Find Beskyttelsesrum

findbeskyttelsesrum.dk er et gratis, uafhængigt orienteringsværktøj til BBR-registreringer af sikringsrumspladser i Danmark. Brugeren kan søge på en adresse, bruge sin aktuelle placering eller gå via kommuneoversigten og landskortet.

En registrering er ikke en garanti for offentlig adgang, klargøring eller aktuel fysisk stand. Tjenesten er ikke en myndighedstjeneste eller en evakueringsanvisning. Ved varsling skal man gå indenfor og følge myndighedernes information.

Hvad løsningen indeholder

• adressesøgning med Klimadatastyrelsens Adressevælger og nærhedsberegning uden adresse eller koordinater i URL'en;
• landskort og lokale kort med Leaflet og OpenStreetMap;
• kommune- og registreringssider med forklaring af datagrundlaget;
• privat fejlrapportering med moderationskø;
• mailfri kontakt- og svarportal med privat sagskø og engangsvisning af adgangskode;
• GitHub-login, tilladelsesliste og MFA til administration;
• daglig BBR/DAR-import med staging, kvalitetskontrol, atomisk publicering og rollback;
• transaktionelt opdaterede kommuneaggregater og versionsbundet kortcache;
• permanente registreringslinks med serverstyret redirecthistorik;
• verificerbar produktions- og dataversion via /api/health;
• gratis produktionskontrol, uafhængig uptime-kontrol og privatlivsvenlige, aggregerede driftstællere.

Tjenesten skal forblive gratis for brugeren. Kortet må ikke få en obligatorisk betalt kortleverandør, og driften er indrettet til at bruge leverandørernes gratis muligheder og tydelige forbrugsgrænser. OpenStreetMaps offentlige standardtiles bruges ansvarligt med listevisninger som fallback.

Arkitektur og dataflow

Datafordeler (BBR + DAR)
        │
        ▼
Python-importer ──► privat staging ──► kvalitetskontrol
                                          │
                                          ▼
                            versioneret publicering i app_v2
                                          │
                                          ▼
Adressevælger ──► Next.js på Vercel ──► offentlige views/RPC'er i Supabase
                          │
                          └──► Leaflet + OpenStreetMap

Den offentlige app læser kun eksplicitte, offentlige views og read-only funktioner i Supabase-skemaet app_v2. Importkandidater, snapshots, moderation, audit og driftstællere er private. En fejlet eller mistænkelig import ændrer aldrig det aktuelt publicerede datasæt.

Kom i gang lokalt

Krav

• Node.js 24 og npm;
• en Supabase-projektadresse og publishable key;
• valgfrit: Python 3.12 og uv til importeren;
• valgfrit: Supabase CLI til migrationsarbejde.

Installation

nvm use
npm ci
cp .env.example .env
npm run dev

Åbn derefter http://localhost:3000.

Udfyld som minimum disse offentlige værdier i .env:

NEXT_PUBLIC_SUPABASE_URL=...
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=...

SUPABASE_SECRET_KEY er kun til server-, import- og driftsopgaver. RATE_LIMIT_HASH_SECRET er en separat serverhemmelighed til anonyme forbrugsgrænser og skal indeholde mindst 32 tilfældige tegn. Ingen af dem må få præfikset NEXT_PUBLIC_, bruges i browserkode, skrives i logoutput eller lægges i Git. Se alle sikre pladsholdere i .env.example.

Kvalitetskontrol

Kommando	Formål
npm run lint	Kontrollerer kodekvalitet.
npm run typecheck	Kontrollerer TypeScript-typer.
npm test	Kører enheds- og sikkerhedstests.
npm run test:db	Kører databaseinvarianter mod lokal Supabase.
npm run build	Bygger produktionsversionen.
npm run test:e2e	Bygger og kører Playwright i desktop Chromium, Firefox og WebKit samt mobil Chromium og WebKit.
npm run test:release	Kører den samlede lokale releasekontrol.
npm run monitor:production	Kontrollerer den live brugerrejse og dataalder.

Pull requests skal bestå lint, typekontrol, kode- og databaseinvarianter, produktionsbuild og hele browserhistorien i Chromium, Firefox og WebKit. De samme kontroller gentages ved push til main.

