Claude
031d6d5a3d
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
184 lines
6.4 KiB
Markdown
184 lines
6.4 KiB
Markdown
# Guidad Felsökning
|
||
|
||
> **Svensk översättning.** Källan är [VISION.md](VISION.md) (engelska).
|
||
> Vid avvikelse gäller det engelska dokumentet.
|
||
|
||
> Styrdokument för utveckling: [Master Prompt v2.0](MASTER-PROMPT.sv.md)
|
||
|
||
## Vision
|
||
|
||
Guidad Felsökning är en professionell diagnostikplattform som steg för steg vägleder tekniker genom en strukturerad felsökningsprocess. Plattformen dokumenterar varje moment, hämtar information från tillverkarens system via användarens egna behörigheter och skapar en komplett, spårbar felsökningshistorik.
|
||
|
||
Systemet ersätter inte teknikerens kompetens – det säkerställer att arbetet utförs metodiskt, dokumenteras korrekt och kan följas i efterhand.
|
||
|
||
Produkten ska inte försöka vara en AI-mekaniker, utan en **digital felsökningshandledare**. Det gör den både mer trovärdig och lättare att använda i professionella miljöer.
|
||
|
||
---
|
||
|
||
## Ledstjärna
|
||
|
||
> **Systemet dokumenterar observationer, leder användaren genom verifierbara kontroller och rekommenderar nästa steg – men presenterar aldrig en hypotes som ett konstaterat fel.**
|
||
|
||
Den principen gör verktyget användbart både för erfarna tekniker och för mindre erfarna användare, samtidigt som det ger ett robust underlag för kunder, verkstäder och framtida analyser. Guidad Felsökning är en digital diagnostikprocess, inte en AI-chat.
|
||
|
||
---
|
||
|
||
## Grundprinciper
|
||
|
||
### 1. Ingen gissning
|
||
|
||
Systemet får aldrig presentera spekulation som fakta.
|
||
|
||
Varje påstående märks med en tillförlitlighetsnivå:
|
||
|
||
- 🟢 **Hög** – verifierat genom mätning, tillverkarinformation eller användarens inmatning.
|
||
- 🟡 **Medel** – logisk slutsats baserad på tillgänglig information.
|
||
- 🔴 **Låg** – hypotes eller möjlig felorsak som kräver verifiering.
|
||
|
||
Om tillräckligt underlag saknas ska systemet uttryckligen säga det.
|
||
|
||
### 2. Identifiera objektet först
|
||
|
||
Ingen felsökning börjar innan objektet identifierats.
|
||
|
||
Identifiering kan ske genom:
|
||
|
||
- registreringsnummer
|
||
- VIN
|
||
- maskinnummer
|
||
- serienummer
|
||
- QR-kod
|
||
- streckkod
|
||
- OCR från typskylt
|
||
- foto av objektet
|
||
- manuell inmatning av objekt-ID
|
||
|
||
När identifieringen är klar visas en tydlig bekräftelse innan felsökningen fortsätter.
|
||
|
||
### 3. Integration med tillverkarsystem
|
||
|
||
Användaren ansluter sina egna behörigheter via API eller motsvarande integrationslösning.
|
||
|
||
Exempel på informationskällor:
|
||
|
||
- tillverkarens verkstadssystem
|
||
- reservdelskataloger
|
||
- elscheman
|
||
- servicebulletiner
|
||
- servicehistorik
|
||
- elektroniska serviceböcker
|
||
- interna DMS-system
|
||
|
||
Guidad Felsökning använder dessa som referens men lagrar inte upphovsrättsskyddad dokumentation om inte användaren eller organisationen har rätt att göra det.
|
||
|
||
### 4. Samtalsbaserad guidning
|
||
|
||
Teknikern arbetar naturligt:
|
||
|
||
> ”Jag har mätt.”
|
||
>
|
||
> ”Det finns 13,9 volt.”
|
||
>
|
||
> ”Reläet klickar inte.”
|
||
|
||
Systemet väljer nästa steg utifrån tidigare observationer och den etablerade felsökningsmetodiken.
|
||
|
||
### 5. Fullständig revisionslogg
|
||
|
||
Varje aktivitet registreras.
|
||
|
||
Exempel på loggposter:
|
||
|
||
- tidpunkt
|
||
- användare
|
||
- objekt
|
||
- mätvärden
|
||
- bilder
|
||
- dokument
|
||
- observationer
|
||
- AI:s rekommendation
|
||
- användarens svar
|
||
- nästa steg
|
||
|
||
Ingenting skrivs över. Händelser läggs endast till, vilket ger full spårbarhet.
|
||
|
||
### 6. Export och API
|
||
|
||
Varje avslutat ärende kan exporteras som ett strukturerat felsökningsprotokoll.
|
||
|
||
Det ska även finnas ett API för att:
|
||
|
||
- hämta loggar
|
||
- hämta rapporter
|
||
- koppla mot DMS
|
||
- koppla mot affärssystem
|
||
- koppla mot ERP
|
||
- koppla mot elektroniska serviceböcker
|
||
- koppla mot garantiadministration
|
||
|
||
På så sätt blir Guidad Felsökning en komponent i befintliga arbetsflöden, inte ett isolerat system.
|
||
|
||
---
|
||
|
||
## Moduler
|
||
|
||
Utöver grundprinciperna byggs plattformen upp av moduler som specificeras separat:
|
||
|
||
- [Arbetslogg & Tidredovisning](modules/work-log-and-time-tracking.sv.md) – tidsatt, spårbart arbete kopplat till konkreta aktiviteter; ett digitalt arbetsprotokoll där tid, aktivitet och tekniskt resonemang hänger ihop.
|
||
- [Delningsbar kundrapport (Kundvy)](modules/customer-report.sv.md) – en tydlig tidslinje med bilder, mätvärden och kommentarer som visar kunden vad de faktiskt betalat för.
|
||
- [Ärendebrief](modules/case-brief.sv.md) – en löpande uppdaterad arbetsbild av ärendet som gör att en ny tekniker blir produktiv på under en minut; fleranvändararbetsyta med överlämning med ett klick.
|
||
- [Kommunikationsmodell (röst)](modules/communication-model.sv.md) – tal in, text ut via Push-to-Talk; röst är ett inmatningssätt, inte ett separat gränssnitt, och inget skickas utan bekräftelse.
|
||
- [Verifierade checklistor](modules/verified-checklists.sv.md) – en kontrollpunkt är inte slutförd genom en kryssruta; varje kontroll samlar bevis och kontext med minimikrav per kontrolltyp.
|
||
- [Live Share](modules/live-share.sv.md) – behörighetsstyrd delningslänk som visar ärendet i realtid; versionsmärkta exporter ur samma händelselogg.
|
||
|
||
Hur processen fungerar i praktiken illustreras i exempelflödet [”Bilen vibrerar runt 88 km/h”](examples/vibration-at-88-km-h.sv.md).
|
||
|
||
---
|
||
|
||
## Användargränssnitt
|
||
|
||
Gränssnittet ska vara avsiktligt enkelt.
|
||
|
||
Ingen chatt med långa AI-svar.
|
||
|
||
Istället:
|
||
|
||
- en fråga i taget
|
||
- en tydlig rekommenderad åtgärd
|
||
- stora knappar
|
||
- tydliga statusindikatorer
|
||
- hög kontrast
|
||
- få val per skärm
|
||
|
||
Designen ska ge samma känsla som ett modernt fabriksverktyg: funktion före estetik.
|
||
|
||
---
|
||
|
||
## Säkerhet
|
||
|
||
Systemet ska utformas för professionell användning med fokus på informationssäkerhet.
|
||
|
||
Målet är att:
|
||
|
||
- kryptera data under överföring och lagring,
|
||
- logga alla förändringar och åtkomster,
|
||
- stödja rollbaserad behörighetsstyrning,
|
||
- erbjuda säker API-autentisering,
|
||
- möjliggöra export och radering enligt organisationens policy och tillämpliga regelverk.
|
||
|
||
---
|
||
|
||
## Produktfilosofi
|
||
|
||
Den viktigaste principen är att Guidad Felsökning aldrig försöker ersätta teknikern.
|
||
|
||
Den ersätter inte erfarenhet.
|
||
|
||
Den ersätter inte tillverkarens dokumentation.
|
||
|
||
Den ersätter inte verkstadshandboken.
|
||
|
||
Den fungerar som en konsekvent arbetsledare som säkerställer att rätt frågor ställs i rätt ordning, att inga steg förbises och att hela felsökningsprocessen dokumenteras på ett sätt som är spårbart, återanvändbart och enkelt att integrera med övriga verksamhetssystem.
|
||
|
||
Det gör att verkstäder och serviceorganisationer får högre kvalitet, jämnare arbetssätt, bättre kunskapsöverföring mellan tekniker och ett tydligt underlag gentemot kunder, garantihantering och intern uppföljning.
|