Databasmodell

Viktiga designbeslut & motivering

• Förbund & flera kommuner: ORGANISATIONER + ORG_KOMMUN modellerar kommunalförbund/gemensam nämnd/egen regi. Stationer är kopplade till både organisation och kommun (passar drift/logistik och statistik). (Jfr SKR:s beskrivning av organisationsformer och SOU/prop.)
• MSB-händelserapport: INSATSER har kategorier/underkategorier, orsak, utfall m.m. som frikopplade kodtabeller. Detta speglar MSB:s händelserapport och möjliggör framtida justeringar utan schemaändring.
• Geodata/PostGIS: både WGS84 (geography(Point,4326)) och SWEREF 99 TM (geometry(Point,3006)) för svensk analys, enligt Lantmäteriet/EPSG.
• LBE-tillstånd: TILLSTAND med typ_kod (enligt MSBFS 2013:3) samt koppling till VERKSAMHETER och handläggare.
• Rakel: fält för talgrupp/loggning i INSATSER; detaljer kan normaliseras vid behov (egna tabeller) enligt nationella riktlinjer.
• ENUM → kodtabeller: Allt som tidigare var ENUM är nu kodstyrt (KOD_TYPER, KODER) för att harmonisera begrepp över många kommuner/förbund och undvika migreringar.
• Personal i flera stationer: PERSONAL_STATION med giltighetsintervall stödjer RiB/hybridbemanning och tillfälliga förflyttningar.
• Insatsresurser: INSATS_FORDON + INSATS_PERSONAL gör tidslinjer/uppdrag spårbara per resurs.
• Resurshantering: FORDON och MATERIEL separeras för att stödja olika typer av resurser. MATERIEL har lagerstyrning med minimunivåer och QR-koder för spårning.
• VB-status: VB_STATUS samlar realtidsinformation om verksamhetsberedskap med koppling till organisation, stationer, fordon och personal.
• Verksamhetsregister: VERKSAMHETER innehåller riskklass, tillsynshistorik och status för effektiv planering och uppföljning.
• Brandskyddskontroll: BRANDSKYDSOBJEKT och BRANDSKYDSKONTROLL separeras för att stödja både objektregister och kontrollplanering. KONTROLL_PROTOKOLL dokumenterar genomförda kontroller.
• Ärenden: ARENDEN kan kopplas till verksamheter och har prioritering och status för effektiv handläggning. ARENDE_HANDLINGAR spårar alla aktiviteter i ärendet.

Exempel på kodtyper (urval)

Detaljerad tabellbeskrivning (urval)

ORGANISATIONER

INSATSER

TILLSTAND (LBE)

VERKSAMHETER

TILLSYNER

BRANDSKYDSKONTROLL

BRANDSKYDSOBJEKT

KONTROLL_PROTOKOLL

FORDON

MATERIEL

VB_STATUS

ÄRENDEN

ÄRENDE_HANDLINGAR

Index, constraints & säkerhet

API-dokumentation (OpenAPI 3.1.1)

RESTful API för räddningstjänstens IT-stöd enligt OpenAPI 3.1.1-specifikationen.

API-översikt

API:et är designat för att stödja alla funktioner i räddningstjänstens IT-stöd med fokus på:

• Insatshantering - Skapa, uppdatera och spåra räddningsinsatser
• Personaladministration - Hantera personal, scheman och kompetenser
• Tillsyn och tillstånd - Verksamhetskontroll och tillståndshandläggning
• Utbildning och övningar - Planera och följa upp utbildningsaktiviteter
• Rapportering - MSB-rapporter och statistik
• Geodata - Platsbaserade tjänster med PostGIS-stöd

Autentisering och säkerhet

{
  "securitySchemes": {
    "BearerAuth": {
      "type": "http",
      "scheme": "bearer",
      "bearerFormat": "JWT"
    },
    "ApiKeyAuth": {
      "type": "apiKey",
      "in": "header",
      "name": "X-API-Key"
    }
  }
}

Huvudendpoints

Exempel på API-anrop

POST /api/v1/insatser
Content-Type: application/json
Authorization: Bearer {jwt_token}

{
  "larmnummer": "L2024-001234",
  "larmtid": "2024-09-15T14:30:00Z",
  "kategori_kod": 1,
  "prioritet_kod": 2,
  "adress": "Storgatan 123, Stockholm",
  "latitud": 59.3293,
  "longitud": 18.0686,
  "beskrivning": "Brand i lägenhet",
  "insatsledare_id": 15
}

GET /api/v1/insatser?kommun_id=1&start_datum=2024-09-01&slut_datum=2024-09-30&status_kod=1
Authorization: Bearer {jwt_token}

GET /api/v1/insatser/nearby?lat=59.3293&lng=18.0686&radius=5000
Authorization: Bearer {jwt_token}

Svarformat och felhantering

{
  "success": true,
  "data": {
    "insats_id": 123,
    "larmnummer": "L2024-001234",
    "status": "Pågående",
    "created_at": "2024-09-15T14:30:00Z"
  },
  "meta": {
    "total": 1,
    "page": 1,
    "per_page": 20
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Ogiltig data",
    "details": [
      {
        "field": "larmnummer",
        "message": "Larmnummer är obligatoriskt"
      }
    ]
  },
  "timestamp": "2024-09-15T14:30:00Z"
}

HTTP-statuskoder

Rate Limiting

Versionering

Teknisk implementation (rekommendation)

• Databasmotor: PostgreSQL 15+ med PostGIS.
• Geometri: lagra både WGS84 och SWEREF 99 TM (EPSG:3006). Transformera vid ETL enligt Lantmäteriets riktlinjer.
• Fulltextsök: pg_trgm + tsvector för ärenden/rapporter.
• Partitionering: årsvis partition på INSATSER(larmtid) för storskalig historik (100k+/år nationellt).
• Integrationer: utskicksjobb för händelserapport/uppdatering till MSB och automatisk korrigering vid ny utredning.
• Rakel: separata tabeller vid behov för talgruppsloggar samt korsorg-samverkan enligt riktlinjer.