Mark section 25 as implemented and verified, tick its items and condense it
This commit is contained in:
1 parent
7bd5144238
commit
1b33f0c950
1 file changed
+59
-129
@@ -14,7 +14,7 @@ Appen skal **berre registrere resultat og historikk**. Han skal ikkje signere Bi
|
||||
|
||||
Denne `TODO.md` er det einaste kravgrunnlaget du treng for MVP.
|
||||
|
||||
**Om dokumentet:** §1–§18 er kravspecen og gjeld som han står. §19–§22 er eit kort vedlegg med dei fire avgjerdene som vart tekne undervegs, alle innarbeidde i §1–§18. §23 (konfigurerbart nøkkeloppsett) og §24 (obligatoriske val, fjerning av BIP327/SLIP39, ny skjemastruktur og skjemaversjon 9) er implementerte og verifiserte. §25 (nøkkelidentitet, rotering, varselkvittering og innstillingar) er **implementert og ventar på verifisering**, og kjem før steg 9–12 i §18. §26 (sperring av ein nøkkel med ope varsel) er **avtalt, men ikkje implementert**, og kjem etter §25. Den fulle grunngjevinga for kvar avgjerd ligg i git-historikken.
|
||||
**Om dokumentet:** §1–§18 er kravspecen og gjeld som han står. §19–§22 er eit kort vedlegg med dei fire avgjerdene som vart tekne undervegs, alle innarbeidde i §1–§18. §23 (konfigurerbart nøkkeloppsett), §24 (obligatoriske val, fjerning av BIP327/SLIP39, ny skjemastruktur og skjemaversjon 9) og §25 (nøkkelidentitet, rotering, varselkvittering og innstillingar) er implementerte og verifiserte. §26 (sperring av ein nøkkel med ope varsel) er **avtalt, men ikkje implementert**, og kjem etter §25. Den fulle grunngjevinga for kvar avgjerd ligg i git-historikken.
|
||||
|
||||
## Språkkrav
|
||||
|
||||
@@ -83,7 +83,7 @@ Appen er bygd for eitt 2-av-3 multisig-oppsett. Tabellen under viser standardopp
|
||||
- [x] Vis 2-av-3 som oppsettet i dashboardet.
|
||||
- [x] Ha tre nøkkelprofilar, éin for kvar nøkkel.
|
||||
- [x] Ikkje bygg generell støtte for mange oppsett enno.
|
||||
- [ ] La brukaren gi nøklane namn, type og adressesti ved første oppstart (§23.2, §25.1).
|
||||
- [x] La brukaren gi nøklane namn, type og adressesti ved første oppstart (§23.2, §25.1).
|
||||
|
||||
**Merk:** §23.2 erstattar det faste oppsettet i denne seksjonen: kvar nøkkel blir konfigurert ved første oppstart, og namnet brukaren skriv, blir produktnamnet. §25.1 legg adressestien til. Tabellen over viser standardoppsettet appen vart bygd for.
|
||||
|
||||
@@ -126,10 +126,10 @@ Reglar:
|
||||
- [x] `hardware_works` er obligatorisk (`0` eller `1`) for ein tilgjengeleg hardware-nøkkel (§24.1).
|
||||
- [x] `contact_info_verified` er obligatorisk og har ingen «not assessed»-verdi (§24.1).
|
||||
- [x] `tool_checks`-tabellen er fjerna (§24.2, §24.4).
|
||||
- [ ] `name` i `keys` kan endrast i innstillingane, medan `type` og `address_path` er identiteten til nøkkelen (§25.1, §25.2).
|
||||
- [ ] `cloud_health_status` og `cloud_provider_operational` er fjerna. Ein cloud-nøkkel registrerer berre `available` (§25.3, §25.6).
|
||||
- [ ] `address_path_verified` blir sett av serveren ut frå ei samanlikning med `keys.address_path`, og blir ikkje sendt inn av brukaren (§25.1).
|
||||
- [ ] `wallet_software` i `health_checks` held fram som fri tekst, slik at eldre rader og fjerna listeelement held fram å visast rett (§25.4).
|
||||
- [x] `name` i `keys` kan endrast i innstillingane, medan `type` og `address_path` er identiteten til nøkkelen (§25.1, §25.2).
|
||||
- [x] `cloud_health_status` og `cloud_provider_operational` er fjerna. Ein cloud-nøkkel registrerer berre `available` (§25.3, §25.6).
|
||||
- [x] `address_path_verified` blir sett av serveren ut frå ei samanlikning med `keys.address_path`, og blir ikkje sendt inn av brukaren (§25.1).
|
||||
- [x] `wallet_software` i `health_checks` held fram som fri tekst, slik at eldre rader og fjerna listeelement held fram å visast rett (§25.4).
|
||||
|
||||
---
|
||||
|
||||
@@ -145,8 +145,8 @@ Reglar:
|
||||
- [x] `Hardware works` krev eit aktivt val (`Yes` / `No`) for ein tilgjengeleg hardware-nøkkel (§24.1).
|
||||
- [x] Kontaktstadfesting er obligatorisk og har ingen «not assessed»-verdi (§24.1).
|
||||
- [x] BIP327- og SLIP39-statusane er fjerna saman med funksjonen sin (§24.2).
|
||||
- [ ] `NOT_ASSESSED` blir òg den utleidde verdien når adressestien ikkje stemmer (§25.1).
|
||||
- [ ] `address_path_verified` blir utleidd av serveren og er ikkje eit val i skjemaet (§25.1).
|
||||
- [x] `NOT_ASSESSED` blir òg den utleidde verdien når adressestien ikkje stemmer (§25.1).
|
||||
- [x] `address_path_verified` blir utleidd av serveren og er ikkje eit val i skjemaet (§25.1).
|
||||
|
||||
---
|
||||
|
||||
@@ -181,11 +181,9 @@ Stega følgjer seksjonane i skjemaet.
|
||||
|
||||
### Adressesti (alle nøklar)
|
||||
|
||||
- [ ] Brukaren registrerer berre `Address path`, førehandsutfylt med nøkkelen sin lagra sti (§25.1).
|
||||
- [ ] `Address path verified` er ikkje lenger eit felt i skjemaet. Serveren samanliknar den innsende stien med `keys.address_path`: lik → `OK`, ulik → `PROBLEM` (§25.1).
|
||||
- [ ] Stemmer ikkje stien, viser nettlesaren eit påminningsvarsel før innsending, og kontrollen blir lagra som ein nøkkel som ikkje kunne kontrollerast (§25.1).
|
||||
- [x] I dag: `Address path verified` (`OK` / `PROBLEM`) er eit eige val, og `address_path` blir berre lagra når verifiseringa er `OK`.
|
||||
- [x] I dag: når nøkkelen ikkje er tilgjengeleg, blir adressestien ikkje spurt om.
|
||||
- [x] Brukaren registrerer berre `Address path`, førehandsutfylt med nøkkelen sin lagra sti (§25.1).
|
||||
- [x] `Address path verified` er ikkje lenger eit felt i skjemaet. Serveren samanliknar den innsende stien med `keys.address_path`: lik → `OK`, ulik → `PROBLEM` (§25.1).
|
||||
- [x] Stemmer ikkje stien, viser nettlesaren eit påminningsvarsel før innsending, og kontrollen blir lagra som ein nøkkel som ikkje kunne kontrollerast (§25.1).
|
||||
|
||||
## Steg 3 — Compatibility (03 / Compatibility)
|
||||
|
||||
@@ -194,8 +192,8 @@ Stega følgjer seksjonane i skjemaet.
|
||||
- [x] Registrer `OK` eller `PROBLEM`, med kommentar ved problem.
|
||||
- [x] For ein cloud-nøkkel er `Wallet software` og `Compatibility status` skjulte og utleidde.
|
||||
- [x] Når nøkkelen ikkje er tilgjengeleg, er feltet skjult og valfritt (§22).
|
||||
- [ ] Feltet heiter `Software version`, ikkje `Software version (if used)` (§25.5).
|
||||
- [ ] Ein cloud-nøkkel får òg `Software version`, medan `Wallet software` og `Compatibility status` held fram med å vere skjulte og utleidde (§25.5).
|
||||
- [x] Feltet heiter `Software version`, ikkje `Software version (if used)` (§25.5).
|
||||
- [x] Ein cloud-nøkkel får òg `Software version`, medan `Wallet software` og `Compatibility status` held fram med å vere skjulte og utleidde (§25.5).
|
||||
|
||||
## Steg 4 — External research (04 / External research)
|
||||
|
||||
@@ -219,7 +217,7 @@ Stega følgjer seksjonane i skjemaet.
|
||||
|
||||
- [x] Før lagring viser appen alle kontrollpunkt, alle problem, alle manglande kontrollar, neste sjekkdato, handlingar som bør følgjast opp, og utleidde verdiar merkte som nettopp det (§20).
|
||||
- [x] Brukaren må trykkje `Lagre health check` for å lagre kontrollen.
|
||||
- [ ] Når adressestien ikkje stemmer, blir valet om å lagre likevel tydeleg merkt i oppsummeringa (§25.1).
|
||||
- [x] Når adressestien ikkje stemmer, blir valet om å lagre likevel tydeleg merkt i oppsummeringa (§25.1).
|
||||
|
||||
---
|
||||
|
||||
@@ -227,21 +225,19 @@ Stega følgjer seksjonane i skjemaet.
|
||||
|
||||
Alle lagra kontrollar blir lesne (§21). Kva som kan lukke eit varsel, står i §25.3.
|
||||
|
||||
- [x] Nøkkel ikkje tilgjengeleg → kritisk varsel om at nøkkelen må bytast ut før ein går vidare, og at resten av nøkkelfelta ikkje kan registrerast. For ein cloud-nøkkel eitt samanslått varsel som òg nemner at leverandøren er registrert som nede (§20).
|
||||
- [x] Nøkkel ikkje tilgjengeleg → kritisk varsel om at nøkkelen må bytast ut før ein går vidare, og at resten av nøkkelfelta ikkje kan registrerast.
|
||||
- [x] Hardware fungerer ikkje → seed-backupen bør testast på annan kompatibel hardware.
|
||||
- [x] Seed-backup manglar eller er øydelagd → PROTOKOLL 3: Nøkkeltap skal aktiverast. Skal ikkje utløysast når nøkkelen er utilgjengeleg.
|
||||
- [x] Cloud-helse `PROBLEM` eller leverandøren ute av drift → leverandørstatusen bør kontrollerast før ein går vidare. Skal ikkje utløysast når nøkkelen er utilgjengeleg.
|
||||
- [x] Adresseverifisering feilar → adressa bør kontrollerast mot BSMS og testast på nytt. Skal ikkje utløysast når nøkkelen er utilgjengeleg.
|
||||
- [x] Programvare støttar ikkje lenger hardware → alternativ programvare eller løysing bør vurderast.
|
||||
- [x] KI-status `VULNERABLE` → firmware- eller sikkerheitsproblemet må følgjast opp.
|
||||
- [x] KI-status `COMPROMISED` → nøkkeltapsprosedyren må følgjast.
|
||||
- [x] Kontaktinfo ikkje stadfesta → kontaktinformasjonen må oppdaterast i den eksterne dokumentasjonen.
|
||||
- [x] Kritiske varsel blir lista før informative. Like varsel (same `code` og `source`) blir slegne saman, og berre den nyaste blir vist (§21).
|
||||
- [x] Appen utfører aldri desse tiltaka sjølv.
|
||||
- [ ] Adressestien stemmer ikkje med nøkkelen → kritisk varsel om at nøkkelen må bytast ut, og at resten av nøkkelfelta ikkje kan registrerast (§25.1).
|
||||
- [ ] Varselet om cloud-helse er fjerna: det kunne ikkje utløysast frå skjemaet (§25.3).
|
||||
- [ ] Varselet om feila adresseverifisering er erstatta av varselet om adressestifeil (§25.3).
|
||||
- [ ] Eit kvittert varsel er skjult til ein nyare kontroll for same `code` og `source` utløyser det igjen (§25.3).
|
||||
- [x] Adressestien stemmer ikkje med nøkkelen → kritisk varsel om at nøkkelen må bytast ut, og at resten av nøkkelfelta ikkje kan registrerast (§25.1).
|
||||
- [x] Varselet om cloud-helse er fjerna: det kunne ikkje utløysast frå skjemaet (§25.3).
|
||||
- [x] Varselet om feila adresseverifisering er erstatta av varselet om adressestifeil (§25.3).
|
||||
- [x] Eit kvittert varsel er skjult til ein nyare kontroll for same `code` og `source` utløyser det igjen (§25.3).
|
||||
- [ ] Ein nøkkel med eit ope varsel kan ikkje få ein ny kontroll før varselet er lukka (§26).
|
||||
|
||||
---
|
||||
@@ -254,8 +250,8 @@ Alle lagra kontrollar blir lesne (§21). Kva som kan lukke eit varsel, står i
|
||||
- [x] Vis alle aktive varsel, med kva registrering kvart varsel kjem frå (§21).
|
||||
- [x] Knapp `Start årleg health check`, lenke `Historikk` og lenke `Download CSV`.
|
||||
- [x] Vis oppsettsteget i staden for dashboardet når nøkkeloppsettet manglar (§23.2).
|
||||
- [ ] Vis handlinga som høyrer til kvart varsel, slik at brukaren kan lukke det (§25.3).
|
||||
- [ ] Lenke til innstillingane (§25.4).
|
||||
- [x] Vis handlinga som høyrer til kvart varsel, slik at brukaren kan lukke det (§25.3).
|
||||
- [x] Lenke til innstillingane (§25.4).
|
||||
|
||||
---
|
||||
|
||||
@@ -264,8 +260,8 @@ Alle lagra kontrollar blir lesne (§21). Kva som kan lukke eit varsel, står i
|
||||
- [x] Vis alle gjennomførte health checks kronologisk, nyaste først, med kva nøkkel kvar innsending gjeld (§19).
|
||||
- [x] Opne ein health check i read-only-visning med dato, neste sjekk, status per nøkkel, programvare og versjon, KI-status og kommentarar.
|
||||
- [x] Gamle health checks blir aldri overskrivne.
|
||||
- [ ] Vis `Address path verified` som den utleidde verdien han er, og ikkje som eit brukarval (§25.1).
|
||||
- [ ] Vis namnet nøkkelen har no, sidan namnet kan endrast i innstillingane (§25.2).
|
||||
- [x] Vis `Address path verified` som den utleidde verdien han er, og ikkje som eit brukarval (§25.1).
|
||||
- [x] Vis namnet nøkkelen har no, sidan namnet kan endrast i innstillingane (§25.2).
|
||||
|
||||
---
|
||||
|
||||
@@ -273,18 +269,18 @@ Alle lagra kontrollar blir lesne (§21). Kva som kan lukke eit varsel, står i
|
||||
|
||||
- [x] `GET /api/export` gjev rein CSV (UTF-8, komma, CRLF, header). Ingen XLSX, og appen lovar ikkje Excel-kompatibilitet.
|
||||
- [x] Éi rad per nøkkelsjekk. Kolonnen `Check id` knyter saman rader frå same innsending.
|
||||
- [x] Inneheld dato, neste sjekk, nøkkelstatus, hardware/firmware, seed/cloud-resultat, adresse-sti, programvare og kompatibilitet, KI-status, kontaktstadfesting og kommentarar.
|
||||
- [x] Inneheld dato, neste sjekk, nøkkelstatus, hardware/firmware, seed-resultat, adresse-sti, programvare og kompatibilitet, KI-status, kontaktstadfesting og kommentarar.
|
||||
- [x] Resultat med meir enn éin verdi per innsending ligg i éi celle som `SeedSigner: VULNERABLE; Sparrow Wallet: SECURE`.
|
||||
- [x] Statusverdiane blir skrivne slik dei er lagra (§21).
|
||||
- [x] Nøkkelnamnet og nøkkeltypen kjem frå oppsettet (§23.3).
|
||||
- [ ] Kolonnen for cloud-leverandøren er fjerna saman med feltet (§25.6).
|
||||
- [ ] Nøkkelnamnet i eksporten er namnet nøkkelen har no (§25.2).
|
||||
- [x] Kolonnen for cloud-leverandøren er fjerna saman med feltet (§25.6).
|
||||
- [x] Nøkkelnamnet i eksporten er namnet nøkkelen har no (§25.2).
|
||||
|
||||
---
|
||||
|
||||
# 11. Backend
|
||||
|
||||
- [x] SQLite med initialisering og migrering. Skjemaet er no versjon 9 (§21, §23.1, §23.4, §24.4) og blir versjon 10 når §25.6 er implementert.
|
||||
- [x] SQLite med initialisering og migrering. Skjemaet er no versjon 10 (§21, §23.1, §23.4, §24.4, §25.6).
|
||||
- [x] Lagring av nøklar, health checks, historikk og rapporteksport.
|
||||
- [x] Varsellogikken (§7).
|
||||
- [x] Health endpoint.
|
||||
@@ -298,18 +294,18 @@ Minimumsendepunkt:
|
||||
- [x] `POST /api/health-checks`
|
||||
- [x] `GET /api/export`
|
||||
|
||||
**Merk:** `GET /api/setup`, `POST /api/setup`, `GET /api/key-status`, `GET /api/previous-values` og `GET /api/alerts` er ekstra endepunkt utanom minimumslista, fordi oppsettsteget, dashboardet og skjemaet treng dei. Dei står ikkje i spesifikasjonen enno.
|
||||
**Merk:** `GET /api/setup`, `POST /api/setup`, `GET /api/settings`, `POST /api/settings/keys`, `POST /api/settings/wallet-software`, `POST /api/keys/<id>/rotate`, `POST /api/alerts/acknowledge`, `GET /api/key-status`, `GET /api/previous-values` og `GET /api/alerts` er ekstra endepunkt utanom minimumslista, fordi oppsettsteget, innstillingane, dashboardet og skjemaet treng dei. Dei står ikkje i spesifikasjonen enno.
|
||||
|
||||
- [x] `POST /api/health-checks` krev éin konfigurert nøkkel, `available` og gyldige, relevante resultat, og avviser manglande eller dupliserte registreringar (§22).
|
||||
- [x] `POST /api/health-checks` krev ikkje programvare eller KI-status når nøkkelen er utilgjengeleg (§22).
|
||||
- [x] `POST /api/setup` lagrar nøkkeloppsettet éin gong, krev unike og ikkje-tømme namn, og avviser eit nytt oppsett med `409` (§23.2).
|
||||
- [ ] `POST /api/setup` krev òg ein adressesti per nøkkel (§25.1).
|
||||
- [ ] `GET /api/settings` gjev nøklane med adressestien deira og lista over wallet-programvare (§25.4).
|
||||
- [ ] `POST /api/settings/keys` lagrar eit nytt namn, og ein adressesti så lenge nøkkelen ikkje har nokon lagra kontroll (§25.2).
|
||||
- [ ] `POST /api/settings/wallet-software` lagrar heile lista (§25.4).
|
||||
- [ ] `POST /api/keys/<id>/rotate` roterer ein nøkkel og kvitterer ut varsla hans (§25.2).
|
||||
- [ ] `POST /api/alerts/acknowledge` kvitterer ut eit varsel med `code`, `source` og ein årsak (§25.3).
|
||||
- [ ] `POST /api/health-checks` samanliknar adressestien og krev eit minimalt innhald når han ikkje stemmer, elles `400` (§25.1).
|
||||
- [x] `POST /api/setup` krev òg ein adressesti per nøkkel (§25.1).
|
||||
- [x] `GET /api/settings` gjev nøklane med adressestien deira og lista over wallet-programvare (§25.4).
|
||||
- [x] `POST /api/settings/keys` lagrar eit nytt namn, og ein adressesti så lenge nøkkelen ikkje har nokon lagra kontroll (§25.2).
|
||||
- [x] `POST /api/settings/wallet-software` lagrar heile lista (§25.4).
|
||||
- [x] `POST /api/keys/<id>/rotate` roterer ein nøkkel og kvitterer ut varsla hans (§25.2).
|
||||
- [x] `POST /api/alerts/acknowledge` kvitterer ut eit varsel med `code`, `source` og ein årsak (§25.3).
|
||||
- [x] `POST /api/health-checks` samanliknar adressestien og krev eit minimalt innhald når han ikkje stemmer, elles `400` (§25.1).
|
||||
- [ ] `POST /api/health-checks` avviser ein nøkkel som har eit ope varsel (§26).
|
||||
|
||||
---
|
||||
@@ -325,10 +321,10 @@ Minimumsendepunkt:
|
||||
- [x] Eige oppsettsteg for namn og type ved første oppstart (§23.2).
|
||||
- [x] Bygg `Wallet software`-vala frå oppsettet i staden for ei fast liste (§23.3).
|
||||
- [x] Følg den nye seksjonsrekkjefølgja: 01 Schedule, 02 Key, 03 Compatibility, 04 External research, 05 Contact confirmation, 06 Notes (§24.3).
|
||||
- [ ] Oppsettsteget spør òg om adressesti (§25.1).
|
||||
- [ ] Ny innstillingsside med seksjonar for nøklar og wallet-programvare, bygd for fleire tema seinare (§25.4).
|
||||
- [ ] Eit påminningsvarsel før innsending når adressestien ikkje stemmer (§25.1).
|
||||
- [ ] `Wallet software`-vala kjem frå nøkkeloppsettet, cloud-nøklane og innstillingslista (§25.4).
|
||||
- [x] Oppsettsteget spør òg om adressesti (§25.1).
|
||||
- [x] Ny innstillingsside med seksjonar for nøklar og wallet-programvare, bygd for fleire tema seinare (§25.4).
|
||||
- [x] Eit påminningsvarsel før innsending når adressestien ikkje stemmer (§25.1).
|
||||
- [x] `Wallet software`-vala kjem frå nøkkeloppsettet, cloud-nøklane og innstillingslista (§25.4).
|
||||
- [ ] Sørg for at appen fungerer godt i vanleg StartOS-browser.
|
||||
- [ ] Skjemaet viser kva nøklar som er sperra av eit ope varsel, og kva handling som lukkar det (§26).
|
||||
|
||||
@@ -410,7 +406,6 @@ Unngå:
|
||||
- [ ] Test nøkkel utilgjengeleg.
|
||||
- [ ] Test hardware-feil.
|
||||
- [ ] Test seed-backup-feil.
|
||||
- [ ] Test adresseverifiseringsfeil.
|
||||
- [ ] Test adressestifeil (mismatch), både påminninga før innsending og varselet etterpå (§25.1).
|
||||
- [ ] Test programvare-inkompatibilitet.
|
||||
- [ ] Test at `Hardware works` krev eit val.
|
||||
@@ -476,9 +471,9 @@ Utfør oppgåvene i denne rekkjefølgja og ikkje hopp fram til avanserte funksjo
|
||||
|
||||
**Merk:** steg 4, 5 og 6 vart først fullførte før §19 vart vedteken, og gjorde på nytt etterpå. Steg 4 og 6 vart kryssa av då §22 var verifisert.
|
||||
|
||||
**Merk:** §23 og §24 er implementerte og verifiserte. §25 er implementert og ventar på verifisering. §26 er avtalt, men ikkje implementert. Begge kjem før steg 9–12. Steg 9–12 er ikkje starta.
|
||||
**Merk:** §23, §24 og §25 er implementerte og verifiserte. §26 er avtalt, men ikkje implementert, og kjem før steg 9–12. Steg 9–12 er ikkje starta.
|
||||
|
||||
**Testar:** 178 grøne testar etter §24. Talet blir oppdatert når §25 er verifisert. Køyr `python3 -m unittest discover -s tests`.
|
||||
**Testar:** 283 grøne testar etter §25. Køyr `python3 -m unittest discover -s tests`.
|
||||
|
||||
**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.
|
||||
|
||||
@@ -486,13 +481,13 @@ Utfør oppgåvene i denne rekkjefølgja og ikkje hopp fram til avanserte funksjo
|
||||
|
||||
# 19–22. Vedtekne avgjerder (implementerte og verifiserte)
|
||||
|
||||
Desse fire vart tekne undervegs og er no innarbeidde i §1–§18. Kvar referanse i §1–§18 peikar på avsnittet nedanfor. Den fulle grunngjevinga ligg i git-historikken. §23 og §24 endra enkelte av detaljane etterpå; det står i så fall i parentes. §25 endrar detaljane nedanfor, og er no implementert.
|
||||
Desse fire vart tekne undervegs og er no innarbeidde i §1–§18. Kvar referanse i §1–§18 peikar på avsnittet nedanfor. Den fulle grunngjevinga ligg i git-historikken. §23–§25 endra enkelte av detaljane etterpå; det står i så fall i parentes.
|
||||
|
||||
**§19 — registrering per nøkkel.** Ei innsending gjeld **éin vald nøkkel**, ikkje alle tre. Brukaren vel éi wallet-programvare med eitt versjonsfelt. `seed_backup_status`, `address_verified` og `derivation_height` er fjerna. Migreringa er bakoverkompatibel, og eldre historikk blir framleis vist. (§23.3 endra vala: `Sparrow Wallet` pluss namnet på kvar cloud-nøkkel, og ein cloud-nøkkel er låst til sitt eige namn.)
|
||||
|
||||
**§20 — skjulte felt som blir utleidde.** Ein cloud-nøkkel samlar berre `Availability`; cloud-helse, «leverandøren er i drift» og kompatibilitet blir utleidde. Førre lagra verdi blir fylt inn i feltet. Alt utleidd blir lista i Review-oppsummeringa, merkt som nettopp det. (§23.1 gjorde den førre verdien til ein vanleg input-verdi i staden for ein placeholder, §23.3 fjerna vidareføringa av ein tredje leverandør, og §25.3 fjernar dei to utleidde cloud-felta.)
|
||||
**§20 — skjulte felt som blir utleidde.** Ein cloud-nøkkel samlar berre `Availability`; cloud-helse, «leverandøren er i drift» og kompatibilitet blir utleidde. Førre lagra verdi blir fylt inn i feltet. Alt utleidd blir lista i Review-oppsummeringa, merkt som nettopp det. (§23.1 gjorde den førre verdien til ein vanleg input-verdi i staden for ein placeholder, §23.3 fjerna vidareføringa av ein tredje leverandør, og §25.3 fjerna dei to utleidde cloud-felta.)
|
||||
|
||||
**§21 — engelske statusverdiar, adressesti og alle varsel.** `IKKJE_VURDERT` → `NOT_ASSESSED`. Skjema versjon 6 (no versjon 9, §23.4 og §24.4; versjon 10 når §25.6 er verifisert): kvar råka tabell blir bygd opp att med `PRAGMA foreign_keys = OFF` og `PRAGMA foreign_key_check` før commit. `Address path` blir berre vist og lagra når verifiseringa er `OK`. `GET /api/alerts` summerer alle lagra kontrollar, med `check_id` og `checked_at`, slår saman like varsel og listar kritiske først. «Helsesjekk» og `data/helsesjekk.sqlite3` er dokumenterte unntak frå engelskregelen. (§25.1 erstattar kravet om at `Address path` berre blir lagra når verifiseringa er `OK`, og §25.3 legg kvittering til.)
|
||||
**§21 — engelske statusverdiar, adressesti og alle varsel.** `IKKJE_VURDERT` → `NOT_ASSESSED`. Skjema versjon 6 (no versjon 10, §23.4, §24.4 og §25.6): kvar råka tabell blir bygd opp att med `PRAGMA foreign_keys = OFF` og `PRAGMA foreign_key_check` før commit. `GET /api/alerts` summerer alle lagra kontrollar, med `check_id` og `checked_at`, slår saman like varsel og listar kritiske først. «Helsesjekk» og `data/helsesjekk.sqlite3` er dokumenterte unntak frå engelskregelen. (§25.1 erstatta kravet om at `Address path` berre blir lagra når verifiseringa er `OK`, og §25.3 la kvittering til.)
|
||||
|
||||
**§22 — utilgjengeleg nøkkel gjer resten valfritt.** `Availability` er obligatorisk med berre Ja/Nei. Når han er Nei, blir programvare og KI-status skjulte og ikkje kravde, og dei må vere tomme i POST — elles svarar serveren `400`. Det blir ikkje lagra nokon slike rader, `wallet_software` er `NULL`, og `software_compatibility_status` blir `NOT_ASSESSED`. Ein cloud-nøkkel held fram med dei utleidde cloud-verdiane sine og gir det samanslåtte varselet. Databasen kravde inga endring. (§25.1 brukar same mønsteret for ein adressestifeil.)
|
||||
|
||||
@@ -508,7 +503,7 @@ Avtalt 02.10.2026, implementert og verifisert før steg 9–12 i §18. Reglane s
|
||||
- `Wallet software`-vala er `Sparrow Wallet` pluss namnet på kvar konfigurert cloud-nøkkel. Namn på hardware-nøklar er aldri eit software-val.
|
||||
- Oppsettet blir lagra i SQLite saman med historikken. Nye databasar får eit oppsettsteg; eksisterande databasar blir migrerte frå nøkkelradene sine. Ei uleseleg database gir ein feil og blir ikkje behandla som ny.
|
||||
- Skjemafiksar: `Firmware version`, `Address path` og `Software version` blir fylte med førre lagra verdi som ein vanleg input-verdi; `Software compatibility` krev eit aktivt val; kontaktspørsmålet gjeld berre nøkkelhaldaren til den valde nøkkelen, med verdiane `Confirmed current` / `Needs external update`.
|
||||
- Skjemaversjon 8 då §23 vart ferdig (§24.4 tok han til 9, §25.6 til 10), og 178 grøne testar. Nye endepunkt: `GET /api/setup` og `POST /api/setup`.
|
||||
- Skjemaversjon 8 då §23 vart ferdig (§24.4 tok han til 9, §25.6 til 10). Nye endepunkt: `GET /api/setup` og `POST /api/setup`.
|
||||
- Verifisert med testsuiten. Nettlesarflytane og migreringa av ein verkeleg eldre database står att som manuelle testar i §16.
|
||||
|
||||
## Framtidig arbeid, ikke no
|
||||
@@ -529,103 +524,38 @@ Avtalt 03.10.2026, implementert og verifisert før steg 9–12 i §18. Der §24
|
||||
|
||||
**§24.4 — datamodell og migrering.** Skjemaversjon 9. Migreringa droppar `tool_checks` med `PRAGMA foreign_keys = OFF` og `PRAGMA foreign_key_check` før commit. `tool_checks` er ei barnetabell, så droppet krev inga omskriving av `health_checks`, og alle andre tabellar er uendra.
|
||||
|
||||
**§24.5 — testar og dokumentasjon.** Testane for BIP327/SLIP39 er fjerna, testar for dei obligatoriske vala (både i skjemaet og på serveren) og for migrering av ein database med `tool_checks` til versjon 9 er lagde til, og `README.md` er oppdatert. 178 grøne testar.
|
||||
**§24.5 — testar og dokumentasjon.** Testane for BIP327/SLIP39 er fjerna, testar for dei obligatoriske vala (både i skjemaet og på serveren) og for migrering av ein database med `tool_checks` til versjon 9 er lagde til, og `README.md` er oppdatert.
|
||||
|
||||
---
|
||||
|
||||
# 25. Nøkkelidentitet, rotering, varselkvittering og innstillingar (IMPLEMENTERT, VENTAR PÅ VERIFISERING)
|
||||
# 25. Nøkkelidentitet, rotering, varselkvittering og innstillingar (implementert og verifisert)
|
||||
|
||||
Avtalt 04.10.2026. Arbeidet er utført, men punkta under blir ikkje kryssa av før testane er grøne og brukaren har stadfesta at det verkar. Arbeidet vart gjort **før** steg 9–12 i §18. Der §25 seier noko anna enn §3–§12, gjeld §25. Testtalet i §18 blir oppdatert når verifiseringa er gjord.
|
||||
Avtalt 04.10.2026, implementert og verifisert før steg 9–12 i §18. Reglane står i §3–§12; dette er berre eit kort samandrag, så fila er lett å lese. 283 grøne testar.
|
||||
|
||||
## 25.1 Adressestien er nøkkelens identitet
|
||||
|
||||
- [ ] `keys` får ein `address_path`-kolonne, og oppsettsteget (`/setup`) spør om namn, type **og** adressesti for kvar av dei tre nøklane.
|
||||
- [ ] `Address path verified` er ikkje lenger eit felt i skjemaet. Brukaren registrerer berre `Address path`, førehandsutfylt med nøkkelen sin lagra sti.
|
||||
- [ ] Serveren samanliknar den innsende stien med `keys.address_path`, etter `strip`: lik → `OK`, ulik → `PROBLEM`. Verdien blir lagra i `address_path_verified`, så historikk, eksport og varsel held fram å verke utan nye kolonnar.
|
||||
- [ ] Ved ulik sti viser nettlesaren eit påminningsvarsel før innsending, t.d. «The address path does not match the one stored for this key. Check it against your BSMS and try again, or confirm that you want to record this check anyway.»
|
||||
- [ ] Innsending likevel blir behandla som ein nøkkel som ikkje kunne kontrollerast: `address_path`, nøkkelnotatet, kontaktstadfestinga og den overordna kommentaren blir lagra, medan hardware, programvare og KI-status blir tomme, `wallet_software` blir `NULL`, og `software_compatibility_status` blir `NOT_ASSESSED`. Eit kritisk varsel blir utløyst.
|
||||
- [ ] Serveren krev det same minimale innhaldet og svarar `400` om programvare eller KI-status følgjer med, slik §22 alt gjer for ein utilgjengeleg nøkkel. Nettlesaren byggjer difor eit minimalt innhald når stien ikkje stemmer.
|
||||
- [ ] `address_path_verified` blir elles berre sett av serveren, aldri sendt inn.
|
||||
- [ ] Adressestien kan berre endrast i innstillingane så lenge nøkkelen ikkje har nokon lagra kontroll. Etter det er han låst, fordi han er identiteten til nøkkelen.
|
||||
- [ ] Adressestien er ein offentleg derivasjonssti og inneheld inga hemmelegheit.
|
||||
|
||||
**Gjort:** `keys.address_path` er lagd til (ikkje-tom ved oppsett, låst etter første lagra kontroll), oppsettsteget spør om han, og skjemaet registrerer berre `Address path`. Serveren samanliknar stien etter `strip` og set `address_path_verified` sjølv; eit innsend resultat blir ignorert. Ved ulik sti blir nøkkelen handsama som ein nøkkel som ikkje kunne kontrollerast, med `400` om programvare eller KI-status følgjer med, og nettlesaren viser eit påminningsvarsel med ei avkryssing før innsending.
|
||||
|
||||
## 25.2 Namn kan endrast, og ein nøkkel kan roterast
|
||||
|
||||
- [ ] Namnet i `keys` kan endrast i innstillingane. Typen og adressestien kan ikkje endrast.
|
||||
- [ ] Historikk, varsel og CSV viser namnet nøkkelen har no, sidan namnet blir lese frå nøkkelraden.
|
||||
- [ ] Rotering: brukaren stadfestar at hardware-walleten er bytt ut med ein ny. Han vel om namnet skal haldast eller endrast, typen er låst, og han må stadfeste at adressestien er lik den førre.
|
||||
- [ ] Rotering oppdaterer nøkkelraden og kvitterer ut varsla som høyrer til nøkkelen.
|
||||
- [ ] Rotering gjer inga endring i tidlegare lagra kontrollar.
|
||||
|
||||
**Gjort:** `POST /api/settings/keys` lagrar eit nytt namn (og adressestien medan han er ulåst), og `POST /api/keys/<id>/rotate` stadfestar byttet, held eller endrar namnet, kvitterer ut nøkkelens eigne varsel, og rører ingen tidlegare kontroll. Rotering ligg berre på `/settings`, kan gjere fleire nøklar i éi handling, og sida varslar om at rotering gir ei ny lommebok, slik at midla må flyttast frå den gamle multisig-oppsetninga før dei gamle nøklane blir kasserte.
|
||||
- **Adressestien er identiteten til nøkkelen, saman med typen.** `keys.address_path` blir lagra i oppsettet og er låst etter første lagra kontroll. Oppsettsteget spør om namn, type og adressesti, og skjemaet registrerer berre `Address path`, førehandsutfylt med nøkkelen sin lagra sti.
|
||||
- **Serveren utleier `address_path_verified`.** Den innsende stien blir samanlikna med `keys.address_path` etter `strip`: lik → `OK`, ulik → `PROBLEM`. Eit innsend resultat blir ignorert. Ved ulik sti blir nøkkelen handsama som ein nøkkel som ikkje kunne kontrollerast (§22-mønsteret): berre stien, nøkkelnotatet, kontaktstadfestinga og den overordna kommentaren blir lagra, `wallet_software` blir `NULL`, `software_compatibility_status` blir `NOT_ASSESSED`, og eit kritisk varsel blir utløyst. Nettlesaren viser eit påminningsvarsel med ei avkryssing før innsending. Ein utilgjengeleg nøkkel registrerer ingen sti, og gir difor aldri eit slikt varsel.
|
||||
- **Namnet er ein etikett som kan endrast i innstillingane**, medan typen og adressestien er låste. Historikk, varsel og CSV viser namnet nøkkelen har no.
|
||||
- **Rotering** (`POST /api/keys/<id>/rotate`) stadfestar at nøkkelen er bytt ut, held eller endrar namnet, kvitterer ut nøkkelens eigne varsel, og gjer inga endring i tidlegare kontrollar. Sida varslar om at rotering gir ei ny lommebok, slik at midla må flyttast frå den gamle multisig-oppsetninga før dei gamle nøklane blir kasserte.
|
||||
- **Innstillingane** ligg på `/settings`, med `01 / Keys`, `02 / Wallet software` og `03 / Key rotation`, bygd for fleire seksjonar seinare. Software-lista blir lagra heilt, er sådd med `Sparrow Wallet`, må aldri bli tom, og kan ikkje innehalde eit namn som alt kjem frå ein cloud-nøkkel. Software-vala i skjemaet er lista pluss cloud-nøkkelnamna, og dashboardet lenkjer til innstillingane.
|
||||
- **Skjemajusteringar:** feltet heiter `Software version`, gjeld òg ein cloud-nøkkel, og blir gjenbrukt frå førre lagra verdi for same nøkkel og programvare.
|
||||
- **Skjema versjon 10:** `keys.address_path`, `wallet_software` og `alert_acknowledgements` er lagde til, og `cloud_health_status` og `cloud_provider_operational` er fjerna frå `key_checks`. Ingen datamigrering for eldre testdatabasar: `data`-mappa blir sletta og oppsettet gjort på nytt. Migreringa køyrer framleis med `PRAGMA foreign_keys = OFF` og `PRAGMA foreign_key_check` før commit.
|
||||
|
||||
## 25.3 Varselkvittering
|
||||
|
||||
Eit kvittert varsel held seg skjult til ein nyare kontroll for same `code` og `source` utløyser det igjen. Kvitteringa blir lagra med `code`, `source`, `acknowledged_at` og ein årsak. I tillegg lagrar han `check_id` til den nyaste kontrollen som heva varselet, slik at eit nyare varsel alltid kjem tilbake.
|
||||
Eit kvittert varsel held seg skjult til ein nyare kontroll for same `code` og `source` utløyser det igjen. Kvitteringa blir lagra med `code`, `source`, `check_id` (den nyaste kontrollen som heva varselet), `acknowledged_at` og ein årsak.
|
||||
|
||||
| `code` | Alvor | Utløyst av | Slik blir det lukka |
|
||||
|---|---|---|---|
|
||||
| `key_unavailable` | critical | `available` = Nei | Rotering |
|
||||
| `key_unavailable`, cloud-variant | critical | `available` = Nei på ein cloud-nøkkel | Rotering |
|
||||
| `address_path_mismatch` (ny) | critical | `Address path` ulik nøkkelen sin lagra sti | Rotering |
|
||||
| `address_path_mismatch` | critical | `Address path` ulik nøkkelen sin lagra sti | Rotering |
|
||||
| `hardware_failure` | critical | `Hardware works` = No | Rotering, eller berre lukking, sidan ein ny hardware-wallet med same seed er same nøkkel med same adressesti |
|
||||
| `seed_backup_problem` | critical | Seed-backup `PROBLEM` | Rotering |
|
||||
| `software_incompatible` | critical | `software_compatibility_status` = `PROBLEM` | Lukking, etter at alternativ programvare er lagd til i innstillingane |
|
||||
| `security_vulnerable` | critical | KI-status `VULNERABLE` | Kjelde = nøkkel: rotering, bytte av hardware-wallet, eller lukking. Kjelde = programvare: som for `software_incompatible` |
|
||||
| `security_vulnerable` | critical | KI-status `VULNERABLE` | Kjelde = nøkkel: rotering eller lukking. Kjelde = programvare: lukking |
|
||||
| `security_compromised` | critical | KI-status `COMPROMISED` | Kjelde = nøkkel: rotering er påkravd. Kjelde = programvare: lukking |
|
||||
| `contact_info_unconfirmed` | info | Kontaktstadfesting `Needs external update` | Lukking, med ei melding om at kontaktinformasjonen er oppdatert eksternt |
|
||||
|
||||
- [ ] `address_path_mismatch` får sin eigen `code` og ordlyd, t.d. «The recorded address path does not match this key. Replace the key before continuing; the remaining checks for this key cannot be recorded.» Han blir ikkje slått saman med eit ekte utilgjengeleg-varsel.
|
||||
- [ ] `cloud_provider_problem` er fjerna. Regelen kunne ikkje utløysast frå skjemaet, sidan dei to cloud-felta vart utleidde.
|
||||
- [ ] `address_verification_failed` er fjerna og erstatta av `address_path_mismatch`.
|
||||
- [ ] Kvar handling som lukkar eit varsel krev ei stadfesting frå brukaren, og appen utfører aldri eit tiltak sjølv.
|
||||
|
||||
**Gjort:** `alerts.py` har `address_path_mismatch` med eigen ordlyd, kvart varsel oppgjev `actions` (`rotate`/`acknowledge`) og `key_id`, og `collect_alerts` filtrerer bort kvitterte varsel. `cloud_provider_problem` og `address_verification_failed` er fjerna, og den samanslåtte cloud-ordlyden forsvann — éi `key_unavailable`-melding gjeld no alle nøklar. `POST /api/alerts/acknowledge` lagrar `code`, `source`, `check_id`, årsak og tidspunkt, svarar `404` når varselet ikkje finst, og `actions` i UI-et avgjer kva knappar som blir viste.
|
||||
|
||||
## 25.4 Innstillingar
|
||||
|
||||
- [ ] Ny side `/settings`, med tydelege seksjonar: `01 / Keys` (namn og adressesti per nøkkel) og `02 / Wallet software` (lista brukaren vedlikeheld).
|
||||
- [ ] Sida er bygd slik at fleire seksjonar kan leggjast til seinare, med same mønster for overskrift, hjelpetekst og lagring.
|
||||
- [ ] `Wallet software`-lista blir lagra heilt, ikkje elementvis, og blir validert på serveren: ikkje-tomme, unike namn, og ikkje eit namn som alt kjem frå ein cloud-nøkkel.
|
||||
- [ ] `Wallet software`-vala i skjemaet er `Sparrow Wallet`, namnet på kvar konfigurert cloud-nøkkel og kvart element i innstillingslista. Namn på hardware-nøklar er framleis aldri eit software-val.
|
||||
- [ ] Å fjerne eit element frå lista rører ikkje lagra kontrollar, sidan `wallet_software` i `health_checks` er fri tekst.
|
||||
- [ ] Sida må leggjast inn i `STATIC_FILES` i `app.py`, elles svarar ho `404`.
|
||||
- [ ] Dashboardet får ei lenke til innstillingane.
|
||||
|
||||
**Gjort:** `/settings` er lagd inn i `STATIC_FILES` og har `01 / Keys`, `02 / Wallet software` og `03 / Key rotation`, med eitt lagre-kall per nøkkel og éin lagring for heile software-lista. Lista blir sådd med `Sparrow Wallet` ved oppstart, må aldri bli tom, og kan ikkje innehalde eit namn som alt kjem frå ein cloud-nøkkel. Software-vala i skjemaet er lista pluss cloud-nøkkelnamna, og dashboardet har ei lenkje til innstillingane.
|
||||
|
||||
## 25.5 Skjemajusteringar
|
||||
|
||||
- [ ] `Software version (if used)` blir `Software version`.
|
||||
- [ ] Ein cloud-nøkkel får òg `Software version`, medan `Wallet software` og `Compatibility status` held fram med å vere skjulte og utleidde.
|
||||
- [ ] Versjonen blir gjenbrukt frå førre lagra verdi for same nøkkel, som i dag.
|
||||
|
||||
**Gjort:** feltet heiter no `Software version` og står utanfor det gridet som blir skjult for ein cloud-nøkkel, slik at alle nøklar får det. Versjonen blir framleis gjenbrukt frå førre lagra verdi for same nøkkel og same programvare.
|
||||
|
||||
## 25.6 Datamodell og migrering (versjon 10)
|
||||
|
||||
- [ ] Nye kolonnar og tabellar: `keys.address_path`, `wallet_software` og `alert_acknowledgements`.
|
||||
- [ ] Fjerna: `cloud_health_status` og `cloud_provider_operational` i `key_checks`, saman med dei utleidde verdiane i skjemaet.
|
||||
- [ ] Inga datamigrering for eldre testdatabasar. Skjemaversjonen blir heva til 10, og dei eksisterande migreringane for eldre oppsett blir ståande som dei er.
|
||||
- [ ] Migreringa køyrer framleis med `PRAGMA foreign_keys = OFF` og `PRAGMA foreign_key_check` før commit (§21).
|
||||
|
||||
**Gjort:** skjema versjon 10 med `keys.address_path`, `wallet_software` og `alert_acknowledgements`, og dei to cloud-kolonnane er fjerna frå `key_checks`. Ingen datamigrering for eldre testdatabasar: `data`-mappa blir sletta og oppsettet gjort på nytt. Migreringa køyrer framleis med `PRAGMA foreign_keys = OFF` og `PRAGMA foreign_key_check` før commit.
|
||||
|
||||
## 25.7 Testar og dokumentasjon
|
||||
|
||||
- [ ] Testar for at `address_path_verified` blir sett av serveren, både ved lik og ulik sti.
|
||||
- [ ] Testar for at ei innsending med ulik sti blir lagra som ein nøkkel som ikkje kunne kontrollerast, og at programvare eller KI-status i eit slikt innhald gir `400`.
|
||||
- [ ] Testar for rotering, med og utan nytt namn, og for at adressestien er låst etter første lagra kontroll.
|
||||
- [ ] Testar for kvittering, inkludert at eit nyare varsel for same `code` og `source` kjem tilbake.
|
||||
- [ ] Testar for innstillingane: namn, adressesti, `wallet_software`-lista og valideringa av ho.
|
||||
- [ ] Testar for at `Software version` òg blir lagra for ein cloud-nøkkel.
|
||||
- [ ] Testar for at dei fjerna varsla ikkje lenger kan utløysast.
|
||||
- [ ] Alle testar skal vere grøne, og talet i §18 skal oppdaterast.
|
||||
- [ ] `README.md`, `TODO.md` og `ai-note.md` skal oppdaterast.
|
||||
|
||||
**Gjort:** alle seks testfilene er oppdaterte og utvida med testar for punkta over, og `README.md`, `TODO.md` og `ai-note.md` er oppdaterte. Testane er ikkje køyrde av brukaren enno, så talet i §18 står framleis på 178.
|
||||
Kvart varsel oppgjev kva handlingar som lukkar det (`rotate`/`acknowledge`) og kva nøkkel det høyrer til, og kvar handling krev ei stadfesting frå brukaren. Appen utfører aldri eit tiltak sjølv. `cloud_provider_problem` og `address_verification_failed` er fjerna.
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in new issue
Block a user