commit d93f509d4093dde910ee37cd864c49057571aebe Author: ai-bot Date: Thu Oct 1 12:31:10 2026 +0000 Add TODO.md diff --git a/TODO.md b/TODO.md new file mode 100644 index 0000000..2e1b4ec --- /dev/null +++ b/TODO.md @@ -0,0 +1,542 @@ +# TODO — Helsesjekk for StartOS 0.4.0 + +## Mål + +Bygg ein **enkel lokal web-app** som køyrer som ein StartOS 0.4.0-service. + +Appen skal hjelpe éin brukar å gjennomføre og dokumentere ein årleg health check av eit fast **2-av-3 multisig-oppsett** med tre nøklar: + +- Nøkkel 1: SeedSigner +- Nøkkel 2: Blockstream Jade +- Nøkkel 3: sky-nøkkel hos Nunchuk + +Appen skal **berre registrere resultat og historikk**. Han skal ikkje signere Bitcoin-transaksjonar, handtere private nøklar eller utføre wallet-operasjonar. + +Denne `TODO.md` er det einaste kravgrunnlaget du treng for MVP. + +--- + +# 1. Scope for første versjon + +## Dette skal vere med + +- [ ] Ein enkel web-app med dashboard. +- [ ] Registrering av dei tre nøklane. +- [ ] Registrering av årleg health check. +- [ ] Kontroll av alle punkta i den årlege sjekklista. +- [ ] Varsel når eit kontrollpunkt krev oppfølging. +- [ ] Historikk over gjennomførte health checks. +- [ ] Automatisk forslag til neste sjekk, ca. eitt år fram i tid. +- [ ] Rapporteksport i Excel-kompatibelt format. +- [ ] Lokal SQLite-database. +- [ ] Persistent lagring på StartOS. +- [ ] StartOS health check. +- [ ] StartOS backup og restore. + +## Dette skal ikkje vere med i første versjon + +- [ ] Ingen AI-integrasjon i appen. +- [ ] Ingen Bitcoin-node-integrasjon. +- [ ] Ingen Bitcoin-signering. +- [ ] Ingen PSBT-generering eller signering. +- [ ] Ingen seed phrase-lagring. +- [ ] Ingen private key-lagring. +- [ ] Ingen cloud sync av appdata. +- [ ] Ingen ekstern database. +- [ ] Ingen PWA/offline-database. +- [ ] Ingen kalenderintegrasjon. +- [ ] Ingen avansert analyse eller grafar. +- [ ] Ingen støtte for fleire multisig-oppsett i MVP. + +--- + +# 2. Viktige reglar for appen + +- [ ] Appen skal aldri spørje etter seed phrase. +- [ ] Appen skal aldri spørje etter private keys. +- [ ] Appen skal aldri lagre PIN, passord eller wallet-hemmeligheiter. +- [ ] Kontaktinformasjon til nøkkelhaldarar skal ikkje lagrast i appen; berre om kontaktinfo er verifisert. +- [ ] Appen skal ikkje late som han sjølv har utført ein hardware-test. Brukaren registrerer resultatet av testen. +- [ ] Appen skal vere lokal og enkel. +- [ ] Dersom noko ikkje er nødvendig for den årlege health check-en, skal det ikkje byggjast i MVP. + +--- + +# 3. Fast oppsett som appen skal støtte + +Appen skal starte med eitt fast multisig-oppsett: + +| Nøkkel | Type | Einheit | +|---|---|---| +| 1 | Hardware | SeedSigner | +| 2 | Hardware | Blockstream Jade | +| 3 | Cloud | Nunchuk | + +- [ ] Vis 2-av-3 som oppsettet i dashboardet. +- [ ] Ha tre nøkkelprofilar, éin for kvar nøkkel. +- [ ] La brukaren gi nøklane lesbare namn dersom ønskjeleg. +- [ ] Ikkje bygg generell støtte for mange oppsett enno. + +--- + +# 4. Datamodell + +Bruk SQLite med så få tabellar som mogleg. + +## 4.1 `keys` + +- [ ] `id` +- [ ] `key_number` = 1, 2 eller 3 +- [ ] `name` +- [ ] `type` = `hardware` eller `cloud` +- [ ] `device` = SeedSigner / Blockstream Jade / Nunchuk +- [ ] `created_at` + +## 4.2 `health_checks` + +Ein rad/record for kvar årlege health check. + +- [ ] `id` +- [ ] `checked_at` +- [ ] `next_check_due` +- [ ] `software_compatibility_status` +- [ ] `sparrow_version` +- [ ] `nunchuk_version` +- [ ] `ai_security_status` +- [ ] `contact_info_verified` +- [ ] `comments` + +## 4.3 `key_checks` + +Eitt record per nøkkel i kvar health check. + +- [ ] `id` +- [ ] `health_check_id` +- [ ] `key_id` +- [ ] `available` +- [ ] `hardware_works` +- [ ] `firmware_version` +- [ ] `seed_backup_status` +- [ ] `cloud_health_status` +- [ ] `cloud_provider_operational` +- [ ] `address_path_verified` +- [ ] `address_path` +- [ ] `comments` + +Reglar: + +- [ ] `hardware_works` skal vere relevant for nøkkel 1 og 2. +- [ ] `firmware_version` skal vere relevant for nøkkel 1 og 2. +- [ ] `cloud_health_status` og `cloud_provider_operational` skal vere relevante for nøkkel 3. +- [ ] `address_path` skal kunne lagre den verifiserte adressestien. + +## 4.4 `tool_checks` + +Ein enkel matrise for støtte-kontrollen. + +Produkta som skal vurderast: + +- SeedSigner +- Blockstream Jade +- Nunchuk +- Sparrow Wallet + +Felt: + +- [ ] `id` +- [ ] `health_check_id` +- [ ] `product` +- [ ] `bip327_status` +- [ ] `slip39_status` +- [ ] `version` +- [ ] `checked_at` +- [ ] `notes` + +--- + +# 5. Statusverdiar + +## 5.1 Generelle kontrollar + +Bruk enkle statusar som: + +- `OK` +- `PROBLEM` +- `IKKJE_VURDERT` + +- [ ] Bruk same statuslogikk i database og UI. +- [ ] Ikkje bland saman «ikkje vurdert» og eit faktisk negativt resultat. + +## 5.2 KI-sikkerheitsstatus + +Bruk nøyaktig desse fire verdiane: + +- [ ] `TRYGG` +- [ ] `PATCHA` +- [ ] `SÅRBAR` +- [ ] `KOMPROMITTERT` + +Ingen andre sikkerheitsstatusar skal brukast. + +--- + +# 6. Årleg health check — steg for steg + +## Steg 1 — Start kontroll + +- [ ] Brukaren trykkjer `Start årleg health check`. +- [ ] Dagens dato blir føreslått automatisk. +- [ ] Neste sjekk blir føreslått ca. eitt år fram i tid. + +## Steg 2 — Kontroller nøkkel 1: SeedSigner + +- [ ] Tilgjengeleg / ikkje tilgjengeleg. +- [ ] Hardware fungerer / fungerer ikkje. +- [ ] Registrer firmware-versjon. +- [ ] Kontroller seed-backup. +- [ ] Kontroller at backupen er intakt og stemmer med hardware. +- [ ] Verifiser adresse. +- [ ] Verifiser derivasjonshøgd. +- [ ] Verifiser adresse-sti. +- [ ] Kommentar ved behov. + +## Steg 3 — Kontroller nøkkel 2: Blockstream Jade + +- [ ] Tilgjengeleg / ikkje tilgjengeleg. +- [ ] Hardware fungerer / fungerer ikkje. +- [ ] Registrer firmware-versjon. +- [ ] Kontroller seed-backup. +- [ ] Kontroller at backupen er intakt og stemmer med hardware. +- [ ] Verifiser adresse. +- [ ] Verifiser derivasjonshøgd. +- [ ] Verifiser adresse-sti. +- [ ] Kommentar ved behov. + +## Steg 4 — Kontroller nøkkel 3: Nunchuk sky-nøkkel + +- [ ] Tilgjengeleg / ikkje tilgjengeleg. +- [ ] Gjennomfør cloud health check. +- [ ] Verifiser at Nunchuk framleis er i drift. +- [ ] Registrer resultatet av leverandør-kontrollen. +- [ ] Verifiser relevant adresse/oppsett. +- [ ] Kommentar ved behov. + +## Steg 5 — Programvare-kompatibilitet + +- [ ] Registrer Sparrow-versjon dersom Sparrow blir brukt. +- [ ] Registrer Nunchuk-versjon dersom Nunchuk blir brukt. +- [ ] Verifiser at Sparrow og/eller Nunchuk støttar hardware-oppsettet. +- [ ] Registrer `OK` eller `PROBLEM`. +- [ ] Legg inn kommentar dersom det er problem. + +## Steg 6 — BIP327 / SLIP39 + +Sjekk status for kvart av desse fire produkta: + +- [ ] SeedSigner — BIP327 +- [ ] SeedSigner — SLIP39 +- [ ] Blockstream Jade — BIP327 +- [ ] Blockstream Jade — SLIP39 +- [ ] Nunchuk — BIP327 +- [ ] Nunchuk — SLIP39 +- [ ] Sparrow Wallet — BIP327 +- [ ] Sparrow Wallet — SLIP39 + +For kvart resultat: + +- [ ] Registrer status. +- [ ] Registrer versjon dersom relevant. +- [ ] Registrer dato. +- [ ] Registrer kommentar/kjelde dersom relevant. + +Appen skal berre **registrere** dette resultatet. Han skal ikkje starte ei oppgradering. + +## Steg 7 — KI-sikkerheitsstatus + +Brukaren skal registrere resultat frå ein ekstern KI-/research-sjekk av leverandørane. + +Leverandørar: + +- [ ] SeedSigner +- [ ] Blockstream Jade +- [ ] Nunchuk +- [ ] Sparrow Wallet + +For kvar leverandør: + +- [ ] Registrer status: TRYGG / PATCHA / SÅRBAR / KOMPROMITTERT. +- [ ] Registrer kort kommentar. + +Appen skal ikkje kontakte KI sjølv i MVP. + +## Steg 8 — Kontaktinfo + +- [ ] Stadfest at kontaktinformasjonen til alle nøkkelhaldarane er gyldig. +- [ ] Lagre berre `JA` / `NEI`. +- [ ] Ikkje lagre namn, telefonnummer, e-post eller anna kontaktinnhald. + +## Steg 9 — Kommentar + +- [ ] Eitt overordna kommentarfelt for observasjonar. +- [ ] Eigne kommentarar per nøkkel der nødvendig. + +## Steg 10 — Oppsummering + +Før lagring skal appen vise: + +- [ ] Alle kontrollpunkt. +- [ ] Alle problem. +- [ ] Alle manglande kontrollar. +- [ ] Neste sjekkdato. +- [ ] Eventuelle handlingar som bør følgjast opp. + +- [ ] Brukaren må trykkje `Lagre health check` for å lagre kontrollen. + +--- + +# 7. Varsel og oppfølging + +Appen skal gi tydelege varsel når resultatet krev handling. + +- [ ] Nøkkel ikkje tilgjengeleg → vis at dette krev umiddelbar oppfølging. +- [ ] Hardware fungerer ikkje → vis at seed-backup bør testast på annan kompatibel hardware. +- [ ] Seed-backup manglar eller er øydelagd → vis at PROTOKOLL 3: Nøkkeltap skal aktiverast. +- [ ] Adresseverifisering feilar → vis at adressa bør kontrollerast mot BSMS og testast på nytt. +- [ ] Programvare støttar ikkje lenger hardware → vis at alternativ programvare/løysing bør vurderast. +- [ ] BIP327-status er positiv → vis at framtidig BIP327-oppgradering kan vurderast. +- [ ] SLIP39-status er positiv → vis at framtidig SLIP39-aktivering kan vurderast. +- [ ] KI-status `SÅRBAR` → vis at firmware-/sikkerheitsproblem må følgjast opp. +- [ ] KI-status `KOMPROMITTERT` → vis at nøkkeltapsprosedyre må følgjast. +- [ ] Kontaktinfo er ikkje stadfesta → vis at kontaktinformasjon må oppdaterast i den eksterne dokumentasjonen. + +Appen skal ikkje automatisk utføre nokon av desse tiltaka. + +--- + +# 8. Dashboard + +Dashboardet skal vere enkelt. + +- [ ] Vis 2-av-3 oppsettet. +- [ ] Vis status for nøkkel 1. +- [ ] Vis status for nøkkel 2. +- [ ] Vis status for nøkkel 3. +- [ ] Vis dato for siste health check. +- [ ] Vis neste health check. +- [ ] Vis aktive varsel. +- [ ] Knapp: `Start årleg health check`. +- [ ] Knapp/lenke: `Historikk`. + +--- + +# 9. Historikk + +- [ ] Vis alle gjennomførte health checks kronologisk. +- [ ] Opne ein health check i read-only-visning. +- [ ] Vis dato. +- [ ] Vis neste sjekk. +- [ ] Vis status per nøkkel. +- [ ] Vis programvarestatus. +- [ ] Vis BIP327/SLIP39-resultat. +- [ ] Vis KI-status. +- [ ] Vis kommentarar. +- [ ] Gamle health checks skal ikkje overskrivast når ein ny blir registrert. + +--- + +# 10. Rapporteksport + +Rapporten skal kunne brukast i Excel. + +- [ ] Implementer XLSX-eksport dersom dette kan gjerast enkelt. +- [ ] Elles implementer CSV med tydeleg dokumentasjon om Excel-kompatibilitet. +- [ ] Eksporter alle nødvendige felt frå health check. +- [ ] Éin gjennomført health check skal kunne identifiserast som éi historisk kontroll. +- [ ] Ta med dato. +- [ ] Ta med nøkkelstatus. +- [ ] Ta med hardware-/firmware-resultat. +- [ ] Ta med seed/cloud-resultat. +- [ ] Ta med adresse-sti. +- [ ] Ta med programvareversjon og kompatibilitet. +- [ ] Ta med BIP327/SLIP39. +- [ ] Ta med KI-status. +- [ ] Ta med kontaktinfo-verifisering. +- [ ] Ta med neste sjekk. +- [ ] Ta med kommentarar. + +--- + +# 11. Backend + +Vel den enklaste teknologien som passar godt for ein liten lokal web-app. + +- [ ] Implementer SQLite. +- [ ] Implementer database-initialisering/migrering. +- [ ] Implementer lagring av nøklar. +- [ ] Implementer lagring av health checks. +- [ ] Implementer historikk. +- [ ] Implementer varsellogikken. +- [ ] Implementer rapporteksport. +- [ ] Implementer health endpoint. + +Minimum: + +- [ ] `GET /health` +- [ ] `GET /api/keys` +- [ ] `GET /api/health-checks` +- [ ] `GET /api/health-checks/:id` +- [ ] `POST /api/health-checks` +- [ ] `GET /api/export` + +--- + +# 12. Frontend + +- [ ] Lag enkel responsiv web-UI. +- [ ] Prioriter enkelheit framfor grafisk kompleksitet. +- [ ] Bruk tydelege statusfelt. +- [ ] Bruk faste val der status skal vere ein avgrensa verdi. +- [ ] Vis problem tydeleg. +- [ ] Vis kva som står att før ein health check kan lagrast. +- [ ] Sørg for at appen fungerer godt i vanleg StartOS-browser. + +--- + +# 13. StartOS 0.4.0 + +Bygg appen som éin enkel StartOS-service. + +```text +StartOS 0.4.0 +└── Helsesjekk + ├── Web UI + ├── Backend/API + ├── SQLite + └── Persistent data +``` + +- [ ] Opprett StartOS package. +- [ ] Opprett manifest. +- [ ] Opprett service-definisjon. +- [ ] Opprett HTTP web-interface. +- [ ] Opprett persistent volume. +- [ ] Opprett health check. +- [ ] Opprett backup-oppsett. +- [ ] Opprett installasjons-/brukarinstruksjonar. +- [ ] Bygg `.s9pk`. +- [ ] Verifiser at pakken kan installerast på StartOS 0.4.0. + +Unngå: + +- [ ] Ingen Postgres. +- [ ] Ingen Redis. +- [ ] Ingen ekstern backend. +- [ ] Ingen ekstern cloud-service for appdata. +- [ ] Ingen ekstra container utan konkret behov. + +--- + +# 14. Lagring og backup + +- [ ] SQLite-database skal liggje på persistent volum. +- [ ] Appdata skal overleve restart. +- [ ] Konfigurer StartOS backup av persistent data. +- [ ] Test backup. +- [ ] Test restore. +- [ ] Verifiser at gamle health checks finst etter restore. + +--- + +# 15. Sikkerheit og personvern + +- [ ] Ingen seed phrase i database. +- [ ] Ingen private keys i database. +- [ ] Ingen wallet-passord i database. +- [ ] Ingen sky-passord eller tokens i database. +- [ ] Ingen unødvendige personopplysningar. +- [ ] Kontaktinfo blir berre registrert som verifisert/ikkje verifisert. +- [ ] Valider input på serveren. +- [ ] Bruk parameteriserte SQL-spørringar. +- [ ] Ikkje implementer eigen kryptografi. +- [ ] Ikkje send data til eksterne tenester i MVP. + +--- + +# 16. Testing + +## Funksjonstest + +- [ ] Opprett dei tre nøklane. +- [ ] Start health check. +- [ ] Fullfør alle kontrollpunkt. +- [ ] Lagre health check. +- [ ] Vis han i historikken. +- [ ] Start ny health check. +- [ ] Verifiser at gammal kontroll framleis finst. + +## Problemtest + +- [ ] Test nøkkel utilgjengeleg. +- [ ] Test hardware-feil. +- [ ] Test seed-backup-feil. +- [ ] Test adresseverifiseringsfeil. +- [ ] Test programvare-inkompatibilitet. +- [ ] Test BIP327-resultat. +- [ ] Test SLIP39-resultat. +- [ ] Test KI-status `SÅRBAR`. +- [ ] Test KI-status `KOMPROMITTERT`. +- [ ] Test kontaktinfo `NEI`. + +## StartOS-test + +- [ ] Installer `.s9pk` på StartOS 0.4.0. +- [ ] Start service. +- [ ] Opne web UI. +- [ ] Utfør ein komplett test-check. +- [ ] Restart service. +- [ ] Verifiser at data framleis finst. +- [ ] Ta backup. +- [ ] Restore backup. +- [ ] Verifiser data etter restore. + +--- + +# 17. Ferdigkriterium for første release + +Før første release skal alle desse vere oppfylte: + +- [ ] Appen køyrer på StartOS 0.4.0. +- [ ] Dei tre nøklane er representerte i appen. +- [ ] Ein komplett årleg health check kan gjennomførast i nettlesaren. +- [ ] Alle årlege kontrollpunkt kan registrerast. +- [ ] BIP327/SLIP39 kan registrerast for SeedSigner, Blockstream Jade, Nunchuk og Sparrow. +- [ ] KI-status kan registrerast som TRYGG, PATCHA, SÅRBAR eller KOMPROMITTERT. +- [ ] Kontaktinfo kan verifiserast utan å lagre kontaktinformasjonen. +- [ ] Problem gir tydelege varsel. +- [ ] Neste sjekk blir lagra. +- [ ] Historikk fungerer. +- [ ] Excel-kompatibel rapport kan eksporterast. +- [ ] Data overlever restart. +- [ ] Backup og restore fungerer. +- [ ] Ingen wallet-hemmeligheiter blir lagra. + +--- + +# 18. Arbeidsrekkefølgje for AI-programmeraren + +Utfør oppgåvene i denne rekkefølgja og ikkje hopp fram til avanserte funksjonar: + +- [ ] 1. Opprett grunnleggande web-app. +- [ ] 2. Opprett SQLite og datamodellen. +- [ ] 3. Implementer dei tre faste nøklane. +- [ ] 4. Implementer health check-skjemaet. +- [ ] 5. Implementer lagring og historikk. +- [ ] 6. Implementer varsellogikken. +- [ ] 7. Implementer dashboard. +- [ ] 8. Implementer rapporteksport. +- [ ] 9. Implementer StartOS package. +- [ ] 10. Implementer persistent storage og backup. +- [ ] 11. Test restart og restore. +- [ ] 12. Bygg endeleg `.s9pk` og gjer første release. + +**Hovudregel:** Bygg den minste løysinga som oppfyller lista over. Ikkje legg til nye funksjonar, tenester eller arkitektur utan at dei er nødvendige for punkta i denne TODO-lista.