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)

src/akkudoktoreos/devices/devices.py

@@ -38,7 +38,15 @@ class DevicesCommonSettings(SettingsBaseModel):
         default=None,
         json_schema_extra={
             "description": "Stationary battery storage devices, keyed by device_id.",
-            "examples": [{"bat0": {"device_id": "bat0", "capacity_wh": 8000, "ports": []}}],
+            "examples": [
+                {
+                    "bat0": {
+                        "device_id": "bat0",
+                        "profile_adjustment": {"nominal_capacity_wh": 8000},
+                        "ports": [],
+                    }
+                }
+            ],
             "x-scope": [str(ConfigScope.GENETIC), str(ConfigScope.GENETIC0)],
         },
     )
@@ -57,7 +65,15 @@ class DevicesCommonSettings(SettingsBaseModel):
         default=None,
         json_schema_extra={
             "description": "Electric vehicle battery packs, keyed by device_id.",
-            "examples": [{"ev0": {"device_id": "ev0", "capacity_wh": 60000, "ports": []}}],
+            "examples": [
+                {
+                    "ev0": {
+                        "device_id": "ev0",
+                        "profile_adjustment": {"nominal_capacity_wh": 60000},
+                        "ports": [],
+                    }
+                }
+            ],
             "x-scope": [str(ConfigScope.GENETIC), str(ConfigScope.GENETIC0)],
         },
     )
@@ -154,6 +170,24 @@ class DevicesCommonSettings(SettingsBaseModel):
                 keys.extend(device.measurement_keys or [])
         return keys
 
+    def check_battery_profiles(self) -> tuple[list[str], list[str]]:
+        """Check that every battery and electric vehicle can be resolved from its profile.
+
+        See ``BatteriesCommonSettings.check_profile``.
+
+        Returns:
+            ``(errors, warnings)`` of all batteries and electric vehicles, each
+            message naming its device.
+        """
+        errors: list[str] = []
+        warnings: list[str] = []
+        for device_dict in (self.batteries, self.electric_vehicles):
+            for device in (device_dict or {}).values():
+                device_errors, device_warnings = device.check_profile()
+                errors.extend(device_errors)
+                warnings.extend(device_warnings)
+        return errors, warnings
+
 
 # Type used for indexing: (resource_id, optional actuator_id)
 class ResourceKey(PydanticBaseModel):