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

3.7 KiB

Raw Permalink Blame History

Guidad Felsökning – Demomanus

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

Ett 5–10 minuters manus för att visa plattformen. Allt körs lokalt utan konton eller nycklar.

Förberedelser

npm install
npm run dev

Öppna http://localhost:8080/felsokning — helst på mobil eller i mobilläge i webbläsaren (appen är byggd för verkstadsgolvet). Ange ett namn (allt loggas per användare).

Chrome rekommenderas: då fungerar även röstinmatningen (Push-to-Talk).

Demoflöde

1. Dashboarden och demoärendet (1 min)

Klicka Skapa demoärende (Volvo XC60, vibration). Ett komplett ärende med 1 tim 35 min arbetshistorik läggs in: identifierat objekt, besvarade symptomfrågor, fyra hjulfoton, mätvärden, provkörning, en överlämning mellan två tekniker och en hypotes.

Poäng att göra: dashboarden visar bara det viktigaste — pågående, klara, nytt ärende.

2. Ärendebriefen (2 min)

Öppna ärendet → fliken Brief. Det här är kärnargumentet:

Utförda kontroller med resultat — inte bara kryssrutor.
Ej kontrollerat — härlett automatiskt ur metodiken; det som orsakar dubbelarbete vid skiftbyte är det ingen skrivit ner att ingen gjort.
Hypoteser tydligt märkta 🔴 — systemet presenterar aldrig en hypotes som ett konstaterat fel.
Tillförlitlighet och total arbetstid.

Poäng: en ny tekniker är produktiv på under en minut, utan att läsa hundratals loggrader.

3. Guiden och verifierade checklistor (2 min)

Fliken Guide. Metodiken fortsätter där den slutade: en fråga eller kontroll i taget, stora knappar.

Visa att en mätkontroll inte kan verifieras utan mätvärde (knappen är låst tills värdet är ifyllt).
Tryck på 🎤 och diktera en observation — texten hamnar i fältet, redigerbar, och sparas först när man trycker Spara. Tal in, text ut; inget skickas automatiskt.
Visa kategoriknapparna (aktiv felsökning / väntetid / provkörning …) — tidrapporteringen sköter sig själv.

4. Arbetsloggen (1 min)

Fliken Logg: varje händelse tidsstämplad med användare, append-only — ingenting kan ändras eller raderas i efterhand. Peka på överlämningen mellan Anna och Johan.

Fliken Rapport:

Skriv ut / PDF — rapporten blir svart på vitt automatiskt.
Exportera JSON — versionsmärkt (version = antal händelser), och exporten loggas själv.
Öppna Live Share-vy — det kunden ser via delningslänken: status ✔/🔄/⏳, bilder, mätvärden, tidslinje. Inga hypoteser, inga interna poster.

Poäng: i stället för "Felsökning – 2,5 timmar" på fakturan får kunden en tidslinje över vad som faktiskt gjorts.

6. Avsluta med filosofin (30 sek)

Systemet dokumenterar observationer, leder användaren genom verifierbara kontroller och rekommenderar nästa steg — men presenterar aldrig en hypotes som ett konstaterat fel.

Det ersätter inte teknikern. Det ersätter pärmen, minneslapparna och "fråga Kent, han skruvade på den i torsdags".

Vad som är demoläge respektive produktion

I demon	I produktion
Deterministisk metodikmotor (16 metodiker)	LLM väljer/genererar steg genom samma motorgränssnitt
Webbläsarens taligenkänning	Leverantörens Voice-to-Text bakom samma gränssnitt
localStorage + synk vid inloggning	Multi-tenant-backend (migration finns), roller enligt Master Prompt
Delningslänk kräver synkat ärende	Live Share med behörighetsnivåer kund/intern/partner
Demobilder ritade av systemet	Riktiga foton via kameran (fungerar redan i demon också)

3.7 KiB Raw Permalink Blame History Unescape Escape