From 9872f3bf4752a9511fa9fbb815cbf25efcf0047d Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 7 Aug 2026 13:54:01 +0000 Subject: [PATCH] VAD-AR-ALVA.txt: hela systemet beskrivet i en textfil MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fristående klartextbeskrivning av vad ALVA är och vad som är byggt, till och med 3.6: metoden, delarna, tekniken, AWS-infrastrukturen, driftsättningspaketen, kvalitetsarbetet, versionshistoriken och var allt ligger. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_012EQg3rJsrQ1ZNTvkzmQAtt --- felsokning/docs/VAD-AR-ALVA.txt | 198 ++++++++++++++++++++++++++++++++ 1 file changed, 198 insertions(+) create mode 100644 felsokning/docs/VAD-AR-ALVA.txt diff --git a/felsokning/docs/VAD-AR-ALVA.txt b/felsokning/docs/VAD-AR-ALVA.txt new file mode 100644 index 0000000..313421c --- /dev/null +++ b/felsokning/docs/VAD-AR-ALVA.txt @@ -0,0 +1,198 @@ +======================================================================== + 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. +========================================================================