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_homeassistant.py

@@ -458,7 +458,7 @@ class TestHomeAssistantConfigEntityIds:
                     "batteries": {
                         "battery1": {
                             "device_id": "battery1",
-                            "capacity_wh": 8000,
+                            "profile_adjustment": {"nominal_capacity_wh": 8000},
                             "min_soc_percentage": 10,
                         }
                     }
@@ -476,10 +476,10 @@ class TestHomeAssistantConfigEntityIds:
     async def test_sets_value_by_device_id(self, config) -> None:
         await self._sync(
             config,
-            {"devices/batteries/battery1/capacity_wh": "sensor.capacity"},
+            {"devices/batteries/battery1/profile_adjustment/nominal_capacity_wh": "sensor.capacity"},
             {"sensor.capacity": "12000"},
         )
-        assert config.devices.batteries["battery1"].capacity_wh == 12000
+        assert config.devices.batteries["battery1"].profile_adjustment.nominal_capacity_wh == 12000
 
     @pytest.mark.asyncio
     async def test_applies_zero(self, config) -> None:
@@ -496,17 +496,17 @@ class TestHomeAssistantConfigEntityIds:
     async def test_keeps_value_of_unavailable_entity(self, config, state) -> None:
         await self._sync(
             config,
-            {"devices/batteries/battery1/capacity_wh": "sensor.capacity"},
+            {"devices/batteries/battery1/profile_adjustment/nominal_capacity_wh": "sensor.capacity"},
             {"sensor.capacity": state},
         )
-        assert config.devices.batteries["battery1"].capacity_wh == 8000
+        assert config.devices.batteries["battery1"].profile_adjustment.nominal_capacity_wh == 8000
 
     @pytest.mark.asyncio
     @pytest.mark.parametrize(
         "config_key",
         [
-            "devices/batteries/0/capacity_wh",
-            "devices/batteries/battery2/capacity_wh",
+            "devices/batteries/0/profile_adjustment/nominal_capacity_wh",
+            "devices/batteries/battery2/profile_adjustment/nominal_capacity_wh",
             "devices/batteries/battery1/no_such_setting",
         ],
     )
@@ -518,6 +518,6 @@ class TestHomeAssistantConfigEntityIds:
         await self._sync(config, {config_key: "sensor.capacity"}, {"sensor.capacity": "12000"})
 
         assert list(config.devices.batteries) == ["battery1"]
-        assert config.devices.batteries["battery1"].capacity_wh == 8000
+        assert config.devices.batteries["battery1"].profile_adjustment.nominal_capacity_wh == 8000
         mock_logger.error.assert_called_once()
         assert config_key in mock_logger.error.call_args.args[0]