From 2340129511d8396ec28f524c90e918f738a1437e Mon Sep 17 00:00:00 2001
From: Andreas <drbacke@gmx.de>
Date: Wed, 16 Sep 2026 13:21:44 +0200
Subject: [PATCH] docs(measurement): describe household settings and
 consolidate regression coverage

---
 src/akkudoktoreos/measurement/measurement.py |  5 +++-
 tests/test_consolidation_file_restore.py     | 24 --------------------
 2 files changed, 4 insertions(+), 25 deletions(-)
 delete mode 100644 tests/test_consolidation_file_restore.py

diff --git a/src/akkudoktoreos/measurement/measurement.py b/src/akkudoktoreos/measurement/measurement.py
index 5f1dfb78..4904c8e2 100644
--- a/src/akkudoktoreos/measurement/measurement.py
+++ b/src/akkudoktoreos/measurement/measurement.py
@@ -91,7 +91,10 @@ class MeasurementCommonSettings(SettingsBaseModel):
         },
     )
 
-    household: Optional[HouseholdSettings] = None
+    household: Optional[HouseholdSettings] = Field(
+        default=None,
+        json_schema_extra={"description": "Optional household energy balance definition.", "examples": [None]},
+    )
     energy_context_seconds: int = Field(default=86400, gt=0, le=604800, strict=True)
 
     @model_validator(mode="after")
diff --git a/tests/test_consolidation_file_restore.py b/tests/test_consolidation_file_restore.py
deleted file mode 100644
index 461d4b04..00000000
--- a/tests/test_consolidation_file_restore.py
+++ /dev/null
@@ -1,24 +0,0 @@
-"""Verify fallback JSON loading does not lose records through the singleton."""
-from unittest.mock import AsyncMock
-import pytest
-from akkudoktoreos.core.coreabc import get_measurement
-from akkudoktoreos.core.dataabc import DataSequence
-
-@pytest.mark.asyncio
-async def test_measurement_json_roundtrip(config_eos, tmp_path, monkeypatch):
-    m = get_measurement()
-    config_eos.measurement.load_emr_keys = ["meter"]
-    config_eos.general.data_folder_path = tmp_path
-    config_eos.database.provider = None
-    m._db_reset_state()
-    try:
-        await m.update_value("2026-09-16T08:00:00Z", "meter", 123.5)
-        monkeypatch.setattr(DataSequence, "save", AsyncMock(return_value=False))
-        monkeypatch.setattr(DataSequence, "load", AsyncMock(return_value=False))
-        assert await m.save()
-        m._db_reset_state()
-        assert await m.load()
-        assert len(m.records) == 1
-        assert m.records[0]["meter"] == 123.5
-    finally:
-        m._db_reset_state()