feat(devices): add battery profiles

A battery profile describes a battery model: the charge and discharge limit
maps over temperature and SoC, the charge and discharge efficiency curves
over C-rate, the technical SoC bounds, the hard temperature cutoffs and,
for a model, its nominal capacity and power limits. EOS packages the
generic profile generic-lfp; users add their own profiles.

A battery or electric vehicle selects its profile by battery_profile and
describes how the installation differs from it in profile_adjustment
(capacity, power limits of the installation, periodic full charge). The
effective values are resolved from both at the measured operating point
(temperature, SoC, power) and shown as effective_* fields.

The GENETIC simulation uses the limits and efficiencies of the profile over
SoC, with precomputed tables as a fast path; GENETIC0 gets the values at the
operating point. Optimization parameters are always valid: a battery whose
profile is missing, unreadable or invalid uses the packaged generic-lfp
profile, and the former defaults only if that is not usable either; each is
logged as error, and an optimization run is never cancelled because of a
battery.

Additional changes
- Add a generic device profile store: user and packaged profiles, atomic
  saves, compiled profiles cached per file and checked again at most once a
  second, plain file names as profile names ('schema' is reserved). On
  Windows, a save or read that collides with the other is retried briefly.
- Add the REST API /v1/profile to list the profile kinds and to list, read
  (document and JSON schema), save and delete profiles.
- Check the hard temperature cutoffs on the exact temperature.
- Resolve inhibited charging or discharging to a power of 0, e.g. for a cold
  battery; give GENETIC0 its own discharge limit for that.
- Limit generic profiles without own power limits to the former 5000 W.
- Accept only the implemented units; current limits need the nominal
  voltage.
- Migrate legacy battery settings into the profile adjustment, keep the
  former charge power limit as discharge limit (also for a Home Assistant
  entity on it) and report dropped efficiencies as errors.
- Limit GENETIC battery discharge by the discharge power.
- Allow battery profile lookups while the configuration is created.
- Resolve a battery once per configuration dump.
- Package the bundled profiles, document battery profiles and regenerate
  the configuration and OpenAPI documentation.
- Ignore the report PDFs written by the visualization tests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Assisted-by: Claude Code (claude-opus-5-5)

tests/test_geneticconfigoptimizerequest.py

@@ -61,8 +61,8 @@ def configured_request(config_eos, monkeypatch):
                 "max_home_appliances": 2,
                 "batteries": {
                     "storage": {
-                        "capacity_wh": 2000,
-                        "max_charge_power_w": 1000,
+                        "profile_adjustment": {"nominal_capacity_wh": 2000,
+                        "max_charge_power_w": 1000},
                         "levelized_cost_of_storage_amt_kwh": 0.01,
                     }
                 },
@@ -534,7 +534,7 @@ async def test_missing_ev_soc_does_not_replace_explicit_battery_soc(configured_r
     config, _, _, data = configured_request
     config.merge_settings_from_dict(
         {"devices": {"max_electric_vehicles": 1,
-                     "electric_vehicles": {"car": {"capacity_wh": 60000}}}}
+                     "electric_vehicles": {"car": {"profile_adjustment": {"nominal_capacity_wh": 60000}}}}}
     )
     parameters = await ConfigOptimizationRequest.model_validate(data).resolve()
     assert parameters.pv_battery is not None
@@ -551,8 +551,8 @@ async def test_http_config_and_real_optimizer_allow_full_ev_target(configured_re
 
     config, fake, _, data = configured_request
     config.merge_settings_from_dict({"devices": {"max_electric_vehicles": 1,
-        "electric_vehicles": {"ev": {"capacity_wh": 1000, "max_charge_power_w": 1000,
-            "charging_efficiency": 1, "min_soc_percentage": 0,
+        "electric_vehicles": {"ev": {"profile_adjustment": {"nominal_capacity_wh": 1000,
+            "max_charge_power_w": 1000}, "min_soc_percentage": 0,
             "max_soc_percentage": 100}}}})
     data["soc"]["ev"] = soc
     ems = EnergyManagement()
@@ -589,7 +589,7 @@ async def test_explicit_ev_soc_has_no_measurement_age_limit(configured_request,
     config, ems, measurement, data = configured_request
     config.merge_settings_from_dict(
         {"devices": {"max_electric_vehicles": 1,
-                     "electric_vehicles": {"car": {"capacity_wh": 60000,
+                     "electric_vehicles": {"car": {"profile_adjustment": {"nominal_capacity_wh": 60000},
                                                  "min_soc_percentage": 100,
                                                  "max_soc_percentage": 100}}}}
     )
@@ -730,3 +730,31 @@ async def test_missing_newest_soc_value_falls_back_to_older_fresh_sample(
     parameters = await ConfigOptimizationRequest.model_validate(data).resolve()
     assert parameters.pv_battery is not None
     assert parameters.pv_battery.initial_soc_percentage == 42
+
+
+@pytest.mark.asyncio
+async def test_battery_configuration_error_uses_defaults_and_logs_error(configured_request):
+    """A battery that cannot be resolved does not cancel the parameter preparation."""
+    from loguru import logger
+
+    config, _, _, data = configured_request
+    config.merge_settings_from_dict(
+        {"devices": {"batteries": {"storage": {"battery_profile": "does-not-exist"}}}}
+    )
+    messages: list[str] = []
+    sink_id = logger.add(lambda message: messages.append(message.record["message"]), level="ERROR")
+    try:
+        parameters = await ConfigOptimizationRequest.model_validate(data).resolve()
+    finally:
+        logger.remove(sink_id)
+    assert parameters.pv_battery is not None
+    # The packaged generic profile applies with the adjustment.
+    assert parameters.pv_battery.capacity_wh == 2000
+    assert parameters.pv_battery.max_charge_power_w == pytest.approx(1000.0)
+    assert parameters.pv_battery.charge_power_limit_w_by_soc is not None
+    assert any(
+        "Battery 'storage'" in m
+        and "does-not-exist" in m
+        and "Using defaults for the optimization: battery profile 'generic-lfp'" in m
+        for m in messages
+    )