TODO: rename the app to VardKey (section 29) and add the StartOS package plan (section 30)
This commit is contained in:
1 parent
4c23120fa3
commit
f7f1e41031
1 file changed
+46
-5
@@ -1,4 +1,4 @@
|
||||
# TODO — Helsesjekk for StartOS 0.4.0
|
||||
# TODO — VardKey for StartOS 0.4.0
|
||||
|
||||
## Mål
|
||||
|
||||
@@ -13,7 +13,7 @@ Appen skal **berre registrere resultat og historikk**. Han skal ikkje signere Bi
|
||||
- §1–§18 er kravspecen og gjeld som han står.
|
||||
- §19–§28 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–§28 er implementerte og verifiserte, skjema versjon 11, testsuiten er grøn (345 testar). §18 steg 9–12 (StartOS) er **ikkje starta**.
|
||||
- **Status:** §1–§28 er implementerte og verifiserte, skjema versjon 11, testsuiten er grøn (345 testar). §29 og §30 er vedtekne og **ikkje starta**; §29 (namnebytet) blir gjord fyrst. §18 steg 9–12 (StartOS) høyrer til §30.
|
||||
|
||||
## Språkkrav
|
||||
|
||||
@@ -295,7 +295,7 @@ Bygg appen som éin enkel StartOS-service.
|
||||
|
||||
```text
|
||||
StartOS 0.4.0
|
||||
└── Helsesjekk
|
||||
└── VardKey
|
||||
├── Web UI
|
||||
├── Backend/API
|
||||
├── SQLite
|
||||
@@ -404,7 +404,7 @@ Utfør oppgåvene i denne rekkjefølgja og ikkje hopp fram til avanserte funksjo
|
||||
- [ ] 11. Test restart og restore.
|
||||
- [ ] 12. Bygg endeleg `.s9pk` og gjer første release.
|
||||
|
||||
**Merk:** §23–§28 kom inn etter steg 8 og er implementerte og verifiserte. Steg 9–12 er ikkje starta.
|
||||
**Merk:** §23–§28 kom inn etter steg 8 og er implementerte og verifiserte. Steg 9–12 er ikkje starta, og høyrer til §30.
|
||||
|
||||
**Testar:** køyr `python3 -m unittest discover -s tests`. Suiten skal vere grøn både på Linux og på Windows-kopien.
|
||||
|
||||
@@ -416,7 +416,7 @@ Utfør oppgåvene i denne rekkjefølgja og ikkje hopp fram til avanserte funksjo
|
||||
|
||||
- **§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.
|
||||
- **§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.
|
||||
- **§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. Etter §29 er `TODO.md` det einaste norske dokumentet i repoet; korkje produktnamnet eller databasefila er lenger unntak frå engelskregelen.
|
||||
- **§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.
|
||||
|
||||
---
|
||||
@@ -475,6 +475,47 @@ Typen er ein del av identiteten til nøkkelen, saman med adressestien, så oppse
|
||||
- Ei rotering krev at nøkkelen blir markert med `Rotate this key` **og** at stadfestingsboksen «I confirm that each selected key has been replaced by a new key or hardware wallet» blir huka av. Då blir typen, den nye stien og namnet lagra gjennom roteringsendepunktet.
|
||||
- Knappen heiter `Save keys`, sidan han lagrar både namnebyte og roteringar i éin omgang, og han seier ifrå når det ikkje finst noko å lagre.
|
||||
|
||||
---
|
||||
|
||||
# 29. Namnebyte til VardKey (vedteke, ikkje implementert)
|
||||
|
||||
Avtalt 10.10.2026. Skjema versjon 11 står uendra; dette er eit reint namnebyte utan åtferdsendring.
|
||||
|
||||
Appen heiter **VardKey**, med beskrivinga **Bitcoin Multisig Health Monitor**. Etter bytet er `TODO.md` det einaste norske dokumentet i repoet: korkje produktnamnet eller databasefila er lenger unntak frå engelskregelen.
|
||||
|
||||
- **Databasen.** Standardstien blir `data/vardkey.sqlite3` i `app.py` og i alle funksjonsdefaultane i `database.py`. Det blir **ikkje** skriven migrering: den gamle testdatabasen blir kasta og oppsettet konfigurert på nytt, slik README alt seier for ei eldre testdatabase.
|
||||
- **Eksportfila.** `EXPORT_FILENAME` i `app.py` og `download`-attributtet i `static/index.html` blir `vardkey-export.csv`, og `tests/test_app.py` sjekkar det nye namnet. Dei to stadene må byte i takt, elles lovar grensesnittet eitt namn og serveren eit anna.
|
||||
- **Produktnamnet i grensesnittet.** `<title>`, brand-teksten, `aria-label`, `brand-mark` (`H` → `V`) og footeren i alle fem HTML-filene, og intro-meininga i `health-check.html`.
|
||||
- **Beskrivinga.** «Bitcoin Multisig Health Monitor» blir vist i README, i StartOS-manifestet (§30) og som éi linje under tittelen på dashboardet. Ho blir **ikkje** lagd inn som `<p class="eyebrow">` i `health-check.html` eller `settings.html`: testane samanliknar eyebrow-lista på dei to sidene eksakt.
|
||||
- **Repoet byter ikkje namn.** Gitea-repoet og prosjekt-id-en held fram som `ai-bot/helsesjekk`. Ei seinare omdøyping i Gitea-UI rører ingen kode, men `REPOSITORIES_JSON` må då oppdaterast.
|
||||
- **README.md** held strukturen sin. Berre namna, stiane, eksportfila og unntaksavsnittet i «Development» blir endra. Unntaksavsnittet må formulerast på nytt, sidan det ikkje finst namn-unntak att.
|
||||
- **Inga åtferdsendring, ingen nye funksjonar, ingen skjemaendring.** Testsuiten skal framleis vere grøn, med éin ny test som sjekkar at dashboardet viser namnet og beskrivinga.
|
||||
- **Filer, i rekkjefølgja dei skal gjerast ferdige:** `app.py`, `database.py`, `static/index.html`, `static/styles.css`, `static/setup.html`, `static/settings.html`, `static/history.html`, `static/health-check.html`, `tests/test_app.py`, `README.md`. `TODO.md` og `ai-note.md` er alt oppdaterte og skal ikkje rørast i denne runden.
|
||||
- **Vernet:** grep etter `helsesjekk` i heile repoet før arbeidet byrjar og etter at det er ferdig. Null treff att er kriteriet.
|
||||
|
||||
---
|
||||
|
||||
# 30. StartOS 0.4.0-pakke (vedteke, ikkje starta)
|
||||
|
||||
Avtalt 10.10.2026. Blir bygd etter at §29 er verifisert.
|
||||
|
||||
Appen blir éin StartOS-service: éin daemon, éin container, SQLite på eit persistent volum. Forbodet i §13 gjeld som han står: ingen Postgres, ingen Redis, ingen ekstern backend, inga ekstern cloud-teneste for appdata, og ingen ekstra container utan konkret behov.
|
||||
|
||||
- **Pakka ligg i app-repoet.** StartOS-filene (`startos/`, `Dockerfile`, `Makefile`, `package.json` og resten av skjelettet) ligg ved sida av appen i `ai-bot/helsesjekk`. Pakkeguiden seier at pakke-repoet ikkje skal vere ein fork av appen; her er appen vår eigen og har ikkje noko publisert image, så pakka byggjer appen frå repo-rota. Avviket skal stå i `AGENTS.md`, så ingen legg inn ein submodul for å «rette» det.
|
||||
- **Namn og versjon.** Manifest `id: 'vardkey'`, `title: 'VardKey'`, `volumes: ['main']` mounta på `/data`. Pakkeversjonen startar på `0.1.0:0` og blir heva til `1.0.0:0` når §16 StartOS-testen og §17 er oppfylte.
|
||||
- **Lisens.** `GPL-3.0-only`, med ein `LICENSE`-fil i repoet. Det er copyleft-motstykket til CC BY-SA 4.0, som er ein innhaldslisens Creative Commons sjølve rår frå å bruke på programvare, og GPL-3.0 gjev i tillegg ein eksplisitt patentlisens. Blir SPDX-id-en avvist av bygget, blir han skriven som `GPL-3.0`.
|
||||
- **`marketingUrl`** er `https://sondreolav.com/vardkey`. Sida finst ikkje enno og blir laga til slutt; URL-en blir sett inn no likevel, sidan manifestet krev han.
|
||||
- **Ikonet blir utsett.** `icon.svg` blir teikna i runden som hevar pakka til `1.0.0`, når appen er ferdig. Nektar bygget å pakke utan ikon, blir eit minimalt placeholder-ikon lagt inn og bytt ut i den runden.
|
||||
- **Daemonen.** Éin daemon `primary` som køyrer `python3 app.py` med `PORT=8080` og `DATABASE_PATH=/data/vardkey.sqlite3`. Volumet `main` blir mounta skrivbart på `/data`. Ingen oneshot, ingen sidecar, og inga `USER`-linje i Dockerfile, så `/data` er skrivbar utan `chown`.
|
||||
- **Helsesjekk.** Daemon-`ready` med `checkWebUrl` mot `http://127.0.0.1:8080/health`. Den interne porten i `bindPort` må vere den same som `PORT`, elles blir sjekken aldri grøn.
|
||||
- **Web-grensesnitt.** `MultiHost.of(effects, 'ui').bindPort(8080, { protocol: 'http', preferredExternalPort: 80 })` med éin `createInterface({ id: 'ui', type: 'ui' })`. StartOS terminerer TLS og proxyar rein HTTP inn i containeren, så appen må ikkje byggje absolutte `http://`-URL-ar. Appen gjer det ikkje i dag.
|
||||
- **Backup.** `backups.ts` peikar på volumet `main`. Det må undersøkast om `setupBackups` har ein krok som kan ta eit konsistent SQLite-snapshot. Finnst han ikkje, blir snapshotet teke medan ei skriving kan pågå, og det skal i så fall nemnast som ei kjend avgrensing.
|
||||
- **Ingen CI.** Pakkeguiden føreset GitHub-workflows. Repoet ligg på Gitea, og `.s9pk` blir bygd lokalt med `make`. Det skal stå i `AGENTS.md`.
|
||||
- **Rekkjefølgje.** Skjelettet kjem frå `s9pk init-workspace`; deretter `LICENSE`, `Dockerfile`, `.dockerignore`, `startos/manifest/i18n.ts`, `startos/manifest/index.ts`, `startos/utils.ts`, `startos/main.ts`, `startos/interfaces.ts`, `startos/backups.ts`, `startos/versions/`, `startos/init/`, `instructions.md`, `UPDATING.md`, `AGENTS.md`, `README.md`, og til slutt `TODO.md` og `ai-note.md`.
|
||||
- **Framleis manuelt:** §14, §16 StartOS-testen og §17 blir ikkje kryssa av før brukaren har køyrt dei på ein eigen StartOS 0.4.0-boks.
|
||||
|
||||
---
|
||||
|
||||
## Framtidig arbeid, ikkje no
|
||||
|
||||
- [ ] Fleire enn tre nøklar, og andre tersklar enn 2-av-3.
|
||||
Reference in new issue
Block a user