phase3+4: Homelab-Teil (Ausfuehrer, Ziele, Jetzt updaten mit Rueckweg) und Seite Homelab fuer alle Geraete

- deploy/homelab/ausfuehrer.py: laeuft als root auf dem Proxmox-Host, holt Auftraege beim Homelab-Teil
  ab (Pull, kein offener Port), feste Aktionsliste, prueft Etiketten selbst; Bericht gegen den echten
  Host erprobt (nur lesend). Kein Proxmox-Schluessel im Container noetig.
- services/homelab: Kanal mit gemeinsamem Geheimnis, App-Katalog, Inventar -> Ziele im gemeinsamen
  Modell (GitHub-Versionen, Webpruefung, alte Paketlisten = unklar), Jetzt updaten: Snapshot ->
  Update -> Pruefung -> bei Rot zurueck + dringende Meldung
- Waechter in der Rolle homelab: Ausfuehrer schweigt, Gaeste antworten nicht
- kern/github.py fuer beide Rollen (auch untagged Releases mit Version im Namen)
- Oberflaeche: Seite Homelab zeigt alle Geraete als Karten (KI-Box ueber /api/ziele, Homelab ueber
  /api/homelab/ziele) mit Stand, Rueckweg und Knopf samt Rueckfrage
- Einrichtung als Skripte (container-anlegen, ausrollen, ausfuehrer-einrichten, box-partner) — noch
  nicht ausgefuehrt, jeder Schritt braucht das User-OK
