olemd/tilfluktsrom
1
0
Fork 0
Code Issues 10 Pull requests Projects Releases 11 Packages Wiki Activity Actions
tilfluktsrom/README.md
Ole-Morten Duesund da7917d17b Legg til README med prosjektbeskrivelse på norsk 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-08 18:24:19 +01:00

3.3 KiB
Raw Blame History

Tilfluktsrom

Finn nærmeste offentlige tilfluktsrom i Norge. Appen er bygd for nødsituasjoner og fungerer uten internett etter første gangs bruk.

Funksjoner

  • Finn nærmeste tilfluktsrom — viser de tre nærmeste tilfluktsrommene med avstand og kapasitet
  • Kompassnavigasjon — retningspil som peker mot valgt tilfluktsrom
  • Frakoblet kart — kartfliser lagres automatisk for bruk uten nett
  • Velg fritt — trykk på en hvilken som helst markør i kartet for å navigere dit
  • Flerspråklig — engelsk, bokmål og nynorsk

Plattformer

Android-app (app/)

Native Kotlin-app med OSMDroid-kart og Room-database.

  • Minstekrav: Android 8.0 (API 26)
  • Bygg: ./gradlew assembleDebug
  • Installer: adb install app/build/outputs/apk/debug/app-debug.apk

Nettapp / PWA (pwa/)

Progressiv nettapp med Vite, TypeScript og Leaflet. Kan installeres på alle enheter via nettleseren.

  • Avhengigheter: bun install
  • Hent tilfluktsromdata: bun run fetch-shelters
  • Utviklingsserver: bun run dev
  • Bygg for produksjon: bun run build
  • Kjør tester: bun test

Datakilde

Tilfluktsromdata lastes ned fra Geonorge som GeoJSON i UTM33N-projeksjon (EPSG:25833). Koordinatene konverteres til WGS84 (bredde-/lengdegrad) for visning i kartet.

Datasettet inneholder ca. 556 offentlige tilfluktsrom med adresse, romnummer og kapasitet (antall plasser).

Arkitektur

tilfluktsrom/
├── app/                    # Android-app (Kotlin)
│   └── src/main/
│       ├── java/.../
│       │   ├── data/       # Room-database, nedlasting, GeoJSON-parser
│       │   ├── location/   # GPS, nærmeste tilfluktsrom
│       │   ├── ui/         # Retningspil, liste-adapter
│       │   └── util/       # UTM→WGS84-konvertering, avstandsberegning
│       └── res/            # Layout, strenger (en/nb/nn), ikoner
├── pwa/                    # Nettapp (TypeScript)
│   ├── src/
│   │   ├── data/           # IndexedDB-cache
│   │   ├── location/       # GPS, kompass
│   │   ├── ui/             # Kart, kompass, liste
│   │   ├── cache/          # Kartfliser for frakoblet bruk
│   │   └── i18n/           # Oversettelser
│   └── scripts/            # Bygg-tidsskript for datakonvertering
└── CLAUDE.md               # Prosjektdokumentasjon for AI-assistert utvikling

Frakoblet bruk

Appen er designet etter «offline-first»-prinsippet:

  1. Tilfluktsromdata lagres lokalt etter første nedlasting (Room / IndexedDB)
  2. Kartfliser caches automatisk for området rundt brukeren
  3. GPS og kompass fungerer uten internett
  4. Data oppdateres automatisk i bakgrunnen når det er eldre enn 7 dager

Sikkerhet

  • All nettverkstrafikk går over HTTPS
  • Tilfluktsromdata valideres ved parsing (koordinater innenfor Norge, gyldige felt)
  • Databaseoppdateringer er atomiske (transaksjon) for å unngå datatap
  • Ingen persondata lagres — kun tilfluktsromdata og kartfliser

Lisens

Tilfluktsromdata er åpne data fra Geonorge / Direktoratet for samfunnssikkerhet og beredskap (DSB). Kartfliser fra OpenStreetMap er lisensiert under ODbL.