VAD-AR-ALVA.txt: hela systemet beskrivet i en textfil
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 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012EQg3rJsrQ1ZNTvkzmQAtt
This commit is contained in:
Claude
@@ -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.
|
||||||
|
========================================================================
|
||||||
Reference in New Issue
Block a user