- frontend-bauen-box.sh: Frontend-Pruefung und Build auf der Box, wenn der PC keinen Speicher hat

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Hitonabi
2026-09-24 18:39:59 +02:00
co-authored by Claude Opus 5.5
parent a47489fa85
commit 5e9227c4a3
66 changed files with 2472 additions and 170 deletions
@@ -0,0 +1,45 @@
import { fireEvent, render, screen, within } from "@testing-library/react"
import type { ZielStand } from "@/lib/typen"
import { ZielKarte } from "./ZielKarte"
const gitea: ZielStand = {
id: "ct-104", name: "Gitea", art: "container", instanz: "homelab", erreichbar: true, geprueft: 1_790_000_000,
rueckweg: "Snapshot vor jedem Update", zaehlung: { neu: 1, aktuell: 1 }, offen: 1,
bausteine: [
{
id: "app", name: "Gitea", zustand: "neu", installiert: "1.27.2", verfuegbar: "1.27.3", kurz: "1.27.2 → 1.27.3",
grund: null,
aktion: { methode: "POST", pfad: "/api/homelab/ziele/ct-104/update", label: "Jetzt updaten",
frage: "Gitea jetzt aktualisieren? Vorher wird ein Snapshot angelegt." },
},
{ id: "os", name: "Pakete", zustand: "aktuell", installiert: null, verfuegbar: null, kurz: "", grund: null, aktion: null },
],
}
describe("ZielKarte", () => {
it("zeigt Stand, Container-Nummer und Rückweg", () => {
render(<ZielKarte ziel={gitea} laeuft={null} gesperrt={false} onAktion={() => {}} />)
expect(screen.getByText("Container 104")).toBeInTheDocument()
expect(screen.getByText("1.27.2 → 1.27.3")).toBeInTheDocument()
expect(screen.getByText("Update bereit")).toBeInTheDocument()
expect(screen.getByText("Rückweg: Snapshot vor jedem Update")).toBeInTheDocument()
expect(screen.getByText("erreichbar")).toBeInTheDocument()
})
it("fragt mit dem Text des Geräts und startet erst nach dem Ja", () => {
const aktion = vi.fn()
render(<ZielKarte ziel={gitea} laeuft={null} gesperrt={false} onAktion={aktion} />)
fireEvent.click(screen.getByRole("button", { name: "Jetzt updaten" }))
const dialog = screen.getByRole("dialog")
expect(within(dialog).getByText(/Vorher wird ein Snapshot angelegt/)).toBeInTheDocument()
expect(aktion).not.toHaveBeenCalled()
fireEvent.click(within(dialog).getByRole("button", { name: "Jetzt updaten" }))
expect(aktion).toHaveBeenCalledWith(gitea.bausteine[0].aktion)
})
it("sperrt die Knöpfe, solange ein Update läuft", () => {
render(<ZielKarte ziel={gitea} laeuft="update …" gesperrt={false} onAktion={() => {}} />)
expect(screen.getByRole("status")).toHaveTextContent("Update läuft: update …")
expect(screen.getByRole("button", { name: "Jetzt updaten" })).toBeDisabled()
})
})
@@ -0,0 +1,117 @@
import { useState } from "react"
import { cn } from "cn"
import { Bestaetigen } from "@/components/cockpit/Bestaetigen"
import { Chip, type ChipArt } from "@/components/cockpit/Chip"
import { Button } from "@/components/ui/button"
import type { BausteinStand, BausteinZustand, ZielAktion, ZielStand } from "@/lib/typen"
const ZUSTAND: Record<BausteinZustand, { art: ChipArt; text: string }> = {
neu: { art: "cyan", text: "Update bereit" },
aktuell: { art: "gruen", text: "aktuell" },
unbekannt: { art: "bernstein", text: "unklar" },
festgehalten: { art: "bernstein", text: "festgehalten" },
"wird-geprueft": { art: "grau", text: "wird geprüft" },
}
const ART: Record<string, string> = {
"ki-box": "KI-Box",
"proxmox-host": "Proxmox-Host",
container: "Container",
vm: "VM",
}
/** „Container 104“ aus Art und ID („ct-104“). */
function artText(ziel: ZielStand): string {
const nummer = ziel.id.match(/-(\d+)$/)?.[1]
const art = ART[ziel.art] ?? ziel.art
return nummer ? `${art} ${nummer}` : art
}
function Stand({ b }: { b: BausteinStand }) {
if (b.kurz) return <span className="ziffern">{b.kurz}</span>
if (b.installiert && b.verfuegbar) return <span className="ziffern">{b.installiert} → {b.verfuegbar}</span>
if (b.installiert) return <span className="ziffern">{b.installiert}</span>
return null
}
function Zeile({ b, gesperrt, onAktion }: { b: BausteinStand; gesperrt: boolean; onAktion: (a: ZielAktion) => void }) {
const z = ZUSTAND[b.zustand] ?? ZUSTAND.unbekannt
return (
<li className="flex flex-col gap-2 border-t border-linie py-3 first:border-t-0 first:pt-0 last:pb-0">
<div className="flex flex-wrap items-center justify-between gap-2">
<div className="flex min-w-0 flex-col">
<span className="text-[15px] font-medium">{b.name}</span>
<span className="text-sm text-text-2">
<Stand b={b} />
</span>
</div>
<Chip art={z.art}>{z.text}</Chip>
</div>
{b.grund && <p className="text-sm text-text-2">{b.grund}</p>}
{b.aktion && (
<div>
<Button size="sm" variant={b.zustand === "neu" ? "default" : "outline"} disabled={gesperrt}
onClick={() => b.aktion && onAktion(b.aktion)}>
{b.aktion.label}
</Button>
</div>
)}
</li>
)
}
/**
* Ein Gerät (KI-Box, Proxmox-Host, Container, VM) mit seinen Bausteinen — dieselbe Karte für beide
* Instanzen, weil beide dasselbe Ziel-Modell liefern (backend/kern/ziele.py). Jeder Knopf fragt vorher
* mit dem Text, den das Gerät selbst mitliefert (Rückweg, Neustart, was wegfällt).
*/
export function ZielKarte({ ziel, laeuft, gesperrt, onAktion }: {
ziel: ZielStand
/** Letzter Schritt eines laufenden Updates für dieses Gerät, sonst null. */
laeuft: string | null
gesperrt: boolean
onAktion: (a: ZielAktion) => void
}) {
const [frage, setFrage] = useState<ZielAktion | null>(null)
const erreichbar = ziel.erreichbar
return (
<section aria-label={ziel.name} className="flex min-w-0 flex-col gap-3 rounded-2xl border border-linie bg-panel p-5">
<header className="flex flex-wrap items-start justify-between gap-2">
<div className="flex min-w-0 flex-col">
<h3 className="schild text-base font-bold tracking-[0.18em] break-words">{ziel.name}</h3>
<span className="text-sm text-text-3">{artText(ziel)}</span>
</div>
{erreichbar !== null && (
<span className={cn("schild flex items-center gap-1.5 text-xs", erreichbar ? "text-text-3" : "text-rot-text")}>
<span aria-hidden className={cn("size-2 rounded-full", erreichbar ? "bg-gruen" : "bg-rot")} />
{erreichbar ? "erreichbar" : "antwortet nicht"}
</span>
)}
</header>
{laeuft && (
<p role="status" className="rounded-lg border border-cyan-rand bg-cyan-grund px-3 py-2 text-sm text-cyan-text">
Update läuft: {laeuft}
</p>
)}
<ul className="flex flex-col">
{ziel.bausteine.map((b) => (
<Zeile key={b.id} b={b} gesperrt={gesperrt || !!laeuft} onAktion={setFrage} />
))}
</ul>
{ziel.rueckweg && <p className="text-xs text-text-3">Rückweg: {ziel.rueckweg}</p>}
<Bestaetigen
offen={!!frage}
titel={frage ? `${ziel.name}: ${frage.label}` : ""}
text={frage?.frage ?? ""}
knopf={frage?.label ?? ""}
gefahr={!!frage?.pfad.endsWith("/neustart")}
gesperrt={gesperrt}
onJa={() => {
if (frage) onAktion(frage)
setFrage(null)
}}
onNein={() => setFrage(null)}
/>
</section>
)
}