The portal
The web frontend — the product surface for regnskapsførere, revisorer and businesses. A Svelte 5 (runes) single-page app, built by Vite, embedded into the regnmed-api binary and served on the API’s own origin. One service, no CORS, nothing extra in the distroless image.
Byggekjeden: node bygger, cargo bare leser (#76)
Section titled “Byggekjeden: node bygger, cargo bare leser (#76)”Kilden ligger i ui/portal/. scripts/build-portal.sh kompilerer den,
og ui/portal/dist/ sjekkes inn — nøyaktig presedensen den
genererte app.css satte. Rust-siden leser dist med include_dir, så
cargo build, og særlig kryssbygget i build-images.sh, trenger
aldri Node. Vite gir innholdshashede filnavn, derfor include_dir og
ikke én include_str! per fil.
En innsjekket artefakt lyver hvis den ikke er bygget fra kilden, så en
CI-jobb (portal) bygger portalen på nytt og feiler dersom dist
avviker. dist har dessuten sitt eget budsjett i scripts/frugality.sh.
Adressene:
/og/callback→ appen (rutingen skjer i hashen, og callback-adressen må lande i appen for å fullføre PKCE-flyten)./assets/*→ Vite-filene,immutableog cachet for alltid fordi filnavnet bærer innholdshashen. En ukjent asset gir 404, ikke appen på nytt: en 200 med HTML der JS-en skulle vært feiler stille./ny→ permanent redirect til/. Det var appens adresse mens migreringen pågikk; gamle bokmerker skal ikke lande i en 404.
Fart: komprimering, seksjoner ved behov, svarbuffer (2026-11-09)
Section titled “Fart: komprimering, seksjoner ved behov, svarbuffer (2026-11-09)”Tre grep som gjør portalen rask å bruke, uten å endre hva serveren garanterer:
- Gzip på tekst.
compression_layer()iregnmed-apikomprimerer JS, CSS, HTML, JSON og XML over 1 kB. PDF-er, bilder og opplastede dokumenter går urørt (allerede komprimert eller opake — å presse et vedlegg på 20 MB koster CPU for ingenting). Gzip og ikke brotli: den gjenbruker flate2 og holder minnet per strøm lite (frugality-budsjettet på 64 MB). Testet itext_is_gzipped_and_documents_are_not. - Seksjonene lastes ved behov. Første nedlasting er skallet og
oversikten (106 kB JS, 39 kB komprimert — før: 408 kB ukomprimert).
Hver seksjon er en egen bit (
lib/lazy.svelte.js); etter oppstart forhåndslastes resten i ledig tid, så et menyklikk likevel ikke venter på nettet. Feiler en bit (typisk: en ny versjon er rullet ut mens fanen sto åpen), ber siden om omlasting i stedet for å vise en tom flate. - Svarbuffer for GET (
lib/api.js). Et svar gjenbrukes i 30 sekunder, så et seksjonsbytte frem og tilbake er øyeblikkelig. Enhver endring (POST/PUT/DELETE) tømmer hele bufferet, før og etter kallet, så egne endringer vises alltid straks; et lesekall som startet før en endring lagres ikke etter den (generasjonsteller). Andres endringer kan være opptil 30 sekunder gamle ved et seksjonsbytte — som en side som står åpen. Bufferet tømmes når fanen blir synlig igjen, ligger bare i minnet (dør med fanen), og lagrer teksten, så en seksjon som endrer svaret sitt aldri endrer bufferet./mebufres aldri: den løser inn invitasjoner. Bufferet påvirker bare visningen — hver endring valideres av serveren som før. Testet mednpm test(kjøres i CI-jobbenportal).
Historikk: fram til 2026-07-29 var portalen rammeverksfri og uten
byggesteg (app.js + theme.js + generert app.css, include_str!).
Vedtaket om å bytte, og hvorfor, står i #76.
Utvikling
Section titled “Utvikling”scripts/build-portal.sh # bygg dist (kjøres før commit av UI-endringer)cd ui/portal && npm run dev # hot reload mot en kjørende regnmed-apiDev-serveren proxyer API-kallene til localhost:8080, så innlogging og
data virker som i produksjon.
OIDC authorization code + PKCE against regnid. The code→token
exchange is proxied through POST /auth/token (server-to-server), so
the IdP needs no browser CORS and the SPA never talks cross-origin.
Logout goes through regnid’s end_session with id_token_hint
(RP-initiated logout). regnmed still never sees a password.
Økten holdes i live av refresh-tokenet, ikke av en ny innlogging.
Tilgangstokenet lever en time, refresh-tokenet 30 dager. Et 401
veksler derfor refresh-tokenet gjennom POST /auth/refresh — samme
proxy-skinne som /auth/token, samme grunn (ingen browser-CORS, og
utstederens feildetalj blir på serveren) — og forsøker kallet én gang
til; bare en feilet veksling sender brukeren tilbake til innlogging.
INGEN TOKENER LAGRES I NETTLESEREN (avgjort 2026-10-31). De to tokenene har ulik verdi og ligger derfor ikke på samme sted:
| Token | Levetid | Hvor | Hva XSS kan gjøre med det |
|---|---|---|---|
| access | 1 time | en variabel i auth.svelte.js |
bruke timen som alt er i gang |
| refresh | 30 dager | HttpOnly-cookie, Path=/auth |
ingenting — siden kan ikke lese den |
Veien dit var sessionStorage → localStorage → cookie, og
mellomstasjonen ble forkastet med vilje. sessionStorage og
localStorage er like åpne for XSS — samme origin, samme JS — så
flyttingen mellom dem endret ikke XSS-flaten for tilgangstokenet. Det
den ville endret, er hva et innbrudd er verdt: et 30-dagers
refresh-token i localStorage gjør ett XSS-vindu om til en måneds
fornybar tilgang, mens et tilgangstoken i minnet er over om en time.
Det er levetiden som er risikoen, ikke lageret — så det lange
tokenet ble lagt der JavaScript ikke rekker.
Det er proxyen som kan holde det: den er alt det eneste som snakker med
token-endepunktet, så den deler svaret — tilgangstokenet til siden,
refresh-tokenet ut som Set-Cookie. En omlasting har derfor ingenting i
minnet, og oppstarten veksler cookien ÉN gang før innloggingen vises;
økten overlever både lukket fane og omstartet maskin uten at noe
langlivet ligger i et lager siden kan lese. Testen
the_refresh_token_leaves_only_as_an_httponly_cookie fester at
refresh_token ikke finnes i noe svar til nettleseren (sett feile).
Cookien er HttpOnly, SameSite=Strict og Path=/auth — bare de to
rutene som faktisk bruker den ser den — og Secure alltid UNNTATT på en
loopback-vert. X-Forwarded-Proto ville sviktet åpent den dagen en
proxy slutter å sette headeren; et vertsnavn kan ikke drive på den
måten.
POST /auth/logout tømmer cookien, og det er ikke pynt: uten den
overlever refresh-tokenet utloggingen, og neste besøk logger stille inn
igjen — på en delt maskin som forrige bruker.
PKCE-flighten (regnmed-pkce) blir liggende i sessionStorage. Den
gjelder én fane og brukes én gang, og skal dø med fanen.
Rotasjonen, og kappløpet mellom faner. Utstederen ROTERER: svaret
bærer en erstatter, og tokenet vi nettopp brukte er dødt. Innenfor én
fane deles ÉN veksling (refreshing i auth.svelte.js), men cookien
deles mellom faner, så to faner kan fortsatt veksle samtidig — og
taperen får avslag på et token som nettopp ble byttet ut. Her hjelper
cookien av seg selv: vinnerens Set-Cookie havner i den DELTE
cookie-burken, så taperen prøver ganske enkelt én gang til og bærer det
nye tokenet uten å vite om det. Derfor skiller /auth/refresh mellom
401 (ingen cookie — ingen økt å redde, ikke prøv igjen) og 400
(utstederen avviste — kan være rotasjonen, prøv én gang til). Smetten
som står igjen er smal: rekker avslaget fram før vinnerens svar er
lagret, blir det likevel en utlogging — samme utfall som før denne
endringen, aldri verre.
ÆRLIG BEGRENSNING: end_session tilbakekaller ikke refresh-tokenet hos
utstederen, så et token noen alt har stjålet dør først når det utløper.
Vi slipper cookien, som er alt vi rår over; en revoke-rute hører i
regnid.
Innlogging fra en annen enhet: QR-kode (RFC 8628)
Section titled “Innlogging fra en annen enhet: QR-kode (RFC 8628)”En bilskjerm, en TV, en lånt PC: et langt passord fra en passordbehandler finnes ikke der. Derfor tilbyr innloggingssiden «Logg inn med telefonen», som kjører device authorization grant (RFC 8628) mot regnid:
- Portalen ber
POST /auth/device. Proxyen kaller regnids/device_authorizationog får en enhetskode (legitimasjonen) og en brukerkode (de ni tegnene et menneske leser). - Svaret til siden bærer brukerkoden, adressen og et QR-bilde av
godkjenningssiden med koden ferdig utfylt. Enhetskoden gjør det
ikke: den legges i en HttpOnly-cookie (
regnmed_device, fem minutter,Path=/auth) av samme grunn som refresh-tokenet — siden skal ikke holde en legitimasjon. - Telefonen skanner, lander på regnids
/device, ser hvilken tjeneste som spør og hvilken kode, og godkjenner eller avviser. - Skjermen spør
POST /auth/device/pollhvert femte sekund. 202 betyr «ingen har svart ennå» — statuskoden bærer forskjellen, så siden aldri tolker utstederens ordlyd. 200 bærer tilgangstokenet, 400 avslutter.
Refresh-cookie settes bare når den som godkjenner sier at skjermen er
sin egen. Godkjenningssiden spør: uten avhuking varer økten én time og
skjermen må spørre på nytt — en lånt PC skal ikke sitte igjen med en
måneds tilgang. Med avhuking svarer regnid med et refresh-token, proxyen
løfter det ut av kroppen og inn i regnmed_refresh som på en vanlig
innlogging, og en bilskjerm overlever en omlasting.
Valget ligger på telefonen, ikke på skjermen, og det er grunnen til at det er trygt å tilby: bare den som holder telefonen kan se om det er sin egen bil eller en kiosk, og en angriper som har lurt noen til å godkjenne en kode ville uansett huket av selv. Standardsvaret er det trygge, altså det som skjer når ingen velger.
Risikoen her er overtalelse, ikke avlytting. Device-code-phishing virker ved at noen sender deg en kode og en plausibel grunn til å godkjenne den; ditt eget trykk gjør resten. Mottrekkene ligger i regnid og er dokumentert i regnids README: koden varer fem minutter, gjetting strupes per adresse, og godkjenningssiden sier rett ut at man bare skal godkjenne en kode som står på en skjerm foran en.
Siden viser med vilje IKKE enhetens IP-adresse eller nettleser. Den
IP-en regnid ser er vår egen proxys, ikke bilskjermens, og gjennom
Traefik kan den ikke bæres videre ærlig; en videresendt IP ville dessuten
kunne forfalskes av hvem som helst som når /device_authorization, siden
portalklienten er offentlig. En oppdiktet detalj presentert som faktum er
verre enn ingen detalj — sammenligningen av koden er vernet som holder.
QR-koden rendres av regnmed-core::qr — håndrullet som alt annet format
i den kisten, byte-modus, feilrettingsnivå L, versjon 1–5 (de versjonene
som har ÉN rettingsblokk, så interleaving-halvdelen av standarden
forsvinner). En nyttelast som ikke passer sier fra høyt i stedet for å
lage noe et kamera ikke kan lese. Verifisert mot en uavhengig koder
(segno) modul for modul på hver versjon, og i tillegg dekodet og
EC-regnet på nytt fra bunnen av; the_modules_are_pinned fester
resultatet. Ingen QR-pakke i portalen: ui/portal/dist har ikke plass
(547 KB av 552), og en koder i Rust koster ingenting der.
The public client regnmed-portal must have the portal’s origin
registered: {origin}/callback as redirect URI and {origin}/ as
post-logout URI. The portal derives both from location.origin, so the
port is part of the registration — moving the dev server means
re-registering the client.
- Cluster:
regnmed.localhost(portalen) ogapi.regnmed.localhost(API-verten, samme binær), begge seedet avscripts/dev-cluster.sh. Begge opphav må stå på klienten, siden appen kan åpnes fra begge. - Two-process dev (no cluster):
scripts/dev-sso.shregisters the client and a dev admin against a local regnid, defaulting to regnmed-api on 8082 and regnid on 8081. 8080 is avoided because colima/k3s port forwards commonly hold it. Start regnid first — regnmed-api resolves OIDC discovery at startup and exits if the issuer is unreachable.
Theming (the cross-site contract)
Section titled “Theming (the cross-site contract)”ui/portal/themes.css is a copy of the canonical
../regnid/ui/themes.css — same daisyUI theme names and blocks, so a
user’s theme feels identical on both sites. Update both files together.
(The copy lives beside the app because @plugin "daisyui/theme"
resolves against the nearest node_modules, and Node lives only in
ui/portal.) The preference is stored per site in localStorage
(regnmed-theme), resolved stored → system → light, applied pre-paint
by an inline script in index.html so the page never flashes; it is
never synced through the IdP or tokens. Tailwind and daisyUI are built
by Vite as part of scripts/build-portal.sh.
Alle daisyUIs innebygde temaer er tilgjengelige (themes: all i
ui/portal/src/app.css, samme i ../regnid/ui/input.css) — 35 innebygde
pluss våre egne: regnid, kontrast og steelzombie. Temavalget er
brukerens, og en håndplukket liste måtte vedlikeholdes for hånd hver gang
daisyUI la til et tema. steelzombie er husets MØRKE standard
(2026-08-06): blokken i themes.css har prefersdark: true, som vinner
prefers-dark-plassen over innebygde dark fordi den lastes ETTER
plugin-en — «følg systemet» med mørkt OS gir steelzombie, og
snarveisknappens syklus er system → light → steelzombie (CYCLE i
theme.svelte.js). Innebygde dark kan fortsatt velges ved navn.
To ting å vite:
allkan ikke kombineres medlight --default, dark --prefersdark: da faller resten av listen stille bort (verifisert 2026-08-03 — 4 temaer i bygget i stedet for 37).allbeholder de samme standardene selv:lightpå:where(:root),darkunderprefers-color-scheme.- Velgeren er gruppert etter daisyUIs egen
color-schemepå hver temablokk, ikke etter skjønn:THEME_GROUPSisrc/lib/theme.svelte.jsogTHEME_GROUPSi regnidssrc/accounts.rs(som også er allowlistenis_themevaliderer mot). En flat liste på 37 navn er ubrukelig, og den som vil ha et mørkt tema skal slippe å gjette.
Selve velgeren er daisyUIs theme-controller i et dropdown+menu
(begge steder): en avkrysset radio med temanavnet som value velger
temaet i REN CSS. I regnid heter radioene theme, så skjemaet POSTer
valget uten JS i innsendingsveien. JS-en består likevel — den husker
valget (localStorage) og setter data-theme FØR første maling, ellers
blinker siden i feil tema.
Fellen, og hvorfor «system» er bygget som den er: en avkrysset
theme-controller har HØYERE spesifisitet enn [data-theme]
(:root:has(input.theme-controller[value=x]:checked) slår
[data-theme=x]). «Følg systemet» er derfor med vilje IKKE en
theme-controller: den ligger i samme radiogruppe, så den krysser av de
andre, og uten noen avkrysset controller finnes ingen overstyring — da
får OS-preferansen bestemme. Var «system» en controller, ville en
gjenglemt avkryssing overstyrt den i det stille.
Nye temaer lages enklest med daisyUIs Theme Generator
(<https://daisyui.com/theme-generator/>): den skriver ut nøyaktig én
@plugin "daisyui/theme" { … }-blokk, som er formatet themes.css
allerede har. Lim blokken inn i BEGGE themes.css-filene, legg navnet i
begge THEME_GROUPS, og bygg (scripts/build-portal.sh +
../regnid/scripts/build-css.sh).
Kostnaden er ren CSS: dist vokste ~32 KB (~21 KB gzipet) og ligger godt
innenfor PORTAL_DIST_BUDGET_KB i scripts/frugality.sh.
Skallet: meny, meldinger, dialoger og ulagret arbeid (2026-11-14)
Section titled “Skallet: meny, meldinger, dialoger og ulagret arbeid (2026-11-14)”Det som omgir hver side, og som derfor må virke likt overalt:
- Meny. Seksjonene står i en
<nav aria-label="Seksjoner">. På telefon er de en liste bak en knapp som viser hvor du er («Lønn · Meny») — tidligere var de en vannrett stripe på 18 punkter der den aktive kunne ligge 1 400 px utenfor skjermen. Listen legger seg OVER siden, ikke inn i den — ellers ville en seksjon som fyller skjermen (Meldinger) blitt klemt hver gang den åpnes — og lukker seg når du har valgt, trykker utenfor eller trykker Escape. - Hopp til innhold. Første tabulatorstopp er en knapp (ikke en
#-lenke — hashen tilhører ruteren) som setter fokus i innholdet; uten den var det 20 tabulatorstopp før siden begynte. - Ny side. Ved bytte av seksjon eller underside rulles det til toppen,
og ved bytte av seksjon flyttes fokus til innholdet (
main,tabindex=-1), så tastatur og skjermleser lander der siden er. En seksjon som bare endrer sin egen?spørring(en uke, et filter) flytter ingenting — ellers ville piltastene i timearket miste cellen. - Fanetittel. Hver side heter «Seksjon · Selskap · regnmed» i fanen og i historikken.
- Ukjent selskap. En adresse til et selskap personen ikke har tilgang til, sier «Fant ikke selskapet» med lenke til Mine selskaper, i stedet for en halvtom oversikt.
- Meldinger. Toast-feltet står alltid i siden med
aria-live, så skjermlesere hører meldingene; feil errole="alert". En bekreftelse forsvinner etter fem sekunder, en feil blir stående til den lukkes — feilmeldingene våre sier hva man skal gjøre, og fem sekunder holder ikke til å lese dem. Høyst fire vises samtidig. - Dialoger. Felles dialog (
lib/dialog.svelte.js) navngir seg selv etter tittelen (aria-labelledby), og hvert felt har en ekte<label>(et spørsmål uten egen etikett får dialogtittelen som navn). Før var ingen felt i noen dialog navngitt for skjermlesere. - Oppstart. Svarer ikke serveren (
/portal-config), sier portalen det med «Prøv igjen» i stedet for å snurre for alltid. - Ulagret arbeid (
lib/ulagret.js). Et skjema som holder noe ulagret, registrerer en vakt (vaktUlagret({ ulagret: () => …, tittel, melding })ionMount). Da spør portalen før man forlater siden — via en lenke hvor som helst (fanget før adressen endres), via Tilbake (adressen settes tilbake og spørsmålet stilles etterpå) og ved omlasting eller lukket fane (nettleserens egen advarsel). Ny faktura er første bruker; før dekket den bare sine egne to lenker, ikke menyen.
Sections (all backed by the existing engagement-guarded API)
Section titled “Sections (all backed by the existing engagement-guarded API)”Én komponentmappe per seksjon under ui/portal/src/sections/, registrert
i App.svelte og navngitt i lib/meny.js:
Meldinger (2026-11-16, docs/meldinger.md §7) er en egen visning,
#/meldinger, utenfor selskapene — en samtale er mellom personer, og
byråets folk snakker med alle klientene. Knappen med uleste står i hver
navbar (ChatButton i brukermenyen) og i selskapsmenyen. Liste og
samtale side om side på bred skjerm, én av dem om gangen på telefon.
lib/chat.svelte.js holder ÉN SSE-forbindelse per innlogget person (lest
med fetch, fordi EventSource ikke kan sende Authorization).
/chat-adressene bufres aldri i API-klienten, og Vite-proxyen sender dem
videre.
Oversikt (snarveier, «Til oppfølging» — forfalte fakturaer, neste
mva-frist etter terminordningen, innboks, uavstemt bank — tre nøkkeltall,
resultat per måned, siste bilag, migrering av tomt selskap, inviter-kort
som kan skjules; valutakurser bor i Bank, forankringen under Rapporter →
Revisjon) · Faktura (fakturaliste m/ status, søk og filter;
fakturaside m/ linjer, send/PDF/EHF/purring/kreditnota/gjenta; ny faktura
m/ flere linjer og løpende sum; faner for tilbud→ordre, repeterende og
ufakturerte timer — docs/faktura.md) · Produkter
(register, varelager, telling) · Prosjekter (register m/ kundekobling og
navneendring, avdelinger — docs/dimensjoner.md) · Timer (ukegrid m/
autolagring per celle, kopier forrige uke, fakturagrunnlag m/
personutvalg — docs/timer.md) · Lønn · Utlegg · Anlegg ·
Aksjonærer · Kunder (register m/ søk, sortering og
sider på serveren, utestående og forfalt per kunde; ny kunde fra
organisasjonsnummeret m/ navn og adresse fra Enhetsregisteret og varsel
ved konkurs/avvikling; kundeside m/ kundens fakturaer, «Ny faktura» med
kunden valgt, merket kontaktinfo og reskontroposter under) · Leverandører
(samme register og «ny» fra orgnr som Kunder, med leverandørens ord og
fortegn; leverandørside m/ skyldig og forfalt, åpne poster med forfall og
KID som kan føres og rettes, «Legg i betalingsliste» for valgte poster,
kontonummer og reskontroposter under — docs/betaling.md) · Reskontro (alle parter på tvers, CSV-import) · Mva
(spesifikasjon, eksport, terminordning) · Rapporter (saldobalanse,
resultat, balanse, budsjett/avvik, konto-, reskontro- og
bokføringsspesifikasjon, revisjon) · Bank (kontoutskrift, avstemming,
betalingsliste) · Bilag
(innboksen som forside m/ flere filer og dra-og-slipp; dokumentside m/
PDF/bilde ved siden av en enkel bokføring som viser linjene, avansert
linjeredigering, attestering og «neste dokument»; faner for
behandlede, bokførte bilag og innstillinger — docs/bilagsinnboks.md) ·
Administrasjon (konsollen, se under) — pluss byråvisningen på
#/byra/{id}.
Administrasjon-konsollen og ikonene (2026-08-06)
Section titled “Administrasjon-konsollen og ikonene (2026-08-06)”Administrasjon (#/c/{id}/admin/{fane}) samler selskapets styring
bak én menyoppføring: et dashbord med statusfliser (daisyUI
stat-komponenter, samme form som plattformdashbordet: abonnement,
medlemmer, åpne invitasjoner, oppdrag/integrasjoner, periodelås,
firmaopplysninger) og faner som gjenbruker de eksisterende kortene —
Firmaopplysninger og Abonnement (flyttet fra Oversikt), Brukere og
roller, Oppdrag og integrasjoner, Periode, Utseende. Ingen ny
autorisasjon: alle kall går til de samme vaktede endepunktene, og en
flis hvis endepunkt nektet sier «krever mer tilgang» i stedet for å
late som null. De gamle adressene #/c/{id}/brukere|oppdrag|periode
består og rutes til riktig fane (FLYTTET_TIL_ADMIN i lib/meny.js).
Revidert 2026-11-15 (gjennomgang mot grunnreglene):
- «Å gjøre» øverst på dashbordet lister det som mangler før
selskapet kan fakturere og sende til myndighetene — adresse,
kontonummer, e-post, en registreringsstatus som bare er utledet,
kundevilkår som ikke er godtatt, et ubetalt eller sperret abonnement —
hver med lenke til fanen som retter det (
gjoremalisections/admin/admin.js, testet). Bare fakta som faktisk ble hentet teller: manglende tilgang gir ingen falsk alarm. - Nektet er ikke nede: om en flis «krever mer tilgang» avgjøres av
rettighetene i
/meFØR kallet; et kall som feiler sier «kunne ikke hentes» med Prøv igjen. Før så et nettverksbrudd ut som manglende tilgang på alle flisene. - Hver fane henter sitt: dashbordets kall går bare på Oversikt; Firmaopplysninger og Abonnement henter bare det de viser.
- Fanelinjen er en
navmedaria-current="page", ikke en tablist uten paneler. Firmaopplysninger har ekte etiketter og stables på telefon, Lagre viser fremdrift og resultatet ved knappen, og historikken viser kilden i ord. Kundevilkår og abonnementshandlinger vises bare for administrator; innsendingene til myndighetene er rader, ikke en femkolonners tabell. Abonnementet viser årspris når «Årlig» er valgt (pris_ore_per_arfra/subscription; uten egen årsrad er den 12 × månedsprisen, samme regel som faktureringen).
Brukere og roller revidert 2026-11-16 (samme gjennomgang):
- Nektet er ikke nede her heller: fanen henter bare det
/mesier at brukeren får lese (MEDLEM_ADMINfor medlemmer, invitasjoner, roller og leverandørtilgang;INTEGRASJON_LESfor agentene). Et kall som feiler gir «Prøv igjen», ikke «krever administrator». - Medlemmer og agenter er rader, ikke tabeller, så rolle, Fjern og agentenes handlinger kan nås på telefon. De sjeldne agenthandlingene (bytt rolle, modell, trekk tilbake) ligger under «Mer».
- Rollebytte bekreftes når det kan stenge noen ute: når en
administrator mister administratorrollen, eller når du endrer din egen
rolle (
rolleendringAdvarselisections/brukere/brukere.js, testet). Et vanlig bytte skjer straks, som før. Avbryter man, settes velgeren tilbake. Siste-admin-vakten står fortsatt på serveren. - Rollene vises med navn («Bokføring», «Lesetilgang»), ikke lagringsnøkkel,
og med rollens forklaring fra
/roles. Invitasjon, ny rolle og «gi tilgang» er skjemaer med etiketter, Enter sender, knappen viser fremdrift og feltet tømmes etterpå. Tilbakekalling av en invitasjon bekreftes. En lukket rettighetsgruppe viser hvor mange som er valgt («2 av 8»), og Lagre på en egen rolle er bare aktiv når noe er endret.
Byråvisningen (#/byra/{id}) revidert 2026-11-16 (samme gjennomgang):
/melister hvert selskap ÉN gang. En person kan nå samme selskap på flere veier — direkte medlemskap og et byrås oppdrag, eller to byråer — og/mesendte én rad per vei. Selskapslisten er nøklet på id, så duplikatet blanket ut startsiden for et byrå som fører sitt eget regnskap og har tatt seg selv som klient. Nå slås radene sammen (regnmed-db::one_per_company): den sterkeste veien vises (access_rank, samme rangering somcompany_access), og rettighetene er som før unionen av alle veiene. Testet ime_lists_a_company_once_when_reached_two_ways, sett feile uten rettingen.- Klientene er lenker til selskapets Oversikt — grunnen til at en
regnskapsfører åpner siden. Avsluttede oppdrag står for seg under
«Avsluttede oppdrag», uten lenke (
delKlienterisections/byra/byra.js, testet;valid_toer eksklusiv som overalt). - Godta og Avslå bekreftes, og forespørselen viser dato og oppdragstype i ord. Forespørsler, klienter og medlemmer er rader som passer en telefon. Medlemmer-kortet følger Tilgang-kortet: rollebytte som kan stenge noen ute bekreftes, invitasjonen er et skjema med etiketter, tilbakekalling bekreftes.
- Et ukjent byrå sier fra i stedet for å spinne for alltid, og et kall som feiler gir «Prøv igjen». Brødsmulesti tilbake til Mine selskaper.
- Leverandørtilgang vises også for byrået (administrator):
/firms/{id}/platform-accessfantes, men byråvisningen brukte den aldri, så «varslet»-kravet fra #57 var oppfylt for selskaper og ikke for byråer.
Menyikonene er håndrullede 24×24 outline-SVG-er i
src/lib/ikoner.js — vendored som themes.css: intet ikonbibliotek,
ingen CDN, ingenting hentes i kjøretid. Hvert ikon lagres ÉN gang som
statisk markup; ikonstilen (linje / kraftig / emoji / ingen) endrer
bare gjengivelsen i components/Ikon.svelte (strekbredde eller
emoji-fallback). Tilordningen seksjon → ikon er fast med vilje —
gjenkjenning dør om hver installasjon stokker om. Stilen er en
PLATTFORMINNSTILLING, låst globalt av systemadmin (brukerbeslutning
2026-08-06, migrasjon 0053): portalen leser den fra /portal-config
ved oppstart (lib/prefs.svelte.js er bare speilet), og velgeren bor i
plattformkonsollens Innstillinger-fane (PUT /platform/settings).
Ingen brukeroverstyring — i motsetning til fargetemaet, som fortsatt er
per bruker.
Brukermenyen (2026-08-06, components/UserMenu.svelte): én
avatar-dropdown (initialer, daisyUI avatar-placeholder) i alle
innloggede navbarer — navn/e-post, Profil (lenker til IdP-ens
/account, identitet redigeres ALDRI her), kontekstens Innstillinger
(selskapsskallet peker på Administrasjon), fargetemavelgeren (samme
theme-controller-maskineri som før; ThemeControls består bare på
innloggingssiden), Logg ut og versjonsnummeret. Versjonen kommer fra
/portal-config (versjon): CI baker REGNMED_VERSION inn i binæren
(taggen eller sha-<kort> — images.yml), lokalt svarer den ærlig «dev».
Plattformkonsollen (#/plattform, docs/auth.md §8) er back-office:
dashbord (/platform/overview), Abonnementer per selskap
(/platform/subscriptions), og drill-down per selskap
(components/PlattformSelskap.svelte mot
GET /platform/companies/{id}) med redigerbare firmaopplysninger,
medlemsstyring (kilde «plattform» i selskapets logg) og manuell
åpning/avslutning av dekning. Identitetsdata (navn/e-post) eies av
IdP-en — Brukere-fanen sier det og lenker dit (BogenTech/regnid#1).
Fellesdeler ligger i src/lib/ (API-klient, auth, ruter, tema, toast,
nedlasting, offline-kø) og src/components/ (skall, kort, dimensjons-
og mva-velger). Ruteren leser hash-spørringen ett sted, så
#/c/{id}/mva?year=&termin= fortsatt kan deles.
Modale spørsmål (2026-08-06): nettleserens confirm()/prompt()
er erstattet av daisyUI-modaler med samme mønster som toastene —
lib/dialog.svelte.js eier tilstanden og tilbyr promise-funksjonene
bekreft (ja/nei; farlig gir rød OK-knapp), sporsmal
(prompt-ekvivalenten) og skjema (flere felt i én modal: text/date/
textarea/select/checkbox, påkrevde felt sperrer OK-knappen);
components/Dialog.svelte monteres én gang i App.svelte og rendrer via
en nativ <dialog> (showModal()), så Esc, fokusfelle og
bakgrunnsklikk kommer fra plattformen. Flyter som før stilte flere
prompt-spørsmål etter hverandre (gjenta faktura, avhending, godkjenn
utlegg, aksjonærkontakt) er nå ett skjema. Ingen confirm(/prompt(
skal finnes igjen i ui/portal/src.
Authorization is entirely server-side — the portal is a view; a revisor’s read-only access or a stranger’s 404 comes from the API, never from hidden buttons. Menyen skjuler bare det en rolle ikke kan bruke, så ingen klikker seg inn i en feilmelding; sperren ligger i tilgangsvakten.
PWA: kvitteringsfoto og attestering på farten (#48)
Section titled “PWA: kvitteringsfoto og attestering på farten (#48)”De to tingene folk faktisk gjør på telefon er å ta bilde av en kvittering i det den finnes, og å godkjenne noe mens de er ute. Begge deler er den samme portalen — ingen app-butikk, ingen andre kodebase.
Installerbar: /manifest.webmanifest (standalone, norsk, ikoner
192 og 512 — den siste maskable, fordi Android beskjærer) og
/sw.js, servert fra binæren som alt annet. Ikonene genereres av
scripts/build-icons.py (hand-rolled PNG, ingen bildebibliotek i
treet) og sjekkes inn ferdig, akkurat som dist.
Service workeren cacher app-skallet — og bare det.
Hovedboken caches aldri. Et regnskap som viser gamle tall offline er verre enn et som sier at det ikke har kontakt.
Siden skallet er Vite-bygget, kan filnavnene ikke listes opp på
forhånd. Regelen er derfor uttrykt som adresser: /assets/* er
bygde, uforanderlige filer, og de faste PWA-filene er navngitt. Alt
annet — hele API-et — går utenom cachen. Skallet hentes nett-først (en
oppdatert app vinner alltid), og cachen trår bare til uten dekning.
Endrende forespørsler går aldri gjennom arbeideren.
Kvitteringsfoto: knappen bruker
<input type="file" accept="image/*" capture="environment"> — kamera
på telefon, vanlig filvelger på maskin — og laster opp til det samme
innboks-endepunktet som før. API-et er uendret.
Offline-kø, bare for opplastinger. Uten dekning legges bildet i
IndexedDB og sendes automatisk når nettet er tilbake (ved online og
ved oppstart). Bildet hashes i telefonen og sendes med ?sha256=, og
serveren:
- avviser innhold den allerede har («nøyaktig dette dokumentet
ligger allerede i innboksen som …»), så en kø som prøver igjen fordi
svaret aldri kom fram ikke gjør ett bilag til to — med ett unntak:
en avvist kopi sperrer ikke. Avvisningen var svaret på den
opplastingen, og å sende samme kvittering inn igjen er et nytt
spørsmål (
regnmed-db::upload_inbox_document), og - avviser en hash som ikke stemmer med bytene den mottok, som betyr at bildet ble skadet underveis.
Køen fjerner et bilde når serveren avviser det (det blir ikke bedre av å prøve igjen) og lar det ligge når det er nettet som svikter.
Responsivt: menyen legger seg vannrett over innholdet under sm
og er sidestilt fra sm og opp; kortkroppene ruller sine egne brede
tabeller i stedet for å dytte siden sidelengs. Temakontrakten er
urørt — samme daisyUI-temaer som på skrivebordet.
Stat-radene stabler (stats-vertical) under sitt brytepunkt i stedet
for å rulle sidelengs. Aktivt menyvalg markeres diskret med
temastyrte tokens (bg-base-200 text-primary + primærfarget stolpe
via inset-skygge i currentColor + aria-current — daisyUIs
menu-active ble prøvd og var for kraftig, og stolpen bærer
markeringen i temaer der tonen knapt synes), og skallet
viser brødsmulesti
(daisyUI breadcrumbs): Mine selskaper → selskap → seksjon — dybden
innenfor en seksjon er seksjonens egen fanelinje.
Bevisst utenfor: native apper, push-varsler (e-post dekker frister), og offline bokføring — aldri.
Verified
Section titled “Verified”Full browser round-trip against the dev servers: SSO login via regnid →
company picker from /me → dashboard with live ledger numbers → customer
created → invoice issued (KID shown) → mva-spesifikasjon reflecting the
new invoice → theme switch (corporate) applied instantly.
PWA-en er verifisert i mobilviewport (375×812): service workeren
registrert og aktiv med rot-scope, manifestet lest, kameraknappen med
capture="environment", menyen vannrett, ingen vannrett overflyt — og
et «kamerabilde» lastet opp gjennom den ekte veien, der den samme
filen sendt en gang til ble avvist av serveren.
regnmed-api/tests/grupper/pwa.rs dekker det som må stå: manifest og ikoner
serveres med riktig content-type (og er ekte PNG-er i riktig
størrelse), arbeideren nevner ikke hovedboken, index.html peker på
manifestet, og den samme kvitteringen to ganger blir ett bilag mens en
gal hash avvises. tests/grupper/portal.rs dekker serveringen: / og
/callback gir appen, hver hashet asset serveres immutable, en ukjent
asset gir 404 (ikke appen på nytt), /ny redirecter til /, og de
gamle adressene /app.js, /app.css, /theme.js er borte.
Flippen (2026-07-29, #76 steg 3)
Section titled “Flippen (2026-07-29, #76 steg 3)”Svelte-appen overtok /, og den rammeverksfrie portalen ble slettet i
samme endring: app.js (4 174 linjer), theme.js, den genererte
app.css, index.html, scripts/build-css.sh og ui/input.css.
Verifisert i nettleseren etterpå: appen serveres fra roten, service
workeren er registrert med rot-scope og cachen inneholder bare
skallet (/, /assets/*, ikoner, manifest) og ingenting fra
hovedboken, den gamle v1-cachen er ryddet bort, de gamle adressene
svarer 404, /ny redirecter, og 375×812 har fortsatt ingen vannrett
sidescroll.