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

3.0 KiB
Raw Blame History

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.