# 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.