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

felsokning/docs/VISION.md

@@ -0,0 +1,180 @@
+# Guidad Felsökning
+
+> Styrdokument för utveckling: [Master Prompt v2.0](MASTER-PROMPT.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](moduler/arbetslogg-och-tidredovisning.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)](moduler/kundrapport.md) – en tydlig tidslinje med bilder, mätvärden och kommentarer som visar kunden vad de faktiskt betalat för.
+- [Ärendebrief](moduler/arendebrief.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)](moduler/kommunikationsmodell.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](moduler/verifierade-checklistor.md) – en kontrollpunkt är inte slutförd genom en kryssruta; varje kontroll samlar bevis och kontext med minimikrav per kontrolltyp.
+- [Live Share](moduler/live-share.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”](exempel/vibration-vid-88-km-h.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.