Panels become devices: per-device documents in the flow repo, a Devices tab

- flow/devices.py: DeviceDef in FLOWS_DIR/_devices/<id>.json, committed under
  the flow store's write lock, 409 on a stale version; nonces in DEVICES_FILE
  outside git; in-memory presence announced as device_status
- api/routes/devices.py: CRUD, pairing with an optional {name, board,
  firmware}, a pending list adopted without a code from the LAN only, unpair;
  /panels/pair, /panels/pair/{code} and GET /panels/{id} kept as aliases,
  PUT /panels/ gone
- _device_may replaces _panel_may, JWT claims unchanged
- panels.json moves into devices once at startup, then .migrated
- MCP list_devices, get_device; search category device
- Devices tab (list, detail with presence, pairing, ordered dashboards,
  touch, I/O), PanelsDialog removed, serialised optimistic saves
This commit is contained in:
Melvin Strobl
2026-10-16 15:48:36 +02:00
parent 3c0912a3fe
commit 28a565e501
56 changed files with 3539 additions and 2404 deletions
+58
View File
@@ -0,0 +1,58 @@
"""The one-time move of an older instance's panels file into devices."""
import json
import subprocess
from pathlib import Path
from fluksio.flow.devices import DeviceStore
from fluksio.flow.store import FlowStore
def test_panels_move_into_devices_once(tmp_path: Path) -> None:
flows = FlowStore(tmp_path / "flows")
panels = tmp_path / "panels.json"
panels.write_text(
json.dumps(
{
"panels": [
{"id": "hall", "title": "Hall", "dashboards": ["home"], "nonce": 2},
{"id": "knob", "touch": True, "io": [], "nonce": 0},
],
"version": 7,
}
)
)
store = DeviceStore(flows, tmp_path / "devices.json")
store.migrate(panels)
assert not panels.exists()
assert (tmp_path / "panels.json.migrated").exists()
hall = store.find("hall")
assert hall is not None and hall.dashboards == ["home"] and hall.version == 1
assert store.find("knob").touch is True # type: ignore[union-attr]
# The nonce stays outside git, so a credential minted at it still stands.
assert store.nonce("hall") == 2
assert "nonce" not in (flows.root / "_devices" / "hall.json").read_text()
log = subprocess.run(
["git", "-C", str(flows.root), "log", "--format=%s"],
capture_output=True,
text=True,
).stdout
assert log.splitlines()[0] == "Migrate panels to devices"
# Nothing in `_devices` is taken for a flow.
assert flows.list_flows() == []
# A second start finds nothing to do, and a panels file restored from a
# backup does not lower a nonce an unpair has raised since.
store.bump("hall")
panels.write_text((tmp_path / "panels.json.migrated").read_text())
store.migrate(panels)
assert store.nonce("hall") == 3
assert (
log
== subprocess.run(
["git", "-C", str(flows.root), "log", "--format=%s"],
capture_output=True,
text=True,
).stdout
)
+12 -19
View File
@@ -10,10 +10,9 @@ from pathlib import Path
import pytest
from fluksio.api.routes.flows import _endpoints
from fluksio.core.config import settings
from fluksio.flow.controller import FlowController
from fluksio.flow.devices import DeviceDef, DevicePort, DeviceStore
from fluksio.flow.messages import DType, MessageSpec
from fluksio.flow.panels import PanelDef, PanelPort, PanelsConfig, write_config
from fluksio.flow.schemas import FlowDef, NodeDef
from fluksio.flow.store import FlowStore
@@ -113,23 +112,17 @@ def test_the_wiring_index_is_read_once_per_store_revision(controller):
assert reads == 2
def test_a_panel_port_is_drawn_on_the_side_it_wires(controller, tmp_path, monkeypatch):
monkeypatch.setattr(settings, "PANELS_FILE", tmp_path / "panels.json")
write_config(
PanelsConfig(
panels=[
PanelDef(
id="hall",
title="Hall",
io=[
PanelPort(port="gpio.4", message="house.temp", direction="in"),
PanelPort(
port="backlight", message="house.temp", direction="out"
),
PanelPort(port="mic", message="garage.open", direction="in"),
],
)
]
def test_a_device_port_is_drawn_on_the_side_it_wires(controller, tmp_path):
controller.devices = DeviceStore(controller.store, tmp_path / "devices.json")
controller.devices.create(
DeviceDef(
id="hall",
title="Hall",
io=[
DevicePort(port="gpio.4", message="house.temp", direction="in"),
DevicePort(port="backlight", message="house.temp", direction="out"),
DevicePort(port="mic", message="garage.open", direction="in"),
],
)
)