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

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Melvin Strobl
2026-10-16 15:48:36 +02:00
co-authored by Claude Opus 5.5
parent 01495aed25
commit ed06bdec6b
56 changed files with 3539 additions and 2404 deletions
@@ -1,6 +1,6 @@
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query"
import { createFileRoute, useNavigate } from "@tanstack/react-router"
import { LayoutDashboard, MonitorSmartphone } from "lucide-react"
import { LayoutDashboard } from "lucide-react"
import { useState } from "react"
import { DashboardsService } from "@/client"
@@ -12,7 +12,6 @@ import {
useDuplicateSelected,
usePublishAll,
} from "@/components/Common/OverviewToolbar"
import { PanelsDialog } from "@/components/Dashboard/PanelsDialog"
import {
dashboardKeys,
dashboardsQueryOptions,
@@ -28,25 +27,11 @@ import {
} from "@/components/ui/dialog"
import { Input } from "@/components/ui/input"
import { Skeleton } from "@/components/ui/skeleton"
import {
Tooltip,
TooltipContent,
TooltipTrigger,
} from "@/components/ui/tooltip"
import useCustomToast from "@/hooks/useCustomToast"
import { handleError } from "@/utils"
type Search = { panels?: boolean; panel?: string }
export const Route = createFileRoute("/_layout/dashboards/")({
component: Dashboards,
// The panels dialog has no route of its own, so the address is how anything
// else — the global search among them — arrives at it.
validateSearch: (search: Record<string, unknown>): Search => ({
panels: search.panels === true || search.panels === "true" || undefined,
// Which panel to scroll to, for a link that is about one of them.
panel: typeof search.panel === "string" ? search.panel : undefined,
}),
})
function Dashboards() {
@@ -58,11 +43,6 @@ function Dashboards() {
const [search, setSearch] = useState("")
const [dialogOpen, setDialogOpen] = useState(false)
const [deleteOpen, setDeleteOpen] = useState(false)
// Which screens exist is a question with an address, so anything can link to
// it — the global search lands a panel here.
const { panels: panelsOpen, panel: panelFocus } = Route.useSearch()
const setPanelsOpen = (open: boolean) =>
navigate({ to: "/dashboards", search: open ? { panels: true } : {} })
const create = useMutation({
mutationFn: (dashboard: string) =>
@@ -131,12 +111,6 @@ function Dashboards() {
</p>
</div>
{/* Its own root rather than a nested one: which screens exist is a
different question from which dashboards do. */}
<Dialog open={panelsOpen ?? false} onOpenChange={setPanelsOpen}>
<PanelsDialog focus={panelFocus} />
</Dialog>
<Dialog open={dialogOpen} onOpenChange={setDialogOpen}>
<OverviewToolbar
search={search}
@@ -152,23 +126,7 @@ function Dashboards() {
onDeleteSelected={() => setDeleteOpen(true)}
duplicating={duplicate.isPending}
onDuplicateSelected={() => duplicate.mutate(selection.selected)}
>
<Tooltip>
<TooltipTrigger asChild>
<Button
variant="ghost"
size="icon-touch"
className="text-muted-foreground"
aria-label="Panels"
data-testid="open-panels"
onClick={() => setPanelsOpen(true)}
>
<MonitorSmartphone />
</Button>
</TooltipTrigger>
<TooltipContent>Panels</TooltipContent>
</Tooltip>
</OverviewToolbar>
/>
<DialogContent>
<form
className="grid gap-4"
@@ -0,0 +1,13 @@
import { createFileRoute } from "@tanstack/react-router"
import { DeviceDetail } from "@/components/Devices/DeviceDetail"
export const Route = createFileRoute("/_layout/devices/$id")({
component: Device,
head: ({ params }) => ({ meta: [{ title: `${params.id} - Fluksio` }] }),
})
function Device() {
const { id } = Route.useParams()
return <DeviceDetail id={id} />
}
@@ -0,0 +1,122 @@
import { useQuery, useQueryClient } from "@tanstack/react-query"
import { createFileRoute } from "@tanstack/react-router"
import { MonitorSmartphone } from "lucide-react"
import { useState } from "react"
import { DevicesService } from "@/client"
import { OverviewCard, useSelection } from "@/components/Common/OverviewCard"
import {
ConfirmDelete,
OverviewToolbar,
useDeleteSelected,
} from "@/components/Common/OverviewToolbar"
import { AddDeviceDialog } from "@/components/Devices/AddDeviceDialog"
import { presenceText } from "@/components/Devices/DeviceDetail"
import { deviceKeys, devicesQueryOptions } from "@/components/Devices/queries"
import { Dialog } from "@/components/ui/dialog"
import { Skeleton } from "@/components/ui/skeleton"
import useAuth from "@/hooks/useAuth"
export const Route = createFileRoute("/_layout/devices/")({
component: Devices,
head: () => ({ meta: [{ title: "Devices - Fluksio" }] }),
})
function Devices() {
const { data, isPending } = useQuery(devicesQueryOptions())
const queryClient = useQueryClient()
const { user } = useAuth()
const [search, setSearch] = useState("")
const [addOpen, setAddOpen] = useState(false)
const [deleteOpen, setDeleteOpen] = useState(false)
const needle = search.trim().toLowerCase()
const all = data?.data ?? []
const devices = all.filter((device) =>
`${device.id} ${device.title ?? ""}`.toLowerCase().includes(needle),
)
const selection = useSelection(devices.map((device) => device.id))
const remove = useDeleteSelected(
(id) => DevicesService.deleteDevice({ deviceId: id }),
"device",
() => queryClient.invalidateQueries({ queryKey: deviceKeys.all }),
)
return (
<div className="grid gap-6">
<div className="grid gap-1">
<h1 className="text-2xl">Devices</h1>
<p className="text-sm text-muted-foreground">
The screens and boards paired with this instance, and what each shows.
</p>
</div>
<Dialog open={addOpen} onOpenChange={setAddOpen}>
{/* Adding and removing devices is a superuser's, like pairing them. */}
{user?.is_superuser ? (
<OverviewToolbar
search={search}
onSearch={setSearch}
searchLabel="Search devices"
searchTestId="search-devices"
createLabel="Add device"
createTestId="add-device"
selectedCount={selection.selected.length}
onDeleteSelected={() => setDeleteOpen(true)}
/>
) : null}
<AddDeviceDialog
taken={all.map((device) => device.id)}
host={data?.frontend_host ?? ""}
/>
</Dialog>
<ConfirmDelete
open={deleteOpen}
onOpenChange={setDeleteOpen}
names={selection.selected}
noun="device"
pending={remove.isPending}
description="Its screen is signed out at once and asks for a new code. The dashboards it showed stay."
onConfirm={() => {
setDeleteOpen(false)
remove.mutate(selection.selected)
}}
/>
{isPending ? (
<div className="grid gap-3 sm:grid-cols-2 lg:grid-cols-3">
{Array.from({ length: 3 }).map((_, index) => (
<Skeleton key={index} className="h-[5.5rem] rounded-lg" />
))}
</div>
) : devices.length === 0 ? (
<p className="text-sm text-muted-foreground">
{needle
? "No device matches that."
: "No devices yet. Add one, then pair the screen with it."}
</p>
) : (
<div className="grid gap-3 sm:grid-cols-2 lg:grid-cols-3">
{devices.map((device) => {
const count = (device.dashboards ?? []).length
return (
<OverviewCard
key={device.id}
link={{ to: "/devices/$id", params: { id: device.id } }}
icon={MonitorSmartphone}
title={device.title || device.id}
online={device.online}
detail={`${presenceText(device)} · ${count} dashboard${count === 1 ? "" : "s"}`}
selecting={selection.selecting}
selected={selection.selected.includes(device.id)}
onToggle={() => selection.toggle(device.id)}
testId="device-card"
/>
)
})}
</div>
)}
</div>
)
}