22 KiB
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.
Språkkrav
- Brukargrensesnittet, app-tekst, kjeldekode, variabel- og funksjonsnamn, kommentarar og teknisk dokumentasjon skal vere på engelsk.
TODO.mdkan vere på norsk; dette er det einaste unntaket.
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.
Merk: denne lista er eit varig forbod, ikkje ei oppgåveliste. Punkta blir difor ikkje kryssa av, men skal stadfestast på nytt før release.
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. (Avgjort: ikkje no — faste namn er nok for MVP.)
- Ikkje bygg generell støtte for mange oppsett enno.
4. Datamodell
Bruk SQLite med så få tabellar som mogleg.
Merk: §19 gjorde om datamodellen. Felta under er oppdaterte i tråd med §19 og er no implementerte.
4.1 keys
idkey_number= 1, 2 eller 3nametype=hardwareellerclouddevice= SeedSigner / Blockstream Jade / Nunchukcreated_at
4.2 health_checks
Ein rad/record for kvar innsending, som gjeld éin vald nøkkel (§19).
idchecked_atnext_check_duesoftware_compatibility_statuswallet_software— vald programvare:Sparrow WalletellerNunchuk(§19)software_version— versjonen til den valde programvara (§19)ai_security_status— blir lagra per leverandør iai_security_checks, jf. §6 steg 7 og §19contact_info_verifiedcomments
Endra i §19: sparrow_version og nunchuk_version er tekne ut av kravet og erstatta av wallet_software og software_version. Kolonnane blir behaldne for gamle rader.
4.3 key_checks
Eitt record for den valde nøkkelen i kvar innsending.
idhealth_check_idkey_idavailablehardware_worksfirmware_versionseed_backup_verified— statusOKellerProblem; gjeld nøkkel 1 og 2 (§19)cloud_health_statuscloud_provider_operationaladdress_path_verified— statusOKellerProblem; var Ja/Nei (§19)address_pathcomments
Reglar:
hardware_worksskal vere relevant for nøkkel 1 og 2.firmware_versionskal vere relevant for nøkkel 1 og 2.seed_backup_verifiedskal vere relevant for nøkkel 1 og 2, og ikkje for sky-nøkkelen.cloud_health_statusogcloud_provider_operationalskal vere relevante for nøkkel 3.address_pathskal kunne lagre den verifiserte adressestien.seed_backup_verifiedogaddress_path_verifiedskal berre ha verdianeOKellerProblem, og vere obligatoriske nåravailableer Ja.- Når
availableer Nei, skal dei andre nøkkelfelta ikkje krevjast, og nøkkelnotatet skal framleis kunne fyllast ut (§19).
Endra i §19: seed_backup_status, address_verified og derivation_height er tekne ut. Sjekkpunktet «Verifiser derivasjonshøgd» blir dekt av address_path.
4.4 tool_checks
Ein enkel matrise for støtte-kontrollen.
Produkta som skal vurderast, alle fire, men i ulike innsendingar (§19):
- SeedSigner
- Blockstream Jade
- Nunchuk
- Sparrow Wallet
Felt:
idhealth_check_idproduct— nøkkelproduktet pluss vald programvare, maks to rader per innsending (§19)bip327_statusslip39_status
Endra i §19: version, checked_at og notes er tekne ut av kravet. Kolonnane blir behaldne for gamle rader.
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:
SECUREPATCHEDVULNERABLECOMPROMISED
Ingen andre sikkerheitsstatusar skal brukast.
Endra i §19: dei norske verdiane TRYGG, PATCHA, SÅRBAR og KOMPROMITTERT er bytte ut med dei engelske. Eksisterande rader blir migrerte til dei nye verdiane.
6. Årleg health check — steg for steg
Merk: §19 gjer at éi innsending gjeld éin vald nøkkel.
Steg 1 — Start kontroll
- Brukaren trykkjer
Start årleg health check. - Brukaren vel kva nøkkel innsendinga gjeld: nøkkel 1, 2 eller 3 (§19).
- Dagens dato blir føreslått automatisk.
- Neste sjekkdato blir rekna ut på serveren som eitt kalenderår etter sjekkdatoen, og kan ikkje redigerast i skjemaet (§19).
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 →
seed_backup_verified(OK/Problem). - Verifiser adresse, derivasjonshøgd og adresse-sti →
address_path_verified(OK/Problem) ogaddress_path(tekst). - 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 →
seed_backup_verified(OK/Problem). - Verifiser adresse, derivasjonshøgd og adresse-sti →
address_path_verified(OK/Problem) ogaddress_path(tekst). - 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 →
address_path_verified(OK/Problem) ogaddress_path(tekst). - Kommentar ved behov.
Steg 5 — Programvare-kompatibilitet
- Brukaren vel éi wallet-programvare: Sparrow Wallet eller Nunchuk (§19). For nøkkel 3 er valet låst til Nunchuk.
- Registrer versjonen til den valde programvara i
software_version(§19). - Verifiser at Sparrow og/eller Nunchuk støttar hardware-oppsettet.
- Registrer
OKellerPROBLEM. - Legg inn kommentar dersom det er problem.
Endra i §19: dei separate Sparrow- og Nunchuk-versjonsfelta er tekne ut.
Steg 6 — BIP327 / SLIP39
Registrer berre status for den valde nøkkelen sitt produkt og den valde programvara (§19):
- Nøkkelproduktet: SeedSigner for nøkkel 1, Blockstream Jade for nøkkel 2, Nunchuk for nøkkel 3.
- Vald programvare: Sparrow Wallet eller Nunchuk. Når Nunchuk både er nøkkel og programvare, blir det éi rad.
For kvart produkt:
- Registrer
bip327_status. - Registrer
slip39_status.
Alle fire produkta skal framleis kunne registrerast, men i ulike innsendingar.
Endra i §19: «Version checked», «Date checked» og «Notes or source» er tekne ut.
Steg 7 — KI-sikkerheitsstatus
Brukaren skal registrere resultat frå ein ekstern KI-/research-sjekk av leverandørane.
Leverandørar per innsending (§19):
- Nøkkel 1: SeedSigner, Sparrow Wallet og Nunchuk.
- Nøkkel 2: Blockstream Jade, Sparrow Wallet og Nunchuk.
- Nøkkel 3: Nunchuk åleine.
For kvar leverandør:
- Registrer status:
SECURE/PATCHED/VULNERABLE/COMPROMISED. - 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 checkfor å lagre kontrollen.
7. Varsel og oppfølging
Appen skal gi tydelege varsel når resultatet krev handling.
- Nøkkel ikkje tilgjengeleg → vis at nøkkelen må bytast ut før du går vidare, og at resten av nøkkelfelta ikkje kan registrerast (§19).
- 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. Skal ikkje utløysast når nøkkelen er utilgjengeleg.
- Cloud-helse er
PROBLEMeller leverandøren er ikkje i drift → vis at leverandørstatusen bør kontrollerast før du går vidare. Skal ikkje utløysast når nøkkelen er utilgjengeleg. - Adresseverifisering feilar → vis at adressa bør kontrollerast mot BSMS og testast på nytt. Skal ikkje utløysast når nøkkelen er utilgjengeleg.
- 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
VULNERABLE→ vis at firmware-/sikkerheitsproblem må følgjast opp. - KI-status
COMPROMISED→ 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 siste sjekk og neste forfall per nøkkel (§19: kvar nøkkel har sitt eige intervall).
- Vis aktive varsel.
- Knapp:
Start årleg health check. - Knapp/lenke:
Historikk.
Endra i §19, no implementert: dei to oversiktskorta («Last completed» og «Next check») gjekk ut frå éin felles dato. Dei er no «Next check» (tidlegaste forfall blant nøklane, med kva nøkkel det gjeld) og «Attention» (kor mange nøklar som har passert fristen). Datoane per nøkkel står på nøkkelkorta, frå GET /api/key-status.
9. Historikk
- Vis alle gjennomførte health checks kronologisk.
- Opne ein health check i read-only-visning.
- Vis kva nøkkel innsendinga gjeld (§19).
- Vis dato.
- Vis neste sjekk.
- Vis status per nøkkel.
- Vis programvarestatus — vald programvare og versjon (§19).
- 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 — må utvidast med migreringa i §19.
- Implementer lagring av nøklar.
- Implementer lagring av health checks — éi innsending gjeld éin vald nøkkel (§19).
- Implementer historikk.
- Implementer varsellogikken — varseltekstane og vilkåra blir endra i §19.
- Implementer rapporteksport.
- Implementer health endpoint.
Minimum:
GET /healthGET /api/keysGET /api/health-checksGET /api/health-checks/:idPOST /api/health-checks— kontrakten blir endra i §19.GET /api/export
Merk: GET /api/alerts og GET /api/key-status er ekstra endepunkt utanom minimumslista, fordi dashboardet treng varsla og statusen per nøkkel. Dei står ikkje i spesifikasjonen enno.
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.
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.
Merk: denne lista er eit varig forbod, ikkje ei oppgåveliste. Punkta blir difor ikkje kryssa av, men skal stadfestast på nytt før release.
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
VULNERABLE. - Test KI-status
COMPROMISED. - Test kontaktinfo
NEI.
StartOS-test
- Installer
.s9pkpå 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 SECURE, PATCHED, VULNERABLE eller COMPROMISED.
- 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 rekkjefø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
.s9pkog gjer første release.
Merk: steg 4, 5 og 6 vart først fullførte før §19 vart vedteken. Dei vart sette tilbake til uticka og er no gjort på nytt i tråd med §19, med 65 grøne testar. Steg 7 er gjort etter §19 og byggjer på at kvar nøkkel har sitt eige intervall.
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.
19. Ny avgjerd: registrering per nøkkel
Denne delen er den nyaste avgjerda og overstyrer motstridande krav ovanfor om at alle nøklane eller alle produkta må registrerast i same innsending. Eksisterande historiske data skal bevarast.
Status: implementert og verifisert.
Kvar innsending
- Ei innsending skal registrere kontrollen av éin vald nøkkel, ikkje alle tre samtidig.
- Brukaren skal velje nøkkel 1 (SeedSigner), nøkkel 2 (Blockstream Jade) eller nøkkel 3 (Nunchuk).
- Alle nøkkelkontrollar og nøkkelnotat i innsendinga skal gjelde berre den valde nøkkelen.
- Brukaren vel sjekkdato. Neste sjekkdato skal automatisk vere eitt kalenderår etter sjekkdatoen, skal ikkje vere redigerbar i skjemaet, og skal reknast/validerast på serveren.
- Kontaktstadfesting og overordna kommentar skal framleis kunne registrerast per innsending.
Programvarekompatibilitet
- Brukaren skal velje éi wallet-programvare: Sparrow eller Nunchuk.
- Registrer kompatibilitetsstatus og versjonen til den valde programvara for den valde nøkkelen.
- Fjern dei separate Sparrow- og Nunchuk-versjonsfelta.
BIP327 / SLIP39
- Registrer berre BIP327-status og SLIP39-status for den valde nøkkelen/produktet i kvar innsending.
- Fjern «Version checked», «Date checked» og «Notes or source» frå denne delen.
- Ikkje krev status for dei andre nøklane/produkta i same innsending.
Security status
- SeedSigner-status skal berre følgje registreringar av nøkkel 1.
- Blockstream Jade-status skal berre følgje registreringar av nøkkel 2.
- Nunchuk- og Sparrow-status skal følgje kvar registrering, sidan dei også er wallet-programvare.
- Ha berre éin Nunchuk-status per innsending. Ved nøkkel 3 gjeld den statusen Nunchuk-programvara og Nunchuk-nøkkelen; ikkje lag to dupliserte statusfelt.
- Vis og krev berre security status-felt som er relevante for vald nøkkel og programvare. Ikkje krev status for alle tre nøklane i éi innsending.
Lagring, historikk og verifikasjon
- Knytt nøkkelsjekk, programvarekompatibilitet, BIP327/SLIP39 og relevante security status-resultat til same innsending og vald nøkkel.
- Oppdater historikkdetaljen slik at han tydeleg viser vald nøkkel og tilhøyrande resultat.
- Bevar eksisterande lagra registreringar; bruk trygg, bakoverkompatibel databasemigrering dersom datamodellen må endrast.
- Oppdater servervalidering og testar: ei innsending skal krevje éin konfigurert nøkkel og gyldige, relevante resultat, og avvise manglande eller dupliserte nøkkel-/produktregistreringar og ugyldige programvareval.
- Test registrering av kvar nøkkel, automatisk neste dato, relevante programvare- og security status-resultat, og at eldre historikk framleis kan lesast.