Parity- og sanitykontroller kræver de relevante Supabase-nøgler og fejler, hvis konfigurationen mangler. De bruger samme publishable-key-konfiguration som appen; den ældre NEXT_PUBLIC_SUPABASE_ANON_KEY understøttes fortsat. test:release kræver også SUPABASE_SECRET_KEY til de private paritylæsninger. Nøglen skal kun findes lokalt eller i betroede driftsjob, aldrig i pull request-job.

Dataimport

Den autoritative importer ligger i tools/datafordeler-importer. GitHub Actions kører den dagligt. En manuel kørsel starter som tørkørsel; en fuld skrivning kræver en eksplicit produktionsbekræftelse.

Importerens lokale kontroller køres fra dens egen mappe:

uv sync --frozen --extra dev
uv run ruff check .
uv run mypy shelter_importer
uv run pytest
uv run python -m build

Læs den operationelle kontrakt i importerens README og det samlede dataflow i docs/data/import-flow.md.

Databaseændringer

Alle databaseskemaændringer skal ligge som tidsstemplede filer i supabase/migrations. Brug Supabase CLI, så lokal og ekstern migrationshistorik forbliver enige:

supabase db push --dry-run
supabase db push
supabase migration list

Kør ikke migrationsfiler direkte én efter én uden migrationshistorik. Kontrollér altid den konkrete diff og Supabase-advisors ved ændringer i views, funktioner, rettigheder eller RLS.

Drift og administration

• /admin er den beskyttede indgang til moderation og drift.
• /admin/kontakt er den private kø til kontakt- og persondatahenvendelser; svar læses med sagsnummer og adgangskode uden e-mail.
• Administratorer logger ind gennem GitHub OAuth, skal være på tilladelseslisten og skal gennemføre MFA.
• /admin/drift viser importer, kvalitetskontroller, aktivt datasæt, rollback og 30 dages aggregerede driftstal.
• /api/health viser deployet Git SHA, deployment-ID, byggetid, publication-ID, offentlig datarevision, import-run-ID og dataalder. Gamle eller inkonsistente data giver 503 degraded.
• Produktionsflowet kontrolleres automatisk én gang i timen (GitHub kan forsinke planlagte kørsler med flere timer). Fejl opretter en GitHub-issue; næste succes lukker den igen.
• Et service-only heartbeat kobler health-status til den seneste gennemførte produktionskontrol. En gratis ekstern monitor kan derfor også opdage, hvis GitHub-workflowet slet ikke starter.
• De egne driftstællere indeholder ikke IP-adresse, bruger-id, adresse, koordinater, søgetekst eller fuld URL og slettes senest efter 90 dage.
• Rapportfritekst og identificerende auditfelter redigeres efter 24 måneder; struktureret audit slettes efter 5 år. Se docs/privacy/retention.md.
• Recovery og nøgleudskiftning er dokumenteret i docs/operations/mfa-recovery-and-secret-rotation.md.

Release

Vercel-projektet er forbundet til GitHub-repositoriet. Hver pull request får en beskyttet preview-deployment, og hver merge til main udgives automatisk til produktion.

1. Opret en feature branch og en pull request.
2. Lad de obligatoriske kvalitetskontroller bestå, og kontrollér eventuelt preview-deploymentet.
3. Anvend og verificér eventuelle Supabase-migrations før merge, hvis koden afhænger af dem. Merge udgiver straks.
4. Merge til main. Vercel bygger og udgiver produktion automatisk.
5. Kontrollér produktionskontrollen mod det deployede Git-SHA (npm run monitor:production eller /api/health).
6. Ved fejl: brug Instant Rollback i Vercel til den forrige produktionsdeployment.

Struktur

Mappe	Indhold
src/app	Sider, API-ruter, metadata og adminflader.
src/components	Genbrugelige brugerfladekomponenter.
src/lib	Dataadgang, sikkerhed, kort, SEO og domænelogik.
supabase/migrations	Versionsstyrede databaseændringer.
tools/datafordeler-importer	Autoritativ Python-importer og egne tests.
tests	Enheds- og sikkerhedstests.
e2e	Playwright-tests af hele brugerrejsen.
scripts	Aktive drifts-, parity- og verifikationsværktøjer.
docs	Aktive data-, kvalitets- og driftsaftaler.

Se dokumentationsoversigten for dataaftaler, kvalitet og drift.