chore: adopt SIAX Golden Standard docs and configuration
siax-scaffold genererade saknade standardartefakter (arkitektur, säkerhet, ändringslogg, runbooks, CI, devcontainer, licens m.m.) ur repots faktiska filer. DOC-07 lämnas avsiktligt röd till en verklig restore bevisats.
This commit is contained in:
@@ -0,0 +1,5 @@
|
||||
{
|
||||
"name": "accounted",
|
||||
"image": "mcr.microsoft.com/devcontainers/javascript-node:22",
|
||||
"postCreateCommand": "npm ci"
|
||||
}
|
||||
@@ -0,0 +1,11 @@
|
||||
# CI-14 — CODEOWNERS bor i .gitea/, aldrig i .github/ (SEC-25).
|
||||
# Granskning krävs särskilt för kontrakt, deploy och migrationer.
|
||||
|
||||
* @sax3l
|
||||
/contracts/ @sax3l
|
||||
/deploy/ @sax3l
|
||||
/.gitea/ @sax3l
|
||||
/siax.repo.json @sax3l
|
||||
/siax.config.json @sax3l
|
||||
# TODO: lägg till migrationskatalogen när den finns, t.ex.
|
||||
# /packages/db/migrations/ @sax3l
|
||||
@@ -0,0 +1,53 @@
|
||||
name: security
|
||||
# CI-10 — gitleaks, Semgrep, OSV-Scanner, Trivy. Körs på PR, på push mot main
|
||||
# och nattligt. Scannrarna körs som containrar för att inte kräva att runnern
|
||||
# har verktygen installerade (samma mönster som siax-standards egen security.yml).
|
||||
#
|
||||
# FÄLLA (verifierad i siax-standards egen CI-utredning): ett stegnamn som
|
||||
# innehåller ": " (kolon + mellanslag) får Giteas YAML-parser att TYST kasta
|
||||
# bort hela workflowen — den dispatcheras aldrig och syns inte som fel.
|
||||
# Håll därför alla `name:`-rader på steg i ren ASCII utan kolon-mellanslag.
|
||||
#
|
||||
# TODO (CI-10, ej wired av scaffolden): licenskontroll kräver ett policybeslut
|
||||
# om vilka licenser som är tillåtna — lägg till steget när listan finns.
|
||||
on:
|
||||
push: { branches: [main] }
|
||||
pull_request: {}
|
||||
schedule:
|
||||
- cron: "17 2 * * *"
|
||||
permissions: { contents: read }
|
||||
concurrency:
|
||||
group: security-${{ github.ref }}
|
||||
cancel-in-progress: true
|
||||
|
||||
jobs:
|
||||
scan:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
with: { fetch-depth: 0 }
|
||||
|
||||
# gitleaks over worktree and history (REPO-15, SEC-01)
|
||||
- name: gitleaks secret scan
|
||||
run: |
|
||||
docker run --rm -v "$PWD:/repo" -w /repo \
|
||||
zricethezav/gitleaks:latest detect --source /repo --no-banner --exit-code 1
|
||||
|
||||
# Trivy filsystem, blockerar på HIGH och CRITICAL (SUP-*)
|
||||
- name: Trivy filesystem scan
|
||||
run: |
|
||||
docker run --rm -v "$PWD:/repo" -w /repo \
|
||||
aquasec/trivy:latest fs --scanners vuln,secret,misconfig \
|
||||
--severity HIGH,CRITICAL --exit-code 1 --no-progress /repo
|
||||
|
||||
# Kända sårbarheter i lockfilen
|
||||
- name: OSV Scanner
|
||||
run: |
|
||||
docker run --rm -v "$PWD:/repo" -w /repo \
|
||||
ghcr.io/google/osv-scanner:latest scan source --recursive /repo
|
||||
|
||||
# Statisk kodanalys, felallvarlighet bryter bygget
|
||||
- name: Semgrep code scan
|
||||
run: |
|
||||
docker run --rm -v "$PWD:/src" -w /src \
|
||||
semgrep/semgrep:latest semgrep scan --config=p/ci --error --quiet
|
||||
@@ -0,0 +1,4 @@
|
||||
@siax:registry=https://git.siax.io/api/packages/siax/npm/
|
||||
//git.siax.io/api/packages/siax/npm/:_authToken=${NODE_AUTH_TOKEN}
|
||||
engine-strict=true
|
||||
fund=false
|
||||
+113
@@ -0,0 +1,113 @@
|
||||
# Ändringslogg — accounted
|
||||
|
||||
Alla väsentliga ändringar dokumenteras här. Filen är genererad ur repots
|
||||
git-historik av `siax-scaffold` (DOC-11) och ska uppdateras när historiken
|
||||
ändras; den ska aldrig handredigeras med påståenden som inte finns i git.
|
||||
|
||||
Formatet följer [Keep a Changelog](https://keepachangelog.com/sv/1.1.0/).
|
||||
|
||||
## [Unreleased]
|
||||
|
||||
Nästa version. Nya poster läggs överst när de mergas.
|
||||
|
||||
## 2026-11-09
|
||||
|
||||
- docs(production): standardiserad produktionsberedskap och gap-analys (`b3003f8a`)
|
||||
|
||||
## 2026-11-05
|
||||
|
||||
- chore(ui): document upstream/legacy component exceptions (`9a3de47b`)
|
||||
|
||||
## 2026-11-04
|
||||
|
||||
- fix(recovery): use the schema-valid 30d retention in accounted's backup record (`ca226cce`)
|
||||
- chore(recovery): record the accounted backup policy and repo restore drill (`16a69a0f`)
|
||||
|
||||
## 2026-10-31
|
||||
|
||||
- fix(deps): next 16.4.1 (GHSA-2464-fhr4-w9xw CRITICAL RCE) (`d7253f1b`)
|
||||
|
||||
## 2026-09-30
|
||||
|
||||
- fix(deps): next 16.3.3 -> 16.3.6 (GHSA-vcvr-r3jv-pc5j, CRITICAL) (`ddc4cce3`)
|
||||
- fix(deps): patch HIGH/CRITICAL advisories (`0250b4ba`)
|
||||
- fix(pay): payment-consumer-deklaration med äkta PSP-SDK-scope (Stripe webhook/checkout/connect/sync — kodverifierat) (`4269404a`)
|
||||
|
||||
## 2026-09-28
|
||||
|
||||
- chore(ci): koppla in SonarQube-analys mot självhostad sonar.siax.io (`73d24a81`)
|
||||
|
||||
## 2026-09-27
|
||||
|
||||
- fix(ci): add timeout-minutes and concurrency guard to masterplan-lock (`f6871581`)
|
||||
|
||||
## 2026-09-24
|
||||
|
||||
- fix(worklist): countSkattekontoPaymentDue accepts today — test time-bomb (due date 2026-09-12 expired vs wall clock) (`5d9b220f`)
|
||||
- fix(ci): use internal pinned action mirrors (github.com egress flaky from runners) (`a9090431`)
|
||||
- chore(deps): update dependency vitest to v4.1.11 (`14e6aead`)
|
||||
- chore(deps): update dependency mailparser to v3.9.28 (`4986cfe2`)
|
||||
- feat(estate): härlett siax.repo.v3.json (estate-manifest-gen v0) (`48c762f7`)
|
||||
|
||||
## 2026-09-23
|
||||
|
||||
- chore(deps): update dependency jszip to v3.10.2 (`592cfd1e`)
|
||||
- chore(deps): update dependency eslint to v9.39.5 (`3299eeec`)
|
||||
|
||||
## 2026-09-22
|
||||
|
||||
- chore(deps): update dependency @upstash/redis to v1.38.4 (`5aabd3d4`)
|
||||
- chore(deps): update dependency @supabase/ssr to v0.12.7 (`1169e0dd`)
|
||||
- fix(deps): replace dependency framer-motion with motion (`8ef8e8bb`)
|
||||
|
||||
## 2026-09-21
|
||||
|
||||
- chore(backup): initial backup-policy post (RW-002 automat) — källa: flottloggar (`0b296b92`)
|
||||
|
||||
## 2026-09-15
|
||||
|
||||
- feat(toolchain): W4-slutvåg — mise task-kontrakt (genererad ur toolchain-discovery) + lefthook + template-pin + dokumentation (`42241a9a`)
|
||||
- feat(toolchain): W4-slutvåg — mise task-kontrakt + lefthook + template-pin + dokumentation (`07eb82af`)
|
||||
|
||||
## 2026-09-11
|
||||
|
||||
- Add renovate.json (`97e17964`)
|
||||
|
||||
## 2026-09-10
|
||||
|
||||
- fix(plan): komplettera lock-scriptet-krav (aldrig egen SQL, frontend-tenant-trust, PRODUCTION_READY) (`5b7015d8`)
|
||||
- feat(scaffold): SIAX masterplan-lock-gate + PLAN/MASTERPLAN_INDEX.md integrering (`d8463e7f`)
|
||||
- feat(dashboard): dismissible system notice banner for every signed-in user (#2464) (`51f05ffe`)
|
||||
|
||||
## 2026-09-09
|
||||
|
||||
- feat(import): keep the source system's #BTRANS/#RTRANS correction history at SIE import (#2458) (`a84d2723`)
|
||||
- feat(reports): list a booked 8999 in Resultatrapport instead of hiding it (#2457) (`9a8291f4`)
|
||||
- feat(settings): rename learned counterparty templates (#2454) (`e996d709`)
|
||||
- fix(import): chunk SIE account creation and close the import row on every exit (#2451) (`bb289681`)
|
||||
- feat(onboarding): the orgnr step suggests companies as you type (SCB search, TIC on the pick) (#2452) (`fc2d78a7`)
|
||||
- fix(bank): unchecked accounts yield their bokföringskonto to a checked one in the picker (#2449) (`cb9eedd7`)
|
||||
- feat(zettle): sync paid purchases into webshop_orders (#2445) (`6ea92f31`)
|
||||
|
||||
## 2026-09-08
|
||||
|
||||
- fix(agent): the assistant reaches earlier räkenskapsår: period resolved from dates, years listed in the grounding (#2436) (`500806f0`)
|
||||
- feat(worklist): the next Skatteverket payment with bankgiro, OCR and due date under Att göra on Hem (#2435) (`20925f6c`)
|
||||
- feat(kpi): monthly revenue, expenses and result table under Nyckeltal, toggle in Anpassa (#2433) (`a7dcaac6`)
|
||||
- feat(transactions): pick several ROT/RUT begäran by hand for one Skatteverket transfer (#2431) (`5e2498bc`)
|
||||
- feat(invoices): ROT/RUT begäran status as a column and filter in the invoice list (#2434) (`d5373cd6`)
|
||||
- feat(invoices): offert to kundorder, the missing step in offert, order, faktura (#2442) (`9782f80d`)
|
||||
- feat(invoices): diagonal UTKAST/DRAFT watermark on draft PDFs instead of the top-margin banner (#2441) (`32721b9f`)
|
||||
- fix(bookkeeping): negative item rows book on the opposite side, never as negative amounts (#2439) (`2d49a815`)
|
||||
- fix(ui): clip the flexible list cell on the rows #2003 missed (#2284) (`c091a7f2`)
|
||||
- fix(bookkeeping): send each missing-underlag lookup chunk once per URL (#2430) (`2f787a2b`)
|
||||
- fix(invoice-inbox): make the extraction prompt fill invoiceDate on receipts (#2429) (`b2b714f8`)
|
||||
- feat(company): ideell förening as a third legal form, behind a flag (#2072 step 1) (#2423) (`26e29f47`)
|
||||
- feat(onboarding): the orgnr field also accepts a company name (#2421) (`1157ff1b`)
|
||||
- fix(migrations): re-issue the 12xx label backfill inside an explicit transaction block (#2422) (`5987523a`)
|
||||
- feat(arsredovisning): manual override for medelantal anställda (Not 2) (#2420) (`e85eac31`)
|
||||
- fix(bookkeeping): name 1249/1259/1269 after their BAS 2026 free heads, drop retired 12xx sub-accounts (#2419) (`59d5b7b3`)
|
||||
|
||||
---
|
||||
|
||||
Genererad: 2026-11-10. Underlag: `git log --no-merges` (senaste 50 commits).
|
||||
@@ -0,0 +1,10 @@
|
||||
# DX-02 — lokala beroenden för ACCOUNTED.
|
||||
#
|
||||
# TODO: deklarera repots FAKTISKA lokala beroenden (databas, cache, objektlager,
|
||||
# meddelandebuss …) så att DX-01 håller: ett kommando ska resa allt lokalt, utan
|
||||
# åtkomst till produktion.
|
||||
#
|
||||
# Tomt värde nedan betyder "repot har inga lokala beroenden". Scaffolden kan
|
||||
# inte veta om det är sant — den lämnar det tomt i stället för att hitta på
|
||||
# tjänster som ingen kör.
|
||||
services: {}
|
||||
@@ -0,0 +1,33 @@
|
||||
# API-01 — kontraktet är källan till sanning för hela HTTP-ytan.
|
||||
#
|
||||
# TODO: DETTA ÄR ETT SKELETT. Det beskriver ännu INGEN route. Doctorns API-01 är
|
||||
# en ren existenskontroll och blir grön av den här filen — men API-02 (ingen
|
||||
# route utanför kontraktet), API-03 (lint) och API-04 (generering) förblir röda
|
||||
# tills ytan faktiskt är beskriven. Grönt API-01 med tomt `paths` betyder
|
||||
# "filen finns", ingenting annat.
|
||||
openapi: 3.1.0
|
||||
info:
|
||||
title: ACCOUNTED API
|
||||
version: 0.0.0
|
||||
description: |
|
||||
SKELETT genererat av siax-scaffold. Beskriver ännu ingen operation.
|
||||
Fyll i hela HTTP-ytan, ge varje operation ett operationId och en
|
||||
risknivå (x-siax-risk, API-12), och generera typer/klient från denna fil.
|
||||
x-siax-scaffold: TODO-ofullstandigt
|
||||
servers:
|
||||
- url: https://TODO.siax.io
|
||||
description: TODO: verklig bas-URL per miljö
|
||||
paths: {}
|
||||
components:
|
||||
schemas:
|
||||
Problem:
|
||||
# API-07 — RFC 9457 Problem Details, enhetligt felformat i hela estatet.
|
||||
type: object
|
||||
properties:
|
||||
type: { type: string }
|
||||
title: { type: string }
|
||||
status: { type: integer }
|
||||
detail: { type: string }
|
||||
instance: { type: string }
|
||||
traceId: { type: string }
|
||||
code: { type: string }
|
||||
@@ -0,0 +1,74 @@
|
||||
# Arkitektur — ACCOUNTED
|
||||
|
||||
> **Status:** automatisk första version, genererad av `siax-scaffold` ur repots
|
||||
> faktiska filer. Den beskriver vad som finns, inte vad som är bestämt. Läs
|
||||
> igenom, rätta och fyll i avsnitten som är markerade TODO innan dokumentet
|
||||
> betraktas som en arkitekturbeskrivning (ARK-serien).
|
||||
|
||||
Senast verifierad mot kod: 2026-11-10
|
||||
|
||||
## 1. Översikt
|
||||
|
||||
| Fält | Värde |
|
||||
| --- | --- |
|
||||
| Repo | `accounted` |
|
||||
| Körtid | node |
|
||||
| Ramverk | Next.js |
|
||||
| Paketnamn | `erp-base` |
|
||||
| Domäner i `siax.config.json` | inga |
|
||||
|
||||
|
||||
## 2. Komponenter
|
||||
|
||||
Toppnivåkataloger som innehåller kod eller konfiguration (härledda ur filträdet):
|
||||
|
||||
| Katalog | Roll |
|
||||
| --- | --- |
|
||||
| `packages/` | TODO: beskriv katalogens roll (packages) |
|
||||
| `lib/` | TODO: beskriv katalogens roll (lib) |
|
||||
| `scripts/` | TODO: beskriv katalogens roll (scripts) |
|
||||
| `docs/` | TODO: beskriv katalogens roll (docs) |
|
||||
| `tests/` | TODO: beskriv katalogens roll (tests) |
|
||||
|
||||
Undermoduler som är deklarerade i `children[]`:
|
||||
|
||||
| Sökväg | Syfte |
|
||||
| --- | --- |
|
||||
| — | Inga undermoduler (apps/, packages/, services/) finns. |
|
||||
|
||||
## 3. Startpunkter
|
||||
|
||||
| Fil | Typ |
|
||||
| --- | --- |
|
||||
| — | Ingen startpunkt hittades i `package.json`, `pyproject.toml` eller `Dockerfile`. |
|
||||
|
||||
## 4. Språk och filfördelning
|
||||
|
||||
| Ändelse | Omfattning |
|
||||
| --- | --- |
|
||||
| .ts | 3878 filer |
|
||||
| .tsx | 667 filer |
|
||||
| .mjs | 21 filer |
|
||||
| .sh | 8 filer |
|
||||
| .js | 3 filer |
|
||||
| .py | 2 filer |
|
||||
|
||||
## 5. Dataflöde
|
||||
|
||||
TODO: beskriv hur data rör sig genom repot: inkommande anrop/jobb → lagring → utdata, och vilka externa system som anropas. Scaffolden kan inte härleda detta ur filerna.
|
||||
|
||||
## 6. Gränser och beroenden
|
||||
|
||||
TODO: lista vilka SIAX-komponenter repot äger respektive konsumerar (REUSE FIRST), samt vilka kontrakt som är stabila utåt. Se `siax.repo.json` → `consumes`/`consumedBy`.
|
||||
|
||||
## 7. Drift och miljöer
|
||||
|
||||
Ingen `siax.config.json` finns — repot är inte deklarerat som driftsatt. Om det driftsätts ska `siax.config.json` skapas först (REPO-06).
|
||||
|
||||
TODO: verifiera mot faktisk nod och `docker ps` (GOV-06). Ett dokument får inte påstå drift som inte är mätt.
|
||||
|
||||
## 8. Källhänvisning
|
||||
|
||||
- Genererad: 2026-11-10 av `siax-scaffold` (scaffold 2026-11-09).
|
||||
- Underlag: filträdet, `package.json`/`pyproject.toml`, `Dockerfile`, `siax.repo.json`.
|
||||
- Ändringslogg: se `CHANGELOG.md` och git-historiken.
|
||||
@@ -0,0 +1,47 @@
|
||||
# SCAFFOLD-TODO — vad som är härlett och vad som måste verifieras
|
||||
|
||||
**Genererad:** 2026-11-10 av `siax-scaffold` (siax-standard,
|
||||
`packages/scaffold`) mot Golden Standard v2.0.
|
||||
|
||||
Den här filen finns för att en mall inte får låtsas veta saker. Varje rad nedan
|
||||
är antingen **härledd ur repot** (källan står i kolumn 3) eller ett
|
||||
**konservativt defaultvärde** som en människa måste bekräfta. Radera raden när
|
||||
den är verifierad — filen ska till slut kunna tas bort helt.
|
||||
|
||||
## Härledda värden i `siax.repo.json`
|
||||
|
||||
| Fält | Värde | Härlett ur |
|
||||
|---|---|---|
|
||||
| `repo` | `ACCOUNTED` | `git remote.origin.url` (VERSALER per REPO-08) |
|
||||
| `codeowners` | `["@sax3l"]` | default (organisationens ägare) |
|
||||
| `category` | `platform` | DEFAULT — ej härledbart |
|
||||
| `subcategory` | `TODO: fyll i underkategori (t.ex. compute-os, saas-ersättare)` | TODO-markör |
|
||||
| `operationalState` | `degraded` | driftsartefakter finns (Dockerfile) — EJ VERIFIERAT driftläge |
|
||||
| `domains` | `0 st` | inga funna |
|
||||
| `children` | `3 st` | faktiska kataloger under apps/, packages/, services/ |
|
||||
| `packageName` | `erp-base` | `package.json` → name |
|
||||
|
||||
## Måste verifieras av människa
|
||||
|
||||
- [ ] Bekräfta `codeowners` — scaffolden defaultade till `@sax3l` (CI-14).
|
||||
- [ ] Verifiera `category` i `siax.repo.json` mot den kanoniska taxonomin och CL0UD APP_REGISTRY (GOV-01/REPO-05). Scaffolden defaultade till `platform` — den kan inte veta.
|
||||
- [ ] Fyll i `subcategory` i `siax.repo.json` (REPO-04).
|
||||
- [ ] Rätta `operationalState` mot verkligheten (`docker ps` på noden, GOV-06). Scaffolden satte `degraded` eftersom driftsartefakter finns men driftläget inte går att mäta från filsystemet — det är det konservativa valet som HÅLLER REPO-06/CD-01/API-01 aktiva i doctorn i stället för att tysta dem.
|
||||
- [ ] Beskriv varje post i `children[]` — sökvägarna är härledda ur filträdet, syftet är inte (ARK-11).
|
||||
- [ ] Beskriv hela HTTP-ytan i `contracts/openapi.yaml` — skelettet gör API-01 grön men API-02/03/04 förblir röda.
|
||||
- [ ] Fastställ `appId` mot CL0UD APP_REGISTRY och ta bort `appIdJustification` (REPO-05).
|
||||
- [ ] Fyll i consumes[] och consumedBy[] från FAS 2-beroendekartan — de får aldrig gissas.
|
||||
- [ ] Fyll i `node` (server5–server11) i `siax.repo.json`, eller lämna `null` om repot inte driftsätts.
|
||||
- [ ] Kör återställningen skarpt och skriv in datumet i `docs/runbook/backup-restore.md` (DOC-07).
|
||||
|
||||
## Kontroller som scaffolden AVSIKTLIGT lämnar röda
|
||||
|
||||
- **REPO-05** — `appId` är `null` med motivering. Ett påhittat appId skulle se konformt ut och peka på ingenting i CL0UD APP_REGISTRY.
|
||||
- **DOC-07** — `docs/runbook/backup-restore.md` saknar datum för bevisad restore. Scaffolden skriver aldrig in ett datum: kontrollen letar efter ett datum, och ett genererat sådant skulle göra den grön utan att någon återställning ägt rum. Kör återställningen, skriv in datumet.
|
||||
- **API-02/03/04** — ett genererat kontraktsskelett beskriver ingen route.
|
||||
|
||||
|
||||
---
|
||||
|
||||
_Genererad av `siax-scaffold` (siax-standard). Varje `TODO:` i filen måste
|
||||
fyllas i av en människa. Samlad lista: `docs/compliance/SCAFFOLD-TODO.md`._
|
||||
@@ -0,0 +1,36 @@
|
||||
# Backup & restore
|
||||
|
||||
## Vad som säkerhetskopieras
|
||||
|
||||
TODO: lista varje tillstånd repot äger — databas, volymer, objektlager,
|
||||
hemligheter. Sådant som inte står här är inte säkerhetskopierat.
|
||||
|
||||
| Tillstånd | Var | Frekvens | Retention |
|
||||
|---|---|---|---|
|
||||
| TODO | TODO | TODO | TODO |
|
||||
|
||||
## Återställning — steg
|
||||
|
||||
1. TODO: exakt kommando för att hämta senaste dumpen.
|
||||
2. TODO: exakt kommando för att läsa in den.
|
||||
3. TODO: hur du verifierar att data faktiskt är tillbaka (räkna rader, anropa
|
||||
en endpoint) — inte bara att kommandot gav exit 0.
|
||||
|
||||
## Senast bevisad restore
|
||||
|
||||
**EJ BEVISAD.**
|
||||
|
||||
TODO: kör återställningen skarpt mot en tom miljö och skriv in datumet här på
|
||||
formen ÅÅÅÅ-MM-DD tillsammans med vem som körde den och vad som verifierades.
|
||||
|
||||
> Detta fält är avsiktligt tomt. `siax-scaffold` skriver ALDRIG in ett datum
|
||||
> här: DOC-07 letar efter ett datum, och ett genererat datum skulle göra
|
||||
> kontrollen grön utan att någon återställning ägt rum. Kontrollen ska förbli
|
||||
> röd tills påståendet är sant.
|
||||
|
||||
**RTO/RPO:** TODO: mät, gissa inte.
|
||||
|
||||
---
|
||||
|
||||
_Genererad av `siax-scaffold` (siax-standard). Varje `TODO:` i filen måste
|
||||
fyllas i av en människa. Samlad lista: `docs/compliance/SCAFFOLD-TODO.md`._
|
||||
@@ -0,0 +1,26 @@
|
||||
# Deploy
|
||||
|
||||
TODO: `siax.config.json` saknas (REPO-06) — fyll i framework, build,
|
||||
start, port, healthcheck och per-miljö-domän, och spegla dem här.
|
||||
|
||||
## Steg
|
||||
|
||||
1. TODO: hur en ändring når drift (börvärde i estatet: merge till `main` →
|
||||
`.gitea/workflows/cd.yml` → Coolify-webhook på den nod repot bor på).
|
||||
Skriv det som FAKTISKT sker — inte det som borde ske (DOC-19).
|
||||
2. TODO: hur du verifierar att den nya versionen kör (healthcheck-URL, exakt
|
||||
`curl`-kommando och förväntat svar).
|
||||
3. TODO: rollback — exakt kommando/knapp och hur lång tid det tar (CD-*).
|
||||
|
||||
## Förutsättningar
|
||||
|
||||
- Hemligheter hämtas från Infisical, aldrig ur repot (AR-6, SEC-01).
|
||||
- TODO: vilka env-nycklar som måste finnas innan deploy.
|
||||
|
||||
**Runbooken ska vara körbar av någon som inte byggt systemet (DOC-06).**
|
||||
Så länge något `TODO` står kvar är den inte det.
|
||||
|
||||
---
|
||||
|
||||
_Genererad av `siax-scaffold` (siax-standard). Varje `TODO:` i filen måste
|
||||
fyllas i av en människa. Samlad lista: `docs/compliance/SCAFFOLD-TODO.md`._
|
||||
@@ -0,0 +1,35 @@
|
||||
# Incident
|
||||
|
||||
## 1. Bekräfta
|
||||
|
||||
TODO: exakt kommando/URL som visar om tjänsten lever (healthcheck, `docker ps`
|
||||
på noden, dashboard). Ett incidentsvar börjar alltid med en mätning.
|
||||
|
||||
## 2. Klassa
|
||||
|
||||
| Läge | Innebörd | Åtgärd |
|
||||
|---|---|---|
|
||||
| Nere | ingen trafik betjänas | eskalera direkt, se `oncall.md` |
|
||||
| Degraderad | fel/latens över SLO | TODO: tröskelvärden ur `docs/slo.md` (OBS-10) |
|
||||
| Kosmetiskt | ingen kundpåverkan | ärende, inte incident |
|
||||
|
||||
## 3. Vanliga orsaker (fylls på efter varje incident)
|
||||
|
||||
- TODO: känd felkälla 1 — symptom, kommando som bekräftar, åtgärd.
|
||||
- TODO: känd felkälla 2.
|
||||
|
||||
## 4. Återställ
|
||||
|
||||
1. TODO: rollback enligt `deploy.md`.
|
||||
2. TODO: om data är påverkad — följ `backup-restore.md` (och notera att
|
||||
återställningen då faktiskt är bevisad, DOC-07).
|
||||
|
||||
## 5. Efterarbete
|
||||
|
||||
Postmortem i `docs/incidents/` — orsak, tidslinje, vad som saknades i
|
||||
mätningen, vilken kontroll som skulle ha fångat det. Aldrig skuld på person.
|
||||
|
||||
---
|
||||
|
||||
_Genererad av `siax-scaffold` (siax-standard). Varje `TODO:` i filen måste
|
||||
fyllas i av en människa. Samlad lista: `docs/compliance/SCAFFOLD-TODO.md`._
|
||||
@@ -0,0 +1,21 @@
|
||||
# Oncall
|
||||
|
||||
**Jour:** TODO: vem som svarar, på vilken kanal, inom vilken tid. Står här
|
||||
"ingen jour" ska det vara ett medvetet beslut — inte en glömska.
|
||||
|
||||
**Eskalering:** TODO: namn + kontaktväg. Sista instans i estatet: Simon
|
||||
(goat@siax.io).
|
||||
|
||||
**Innan du väcker någon:**
|
||||
|
||||
1. Kör bekräftelsesteget i `incident.md` §1.
|
||||
2. Kolla om det finns en känd orsak i `incident.md` §3.
|
||||
3. TODO: länk till dashboard/larm (OBS-06/OBS-08).
|
||||
|
||||
**Larmvägar:** TODO: vilka larm som faktiskt är kopplade. Ett larm som ingen
|
||||
tar emot är inget larm.
|
||||
|
||||
---
|
||||
|
||||
_Genererad av `siax-scaffold` (siax-standard). Varje `TODO:` i filen måste
|
||||
fyllas i av en människa. Samlad lista: `docs/compliance/SCAFFOLD-TODO.md`._
|
||||
@@ -0,0 +1,24 @@
|
||||
# Prompt-index — ACCOUNTED
|
||||
|
||||
| # | Prompt | Status | Beroende |
|
||||
|---|---|---|---|
|
||||
| — | _inga numrerade prompts ännu_ | — | — |
|
||||
|
||||
## Öppet, ännu inte brutet till numrerade prompts
|
||||
|
||||
Punkterna nedan hittades av `siax-scaffold` när mallarna lades in. Var och en
|
||||
ska bli en egen `NNN-<slug>.md` enligt mallen i DEL 5.5 av standarden, med
|
||||
maskinellt verifierbara acceptanskriterier och kontroll-ID (AGENT-03).
|
||||
|
||||
- Bekräfta `codeowners` — scaffolden defaultade till `@sax3l` (CI-14).
|
||||
- Verifiera `category` i `siax.repo.json` mot den kanoniska taxonomin och CL0UD APP_REGISTRY (GOV-01/REPO-05). Scaffolden defaultade till `platform` — den kan inte veta.
|
||||
- Fyll i `subcategory` i `siax.repo.json` (REPO-04).
|
||||
- Rätta `operationalState` mot verkligheten (`docker ps` på noden, GOV-06). Scaffolden satte `degraded` eftersom driftsartefakter finns men driftläget inte går att mäta från filsystemet — det är det konservativa valet som HÅLLER REPO-06/CD-01/API-01 aktiva i doctorn i stället för att tysta dem.
|
||||
- Beskriv varje post i `children[]` — sökvägarna är härledda ur filträdet, syftet är inte (ARK-11).
|
||||
|
||||
Fullständig lista med härledda värden som måste verifieras: `docs/compliance/SCAFFOLD-TODO.md`.
|
||||
|
||||
---
|
||||
|
||||
_Genererad av `siax-scaffold` (siax-standard). Varje `TODO:` i filen måste
|
||||
fyllas i av en människa. Samlad lista: `docs/compliance/SCAFFOLD-TODO.md`._
|
||||
@@ -0,0 +1,13 @@
|
||||
{
|
||||
"_comment": "Genererad av siax-scaffold ur package.json/Dockerfile. Verifiera build, start, port och healthcheck mot faktisk container innan deploy (REPO-06).",
|
||||
"framework": "Next.js",
|
||||
"build": "npm run run build",
|
||||
"start": "npm run run start",
|
||||
"port": 3000,
|
||||
"healthcheck": "/health",
|
||||
"environments": {
|
||||
"production": {
|
||||
"domain": "TODO: produktionsdomän — sätts när tjänsten får en FQDN"
|
||||
}
|
||||
}
|
||||
}
|
||||
+117
@@ -0,0 +1,117 @@
|
||||
{
|
||||
"$schema": "https://git.siax.io/sax3l/siax-standard/raw/branch/main/schema/siax.repo.v3.schema.json",
|
||||
"standardVersion": "3.0",
|
||||
"repo": "ACCOUNTED",
|
||||
"category": "platform",
|
||||
"subcategory": "TODO: fyll i underkategori (t.ex. compute-os, saas-ersättare)",
|
||||
"appId": null,
|
||||
"appIdJustification": "TODO: appId ej fastställt. Genererat av siax-scaffold, som inte kan slå upp CL0UD APP_REGISTRY. Ett påhittat appId hade sett konformt ut och pekat på ingenting (REPO-05).",
|
||||
"capabilityPrefix": "accounted",
|
||||
"owner": "SIAX Technology AB",
|
||||
"lifecycle": "active",
|
||||
"operationalState": "degraded",
|
||||
"gitHost": "git.siax.io",
|
||||
"node": null,
|
||||
"packageName": "erp-base",
|
||||
"domains": [],
|
||||
"consumes": [],
|
||||
"consumedBy": [],
|
||||
"children": [
|
||||
{
|
||||
"path": "packages/accounted-mcp",
|
||||
"purpose": "TODO: beskriv modulens syfte",
|
||||
"lifecycle": "active"
|
||||
},
|
||||
{
|
||||
"path": "packages/connect-contract",
|
||||
"purpose": "TODO: beskriv modulens syfte",
|
||||
"lifecycle": "active"
|
||||
},
|
||||
{
|
||||
"path": "packages/gnubok-mcp",
|
||||
"purpose": "TODO: beskriv modulens syfte",
|
||||
"lifecycle": "active"
|
||||
}
|
||||
],
|
||||
"replacesSaaS": [],
|
||||
"tier": "product",
|
||||
"canonical": true,
|
||||
"parentRepo": null,
|
||||
"capabilities": [],
|
||||
"surfaces": [
|
||||
"api"
|
||||
],
|
||||
"identity": {
|
||||
"workloadIdentity": false,
|
||||
"tenantScoped": true
|
||||
},
|
||||
"persistence": {
|
||||
"stateful": false,
|
||||
"database": "none",
|
||||
"storage": "none"
|
||||
},
|
||||
"deployment": {
|
||||
"node": null,
|
||||
"dedicated": false
|
||||
},
|
||||
"observability": {
|
||||
"health": false,
|
||||
"ready": false,
|
||||
"metrics": false
|
||||
},
|
||||
"reliability": {
|
||||
"backupFrequency": "none",
|
||||
"provenRestore": false
|
||||
},
|
||||
"engines": [],
|
||||
"licenses": {
|
||||
"spdx": "LicenseRef-SIAX-Proprietary",
|
||||
"approved": false
|
||||
},
|
||||
"productionEvidence": {
|
||||
"verified": false
|
||||
},
|
||||
"discovery": {
|
||||
"enabled": true,
|
||||
"profile": "FULL_DISCOVERY",
|
||||
"changeCapture": {
|
||||
"strategy": "transactional_outbox",
|
||||
"fallback": "cdc"
|
||||
},
|
||||
"classification": {
|
||||
"default": "internal",
|
||||
"failClosed": true
|
||||
},
|
||||
"pii": {
|
||||
"detectionRequired": false,
|
||||
"detectorRef": "TODO: sätt om repot rör persondata"
|
||||
},
|
||||
"lineage": {
|
||||
"required": true
|
||||
},
|
||||
"deletion": {
|
||||
"propagationRequired": true
|
||||
},
|
||||
"retention": {
|
||||
"policyRef": "TODO: retention-policy (t.ex. operational_30d, permanent)"
|
||||
},
|
||||
"projections": [],
|
||||
"exclusions": []
|
||||
},
|
||||
"decision": {
|
||||
"policies": [],
|
||||
"consumes": [
|
||||
"decision.choice",
|
||||
"decision.score",
|
||||
"decision.boolean"
|
||||
],
|
||||
"deterministicOnly": false
|
||||
},
|
||||
"runtime": {
|
||||
"language": "node-esm",
|
||||
"packageManager": "pnpm"
|
||||
},
|
||||
"contracts": {
|
||||
"openapi": "contracts/openapi.yaml"
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user