feat(mazenet): per-LAN swarm host pin

Adds nullable LAN.host_uuid (FK swarm_hosts.uuid). Resolution order
when deploying a LAN: lan.host_uuid → topology.target_host_uuid →
master. A LAN is one Docker bridge so the bridge cannot span hosts;
this pin forces every decky in the LAN onto the named host.

LANCreateRequest / LANUpdateRequest accept host_uuid; both validate
that the host exists, returning 400 on unknown UUIDs. PATCH still
gated by the existing pending-only guard, so reassignment of a live
LAN is not yet possible (deferred to mutator support).

LANRow surfaces the field so the frontend can render per-host badges.
This commit is contained in:
2026-04-25 03:04:23 -04:00
parent 36031fa10a
commit 0d92170a57
3 changed files with 98 additions and 0 deletions

View File

@@ -59,6 +59,13 @@ class LAN(SQLModel, table=True):
docker_network_id: Optional[str] = Field(default=None)
subnet: str
is_dmz: bool = Field(default=False)
# Per-LAN swarm host pin. ``None`` means "fall back to
# ``Topology.target_host_uuid``; if that is also None, deploy on the
# master." A LAN is one Docker bridge — bridges don't span hosts —
# so a non-null value forces every decky in this LAN onto that host.
host_uuid: Optional[str] = Field(
default=None, foreign_key="swarm_hosts.uuid", index=True
)
# Canvas layout coordinates (set by the web editor). Nullable so
# generator-emitted LANs don't need auto-layout at generation time.
x: Optional[float] = Field(default=None)
@@ -225,6 +232,7 @@ class LANRow(BaseModel):
subnet: str
is_dmz: bool = False
docker_network_id: Optional[str] = None
host_uuid: Optional[str] = None
x: Optional[float] = None
y: Optional[float] = None
@@ -280,6 +288,7 @@ class LANCreateRequest(BaseModel):
name: str = PydanticField(..., min_length=1, max_length=64)
subnet: Optional[str] = None
is_dmz: bool = False
host_uuid: Optional[str] = None
x: Optional[float] = None
y: Optional[float] = None
expected_version: Optional[int] = None
@@ -289,6 +298,7 @@ class LANUpdateRequest(BaseModel):
name: Optional[str] = None
subnet: Optional[str] = None
is_dmz: Optional[bool] = None
host_uuid: Optional[str] = None
x: Optional[float] = None
y: Optional[float] = None
expected_version: Optional[int] = None