diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..c51f26b --- /dev/null +++ b/AGENTS.md @@ -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). diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..cb83e65 --- /dev/null +++ b/CONTRIBUTING.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. diff --git a/README.md b/README.md index 355eca4..b0118ea 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/SECURITY.md b/SECURITY.md index b5a4bb7..7dcb647 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -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 diff --git a/docs/runbook/backup-restore.md b/docs/runbook/backup-restore.md new file mode 100644 index 0000000..46d3049 --- /dev/null +++ b/docs/runbook/backup-restore.md @@ -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/`. diff --git a/docs/runbook/deploy.md b/docs/runbook/deploy.md new file mode 100644 index 0000000..3f994c4 --- /dev/null +++ b/docs/runbook/deploy.md @@ -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=&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. diff --git a/docs/runbook/incident.md b/docs/runbook/incident.md new file mode 100644 index 0000000..a442e9f --- /dev/null +++ b/docs/runbook/incident.md @@ -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. diff --git a/docs/runbook/oncall.md b/docs/runbook/oncall.md new file mode 100644 index 0000000..fa881ae --- /dev/null +++ b/docs/runbook/oncall.md @@ -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. diff --git a/docs/slo.md b/docs/slo.md new file mode 100644 index 0000000..8bb4c8a --- /dev/null +++ b/docs/slo.md @@ -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. diff --git a/prompts/000-INDEX.md b/prompts/000-INDEX.md new file mode 100644 index 0000000..2687ca9 --- /dev/null +++ b/prompts/000-INDEX.md @@ -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 | diff --git a/prompts/001-repo-health.md b/prompts/001-repo-health.md new file mode 100644 index 0000000..fe3ade0 --- /dev/null +++ b/prompts/001-repo-health.md @@ -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). diff --git a/prompts/002-compliance-audit.md b/prompts/002-compliance-audit.md new file mode 100644 index 0000000..f557f23 --- /dev/null +++ b/prompts/002-compliance-audit.md @@ -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. diff --git a/prompts/003-security-review.md b/prompts/003-security-review.md new file mode 100644 index 0000000..c9c0574 --- /dev/null +++ b/prompts/003-security-review.md @@ -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. diff --git a/prompts/004-deploy-cutover.md b/prompts/004-deploy-cutover.md new file mode 100644 index 0000000..f8e4cd8 --- /dev/null +++ b/prompts/004-deploy-cutover.md @@ -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.