Compress the implemented rounds and add section 27
This commit is contained in:
1 parent
9f15f1b532
commit
2b18108e36
1 file changed
+214
-369
@@ -4,100 +4,85 @@
|
|||||||
|
|
||||||
Bygg ein **enkel lokal web-app** som køyrer som ein StartOS 0.4.0-service.
|
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 **2-av-3 multisig-oppsett** med tre nøklar (namn, type og adressesti blir konfigurerte ved første oppstart, §23.2 og §25.1):
|
Appen skal hjelpe éin brukar å gjennomføre og dokumentere ein årleg health check av eit **2-av-3 multisig-oppsett** med tre nøklar. Namn, type og adressesti blir konfigurerte ved første oppstart.
|
||||||
|
|
||||||
- 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.
|
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.
|
**Om dokumentet**
|
||||||
|
|
||||||
**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, og §23–§26 er samandrag av dei fire rundane som er implementerte og verifiserte: konfigurerbart nøkkeloppsett (§23), obligatoriske val og fjerning av BIP327/SLIP39 (§24), nøkkelidentitet, rotering, varselkvittering og innstillingar (§25), og sperring, unike adressestiar, rotering med ny sti og varselhandlingar (§26). Alle reglane står i §1–§18; den fulle grunngjevinga ligg i git-historikken.
|
- §1–§18 er kravspecen og gjeld som han står.
|
||||||
|
- §19–§27 er korte samandrag av rundane. Alle reglane deira står i §1–§18; den fulle grunngjevinga ligg i git-historikken.
|
||||||
|
- Eit punkt utan avkryssingsboks er implementert og verifisert. `[ ]` markerer det som står att.
|
||||||
|
- **Status:** §1–§26 er implementerte og verifiserte, skjema versjon 10, testsuiten er grøn (319 testar). §27 er neste runde og er **ikkje starta**. §18 steg 9–12 (StartOS) er **ikkje starta**.
|
||||||
|
|
||||||
## Språkkrav
|
## Språkkrav
|
||||||
|
|
||||||
- [x] Brukargrensesnittet, app-tekst, kjeldekode, variabel- og funksjonsnamn, kommentarar og teknisk dokumentasjon skal vere på engelsk.
|
- Brukargrensesnittet, app-tekst, kjeldekode, variabel- og funksjonsnamn, kommentarar og teknisk dokumentasjon skal vere på engelsk.
|
||||||
- [x] `TODO.md` kan vere på norsk; dette er det einaste unntaket.
|
- `TODO.md` er på norsk; dette er det einaste unntaket.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 1. Scope for første versjon
|
# 1. Scope for første versjon
|
||||||
|
|
||||||
## Dette skal vere med
|
**Dette skal vere med**
|
||||||
|
|
||||||
- [x] Ein enkel web-app med dashboard.
|
- Ein enkel web-app med dashboard.
|
||||||
- [x] Registrering av dei tre nøklane.
|
- Registrering av dei tre nøklane.
|
||||||
- [x] Registrering av årleg health check.
|
- Registrering av årleg health check, med kontroll av alle punkta i den årlege sjekklista.
|
||||||
- [x] Kontroll av alle punkta i den årlege sjekklista.
|
- Varsel når eit kontrollpunkt krev oppfølging.
|
||||||
- [x] Varsel når eit kontrollpunkt krev oppfølging.
|
- Historikk over gjennomførte health checks.
|
||||||
- [x] Historikk over gjennomførte health checks.
|
- Automatisk forslag til neste sjekk, ca. eitt år fram i tid.
|
||||||
- [x] Automatisk forslag til neste sjekk, ca. eitt år fram i tid.
|
- Rapporteksport i CSV-format.
|
||||||
- [x] Rapporteksport i CSV-format.
|
- Lokal SQLite-database.
|
||||||
- [x] Lokal SQLite-database.
|
|
||||||
- [ ] Persistent lagring på StartOS.
|
- [ ] Persistent lagring på StartOS.
|
||||||
- [ ] StartOS health check.
|
- [ ] StartOS health check.
|
||||||
- [ ] StartOS backup og restore.
|
- [ ] StartOS backup og restore.
|
||||||
|
|
||||||
## Dette skal ikkje vere med i første versjon
|
**Dette skal ikkje vere med i første versjon**
|
||||||
|
|
||||||
- [ ] Ingen AI-integrasjon i appen.
|
Ingen AI-integrasjon, 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, og inga støtte for fleire multisig-oppsett i MVP.
|
||||||
- [ ] 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, ikke ei oppgåveliste. Punkta blir difor ikkje kryssa av, men skal stadfestast på nytt før release.
|
**Merk:** dette er eit varig forbod, ikkje ei oppgåveliste. Det skal stadfestast på nytt før release.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 2. Viktige reglar for appen
|
# 2. Viktige reglar for appen
|
||||||
|
|
||||||
- [x] Appen skal aldri spørje etter seed phrase, private keys, PIN, passord eller wallet-hemmelegheiter.
|
- Appen skal aldri spørje etter seed phrase, private keys, PIN, passord eller wallet-hemmelegheiter, og aldri lagre slike.
|
||||||
- [x] Appen skal aldri lagre slike hemmelegheiter, og ikkje lagre kontaktinnhald.
|
- Kontaktinformasjon til nøkkelhaldarar skal ikkje lagrast; berre om kontaktinfo er stadfesta.
|
||||||
- [x] Kontaktinformasjon til nøkkelhaldarar skal ikkje lagrast; berre om kontaktinfo er verifisert.
|
- Appen skal ikkje late som han sjølv har utført ein hardware-test. Brukaren registrerer resultatet av testen.
|
||||||
- [x] 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.
|
||||||
- [x] Appen skal vere lokal og enkel.
|
|
||||||
- [x] Dersom noko ikkje er nødvendig for den årlege health check-en, skal det ikkje byggjast i MVP.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 3. Nøkkeloppsettet appen er bygd for
|
# 3. Nøkkeloppsettet appen er bygd for
|
||||||
|
|
||||||
Appen er bygd for eitt 2-av-3 multisig-oppsett. Tabellen under viser standardoppsettet, med ein døme-adressesti:
|
Appen er bygd for eitt 2-av-3 multisig-oppsett med tre nøkkelplassar. Kvar nøkkel blir konfigurert éin gong ved første oppstart: namn, type (`hardware`/`cloud`) og adressesti.
|
||||||
|
|
||||||
| Nøkkel | Type | Einheit | Adressesti (døme) |
|
- Namnet brukaren skriv, er produktetiketten overalt: skjema, varsel, historikk og CSV-eksport. Nøkkelnummeret blir vist saman med namnet der det trengst, t.d. `Key 1: ColdCard`.
|
||||||
|
- Nøkkeltypen styrer kontrollane, aldri nøkkelnummeret.
|
||||||
|
- `type` og `address_path` er identiteten til nøkkelen og er låste etter oppsettet. Namnet kan endrast i innstillingane.
|
||||||
|
- [ ] Ikkje bygg generell støtte for mange oppsett enno (fleire enn tre nøklar, eller andre tersklar enn 2-av-3).
|
||||||
|
|
||||||
|
Standardoppsettet appen vart bygd for, med døme-adressestiar:
|
||||||
|
|
||||||
|
| Nøkkel | Type | Eining | Adressesti (døme) |
|
||||||
|---|---|---|---|
|
|---|---|---|---|
|
||||||
| 1 | Hardware | SeedSigner | m/48'/0'/0'/2' |
|
| 1 | Hardware | SeedSigner | m/48'/0'/0'/2' |
|
||||||
| 2 | Hardware | Blockstream Jade | m/48'/1'/0'/2' |
|
| 2 | Hardware | Blockstream Jade | m/48'/1'/0'/2' |
|
||||||
| 3 | Cloud | Nunchuk | m/48'/2'/0'/2' |
|
| 3 | Cloud | Nunchuk | m/48'/2'/0'/2' |
|
||||||
|
|
||||||
- [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.
|
|
||||||
- [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, og §26.2 gjer han unik per nøkkel. Tabellen over viser standardoppsettet appen vart bygd for.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 4. Datamodell
|
# 4. Datamodell
|
||||||
|
|
||||||
SQLite med så få tabellar som mogleg. Kvar tabell har éi rad per kolonne her; kolonnar merkte `*` er legacy-kolonnar som berre finst for gamle rader og aldri blir skrivne på nytt.
|
SQLite, med så få tabellar som mogleg. Kvar tabell har éi rad per kolonne her; kolonnar merkte `*` er legacy-kolonnar som berre finst for gamle rader og aldri blir skrivne på nytt.
|
||||||
|
|
||||||
**`keys`** — dei tre nøkkelplassane.
|
**`keys`** — dei tre nøkkelplassane.
|
||||||
`id`, `key_number` (1–3), `name`, `type` (`hardware`/`cloud`), `address_path` (§25.1), `created_at`.
|
`id`, `key_number` (1–3), `name`, `type` (`hardware`/`cloud`), `address_path`, `created_at`.
|
||||||
|
|
||||||
**`health_checks`** — éi rad per innsending, som gjeld éin vald nøkkel (§19).
|
**`health_checks`** — éi rad per innsending, som gjeld éin vald nøkkel.
|
||||||
`id`, `checked_at`, `next_check_due`, `wallet_software`, `software_version`, `software_compatibility_status`, `sparrow_version*`, `nunchuk_version*`, `software_comments`, `contact_info_verified`, `comments`.
|
`id`, `checked_at`, `next_check_due`, `wallet_software`, `software_version`, `software_compatibility_status`, `software_comments`, `sparrow_version*`, `nunchuk_version*`, `contact_info_verified`, `comments`.
|
||||||
|
|
||||||
**`key_checks`** — eitt record for den valde nøkkelen i kvar innsending.
|
**`key_checks`** — eitt record for den valde nøkkelen i kvar innsending.
|
||||||
`id`, `health_check_id`, `key_id`, `available`, `hardware_works`, `firmware_version`, `seed_backup_verified`, `address_path_verified`, `address_path`, `comments`.
|
`id`, `health_check_id`, `key_id`, `available`, `hardware_works`, `firmware_version`, `seed_backup_verified`, `address_path_verified`, `address_path`, `comments`.
|
||||||
@@ -105,50 +90,42 @@ SQLite med så få tabellar som mogleg. Kvar tabell har éi rad per kolonne her;
|
|||||||
**`ai_security_checks`** — KI-sikkerheitsstatus per leverandør.
|
**`ai_security_checks`** — KI-sikkerheitsstatus per leverandør.
|
||||||
`id`, `health_check_id`, `provider`, `status`, `comments`.
|
`id`, `health_check_id`, `provider`, `status`, `comments`.
|
||||||
|
|
||||||
**`wallet_software`** — lista brukaren vedlikeheld i innstillingane (§25.4).
|
**`wallet_software`** — lista brukaren vedlikeheld i innstillingane.
|
||||||
`id`, `name`, `created_at`.
|
`id`, `name`, `created_at`.
|
||||||
|
|
||||||
**`alert_acknowledgements`** — kvitterte varsel (§25.3, §26.4).
|
**`alert_acknowledgements`** — kvitterte varsel.
|
||||||
`id`, `code`, `source`, `check_id`, `reason`, `acknowledged_at`.
|
`id`, `code`, `source`, `key_id` (§27), `check_id`, `reason`, `acknowledged_at`.
|
||||||
|
|
||||||
Reglar:
|
Reglar:
|
||||||
|
|
||||||
- [x] `hardware_works`, `firmware_version` og `seed_backup_verified` er berre relevante for hardware-nøklar.
|
- `hardware_works`, `firmware_version` og `seed_backup_verified` gjeld berre hardware-nøklar.
|
||||||
- [x] `seed_backup_verified` og `address_path_verified` har berre verdiane `OK` eller `PROBLEM`.
|
- `seed_backup_verified` og `address_path_verified` har berre verdiane `OK` eller `PROBLEM`.
|
||||||
- [x] `address_path` lagrar adressestien for den kontrollen.
|
- `address_path` lagrar adressestien for den kontrollen.
|
||||||
- [x] Når `available` er Nei, blir dei andre nøkkelfelta tømde, medan nøkkelnotatet blir behalde.
|
- Når `available` er Nei, blir dei andre nøkkelfelta tømde, medan nøkkelnotatet blir behalde.
|
||||||
- [x] `seed_backup_status`, `address_verified` og `derivation_height` er fjerna (§19).
|
- Når `available` er Nei, blir `wallet_software` og `ai_security_checks` ikkje registrerte i det heile.
|
||||||
- [x] Når `available` er Nei, blir `wallet_software` og `ai_security_checks` ikkje registrerte i det heile (§22).
|
- `type` blir lagra éin gong ved første oppstart og er låst etterpå.
|
||||||
- [x] `type` i `keys` blir lagra éin gong ved første oppstart og er låst etterpå (§23.2).
|
- `provider` lagrar det konfigurerte nøkkelnamnet og den valde programvara, ikkje faste produktnamn.
|
||||||
- [x] `provider` lagrar det konfigurerte nøkkelnamnet og den valde programvara, ikkje faste produktnamn (§23.3).
|
- `contact_info_verified` er fri tekst med to verdiar, og har ingen «not assessed»-verdi.
|
||||||
- [x] `contact_info_verified` er fri tekst; dei faste listene er fjerna (§23.1, §23.3).
|
- `hardware_works` er obligatorisk for ein tilgjengeleg hardware-nøkkel.
|
||||||
- [x] `device`-kolonnen er fjerna; det konfigurerte namnet er den einaste produktetikketten (§23.2).
|
- `name` kan endrast i innstillingane; `type` og `address_path` er identiteten til nøkkelen.
|
||||||
- [x] `hardware_works` er obligatorisk (`0` eller `1`) for ein tilgjengeleg hardware-nøkkel (§24.1).
|
- `address_path_verified` blir sett av serveren ut frå ei samanlikning med `keys.address_path`, og blir ikkje sendt inn av brukaren.
|
||||||
- [x] `contact_info_verified` er obligatorisk og har ingen «not assessed»-verdi (§24.1).
|
- `wallet_software` i `health_checks` held fram som fri tekst, slik at eldre rader og fjerna listeelement held fram å visast rett.
|
||||||
- [x] `tool_checks`-tabellen er fjerna (§24.2, §24.4).
|
- `address_path` må vere unik på tvers av dei tre nøklane: i oppsettet, i innstillingane og ved rotering.
|
||||||
- [x] `name` i `keys` kan endrast i innstillingane, medan `type` og `address_path` er identiteten til nøkkelen (§25.1, §25.2).
|
- `reason` i `alert_acknowledgements` lagrar namnet på handlinga som lukka varselet, ikkje ein fri tekst.
|
||||||
- [x] `cloud_health_status` og `cloud_provider_operational` er fjerna. Ein cloud-nøkkel registrerer berre `available` (§25.3, §25.6).
|
- `tool_checks` finst ikkje. `device`, `seed_backup_status`, `address_verified`, `derivation_height`, `cloud_health_status` og `cloud_provider_operational` finst ikkje.
|
||||||
- [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).
|
|
||||||
- [x] `address_path` må vere unik på tvers av dei tre nøklane, både i oppsettet, i innstillingane og ved rotering (§26.2).
|
|
||||||
- [x] `reason` i `alert_acknowledgements` lagrar namnet på handlinga som lukka varselet, ikkje ein fri tekst (§26.4).
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 5. Statusverdiar
|
# 5. Statusverdiar
|
||||||
|
|
||||||
- [x] Generelle kontrollar brukar `OK` eller `PROBLEM`. `NOT_ASSESSED` finst berre som den utleidde verdien for `software_compatibility_status` når nøkkelen er utilgjengeleg, og ingen andre felt tilbyr eller godtar han (§24.1).
|
- Generelle kontrollar brukar `OK` eller `PROBLEM`. `NOT_ASSESSED` finst berre som den utleidde verdien for `software_compatibility_status` når nøkkelen ikkje kunne kontrollerast; ingen andre felt tilbyr eller godtar han.
|
||||||
- [x] `seed_backup_verified` og `address_path_verified` brukar berre `OK` eller `PROBLEM`.
|
- `seed_backup_verified` og `address_path_verified` brukar berre `OK` eller `PROBLEM`.
|
||||||
- [x] KI-sikkerheitsstatus brukar nøyaktig `SECURE`, `PATCHED`, `VULNERABLE` og `COMPROMISED`. Ingen andre.
|
- KI-sikkerheitsstatus brukar nøyaktig `SECURE`, `PATCHED`, `VULNERABLE` og `COMPROMISED`.
|
||||||
- [x] Same statuslogikk i database, validering, varsel, CSV-eksport og UI.
|
- Kontaktstadfesting brukar `Confirmed current` eller `Needs external update`.
|
||||||
- [x] Ikkje bland saman «ikkje vurdert» og eit faktisk negativt resultat.
|
- `Hardware works` (`Yes`/`No`) og `Software compatibility` (`OK`/`PROBLEM`) krev eit aktivt val for ein tilgjengeleg nøkkel.
|
||||||
- [x] Kontaktstadfesting brukar `Confirmed current` eller `Needs external update` i staden for Ja/Nei (§23.1).
|
- `address_path_verified` er utleidd av serveren og er ikkje eit val i skjemaet.
|
||||||
- [x] `Software compatibility` krev eit aktivt val (`OK` / `PROBLEM`) for ein hardware-nøkkel (§23.1).
|
- Same statuslogikk i database, validering, varsel, CSV-eksport og UI.
|
||||||
- [x] `Hardware works` krev eit aktivt val (`Yes` / `No`) for ein tilgjengeleg hardware-nøkkel (§24.1).
|
- Ikkje bland saman «ikkje vurdert» og eit faktisk negativt resultat.
|
||||||
- [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).
|
|
||||||
- [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).
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -158,192 +135,151 @@ Stega følgjer seksjonane i skjemaet.
|
|||||||
|
|
||||||
## Steg 1 — Schedule (01 / Schedule)
|
## Steg 1 — Schedule (01 / Schedule)
|
||||||
|
|
||||||
- [x] Brukaren trykkjer `Start årleg health check`.
|
- Brukaren trykkjer `Start årleg health check`, og dagens dato blir føreslått automatisk.
|
||||||
- [x] 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.
|
||||||
- [x] Neste sjekkdato blir rekna ut på serveren som eitt kalenderår etter sjekkdatoen, og kan ikkje redigerast i skjemaet.
|
|
||||||
|
|
||||||
## Steg 2 — Key (02 / Key)
|
## Steg 2 — Key (02 / Key)
|
||||||
|
|
||||||
- [x] Brukaren vel kva nøkkel innsendinga gjeld (§19). Ei innsending gjeld éin nøkkel.
|
- Brukaren vel kva nøkkel innsendinga gjeld. Ei innsending gjeld éin nøkkel.
|
||||||
- [x] `Availability` er obligatorisk: Ja eller Nei (§22).
|
- `Availability` er obligatorisk: Ja eller Nei.
|
||||||
- [x] Ein nøkkel med eit ope varsel kan ikkje veljast, og skjemaet seier kva varsel som står i vegen (§26.1).
|
- Ein nøkkel med eit ope varsel kan ikkje veljast, og skjemaet seier kva varsel som står i vegen.
|
||||||
|
- **Hardware-nøkkel:** `Hardware works` er obligatorisk (`Yes`/`No`), firmware-versjon blir registrert, og seed-backup intakt og stemmande med hardware gir `seed_backup_verified` (`OK`/`PROBLEM`). Kommentar ved behov.
|
||||||
### Hardware-nøkkel
|
- **Cloud-nøkkel:** berre `Availability` blir spurd om. Kommentar ved behov.
|
||||||
|
- **Adressesti (alle nøklar):** brukaren registrerer berre `Address path`, førehandsutfylt med nøkkelen sin lagra sti. Serveren samanliknar den innsende stien med `keys.address_path`: lik → `OK`, ulik → `PROBLEM`.
|
||||||
- [x] Tilgjengeleg / ikkje tilgjengeleg.
|
- Når nøkkelen ikkje er tilgjengeleg, blir resten skjult og ikkje kravd.
|
||||||
- [x] `Hardware works` er obligatorisk: Ja eller Nei (§24.1).
|
- Stemmer ikkje stien, viser nettlesaren eit påminningsvarsel før innsending, og kontrollen blir lagra som ein nøkkel som ikkje kunne kontrollerast.
|
||||||
- [x] Registrer firmware-versjon.
|
|
||||||
- [x] Seed-backup intakt og stemmer med hardware → `seed_backup_verified` (`OK` / `PROBLEM`).
|
|
||||||
- [x] Kommentar ved behov.
|
|
||||||
- [x] Når nøkkelen ikkje er tilgjengeleg, blir resten skjult og ikkje kravd (§22).
|
|
||||||
|
|
||||||
### Cloud-nøkkel
|
|
||||||
|
|
||||||
- [x] Berre `Availability` blir spurt om.
|
|
||||||
- [x] Kommentar ved behov.
|
|
||||||
|
|
||||||
### Adressesti (alle nøklar)
|
|
||||||
|
|
||||||
- [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)
|
## Steg 3 — Compatibility (03 / Compatibility)
|
||||||
|
|
||||||
- [x] Brukaren vel éi wallet-programvare: `Sparrow Wallet` eller namnet på ein konfigurert cloud-nøkkel. Ein cloud-nøkkel er låst til sitt eige namn (§23.3).
|
- Brukaren vel éi wallet-programvare: `Sparrow Wallet`, eit namn frå innstillingane, eller namnet på ein konfigurert cloud-nøkkel. Ein cloud-nøkkel er låst til sitt eige namn.
|
||||||
- [x] Registrer versjonen til den valde programvara i `software_version`.
|
- `Software version` blir registrert for alle nøklar, òg ein cloud-nøkkel.
|
||||||
- [x] Registrer `OK` eller `PROBLEM`, med kommentar ved problem.
|
- `OK` eller `PROBLEM`, med kommentar ved problem.
|
||||||
- [x] For ein cloud-nøkkel er `Wallet software` og `Compatibility status` skjulte og utleidde.
|
- 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).
|
- Når nøkkelen ikkje er tilgjengeleg, er feltet skjult og valfritt.
|
||||||
- [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)
|
## Steg 4 — External research (04 / External research)
|
||||||
|
|
||||||
- [x] Leverandørar per innsending: den valde nøkkelen (ved namn) og den valde programvara (§23.3).
|
- Leverandørar per innsending: den valde nøkkelen (ved namn) og den valde programvara.
|
||||||
- [x] Registrer status (`SECURE` / `PATCHED` / `VULNERABLE` / `COMPROMISED`) og ein kort kommentar.
|
- Registrer status (`SECURE` / `PATCHED` / `VULNERABLE` / `COMPROMISED`) og ein kort kommentar.
|
||||||
- [x] Berre den valde nøkkelen og den valde programvara blir registrerte; vidareføringa av ein tredje leverandør (§20) er fjerna (§23.3).
|
- Berre den valde nøkkelen og den valde programvara blir registrerte. Appen kontaktar ikkje KI sjølv i MVP.
|
||||||
- [x] Når nøkkelen ikkje er tilgjengeleg, blir ingen statusar registrerte (§22).
|
- Når nøkkelen ikkje er tilgjengeleg, blir ingen statusar registrerte.
|
||||||
- [x] Appen kontaktar ikkje KI sjølv i MVP.
|
|
||||||
|
|
||||||
## Steg 5 — Contact confirmation (05 / Contact confirmation)
|
## Steg 5 — Contact confirmation (05 / Contact confirmation)
|
||||||
|
|
||||||
- [x] Stadfest at kontaktinformasjonen til nøkkelhaldaren til den valde nøkkelen er gyldig, og lagre berre statusen (§23.1).
|
- Stadfest at kontaktinformasjonen til nøkkelhaldaren til den valde nøkkelen er gyldig: `Confirmed current` eller `Needs external update`. Stadfestinga er obligatorisk, òg når nøkkelen ikkje er tilgjengeleg.
|
||||||
- [x] Stadfestinga er obligatorisk: `Confirmed current` eller `Needs external update` (§24.1). Ho blir spurt om også når nøkkelen er utilgjengeleg.
|
- Berre statusen blir lagra. Ikkje lagre namn, telefonnummer, e-post eller anna kontaktinnhald.
|
||||||
- [x] Ikkje lagre namn, telefonnummer, e-post eller anna kontaktinnhald.
|
|
||||||
|
|
||||||
## Steg 6 — Notes (06 / Notes)
|
## Steg 6 — Notes (06 / Notes)
|
||||||
|
|
||||||
- [x] Eitt overordna kommentarfelt for observasjonar, og eigne kommentarar per nøkkel der det trengst.
|
- Eitt overordna kommentarfelt for observasjonar, og eigne kommentarar per nøkkel der det trengst.
|
||||||
|
|
||||||
## Oppsummering før lagring (Review-panelet)
|
## Oppsummering før lagring (Review-panelet)
|
||||||
|
|
||||||
- [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).
|
- 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.
|
||||||
- [x] Brukaren må trykkje `Lagre health check` for å lagre kontrollen.
|
- Brukaren må trykkje `Lagre health check` for å lagre kontrollen.
|
||||||
- [x] Når adressestien ikkje stemmer, blir valet om å lagre likevel tydeleg merkt i oppsummeringa (§25.1).
|
- Når adressestien ikkje stemmer, blir valet om å lagre likevel tydeleg merkt i oppsummeringa.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 7. Varsel og oppfølging
|
# 7. Varsel og oppfølging
|
||||||
|
|
||||||
Alle lagra kontrollar blir lesne (§21). Kva som kan lukke eit varsel, står i §25.3 og §26.4.
|
Alle lagra kontrollar blir lesne, ikkje berre den nyaste. Like varsel (same `code` og `source`) blir slegne saman, og berre den nyaste blir vist. Kritiske varsel blir lista før informative, og nyaste kontroll først innanfor kvar alvor. Eit kvittert varsel held seg skjult til ein nyare kontroll for same `code` og `source` utløyser det igjen.
|
||||||
|
|
||||||
- [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.
|
**Eit ope varsel som høyrer til ein nøkkel sperrar den nøkkelen** til varselet er lukka. Serveren handhevar regelen, så eit direkte API-kall ikkje kan omgå han. Sperringa gjeld berre den nøkkelen som har varselet.
|
||||||
- [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.
|
| `code` | Alvor | Kjelde | Utløyst av | Slik blir det lukka |
|
||||||
- [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.
|
| `key_unavailable` | critical | nøkkel | `available` = Nei | Rotering |
|
||||||
- [x] KI-status `COMPROMISED` → nøkkeltapsprosedyren må følgjast.
|
| `address_path_mismatch` | critical | nøkkel | Adressestien stemmer ikkje med den lagra | Rotering |
|
||||||
- [x] Kontaktinfo ikkje stadfesta → kontaktinformasjonen må oppdaterast i den eksterne dokumentasjonen.
|
| `hardware_failure` | critical | nøkkel | `Hardware works` = No | Rotering, eller at hardware-walleten blir bytt med same seed |
|
||||||
- [x] Kritiske varsel blir lista før informative. Like varsel (same `code` og `source`) blir slegne saman, og berre den nyaste blir vist (§21).
|
| `seed_backup_problem` | critical | nøkkel | Seed-backup `PROBLEM` | Rotering |
|
||||||
- [x] Appen utfører aldri desse tiltaka sjølv.
|
| `software_incompatible` | critical | programvare | `software_compatibility_status` = `PROBLEM` | Fjerning av den feilande programvara i innstillingane, eller (§27) at hardware-walleten blir bytt når programvara er namnet på ein cloud-nøkkel |
|
||||||
- [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).
|
| `security_vulnerable` | critical | nøkkel | KI-status `VULNERABLE` | Rotering, eller lukking utan tiltak |
|
||||||
- [x] Varselet om cloud-helse er fjerna: det kunne ikkje utløysast frå skjemaet (§25.3).
|
| `security_vulnerable` | critical | programvare | KI-status `VULNERABLE` | Fjerning av programvara, eller lukking utan tiltak |
|
||||||
- [x] Varselet om feila adresseverifisering er erstatta av varselet om adressestifeil (§25.3).
|
| `security_compromised` | critical | nøkkel | KI-status `COMPROMISED` | Rotering er påkravd |
|
||||||
- [x] Eit kvittert varsel er skjult til ein nyare kontroll for same `code` og `source` utløyser det igjen (§25.3).
|
| `security_compromised` | critical | programvare | KI-status `COMPROMISED` | Fjerning av programvara |
|
||||||
- [x] Ein nøkkel med eit ope varsel kan ikkje få ein ny kontroll før varselet er lukka (§26.1).
|
| `contact_info_unconfirmed` | info | kontaktinfo | Kontaktstadfesting `Needs external update` | Lukking, etter at kontaktinformasjonen er oppdatert eksternt |
|
||||||
- [x] Kvar varselkode har ei fast sett av handlingar, kvar med sin eigen knappetekst og eige stadfestingssteg. Den generiske kvitteringa er fjerna (§26.4).
|
|
||||||
- [x] `hardware_failure` har `rotate` og `replace_hardware`, og ingen generisk kvittering (§26.4).
|
- Kvar varselkode har eit fast sett av handlingar: `rotate`, `replace_hardware`, `remove_software`, `ignore`, `contact_updated`. Ei handling som ikkje høyrer til varselet, blir avvist.
|
||||||
- [x] `software_incompatible` blir lukka ved at den feilande programvara blir fjerna frå innstillingane (§26.4, §26.7).
|
- `rotate` blir utført i innstillingane, sidan han krev ein ny adressesti. Dei andre handlingane blir utførte der varselet står, kvar med sin eigen knappetekst og sitt eige stadfestingssteg.
|
||||||
- [x] `security_compromised` har ingen `ignore`, korkje med nøkkel eller programvare som kjelde (§26.4).
|
- Kjelda til eit KI-varsel er leverandøren. Er han nøkkelen sitt eige konfigurerte namn, er nøkkelen kjelda og ei rotering lukkar varselet. Elles er leverandøren programvara nøkkelen køyrer med, og varselet blir lukka ved å fjerne ho frå innstillingane.
|
||||||
|
- Kvar handling krev ei stadfesting frå brukaren, og appen utfører aldri tiltaket sjølv. Han kontaktar heller aldri leverandørar eller KI-tenester.
|
||||||
|
- Eit varsel utan handling er ein feil i koden, ikkje ein tilstand brukaren kan hamne i.
|
||||||
|
- Eit varsel om nøkkel utilgjengeleg, adressestifeil eller seed-backup gjeld berre den nøkkelen, og resten av nøkkelfelta kan ikkje registrerast.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 8. Dashboard
|
# 8. Dashboard
|
||||||
|
|
||||||
- [x] Vis 2-av-3-oppsettet og status for kvar av dei tre nøklane.
|
- Vis 2-av-3-oppsettet og status for kvar av dei tre nøklane, med siste sjekk og neste forfall per nøkkel.
|
||||||
- [x] Vis siste sjekk og neste forfall per nøkkel — kvar nøkkel har sitt eige intervall (§19).
|
- Oversiktskort «Next check» (tidlegaste forfall, med kva nøkkel det gjeld) og «Attention» (kor mange nøklar som har passert fristen). Om ein dato er passert, blir avgjort i nettlesaren.
|
||||||
- [x] Oversiktskort «Next check» (tidlegaste forfall, med kva nøkkel det gjeld) og «Attention» (kor mange nøklar som har passert fristen). Om ein dato er passert blir avgjort i nettlesaren.
|
- Vis alle aktive varsel, med kva registrering kvart varsel kjem frå, og handlinga som lukkar det.
|
||||||
- [x] Vis alle aktive varsel, med kva registrering kvart varsel kjem frå (§21).
|
- Knapp `Start årleg health check`, lenke `Historikk`, lenke `Download CSV` og lenke til innstillingane.
|
||||||
- [x] Knapp `Start årleg health check`, lenke `Historikk` og lenke `Download CSV`.
|
- Vis oppsettsteget i staden for dashboardet når nøkkeloppsettet manglar.
|
||||||
- [x] Vis oppsettsteget i staden for dashboardet når nøkkeloppsettet manglar (§23.2).
|
- Eit nøkkelkort viser ei tydeleg melding når nøkkelen har eit ope varsel, i staden for den vanlege statusen sin: kor mange varsel som står ope, at nøkkelen ikkje kan kontrollerast før dei er lukka, kva handling som lukkar det første, og ei lenkje til varsellista.
|
||||||
- [x] Vis handlinga som høyrer til kvart varsel, slik at brukaren kan lukke det (§25.3).
|
|
||||||
- [x] Lenke til innstillingane (§25.4).
|
|
||||||
- [x] Eit nøkkelkort viser ei tydeleg melding når nøkkelen har eit ope varsel, i staden for den vanlege statusen sin, og seier kor mange varsel som står ope (§26.5).
|
|
||||||
- [x] Nøkkelkortet peikar på handlinga som lukkar varselet, eller lenker til varsellista (§26.5).
|
|
||||||
- [x] Varselet om programvare-inkompatibilitet lenker til innstillingane, der brukaren legg til ny programvare eller fjernar den feilande (§26.7).
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 9. Historikk
|
# 9. Historikk
|
||||||
|
|
||||||
- [x] Vis alle gjennomførte health checks kronologisk, nyaste først, med kva nøkkel kvar innsending gjeld (§19).
|
- Vis alle gjennomførte health checks kronologisk, nyaste først, med kva nøkkel kvar innsending gjeld.
|
||||||
- [x] Opne ein health check i read-only-visning med dato, neste sjekk, status per nøkkel, programvare og versjon, KI-status og kommentarar.
|
- 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.
|
- Gamle health checks blir aldri overskrivne.
|
||||||
- [x] Vis `Address path verified` som den utleidde verdien han er, og ikkje som eit brukarval (§25.1).
|
- Vis `Address path verified` som den utleidde verdien han er, og ikkje som eit brukarval.
|
||||||
- [x] Vis namnet nøkkelen har no, sidan namnet kan endrast i innstillingane (§25.2).
|
- Vis namnet nøkkelen har no, sidan namnet kan endrast i innstillingane.
|
||||||
|
- [ ] (§27) Vis kva varsel som vart lukka på kontrollen, med kva handling og kva dato.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 10. Rapporteksport
|
# 10. Rapporteksport
|
||||||
|
|
||||||
- [x] `GET /api/export` gjev rein CSV (UTF-8, komma, CRLF, header). Ingen XLSX, og appen lovar ikkje Excel-kompatibilitet.
|
- `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.
|
- Éi rad per nøkkelsjekk. Kolonnen `Check id` knyter saman rader frå same innsending.
|
||||||
- [x] Inneheld dato, neste sjekk, nøkkelstatus, hardware/firmware, seed-resultat, adresse-sti, programvare og kompatibilitet, KI-status, kontaktstadfesting og kommentarar.
|
- 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`.
|
- 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).
|
- Statusverdiane blir skrivne slik dei er lagra. `0`/`1` blir skrivne som `No`/`Yes`.
|
||||||
- [x] Nøkkelnamnet og nøkkeltypen kjem frå oppsettet (§23.3).
|
- Nøkkelnamnet og nøkkeltypen kjem frå oppsettet, og namnet er namnet nøkkelen har no.
|
||||||
- [x] Kolonnen for cloud-leverandøren er fjerna saman med feltet (§25.6).
|
- [ ] (§27) Ny kolonne heilt til slutt med varsla som vart lukka på kontrollen, med handling og dato.
|
||||||
- [x] Nøkkelnamnet i eksporten er namnet nøkkelen har no (§25.2).
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 11. Backend
|
# 11. Backend
|
||||||
|
|
||||||
- [x] SQLite med initialisering og migrering. Skjemaet er no versjon 10 (§21, §23.1, §23.4, §24.4, §25.6). §26 legg ikkje til kolonnar eller tabellar.
|
- SQLite med initialisering og migrering. Skjemaet er versjon 10, og blir versjon 11 i §27.
|
||||||
- [x] Lagring av nøklar, health checks, historikk og rapporteksport.
|
- Lagring av nøklar, health checks, historikk og rapporteksport.
|
||||||
- [x] Varsellogikken (§7).
|
- Varsellogikken (§7).
|
||||||
- [x] Health endpoint.
|
- Health endpoint.
|
||||||
|
- Valider input på serveren, og bruk parameteriserte SQL-spørringar.
|
||||||
|
|
||||||
Minimumsendepunkt:
|
Minimumsendepunkt: `GET /health`, `GET /api/keys`, `GET /api/health-checks`, `GET /api/health-checks/:id`, `POST /api/health-checks`, `GET /api/export`.
|
||||||
|
|
||||||
- [x] `GET /health`
|
|
||||||
- [x] `GET /api/keys`
|
|
||||||
- [x] `GET /api/health-checks`
|
|
||||||
- [x] `GET /api/health-checks/:id`
|
|
||||||
- [x] `POST /api/health-checks`
|
|
||||||
- [x] `GET /api/export`
|
|
||||||
|
|
||||||
**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.
|
**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).
|
- `POST /api/health-checks` krev éin konfigurert nøkkel, `available` og gyldige, relevante resultat, og avviser manglande eller dupliserte registreringar.
|
||||||
- [x] `POST /api/health-checks` krev ikkje programvare eller KI-status når nøkkelen er utilgjengeleg (§22).
|
- `POST /api/health-checks` krev ikkje programvare eller KI-status når nøkkelen ikkje kunne kontrollerast, og avviser slike resultat med `400`.
|
||||||
- [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/health-checks` avviser ein nøkkel som har eit ope varsel, med `409`, og regelen blir handheva før resten av valideringa.
|
||||||
- [x] `POST /api/setup` krev òg ein adressesti per nøkkel (§25.1).
|
- `POST /api/setup` lagrar nøkkeloppsettet éin gong med namn, type og adressesti, og avviser eit nytt oppsett med `409`.
|
||||||
- [x] `GET /api/settings` gjev nøklane med adressestien deira og lista over wallet-programvare (§25.4).
|
- `POST /api/setup`, `POST /api/settings/keys` og `POST /api/keys/<id>/rotate` avviser ein adressesti som ein annan nøkkel alt har (`400` i oppsettet og roteringa, `409` i innstillingane).
|
||||||
- [x] `POST /api/settings/keys` lagrar eit nytt namn, og ein adressesti så lenge nøkkelen ikkje har nokon lagra kontroll (§25.2).
|
- `GET /api/settings` gjev nøklane med adressestien deira og lista over wallet-programvare.
|
||||||
- [x] `POST /api/settings/wallet-software` lagrar heile lista (§25.4).
|
- `POST /api/settings/keys` lagrar eit nytt namn, og ein adressesti så lenge nøkkelen ikkje har nokon lagra kontroll.
|
||||||
- [x] `POST /api/keys/<id>/rotate` roterer ein nøkkel og kvitterer ut varsla hans (§25.2).
|
- `POST /api/settings/wallet-software` lagrar heile lista, og lukkar varsla til ei programvare som blir fjerna.
|
||||||
- [x] `POST /api/alerts/acknowledge` kvitterer ut eit varsel med `code`, `source` og ein årsak (§25.3).
|
- `POST /api/keys/<id>/rotate` roterer ein nøkkel med ein ny, unik adressesti, og kvitterer ut varsla hans.
|
||||||
- [x] `POST /api/health-checks` samanliknar adressestien og krev eit minimalt innhald når han ikkje stemmer, elles `400` (§25.1).
|
- `POST /api/alerts/acknowledge` kvitterer ut eit varsel med `code`, `source` og handlinga som lukkar det.
|
||||||
- [x] `POST /api/health-checks` avviser ein nøkkel som har eit ope varsel, med `409` (§26.1).
|
- Feilkodar elles: ugyldig payload `400`, ukjend nøkkel eller varsel `404`, låst eller duplikat adressesti `409`, øydelagd database `500`.
|
||||||
- [x] `POST /api/setup`, `POST /api/settings/keys` og `POST /api/keys/<id>/rotate` avviser ein adressesti som ein annan nøkkel alt har (§26.2).
|
|
||||||
- [x] `POST /api/keys/<id>/rotate` tek ein ny `address_path` i staden for `address_path_unchanged`, og avviser den gamle stien og ein tom verdi (§26.3).
|
|
||||||
- [x] `POST /api/alerts/acknowledge` tek handlinga (`rotate`, `replace_hardware`, `remove_software`, `ignore`, `contact_updated`) i staden for ein fri årsak, og avviser ei handling som ikkje høyrer til varselet (§26.4).
|
|
||||||
- [x] Varselet oppgjev kva programvare som fekk resultatet, slik at fjerninga i innstillingane peikar på rett element (§26.7).
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 12. Frontend
|
# 12. Frontend
|
||||||
|
|
||||||
- [x] Enkel responsiv web-UI. Enkelheit går framfor grafisk kompleksitet.
|
- Enkel responsiv web-UI. Enkelheit går framfor grafisk kompleksitet.
|
||||||
- [x] Tydlege statusfelt, og faste val der statusen skal vere ein avgrensa verdi.
|
- Tydlege statusfelt, og faste val der statusen skal vere ein avgrensa verdi.
|
||||||
- [x] Vis problem tydeleg.
|
- Vis problem tydeleg, og vis kva som står att før ein health check kan lagrast.
|
||||||
- [x] Vis kva som står att før ein health check kan lagrast.
|
- Skjul felt som ikkje gjeld for vald nøkkel eller vald programvare, og skjul programvare og KI-status når nøkkelen ikkje kunne kontrollerast. Eit skjult `required`-felt blokkerer innsendinga, så flagget må alltid clearast når feltet blir skjult.
|
||||||
- [x] Skjul felt som ikkje gjeld for vald nøkkel eller vald programvare (§20, §21).
|
- Eige oppsettsteg for namn, type og adressesti ved første oppstart.
|
||||||
- [x] Skjul programvare og KI-status når nøkkelen er utilgjengeleg (§22).
|
- Skjemaet viser kva nøklar som er sperra av eit ope varsel, og kva handling som lukkar det.
|
||||||
- [x] Eige oppsettsteg for namn og type ved første oppstart (§23.2).
|
- Eit påminningsvarsel før innsending når adressestien ikkje stemmer.
|
||||||
- [x] Bygg `Wallet software`-vala frå oppsettet i staden for ei fast liste (§23.3).
|
- Innstillingsside med `01 / Keys`, `02 / Wallet software` og `03 / Key rotation`, bygd for fleire tema seinare.
|
||||||
- [x] Følg den nye seksjonsrekkjefølgja: 01 Schedule, 02 Key, 03 Compatibility, 04 External research, 05 Contact confirmation, 06 Notes (§24.3).
|
- Varselknappane har den teksten og det stadfestingssteget som høyrer til handlinga si, og varselet om programvare-inkompatibilitet peikar på innstillingane.
|
||||||
- [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).
|
|
||||||
- [x] Skjemaet viser kva nøklar som er sperra av eit ope varsel, og kva handling som lukkar det (§26.1).
|
|
||||||
- [x] Roteringsfeltet har eit eige tekstfelt for den nye adressestien, og namnefeltet er førehandsfylt med namnet nøkkelen har no (§26.3).
|
|
||||||
- [x] Avstanden mellom `warning-note` og `rotation-list` i `03 / Key rotation` blir auka, utan at fargar eller innhald blir endra (§26.6).
|
|
||||||
- [x] Varselknappane har den teksten og det stadfestingssteget som høyrer til handlinga si (§26.4).
|
|
||||||
- [x] Varselet om programvare-inkompatibilitet lenker til innstillingane, og den feilande programvara kan fjernast derfrå (§26.7).
|
|
||||||
- [ ] Sørg for at appen fungerer godt i vanleg StartOS-browser.
|
- [ ] Sørg for at appen fungerer godt i vanleg StartOS-browser.
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -372,15 +308,9 @@ StartOS 0.4.0
|
|||||||
- [ ] Bygg `.s9pk`.
|
- [ ] Bygg `.s9pk`.
|
||||||
- [ ] Verifiser at pakken kan installerast på StartOS 0.4.0.
|
- [ ] Verifiser at pakken kan installerast på StartOS 0.4.0.
|
||||||
|
|
||||||
Unngå:
|
Unngå: Postgres, Redis, ekstern backend, ekstern cloud-service for appdata, og ekstra container utan konkret behov.
|
||||||
|
|
||||||
- [ ] Ingen Postgres.
|
**Merk:** dette er eit varig forbod, ikkje ei oppgåveliste. Det skal stadfestast på nytt før release.
|
||||||
- [ ] Ingen Redis.
|
|
||||||
- [ ] Ingen ekstern backend.
|
|
||||||
- [ ] Ingen ekstern cloud-service for appdata.
|
|
||||||
- [ ] Ingen ekstra container utan konkret behov.
|
|
||||||
|
|
||||||
**Merk:** denne lista er eit varig forbod, ikke ei oppgåveliste. Punkta blir difor ikkje kryssa av, men skal stadfestast på nytt før release.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -389,21 +319,19 @@ Unngå:
|
|||||||
- [ ] SQLite-database skal liggje på persistent volum.
|
- [ ] SQLite-database skal liggje på persistent volum.
|
||||||
- [ ] Appdata skal overleve restart.
|
- [ ] Appdata skal overleve restart.
|
||||||
- [ ] Konfigurer StartOS backup av persistent data.
|
- [ ] Konfigurer StartOS backup av persistent data.
|
||||||
- [ ] Test backup.
|
- [ ] Test backup og test restore.
|
||||||
- [ ] Test restore.
|
|
||||||
- [ ] Verifiser at gamle health checks finst etter restore.
|
- [ ] Verifiser at gamle health checks finst etter restore.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 15. Sikkerheit og personvern
|
# 15. Sikkerheit og personvern
|
||||||
|
|
||||||
- [x] Ingen seed phrase, private keys, wallet-passord eller sky-tokens i databasen.
|
- Ingen seed phrase, private keys, wallet-passord eller sky-tokens i databasen.
|
||||||
- [x] Ingen unødvendige personopplysningar. Kontaktinfo blir berre registrert som status (`Confirmed current` / `Needs external update`).
|
- Ingen unødvendige personopplysningar. Kontaktinfo blir berre registrert som status (`Confirmed current` / `Needs external update`).
|
||||||
- [x] Valider input på serveren.
|
- Valider input på serveren, og bruk parameteriserte SQL-spørringar.
|
||||||
- [x] Bruk parameteriserte SQL-spørringar.
|
- Ikkje implementer eigen kryptografi.
|
||||||
- [x] Ikkje implementer eigen kryptografi.
|
- Ikkje send data til eksterne tenester i MVP.
|
||||||
- [x] Ikkje send data til eksterne tenester i MVP.
|
- Adressestien er ein offentleg derivasjonssti og inneheld inga hemmelegheit.
|
||||||
- [x] Adressestien er ein offentleg derivasjonssti og inneheld inga hemmelegheit.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -411,48 +339,34 @@ Unngå:
|
|||||||
|
|
||||||
## Funksjonstest
|
## Funksjonstest
|
||||||
|
|
||||||
- [ ] Opprett dei tre nøklane.
|
- [ ] Opprett dei tre nøklane, start ein health check, fullfør alle kontrollpunkt, lagre han og vis han i historikken.
|
||||||
- [ ] Start health check.
|
- [ ] Start ein ny health check, og verifiser at den gamle kontrollen framleis finst.
|
||||||
- [ ] Fullfør alle kontrollpunkt.
|
|
||||||
- [ ] Lagre health check.
|
|
||||||
- [ ] Vis han i historikken.
|
|
||||||
- [ ] Start ny health check.
|
|
||||||
- [ ] Verifiser at gammal kontroll framleis finst.
|
|
||||||
|
|
||||||
## Problemtest
|
## Problemtest
|
||||||
|
|
||||||
- [ ] Test nøkkel utilgjengeleg.
|
- [ ] Test nøkkel utilgjengeleg, hardware-feil og seed-backup-feil.
|
||||||
- [ ] Test hardware-feil.
|
- [ ] Test adressestifeil, både påminninga før innsending og varselet etterpå.
|
||||||
- [ ] Test seed-backup-feil.
|
- [ ] Test programvare-inkompatibilitet, og at `Hardware works` og kontaktstadfestinga krev eit val.
|
||||||
- [ ] Test adressestifeil (mismatch), både påminninga før innsending og varselet etterpå (§25.1).
|
- [ ] Test KI-status `VULNERABLE` og `COMPROMISED`, og kontaktinfo `Needs external update`.
|
||||||
- [ ] Test programvare-inkompatibilitet.
|
- [ ] Test rotering av ein nøkkel, med og utan nytt namn, og at rotering krev ein ny adressesti.
|
||||||
- [ ] Test at `Hardware works` krev eit val.
|
- [ ] Test kvittering av eit varsel, og at eit nyare varsel kjem tilbake.
|
||||||
- [ ] Test at kontaktstadfesting krev eit val.
|
- [ ] Test at ein nøkkel med eit ope varsel ikkje kan få ein ny kontroll, og at nøkkelen blir ledig igjen når varselet er lukka.
|
||||||
- [ ] Test KI-status `VULNERABLE`.
|
- [ ] Test at to nøklar ikkje kan ha same adressesti, korkje i oppsettet, i innstillingane eller ved rotering.
|
||||||
- [ ] Test KI-status `COMPROMISED`.
|
- [ ] Test kvar varselhandling, og at eit varsel utan handlingar blir rekna som ein feil.
|
||||||
- [ ] Test kontaktinfo `Needs external update`.
|
- [ ] Test at eit nøkkelkort viser ei varselmelding når nøkkelen har eit ope varsel.
|
||||||
- [ ] Test rotering av ein nøkkel, med og utan nytt namn (§25.2).
|
- [ ] Test at fjerning av den feilande programvara lukkar `software_incompatible`.
|
||||||
- [ ] Test kvittering av eit varsel, og at eit nyare varsel kjem tilbake (§25.3).
|
- [ ] (§27) Test at eit lukka varsel viser seg i historikken og i CSV-en, med handling og dato.
|
||||||
- [ ] Test at ein nøkkel med eit ope varsel ikkje kan få ein ny kontroll, og at nøkkelen blir ledig igjen når varselet er lukka (§26.1).
|
- [ ] (§27) Test at eit kontaktvarsel gir `Needs action` og sperrar nøkkelen, og at nøkkelen blir ledig att ved `contact_updated`.
|
||||||
- [ ] Test at to nøklar ikkje kan ha same adressesti, korkje i oppsettet, i innstillingane eller ved rotering (§26.2).
|
- [ ] (§27) Test at `software_incompatible` med ei cloud-nøkkel-programvare gir `replace_hardware` på den kontrollerte nøkkelen, og at det same varselet frå innstillingslista held fram med `remove_software`.
|
||||||
- [ ] Test at rotering krev ein ny adressesti, og at den gamle blir avvist (§26.3).
|
|
||||||
- [ ] Test kvar varselhandling, og at eit varsel utan handlingar blir rekna som ein feil (§26.4).
|
|
||||||
- [ ] Test at eit nøkkelkort viser ei varselmelding når nøkkelen har eit ope varsel (§26.5).
|
|
||||||
- [ ] Test at fjerning av den feilande programvara lukkar `software_incompatible` (§26.7).
|
|
||||||
|
|
||||||
**Merk:** desse er dei manuelle nettlesartestane dine. Alle punkta i §26 er òg dekte av testsuiten, men dei står opne her til du har køyrt dei i nettlesaren.
|
**Merk:** dette er dei manuelle nettlesartestane dine. Alt som er implementert, er òg dekt av testsuiten, men punkta står opne til du har køyrt dei i nettlesaren.
|
||||||
|
|
||||||
## StartOS-test
|
## StartOS-test
|
||||||
|
|
||||||
- [ ] Installer `.s9pk` på StartOS 0.4.0.
|
- [ ] Installer `.s9pk` på StartOS 0.4.0, start servicen og opne web UI.
|
||||||
- [ ] Start service.
|
|
||||||
- [ ] Opne web UI.
|
|
||||||
- [ ] Utfør ein komplett test-check.
|
- [ ] Utfør ein komplett test-check.
|
||||||
- [ ] Restart service.
|
- [ ] Restart servicen, og verifiser at data framleis finst.
|
||||||
- [ ] Verifiser at data framleis finst.
|
- [ ] Ta backup, restore backup, og verifiser data etter restore.
|
||||||
- [ ] Ta backup.
|
|
||||||
- [ ] Restore backup.
|
|
||||||
- [ ] Verifiser data etter restore.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -462,17 +376,13 @@ Før første release skal alle desse vere oppfylte:
|
|||||||
|
|
||||||
- [ ] Appen køyrer på StartOS 0.4.0.
|
- [ ] Appen køyrer på StartOS 0.4.0.
|
||||||
- [ ] Dei tre nøklane er representerte i appen.
|
- [ ] Dei tre nøklane er representerte i appen.
|
||||||
- [ ] Ein komplett årleg health check kan gjennomførast i nettlesaren.
|
- [ ] Ein komplett årleg health check kan gjennomførast i nettlesaren, og alle årlege kontrollpunkt kan registrerast.
|
||||||
- [ ] Alle årlege kontrollpunkt kan registrerast.
|
|
||||||
- [ ] KI-status kan registrerast som SECURE, PATCHED, VULNERABLE eller COMPROMISED.
|
- [ ] KI-status kan registrerast som SECURE, PATCHED, VULNERABLE eller COMPROMISED.
|
||||||
- [ ] Kontaktinfo kan verifiserast utan å lagre kontaktinformasjonen.
|
- [ ] Kontaktinfo kan verifiserast utan å lagre kontaktinformasjonen.
|
||||||
- [ ] Problem gir tydelege varsel.
|
- [ ] Problem gir tydelege varsel, og eit varsel kan lukkast på den måten som høyrer til varselet.
|
||||||
- [ ] Eit varsel kan lukkast på den måten som høyrer til varselet.
|
- [ ] Neste sjekk blir lagra, og historikk fungerer.
|
||||||
- [ ] Neste sjekk blir lagra.
|
|
||||||
- [ ] Historikk fungerer.
|
|
||||||
- [ ] CSV-rapport kan eksporterast.
|
- [ ] CSV-rapport kan eksporterast.
|
||||||
- [ ] Data overlever restart.
|
- [ ] Data overlever restart, og backup og restore fungerer.
|
||||||
- [ ] Backup og restore fungerer.
|
|
||||||
- [ ] Ingen wallet-hemmelegheiter blir lagra.
|
- [ ] Ingen wallet-hemmelegheiter blir lagra.
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -481,22 +391,15 @@ Før første release skal alle desse vere oppfylte:
|
|||||||
|
|
||||||
Utfør oppgåvene i denne rekkjefølgja og ikkje hopp fram til avanserte funksjonar:
|
Utfør oppgåvene i denne rekkjefølgja og ikkje hopp fram til avanserte funksjonar:
|
||||||
|
|
||||||
- [x] 1. Opprett grunnleggande web-app.
|
- 1–8. Grunnleggande web-app, SQLite og datamodellen, dei tre nøklane, health check-skjemaet, lagring og historikk, varsellogikken, dashboardet og rapporteksport.
|
||||||
- [x] 2. Opprett SQLite og datamodellen.
|
|
||||||
- [x] 3. Implementer dei tre nøklane.
|
|
||||||
- [x] 4. Implementer health check-skjemaet.
|
|
||||||
- [x] 5. Implementer lagring og historikk.
|
|
||||||
- [x] 6. Implementer varsellogikken.
|
|
||||||
- [x] 7. Implementer dashboard.
|
|
||||||
- [x] 8. Implementer rapporteksport.
|
|
||||||
- [ ] 9. Implementer StartOS package.
|
- [ ] 9. Implementer StartOS package.
|
||||||
- [ ] 10. Implementer persistent storage og backup.
|
- [ ] 10. Implementer persistent storage og backup.
|
||||||
- [ ] 11. Test restart og restore.
|
- [ ] 11. Test restart og restore.
|
||||||
- [ ] 12. Bygg endeleg `.s9pk` og gjer første release.
|
- [ ] 12. Bygg endeleg `.s9pk` og gjer første release.
|
||||||
|
|
||||||
**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. §23–§26 er implementerte og verifiserte og kom før steg 9–12. Steg 9–12 er ikkje starta.
|
**Merk:** §23–§26 kom inn etter steg 8 og er implementerte og verifiserte. §27 kjem òg før steg 9–12. Steg 9–12 er ikkje starta.
|
||||||
|
|
||||||
**Testar:** 319 grøne testar etter §26. Køyr `python3 -m unittest discover -s tests`.
|
**Testar:** køyr `python3 -m unittest discover -s tests`. Suiten skal vere grøn både på Linux og på Windows-kopien.
|
||||||
|
|
||||||
**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.
|
**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.
|
||||||
|
|
||||||
@@ -504,108 +407,50 @@ Utfør oppgåvene i denne rekkjefølgja og ikkje hopp fram til avanserte funksjo
|
|||||||
|
|
||||||
# 19–22. Vedtekne avgjerder (implementerte og verifiserte)
|
# 19–22. Vedtekne avgjerder (implementerte og verifiserte)
|
||||||
|
|
||||||
Kvar avgjerd er innarbeidd i §1–§18, og §23–§26 har endra enkelte detaljar etterpå. Den fulle grunngjevinga ligg i git-historikken.
|
- **§19 — registrering per nøkkel.** Ei innsending gjeld éin vald nøkkel, ikkje alle tre. Brukaren vel éi wallet-programvare med eitt versjonsfelt. Kvar nøkkel har sitt eige neste-sjekk-intervall.
|
||||||
|
- **§20 — skjulte felt som blir utleidde.** Eit felt som ikkje gjeld for den valde nøkkelen eller den valde programvara, blir skjult og utleidd. Førre lagra verdi blir fylt inn som ein vanleg input-verdi, og alt utleidd blir lista i Review-oppsummeringa, merkt som nettopp det.
|
||||||
- **§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, og migreringa er bakoverkompatibel. (§23.3 endra vala, og §25.4 tok dei frå innstillingane.)
|
- **§21 — engelske statusverdiar og alle varsel.** `IKKJE_VURDERT` → `NOT_ASSESSED`. 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, slår saman like varsel og listar kritiske først. «Helsesjekk» og `data/helsesjekk.sqlite3` er dokumenterte unntak frå engelskregelen.
|
||||||
- **§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, og alt utleidd blir lista i Review-oppsummeringa, merkt som nettopp det. (§23.1 gjorde den førre verdien til ein vanleg input-verdi, §23.3 fjerna vidareføringa av ein tredje leverandør, og §25.3 fjerna dei to utleidde cloud-felta.)
|
- **§22 — ein nøkkel som ikkje kunne kontrollerast, registrerer ingenting elles.** Det gjeld både `available` = Nei og ein adressesti som ikkje stemmer: `wallet_software` blir `NULL`, `software_compatibility_status` blir `NOT_ASSESSED`, og eit innsend resultat er ein `400`, ikkje noko som blir kasta stille.
|
||||||
- **§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`, §25.3 la kvittering til, og §26.1 gjer eit ope varsel til ei sperre for ein ny kontroll.)
|
|
||||||
- **§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`. Databasen kravde inga endring. (§25.1 brukar same mønsteret for ein adressestifeil, og §26.1 legg sperringa på toppen.)
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 23. Konfigurerbart nøkkeloppsett (implementert og verifisert)
|
# 23. Konfigurerbart nøkkeloppsett (implementert og verifisert)
|
||||||
|
|
||||||
Avtalt 02.10.2026. Reglane står i §3–§6; dette er berre eit kort samandrag.
|
Kvar nøkkel blir konfigurert éin gong ved første oppstart: namn, type og adressesti. Namnet er produktetiketten overalt. `Wallet software`-vala er lista frå innstillingane (sådd med `Sparrow Wallet`) pluss namnet på kvar konfigurert cloud-nøkkel; eit hardware-nøkkelnamn er aldri eit software-val. Oppsettet ligg i SQLite saman med historikken, og ei ny database får eit oppsettsteg. Ei uleseleg database gir ein feil og blir ikkje behandla som ny. Nye endepunkt: `GET /api/setup` og `POST /api/setup`.
|
||||||
|
|
||||||
- Kvar nøkkel blir konfigurert éin gong ved første oppstart: namn og type (`hardware`/`cloud`). (§25.1 legg adressestien til og §25.2 gjer namnet endreleg.)
|
|
||||||
- Namnet brukaren skriv er produktetiketten overalt: skjema, varsel, historikk og CSV-eksport. Nøkkelnummeret blir vist saman med namnet der det trengst, t.d. `Key 1: ColdCard`.
|
|
||||||
- Nøkkeltypen styrer kontrollane, aldri nøkkelnummeret. Ein cloud-nøkkel følgjer Nunchuk-modellen med det konfigurerte namnet.
|
|
||||||
- `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). 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
|
|
||||||
|
|
||||||
- [ ] Fleire enn tre nøklar, og andre tersklar enn 2-av-3.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 24. Obligatoriske val, fjerning av BIP327/SLIP39 og ny skjemastruktur (implementert og verifisert)
|
# 24. Obligatoriske val og ny skjemastruktur (implementert og verifisert)
|
||||||
|
|
||||||
Avtalt 03.10.2026. Der §24 seier noko anna enn §3–§12, gjeld §24. 24.2 og 24.4 vart gjorde i same runde, slik at skjemaversjonen gjekk til 9 med ein gong.
|
`Hardware works` og kontaktstadfestinga er obligatoriske val med `Select status` som første, ugyldige alternativ. Kravet for `Hardware works` fell bort når nøkkelen ikkje kunne kontrollerast; kontaktstadfestinga blir spurd om uansett. Skjemaet har seks seksjonar: 01 Schedule, 02 Key, 03 Compatibility, 04 External research, 05 Contact confirmation, 06 Notes. BIP327/SLIP39 er fjerna heilt, saman med `tool_checks`-tabellen og dataa hans.
|
||||||
|
|
||||||
- **§24.1 — obligatoriske val.** `Hardware works` og kontaktstadfestinga er obligatoriske val med `Select status` som første, ugyldige alternativ. Kravet for `Hardware works` fell bort når nøkkelen er utilgjengeleg; kontaktstadfestinga blir spurt om uansett. Serveren avviser manglande verdi med `400`. `NOT_ASSESSED` finst berre som den utleidde `software_compatibility_status` for ein utilgjengeleg nøkkel. Databasen kravde inga endring.
|
|
||||||
- **§24.2 — BIP327/SLIP39 er fjerna.** Skjema, validering, varsel, historikk, CSV-kolonnar og `tool_checks`-tabellen med dataa sine er borte. Grunngjeving: appen skal haldast enkel og ryddig.
|
|
||||||
- **§24.3 — skjemastruktur.** Rekkjefølgja er 01 Schedule, 02 Key, 03 Compatibility, 04 External research, 05 Contact confirmation, 06 Notes. `04 / Standards` er borte, og seksjonane etter er omnummererte.
|
|
||||||
- **§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`.
|
|
||||||
- **§24.5 — testar og dokumentasjon.** Testane for BIP327/SLIP39 er fjerna, testar for dei obligatoriske vala og for migrering til versjon 9 er lagde til, og `README.md` er oppdatert.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 25. Nøkkelidentitet, rotering, varselkvittering og innstillingar (implementert og verifisert)
|
# 25. Nøkkelidentitet, rotering, varselkvittering og innstillingar (implementert og verifisert)
|
||||||
|
|
||||||
Avtalt 04.10.2026. Reglane står i §3–§12; dette er berre eit kort samandrag.
|
Adressestien er identiteten til nøkkelen saman med typen, og er låst etter første lagra kontroll. Serveren utleier `address_path_verified` etter ei samanlikning som ignorerer blankteikn rundt verdien. Namnet er ein etikett som innstillingane kan endre, og historikk, varsel og CSV viser namnet nøkkelen har no. `POST /api/keys/<id>/rotate` stadfestar at nøkkelen er bytt ut, held eller endrar namnet, krev ein ny adressesti, 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`. 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. Skjemaversjon 10.
|
||||||
|
|
||||||
- **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. (§26.2 gjer stien unik på tvers av nøklane.)
|
|
||||||
- **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. (§26.3 erstattar stadfestinga av at adressestien er uendra med eit krav om ein ny, unik sti.)
|
|
||||||
- **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. (§26.6 rettar avstanden mellom varselnotatet og roteringslista, og §26.7 legg til fjerning av ei programvare som feilar.)
|
|
||||||
- **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`, `check_id` (den nyaste kontrollen som heva varselet), `acknowledged_at` og ein årsak. (§26.4 erstattar den generiske kvitteringa med faste handlingar per varselkode.)
|
|
||||||
|
|
||||||
| `code` | Alvor | Utløyst av | Slik blir det lukka |
|
|
||||||
|---|---|---|---|
|
|
||||||
| `key_unavailable` | critical | `available` = Nei | 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 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 |
|
|
||||||
|
|
||||||
Kvart varsel oppgjev kva handlingar som lukkar det 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.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 26. Sperring, unike adressestiar, rotering med ny sti og varselhandlingar (implementert og verifisert)
|
# 26. Sperring, unike adressestiar og varselhandlingar (implementert og verifisert)
|
||||||
|
|
||||||
Avtalt 04.10.2026, implementert og verifisert før steg 9–12 i §18. Reglane står i §4, §6–§8 og §11–§12; dette er berre eit kort samandrag.
|
Ein nøkkel med eit ope varsel kan ikkje få ein ny kontroll før varselet er lukka, og serveren handhevar regelen med `409`. Adressestien må vere unik på tvers av nøklane: `400` i oppsettet, `409` i innstillingane og `400` ved rotering, og meldinga nemner nøkkelen som har stien. Ei rotering krev ein ny, unik sti, og `address_path_unchanged` er fjerna. Kvar varselkode har sine eigne lukkehandlingar (§7), og den generiske kvitteringa er borte: `POST /api/alerts/acknowledge` tek handlinga og lagrar handlingsnamnet som `reason`. Eit nøkkelkort med eit ope varsel viser `Needs action`, kor mange varsel som står ope, og kva handling som lukkar det første.
|
||||||
|
|
||||||
Bakgrunnen: samanslåinga i §21 held fram, så eit varsel frå ein gammal kontroll blir ikkje borte av at ein nyare kontroll for same nøkkel er frisk. Eit varsel blir difor lukka av brukaren, og eit ope varsel må ikkje kunne forsvinnast ved å registrere ein ny kontroll.
|
---
|
||||||
|
|
||||||
- **Eit ope varsel sperrar nøkkelen.** Ein nøkkel med eit ope varsel kan ikkje få ein ny kontroll før varselet er lukka, og serveren handhevar regelen med `409`, så eit direkte API-kall ikkje kan omgå han. Sperringa gjeld berre den nøkkelen som har varselet. Skjemaet merkjer sperra nøklar som `disabled`, nemner varselet som står i vegen, handlinga som lukkar det og kva nøklar som er ledige, og lenkjer til dashboardet. Kvart varsel har alltid minst éi lukkehandling; eit varsel utan handling er ein feil i koden, ikkje noko brukaren kan hamne i.
|
# 27. Varselhandlingar i historikk og CSV, kontaktvarselet og cloud-programvare
|
||||||
- **Adressestien er unik per nøkkel.** To nøklar kan ikkje ha same sti, korkje i oppsettet, i innstillingane eller ved rotering. Samanlikninga skjer etter `strip` og utan omsyn til store og små bokstavar, og meldinga nemner nøkkelen som har stien. Oppsettet svarar `400`, innstillingane `409` (via `DuplicateAddressPath`) og roteringa `400`. Inga omsyn til ein eldre database: brukaren slettar `data`-mappa og gjer oppsettet på nytt.
|
|
||||||
- **Rotering krev ein ny adressesti.** `POST /api/keys/<id>/rotate` tek `replaced`, `keep_name`, `name` og `address_path`; `address_path_unchanged` er fjerna. Tom sti, den gamle stien og ein sti ein annan nøkkel alt har, blir avviste med `400`. Nøkkelnummeret held fram, namnet kan haldast eller endrast (feltet er førehandsfylt), og sida seier både kvifor stien må bytast — nøkkelen er ein annan, og stien er identiteten hans — og at roteringa gir ei ny lommebok.
|
|
||||||
- **Kvar varselkode har sine eigne handlingar.** Den generiske kvitteringa er borte, og `POST /api/alerts/acknowledge` tek handlinga i staden for ein fri årsak og lagrar handlingsnamnet som `reason`. Ei handling som ikkje høyrer til varselet blir avvist. `rotate` blir utført i innstillingane, sidan han krev ein ny adressesti; dei andre handlingane har kvar sin knappetekst og sitt eige stadfestingssteg i nettlesaren.
|
|
||||||
|
|
||||||
| `code` | Kjelde | Handlingar |
|
Avtalt 05.10.2026. **Ikkje starta.** Skjemaet går til versjon 11.
|
||||||
|---|---|---|
|
|
||||||
| `key_unavailable` | nøkkel | `rotate` |
|
|
||||||
| `address_path_mismatch` | nøkkel | `rotate` |
|
|
||||||
| `hardware_failure` | nøkkel | `rotate`, `replace_hardware` |
|
|
||||||
| `seed_backup_problem` | nøkkel | `rotate` |
|
|
||||||
| `software_incompatible` | programvare | `remove_software` |
|
|
||||||
| `security_vulnerable` | nøkkel | `rotate`, `ignore` |
|
|
||||||
| `security_vulnerable` | programvare | `remove_software`, `ignore` |
|
|
||||||
| `security_compromised` | nøkkel | `rotate` |
|
|
||||||
| `security_compromised` | programvare | `remove_software` |
|
|
||||||
| `contact_info_unconfirmed` | kontaktinfo | `contact_updated` |
|
|
||||||
|
|
||||||
- **Programvarevarsel blir lukka ved fjerning.** `software_incompatible` og eit programvarekjeldet `security_vulnerable` oppgjev kva programvare som fekk resultatet, forklarer at ho ikkje lenger støttar hardwaren, og lenker til innstillingane. Varselet blir lukka ved at brukaren fjernar den feilande programvara der, etter at ei ny er lagd til. Er ho det einaste elementet i lista, må brukaren leggje til ei ny først, sidan lista aldri kan bli tom (§25.4); meldinga seier det, og lenkja fører til innstillingane. Er det andre element i lista, får brukaren ein enkel knapp i sjølve varselet som fjernar den feilande programvara, og varselet blir borte med ho. Å fjerne eit listeelement rører ikkje lagra kontrollar, sidan `wallet_software` i `health_checks` er fri tekst.
|
Bakgrunnen: ei lukking blir alt lagra i `alert_acknowledgements` (`code`, `source`, `check_id`, `reason` = handlingsnamnet, `acknowledged_at`), men ingenting les tabellen. Brukaren kan difor ikkje sjå kva som vart lukka, når og med kva handling. I tillegg finst to hol: kontaktvarselet høyrer ikkje til nokon nøkkel, og `software_incompatible` tilbyr `remove_software` òg når «programvara» er namnet på ein cloud-nøkkel, som aldri kan fjernast frå innstillingane.
|
||||||
- **Nøkkelkortet viser eit ope varsel.** Kortet viser `Needs action` i staden for den vanlege statusen sin, kor mange varsel som står ope, at nøkkelen ikkje kan få ein ny kontroll før dei er lukka, kva handling som lukkar det første, og ei lenkje til varsellista.
|
|
||||||
- **Ein CSS-fiks.** Avstanden mellom `div.warning-note` og `div.rotation-list` i `03 / Key rotation` er auka, slik at notatet og lista ikkje flyt saman. Berre avstanden er endra, ikkje fargar eller innhald.
|
|
||||||
- **Skjemaet er framleis versjon 10.** §26 legg ikkje til kolonnar eller tabellar.
|
|
||||||
|
|
||||||
## 26.8 Testar og dokumentasjon
|
- **Sperring.** Eit varsel som høyrer til ein nøkkel sperrar den nøkkelen til det er lukka. Det gjeld òg `contact_info_unconfirmed`, som har alvor `info`. `blocking_alert` og filteret i skjemaet matchar alt på `key_id`, så sperrekoden treng ikkje endrast.
|
||||||
|
- **Kontaktvarselet får ein nøkkel.** `key_id` = den kontrollerte nøkkelen, `source` = `Key N: <namn>` (same konvensjon som nøkkelvarsla), og meldinga namngjev nøkkelen: «The contact details for Key 1: SeedSigner need an external update. Update them in your external documentation, then close this alert.» Alvoret er framleis `info`, og handlinga framleis `contact_updated`.
|
||||||
|
- **`software_incompatible` får to former.** Når den registrerte `wallet_software` er namnet på ein konfigurert cloud-nøkkel: `key_id` = den kontrollerte nøkkelen, `source` = `Key N: <namn>`, og handlingane `[replace_hardware]`. Elles som i dag: `key_id` = `None`, `source` = programvanamnet, og handlingane `[remove_software]`.
|
||||||
|
- **Kvitteringa lagrar nøkkelen.** `alert_acknowledgements` får ei ny, nullable kolonne `key_id` (INTEGER, ingen FK, ingen CHECK).
|
||||||
|
- **Varselidentitet.** Eit varsel med `key_id` blir kvittert og skjult etter `(code, key_id)`; eit varsel utan `key_id` som før, etter `(code, source)`. Dette fiksar ein bug der `rotate` med `keep_name=false`, eller ei rein omdøyping i innstillingane, opnar eit lukka varsel att, fordi `source` inneheld namnet nøkkelen har no.
|
||||||
|
- **Lukkingar i historikk og CSV.** Lukkingar med `key_id` (altså `rotate`, `replace_hardware`, `contact_updated` og `ignore` med nøkkel som kjelde) skal visast i `GET /api/health-checks/<id>` og i CSV-eksporten. `remove_software` og `ignore` med programvare som kjelde skal ikkje visast. Lukkinga blir hengd på kontrollen ho lukka (`check_id`).
|
||||||
|
|
||||||
- [x] §26.8 er svara på 04.10.2026: ingen omsyn til eldre databasar (§26.2), ingen `ignore` på `security_compromised` (§26.4), og `software_incompatible` lukkast ved å fjerne programvara i innstillingane (§26.7).
|
## Framtidig arbeid, ikkje no
|
||||||
- [x] Testar: alt som er implementert i §26 har testar, og funksjonalitet som blir fjerna er ikkje testa. Testsuiten er grøn (319 testar).
|
|
||||||
- [x] Dokumentasjon: `README.md`, `TODO.md` og `ai-note.md` er oppdaterte.
|
- [ ] Fleire enn tre nøklar, og andre tersklar enn 2-av-3.
|
||||||
Reference in new issue
Block a user