Evidensmotor (ECM v1.0): ingen slutsats utan underlag

Regelmotorn kodar plattformens viktigaste princip: systemet får aldrig
anta att en kontroll är utförd eller att dokumentation finns. Varje
påstående måste kunna härledas till evidens i händelseloggen.

- Nytt versionshanterat regelbibliotek (src/felsokning/ecm.ts, ECM v1.0):
  evidensnivåer E0–E6 härledda ur loggen, fullbordansregler och
  kvalitetsgrind — skilt från applikationslogiken
- Fullbordansregel i guiden: en kontroll slutförs med evidens ELLER
  uttryckligt undantag "Underlag kan inte tas fram" med obligatorisk
  orsak — loggas och flaggas ⚠ i brief, överlämning och rapport
- Kvalitetsgrind före slutrapport: utskriften spärrad tills
  objektidentifiering, metodikens kontroller, fotokrav och evidensnivå
  är gröna; varje röd rad visar exakt vad som saknas
- Orkesterns grundprompt utökad: aldrig "OK/kontrollerad/inga fel" utan
  evidens — skriv "Evidens saknas" och begär rätt underlag (foto/video/
  mätvärde/skärmfoto)
- Visual-first instrumentavläsning: ny vision-uppgift läser multimetrar,
  diagnosskärmar m.m. — värden/enheter/felkoder med konfidens, teknikern
  bekräftar, originalbilden loggas alltid bredvid strukturerad data;
  kameran är integrationslagret, inga verktygsintegrationer krävs
- Terminologi: "AI" ersatt med systemspråk i hela gränssnittet
  (Beslutsstöd, Systemet analyserar, Granskning av underlaget …)
- Dokumentation: docs/moduler/evidensmotor.md; 41 vitest-tester

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

docs/moduler/evidensmotor.md

@@ -0,0 +1,108 @@
+# Modul: Evidensmotorn (ECM — Evidence & Compliance Matrix)
+
+**Version: ECM v1.0** · Regelbiblioteket är versionshanterat och skilt från
+applikationslogiken (`src/felsokning/ecm.ts`). Vyerna anropar bara motorns
+rena funktioner — regler kan uppdateras utan att applikationen byggs om.
+
+## Grundprincip
+
+**Inget underlag = ingen slutsats.**
+
+Systemet får aldrig anta att en kontroll är utförd eller påstå att
+dokumentation finns om den inte faktiskt är insamlad. Varje påstående i
+diagnos, brief och slutrapport ska kunna härledas till minst en
+evidenspost i händelseloggen. Systemet skriver aldrig "OK",
+"kontrollerad", "inga fel" eller "åtgärdad" utan evidens — i stället:
+**"Evidens saknas."** Regeln är kodad i orkesterns grundprompt och kan
+inte kringgås från klienten.
+
+## Evidensnivåer
+
+| Nivå | Typ | Bevisvärde |
+| --- | --- | --- |
+| E0 | Inget underlag | 0 % |
+| E1 | Teknikerns observation | Lågt |
+| E2 | Foto | Medel |
+| E3 | Video | Högt |
+| E4 | Mätvärde | Högt |
+| E5 | Diagnosdata/dokument (t.ex. skannad arbetsorder) | Mycket högt |
+| E6 | Flera oberoende källor | Högsta |
+
+Ärendets nivå härleds ur loggens faktiska innehåll (`evidensNiva`) och
+visas i kvalitetsgrinden.
+
+## Fullbordansregler
+
+En kontrollpunkt kan bara slutföras när något av följande är sant:
+
+1. **Krävd evidens är insamlad** — foto för det synliga, mätvärde för det
+   som mäts, kommentar där inget bättre är möjligt (metodikens
+   `krav`-fält per kontroll).
+2. **Teknikern dokumenterar ett undantag**: *"Underlag kan inte tas
+   fram"* med **obligatorisk orsak** (komponenten oåtkomlig, fordonet kan
+   inte lyftas säkert, kunden avböjde demontering, dålig sikt, utrustning
+   saknas — eller fri text). Undantaget loggas i händelseloggen och
+   flaggas ⚠ i brief, överlämning och rapport — det redovisas aldrig som
+   "utförd".
+
+## Kvalitetsgrind före slutrapport
+
+Slutrapporten kan inte genereras förrän grinden är godkänd
+(`kvalitetsgrind`/`grindGodkand`):
+
+| Kontroll | Krav |
+| --- | --- |
+| Fordons-/objektidentifiering verifierad | Obligatorisk |
+| Arbetsorder inläst | Rekommenderas |
+| Metodikens kontroller: evidens eller dokumenterat undantag | Obligatorisk |
+| Foton finns för fotokrävande kontroller | Obligatorisk |
+| Hypoteser redovisas som ej verifierade | Informativ (alltid sant per konstruktion) |
+| Evidensnivå över E0 | Obligatorisk |
+
+Utskriftsknappen är spärrad tills varje obligatorisk rad är grön; varje
+röd rad visar exakt vad som saknas.
+
+## Visual-first: kameran är integrationslagret
+
+Plattformen prioriterar visuell insamling framför systemintegrationer.
+När information redan visas på en skärm, ett instrument, en utskrift
+eller en etikett fotograferas den — bildtolkningen extraherar, validerar
+och strukturerar informationen automatiskt. Ingen specialintegration
+behövs mot Bosch, TEXA, Autel, Launch, Hella Gutmann m.fl. så länge en
+människa kan läsa informationen.
+
+- **Arbetsorder** → ärendestartens dokumenttolkning (fält + konfidens).
+- **Instrument/diagnosskärmar** → `📷 Instrument` i Dokumentera-panelen:
+  foto → typidentifiering (multimeter, diagnosdator, batteritestare,
+  mätarkluster, manometer …) → värden med enhet och konfidens → teknikern
+  bekräftar → **originalbilden loggas alltid tillsammans med de
+  strukturerade värdena** — strukturerad data ersätter aldrig
+  originalevidensen.
+
+Värden med hög säkerhet godkänns automatiskt; osäkra markeras för
+granskning — samma konfidensmodell som arbetsorderskanningen
+(🟢 ≥95 %, 🟡 80–95 %, 🔴 <80 %).
+
+## Spårbarhet
+
+Varje evidenspost är en händelse i den append-only-loggen med tidpunkt,
+tekniker, ärende och innehåll — omöjlig att ändra i efterhand (triggers i
+databasen). Det ger varje slutsats juridiskt spårbart underlag för kund,
+försäkringsbolag eller domstol.
+
+## Terminologi
+
+Produkten beskrivs aldrig som en "AI-app" utan som ett **evidensbaserat
+diagnossystem** / **intelligent beslutsstöd**. I användargränssnitt och
+dokument används *systemet, analysen, bedömningen, tolkningen,
+bildtolkningen, beslutsstödet, regelmotorn* — inte "AI", om det inte är
+tekniskt nödvändigt (t.ex. i arkitekturdokumentation om modellorkestern).
+
+## Kommande (regelbibliotekets väg framåt)
+
+- Områdesregler per komponent (däck: fyra bilder + DOT + dimension;
+  bromsar: närbild per ok; motorljud: video med ljud …) som
+  serverdistribuerade, versionerade regelpaket.
+- Video- och ljudevidens (E3) med analys.
+- Garanti-/försäkrings-/reklamationsprofiler med egna obligatoriska
+  fält i kvalitetsgrinden.