Files

T

Claude 031d6d5a3d All produktdokumentation på engelska som källa

De återstående dokumenten — VISION, MVP, DEMO, DRIFT och MASTER-PROMPT —
får engelska versioner, och de svenska blir översättningar med samma
notis som systembeskrivningen redan hade. DRIFT.md heter nu
OPERATIONS.md; ett svenskt filnamn på ett engelskt dokument hade varit
inkonsekvent.

Dokumentationen är därmed 33 filer: sexton dokument med engelska som
källa, sexton svenska syskon, och systembeskrivningen dessutom på tyska,
danska och norska.

Två fel hittades under översättningen, båda rättade i bägge språken:

DRIFT.md pekade ut .github/workflows/ci.yml som Guidad Felsöknings CI
och sa tre rader längre ned att samma fil tillhör Semantika och inte
rörs. Det stämde innan CI flyttades till egen Gitea; rätt fil är
.gitea/workflows/felsokning.yml.

MVP.md kallade styrdokumentet Master Prompt v1.0 men länkade till v2.0.

Att översätta ett dokument är den grundligaste läsning det får. Båda
felen hade överlevt flera genomgångar av samma text på svenska.

Kodidentifierare, miljövariabler, sökvägar och UI-etiketter står
oöversatta i de engelska versionerna. Att skriva "Create demo case" i
demomanuset hade gjort manuset obrukbart — knappen heter "Skapa
demoärende".

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012EQg3rJsrQ1ZNTvkzmQAtt

2026-08-04 20:25:45 +00:00

4.4 KiB

Raw Blame History

Märkesspecifika kopplingar

Svensk översättning. Källan är brand-integrations.md (engelska). Vid avvikelse gäller det engelska dokumentet.

Verkstaden har redan sina avtal. Volvo-verkstaden har VIDA, VAG-verkstaden har erWin, den fria verkstaden har en fordonsdataleverantör. Ingen av dem vill att vi ska vara mellanhand för deras abonnemang — och ingen av dem har samma uppsättning som grannen.

Därför konfigurerar kunden själv sina kopplingar under Inställningar → Märkesspecifika kopplingar, med sina egna credentials. Vi tillhandahåller ramen, inte kontot.

Principer

Uppgifterna når aldrig webbläsaren. Samma regel som för plattformens egna API-nycklar: hemligheter bor på servern. Credentials krypteras med AES-256-GCM innan de skrivs till databasen, och API:t returnerar hemliga fält maskerade (••••3456). Klienten kan se att en koppling finns och när den senast fungerade — aldrig vad nyckeln är.

Alla uppslag görs av servern. Klienten skickar en identifierare (VIN eller regnr); servern hämtar uppgifterna, dekrypterar dem i minnet, anropar leverantören och returnerar bara de mappade fordonsfälten.

Fail closed. Saknas krypteringsnyckeln (INTEGRATION_NYCKEL) sparas ingenting — API:t svarar 503 och inställningssidan förklarar varför. Alternativet, att lagra i klartext "så länge", finns inte.

Endast systemadministratören. Att lägga till, ändra och ta bort kopplingar kräver rollen admin. Teknikern kan läsa registret över tillgängliga leverantörer (annars kan inställningssidan inte visa dem) men aldrig någon organisations uppgifter.

Organisationsknutet. Kopplingarna hör till organisationen, precis som ärendedata. Ingen tenant ser en annans.

Leverantörer är data, inte kod

Registret ligger i services/plattform/integrationer.json och kan bytas mot en ConfigMap-mount via INTEGRATIONER_FIL. En leverantör beskrivs helt deklarativt:

{
  "id": "volvo_vida",
  "namn": "Volvo VIDA",
  "falt": [
    { "nyckel": "bas_url", "etikett": "Bas-URL (använd {vin} som platshållare)", "hemlig": false },
    { "nyckel": "api_nyckel", "etikett": "API-nyckel", "hemlig": true }
  ],
  "uppslag": {
    "urlFalt": "bas_url",
    "auth": "header",
    "authHeader": "X-Api-Key",
    "authFalt": "api_nyckel",
    "svarsfalt": { "marke": "make", "modell": "model", "arsmodell": "year" }
  }
}

falt — vad administratören ska fylla i. hemlig: true styr både kryptering och maskering.
uppslag.auth — bearer, header, basic eller query. Inga leverantörsspecifika kodgrenar; all variation ligger i registret.
svarsfalt — mappning från leverantörens JSON (punktnotation stöds) till våra fordonsfält.
nyckeltyp: "regnr" — uppslaget sker på registreringsnummer i stället för VIN. {vin}/{regnr} i URL-mallen ersätts URL-kodat.

Ett nytt märke läggs alltså till genom att beskriva det — inte genom att bygga om applikationen.

Vad ett uppslag gör och inte gör

Uppslaget fyller i fordonsbeskrivningen (märke, modell, årsmodell, motor, växellåda). Det är kontextdata, inte evidens: ett svar från en leverantör är aldrig en utförd kontroll och räknas inte i evidensmotorn. Returnerar leverantören inga kända fält säger systemet det rakt ut i stället för att visa tomma rader.

Varje uppslag skriver senast_testad och senaste_status på kopplingen. Ett utgånget abonnemang syns därför i inställningarna som ett felmeddelande från leverantören, inte som tysta tomma svar.

API

Väg	Metod	Roll	Vad
`/api/integrationer/leverantorer`	GET	inloggad	Registret (fältdefinitioner, inga uppgifter)
`/api/integrationer`	GET	admin	Organisationens kopplingar, hemligheter maskerade
`/api/integrationer`	POST	admin	Spara/uppdatera credentials (krypteras)
`/api/integrationer/{leverantor}`	DELETE	admin	Ta bort
`/api/integrationer/{leverantor}/uppslag`	POST	inloggad	Slå upp VIN/regnr via servern

Fullständigt dokumenterat i services/plattform/openapi.yaml.

Drift

INTEGRATION_NYCKEL är 32 byte hex eller base64 (openssl rand -hex 32), levererad via secret:en felsokning-hemligheter — se OPERATIONS.sv.md. Byts nyckeln måste kopplingarna sparas om; tjänsten visar då inga värden i stället för att gissa.

4.4 KiB Raw Blame History