From 57cd11f45cf92e0ab78bc122f121cb9c2b786661 Mon Sep 17 00:00:00 2001 From: Simon Axelsson Date: Tue, 10 Nov 2026 00:01:58 +0100 Subject: [PATCH] docs(production): standardiserad produktionsberedskap och gap-analys MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Lägger docs/production-readiness.md och siax/production-gaps.json enligt SIAX Master Definition of Done. Underlag: git-, kod- och live-evidens 2026-11-09. Nivån är evidensbaserad, inte ett leveransgodkännande. --- docs/production-readiness.md | 83 +++++++++++++++++++++++++++++++ siax/production-gaps.json | 96 ++++++++++++++++++++++++++++++++++++ 2 files changed, 179 insertions(+) create mode 100644 docs/production-readiness.md create mode 100644 siax/production-gaps.json diff --git a/docs/production-readiness.md b/docs/production-readiness.md new file mode 100644 index 0000000..aae3b00 --- /dev/null +++ b/docs/production-readiness.md @@ -0,0 +1,83 @@ +# videovault — produktionsberedskap + +> Standardiserad gap-analys enligt SIAX Master Definition of Done. +> Dokumentet är evidens, inte ett leveransgodkännande. Endast `PRODUCTION_READY` får kallas klart. + +## Identitet + +- Repo: `https://git.siax.io/sax3l/videovault.git` +- Manifest: `saknas` — `videovault`, operationalState `okänt` +- Default branch: `main` +- Bedömd nivå: **IMPLEMENTED** (manifestets DoD-anspråk: nej) +- UI: ja — app +- CI-arbetsflöden: 1 + +## Git- och arbetsyteläge + +- Aktuell branch: `main` — ahead 0 / behind 0 +- Ocommittade filer: 0 · otrackade: 0 +- Worktrees: 1 +- Lokala grenar: 1 · remote: 2 + +## Livebevis (observerat 2026-11-09T23:48:50) + +Ingen produktionsdomän är deklarerad i manifestet. Det är ett gap för en produkt som ska driftas. + +## Kod- och UI-signaler + +- Trackade filer: 28 +- Testfiler: 0 · E2E: 0 · Playwright: False · Cypress: False +- API-kontrakt: saknas +- Migrationer: 0 · Health-referenser: 4 +- `@siax/ui`/tokens: False · a11y-verktyg: False · design-conformance: False +- UI-tillståndsfiler: inga hittade +- TODO/FIXME: 0 + +## Gap mot PRODUCTION_READY + +- `NO_MANIFEST` +- `NO_STATUS_DOC` +- `NO_TESTS` + +## Prioriterad backlogg + +| Prio | Åtgärd | Konkret nästa steg | +|---|---|---| +| P0 | Produktionsbevis | Registrera `siax/source-bundles/*.json` med deployad commit-SHA och build-ID från deploymentsystemet. | +| P1 | Backup | Definiera frekvens, retention, mål och kryptering i `siax.backup`. | +| P1 | E2E i webbläsare | Lägg Playwright-flöde för inloggning och kärnflöde mot riktig miljö. | +| P1 | Testtäckning | Lägg minst en verklig enhets-/integrationstest som körs i CI; mock räknas inte som integration. | +| P1 | Tillgänglighetsgrind | Aktivera eslint-plugin-jsx-a11y/axe och en blockerande WCAG 2.2-kontroll. | +| P2 | Arkitektur | Beskriv produktgräns, canonical owner, beroenden och dataflöde i `docs/architecture.md`. | +| P2 | DES1GN-beroende | Använd `@siax/ui` + `@siax/tokens` i stället för lokala kopior av primitiver. | +| P2 | Designkonformitet | Kör `siax-doctor design --repo . --fail-on=block` och checka in `siax/design-conformance.json`. | +| P2 | Runbook | Dokumentera deploy, rollback, backup/restore och incidentflöde i `docs/runbook/`. | +| P2 | Statusdokument | Lägg `docs/STATUS.md` med nivå, bevis, kända gap och nästa steg. | +| P2 | UI-tillstånd | Säkerställ error/loading/not-found/empty-state och att de är renderade, inte bara definierade. | + +## Checklista före PRODUCTION_READY + +- [ ] Canonical owner och produktgräns dokumenterad +- [ ] Versionerat API-/eventkontrakt med drift-check +- [ ] Tenant-isolering verifierad med negativt test +- [ ] Observability: metrics, loggar, spårning och larm +- [ ] Backup och verkligt återställningstest +- [ ] Live-E2E med verklig konsument, inte mock +- [ ] Deployad commit-SHA och build-ID utlästa ur runtime +- [ ] UI/UX granskad mot DES1GN och WCAG 2.2 där UI finns + +## Verifieringskommandon + +```bash +mise run check && mise run verify && mise run build +siax-doctor design --repo . --fail-on=block +curl -fsS https:///health && curl -fsS https:///ready +``` + +## Standardreferenser + +- `siax-standard/standard/MASTER-DEFINITION-OF-DONE.md` +- `siax-standard/standard/SIAX-REPO-OPERATIONS-CONTRACT.md` +- `siax-standard/standard/registry/REUSE_FIRST_POLICY.md` + +_Genererad 2026-11-09T23:41:39 från git, manifest, kodsignaler och live-prober. Omgenereras av `scripts/estate-production-audit.py`._ diff --git a/siax/production-gaps.json b/siax/production-gaps.json new file mode 100644 index 0000000..aff1323 --- /dev/null +++ b/siax/production-gaps.json @@ -0,0 +1,96 @@ +{ + "name": "videovault", + "slug": "videovault", + "origin_url": "https://git.siax.io/sax3l/videovault.git", + "manifest_file": null, + "manifest_operational_state": null, + "assessed_level": "IMPLEMENTED", + "observed_live": null, + "gaps": [ + "NO_MANIFEST", + "NO_STATUS_DOC", + "NO_TESTS" + ], + "ui": true, + "ui_dirs": [ + "app" + ], + "prod_domains": [], + "live": [], + "deep": { + "tracked_files": 28, + "test_files": 0, + "e2e_files": 0, + "has_playwright": false, + "has_cypress": false, + "api_contracts": [], + "migrations": 0, + "health_refs": 4, + "uses_siax_ui": false, + "has_a11y_tooling": false, + "has_design_conformance": false, + "ui_state_files": [], + "todo_count": 0, + "has_runbook_docs": false, + "has_architecture_docs": false, + "has_status_docs": false + }, + "backlog": [ + { + "priority": "P0", + "task": "Produktionsbevis", + "next_step": "Registrera `siax/source-bundles/*.json` med deployad commit-SHA och build-ID från deploymentsystemet." + }, + { + "priority": "P1", + "task": "Backup", + "next_step": "Definiera frekvens, retention, mål och kryptering i `siax.backup`." + }, + { + "priority": "P1", + "task": "E2E i webbläsare", + "next_step": "Lägg Playwright-flöde för inloggning och kärnflöde mot riktig miljö." + }, + { + "priority": "P1", + "task": "Testtäckning", + "next_step": "Lägg minst en verklig enhets-/integrationstest som körs i CI; mock räknas inte som integration." + }, + { + "priority": "P1", + "task": "Tillgänglighetsgrind", + "next_step": "Aktivera eslint-plugin-jsx-a11y/axe och en blockerande WCAG 2.2-kontroll." + }, + { + "priority": "P2", + "task": "Arkitektur", + "next_step": "Beskriv produktgräns, canonical owner, beroenden och dataflöde i `docs/architecture.md`." + }, + { + "priority": "P2", + "task": "DES1GN-beroende", + "next_step": "Använd `@siax/ui` + `@siax/tokens` i stället för lokala kopior av primitiver." + }, + { + "priority": "P2", + "task": "Designkonformitet", + "next_step": "Kör `siax-doctor design --repo . --fail-on=block` och checka in `siax/design-conformance.json`." + }, + { + "priority": "P2", + "task": "Runbook", + "next_step": "Dokumentera deploy, rollback, backup/restore och incidentflöde i `docs/runbook/`." + }, + { + "priority": "P2", + "task": "Statusdokument", + "next_step": "Lägg `docs/STATUS.md` med nivå, bevis, kända gap och nästa steg." + }, + { + "priority": "P2", + "task": "UI-tillstånd", + "next_step": "Säkerställ error/loading/not-found/empty-state och att de är renderade, inte bara definierade." + } + ], + "standard": "SIAX Master Definition of Done" +} \ No newline at end of file -- 2.54.0