Föreningsguiden
PoC för en publik, sökmotorindexerad sajt som samlar svenska kommuners
föreningsbidrag. Arbetsnamnet var Bidragskollen — namnet beslutades till
Föreningsguiden 2026-07-10 (se namnbesluts-noten i UPPDRAG_POC.md §9.1).
Se UPPDRAG_POC.md för uppdrag, affärshypotes,
arbetsdelning och leveransordning — det dokumentet är sanningskällan,
inte denna README.
Status
Leveransordning steg 1–3 (repo-skelett, datamodell, samtliga tio kommuner,
kategorisidor, deadlinekalender, SEO-teknik) är klart och deployat till
Vercel-preview. E-postformulärets lagringsbackend är INTE kopplad — se
statusrapporten till Jacob/Fable för förslag som väntar på godkännande
(§6 UPPDRAG_POC.md kräver godkännande innan tredjepartsberoende införs).
Nästa steg: Fables brukstext för samtliga {{FABLE:}}-slots, därefter
Fables innehållsgranskning + Jacobs go/no-go för publik deploy (steg 4–5).
Köra lokalt
npm install
npm run dev # http://localhost:4321
npm run build # bygger till dist/, faller på trasig kommun-YAML
Datamodell
En YAML-fil per kommun i data/kommuner/, schema + validering i
src/lib/kommuner.ts. Valideringen körs vid modul-load (alltså varje
build/dev) och kastar ett fel med alla hittade problem om en fil bryter
mot schemat — bygget ska aldrig lyckas på trasig data.
Kommuner med verifierad-datum äldre än 180 dagar (STALE_THRESHOLD_DAYS i
kommuner.ts) får automatiskt en varningsflagga på sin sida.
Placeholder-slots (Fable-copy)
Ingen svensk löptext skrivs av Code (§2 UPPDRAG_POC.md). Textslots som
väntar på Fable är markerade {{FABLE: beskrivning}} i templates — sök på
{{FABLE: för att hitta alla öppna slots.
Struktur
data/kommuner/*.yaml — en fil per kommun (tio st)src/lib/kommuner.ts — schema, validering, loader, deadline-/datumhjälparesrc/layouts/Base.astro — sidlayout, nav, OG-taggarsrc/components/ — BidragCard, StaleWarning, BreadcrumbList,
EmailSignup — byggda för återbruk i vertikal 2 (stipendier)src/pages/kommun/[slug]/index.astro — kommunsidasrc/pages/kommun/[slug]/[kategori]/index.astro — kategori × kommunsrc/pages/deadlines/index.astro — deadlinekalender + e-postformulärsrc/pages/om/index.astro — förtroendesidan (skelett)src/pages/index.astro — startsida (kommunväljare + deadlineöversikt)astro.config.mjs — @astrojs/sitemap med lastmod från verifieradpublic/robots.txt — tillåter allt, pekar på sitemap
