======================================================================== 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. ========================================================================