diff --git a/docs/mvp-completion-plan.md b/docs/mvp-completion-plan.md index a5c2540..da7522a 100644 --- a/docs/mvp-completion-plan.md +++ b/docs/mvp-completion-plan.md @@ -75,7 +75,7 @@ Aus einem sauberen Klon von `95aa707` wurden drei Buildpläne geprüft und der R 1. **Skript veröffentlichen.** Die Bibliothek zeigt je Skript Name, Plattform und aktuelle Version. Im Detail lassen sich ältere Versionen lesen und neue veröffentlichen. 2. **Auftrag einreichen.** Unter „Aufträge“ Kunde und Geräte wählen oder eine Auswahl aus „Geräte“ übernehmen. Eine feste Bibliotheksversion oder ein einmaliges Skript angeben und die Zusammenfassung einreichen. Inkompatible Geräte sind gekennzeichnet. Der Antrag bleibt nach einer unterbrochenen Übermittlung wiederauffindbar. 3. **Entscheidung treffen.** „Genehmigungen“ bündelt offene WebUI- und MCP-Anträge für die Kunden, für die der angemeldete Benutzer entscheiden darf. Den festen Plan mit Zielgeräten, Skript, Ausführungsrechten und Zeitfenster prüfen und genehmigen oder ablehnen. Frühere Entscheidungen stehen im Verlauf. -4. **Ergebnis nachlesen.** „Aufträge“ zeigt die neuesten Anträge zuerst. Bei einem einzelnen Gerät ist die Ausgabe direkt im Auftrag sichtbar. Bei mehreren Geräten öffnet „Ergebnis anzeigen“ die Ausgabe an der jeweiligen Gerätezeile. Technische Kennungen und Prüfsummen stehen in den Details. Geräteaufnahme und Agent-Releases haben eigene Verwaltungsansichten. +4. **Ergebnis und Skript nachlesen.** „Aufträge“ zeigt die neuesten Anträge zuerst. Das Auftragsdetail zeigt den beim Einreichen gebundenen Skripttext und kennzeichnet unterschiedliche Varianten nach Gerät. Bei einem einzelnen Gerät ist die Ausgabe direkt im Auftrag sichtbar. Bei mehreren Geräten öffnet „Ergebnis anzeigen“ die Ausgabe an der jeweiligen Gerätezeile. Technische Kennungen und Prüfsummen stehen in den Details. Geräteaufnahme und Agent-Releases haben eigene Verwaltungsansichten. 5. **Abnahme.** Die Linux-Test-VM lieferte für Version 1 des Bibliotheksskripts trotz bereits verfügbarer Version 2 die Kernelversion, Exitcode 0. Zwei abgelehnte Anträge aus WebUI und MCP erzeugten je null Jobs. Alle drei Entscheidungen liefen über den gekennzeichneten Testprincipal im Entwicklungsprofil. Die öffentlichen Ansichten wurden nach Passwort-/TOTP-Anmeldung in Desktop- und Mobilbreite geprüft. [Abnahmeprotokoll](evidence/webui-auftragsablauf-20261117.json) Den aktuellen Kernablauf mit den vorhandenen Build-, Deployment- und Operatorbefehlen benutzen. Die Windows-Updatevorlage ist mit einer tatsächlichen Installation und dokumentiertem Neustartbedarf abgenommen. Dafür das dokumentierte Fenster öffnen, die gespeicherte Updatevorlage wählen und den festen Plan in der WebUI genehmigen. Den automatischen Agentversionswechsel und bereits erfolgreiche Bibliotheksaufträge nur bei einem betroffenen Fehler erneut abnehmen. diff --git a/docs/public-access.md b/docs/public-access.md index ce436c1..42d9881 100644 --- a/docs/public-access.md +++ b/docs/public-access.md @@ -36,7 +36,7 @@ Der Entwicklungsoperator kann dem bereits eingerichteten lokalen Betreiberkonto 2. Unter **Aufträge → Neuer Auftrag** die Geräte eines Kunden wählen. Eine Auswahl aus dem Gerätebestand lässt sich mit **Auftrag erstellen** übernehmen. Bibliotheksskript samt Version auswählen oder **Einmaliges Skript** eingeben. 3. Die Zusammenfassung prüfen und **Zur Genehmigung einreichen** wählen. Nach einer unterbrochenen Einreichung im selben Browsertab den Auftragsdialog erneut öffnen. Er liest den gespeicherten Plan und, falls bereits vorhanden, den zugehörigen Antrag. 4. Unter **Genehmigungen → Offen** den Antrag öffnen, Skript, Zielgeräte, Rechte und Zeitfenster prüfen und genehmigen oder ablehnen. Der Verlauf zeigt die entschiedenen und abgelaufenen Anträge. -5. Unter **Aufträge** den Eintrag öffnen. Bei einem einzelnen Gerät erscheint die Ausgabe sofort. Bei mehreren Geräten öffnet **Ergebnis anzeigen** die Ausgabe direkt beim gewählten Gerät. +5. Unter **Aufträge** den Eintrag öffnen. Der Bereich **Skriptinhalt** zeigt den beim Einreichen gespeicherten Code samt Version oder Kennzeichnung als einmaliges Skript. Bei einem einzelnen Gerät erscheint die Ausgabe sofort. Bei mehreren Geräten öffnet **Ergebnis anzeigen** die Ausgabe direkt beim gewählten Gerät. ## Entwicklung und Deployment diff --git a/tests/browser/order-composer.spec.ts b/tests/browser/order-composer.spec.ts index 9892411..33c90fc 100644 --- a/tests/browser/order-composer.spec.ts +++ b/tests/browser/order-composer.spec.ts @@ -1,6 +1,7 @@ import { test, expect } from '../../web/node_modules/@playwright/test/index.js'; import { createServer, type ViteDevServer } from '../../web/node_modules/vite/dist/node/index.js'; import { createHash, randomUUID } from 'node:crypto'; +import { readFileSync } from 'node:fs'; import { resolve } from 'node:path'; let server: ViteDevServer; @@ -62,7 +63,7 @@ test.afterAll(async () => { await server?.close(); }); -test('opens a single result automatically and shows each result at its own device row', async ({ page }) => { +test('shows the bound script text alongside single and per-device results', async ({ page }) => { const operationId = randomUUID(); const multiOperationId = randomUUID(); const jobs = [linux, windows].map((device, index) => ({ @@ -71,8 +72,31 @@ test('opens a single result automatically and shows each result at its own devic attempt_id: randomUUID(), state: index === 0 ? 'succeeded' : 'failed' })); + const golden = JSON.parse(readFileSync(resolve(__dirname, '../script_console/codec-golden.json'), 'utf8')) as + { name: string; plan_payload_bytes: number[] }[]; + const [linuxPlan, windowsPlan] = ['legacy_linux_agent', 'windows_system_full'].map(name => { + const fixture = golden.find(row => row.name === name); + if (!fixture) throw new Error('Missing script fixture: ' + name); + return JSON.parse(Buffer.from(fixture.plan_payload_bytes).toString('utf8')); + }); + const boundJobs = [linuxPlan, windowsPlan].map(({ jobs: [job] }, index) => { + const { asset_id, agent_id, job_id, attempt_id } = jobs[index]!; + const payload = { ...job.payload, tenant_id: tenantId, asset_id, agent_id, job_id, attempt_id }; + return { ...job, payload, job_payload_hash: hash(JSON.stringify(payload)) }; + }); + const views = [operationId, multiOperationId].map((id, index) => { + const planJobs = index === 0 ? boundJobs.slice(0, 1) : boundJobs; + const plan = { ...linuxPlan, plan_id: randomUUID(), tenant_id: tenantId, jobs: planJobs }; + if (!index) plan.script_revision = { + revision_id: randomUUID(), name: script.name, version: 2, script_sha256: planJobs[0]!.script_sha256 + }; + const raw = JSON.stringify(plan); + return { operation_id: id, plan_id: plan.plan_id, plan_hash: hash(raw), + plan_payload: plan, plan_payload_bytes: [...Buffer.from(raw)] }; + }); const api = '/api/v1/tenants/' + tenantId; const resultReads = new Set(); + let mismatchedPlan = false; await page.route(origin + '/auth/config', r => r.fulfill({ json: { dev_login_enabled: true, oidc_configured: false, oidc_login_url: null } })); @@ -85,13 +109,17 @@ test('opens a single result automatically and shows each result at its own devic if (pathname === '/api/v1/approvals') return r.fulfill({ json: { ...listing([]), pending_count: 0 } }); if (pathname.startsWith(api + '/operations/')) { const id = pathname.slice((api + '/operations/').length); + const view = views.find(item => item.operation_id === id); if (id === operationId || id === multiOperationId) return r.fulfill({ json: { - operation_id: id, customer_name: 'Nord', title: script.name, approval_state: 'approved', + operation_id: id, customer_name: 'Nord', title: script.name, action: 'run_script', approval_state: 'approved', + plan_id: view?.plan_id, plan_hash: view?.plan_hash, execution_state: id === operationId ? 'succeeded' : 'partially_succeeded', targets: id === operationId ? [linux] : [linux, windows], jobs: id === operationId ? jobs.slice(0, 1) : jobs } }); } + const plan = views.find(view => pathname === api + '/operation-plans/' + view.plan_id); + if (plan) return r.fulfill({ json: mismatchedPlan ? { ...plan, operation_id: randomUUID() } : plan }); const job = jobs.find(item => pathname === api + '/jobs/' + item.job_id); if (job) { const success = job.state === 'succeeded'; @@ -110,6 +138,9 @@ test('opens a single result automatically and shows each result at its own devic await expect(page.getByRole('heading', { name: 'Ergebnis für test-linux' })).toBeVisible(); await expect(page.getByLabel('stdout Textansicht')).toHaveText('Linux'); await expect(page.getByText('Exitcode 0', { exact: true })).toBeVisible(); + const source = page.getByRole('article', { name: 'Skriptinhalt' }); + await expect(source.getByLabel('Gespeicherter Skripttext')).toHaveText(boundJobs[0]!.payload.action.script_utf8.trim()); + await expect(source.getByText('Version 2 · posix_sh')).toBeVisible(); expect([...resultReads]).toEqual(jobs.slice(0, 1).map(job => job.job_id)); await page.setViewportSize({ width: 390, height: 844 }); @@ -119,6 +150,9 @@ test('opens a single result automatically and shows each result at its own devic const windowsButton = page.getByRole('button', { name: 'Ergebnis anzeigen für test-windows' }); await expect(linuxButton).toBeVisible(); await expect(windowsButton).toBeVisible(); + await expect(source.getByRole('heading', { name: 'test-linux' })).toBeVisible(); + await expect(source.getByRole('heading', { name: 'test-windows' })).toBeVisible(); + await expect(source.getByLabel('Gespeicherter Skripttext')).toHaveText(boundJobs.map(job => job.payload.action.script_utf8.trim())); expect(resultReads.size).toBe(0); await linuxButton.click(); const linuxRow = page.getByRole('listitem').filter({ has: page.getByRole('button', { name: 'Ergebnis schließen für test-linux' }) }); @@ -129,6 +163,10 @@ test('opens a single result automatically and shows each result at its own devic await page.getByRole('button', { name: 'Ergebnis schließen für test-windows' }).click(); await expect(page.getByRole('region', { name: 'Gespeichertes Konsolenergebnis' })).toHaveCount(0); expect(await page.evaluate(() => document.documentElement.scrollWidth)).toBeLessThanOrEqual(390); + mismatchedPlan = true; + await page.reload(); + await expect(source.getByRole('alert')).toContainText('konnte diesem Auftrag nicht zugeordnet werden'); + await expect(source.getByLabel('Gespeicherter Skripttext')).toHaveCount(0); }); for (const library of [true, false]) { diff --git a/web/src/main.tsx b/web/src/main.tsx index 14f2471..3ea7091 100644 --- a/web/src/main.tsx +++ b/web/src/main.tsx @@ -366,6 +366,48 @@ function Operations({ tenantId, open, customerName }: { tenantId: string; open: {list.data && } ; } +function OrderScript({ tenantId, operation, names }: { tenantId: string; operation: RecordValue; names: RecordValue[] }) { + const operationId = objectId(operation, 'operation'); + const planId = objectId(operation, 'plan'); + const planHash = stringField(operation, 'plan_hash'); + const scripts = useResource(async signal => { + const plan = record(await request(tenantPath(tenantId, '/operation-plans/' + encodeURIComponent(planId)), { signal })); + const stored = record(plan.plan_payload); + if (plan.operation_id !== operationId || plan.plan_hash !== planHash || + plan.plan_id !== planId || stored.plan_id !== planId || stored.tenant_id !== tenantId) { + throw new Error('Der Skriptinhalt konnte diesem Auftrag nicht zugeordnet werden.'); + } + await verifyScriptPlan(plan); + const jobs = scriptPlanJobs(plan); + if (!jobs.length) throw new Error('Für diesen Auftrag ist kein Skriptinhalt gespeichert.'); + const variants = new Map(); + for (const job of jobs) { + const key = JSON.stringify([job.scriptHash, job.interpreter]); + const group = variants.get(key); + if (group) group.push(job); + else variants.set(key, [job]); + } + return [...variants.values()]; + }, [tenantId, operationId, planId, planHash]); + + const variants = scripts.error ? [] : scripts.data ?? []; + return
+

