alva/felsokning/docs/VAD-AR-ALVA.txt

========================================================================
 VAD ALVA ÄR OCH VAD VI HAR BYGGT
 ALVA 3.6 · 2026-08-07 · uppdateras vid varje utgåva
========================================================================

1. VAD ALVA ÄR
------------------------------------------------------------------------
ALVA är en professionell plattform för guidad fordonsfelsökning i
verkstad. Namnet är metoden: Analysis, Localization, Verification,
Action — fyra faser som varje ärende går igenom, i den ordningen.

Problemet ALVA finns för: felsökning i verkstad dokumenteras i dag i
efterhand, ur minnet, i fritext. Det gör diagnosen omöjlig att granska,
garantiärenden svaga och kunskapen omöjlig att återanvända. ALVA vänder
på det — dokumentationen skapas MEDAN arbetet utförs, som en följd av
att metoden följs, inte som ett extra moment efteråt.

Kärnregeln, som allt annat hänger på: ETT ÄRENDE SOM INTE KAN GRANSKAS
I EFTERHAND ÄR INTE KLART. Systemet säger aldrig "kom ihåg att
dokumentera" — det släpper helt enkelt inte igenom ett avslut förrän
beviskraven är uppfyllda. Detta upprätthålls tekniskt (grindar på
servern), inte som råd i gränssnittet.

Vad ALVA aldrig gör: den ställer inte diagnosen åt teknikern, den
ersätter inte tillverkarnas diagnossystem (ODIS, DISS, SAGA2 och
motsvarande), och den gissar aldrig. ALVA bär metoden och bevispaketet;
människan och tillverkarverktygen gör sitt.

