From 0d75a8265782d96ec77020563cd61bd75cd17e72 Mon Sep 17 00:00:00 2001 From: Simon Axelsson Date: Mon, 9 Nov 2026 23:58:53 +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 | 84 ++++++++++++++++++++++++++++++++++++ 2 files changed, 167 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..8dc3c88 --- /dev/null +++ b/docs/production-readiness.md @@ -0,0 +1,83 @@ +# c0py — 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://github.com/vera-siax/c0py.git` +- Manifest: `siax.repo.v3.json` — `c0py`, operationalState `building` +- Default branch: `main` +- Bedömd nivå: **INTEGRATION_TESTED** (manifestets DoD-anspråk: nej) +- UI: ja — apps +- CI-arbetsflöden: 2 + +## Git- och arbetsyteläge + +- Aktuell branch: `main` — ahead 0 / behind 0 +- Ocommittade filer: 0 · otrackade: 0 +- Worktrees: 1 +- Lokala grenar: 2 · remote: 6 +- Omergeade lokala grenar: + - `wip/uncommitted-20261109` (+1 commits) + +## 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: 99 +- Testfiler: 16 · E2E: 0 · Playwright: False · Cypress: False +- API-kontrakt: contracts/openapi.yaml +- Migrationer: 2 · Health-referenser: 11 +- `@siax/ui`/tokens: False · a11y-verktyg: False · design-conformance: True +- UI-tillståndsfiler: inga hittade +- TODO/FIXME: 0 + +## Gap mot PRODUCTION_READY + +- `BUILDING_NOT_RELEASED` +- `NO_BACKUP_POLICY` +- `NO_STATUS_DOC` +- `UNMERGED_LOCAL_BRANCHES` + +## Prioriterad backlogg + +| Prio | Åtgärd | Konkret nästa steg | +|---|---|---| +| P0 | Landa grenar | Kör PR-flöde per gren, verifiera CI och merga; radera grenen lokalt och på origin efter merge. | +| 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 | Tillgänglighetsgrind | Aktivera eslint-plugin-jsx-a11y/axe och en blockerande WCAG 2.2-kontroll. | +| P2 | DES1GN-beroende | Använd `@siax/ui` + `@siax/tokens` i stället för lokala kopior av primitiver. | +| 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..80c318d --- /dev/null +++ b/siax/production-gaps.json @@ -0,0 +1,84 @@ +{ + "name": "c0py", + "slug": "c0py", + "origin_url": "https://github.com/vera-siax/c0py.git", + "manifest_file": "siax.repo.v3.json", + "manifest_operational_state": "building", + "assessed_level": "INTEGRATION_TESTED", + "observed_live": null, + "gaps": [ + "BUILDING_NOT_RELEASED", + "NO_BACKUP_POLICY", + "NO_STATUS_DOC", + "UNMERGED_LOCAL_BRANCHES" + ], + "ui": true, + "ui_dirs": [ + "apps" + ], + "prod_domains": [], + "live": [], + "deep": { + "tracked_files": 99, + "test_files": 16, + "e2e_files": 0, + "has_playwright": false, + "has_cypress": false, + "api_contracts": [ + "contracts/openapi.yaml" + ], + "migrations": 2, + "health_refs": 11, + "uses_siax_ui": false, + "has_a11y_tooling": false, + "has_design_conformance": true, + "ui_state_files": [], + "todo_count": 0, + "has_runbook_docs": false, + "has_architecture_docs": true, + "has_status_docs": false + }, + "backlog": [ + { + "priority": "P0", + "task": "Landa grenar", + "next_step": "Kör PR-flöde per gren, verifiera CI och merga; radera grenen lokalt och på origin efter merge." + }, + { + "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": "Tillgänglighetsgrind", + "next_step": "Aktivera eslint-plugin-jsx-a11y/axe och en blockerande WCAG 2.2-kontroll." + }, + { + "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": "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