Files
alva/felsokning/docs/moduler/arbetslogg-och-tidredovisning.md
T
Claude 301c477e25 Merge main: Guidad Felsökning flyttar ur roten till felsokning/
Main är sedan den här grenen skapades en helt annan produkt — Semantika,
en mobilapp med egen CDK-infrastruktur. Den äger nu repots rot: en
npm-workspaces-monorepo med apps/mobile, services/api och infra.

För att båda ska rymmas i samma repo flyttar Guidad Felsökning in i en
egen katalog i stället för att göra anspråk på roten:

  felsokning/app        webbklienten (Vite, egen package.json och
                        eslint-/vitest-konfiguration)
  felsokning/services   plattformstjänsten och AI-orkestern
  felsokning/infra      Terraform och databasschemat
  felsokning/docs       vision, moduler, drift
  felsokning/supabase   edge-funktion och migrationer

Merge:n hade tagit bort 128 filer som Guidad Felsökning bygger på —
värdapplikationens komponenter, Supabase-klienten, tillgångar — eftersom
main raderat dem och den här grenen inte råkat ändra just dem. De är
återställda på sin nya plats. Utan dem gick varken bygget eller
testerna: ai.ts och synk.ts importerar Supabase-klienten.

Semantikas rotfiler är orörda: package.json, eslint.config.js och
.github/workflows/ är deras. Guidad Felsökning har egna motsvarigheter i
sin katalog.

CI flyttar samtidigt från GitHub Actions till .gitea/workflows — samma
syntax, egna runners. .github/workflows/ tillhör Semantika härefter.

Verifierat på den nya platsen: 96 vitest-tester, typkontroll, eslint på
både klient och tjänster, bygge, och integrationstest mot riktig Postgres.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012EQg3rJsrQ1ZNTvkzmQAtt
2026-08-04 12:22:49 +00:00

129 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Modul: Arbetslogg & Tidredovisning
## Syfte
Allt arbete som utförs under ett felsökningsärende ska vara tidsatt, spårbart och kopplat till konkreta aktiviteter.
Systemet registrerar inte bara hur lång tid ett arbete tagit, utan även vad som utförts under tiden.
Det här är mer än en stämpelklocka ett digitalt arbetsprotokoll där tid, aktivitet och tekniskt resonemang hänger ihop. Det ger ett betydligt starkare underlag än traditionell tidrapportering.
---
## Start av arbete
Teknikern börjar genom att identifiera objektet.
Exempel:
- Foto av registreringsnummer
- VIN-skanning
- QR-kod
- Serienummer
- Maskinnummer
När objektet är verifierat startar arbetsloggen.
Exempel:
```
08:03 Arbete startat
Objekt: ABC123
Volvo XC60
```
---
## Automatisk tidslinje
Alla aktiviteter tidsstämplas automatiskt.
Exempel:
```
08:03 Objekt identifierat
08:05 Felbeskrivning registrerad
08:11 Säkring F23 kontrollerad
08:18 Mätning av matningsspänning
08:27 Foto uppladdat
08:35 Direktmatning utförd
08:48 Elschema öppnat
09:01 Ny kontroll
09:09 Felsökning avslutad
```
Ingen manuell administration krävs.
---
## Aktiv arbetstid
Systemet skiljer på:
- aktiv felsökning
- väntetid
- administrativ tid
- reservdelssökning
- provkörning
- kundkontakt
Det ger en mer rättvisande tidsredovisning.
---
## Kontext vid längre avbrott
Om det gått en längre stund utan aktivitet kan systemet fråga efter sammanhang, exempelvis:
> ”Ingen aktivitet har registrerats de senaste 20 minuterna. Beskriv kort vad som gjorts under denna period.”
Teknikern kan svara med text eller tal, till exempel:
> ”Demonterade instrumentpanelen för att komma åt kabelstammen.”
Det blir en del av arbetsloggen.
---
## AI som dokumentationsstöd
AI bedömer inte om teknikern arbetar ”tillräckligt snabbt”. Däremot hjälper den till att säkerställa att loggen blir begriplig och komplett. Om ett steg saknar sammanhang kan den be om ett kort förtydligande så att rapporten blir användbar för kunden eller den egna organisationen.
---
## Slutrapport
När arbetet avslutas genereras automatiskt en rapport med exempelvis:
**Total tid: 1 timme 37 minuter**
Fördelning:
- Diagnos: 54 min
- Demontering: 18 min
- Mätningar: 11 min
- Dokumentation: 6 min
- Provkörning: 8 min
Rapporten innehåller även:
- utförda kontroller,
- mätvärden,
- bifogade bilder,
- tekniska slutsatser,
- rekommenderade nästa steg.
---
## Affärsvärde
Den här funktionen kan bli ett av systemets starkaste argument, eftersom den:
- minskar administration efter avslutat arbete,
- ger kunden ett tydligt underlag för debiteringen,
- stärker underlaget vid garanti- och försäkringsärenden,
- gör intern uppföljning enklare,
- skapar en sökbar kunskapsbank över tidigare felsökningar.
Det gör att Guidad Felsökning blir mer än en AI-assistent den blir ett komplett arbetsverktyg där identifiering, metodisk felsökning, dokumentation och tidredovisning bildar en sammanhängande och spårbar process.