2. METODEN
------------------------------------------------------------------------
Varje ärende drivs genom de fyra faserna med grindade steg:

  ANALYSIS      Symptomet i kundens egna ord (vad/när/var, aldrig
                omskrivet), objektidentifiering med registerslagning,
                mätarställning med fotokrav, historikkontroll,
                symptomverifiering (reproducera felet FÖRE diagnos).
  LOCALIZATION  Metodikstyrd inringning: mätningar, kontroller,
                observationer — varje kontroll med evidenskrav
                (mätvärde, foto eller motiverad kommentar).
  VERIFICATION  Felorsaken beläggs: avvikelse, orsakskedja, underlag,
                konfidens. Slutsatsen tvingar fram VARFÖR, inte bara
                vad (ALVA-RULE-200).
  ACTION        Åtgärd, kvalitetskontroll ("symptomet verifierat
                avhjälpt"), provkörning med dokumentationskrav,
                förseglat avslut.

Säkerheten står alltid först: högvoltsarbete kräver skyddsutrustning,
frånskiljning, väntetid och uppmätt spänningsfrihet (CAT III-instrument,
prova–mät–prova) INNAN något annat får göras; köldmediearbete kräver
f-gascertifikat; spärrfrågorna ställs både i klienten och på servern.

3. VAD SOM ÄR BYGGT — DELARNA
------------------------------------------------------------------------
METODIKBIBLIOTEKET. 16 metodiker, 176 kontroller som täcker de vanliga
verkstadsfallen: startproblem/laddning, högvolt (el/hybrid), bromsar,
hjulupphängning/styrning, vibrationer, missljud, läckage, avgaser,
klimat, kyla, motor/drivlina, elsystem, ADAS-kalibrering, med flera,
plus ett generiskt skyddsnät. Varje steg vet vilken fas det tillhör och
faserna får aldrig gå baklänges. Innehållet är tekniskt fackgranskat av
sex oberoende domängranskningar (ALVA-DOC-0009); granskningsprotokollet
för marknadsvisa, namngivna granskare finns i ALVA-DOC-0010.

HÄNDELSELOGGEN. Allt som händer i ett ärende är händelser i en
append-only-logg med slutet schema: ingenting ändras eller raderas i
efterhand, varje händelse hashkedjas och avslutet förseglas
kryptografiskt. Spårbarhetspaketet kan lämnas ut och verifieras av
tredje part. Personuppgifter hanteras med kryptoradering och gallring
per ärendetyp.

REGELPAKETEN (ECM Knowledge Library). Vilka bevis som krävs per
ärendetyp — garanti, försäkring, vagnskadegaranti, förlängd garanti,
leasing/fleet, goodwill, internt, kund — är data, inte kod: ett
signerat regelpaket som klient och server läser gemensamt och som kan
distribueras uppdaterat utan ny programvara.

GARANTISTANDARDEN FGS-1.0 (ALVA 3.6). Betalarspåret: vem som betalar
(fabriksgaranti, vagnskadegaranti, försäkringsbolag, extern
garantigivare, leasing, goodwill, kund) registreras med referens och
godkännande, och beviskraven följer betalaren. Eskaleringar till
tillverkare/garantigivare är grindade — en öppnad eskalering utan
dokumenterat svar spärrar avslutet. Reservdelar dokumenteras med
artikelnummer, serienummer, batch och markering att utbytt del sparas
i väntan på garantibeslut. Claim- och skadenummer kan komma ur
betalarregistreringen eller skannad arbetsorder. Kunden ser åtgärden,
inte förhandlingen med betalaren (delningsfiltret). Kartläggningen mot
standarden: ALVA-DOC-0011.

AI-ORKESTERN. En egen tjänst som ger metodikstöd och sammanfattningar.
AI:n föreslår och sammanfattar — den ställer aldrig diagnosen och kan
aldrig uppfylla ett beviskrav åt teknikern.

WEBBPLATS OCH KUNDPORTAL. Samma system, samma komponentbibliotek —
inloggningen byter aldrig värld. Publika webben talar besökarens språk
(tio språk); portalen är produkten och talar organisationens språk.
Portalen: Dashboard, Analysis (nyckeltal ur riktiga ärenden), Warranty
och Insurance (registervyer med det juridiska skiljt från det
avtalade), Diagnostics (verktyget), och Settings — kunskapskällor,
integrationer, abonnemang, fakturor och supportärenden, samlade under
en egen översikt med beskrivna, klickbara områden.

AFFÄRSFLÖDET. Ansökan granskas av människa, faktura utfärdas ur
systemet (ingen betalleverantör, ingen kortinmatning), betalning
registreras, organisationen aktiveras. Abonnemangsnivåer med
respitdagar; obetalt stänger aldrig läsning eller export.

SPRÅKEN. Tio språk: engelska (källspråk), svenska, danska, norska,
finska, tyska, franska, nederländska, polska, portugisiska, rumänska —
strukturorden (fasnamn, statusord) är avsiktligt invarianta på
engelska, som i annan verkstadsstandard. Fullständig språkrevision
genomförd (ALVA-DOC-0008); ordlistor för orsaks- och evidensspråk per
språk. "Granskat"-flaggan per språk sätts endast av namngiven
marknadsgranskare enligt protokoll — den är ett påstående om
människor, inte om maskiner.

4. TEKNIKEN
------------------------------------------------------------------------
Klient: React + TypeScript (Vite), nästan monokrom industridesign på
8-pixelrutnät, DIN-typografi, fyra ikontecken, ingen animation.
Tjänster: Node utan ramverk — plattformstjänsten (auth, händelse-API,
delning, fakturering) och AI-orkestern, med delad domänkod i ren
JavaScript (metodiker, grindar, språk, statistik) som körs identiskt i
klient och server. Databas: PostgreSQL med append-only-triggrar.
Bilagor i S3. Allt är egenhostat — ingen extern byggtjänst, inget
externt register.

INFRASTRUKTUREN PÅ AWS, i två Terraform-lager:
  Basen (infra/aws): VPC i tre lager där databasen saknar väg ut,
  EKS med IRSA, Aurora PostgreSQL, S3 utan raderingsrätt för bilagor,
  ECR med oföränderliga bildtaggar, tre egna KMS-nycklar, Secrets
  Manager (Terraform ser aldrig ett hemligt värde), Route 53/ACM,
  CloudWatch-larm — varav ett larmar på UTEBLIVEN backupmätpunkt.
  Arbetslasten (infra/terraform): tjänsterna som poddar, ALB-ingress,
  nätverkspolicyer, External Secrets, självhostad Gitea med egna
  byggrunners. Hela systemet beskrivs som data i karta.tf och
  "terraform output karta" skriver ut vad som kör var.

DRIFTSÄTTNINGSPAKETEN (deploy/): hela plattformen paketeras med ett
skript i numrerade zip-paket för agentdriven driftsättning, i ordning:
00 plan+summor, 01 AWS-basen, 02 backendbilderna, 03 webbklienten
(källa + resursdelar under kanalens storleksgräns, styckade filer
återskapas mot summakontroll), 04 arbetslasten, 05 slutkontrollen.
Varje paket bär sin egen agentanvisning med steg, verifiering och
stoppvillkor.

5. KVALITETSARBETET — HUR VI VET ATT DET STÄMMER
------------------------------------------------------------------------
Regeln är densamma överallt: grönt utan träffkrav är inte grönt, och
ett steg utan verifiering är inte utfört.

  · ~790 enhetstester som låser beteende OCH principer: schemat är
    slutet, faserna går aldrig baklänges, 8-pixelrutnätet håller,
    språkkatalogerna är kompletta och inte engelska i förklädnad,
    klientens och serverns regelpaket är identiska.
  · Genomgången: fyra kompletta ärenden körs i riktig webbläsare mot
    riktigt bygge, inom interaktionsbudget, med telefonmätning av
    varje vy (inget sidledsspill vid 390 px).
  · Portalspärren: bevisar i webbläsare att portalen är stängd utan
    giltig session — inte bara att vakten finns i koden.
  · Integrationstest av hela ärendeflödet mot servern, och
    återställningstest som bevisar att säkerhetskopian går att läsa
    tillbaka.
  · Oberoende granskningar bokförda i docs/: kvalitetsrevisioner,
    TÜV-granskningar, panelgranskning, språkrevision, teknisk
    fackgranskning. Fynd åtgärdas med belägg eller bokförs öppet med
    skäl — ingenting försvinner tyst.

6. VERSIONSHISTORIK I KORTHET
------------------------------------------------------------------------
  1.0–1.3  Metoden, ärendeflödet, grindarna, spårbarheten.
  2.0–2.1  Plattformstjänsten, portalen, affärsflödet.
  3.0–3.4  Tio språk, regelpaketen, integrationer, AWS-infrastrukturen,
           revisionsrundor med åtgärder.
  3.5      Teknisk fackgranskning av metodikinnehållet: säkerhets-
           sekvenser skärpta (högvolt, klimat, bränsle), fel metod
           ersatt med rätt, 23 nya kontroller, referensvärden.
  3.6      Garantistandarden FGS-1.0: betalarspår, grindade
           eskaleringar, reservdelsdokumentation, tre nya ärendetyper.
           Dessutom: flerspråkig publik webb, tvånivåmeny i portalen,
           driftsättningspaketen.

7. VAR ALLT LIGGER
------------------------------------------------------------------------
  felsokning/app                 Webbklient (webbplats, portal, verktyg)
  felsokning/services/gemensam   Delad domänkod: metodiker, grindar,
                                 språk, versioner, statistik
  felsokning/services/plattform  Plattformstjänsten + integrations-
                                 och återställningstest
  felsokning/services/ai-orkester AI-tjänsten
  felsokning/infra/aws           Terraform: AWS-basen
  felsokning/infra/terraform     Terraform: arbetslasten
  felsokning/deploy              Driftsättningspaketeringen
  felsokning/docs                All dokumentation, granskningar och
                                 revisionshistorik (börja i
                                 ALVA-SYSTEMBESKRIVNING.md)

========================================================================
 Ett ärende som inte kan granskas i efterhand är inte klart.
========================================================================