Skriptinhalt

+ + {!scripts.data && !scripts.error &&

Skriptinhalt wird geladen …

} + {variants.map(group => { + const script = group[0]!; + return
+ {variants.length > 1 &&

{group.map(job => { + const target = names.find(item => item.asset_id === job.assetId && item.agent_id === job.agentId); + return target ? deviceName(target) : job.assetId; + }).join(', ')}

} +

{script.revision ? 'Version ' + script.revision.version : 'Einmaliges Skript'} · {script.interpreter}

+
{outputText(new TextEncoder().encode(script.script.replace(/\r\n/g, '\n'))).text}
+
; + })} +
; +} function OperationDetail({ tenantId, id, auth, openPlan, customerName }: { tenantId: string; id: string; auth: Session; openPlan: (id: string) => void; customerName?: string }) { @@ -385,29 +427,32 @@ function OperationDetail({ tenantId, id, auth, openPlan, customerName }: { {when(data.created_at)} {display(data.reason, 'Kein Anlass angegeben')} - {singleJob ? - :
-

Geräte und Ergebnisse

- {jobs.length ?
    {jobs.map(job => { - const resultId = objectId(job, 'job'); - const hostname = name(job); - const expanded = jobId === resultId; - const action = expanded ? 'Ergebnis schließen' : 'Ergebnis anzeigen'; - return
  • -
    - {hostname} - - -
    - {expanded && } -
  • ; - })}
- : <>

{names.map(deviceName).join(', ')}

{data.approval_state === 'pending_approval' - ? 'Nach der Genehmigung erscheint hier der Fortschritt je Gerät.' : 'Für diesen Auftrag liegen keine Ausführungen vor.'}

} -
} +
+ {singleJob ? + :
+

Geräte und Ergebnisse

+ {jobs.length ?
    {jobs.map(job => { + const resultId = objectId(job, 'job'); + const hostname = name(job); + const expanded = jobId === resultId; + const action = expanded ? 'Ergebnis schließen' : 'Ergebnis anzeigen'; + return
  • +
    + {hostname} + + +
    + {expanded && } +
  • ; + })}
+ : <>

{names.map(deviceName).join(', ')}

{data.approval_state === 'pending_approval' + ? 'Nach der Genehmigung erscheint hier der Fortschritt je Gerät.' : 'Für diesen Auftrag liegen keine Ausführungen vor.'}

} +
} + {data.action === 'run_script' && } +
{allowed(auth, 'plans:approve') && } @@ -660,7 +705,7 @@ function Workspace({ auth, logout }: { auth: Session; logout: () => void }) { {route.page === 'auftraege' && ( route.tab === 'neu' ? <> ← Zu den Aufträgen - +
Weitere Wartungsaktionen

Inventur, Dienstverwaltung und weitere Wartungsaufträge planen.

Wartungsauftrag planen diff --git a/web/src/style.css b/web/src/style.css index de8aa71..f095c69 100644 --- a/web/src/style.css +++ b/web/src/style.css @@ -122,6 +122,13 @@ section.fleet { padding:0; overflow:hidden; } .job-result > section > p:first-child { margin-top:0; } .job-result .console-output { background:var(--surface); } .job-list .job-result { margin:8px 0 2px; } +.order-script { margin-top:22px; } +.order-script > h3 { font-size:1.15rem; } +.order-script .script-body { max-height:24rem; } +.order-script .script-body:last-child { margin-bottom:0; } +@media (min-width:1101px) { + .order-execution:has(> .order-script) { display:grid; grid-template-columns:minmax(0, 3fr) minmax(0, 2fr); gap:16px; align-items:start; } +} .device-detail > .quiet { margin-bottom:18px; } .sr-only { position:absolute; width:1px; height:1px; margin:-1px; padding:0; overflow:hidden; clip:rect(0,0,0,0); white-space:nowrap; border:0; } @media(max-width:1100px) and (min-width:761px) { .workbench {grid-template-columns:165px minmax(0,1fr);} .content {padding-left:18px;padding-right:18px;} .brand {font-size:1rem;} .fleet-table th,.fleet-table td {padding-inline:6px;} }