TODO: compress the finished section 32 rounds to short numbered point lists
This commit is contained in:
1 parent
030f3a77e6
commit
c59cd7ecbb
1 file changed
+70
-122
@@ -17,7 +17,7 @@ Appen skal **berre registrere resultat og historikk**. Han skal ikkje signere Bi
|
|||||||
|
|
||||||
- **§1–§18 er kravspecen og gjeld som han står.** Han skildrar appen slik han er no, ikkje slik han vart bygd.
|
- **§1–§18 er kravspecen og gjeld som han står.** Han skildrar appen slik han er no, ikkje slik han vart bygd.
|
||||||
- **§19–§31 er historikk.** Alle rundane der er ferdige og verifiserte, og står no som éi linje kvar. Reglane deira ligg i §1–§18 og i `ai-note.md`, som er handoveren.
|
- **§19–§31 er historikk.** Alle rundane der er ferdige og verifiserte, og står no som éi linje kvar. Reglane deira ligg i §1–§18 og i `ai-note.md`, som er handoveren.
|
||||||
- **§32 er runden som går no.** §32.1 (ikonet med favicon og PNG-ar), §32.2 (UI-passet med retro-temaet), §32.3 (varsel- og sidetekstane), §32.4 (bug-rapporten) og §32.7 (dashboard-menyen og oppryddinga i dashbordet, med etterrunden sin) er utførte. I §32.4 står berre BR-003 att, og han kan berre brukaren lukke. §32.6 og §32.5 står att. Etterrunden av §32.1 og §32.2 — faviconet, merket i topplinja, footeren nedst på sida, den eine vegen tilbake, history-knappen og linje- og tabellendringane i historia — er òg utførd.
|
- **§32 er runden som går no.** §32.1–§32.4 og §32.7 er utførte og verifiserte; dei står nedanfor som korte punktlister, slik at §-referansane i koden held, medan grunngjevinga ligg i git-historikken. Att står §32.6 (dokumentasjonsdrifta) og §32.5 (hevinga av pakkeversjonen). I §32.4 står berre BR-003 att, og han kan berre brukaren lukke.
|
||||||
- **Reglane under «Reglar som gjeld alle rundar» er bindande** for kvar framtidig endring.
|
- **Reglane under «Reglar som gjeld alle rundar» er bindande** for kvar framtidig endring.
|
||||||
- Eit punkt utan avkryssingsboks er implementert og verifisert. `[ ]` markerer det som står att.
|
- Eit punkt utan avkryssingsboks er implementert og verifisert. `[ ]` markerer det som står att.
|
||||||
- **Status:** alt til og med §31 er implementert og verifisert, og §32.1, §32.2, §32.3, §32.4 og §32.7 er utførte (sjå §32), med unnatak av BR-003, som berre brukaren kan lukke. Av §32 står §32.6 og §32.5 att. Skjema **versjon 12**, testsuiten grøn (**513 testar**), og StartOS-pakka er bygd, sideloda og køyrd på ein eigen StartOS 0.4.0-boks. Pakkeversjonen står på `0.1.0:0` og blir ikkje heva før §32 er ferdig og brukaren seier ifrå.
|
- **Status:** alt til og med §31 er implementert og verifisert, og §32.1, §32.2, §32.3, §32.4 og §32.7 er utførte (sjå §32), med unnatak av BR-003, som berre brukaren kan lukke. Av §32 står §32.6 og §32.5 att. Skjema **versjon 12**, testsuiten grøn (**513 testar**), og StartOS-pakka er bygd, sideloda og køyrd på ein eigen StartOS 0.4.0-boks. Pakkeversjonen står på `0.1.0:0` og blir ikkje heva før §32 er ferdig og brukaren seier ifrå.
|
||||||
@@ -502,128 +502,78 @@ Alle rundane under er implementerte og verifiserte. Reglane deira ligg i §1–
|
|||||||
|
|
||||||
# 32. Det som står att
|
# 32. Det som står att
|
||||||
|
|
||||||
Sju punkt, alle **før** pakkeversjonen blir heva frå `0.1.0:0` til `1.0.0:0`. §32.1, §32.2, §32.3, §32.4 og §32.7 er utførte; §32.6 og §32.5 står att, og eit punkt skal ikkje startast utan at brukaren ber om det.
|
Att står **§32.6 dokumentasjonsdrifta** og **§32.5 hevinga av pakkeversjonen**, begge **før** pakkeversjonen blir heva frå `0.1.0:0` til `1.0.0:0`. §32.1–§32.4 og §32.7 er utførte og verifiserte, og står nedanfor som korte punktlister, slik at §-referansane i koden held. Eit punkt skal ikkje startast utan at brukaren ber om det.
|
||||||
|
|
||||||
**Status i §32:** 32.1 er utført — SVG-en er teikna om, faviconet ligg på alle seks sidene, og PNG-ikona på 192 og 512 px er rasteriserte, lista i manifestet og serverte. 32.2 er utført saman med etterrunden sin, 32.3 er utført, 32.4 er utført i rundane 32-A og 32-B, og 32.7 er utført — menyen i topplinja, det rydda dashbordet, `Download CSV` og noten i sin eigen `Export`-seksjon på history-sida, hoppet til `#history-detail` og robots-sperra. I 32.4 står berre **BR-003** att, og han er ei manuell ende-til-ende-verifisering som berre brukaren kan gjere. 32.6 og 32.5 står framleis att: 32.6 skal skildre den utgåva som faktisk blir gitt ut, og kjem før 32.5, som er hevinga av pakkeversjonen. Den manuelle nettlesartesten av retro-temaet på ein smal telefon står att for brukaren, saman med dei nye manuelle punkta i etterrunden av 32.1 og 32.2, menyen og det rydda dashbordet, installasjonen av PWA-en med dei to PNG-ikona, og den nye bokstesten i 32.5.
|
**Status i §32:** §32.1 (ikonet), §32.2 (UI-passet med retro-temaet), §32.3 (varsel- og sidetekstane), §32.4 (bug-rapporten, rundane 32-A og 32-B) og §32.7 (dashboard-menyen og oppryddinga i dashbordet) er utførte, kvar med etterrunden sin. I §32.4 står berre **BR-003** att, og han er ei manuell ende-til-ende-verifisering som berre brukaren kan gjere. §32.6 skal skildre den utgåva som faktisk blir gitt ut, og kjem før §32.5, som er hevinga av pakkeversjonen. Den manuelle nettlesartesten av retro-temaet på ein smal telefon står att for brukaren, saman med dei nye manuelle punkta i etterrunden av §32.1 og §32.2, menyen og det rydda dashbordet, installasjonen av PWA-en med dei to PNG-ikona, og den nye bokstesten i §32.5.
|
||||||
|
|
||||||
## 32.1 Ikonet
|
## 32.1 Ikonet — utført
|
||||||
|
|
||||||
**Utført.** `icon.svg` i repo-rota og `static/icon.svg` er den same retro-teikninga: eit heva grått vindauge med dei tre nøklane i standardoppsettet, sentrerte i flata. Fila i rota er 1,2 KiB, langt under grensa på 40 KiB, og ho er rein SVG utan fontar, bilete eller nettverkskall, så CSP-en `default-src 'self'` held.
|
1. `icon.svg` i repo-rota og `static/icon.svg` er den same retro-teikninga: eit heva grått vindauge med dei tre nøklane, sentrerte i flata. Den marineblå tittelstripa er borte, nøkkelgruppa er 21 høg, flata innanfor 3D-kanten går frå 6 til 122, så senteret er 64 og nøklane står på `translate(23, 25.5)`, `(23, 51.5)` og `(23, 77.5)`. Fila i rota er 1,2 KiB, og ho er rein SVG utan fontar, bilete eller nettverkskall, så CSP-en `default-src 'self'` held.
|
||||||
|
2. Kvart av dei seks sidene har `<link rel="icon" type="image/svg+xml" href="/icon.svg">` i `<head>`, og `<img class="brand-mark" src="/icon.svg" alt="" aria-hidden="true">` i topplinja. Klassenamnet `brand-mark` står, og `.brand-mark` i `static/styles.css` er 18×18 med `image-rendering: pixelated`.
|
||||||
|
3. `static/icon-192.png` (192×192) og `static/icon-512.png` (512×512) er rasteriserte frå SVG-en. Begge står i `icons`-oppføringa i `static/manifest.webmanifest` med rett storleik og `type: "image/png"`, **etter** SVG-oppføringa, og begge er med i `STATIC_FILES` i `app.py` og i skal-allow-lista i `static/sw.js`.
|
||||||
|
4. `tests/test_pwa.py` pinnar favicon-lenka og merket på alle seks sidene, `.brand-mark`-stilen, at dei to SVG-filene har same teikning, at kvar PNG er den storleiken han oppgjev, og at begge blir serverte.
|
||||||
|
|
||||||
- Den marineblå tittelstripa er fjerna. Nøklane er rekna på nytt og sentrerte i flata: kvar nøkkelgruppe er 21 høg, og flata innanfor 3D-kanten går frå 6 til 122, så senteret er 64. Nøklane står difor på `translate(23, 25.5)`, `(23, 51.5)` og `(23, 77.5)`, med same innbyrdes avstand som før. Same stil, same `viewBox` og same `role`/`aria-label` er behaldne.
|
## 32.2 UI-finpussen — utført
|
||||||
- `static/icon.svg` er den same teikninga som pakke-ikonet i repo-rota, som er kjelda til sanninga. Ein test samanliknar dei to filene frå `<svg>`-elementet og ut, så berre den leiande kommentaren kan skilje dei.
|
|
||||||
- **Faviconet:** kvart av dei seks sidene har `<link rel="icon" type="image/svg+xml" href="/icon.svg">` i `<head>`, ved sida av manifest-lenka på dei fem som har ei. `/login` har ikkje noko manifest, så der står ikonet ved sida av stilarket.
|
|
||||||
- **Merket i topplinja:** `<span class="brand-mark" aria-hidden="true">V</span>` er bytt mot `<img class="brand-mark" src="/icon.svg" alt="" aria-hidden="true">` på alle seks sidene. Klassenamnet `brand-mark` står, og `.brand-mark` i `static/styles.css` er justert til eit bilete: 18×18, same kant, og `image-rendering: pixelated`. `place-items` og font-reglane som berre galdt bokstaven, er borte.
|
|
||||||
- **PNG-ikona:** `static/icon-192.png` (192×192) og `static/icon-512.png` (512×512) er rasteriserte frå `static/icon.svg`. Begge står i `icons`-oppføringa i `static/manifest.webmanifest` med `sizes` og `type: "image/png"`, **etter** SVG-oppføringa, som framleis er fyrst. Stiane står òg i `STATIC_FILES` i `app.py` og i skal-allow-lista i `static/sw.js`, så dei blir serverte og ligg i PWA-cachen.
|
|
||||||
- `tests/test_pwa.py` pinnar favicon-lenka på alle seks sidene, at merket er biletet og ikkje bokstaven, `.brand-mark`-stilen, at dei to SVG-filene har same teikning, at dei to PNG-ane er 192×192 og 512×512 ifylgje sin eigen IHDR, at manifestet listar dei med rett storleik og type, og at begge blir serverte.
|
|
||||||
- Dette lukkar den opne boksen i §30.
|
|
||||||
|
|
||||||
## 32.2 UI-finpuss
|
Retro-temaet (Windows-app, midten av 90-talet) ligg i `static/styles.css`: bakgrunn `#c0c0c0`, felt `#ffffff`, mørk kant `#808080`, mørkast `#000000` og tittelstripe `#000080` med kvit tekst. Ingen `border-radius`, ingen `box-shadow` og ingen gradientar — djupna kjem av 3D-kantar. Skrifta er systemfont-stabelen `"MS Sans Serif", Tahoma, Verdana, Geneva, sans-serif` i 12–13 px, fokus er `outline: 1px dotted #000000`, og tabellane er rutemønster med 1 px rammer. `theme-color` på dei fem sidene og `/login` og `theme_color`/`background_color` i manifestet er `#c0c0c0`.
|
||||||
|
|
||||||
**Utført.** Ein gjennomgang av dei fem sidene og `/login`, utan nye funksjonar. Sidene har fått eit retro-tema, og dei 15 designpunkta er gjennomførte.
|
1. Luft mellom hjelpetekst og neste blokk: `.field-help + .field-grid, .field-help + .form-stack { margin-top: 12px; }`.
|
||||||
|
2. Åtvaringa mot å lime inn ei løyndom står no éin gong, som eitt `p.secret-warning` over heile nøkkel-lista i `setup.html`; `setup.js` legg henne ikkje lenger inn per kort.
|
||||||
|
3. Dashbord-overskrifta blir fylla av `renderSetupHeading()` i `app.js` frå `threshold` og `key_count` i `/api/setup`; linja i markupen er fallbacken.
|
||||||
|
4. «An overview of your multisig setup and annual checks.» er fjerna.
|
||||||
|
5. `section.setup-card` er fjerna, saman med `setupTitle`, `setupDescription` og `renderSetupShape()`.
|
||||||
|
6. Nøkkelkortet viser nummer og type på den øvste linja (`01 · Hardware`).
|
||||||
|
7. Nøkkelkortet viser berre stien, i skrå skrift (`.key-path`), utan prefikset `Address path:`.
|
||||||
|
8. Nøkkelkortet viser berre modellnamnet, under namnet og over stien, og hoppar over det når det berre gjentek nøkkelnamnet (`sameLabel()`).
|
||||||
|
9. Nøkkelkortet viser berre `Next check due`; `Last checked` er borte.
|
||||||
|
10. Den korte åtvaringa er fjerna frå `health-check.html`, `health-check.js`, `settings.js` og `setup.js`. Serveren er uendra: eit løyndom i eit fritekstfelt blir framleis avvist med `400`.
|
||||||
|
11. `Needs assessment`-lista i Review-oppsummeringa er fjerna; `Results requiring follow-up` står.
|
||||||
|
12. Oppsummeringslinja i Review med `Key N: … · Check date: … · Next check due: …` er fjerna.
|
||||||
|
13. `Local service` i topbaren og `Your data stays local.` i footeren er fjerna på alle sidene, òg `/login`.
|
||||||
|
14. Historikk-kortet viser datoen, nøkkelnummeret og namnet nøkkelen har no, og ein kort status (`All OK` / `Needs follow-up`). Dette kravde eit **additivt** felt i oppsummeringa: `GET /api/health-checks` gjev no `key_names` og `needs_follow_up` i tillegg til felta som alt var der (§11). `needs_follow_up` er ein eigenskap ved den lagra kontrollen, så han endrar seg ikkje når brukaren lukkar varselet seinare.
|
||||||
|
15. Historikk-tabellane held seg innanfor sida på ein smal skjerm, med `table-layout: fixed`, `overflow-wrap: break-word` og mindre skrift på `.detail-table`. Løyst i CSS, utan ny JavaScript.
|
||||||
|
|
||||||
**Retro-temaet (Windows-app, midten av 90-talet).** `static/styles.css` er skriven om: bakgrunn `#c0c0c0`, felt `#ffffff`, mørk kant `#808080`, mørkast `#000000` og tittelstripe `#000080` med kvit tekst. Ingen `border-radius`, ingen `box-shadow` og ingen gradientar — djupna kjem av 3D-kantar (lys oppe/til venstre, mørk nede/til høgre). Skrifta er systemfont-stabelen `"MS Sans Serif", Tahoma, Verdana, Geneva, sans-serif` i 12–13 px med tette linjer. Knappar er heva og ser nedtrykte ut på `:active`, skjemfelta er søkkte, fokus er den klassiske stipla ramma (`outline: 1px dotted #000000`), overskriftene er tittelstriper, og tabellane er rutemønster med 1 px rammer. Dei responsive reglane står uendra, og ingen tekst blir klypt på ein smal telefon. `theme-color`-metaet på dei fem sidene og `/login` og `theme_color`/`background_color` i `static/manifest.webmanifest` er sette til `#c0c0c0` saman med sidebakgrunnen, og `tests/test_pwa.py` er oppdatert.
|
Etterrunden av §32.1 og §32.2 — faviconet, merket, footeren og historia:
|
||||||
|
|
||||||
**Dei 15 designpunkta:**
|
16. Footeren ligg nedst på sida òg når innhaldet er kort: `body` er ein kolonne med `min-height: 100vh` og `100dvh`, og `main { flex: 1 1 auto; }` tek resten.
|
||||||
|
17. Faviconet ligg på alle seks sidene.
|
||||||
|
18. Merket i topplinja er ikonet som bilete, med same klasse `brand-mark`.
|
||||||
|
19. «Back to dashboard» er fjerna frå `history.html`, `settings.html`, `setup.html` og `health-check.html`; merket «VardKey» er vegen tilbake. Lenkja i sperre-noten i skjemaet står.
|
||||||
|
20. «Start annual health check»-knappen er fjerna frå `history.html`. Ein kontroll blir starta frå dashbordet.
|
||||||
|
21. Historie-visninga i `history.js` slår saman programvara og versjonen hennar på éi line (`Sparrow Wallet 2.5.1`) og modellen og firmware-versjonen på éi line (`Blockstream Jade 1.4.1`); manglar ein del, står resten åleine, og manglar båe, står `—`. Lukke-tabellen viser `Alert`, `Action` og `Closed` — kjelde-kolonnen er borte. Dette kravde eit **additivt** felt i svaret: `GET /api/health-checks/<id>` ber no `model` på kvart nøkkelrecord (§11).
|
||||||
|
|
||||||
1. **Luft mellom hjelpetekst og neste blokk.** CSS-regelen `.field-help + .field-grid, .field-help + .form-stack { margin-top: 12px; }` gjev blokka luft etter hjelpelinja på dei tre stadene: før `div.field-grid` i `setup.html`, før `div#key-check` i `health-check.html` og før `div#wallet-software-list` i `settings.html`.
|
**Testar:** `tests/test_health_check_form.py`, `tests/test_pwa.py`, `tests/test_secret_guard.py`, `tests/test_key_status.py` og `tests/test_app.py` er oppdaterte. Suiten gjekk frå 477 til **484 testar**, etterrunden la til ti og PNG-ikona fire til, så han stod på **498 testar**.
|
||||||
2. **Åtvaringa i key setup berre éin gong.** Ho står no som eitt `p.secret-warning` over heile nøkkel-lista i `setup.html`, og `setup.js` legg henne ikkje lenger inn i kvart nøkkelkort.
|
|
||||||
3. **Dashbord-overskrifta nemner oppsettet.** `p#setup-shape` blir fylla av `renderSetupHeading()` i `app.js` frå `threshold` og `key_count` i `/api/setup`, t.d. «Bitcoin Health Monitor for a 2-of-3 Multisig Setup.». Linja som står i markupen er fallbacken før dataa kjem. Beskrivinga «Bitcoin Multisig Health Monitor» står framleis i manifestet og i §29.
|
|
||||||
4. **«An overview of your multisig setup and annual checks.» er fjerna** frå dashbordet.
|
|
||||||
5. **`section.setup-card` er fjerna.** `app.js` skriv ikkje lenger til `#setup-title`/`#setup-description`: `setupTitle`, `setupDescription`, `renderSetupShape()` og `setupResult`-greina er bytte ut med `setupShape` og `renderSetupHeading()`.
|
|
||||||
6. **Nøkkelkortet viser nummer og type i toppen** (`01 · Hardware` / `01 · Cloud`), og den separate `Hardware key`/`Cloud key`-linja er borte.
|
|
||||||
7. **Nøkkelkortet viser berre stien**, i skrå skrift (`.key-path`), utan prefikset `Address path:`.
|
|
||||||
8. **Nøkkelkortet viser berre modellnamnet**, under namnet og over stien. Er modellnamnet likt nøkkelnamnet utan omsyn til store/små bokstavar og luft (`sameLabel()`), blir linja ikkje vist i det heile.
|
|
||||||
9. **Nøkkelkortet viser berre neste kontroll.** `Next check due` står; `Last checked` er fjerna.
|
|
||||||
10. **Åtvaringa står berre i key setup.** Serverlogikken er uendra: `secret_guard.py`, `validation.py` og `auth.py` er ikkje rørde, og eit løyndom i eit fritekstfelt blir framleis avvist med `400`. Den korte åtvaringa er fjerna frå `health-check.html` (3), `health-check.js` (3), `settings.js` (2) og `setup.js` (1 per kort), og står no éin gong i `setup.html`. Formuleringa i §2, §12 og §15 er oppdatert, og `WarningTests` i `tests/test_secret_guard.py` pinnar den nye regelen.
|
|
||||||
11. **`Needs assessment`-lista i Review-oppsummeringa er fjerna** frå `health-check.js`. `Results requiring follow-up` står.
|
|
||||||
12. **Oppsummeringslinja i Review med `Key N: … · Check date: … · Next check due: …` er fjerna.**
|
|
||||||
13. **`Local service` i topbaren og `Your data stays local.` i footeren er fjerna** på alle sidene, òg `/login`.
|
|
||||||
14. **Historikk-kortet viser datoen, nøkkelnummer og -namn, og ein kort status** (`All OK` / `Needs follow-up`). `Next check due` og `Software`-teksten er borte. Dette kravde eit **additivt** felt i oppsummeringa: `GET /api/health-checks` gjev no `key_names` og `needs_follow_up` i tillegg til felta som alt var der (§11). `needs_follow_up` blir rekna ut av dei same varselreglane som dashbordet brukar, og er ein eigenskap ved den lagra kontrollen, så han endrar seg ikkje når brukaren lukkar varselet seinare.
|
|
||||||
15. **Historikk-tabellane på mobil.** CSS-reglane `table-layout: fixed`, `overflow-wrap: break-word` og mindre skrift på `.detail-table` held `Security status` og `Follow-up closed` innanfor sida på ein smal skjerm. Løyst i CSS, utan ny JavaScript.
|
|
||||||
|
|
||||||
**Etterrunden av §32.1 og §32.2 — faviconet, merket, footeren og historia.** Same gjennomgangen førte til desse punkta, utan nye funksjonar og utan skjemaendring:
|
## 32.3 Meldingstekstane i varsla — utført
|
||||||
|
|
||||||
16. **Footeren ligg nedst på sida òg når innhaldet er kort.** `body` er ein kolonne med `min-height: 100vh` og `100dvh`, og `main` tek resten av høgda (`main { flex: 1 1 auto; }`). `.footer` ligg etter han. Ingen andre layoutreglar er rørde.
|
1. Kvar av dei elleve varselradene i §7 har ein `message` i `alerts.py`, og alle er skrivne i same form: kva som er gale, kva nøkkel eller programvare det gjeld, og kva som lukkar varselet. `code`, alvor, kjelde, handlingar og `software`-feltet er uendra, og forma er no presisert i §7.
|
||||||
17. **Faviconet.** Alle seks sidene lenkjer `/icon.svg` i `<head>`, ved sida av manifest-lenka der det finst ei (§32.1).
|
2. Meldinga gjentek ikkje namnet i `source`; ho seier «this key». Det einaste unntaket er den nøkkelforma av `software_incompatible` som namngjev programvara, fordi kjelda der er nøkkelen.
|
||||||
18. **Merket i topplinja er ikonet som bilete**, med same klasse `brand-mark`, så CSS-en og testane som visar til han held (§32.1).
|
3. `_VULNERABLE_MESSAGE` og `_COMPROMISED_MESSAGE` er delte i kvar si melding for nøkkel- og programvareforma, sidan dei to formene blir lukka av kvar si handling. `_HARDWARE_FAILURE_MESSAGE`, `_SEED_BACKUP_MESSAGE` og malen `_SOFTWARE_INCOMPATIBLE_KEY_MESSAGE` er trekte ut av `_key_alerts`.
|
||||||
19. **«Back to dashboard» er fjerna** frå `history.html`, `settings.html`, `setup.html` og `health-check.html`. Merket «VardKey» er vegen tilbake. Lenkja i sperre-noten i skjemaet står, for ho peikar på dashbordet av ein annan grunn.
|
4. «Replace the key» er borte der den einaste handlinga er `rotate`, og «PROTOCOL 3: key loss» og «follow the key loss procedure» er tekne bort, sidan ingen av dei er definerte nokon stad.
|
||||||
20. **«Start annual health check»-knappen er fjerna** frå `history.html`. Ein kontroll blir starta frå dashbordet.
|
5. Sperre-svaret (`409`) seier ikkje lenger den interne koden: «This key has an open alert. Close the alert before recording a new check.»
|
||||||
21. **Historie-visninga i `history.js`:** programvara og versjonen hennar står på éi line (`Sparrow Wallet 2.5.1`), modellen og firmware-versjonen står på éi line (`Blockstream Jade 1.4.1`), og lukke-tabellen viser `Alert`, `Action` og `Closed` — kjelde-kolonnen er borte. Manglar ein del av eit par, står resten åleine; manglar båe, står `—`. Dette kravde eit **additivt** felt i svaret: `GET /api/health-checks/<id>` ber no `model` på kvart nøkkelrecord (§11).
|
6. Sidetekstane som vart rydda: den dupliserte eyebrow-en i `index.html` og `settings.html`, den dupliserte `Sign in`-overskrifta i `login.html`, den dupliserte hjelpelinja og den døde `#software-help`-teksten i `health-check.html`, dei to `Removing an entry…`-hjelpene i `settings.html` slått saman til eitt avsnitt, «Open the settings» i både `setup.js` og `app.js`, og den gjentekne personvernsetninga i `app.js`'s `setupDescription`. `validation.py`-meldinga er skriven om til «this name already comes from a configured cloud key».
|
||||||
|
7. Medvite uendra: `ACTION_LABELS` / `ACTION_CONFIRMATIONS` i dei tre kopiane, og `UNAVAILABLE_MESSAGE` i `health-check.js`.
|
||||||
|
|
||||||
**Testar:** `tests/test_health_check_form.py`, `tests/test_pwa.py`, `tests/test_secret_guard.py`, `tests/test_key_status.py` og `tests/test_app.py` er oppdaterte, og nye testar pinnar nøkkelkortet, dashbord-overskrifta, historikk-kortet, dei to nye oppsummeringsfelta, lufta etter hjelpelinja, dei to tabellane og retro-reglane. Suiten gjekk frå 477 til **484 testar**. Etterrunden la til ti testar: tre i `tests/test_alerts.py` (nøkkelkjelda til eit KI-varsel, at programvareforma held den reine leverandørkj elda, og at eit nøkkelvarsel framleis blir skjult på `key_id` etter kjeldeendringa), fire i `tests/test_pwa.py` (favicon-lenka, merket, `.brand-mark`-stilen og footeren) og tre i `tests/test_health_check_form.py` (dei samanslåtte linjene, den eine vegen tilbake, og at history-sida ikkje startar ein kontroll). Då PNG-ikona kom på plass, la `tests/test_pwa.py` til fire testar til: at dei to SVG-filene har same teikning, at kvar PNG er den storleiken han oppgjev, at manifestet listar begge med rett storleik og type, og at begge blir serverte. Suiten går difor frå 484 til **498 testar**.
|
**Testar:** `tests/test_alerts.py` held tekstane; seks testar er oppdaterte eller omdøypte, og éin ny pinnar at nøkkelforma og programvareforma av same kode har kvar si melding. `tests/test_app.py` held ikkje på nokon meldingstekst.
|
||||||
|
|
||||||
**Det som står att i §32.2:** ingenting av dei 15 punkta, og ingenting av etterrunden. Den manuelle nettlesartesten av retro-temaet på ein smal telefon, stadfestinga av at ingenting blir klypt eller overfylt der, og ein kikk på footeren, faviconet, merket i topplinja, PWA-installasjonen og history-visninga høyrer til brukaren.
|
## 32.4 Bug-rapporten — utført, utanom BR-003
|
||||||
|
|
||||||
## 32.3 Gjennomgang av meldingstekstane i varsla
|
Rapporten vart skriven mot eit anna filsett; dei åtte dokumenta han ber om finst ikkje her, og skal ikkje opprettast. Kvar BR vart verifisert i koden som ligg i dette repoet før noko vart endra:
|
||||||
|
|
||||||
**Utført.** Kvar av dei elleve varselradene i §7 har ein `message` i `alerts.py`, og alle er skrivne om til same form: kva som er gale, kva nøkkel eller programvare det gjeld, og kva som lukkar varselet. `code`, alvor, kjelde, handlingar og `software`-feltet er uendra. Forma er no presisert i §7.
|
|
||||||
|
|
||||||
- **Nye private konstantar.** `_HARDWARE_FAILURE_MESSAGE` og `_SEED_BACKUP_MESSAGE` er trekte ut av `_key_alerts`, der dei låg inline. `_SOFTWARE_INCOMPATIBLE_KEY_MESSAGE` er no ein mal med `{software}`, sidan kjelda til den forma er nøkkelen og ikkje programvara. `_VULNERABLE_MESSAGE` og `_COMPROMISED_MESSAGE` er delte i `_VULNERABLE_KEY_MESSAGE` / `_VULNERABLE_SOFTWARE_MESSAGE` og `_COMPROMISED_KEY_MESSAGE` / `_COMPROMISED_SOFTWARE_MESSAGE`, sidan dei to formene blir lukka av kvar si handling.
|
|
||||||
- **«Replace the key» er borte** der den einaste handlinga varselet tilbyr er `rotate`. Meldingane seier no kva handling som lukkar dei, og dei gjentek ikkje at nøkkelen ikkje kan kontrollerast — det står alt i sperre-noten og på nøkkelkortet.
|
|
||||||
- **«PROTOCOL 3: key loss» og «follow the key loss procedure» er tekne bort.** Ingen av dei er definerte i appen eller i dokumenta, så dei peika på eit omgrep brukaren ikkje har.
|
|
||||||
- **Kontaktvarselet namngjev ikkje lenger nøkkelen i meldinga.** Kjelda er `Key N: <namn>`, og ho blir vist rett over meldinga i varsellista og framføre henne i sperre-noten i skjemaet, så meldinga seier «this key».
|
|
||||||
- **Den nøkkelforma av `software_incompatible` namngjev programvara**, fordi kjelda der er nøkkelen.
|
|
||||||
- **Dobbeltføringa som står att:** handlinga blir nemnd både i meldinga, i knappen i varsellista og i «Close it with: …» i sperre-noten. Det er medvite — knappen og noten seier kva brukaren kan trykkje på, medan meldinga skal stå åleine når ho blir lesen utan knappane.
|
|
||||||
- **Testar:** `tests/test_alerts.py` held tekstane. Seks testar er oppdaterte eller omdøypte (`test_a_hardware_failure_points_at_the_replacement`, `test_a_damaged_seed_backup_asks_for_a_rotation`, `test_a_mismatched_address_path_asks_for_a_replacement`, `test_a_compromised_security_status_asks_for_a_rotation`, `test_contact_details_that_need_an_external_update_are_reported`, `test_a_contact_alert_for_another_key_carries_that_key`), og éin ny test pinnar at nøkkelforma og programvareforma av same kode har kvar si melding. `tests/test_app.py` held ikkje på nokon meldingstekst.
|
|
||||||
|
|
||||||
**Dei andre tekststadene i appen (del 2 av same runde).** Gjennomgangen fann desse overflødige eller dupliserte tekstane; dei er tekne bort eller skrivne om:
|
|
||||||
|
|
||||||
- `static/index.html`: eyebrow-en «Multisig setup» dupliserte h2-en i same kort.
|
|
||||||
- `static/settings.html`: eyebrow-en «Settings» dupliserte h1-en, og dei to hjelpetekstane som begge byrja med «Removing an entry…» er slått saman til eitt avsnitt.
|
|
||||||
- `static/login.html`: h2-en «Sign in» dupliserte både h1-en og eyebrow-en «01 / Sign in»; `aria-labelledby` peikar no på eyebrow-en.
|
|
||||||
- `static/health-check.html`: hjelpelinja «A blocked key is marked in the list and cannot be selected.» dupliserte sperre-noten rett over, og den statiske `#software-help`-teksten vart overstyrt av skriptet før brukaren såg han. Begge er borte; elementet står att og blir fylla av `lockSoftwareFields()`.
|
|
||||||
- `static/setup.js` og `static/app.js`: lenkja til innstillingane heiter no «Open the settings» i begge. Topbaren held «Settings» som navigasjonslenkje.
|
|
||||||
- `static/app.js`: `setupDescription` gjentek ikkje lenger «This app records check results only — never keys or seed phrases.»; same bodskap står i introen og i side-notisen.
|
|
||||||
- `app.py`: sperre-svaret (`409`) seier ikkje lenger den interne koden. Det er no «This key has an open alert. Close the alert before recording a new check.»
|
|
||||||
- `validation.py`: «a configured cloud key already provides this wallet software name» er blitt «this name already comes from a configured cloud key».
|
|
||||||
- **Uendra etter kontroll:** `ACTION_LABELS` / `ACTION_CONFIRMATIONS` i dei tre kopiane (`static/app.js`, `static/health-check.js`, `static/history.js`) er identiske, og blir ikkje slått saman til ei ny delt fil — ho måtte inn i `STATIC_FILES` i `app.py` og i allow-lista i `static/sw.js`. `UNAVAILABLE_MESSAGE` i `health-check.js` står òg, sjølv om seksjonen han blir rendra i, er skjult for ein nøkkel som ikkje kan kontrollerast.
|
|
||||||
- **Testar:** `tests/test_health_check_form.py` held dei endra sidetekstane. `test_the_settings_page_has_the_two_sections` ventar no eyebrow-lista `["01 / Wallet software", "02 / Key rotation"]` og `<h1>Settings</h1>`; `test_form_marks_the_keys_that_an_open_alert_blocks` ventar at hjelpelinja er borte; og `test_the_settings_link_has_one_wording` held dei to lenkjetekstane like. Testane i `tests/test_app.py` held berre statuskoden, ikkje 409-teksten, og held difor uendra.
|
|
||||||
|
|
||||||
## 32.4 Bug-rapporten
|
|
||||||
|
|
||||||
- Arbeid gjennom `BUG-RAPPORT-AI-AGENT.md` (BR-001–BR-008): **verifiser kvart funn i koden først**, rett dei som blir stadfesta med små, målretta endringar, legg til regresjonstestar, og rapporter kva som var stadfesta, kva som var falske positive, og kva som ikkje kunne avgjerast.
|
|
||||||
- **Rapporten er skriven mot eit anna filsett enn dette repoet.** Han ber om `SECURITY.md`, `PRIVACY.md`, `THREATMODEL.md`, `PLATFORM-ACCESS.md`, `ENCRYPTION.md`, `OFFLINE.md`, `AI-STATUS.md` og `DATA-MODEL.md`, og ingen av dei finst her. BR-001, BR-004 og delar av BR-002 kviler på dei. Verifiser mot filene som faktisk ligg i repoet i staden, og meld frå om kva som fell bort av den grunn.
|
|
||||||
- **BR-001** (`P0 dersom stadfesta`) gjeld at kjeldefilene skulle mangle i repo-visinga. Dei ligg i `main` og er spora av Git, så han skal kunne lukkast som falsk positiv etter ein `git ls-tree -r --name-only HEAD`.
|
|
||||||
- **BR-002** er den tyngste: fritekstfelta (`name`, `model`, `comments` og notatfelta) kan lagre ei seed phrase eller ein privatnøkkel brukaren limer inn ved eit uhell. Ei realistisk lokal sperre mot dei vanlegaste wallet-format, i tillegg til ei åtvaring ved kvart fritekstfelt, er innanfor grensene i §2 og §15 — men ikkje send noko til ein ekstern teneste, og ikkje logg feltinnhald.
|
|
||||||
- **BR-005, BR-006, BR-007 og BR-008** krev ein verifikasjon først: autentisering og CSRF, CSV-formelinjeksjon, PWA-cachen og normaliseringa av adressestiar.
|
|
||||||
- Ikkje hev pakkeversjonen, ikkje byt ikonet, og ikkje legg til nye tenester eller infrastruktur som del av denne jobben.
|
|
||||||
|
|
||||||
**Utfall av runde 32-A (bug-triarge).** Kvar BR vart verifisert i koden som ligg i dette repoet før noko vart endra:
|
|
||||||
|
|
||||||
- **BR-001 — falsk positiv.** Kjeldefilene ligg i `main` og er spora av Git; rapporten bygde på repo-visinga, ikkje på ein checkout.
|
- **BR-001 — falsk positiv.** Kjeldefilene ligg i `main` og er spora av Git; rapporten bygde på repo-visinga, ikkje på ein checkout.
|
||||||
- **BR-002 — stadfesta, utsett.** Eit fritekstfelt kan framleis lagre ei løyndom brukaren limer inn ved eit uhell. Arbeidet høyrde til 32-B og vart ikkje starta i 32-A.
|
- **BR-002 — stadfesta og retta** i runde 32-B, sjå nedanfor.
|
||||||
- **BR-003 — stadfesta som formulering, men han kviler på ein tekst som ikkje finst.** Sjå «Det som står att i 32.4» nedanfor.
|
- **BR-003 — står att.** Sjå «Det som står att i 32.4» nedanfor.
|
||||||
- **BR-004 — fell bort.** `AI-STATUS.md` og `DATA-MODEL.md` finst ikkje i dette repoet. Koden følgjer alt kontrakten i §4–§7: statusane `SECURE`/`PATCHED`/`VULNERABLE`/`COMPROMISED`, tabellane `keys`, `health_checks`, `key_checks`, `ai_security_checks`, `wallet_software`, `alert_acknowledgements` og `app_settings`, og inga `tool_checks`. Den reelle dokdrifta er 32.6.
|
- **BR-004 — fell bort.** `AI-STATUS.md` og `DATA-MODEL.md` finst ikkje i dette repoet, og koden følgjer alt kontrakten i §4–§7. Den reelle dokdrifta er 32.6.
|
||||||
- **BR-005 — verifisert i koden, inga åtferdsendring.** Berre `GET /health`, `GET /api/session` og `/login` er opne; alle andre `/api/*` svarar `401` og sidene svarar `302` til `/login`; kvar tilstandsendrande POST krev ei gyldig økt og CSRF-tokenet (`403`). Passordet er ein `hashlib.scrypt`-hash med salt per passord, økta er ein HMAC-SHA256-signert cookie med utløp, og begge samanlikningane brukar `hmac.compare_digest`. Ingen `X-Forwarded-*`-header blir lesen. Det einaste som ikkje kan stadfestast her, er `Secure`-flagget mot den reelle StartOS-proxyen: flagget er medvite utelate fordi StartOS terminerer TLS og proxyar rein HTTP inn i containeren.
|
- **BR-005 — verifisert i koden, inga åtferdsendring.** Berre `GET /health`, `GET /api/session` og `/login` er opne; alle andre `/api/*` svarar `401` og sidene `302` til `/login`; kvar tilstandsendrande POST krev økt og CSRF-token (`403`). Passordet er ein `hashlib.scrypt`-hash med salt per passord, økta ein HMAC-SHA256-signert cookie med utløp, og begge samanlikningane brukar `hmac.compare_digest`. `Secure`-flagget er medvite utelate, fordi StartOS terminerer TLS og proxyar rein HTTP inn i containeren.
|
||||||
- **BR-006 — stadfesta og retta i `export.py`.** Kvar tekstcelle som byrjar med `=`, `+`, `-`, `@` eller eit kontrollteikn — òg etter leiande mellomrom — blir no prefiksa med ein apostrof. Kolonnenamna, kolonnerekkjefølgja og vanlege verdiar er uendra.
|
- **BR-006 — retta i `export.py`.** Ei tekstcelle som byrjar med `=`, `+`, `-`, `@` eller eit kontrollteikn — òg etter leiande mellomrom — blir prefiksa med ein apostrof (§10).
|
||||||
- **BR-007 — stadfesta og retta i `static/sw.js`.** Tenestearbeidaren lagrar no eit svar berre når det er vellukka, same-opphav og ikkje omdirigert, så loginsida kan ikkje lenger erstatta det cacha app-skalet.
|
- **BR-007 — retta i `static/sw.js`.** Tenestearbeidaren lagrar no eit svar berre når det er vellukka, same-opphav og ikkje omdirigert (§12).
|
||||||
- **BR-008 — stadfesta og retta i `validation.py`.** Samanlikninga av adressestiar fellar no den harda markøren (`h`/`H` ≡ `'`) i tillegg til store/små bokstavar og luft, så same derivasjonssti i to skrivemåtar blir avvist som duplikat i oppsettet, i innstillingane og ved rotering — og blir rekna som nøkkelen sin eigen sti i kontrollen. Den lagra verdien blir aldri skriven om.
|
- **BR-008 — retta i `validation.py`.** Samanlikninga av adressestiar fellar no òg den harda markøren (`h`/`H` ≡ `'`), i oppsettet, i innstillingane, ved rotering og i kontrollen. Den lagra verdien blir aldri skriven om (§4).
|
||||||
|
|
||||||
**Nye bindande reglar frå 32-A:** (dei står òg i §4, §10 og §11)
|
**Runde 32-B.** `secret_guard.py` avviser eit wallet-løyndom i kvart fritekstfelt med `400`, før noko blir lagra og før lengdegrensa til feltet; `auth.py` gjer det same for adminbrukarnamnet, men ikkje for passordet. Meldinga namngjev feltet og forma og gjentek aldri verdien. Sjekken er lokal og gjer ingen nettverkskall. Ordlista, mønstra og dei kjende avgrensingane står i modulens docstring. Reglane står òg i §2, §12 og §15.
|
||||||
|
|
||||||
- **Eksporten nøytraliserer formelceller.** Ei tekstcelle som eit rekneark ville lese som ein formel, får ein leiande apostrof. Kolonnenamna, kolonnerekkjefølgja og formatavtalen elles står fast.
|
**Testar:** ti i runde 32-A og 43 i den nye `tests/test_secret_guard.py` i runde 32-B. Suiten gjekk frå 422 til **484 testar**, og vidare til 498 etter etterrunden av §32.1 og §32.2.
|
||||||
- **Adressestien blir samanlikna kanonisk.** Same derivasjonssti i kvar av dei støtta skrivemåtane er den same stien, både for unikheit og for samanlikninga i kontrollen.
|
|
||||||
- **PWA-cachen lagrar berre eit gyldig skal-svar.** Eit svar som ikkje er vellukka, ikkje er same-opphav eller er omdirigert, blir ikkje cacha.
|
|
||||||
|
|
||||||
**Utfall av runde 32-B (BR-002).** Sperra mot wallet-løyndomar i fritekst er no på plass:
|
**Det som står att i 32.4:** berre **BR-003**, og han må lesast rett. Rapporten siterer ein §31-tekst om at den manuelle gjennomgangen står att, men den teksten finst ikkje lenger, og §16 og §17 seier at dei manuelle nettlesartestane og bokstestane vart køyrde og verifiserte fram til §31. Det som faktisk står att, er difor dei **nye** manuelle punkta §32 legg til — ikonet, UI-pussen og retro-temaet på ein smal telefon, ein kikk på varsellista, nøkkelkortet og sperre-noten etter tekstendringane, menyen og det rydda dashbordet, og eksportseksjonen på history-sida — saman med heile bokstesten på nytt etter §32.5, og ei stadfesting frå brukaren på at dei er køyrde. Ikkje re-verifiser det §16 og §17 alt har som gjort.
|
||||||
|
|
||||||
- **Ny modul `secret_guard.py`.** Han held den engelske BIP39-ordlista (2048 ord, bakt inn lokalt — appen gjer framleis ingen nettverkskall) og ein `find_secret()` som kjenner att eit PEM-privatnøkkelblock, ein utvida privatnøkkel (`xprv`/`yprv`/`zprv`/`tprv`/`uprv`/`vprv`), ein WIF-nøkkel (51 eller 52 teikn), ein BIP38-nøkkel og eit ordløp på 12 eller fleire BIP39-ord. Funksjonen gjev berre ei kort engelsk nemning attende, aldri teksten, så ingenting hamnar i ein logg eller ein feilmelding.
|
|
||||||
- **`validation.py` avviser slikt innhald i kvart fritekstfelt.** Sjekken sit i dei fire teksthjelparane (`_text`, `_key_name`, `_model`, `_required_path`), så kvart fritekstfelt er dekt av konstruksjon: nøkkelnamn, modell, wallet-programvarenamn, programvareversjon, firmware-versjon, notatfelta og KI-kommentarane. Han kastar `SecretDetected`, som er ein `ValidationError`, så svaret blir `400` og ikkje `500`. Valideringa køyrer før noko blir skrive, så eit avvist innhald blir aldri lagra delvis.
|
|
||||||
- **Sjekken køyrer òg før lengdegrensa til feltet.** Eit innlimt løyndom blir difor svara med kva det ser ut som, ikkje med «too long» — som elles ville bedt brukaren om å korte ned eit seed phrase i staden for å fjerne det. Lengdegrensa står framleis som ytre grense og gjeld for alt annet. Rekkjefølgja er medvite vald og festa i testar, både for eit løyndom som passar i feltet og eit som ikkje gjer det.
|
|
||||||
- **`auth.py` avviser òg eit adminbrukarnamn som ser ut som ei løyndom**, med same rekkjefølgje. Passordet blir medvite ikkje sjekka, sidan ein lang passfrase er eit legitimt passord og ei avvising der ville stengje brukaren ute frå sin eigen konto.
|
|
||||||
- **Meldinga gjentek aldri verdien.** Ho namngjev feltet og forma som vart kjend att, og seier at ingenting vart lagra.
|
|
||||||
- **Åtvaring ved felta i UI-et.** Runde 32-B la inn ei kort linje i same ambra-palett som sidenotisen, i `static/health-check.html`, `static/health-check.js`, `static/setup.html`, `static/setup.js` og `static/settings.js`, med stilen `.secret-warning` i `static/styles.css`. **32.2 endra dette:** åtvaringa står no éin gong, i nøkkeloppsettet, og er elles fjerna (§2, §12 og §15). Sidenotisen om løyndomar står framleis, og sideoverskriftene er uendra.
|
|
||||||
- **Kjende avgrensingar** står i modulens docstring og blir ikkje tona ned: eit nakent 64-teikns heksadesimalt streng blir ikkje avvist (det kan like gjerne vere ein transaksjons-id, som er legitimt notatinnhald), berre den engelske ordlista blir brukt, og eit format utanom mønstra eller ei løyndom som er delt over fleire felt, blir ikkje fanga.
|
|
||||||
|
|
||||||
**Nye bindande reglar frå 32-B:** (dei står òg i §2, §12 og §15)
|
|
||||||
|
|
||||||
- **Fritekst blir sjekka lokalt før lagring, og før lengdegrensa til feltet.** Eit felt som ser ut som ei wallet-løyndom, blir avvist med `400` og med kva det ser ut som, ingenting blir lagra, og meldinga gjentek aldri verdien. Sjekken er lokal og gjer ingen nettverkskall.
|
|
||||||
- **Den korte åtvaringa ved feltet er éin, i nøkkeloppsettet**, med stilen `.secret-warning`. Ho blir ikkje gjenteken per fritekstfelt. *(Endra i §32.2 punkt 2 og 10; serveren avviser framleis eit løyndom i kvart fritekstfelt.)*
|
|
||||||
|
|
||||||
**Testar lagde til:** ti i runde 32-A (fem i `tests/test_export.py`, ein i `tests/test_pwa.py` og fire i `tests/test_validation.py`) og 43 i runde 32-B, alle i den nye `tests/test_secret_guard.py` (5 ordlistetestar, 10 gjenkjenningstestar, 17 feltnivåtestar, 6 åtvaringstestar og 5 API-testar). Runde 32.3 la til éin test i `tests/test_alerts.py` og éin i `tests/test_health_check_form.py`, og runde 32.2 la til sju. Suiten gjekk frå 422 til **484 testar**. Etterrunden av 32.1 og 32.2 la til ti, og PNG-ikona fire til, så han står på **498 testar**.
|
|
||||||
|
|
||||||
**Det som står att i 32.4:** berre **BR-003**, og han må lesast rett. Rapporten vart skriven mot eit anna filsett og siterer ein §31-tekst om at den manuelle gjennomgangen står att, men den teksten finst ikkje lenger, og §16 og §17 seier at dei manuelle nettlesartestane og bokstestane vart køyrde og verifiserte fram til §31. Det som faktisk står att, er difor dei **nye** manuelle punkta §32 legg til — ikonet (32.1), UI-pussen og retro-temaet på ein smal telefon (32.2), ein kikk på varsellista, nøkkelkortet og sperre-noten etter tekstendringane (32.3), menyen og det rydda dashbordet (32.7), og heile bokstesten på nytt etter endringane (32.5) — saman med dei nye punkta i etterrunden av 32.1 og 32.2, og ei stadfesting frå brukaren på at dei er køyrde. Alt anna i rapporten er avgjort: BR-001 er ein falsk positiv, BR-004 fell bort, BR-005 er verifisert utan åtferdsendring, og BR-002, BR-006, BR-007 og BR-008 er retta med regresjonstestar. To manuelle punkt under 32-B er alt stadfesta av brukaren: at eit seed phrase blir stoppa i namnefeltet og i adressestifeltet, og at åtvaringa ved felta er lesleg på ein telefon.
|
|
||||||
|
|
||||||
## 32.5 Hevinga av pakkeversjonen
|
## 32.5 Hevinga av pakkeversjonen
|
||||||
|
|
||||||
@@ -643,28 +593,26 @@ Dokumenta som skildrar pakka og appen, er skrivne før §31 og før 32-A, 32-B o
|
|||||||
|
|
||||||
Ikkje bygg om overskriftstrukturen i `README.md` (han følgjer rettleiinga), og ikkje legg til nye dokument. Dei åtte filene bug-rapporten nemner (`SECURITY.md`, `PRIVACY.md`, `THREATMODEL.md`, `PLATFORM-ACCESS.md`, `ENCRYPTION.md`, `OFFLINE.md`, `AI-STATUS.md`, `DATA-MODEL.md`) skal **ikkje** opprettast. Dokumenta i repoet er `README.md`, `docs/application.md`, `instructions.md`, `UPDATING.md`, `AGENTS.md` og `TODO.md`.
|
Ikkje bygg om overskriftstrukturen i `README.md` (han følgjer rettleiinga), og ikkje legg til nye dokument. Dei åtte filene bug-rapporten nemner (`SECURITY.md`, `PRIVACY.md`, `THREATMODEL.md`, `PLATFORM-ACCESS.md`, `ENCRYPTION.md`, `OFFLINE.md`, `AI-STATUS.md`, `DATA-MODEL.md`) skal **ikkje** opprettast. Dokumenta i repoet er `README.md`, `docs/application.md`, `instructions.md`, `UPDATING.md`, `AGENTS.md` og `TODO.md`.
|
||||||
|
|
||||||
## 32.7 Dashboard-menyen og oppryddinga i dashbordet
|
## 32.7 Dashboard-menyen og oppryddinga i dashbordet — utført
|
||||||
|
|
||||||
**Utført.** Seks punkt. Inga skjemaendring, ingen nye endepunkt, ingen nye funksjonar, ingen nye dokument, og `static/robots.txt` er den einaste nye fila. Runden vart utførd **før** 32.6 og 32.5, og §8, §9 og §12 skildrar no den nye sanninga, sidan §1–§18 skildrar appen slik han er no.
|
Seks punkt, inga skjemaendring, ingen nye endepunkt, ingen nye funksjonar, og `static/robots.txt` var den einaste nye fila. Runden vart utførd **før** 32.6 og 32.5, og §8, §9 og §12 skildrar no den nye sanninga, sidan §1–§18 skildrar appen slik han er no.
|
||||||
|
|
||||||
- **1. Meny i topplinja i staden for «Sign out».** `static/session.js` byggjer ein `Menu`-knapp med nedtrekk i staden for «Sign out»-knappen, på alle fem app-sidene (`/login` har framleis ingen, sidan `session.js` ikkje blir lasta der). Vala, i denne rekkjefølgja: `Start health check` → `/health-check`, `Settings` → `/settings`, `History` → `/history`, så ein skiljelinje, og til slutt `Sign out`, som gjer det same som i dag (`POST /api/logout` gjennom den pakka `fetch`-en i `session.js`, deretter `/login`). `Sign out` er ein `<button type="button">`, dei tre andre er `<a>`. Panelet er skjult som standard og blir opna og lukka ved klikk, med `aria-haspopup`, `aria-expanded` og `aria-controls`, og det blir lukka på `Escape`, ved klikk utanfor og etter eit val. `session.js` held fram med å lage `.topbar-actions`-innpakninga si sjølv, så alle sidene ser like ut utan at markupen må endrast. **Fjerna frå `static/index.html`:** `<a class="primary-button active-button" href="/health-check">Start annual health check</a>` i `.page-heading` og heile `<div class="topbar-actions">` med `Settings`-lenkja. **Behalde:** lenkja til `/` i sperre-noten i `health-check.html`, «Open the settings» i `setup.js`, `/settings`-lenkjene i `app.js` (`createRotateLink` og `createRemoveSoftwareControl`) og «Open the alert list» på nøkkelkortet — dei er kontekstlenkjer, ikkje navigasjon. Nye klassar i `static/styles.css` (`.menu`, `.menu-button`, `.menu-panel`, `.menu-item`, `.menu-separator`), i retro-temaet og utan inline stil, fordi CSP-en er `default-src 'self'`.
|
1. **Meny i topplinja i staden for «Sign out».** `static/session.js` byggjer ein `Menu`-knapp med nedtrekk på alle fem app-sidene (`/login` har framleis ingen). Vala, i denne rekkjefølgja: `Start health check` → `/health-check`, `Settings` → `/settings`, `History` → `/history`, så ein skiljelinje, og til slutt `Sign out`, som gjer det same som før (`POST /api/logout` gjennom den pakka `fetch`-en, deretter `/login`). `Sign out` er ein `<button type="button">`, dei tre andre er `<a>`. Panelet er skjult som standard og blir opna og lukka ved klikk, med `aria-haspopup`, `aria-expanded` og `aria-controls`, og det blir lukka på `Escape`, ved klikk utanfor og etter eit val. `session.js` held fram med å lage `.topbar-actions`-innpakninga si sjølv. **Fjerna frå `static/index.html`:** `<a class="primary-button active-button" href="/health-check">Start annual health check</a>` i `.page-heading` og heile `<div class="topbar-actions">` med `Settings`-lenkja. **Behalde:** lenkja til `/` i sperre-noten i `health-check.html`, «Open the settings» i `setup.js`, `/settings`-lenkjene i `app.js` og «Open the alert list» på nøkkelkortet — dei er kontekstlenkjer, ikkje navigasjon. Nye klassar i `static/styles.css` (`.menu`, `.menu-button`, `.menu-panel`, `.menu-item`, `.menu-separator`), i retro-temaet og utan inline stil, fordi CSP-en er `default-src 'self'`.
|
||||||
- **2. «Configured setup / Your keys» og nøkkelteljaren bort.** I `static/index.html` blir `section.section-block` som ber eyebrow-en `Configured setup`, `h2` «Your keys» og `span#key-count`, sletta, og `<div class="key-grid" id="key-list">` flytt til å stå rett etter `<p class="intro" id="setup-shape">`, inne i den same `section.page-heading`. `aria-labelledby="keys-title"` fell bort med overskrifta. I `static/app.js` blir `const keyCount` og båe skrivingane til han sletta (`"Unavailable"` i feilgreina og teljinga i `renderKeyCards()`), så ingen `querySelector` peikar på eit element som ikkje finst.
|
2. **«Configured setup / Your keys» og nøkkelteljaren bort.** `section.section-block` som bar eyebrow-en `Configured setup`, `h2` «Your keys» og `span#key-count` er sletta frå `static/index.html`, og `<div class="key-grid" id="key-list">` står no rett etter `<p class="intro" id="setup-shape">`, inne i den same `section.page-heading`. `aria-labelledby="keys-title"` fell bort. I `static/app.js` er `const keyCount` og båe skrivingane til han sletta, så ingen `querySelector` peikar på eit element som ikkje finst.
|
||||||
- **3. «Next check»-kortet bort, tidlegaste forfall inn i «Attention».** `.info-card`-et med `#next-check-title` og `#next-check-detail` blir sletta, og «Attention»-kortet står att åleine og skal spenne heile innhaldsbreidda på alle breiddder; `.overview-grid` og medie-spørringa blir rydda slik at det stemmer. `nextCheckTitle` og `nextCheckDetail` i `static/app.js` fell bort, og `renderSummary()` styrer berre «Attention»: overskrifta er uendra (`Nothing overdue` / `1 key overdue` / `N keys overdue`), detaljlinja er den forfalne lista som i dag når noko er forfalle, og elles `Earliest next check <YYYY-MM-DD>, for Key N: <namn>.` i staden for `No key has passed its next check date.` Har ingen nøkkel ein `next_check_due`, står den eksisterande fallbacken `No key has a next check date yet. Save a health check to schedule one.`
|
3. **«Next check»-kortet bort, tidlegaste forfall inn i «Attention».** `.info-card`-et med `#next-check-title` og `#next-check-detail` er sletta, og «Attention»-kortet står att åleine og spenner heile innhaldsbreidda; `.overview-grid` er éin kolonne på alle breiddder. `nextCheckTitle` og `nextCheckDetail` er borte frå `static/app.js`, og `renderSummary()` styrer berre «Attention»: overskrifta er uendra (`Nothing overdue` / `1 key overdue` / `N keys overdue`), detaljlinja er den forfalne lista når noko er forfalle, og elles `Earliest next check <YYYY-MM-DD>, for Key N: <namn>.` Har ingen nøkkel ein `next_check_due`, står fallbacken `No key has a next check date yet. Save a health check to schedule one.`
|
||||||
- **4. Tomt varsel-område utan plasshaldartekst.** I `renderAlerts()` i `static/app.js` blir `#alerts-list` tømd utan tekst når det ikkje finst varsel, medan `alertCount` held fram med `No alerts`. `aria-live="polite"`-regionen, plasshaldaren i markupen og feilgreina (offline / «could not be loaded») står uendra.
|
4. **Tomt varsel-område utan plasshaldartekst.** `renderAlerts()` i `static/app.js` tømmer `#alerts-list` utan tekst når det ikkje finst varsel, medan `alertCount` held fram med `No alerts`. `aria-live="polite"`-regionen, plasshaldaren i markupen og feilgreina står uendra.
|
||||||
- **5. History-blokka bort frå dashbordet, `Download CSV` til history-sida.** `section.history-card` i `static/index.html` (eyebrow `Previous checks`, `h2` «History», `Open history` og `Download CSV`) blir sletta. I `static/history.html` kjem `<a class="secondary-button" href="/api/export">Download CSV</a>`, **utan** `download`-attributt, så filnamnet frå `Content-Disposition` vinn. Den daude `history-card`-delen av selektoren i `static/styles.css` blir fjerna.
|
5. **History-blokka bort frå dashbordet, `Download CSV` til history-sida.** `section.history-card` i `static/index.html` er sletta. I `static/history.html` kom `<a class="secondary-button" href="/api/export">Download CSV</a>`, **utan** `download`-attributt, så filnamnet frå `Content-Disposition` vinn. Den daude `history-card`-delen av selektoren i `static/styles.css` er fjerna.
|
||||||
- **6. Ingen indeksering, ingen bots.** Ny `static/robots.txt` med `User-agent: *` og `Disallow: /`, lagt inn i `STATIC_FILES` i `app.py` som `text/plain; charset=utf-8` (ei fil som ikkje står der, svarar `404`), men **ikkje** i `SHELL`-lista i `static/sw.js`. `X-Robots-Tag: noindex, nofollow` blir lagd i `_send_security_headers()` i `app.py`, så sider, JSON, redirect, CSV og statiske filer er dekte i éin stad. Alle seks sidene i `static/` får `<meta name="robots" content="noindex, nofollow">` i `<head>`.
|
6. **Ingen indeksering, ingen bots.** Ny `static/robots.txt` med `User-agent: *` og `Disallow: /`, lagt inn i `STATIC_FILES` i `app.py` som `text/plain; charset=utf-8` (ei fil som ikkje står der, svarar `404`), men **ikkje** i `SHELL`-lista i `static/sw.js`. `X-Robots-Tag: noindex, nofollow` blir lagd i `_send_security_headers()` i `app.py`, så sider, JSON, redirect, CSV og statiske filer er dekte i éin stad. Alle seks sidene i `static/` fekk `<meta name="robots" content="noindex, nofollow">` i `<head>`.
|
||||||
|
|
||||||
**Bindingar:** engelsk UI-tekst og engelske kommentarar; CSP-en `default-src 'self'; style-src 'self'; script-src 'self'` tillèt ikkje inline skript eller inline stil; retro-temaet i §32.2 tillèt ingen `border-radius` utanom `0`, ingen `box-shadow` og ingen gradient. `alerts.py`, `validation.py`, `secret_guard.py`, `auth.py`, `database.py`, `export.py`, `maintenance.py`, ikonet, manifestet, `sw.js`, `startos/` og pakkeversjonen blir ikkje rørde.
|
**Bindingar:** engelsk UI-tekst og engelske kommentarar; CSP-en `default-src 'self'; style-src 'self'; script-src 'self'` tillèt ikkje inline skript eller inline stil; retro-temaet i §32.2 tillèt ingen `border-radius` utanom `0`, ingen `box-shadow` og ingen gradient. `alerts.py`, `validation.py`, `secret_guard.py`, `auth.py`, `database.py`, `export.py`, `maintenance.py`, ikonet, manifestet, `sw.js`, `startos/` og pakkeversjonen er ikkje rørde.
|
||||||
|
|
||||||
**Testar:** kvar streng og kvar selektor som vart fjerna eller omdøypt, vart greppa i `tests/` først, og ingen påstand vart sletta utan å bli erstatta av ein som pinnar den nye åtferda. Tretten nye testar pinnar menyen, at dashbordet ikkje har dei fjerna elementa, earliest-linja i «Attention», den tome varsellista, `Download CSV`-lenkja på history-sida utan `download`, robots-metaen på alle seks sidene, `/robots.txt`, og `X-Robots-Tag`-headeren. Brukaren køyrer `python3 -m unittest discover -s tests` og oppgjev talet før og etter; suiten går frå 498 til **511 testar**.
|
**Testar:** kvar streng og kvar selektor som vart fjerna eller omdøypt, vart greppa i `tests/` først, og ingen påstand vart sletta utan å bli erstatta av ein som pinnar den nye åtferda. Tretten nye testar pinnar menyen, at dashbordet ikkje har dei fjerna elementa, earliest-linja i «Attention», den tome varsellista, `Download CSV`-lenkja på history-sida utan `download`, robots-metaen på alle seks sidene, `/robots.txt`, og `X-Robots-Tag`-headeren. Suiten gjekk frå 498 til **511 testar**.
|
||||||
|
|
||||||
**Etterrunden (fire punkt frå brukaren sin gjennomgang).** Utført, utan skjemaendring, utan nye endepunkt og utan nye dokument:
|
Etterrunden (fire punkt frå brukaren sin gjennomgang), utan skjemaendring, utan nye endepunkt og utan nye dokument:
|
||||||
|
|
||||||
- **1. Eksport-noten flytt til history-sida, og knappen fekk luft.** `p#workflow-note` er fjerna frå `static/index.html` og står no i `static/history.html`, rett under `Download CSV`-lenkja. Ordlyden er skriven om frå «The history page exports every saved key check…» til «Download CSV exports every saved key check, one row per key check, as a dated file.», sidan noten no står på den sida ho forklarer. `static/styles.css` har fått `.page-heading > .secondary-button { margin-top: 12px; }`, så knappen ikkje rører linja over seg.
|
1. **Eksport-noten flytt til history-sida.** `p#workflow-note` vart fjerna frå `static/index.html` og stod no i `static/history.html`, rett under `Download CSV`-lenkja, med ny ordlyd: «Download CSV exports every saved key check, one row per key check, as a dated file.» `static/styles.css` fekk `.page-heading > .secondary-button { margin-top: 12px; }`, så knappen ikkje rører linja over seg.
|
||||||
- **2. Menyen: `Dashboard` fyrst, og sida ein står på er gråa ut.** `MENU_ITEMS` i `static/session.js` har no fire oppføringar: `Dashboard` → `/`, `Start health check` → `/health-check`, `Settings` → `/settings`, `History` → `/history`. Sida brukaren alt står på blir rendra som eit `<span class="menu-item menu-item-current">` med `aria-current="page"` i staden for ein `<a>`, så ho kan ikkje klikkast og sida blir ikkje lasta på nytt. Samanlikninga normaliserer stien (`/health-check/` ≡ `/health-check`, rota blir `/`). `.menu-item-current` er grå (`var(--line)`) med `cursor: default`, og hover-/fokus-regelen er avgrensa med `:not(.menu-item-current)`.
|
2. **Menyen: `Dashboard` fyrst, og sida ein står på er gråa ut.** `MENU_ITEMS` i `static/session.js` har fire oppføringar: `Dashboard` → `/`, `Start health check` → `/health-check`, `Settings` → `/settings`, `History` → `/history`. Sida brukaren alt står på blir rendra som eit `<span class="menu-item menu-item-current">` med `aria-current="page"` i staden for ein `<a>`, så ho kan ikkje klikkast og sida blir ikkje lasta på nytt. Samanlikninga normaliserer stien (`/health-check/` ≡ `/health-check`, rota blir `/`). `.menu-item-current` er grå (`var(--line)`) med `cursor: default`, og hover-/fokus-regelen er avgrensa med `:not(.menu-item-current)`.
|
||||||
- **3. Ankeret `#history-detail` på history-sida.** `View`-lenkja i `history.js` peikar no på `/history?id=<id>#history-detail`, og `health-check.js` sender brukaren til `/history?id=<ny id>#history-detail` etter lagring. Sidan detaljen er skjult til ein kontroll blir opna, og eit skjult element ikkje har nokon boks å rulle til, avdekkjer den nye `revealDetail()` seksjonen først og kallar `scrollIntoView({ behavior: "smooth", block: "start" })` etterpå.
|
3. **Ankeret `#history-detail`.** `View`-lenkja i `history.js` peikar no på `/history?id=<id>#history-detail`, og `health-check.js` sender brukaren til `/history?id=<ny id>#history-detail` etter lagring. Sidan detaljen er skjult til ein kontroll blir opna, og eit skjult element ikkje har nokon boks å rulle til, avdekkjer den nye `revealDetail()` seksjonen først og kallar `scrollIntoView({ behavior: "smooth", block: "start" })` etterpå.
|
||||||
- **4. Eksporten fekk ein eigen seksjon, og `id="workflow-note"` er borte.** `Download CSV`-lenkja står ikkje lenger laus i `.page-heading`; ho har ein eigen `section.section-block` i `static/history.html`, mellom lista og detaljseksjonen, med eyebrow-en `Export`, tittellinja `<h2 id="export-title">Download the report</h2>`, lenkja og noten rett under henne. Noten har framleis klassen `workflow-note` men ingen `id`, og ordlyden er «Every saved key check is exported, one row per key check, as a dated CSV file.». Sidan lenkja ikkje lenger står i sideoverskrifta, er CSS-regelen `.page-heading > .secondary-button` fjerna som daud.
|
4. **Eksporten fekk ein eigen seksjon, og `id="workflow-note"` er borte.** `Download CSV`-lenkja står ikkje lenger laus i `.page-heading`; ho har ein eigen `section.section-block` i `static/history.html`, mellom lista og detaljseksjonen, med eyebrow-en `Export`, tittellinja `<h2 id="export-title">Download the report</h2>`, lenkja og noten rett under henne. Noten har framleis klassen `workflow-note` men ingen `id`, og ordlyden er «Every saved key check is exported, one row per key check, as a dated CSV file.». Sidan lenkja ikkje lenger står i sideoverskrifta, er CSS-regelen `.page-heading > .secondary-button` fjerna som daud.
|
||||||
|
|
||||||
**Testar i etterrunden:** to testar er omdøypte og utvida i staden for sletta — `test_the_top_bar_menu_offers_the_three_pages_and_sign_out` → `test_the_top_bar_menu_lists_the_dashboard_and_the_pages`, og `test_the_history_page_offers_the_export` → `test_the_history_page_offers_the_export_and_the_note` → `test_the_history_page_offers_the_export_in_its_own_section`. To nye kom til: `test_the_menu_marks_the_page_you_are_on_and_greys_it_out` og `test_the_history_links_to_the_detail_section`. I tillegg pinnar `test_the_dashboard_has_no_next_check_card_and_no_history_block` no `<p class="eyebrow">Next check</p>` i staden for den bare frasen `Next check`, fordi ein bar delstreng òg fangar ein HTML-kommentar. Suiten går difor frå 511 til **513 testar**, og talet står framleis på 513 etter det siste punktet, sidan det berre døypte om ein test.
|
**Testar i etterrunden:** to testar er omdøypte og utvida i staden for sletta — `test_the_top_bar_menu_offers_the_three_pages_and_sign_out` → `test_the_top_bar_menu_lists_the_dashboard_and_the_pages`, og `test_the_history_page_offers_the_export` → `test_the_history_page_offers_the_export_and_the_note` → `test_the_history_page_offers_the_export_in_its_own_section`. To nye kom til: `test_the_menu_marks_the_page_you_are_on_and_greys_it_out` og `test_the_history_links_to_the_detail_section`. I tillegg pinnar `test_the_dashboard_has_no_next_check_card_and_no_history_block` no `<p class="eyebrow">Next check</p>` i staden for den bare frasen `Next check`, fordi ein bar delstreng òg fangar ein HTML-kommentar. Suiten går frå 511 til **513 testar**, og talet står framleis på 513 etter det siste punktet, sidan det berre døypte om ein test.
|
||||||
|
|
||||||
**Etter runden:** `[ ]` vart fjerna frå kvart punkt, sidan eit punkt utan avkryssingsboks er det som gjeld i dette dokumentet. Testtalet i «Status» øvst og i §32-statusen er oppdatert, §8, §9 og §12 er skrivne om til den nye sanninga, det nye bindande punktet om robots står under «Reglar som gjeld alle rundar», og `ai-note.md` er oppdatert med det same og med dei nye fellene.
|
|
||||||
Reference in new issue
Block a user