Claude
e8cf6db236
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
109 lines
4.6 KiB
Markdown
109 lines
4.6 KiB
Markdown
# 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.
|