Claude
cfa6938c39
Gör granskat-flaggan i SPRAK operativ. Protokollet definierar vem som får fackgranska metodikinnehållet per marknad (yrkesverksam tekniker med modersmålsnivå; HV-metodiken endast med giltig HV-behörighet), vad som ingår (metodikerna, grind-/slutsatstexterna, ordlistorna, metodikvarningen), de tre utfallen per steg, och registreringen: undertecknat protokoll arkiveras som kontrollerat dokument i docs/granskningar/ i samma commit som flaggan sätts, knuten till den granskade commiten. Ändringar efter granskning är ogranskade tills diffen är läst och protokollet kompletterat. Flaggan är ett påstående om människor, inte om filer — ingen intern granskning kan sätta den, och det står nu i processform. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012EQg3rJsrQ1ZNTvkzmQAtt
115 lines
4.9 KiB
Markdown
115 lines
4.9 KiB
Markdown
# Fackgranskningsprotokoll · Metodikinnehåll per marknad
|
|
|
|
**ALVA 3.4 · 2026-08-06 · ALVA-DOC-0010 · Mall och process**
|
|
|
|
Detta dokument gör `granskat`-flaggan i SPRAK operativ. Flaggan är ett
|
|
påstående om människor, inte om filer: den betyder att en namngiven,
|
|
yrkesverksam fackman har läst metodikinnehållet på språket och skrivit
|
|
under på att det är fackmässigt riktigt för marknaden. Ingen intern
|
|
granskning — hur grundlig den än är — kan sätta den flaggan. Det här
|
|
protokollet definierar vad som krävs för att någon ska kunna det.
|
|
|
|
## 1. Vem får granska
|
|
|
|
En person per språk som uppfyller samtliga tre:
|
|
|
|
1. **Yrkesverksam** fordonstekniker, verkmästare eller teknisk utbildare
|
|
med aktuell verkstadserfarenhet (arbetat i yrket under de senaste två
|
|
åren).
|
|
2. **Modersmålsnivå eller motsvarande** i granskningsspråket, och
|
|
arbetsspråket i en verkstad på marknaden.
|
|
3. **Behörighet där innehållet kräver det**: högvoltsmetodiken får
|
|
endast granskas av en person med giltig HV-behörighet enligt
|
|
marknadens regelverk (i Sverige: arbete med spänningssatta
|
|
fordonssystem enligt elsäkerhetsanvisningarna; motsvarande nationell
|
|
utbildning i andra länder).
|
|
|
|
Granskaren får inte vara den som skrivit eller översatt texten.
|
|
|
|
## 2. Vad som granskas
|
|
|
|
Granskningsobjektet är avgränsat och versionsmärkt. För språket X ingår:
|
|
|
|
| # | Innehåll | Fil | Omfattning |
|
|
| --- | --- | --- | --- |
|
|
| 1 | Metodikerna: varje steg, fråga och kontroll i alla 16 metodiker | `services/gemensam/metodiker.mjs` (eller dess granskade översättning till X när en sådan finns) | Fullständig |
|
|
| 2 | Grindtexterna och slutsatsspråket | `services/gemensam/sprak/<X>.mjs`, prefixen `grind.`, `slutsats.`, `pre.`, `evidens.`, `matning.` | Fullständig |
|
|
| 3 | Ordlistorna för språket | `services/gemensam/sprak/ord.mjs`, posterna för X i ICKESVAR, ORSAKSORD, EVIDENSORD | Fullständig |
|
|
| 4 | Metodikvarningens egen text | nyckeln `metodik.ogranskad` på X | Fullständig |
|
|
|
|
Webbplatstexter och övrig gränssnittstext ingår inte — de är
|
|
gränssnitt, inte metodik (ALVA-SPEC-060).
|
|
|
|
## 3. Vad granskaren intygar
|
|
|
|
För varje metodik, med tre möjliga utfall per steg:
|
|
|
|
- **Riktig** — steget är fackmässigt korrekt för marknaden och kan
|
|
följas som det står.
|
|
- **Riktig med anmärkning** — korrekt i sak men med formulering som en
|
|
tekniker på marknaden skulle missförstå eller ifrågasätta; anmärkning
|
|
bifogas och åtgärdas före flaggan sätts.
|
|
- **Fel** — steget är felaktigt, farligt eller ogenomförbart;
|
|
granskningen stoppar tills det är åtgärdat och omgranskat.
|
|
|
|
Särskilt intygande för HOGVOLT: att säkerhetssekvensen är komplett och i
|
|
rätt ordning för marknadens regelverk, och att ingenting i metodiken kan
|
|
läsas som tillstånd att arbeta i spänningssatt system utan behörighet.
|
|
|
|
## 4. Hur resultatet registreras
|
|
|
|
1. Granskaren fyller i protokollet (avsnitt 6) och undertecknar med
|
|
namn, roll, arbetsgivare, behörigheter och datum.
|
|
2. Protokollet arkiveras som `docs/granskningar/FG-<språk>-<datum>.md`
|
|
i repot — granskningen är ett kontrollerat dokument (ALVA-klass RH).
|
|
3. Först därefter sätts `granskat: true` för språket i
|
|
`services/gemensam/sprak/index.mjs`, i samma commit som protokollet,
|
|
med hänvisning till protokollets beteckning i commit-meddelandet.
|
|
4. Granskningen gäller den commit den utfördes mot. Ändras
|
|
metodikinnehållet på språket därefter markeras ändringen ogranskad
|
|
tills granskaren (eller en ny) har läst diffen och kompletterat
|
|
protokollet. Testerna låser att flaggan inte kan sättas utan fil —
|
|
människan låser att filen betyder något.
|
|
|
|
## 5. Vad flaggan därefter betyder — och inte betyder
|
|
|
|
`granskat: true` betyder att metodikinnehållet på språket är läst och
|
|
undertecknat enligt detta protokoll. Den betyder inte att innehållet är
|
|
godkänt av någon myndighet, att det ersätter tillverkarens
|
|
serviceinformation, eller att granskningen omfattar framtida ändringar.
|
|
Metodikvarningen för ogranskade språk får aldrig tas bort på annan väg
|
|
än denna.
|
|
|
|
## 6. Protokollmall
|
|
|
|
```
|
|
FACKGRANSKNINGSPROTOKOLL FG-<språk>-<ÅÅÅÅ-MM-DD>
|
|
Granskat mot commit: <sha>
|
|
Språk: <kod och namn>
|
|
|
|
Granskare
|
|
Namn:
|
|
Roll och arbetsgivare:
|
|
År i yrket, senaste aktiva år:
|
|
Behörigheter (HV m.m.):
|
|
|
|
Omfattning enligt ALVA-DOC-0010 §2: [ ] 1 [ ] 2 [ ] 3 [ ] 4
|
|
|
|
Per metodik (16 rader):
|
|
<metodik-id>: [ ] Riktig [ ] Riktig med anmärkning [ ] Fel
|
|
Anmärkningar (steg-id + text):
|
|
|
|
Högvoltsintygande (endast HV-behörig granskare):
|
|
[ ] Säkerhetssekvensen är komplett och i rätt ordning för marknaden
|
|
[ ] Ingen formulering kan läsas som tillstånd till arbete i
|
|
spänningssatt system utan behörighet
|
|
|
|
Ordlistorna (§2 rad 3): [ ] Genomgångna, tillägg/strykningar bifogade
|
|
|
|
Underskrift och datum:
|
|
```
|
|
|
|
---
|
|
|
|
*ALVA-DOC-0010 · Mall och process · Flaggan sätts av människor*
|