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