docs: FAS 9 - README/SECURITY updates, CONTRIBUTING, AGENTS, runbooks (deploy/incident/backup-restore/oncall), SLO, prompts
This commit is contained in:
@@ -0,0 +1,56 @@
|
||||
# AGENTS.md — 0pt
|
||||
|
||||
> Operativ brief för AI-agenter (Claude Code / opencode / liknande) som arbetar
|
||||
> i detta repo. Läs `CLAUDE.md` + `docs/compliance/` innan du gör ändringar.
|
||||
|
||||
## Vad det här är
|
||||
|
||||
0pt = SIAX Clouds Data OS: företags-/kontakt-/fordonsdata, enrichment,
|
||||
entity-resolution, provenance per fält, adaptive router, orderflöde med
|
||||
50/50-escrow. Next.js 16-webapp + FastAPI-engine + Python-skrapmotor i samma träd.
|
||||
|
||||
## Första steget
|
||||
|
||||
1. `git pull` (Gitea: `git.siax.io/sax3l/0pt` — det är canonical remote, ej GitHub).
|
||||
2. Läs `CLAUDE.md` (kontraktet), `docs/architecture/ARCHITECTURE.md` (vad koden
|
||||
verkligen gör, inkl. kända luckor S1–S12), `docs/compliance/` (status).
|
||||
3. Kontrollera senaste CI-run (Gitea Actions) om du ska verifiera "grön".
|
||||
|
||||
## Viktiga förhållanden
|
||||
|
||||
- **Bypass-stacken** (`services/scrapers/*`, `waf_bypass.py`, data-stack-compose,
|
||||
`adaptive_router.py`) är **medvetet behållen per användarbeslut** — rör den inte,
|
||||
och nämn alltid "medvetet användarbeslut" om den dyker upp i compliance-rapporter.
|
||||
- **Auth:** `/api/0pt/*` fail-closed i kod (Zitadel via middleware), men live-instansen
|
||||
svarade 2026-08-10 anonymt 200 (lucka S1 — rotorsaksanalys ej klar). Påstå aldrig
|
||||
att produktionen är skyddad innan en anonym request fått 401.
|
||||
- **Tenant-id** får aldrig tas från request-body — idag gör handlers det (S2); nya
|
||||
handlers ska läsa `x-0pt-verified-tenant`-headern.
|
||||
- **Sanning:** repot har en stark anti-fabricering-konvention (docs korrigerar
|
||||
README). Om något påstås vara byggt men inte finns: skriv "inte byggt", fabricera inte.
|
||||
- **Skyddade sökvägar:** `.gitea/workflows/**` + `.gitignore` — ändringar går via PR.
|
||||
- **Fonts:** självhämtade via `@fontsource-variable/*` — lägg aldrig tillbaka
|
||||
`next/font/google` eller `@vercel/*`.
|
||||
- **Secrets:** aldrig i repo. Infisical (`vault.siax.io`), env via `process.env.*`.
|
||||
- **Docker:** multi-stage, icke-root (`USER node`), ingen tsx i prod, healthcheck
|
||||
mot `/api/health`.
|
||||
|
||||
## Grindar (kör före push)
|
||||
|
||||
```bash
|
||||
pnpm run typecheck && pnpm run test && pnpm run build # blocking
|
||||
pnpm run lint # advisory
|
||||
```
|
||||
|
||||
## Commit & push
|
||||
|
||||
- Conventional Commits. Push direkt till `main` är OK för icke-skyddade filer,
|
||||
men om du rör skyddade sökvägar: branch → PR.
|
||||
- Lämna aldrig en förgrenad `origin`/`github.com`-remote som sanningskälla —
|
||||
Gitea är primärt (Simon-direktiv 2026-07-14).
|
||||
|
||||
## Vid osäkerhet
|
||||
|
||||
Fråga Simon (simon@siax.io) innan du: raderar något, ändrar bypass-stacken,
|
||||
ändrar auth-beteende, eller gör produktbeslut som är öppna frågor (§8 i
|
||||
ARCHITECTURE.md).
|
||||
@@ -0,0 +1,57 @@
|
||||
# Contributing — 0pt
|
||||
|
||||
> 0pt (SIAX Cloud Data OS) är proprietär mjukvara från SIAX Technology AB.
|
||||
> Interna bidrag följer konventionerna nedan. Externt: kontakta
|
||||
> `security@siax.io` / `simon@siax.io` innan bidrag.
|
||||
|
||||
## Repo-ryggrad
|
||||
|
||||
- **Kategori:** platform (K1) · **Subkategori:** data-os · **SSOT:**
|
||||
[`siax.repo.json`](siax.repo.json) + [`siax.config.json`](siax.config.json)
|
||||
- **Kontrakt:** [`contracts/openapi.yaml`](contracts/openapi.yaml) — alla
|
||||
API-ändringar börjar här (SSOT), sedan routehandler.
|
||||
- **Dokumentation:** `CLAUDE.md` först, sedan `docs/` och `docs/compliance/`.
|
||||
Om kod och docs avviker: skriv avvikelsen, fabricera inte.
|
||||
|
||||
## Hårda regler (bryt aldrig)
|
||||
|
||||
1. **AR-1** — radera aldrig befintlig funktionalitet/endpoint. Bygg färdigt.
|
||||
Undantag: `services/scrapers/*` + `services/infra/docker-compose.data-stack.yml`
|
||||
är **medvetet behållna per användarbeslut** — rör dem inte.
|
||||
2. **AR-2** — rör aldrig frysta kundrepon (contentroom, v0-datahub, prt-*, …).
|
||||
3. **AR-4** — inga betald-SaaS-beroenden; inga Vercel/GCP/Azure/Google Fonts/
|
||||
`next/font/google`; Cloudflare endast inom pågående migrering.
|
||||
4. **AR-5** — bevis, inte påståenden. Märk VERIFIERAT/ANTAGANDE/EJ VERIFIERAT.
|
||||
5. **AR-6** — aldrig hemligheter i repo (Infisical). Inga `NEXT_PUBLIC_*`-hemligheter.
|
||||
6. **AR-8** — beroenden pekar bara nedåt (K1; aldrig kundrepon).
|
||||
7. Tenant-id bunden till sessionen — aldrig litat på från request-body.
|
||||
|
||||
## Arbetsflöde
|
||||
|
||||
1. Branch från `main`: `git switch -c fix/my-change` (conventional prefix).
|
||||
2. `pnpm install --frozen-lockfile` (eller `--no-frozen-lockfile` om lockfilen
|
||||
medvetet uppdateras).
|
||||
3. Grindar innan push:
|
||||
```bash
|
||||
pnpm run typecheck # BLOCKERANDE (src/ + tests/)
|
||||
pnpm run test # BLOCKERANDE (vitest)
|
||||
pnpm run lint # rådgivande (legacy-noise finns)
|
||||
pnpm run build # BLOCKERANDE (next build)
|
||||
```
|
||||
4. Conventional Commits: `feat:` / `fix:` / `docs:` / `chore:` / `ci:` / `refactor:`.
|
||||
5. **`.gitea/workflows/**` och `.gitignore` är skyddade på `main`** — ändringar
|
||||
där går via PR (push direkt avvisas av pre-receive-hook).
|
||||
6. Öppna PR mot `main`; CI måste vara grön innan merge.
|
||||
7. Commit-meddelanden på engelska; UI-copy på svenska.
|
||||
|
||||
## Testkonventioner
|
||||
|
||||
- Enheter + capability-tester: `tests/{auth,p0,validation}/`.
|
||||
- Real-infra-tester (`*.realinfra.test.ts`) skippar ärligt när ST0RE/N0D inte nås.
|
||||
- Lägg aldrig till en test som fabricerar påståenden om kod som inte finns.
|
||||
|
||||
## Merge & release
|
||||
|
||||
- Merge via PR till `main` (skyddad). CD: `.gitea/workflows/cd.yml` triggar
|
||||
Coolify-redeploy — fails medvetet tills en Coolify-app provisionerats och
|
||||
`COOLIFY_APP_ID`/`COOLIFY_TOKEN` satts.
|
||||
@@ -12,7 +12,10 @@ confidence; nothing is guessed.
|
||||
> It documents the real API surface, the real persistence story, and the known
|
||||
> security gaps — including several places where this README is optimistic. Read
|
||||
> it before trusting any capability claim below. Repo identity + estate
|
||||
> classification: [`siax.config.json`](siax.config.json).
|
||||
> classification: [`siax.repo.json`](siax.repo.json) +
|
||||
> [`siax.config.json`](siax.config.json). Compliance state:
|
||||
> [`docs/compliance/`](docs/compliance/) (INVENTORY, RELATIONS, OSS-INVENTORY,
|
||||
> GOLDEN-STANDARD-REPORT, BACKLOG, SLUTRAPPORT).
|
||||
|
||||
## Two planes (see [docs/02-architecture.md](docs/02-architecture.md))
|
||||
|
||||
@@ -52,8 +55,9 @@ cd services/api && pip install -r requirements.txt && uvicorn orchestrator.main:
|
||||
## Deploy
|
||||
- **Config target (as of 2026-08-09):** `siax.config.json` declares `deploy.target: "coolify"`,
|
||||
matching every other SIAX Cloud OS repo (n0d, st0re, aud0, ...) — a Dockerfile "for Coolify"
|
||||
(already committed, see [`Dockerfile`](Dockerfile)) plus [`.gitea/workflows/deploy.yml`](.gitea/workflows/deploy.yml)
|
||||
that POSTs a restart to a Coolify app UUID on `COOLIFY_TOKEN` push.
|
||||
(already committed, see [`Dockerfile`](Dockerfile)) plus [`.gitea/workflows/cd.yml`](.gitea/workflows/cd.yml)
|
||||
(renamed from `deploy.yml` 2026-08-10) that POSTs a restart to a Coolify app UUID on
|
||||
`COOLIFY_TOKEN` push.
|
||||
- **Actually live right now:** the only running instance of `0pt.app` is still on **Vercel**
|
||||
(project `0pt`, scope *Simon Axelsson's projects*) — no Coolify app has been provisioned for
|
||||
this repo yet, so `deploy.yml`'s app UUID is a placeholder that fails the job on purpose until
|
||||
@@ -68,6 +72,13 @@ cd services/api && pip install -r requirements.txt && uvicorn orchestrator.main:
|
||||
REQUIRES a verified Zitadel Bearer token (401 without one). Only the literal
|
||||
`AUTH_ENFORCE=false` disables it, and that is refused when `NODE_ENV=production`
|
||||
(the process throws at startup rather than serving anonymously).
|
||||
**Caveat (live-verified 2026-08-10):** the deployed instance still answers
|
||||
`GET /api/0pt` with 200 anonymously — the middleware appears not to run in
|
||||
production (gap S1, root cause unknown). Do not rely on this being enforced
|
||||
until an anonymous request gets a real 401.
|
||||
- **Fonts:** self-hosted via `@fontsource-variable/inter` +
|
||||
`@fontsource-variable/jetbrains-mono` (no Google Fonts / `next/font/google`).
|
||||
- **API contract (SSOT):** [`contracts/openapi.yaml`](contracts/openapi.yaml).
|
||||
|
||||
## Status
|
||||
Frontend, full order lifecycle, customer + admin portals, edge API, payment/auth/embed
|
||||
|
||||
+27
-18
@@ -55,24 +55,33 @@ The following are **not** news to us — they are open, named gaps as of this
|
||||
pass, not secrets, and reporting them again mainly helps confirm priority
|
||||
rather than surfacing something new:
|
||||
|
||||
- **No authentication or tenant-isolation system exists in this repo yet.**
|
||||
The only gate in front of any route is a `DEV_LOGIN_KEY` dev-login scaffold
|
||||
(`app/api/auth/login/route.ts`) — there is no session-to-tenant binding.
|
||||
`app/api/orders/route.ts`'s `GET` handler carries the literal comment
|
||||
`// GET /api/orders — list (org scoping added with auth).`, confirming this
|
||||
directly. As a consequence, the P0 data-platform routes under `/api/0pt/*`
|
||||
(`lakehouse/mappings`, `sources/rate-policies`, `sources/[sourceId]/query`)
|
||||
and `src/services/document-capture-service.ts` accept `tenant_id`/
|
||||
`project_id` **from the client-supplied request body or query string**
|
||||
rather than from a server-bound session — a violation of this platform's
|
||||
own tenant-isolation rule (tenant_id must never be trusted from client
|
||||
input). This is an open, prioritized gap pending real auth (Phase 3,
|
||||
`docs/09-build-plan.md`), not an intentional design. Do not treat this repo
|
||||
as tenant-isolated until that lands.
|
||||
- Beyond that specific item, other authentication gaps on internal API
|
||||
routes may still exist and are tracked internally pending an intentional,
|
||||
reviewed fix; reporting any you find is still welcome and helps confirm
|
||||
priority.
|
||||
- **Zitadel bearer verification exists in code (fail-closed), but the deployed
|
||||
instance still answers `/api/0pt/*` anonymously (gap S1).** `src/auth/zitadel.ts`
|
||||
+ `middleware.ts` implement real JWKS-based verification with a fail-closed
|
||||
default (`assertAuthConfigSafe()` refuses `AUTH_ENFORCE=false` in production),
|
||||
yet a live probe (2026-08-10) got HTTP 200 without any token. Root cause is
|
||||
unconfirmed — do not treat the public instance as authenticated until an
|
||||
anonymous request receives 401. Additionally, no handler reads the verified
|
||||
tenant headers (`x-0pt-verified-tenant`): the P0 routes under `/api/0pt/*`
|
||||
(`lakehouse/mappings`, `sources/rate-policies`, `sources/[sourceId]/query`,
|
||||
`documents/capture`) accept `tenant_id`/`project_id` **from the client-supplied
|
||||
request body or query string** rather than from a server-bound session — a
|
||||
violation of this platform's own tenant-isolation rule (tenant_id must never be
|
||||
trusted from client input). This is an open, prioritized gap (BACKLOG P0-1/P0-2),
|
||||
not an intentional design.
|
||||
- **The non-`/api/0pt` API surface has no authentication at all.** Orders,
|
||||
admin metrics, payments (including the escrow `release` that flips an order to
|
||||
`delivered`), subscriptions, uploads and DB-grant endpoints are unprotected in
|
||||
code (live-verified 200 anonymously on `/api/orders` and `/api/admin/metrics`).
|
||||
- **The WAF-bypass scraper stack is kept deliberately.** `services/scrapers/*`
|
||||
(`waf_bypass.py`: FlareSolverr, Tor, cloudscraper, curl_cffi, proxy rotation,
|
||||
fake identities) and `services/infra/docker-compose.data-stack.yml`
|
||||
(flaresolverr/tor containers) contradict this repo's own compliance docs.
|
||||
They are retained **as an explicit user decision** (2026-08-10) and are out of
|
||||
scope for deletion — see `docs/compliance/GOLDEN-STANDARD-REPORT.md` control C6.
|
||||
- Beyond those items, other authentication gaps on internal API routes may still
|
||||
exist and are tracked internally pending an intentional, reviewed fix; reporting
|
||||
any you find is still welcome and helps confirm priority.
|
||||
|
||||
## Disclosure
|
||||
|
||||
|
||||
@@ -0,0 +1,46 @@
|
||||
# Runbook: Backup & Restore — 0pt
|
||||
|
||||
> Status 2026-08-10: **ingen databas i produktion** (`/api/health` →
|
||||
> `db: not_configured`); allt state är in-memory (försvinner vid kallstart).
|
||||
> Denna runbook beskriver läget idag + målbilden när Postgres provisioneras.
|
||||
|
||||
## Nuläge
|
||||
|
||||
- Ingen backup behövs/sker idag — det finns inget att backa upp (in-memory).
|
||||
- `sql/001_init.sql` är schemat (13 tabeller + pgvector/pgcrypto).
|
||||
- `sql/004/005` är iceberg-bärande tabeller.
|
||||
- **Kända blockerare:** estate-som-helhet saknar offsite-backup (Hetzner
|
||||
Robot-creds). Denna repo kan inte lösa det enskilt.
|
||||
|
||||
## Målbild (när `DATABASE_URL` satts)
|
||||
|
||||
### Daglig backup (P2-1 i BACKLOG)
|
||||
|
||||
```bash
|
||||
# på Postgres-värden (eller via N0D-jobb):
|
||||
pg_dump -Fc -d opt > /backup/opt-$(date +%F).dump
|
||||
# + offsite-kopia (MinIO/ST0RE via s3_sync-mönstret i services/scrapers)
|
||||
```
|
||||
|
||||
- Retention: 14 dagliga + 12 månatliga (föreslås; justeras vid provisionering).
|
||||
- Schemat får aldrig backupas från en klient med gamla migreringar — kör
|
||||
`sql/*.sql` via versionskontrollerad migrationsrunner (BACKLOG P4-3).
|
||||
|
||||
### Restore (testas kvartalsvis)
|
||||
|
||||
```bash
|
||||
psql -d opt < backup # eller: pg_restore -d opt opt-YYYY-MM-DD.dump
|
||||
# verifiera: SELECT count(*) FROM dim_company; + /api/health → db: configured
|
||||
```
|
||||
|
||||
### ST0RE/lakehouse-artefakter
|
||||
|
||||
- Iceberg-tabeller/snapshots pekar på manifest-URI:er — själva bytena ägs av
|
||||
N0D/ST0RE (0pt skriver bara metadata). 0pt-backup omfattar
|
||||
`opt_dataset_iceberg_mappings` + `opt_source_rate_policies` (finns i pg_dump).
|
||||
|
||||
## Restore-övning
|
||||
|
||||
1. Provisionera tillfällig Postgres (pgvector:pg16).
|
||||
2. `pg_restore` senaste dump. 3. Sätt `DATABASE_URL` i dev-instans.
|
||||
4. Verifiera orderflöde + en källfråga. 5. Logga resultatet i `docs/compliance/EVIDENCE/`.
|
||||
@@ -0,0 +1,37 @@
|
||||
# Runbook: Deploy — 0pt
|
||||
|
||||
> Mål: sätta 0pt.app på SIAX-flottan (Coolify) och avveckla Vercel i ordning.
|
||||
> Status 2026-08-10: `siax.config.json` deklarerar `target: coolify`; ingen
|
||||
> Coolify-app provisionerad; live-instansen körs fortfarande på Vercel.
|
||||
|
||||
## 1. Förutsättningar (blockerare för cutover)
|
||||
|
||||
- [ ] Coolify-app provisionerad i `cloud.siax.io` (build_pack: dockerfile,
|
||||
repo `git.siax.io/sax3l/0pt`, gren `main`).
|
||||
- [ ] `COOLIFY_APP_ID` (appens UUID) ifylld i `.gitea/workflows/cd.yml`.
|
||||
- [ ] `COOLIFY_TOKEN`-secret satt på repot (Gitea → Settings → Actions → Secrets).
|
||||
- [ ] Env-secrets inlagda i Coolify-appen från Infisical-projektet `0pt`
|
||||
(se backup/restore + incident runbooks).
|
||||
- [ ] DNS-cutover planerad: `0pt.app` → Coolify-appens ingress (eller Caddy).
|
||||
|
||||
## 2. Deploy (när appen finns)
|
||||
|
||||
1. Push till `main` → `.gitea/workflows/cd.yml` POSTar till
|
||||
`https://cloud.siax.io/api/v1/deploy?uuid=$COOLIFY_APP_ID&force=false`.
|
||||
2. Följ run i Gitea Actions; verifiera att den slutar grön.
|
||||
3. Verifiera hälsa: `curl https://0pt.app/api/health` → `ok:true` och
|
||||
`db: configured` (när Postgres kopplats in).
|
||||
|
||||
## 3. Manuell redeploy (nöd)
|
||||
|
||||
```bash
|
||||
curl -fsS -X POST "https://cloud.siax.io/api/v1/deploy?uuid=<UUID>&force=true" \
|
||||
-H "Authorization: Bearer $COOLIFY_TOKEN"
|
||||
```
|
||||
|
||||
## 4. Vercel-avveckling (EFFER att Coolify kör stabilt)
|
||||
|
||||
1. Verifiera att ingen verklig trafik/data ligger bakom (2026-08-10:
|
||||
`/api/health` visar `db/queue: not_configured` — marknads-/dev-läge).
|
||||
2. Peka DNS om till Coolify. 3. Behåll Vercel-projektet tills certifierad
|
||||
paritet (katalog, orderflöde, betalningar). 4. Avveckla först därefter.
|
||||
@@ -0,0 +1,34 @@
|
||||
# Runbook: Incident — 0pt
|
||||
|
||||
## Severity-nivåer
|
||||
|
||||
| Nivå | Exempel | Svarstid |
|
||||
|---|---|---|
|
||||
| S1 | Live-instans nere / dataexponering | Omedelbart |
|
||||
| S2 | Större funktion trasig | Inom 30 min (arbetstid) |
|
||||
| S3 | Mindre funktion/UI | Inom 1 arbetsdag |
|
||||
|
||||
## Kända felbilder (2026-08-10)
|
||||
|
||||
| Symtom | Sannolik orsak | Åtgärd |
|
||||
|---|---|---|
|
||||
| `/api/health` grön men `/api/orders` tom | Ingen DB i prod (in-memory-store) | Sätt `DATABASE_URL`; se BACKLOG P3-4 |
|
||||
| `/api/0pt/*` svarar 200 anonymt | Middleware körs inte på Vercel-deployen (lucka S1) | Rotorsaksanalys; verifiera 401 anonymt före "skyddad" |
|
||||
| deploy.yml-röd på main | Guard: placeholder `COOLIFY_APP_ID` (avsiktligt) | Provisionera Coolify-app + fyll UUID |
|
||||
| Test `*.realinfra.test.ts` skip | ST0RE inte nåbar från CI | Inte en incident — förväntat beteende |
|
||||
| Trivy-fynd på `services/scrapers/*` | Medvetet behållen bypass-stack | Läs GOLDEN-STANDARD-REPORT C6; triage, radera ej |
|
||||
|
||||
## Incidentprocess
|
||||
|
||||
1. **Triagera:** läs `/api/health`, senaste CI-run, `git log -5`.
|
||||
2. **Kommunicera:** logga i plattformens kanal; nämn tidslinje.
|
||||
3. **Minsta korrekta ändring:** aldrig radera funktionalitet (AR-1); fixa med
|
||||
minsta diff, håll tester gröna (`pnpm run typecheck && pnpm run test`).
|
||||
4. **Evidens:** dokumentera i `docs/compliance/` (märk VERIFIERAT).
|
||||
5. **Efter incident:** skriv post-mortem i `docs/` + uppdatera BACKLOG om ny lucka.
|
||||
|
||||
## Roller
|
||||
|
||||
- Oncall: se `docs/runbook/oncall.md`.
|
||||
- Eskalering: Simon Axelsson (simon@siax.io) — produkt- och infrastrukturbeslut
|
||||
(t.ex. bypass-stacken, Vercel-avveckling) tas alltid av honom.
|
||||
@@ -0,0 +1,42 @@
|
||||
# Runbook: Oncall — 0pt
|
||||
|
||||
> Gäller tills vidare (2026-08-10). Uppdateras när drift slås på flottan.
|
||||
|
||||
## Vem
|
||||
|
||||
- **Primär:** Simon Axelsson (simon@siax.io) — enda beslutsfattare för
|
||||
produkt/radering/bypass-stacken/Coolify-avveckling.
|
||||
- **Teknisk beredskap:** den som deployar/verifierar CI per dag (se "Dagliga
|
||||
rutiner"). Ingen formell rotation existerar ännu (enmanslag).
|
||||
|
||||
## Dagliga rutiner
|
||||
|
||||
1. Kontrollera Gitea Actions: senaste `ci.yml` på main ska vara grön.
|
||||
(`deploy.yml`/`cd.yml` röd = avsiktlig guard tills Coolify-app provisioneras.)
|
||||
2. `curl https://0pt.app/api/health` — ok:true + notera db/queue-läge.
|
||||
3. Skimma Trivy-rapporten (security.yml) — triage hög/kritisk, dokumentera i BACKLOG.
|
||||
|
||||
## Veckorutiner
|
||||
|
||||
- Verifiera att nightly.yml kört (mån–sön 04:00 UTC).
|
||||
- health-check.yml (måndag 06:00) — lyssna på warnings om saknade filer.
|
||||
|
||||
## Eskaleringsvägar
|
||||
|
||||
| Ärende | Kontakt |
|
||||
|---|---|
|
||||
| Säkerhetslucka / intrång | security@siax.io (omedelbart), sedan Simon |
|
||||
| Vercel/Coolify/provisionering | Simon |
|
||||
| Gitea/Actions-infra | Simon |
|
||||
| Bypass-stacken (GPL/juridiskt) | Simon — aldrig ensidigt beslut |
|
||||
|
||||
## Svarstider
|
||||
|
||||
- S1 (nere/exponering): omedelbart.
|
||||
- S2 (stor funktion): 30 min arbetstid.
|
||||
- S3 (mindre): 1 arbetsdag.
|
||||
|
||||
## Överlämning
|
||||
|
||||
- Allt som en oncall-person gjort dokumenteras i `docs/compliance/` (AR-5).
|
||||
- Incidenter → post-mortem i `docs/runbook/incident.md`-mönstret.
|
||||
+47
@@ -0,0 +1,47 @@
|
||||
# SLO — 0pt
|
||||
|
||||
> Gäller när tjänsten är i produktion på flottan (Coolify). Nuläget (2026-08-10):
|
||||
> live på Vercel, ingen DB — se särskilda noteringar. Ägare: Simon Axelsson.
|
||||
|
||||
## Tillgänglighet
|
||||
|
||||
| SLO | Mål | Nuläge (2026-08-10) |
|
||||
|---|---|---|
|
||||
| `/api/health` (liveness) | 99,9 % | ✅ 200 (men alltid `ok:true` — readiness saknas, se D2) |
|
||||
| Orderflöde `/api/orders` | 99,5 % | ⚠️ fungerar utan DB (in-memory), data försvinner vid restart |
|
||||
| Capability-API `/api/0pt/*` | 99,5 % | ⚠️ live 200 anonymt (lucka S1) — målbild: 401 utan token |
|
||||
| Engine (FastAPI, när deployad) | 99,0 % | ej deployad (EJ VERIFIERAT) |
|
||||
|
||||
## Latens (p95)
|
||||
|
||||
| Operation | Mål |
|
||||
|---|---|
|
||||
| `/api/health` | < 200 ms |
|
||||
| `/api/estimates` | < 500 ms |
|
||||
| `0pt.query_source` (enkla källor) | < 2 s |
|
||||
| Iceberg-write (tung) | ej mätbart sync — asynkront via N0D-jobb |
|
||||
|
||||
## Data & proveniens
|
||||
|
||||
- **Proveniens per fält:** 100 % av levererade fält bär `bridge_provenance`
|
||||
(källa, färskhet, konfidens, level). Målbild; i dag är leverans in-memory.
|
||||
- **Inga fabricerade värden:** 100 % — hård garanti (never-fabricate-tester finns).
|
||||
- **Retention/deletion-after-job:** mål 100 % av jobb — **inte implementerat**
|
||||
(BACKLOG P2-2).
|
||||
|
||||
## Säkerhet (baskrav)
|
||||
|
||||
- 0 kända hårdkodade hemligheter i repo (skannat 2026-08-10: 0 träffar).
|
||||
- Auth fail-closed i kod; **live-verifierad 401 krävs före produktionslöfte**
|
||||
(lucka S1 öppen).
|
||||
- Ingen betald SaaS-plattform som driftkrav (AR-4) — Stripe är kundval, env-guardad.
|
||||
|
||||
## Rapportering
|
||||
|
||||
- Mätning sker manuellt vid incidenter tills observabilitet är inkopplad
|
||||
(BACKLOG P2-4). Mål: automatiska hälsokontroller via nightly.yml + Coolify.
|
||||
|
||||
## Undantag
|
||||
|
||||
Bypass-stacken (`services/scrapers/*`) är medvetet behållen per användarbeslut
|
||||
och omfattas inte av ovanstående SLO; dess körtid är ej mätbar i 0pt-SLO:er.
|
||||
@@ -0,0 +1,11 @@
|
||||
# Prompts — index
|
||||
|
||||
> Operativa prompt-mallar för agentsessioner mot 0pt. Konvention: `NNN-roll.md`.
|
||||
> Alla mallar respekterar CLAUDE.md/AGENTS.md + docs/compliance (AR-5).
|
||||
|
||||
| Fil | Användning |
|
||||
|---|---|
|
||||
| [001-repo-health.md](001-repo-health.md) | Hälsa + CI-status + luckor före arbete |
|
||||
| [002-compliance-audit.md](002-compliance-audit.md) | GOLDEN-STANDARD-uppföljning |
|
||||
| [003-security-review.md](003-security-review.md) | Sårbarhetsgranskning av ändring |
|
||||
| [004-deploy-cutover.md](004-deploy-cutover.md) | Coolify-provisionering + DNS-cutover |
|
||||
@@ -0,0 +1,22 @@
|
||||
# Prompt: Repo-hälsa (0pt)
|
||||
|
||||
> Använd före annat arbete: verifiera att utgångsläget är sant innan ändringar.
|
||||
|
||||
## 1. Status
|
||||
|
||||
- `git status` + `git log --oneline -5` — ren main?
|
||||
- Senaste CI-run (Gitea Actions API):
|
||||
`/repos/sax3l/0pt/actions/runs?limit=5` — ci.yml ska vara grön;
|
||||
cd.yml/deploy.yml röd = avsiktlig guard (placeholder UUID).
|
||||
- `curl -s https://0pt.app/api/health` — ok/true + db/queue-läge.
|
||||
|
||||
## 2. Luckor att minnas
|
||||
|
||||
- S1: `/api/0pt/*` svarade 200 anonymt (2026-08-10) — påstå aldrig "skyddad".
|
||||
- S2: tenant tas ur body — nya handlers läser `x-0pt-verified-tenant`.
|
||||
- Bypass-stacken `services/scrapers/*` — medvetet behållen, rör ej.
|
||||
|
||||
## 3. Output
|
||||
|
||||
Rapportera: HEAD-SHA, CI-status, /api/health-svar, status på S1–S3
|
||||
(VERIFIERAT/ANTAGANDE/EJ VERIFIERAT).
|
||||
@@ -0,0 +1,17 @@
|
||||
# Prompt: Compliance-audit (0pt)
|
||||
|
||||
> Uppföljning av GOLDEN-STANDARD-REPORT. Körs när backlog-objekt stängts.
|
||||
|
||||
## 1. Uppdatera
|
||||
|
||||
- Läs `docs/compliance/GOLDEN-STANDARD-REPORT.md` — sätt status ✅/⚠️/❌/➖
|
||||
per kontroll utifrån faktiska bevis (nya tester, nya live-prober, nya filer).
|
||||
- Uppdatera poängen (✅=1, ⚠️=0.5, ❌=0, ➖ exkluderas).
|
||||
- Flytta stängda BACKLOG-poster till "stängt (datum, SHA)".
|
||||
- Dokumentera nya bevis i `docs/compliance/EVIDENCE/`.
|
||||
|
||||
## 2. Regler
|
||||
|
||||
- AR-5: varje statusändring kräver bevis (testfil/SHA/live-svar).
|
||||
- C6 (bypass-stacken): alltid ➖/"medvetet användarbeslut" — ingen ändring.
|
||||
- Inga fabricerade förbättringar: om inget faktiskt ändrats → ingen poängändring.
|
||||
@@ -0,0 +1,19 @@
|
||||
# Prompt: Security review (0pt)
|
||||
|
||||
> Säkerhetsgranskning av en ändring före push. Kör ALLTID vid ändringar i
|
||||
> auth, klienter (cl0ud/aud0/n0d/st0re), payments eller middleware.
|
||||
|
||||
## 1. Checklista
|
||||
|
||||
- [ ] Inga hemligheter i diffen (grep: sk_/whsec/private key/AIza/AKIA…).
|
||||
- [ ] Inga nya betald-SaaS-/Google/Vercel-bärare (AR-4).
|
||||
- [ ] `tenant_id` inte tagen ur request-body (S2-regeln).
|
||||
- [ ] Inga ändringar i `services/scrapers/*` (bypass-stacken, medvetet beslut).
|
||||
- [ ] Auth-fail-closed kvarstår; ingen `AUTH_ENFORCE=false`-produktionsväg.
|
||||
- [ ] Inga `console.log` av hemligheter; ingen `NEXT_PUBLIC_*`-hemlighet.
|
||||
- [ ] Tester täcker nya grenar; typecheck+test gröna.
|
||||
- [ ] Trivy-fynd i diffen triagerade och dokumenterade.
|
||||
|
||||
## 2. Output
|
||||
|
||||
`VERIFIERAT/ANTAGANDE/EJ VERIFIERAT` per punkt + risknivå (L0–L5) + rekommendation.
|
||||
@@ -0,0 +1,24 @@
|
||||
# Prompt: Deploy-cutover (0pt)
|
||||
|
||||
> Mål: 0pt.app på Coolify, sedan Vercel-avveckling. Följ
|
||||
> `docs/runbook/deploy.md` steg för steg.
|
||||
|
||||
## 1. Gate (blockerare)
|
||||
|
||||
- Coolify-app existerar? (cloud.siax.io → projekt)
|
||||
- `COOLIFY_APP_ID` ifylld i `.gitea/workflows/cd.yml`? (skyddad sökväg → PR)
|
||||
- `COOLIFY_TOKEN`-secret satt? `cd.yml` är röd medvetet tills dess.
|
||||
- Secrets i Infisical-projektet 0pt (ej Vercel-env)?
|
||||
|
||||
## 2. Sekvens
|
||||
|
||||
1. Provisionera app (dockerfile, repo sax3l/0pt, branch main).
|
||||
2. PR: fyll UUID + verifiera status-check (skyddade filer).
|
||||
3. Kör deploy, följ Gitea-run → grön.
|
||||
4. `curl https://0pt.app/api/health` och en marknadssida.
|
||||
5. DNS-ompekning + Vercel-avveckling först när paritet certifierats.
|
||||
|
||||
## 3. Regel
|
||||
|
||||
Radera aldrig Vercel-projektet före certifierad paritet. Dokumentera varje steg
|
||||
i `docs/compliance/EVIDENCE/` med datum + SHA.
|
||||
Reference in New Issue
Block a user