@haus-tech/haus-workflow 4.4.0 → 4.6.0

package/library/global/skills/request-score/references/poangskala.md

@@ -1,6 +1,6 @@
 # Poängskalan
 
-Sexton referensuppdrag med poäng. Skalan används för att placera in ett nytt uppdrag
+Sjutton referensuppdrag med poäng. Skalan används för att placera in ett nytt uppdrag
 genom jämförelse, aldrig genom fri skattning.
 
 Poängen är ett relativt mått på arbetets omfattning. Den innehåller inget timpris, inga
@@ -30,46 +30,54 @@ Stegen är finare i botten därför att samma relativa skillnad kräver det. Fr
 är en fjärdedels ökning; från 16 till 17 är en sextondel. I den nedre änden dominerar
 dessutom den fasta processavgiften priset, så poängen betyder minst där.
 
-
 ## Verifiering förutsätter automatiska tester
 
 Referensuppdragens beskrivningar av vad som kan bevisas automatiskt utgår från att en
 fungerande testsvit finns. Jämför ett nytt uppdrag på samma grund, även om dess repo
 saknar tester i dag.
 
-Skälet är att ett repo utan testsvit annars gör varje post i det repot dyrare, och då
-betalar kunden för Haus egen tekniska skuld. Räkna bara det manuella arbete som
-återstår när testerna gjort sitt: kontroll mot en extern tjänsts testläge, visuell
-granskning, och genomgång på flera enheter eller i flera miljöer.
+Skälet är att alla sjutton referensuppdrag är satta som om en testsvit fanns. Jämförs en
+post mot dem på annan grund mäter den inte samma sak, och skalan slutar hålla ihop.
+
+Saknas täckningen är det inte en rabatt. Den byggs då som en egen post före ändringen
+och poängsätts för sig. Räkna här bara det manuella arbete som återstår när testerna
+gjort sitt: kontroll mot en extern tjänsts testläge, visuell granskning, och genomgång
+på flera enheter eller i flera miljöer.
 
 ## Översikt
 
-| Ankare | Poäng | Typ | Uppdrag |
-| --- | --- | --- | --- |
-| A1 | 0,25 | Kundvänd funktion | Uppdatera texter i en översättningsfil |
-| A2 | 0,75 | Kundvänd funktion | Visa ett kontonummer i användarens kontovy |
-| A3 | 0,75 | Kundvänd funktion | Härled landval ur webbadressens språkdel |
-| A4 | 1 | Kundvänd funktion | Gör en rad i en produktlista klickbar |
-| A5 | 2 | Underhåll | Säkerhetsuppdatering av beroenden |
-| A6 | 2,25 | Kundvänd funktion | Normalisera filnamn vid uppladdning |
-| A7 | 2,5 | Teknisk uppsättning | Konfigurerbart spårningsskript per webbplats |
-| A8 | 3 | Integration | Kundmatchning mot affärssystem via momsnummer |
-| A9 | 4 | Internt verktyg | Låt administratörer sätta en kunds lösenord |
-| A10 | 4 | Kundvänd funktion | Förpackningsstorlek med decimaler |
-| A11 | 7 | Integration | Hantera felaktigt pris vid sidladdning i betalflödet |
-| A12 | 9 | Kundvänd funktion | Förbättrad kartvy för val av upphämtningsplats |
-| A13 | 12 | Internt verktyg | Import av användare och konton från fil |
-| A14 | 13 | Kundvänd funktion | Delad komponent för lägg i varukorg |
-| A15 | 16 | Integration | Inloggning med extern e-legitimation, gränssnittsdelen |
-| A16 | 17 | Kundvänd funktion | Strukturerad produktdata för sökmotorer |
+| Ankare | Poäng | Typ                 | Uppdrag                                                |
+| ------ | ----- | ------------------- | ------------------------------------------------------ |
+| A1     | 0,25  | Kundvänd funktion   | Uppdatera texter i en översättningsfil                 |
+| A2     | 0,75  | Kundvänd funktion   | Visa ett kontonummer i användarens kontovy             |
+| A3     | 0,75  | Kundvänd funktion   | Härled landval ur webbadressens språkdel               |
+| A4     | 1     | Kundvänd funktion   | Gör en rad i en produktlista klickbar                  |
+| A5     | 2     | Underhåll           | Säkerhetsuppdatering av beroenden                      |
+| A6     | 2,25  | Kundvänd funktion   | Normalisera filnamn vid uppladdning                    |
+| A7     | 2,5   | Teknisk uppsättning | Konfigurerbart spårningsskript per webbplats           |
+| A8     | 3     | Integration         | Kundmatchning mot affärssystem via momsnummer          |
+| A9     | 4     | Internt verktyg     | Låt administratörer sätta en kunds lösenord            |
+| A10    | 4     | Kundvänd funktion   | Förpackningsstorlek med decimaler                      |
+| A11    | 7     | Integration         | Hantera felaktigt pris vid sidladdning i betalflödet   |
+| A12    | 9     | Kundvänd funktion   | Förbättrad kartvy för val av upphämtningsplats         |
+| A17    | 10    | Underhåll           | Uppgradering av e-handelsramverket till ny delversion  |
+| A13    | 12    | Internt verktyg     | Import av användare och konton från fil                |
+| A14    | 13    | Kundvänd funktion   | Delad komponent för lägg i varukorg                    |
+| A15    | 16    | Integration         | Inloggning med extern e-legitimation, gränssnittsdelen |
+| A16    | 17    | Kundvänd funktion   | Strukturerad produktdata för sökmotorer                |
 
 Fördelningen speglar materialet: kundvänd funktion är 56 procent av allt arbete,
 internt verktyg 10, integration 7 och underhåll 5. Uppdrag över 25 poäng är utelämnade
 eftersom bara tre sådana finns 2025 och 2026.
 
+Numren är fasta beteckningar satta när ankaret skrevs, inte platser i ordningen. A17
+tillkom efteråt och ligger därför på 10 poäng mellan A12 och A13. Ett nummer byts
+aldrig ut, eftersom satta poäng hänvisar till det.
+
 ---
 
 # A1 · Uppdatera texter i en översättningsfil
+
 **0,25 poäng · Kundvänd funktion**
 
 ## Spec
@@ -118,7 +126,9 @@ beställaren i ärendet.
 **Beroenden.** Inga.
 
 ---
+
 ## Till granskaren
+
 **Ej verifierat:** Om samma term förekommer i marknadsföringstexter utanför
 applikationen.
 **Avvikelse mot specen:** Ingen.
@@ -126,6 +136,7 @@ applikationen.
 ---
 
 # A2 · Visa ett kontonummer i användarens kontovy
+
 **0,75 poäng · Kundvänd funktion**
 
 ## Spec
@@ -174,7 +185,9 @@ verifiera genom att räkna konton utan värde efter en första inläsning.
 **Beroenden.** Inga.
 
 ---
+
 ## Till granskaren
+
 **Ej verifierat:** Om identifieraren är unik över alla konton. Den behandlas som en
 visningsuppgift, inte som en nyckel.
 **Avvikelse mot specen:** Ingen.
@@ -182,6 +195,7 @@ visningsuppgift, inte som en nyckel.
 ---
 
 # A3 · Härled landval ur webbadressens språkdel
+
 **0,75 poäng · Kundvänd funktion**
 
 ## Spec
@@ -231,7 +245,9 @@ för en härledning.
 **Beroenden.** Inga.
 
 ---
+
 ## Till granskaren
+
 **Ej verifierat:** Inget.
 **Avvikelse mot specen:** Specen säger inte vad som ska hända för en språkdel som saknar
 land. Implementationen lämnar valet tomt.
@@ -239,6 +255,7 @@ land. Implementationen lämnar valet tomt.
 ---
 
 # A4 · Gör en rad i en produktlista klickbar
+
 **1 poäng · Kundvänd funktion**
 
 ## Spec
@@ -283,13 +300,16 @@ JavaScript, eftersom det bevarar öppna i ny flik och fungerar för skärmläsar
 **Beroenden.** Inga.
 
 ---
+
 ## Till granskaren
+
 **Ej verifierat:** Inget.
 **Avvikelse mot specen:** Ingen.
 
 ---
 
 # A5 · Säkerhetsuppdatering av beroenden
+
 **2 poäng · Underhåll**
 
 ## Spec
@@ -342,7 +362,9 @@ görs.
 **Beroenden.** Inga.
 
 ---
+
 ## Till granskaren
+
 **Ej verifierat:** Om något av de uppdaterade beroendena har ändringar som bryter mot
 tidigare beteende. Ändringsloggarna är lästa men inte alla i detalj.
 **Avvikelse mot specen:** Ingen.
@@ -350,6 +372,7 @@ tidigare beteende. Ändringsloggarna är lästa men inte alla i detalj.
 ---
 
 # A6 · Normalisera filnamn vid uppladdning
+
 **2,25 poäng · Kundvänd funktion**
 
 ## Spec
@@ -402,7 +425,9 @@ verifiera med en genomsökning av innehållet.
 **Beroenden.** Inga.
 
 ---
+
 ## Till granskaren
+
 **Ej verifierat:** Om lagringen är skiftlägeskänslig. Normaliseringen till gemener gör
 frågan mindre viktig men inte irrelevant.
 **Avvikelse mot specen:** Ingen.
@@ -410,6 +435,7 @@ frågan mindre viktig men inte irrelevant.
 ---
 
 # A7 · Konfigurerbart spårningsskript per webbplats
+
 **2,5 poäng · Teknisk uppsättning**
 
 ## Spec
@@ -462,7 +488,9 @@ förvaltningen; om flera behövs blir fältet en lista.
 **Beroenden.** Inga.
 
 ---
+
 ## Till granskaren
+
 **Ej verifierat:** Om identifieraren behöver skilja sig mellan test och drift för samma
 webbplats. Fältet är i dag ett per webbplats.
 **Avvikelse mot specen:** Ingen.
@@ -470,6 +498,7 @@ webbplats. Fältet är i dag ett per webbplats.
 ---
 
 # A8 · Kundmatchning mot affärssystem via momsnummer
+
 **3 poäng · Integration**
 
 ## Spec
@@ -526,7 +555,9 @@ en fråga mot systemet som räknar dubbletter.
 **Beroenden.** Inga.
 
 ---
+
 ## Till granskaren
+
 **Ej verifierat:** Hur många av de historiska felplacerade ordrarna som skulle ha matchat
 på momsnummer. Det avgör hur mycket posten faktiskt löser.
 **Avvikelse mot specen:** Specen säger inte vad som ska hända med de ordrar som redan
@@ -535,6 +566,7 @@ hamnat fel. Ingen rättning av historiken ingår.
 ---
 
 # A9 · Låt administratörer sätta en kunds lösenord
+
 **4 poäng · Internt verktyg**
 
 ## Spec
@@ -594,7 +626,9 @@ att verifiera i rolladministrationen.
 **Beroenden.** Inga.
 
 ---
+
 ## Till granskaren
+
 **Ej verifierat:** Om kunden ska aviseras när lösenordet ändras av en administratör.
 **Avvikelse mot specen:** Specen nämner inte behörighetsnivå. Åtgärden har lagts bakom en
 egen behörighet, vilket är ett utfallsval specen inte besvarat.
@@ -602,6 +636,7 @@ egen behörighet, vilket är ett utfallsval specen inte besvarat.
 ---
 
 # A10 · Förpackningsstorlek med decimaler
+
 **4 poäng · Kundvänd funktion**
 
 ## Spec
@@ -659,7 +694,9 @@ insticket.
 använder insticket.
 
 ---
+
 ## Till granskaren
+
 **Ej verifierat:** Vilka installationer som i dag använder insticket. Listan är hämtad ur
 paketberoenden och kan vara ofullständig.
 **Avvikelse mot specen:** Specen talar om en installation. Insticket är delat, så
@@ -668,6 +705,7 @@ paketberoenden och kan vara ofullständig.
 ---
 
 # A11 · Hantera felaktigt pris vid sidladdning i betalflödet
+
 **7 poäng · Integration**
 
 ## Spec
@@ -727,7 +765,9 @@ bygget.
 **Beroenden.** Inga.
 
 ---
+
 ## Till granskaren
+
 **Ej verifierat:** Hur betalleverantören beter sig om ordern ändras i samma ögonblick som
 betalningen bekräftas. Kapplöpningen är inte utesluten.
 **Avvikelse mot specen:** Specen säger att ett betalförsök på inaktuellt belopp inte ska
@@ -736,6 +776,7 @@ gå att slutföra, men inte vad kunden ska se när det inträffar.
 ---
 
 # A12 · Förbättrad kartvy för val av upphämtningsplats
+
 **9 poäng · Kundvänd funktion**
 
 ## Spec
@@ -795,14 +836,114 @@ verifiera mot tjänstens villkor och nuvarande förbrukning.
 **Beroenden.** Inga.
 
 ---
+
 ## Till granskaren
+
 **Ej verifierat:** Hur många platser som laddas per område innan prestandan påverkas.
 Ingen övre gräns är satt.
 **Avvikelse mot specen:** Ingen.
 
 ---
 
+# A17 · Uppgradering av e-handelsramverket till ny delversion
+
+**10 poäng · Underhåll**
+
+_Poängen vilar på sex uppgraderingar av samma ramverk under 2025 och 2026, inte på ett
+enda uppdrag. Fyra rena versionssteg låg tätt kring 10. Två som bar med sig extra
+arbete låg kring 18. Poängen är satt på de rena stegen; vägvalen säger när posten i
+stället ligger dubbelt så högt._
+
+## Spec
+
+**Problem.** E-handelsramverket ligger kvar på en äldre delversion. Rättningar och nya
+tillägg från ramverkets community görs mot senare versioner, och avståndet växer för
+varje månad som går.
+
+**Lösning.** Ramverket lyfts till den nya delversionen, både i applikationen och i det
+tilläggspaket applikationen bygger på. Egen kod som den nya versionen bryter anpassas,
+och den strukturändring i databasen som versionen kräver körs.
+
+**När det är klart.** Applikationen bygger och startar på den nya versionen, testsviten
+går igenom, strukturändringen är körd i testmiljö och i produktion, och de egna vyerna i
+administrationen fungerar som förut.
+
+**Ingår inte.** Ingen ny funktion. Inget byte av administrationens grundgränssnitt och
+ingen flytt av driftmiljön.
+
+## Påverkansanalys
+
+**Berörda repon och filer.** Beroendeförteckningen och låsfilen i applikationen, och
+samma två filer i det tilläggspaket applikationen bygger på. Båda måste till samma
+version i samma omgång, eftersom applikationen inte startar med tillägg byggda mot den
+gamla versionen. Till det kommer en ny fil för strukturändringen i databasen,
+omgenererade typdefinitioner för dataförfrågningar, och de egna vyerna i
+administrationen som skrivs om mot ramverkets nya gränssnittsdel.
+**Tilläggspaketet delas mellan flera kunders applikationer**, så lyftet av det når
+vidare till dem och behöver planeras därefter.
+
+Merparten av de ändrade raderna är låsfilen, alltså listan över exakta versioner av
+alla tredjepartspaket. Egen kod som ändras är omkring 800 rader. Radantalet säger
+alltså nästan ingenting om posten.
+
+**Datalagring.** En strukturändring i den egna databasen krävs. Den genereras av
+ramverket men körs mot verklig data, och går inte att backa utan att en sparad kopia
+läses tillbaka.
+
+**Integrationspunkter.** Inga nya. Sökmotorn byter däremot huvudversion i samma omgång,
+eftersom ramverkets nya version kräver en nyare klient, och ett par tillägg som
+underhållits på egen hand ersätts av communityns motsvarigheter. Byten av det slaget är
+regel snarare än undantag vid ett versionssprång och hör till posten.
+
+**Flöden.** Ingen sekvens ändras avsiktligt. Som vid all uppdatering av beroenden kan en
+beteendeändring slå var som helst, och det är hela svårigheten i posten.
+
+**Gränssnitt.** Inget nytt mönster formges. Däremot byggs de egna vyerna i
+administrationen om mot ramverkets nya gränssnittsdel: dataförfrågningarna skrivs om,
+och logiken för att spara och för att välja bild likaså. Utseendet ska vara oförändrat
+för den som använder vyerna.
+
+**Verifiering.** Den automatiska testsviten är huvudkontrollen och täcker applikationens
+egen logik. Strukturändringen provas mot en kopia av produktionsdata innan den körs
+skarpt. De egna vyerna i administrationen gås igenom för hand eftersom de skrivits om,
+och de mest använda kundvyerna gås igenom som stickprov, eftersom ändringen kan slå
+brett.
+
+**Konsekvens av fel.** Ett fel i strukturändringen drabbar data och kräver återläsning
+från säkerhetskopia. Ett fel i de egna administrationsvyerna stoppar personalens arbete
+men rör inte kundens köpflöde. Ett fel som kommer ur ett bytt beroende kan bryta
+funktion som fungerade förut, på en yta ingen tittade på, och upptäcks då först i drift.
+
+**Vägval.** Hela versionssprånget görs i en omgång i stället för stegvis, eftersom
+tilläggspaketet och applikationen måste ligga på samma version för att applikationen ska
+starta. Tilläggspaketet lyfts först och applikationen sedan. Bär uppgraderingen dessutom
+ett byte av administrationens grundgränssnitt eller en flytt av driftmiljön är det egen
+post: de två mätta fallen av det slaget landade på nästan dubbla poängen, 18 i stället
+för 10.
+
+**Antaganden.** Att testsvitens täckning räcker för att fånga de vanligaste
+regressionerna. Går att verifiera genom att läsa täckningsrapporten innan arbetet
+påbörjas. Att ramverkets ändringslogg är fullständig i fråga om brytande ändringar.
+
+**Beroenden.** Egna tillägg som byggts mot den gamla versionen måste vara lyfta först.
+Följdarbete i dem efter uppgraderingen, när ett tillägg behöver anpassas till en ändrad
+datamodell i ramverket, är egen post. I det mätta fallet tillkom ett sådant på ungefär
+8 poäng en månad senare.
+
+---
+
+## Till granskaren
+
+**Ej verifierat:** Om ramverkets ändringslogg tar upp alla brytande ändringar som rör de
+egna tilläggen. Loggen är läst, men tilläggen är inte genomgångna ett och ett i förväg.
+**Avvikelse mot specen:** Specen säger att ingen ny funktion ingår. Bytet av sökmotorns
+huvudversion och av ett par egna tillägg mot communityns motsvarigheter ändrar ändå
+beteende i sök och i betalning, utan att vara ny funktion.
+
+---
+
 # A13 · Import av användare och konton från fil
+
 **12 poäng · Internt verktyg**
 
 ## Spec
@@ -868,7 +1009,9 @@ kolumnmappning bli en del av granskningssteget, vilket den inte är i dag.
 **Beroenden.** Inga.
 
 ---
+
 ## Till granskaren
+
 **Ej verifierat:** Om befintliga användare ska uppdateras eller hoppas över när de
 förekommer i filen. Implementationen uppdaterar.
 **Avvikelse mot specen:** Specen säger "skapar eller uppdaterar" utan att ange hur en
@@ -878,6 +1021,7 @@ utfallsval specen inte besvarat.
 ---
 
 # A14 · Delad komponent för lägg i varukorg
+
 **13 poäng · Kundvänd funktion**
 
 ## Spec
@@ -937,7 +1081,9 @@ skillnad som visar sig behövd måste bli en inställning på den delade kompone
 **Beroenden.** Inga.
 
 ---
+
 ## Till granskaren
+
 **Ej verifierat:** Om någon extern integration förlitar sig på den gamla komponentens
 markering i sidan, till exempel för spårning.
 **Avvikelse mot specen:** Specen säger att befintliga ytor aldrig ska bli sämre, men anger
@@ -946,6 +1092,7 @@ inte vad som gäller om en yta har ett beteende de andra saknar.
 ---
 
 # A15 · Inloggning med extern e-legitimation, gränssnittsdelen
+
 **16 poäng · Integration**
 
 ## Spec
@@ -1020,7 +1167,9 @@ testbygge, och om det inte fungerar krävs en annan återkomstmekanik.
 kan provas i sin helhet.
 
 ---
+
 ## Till granskaren
+
 **Ej verifierat:** Hur länge en påbörjad legitimering ska anses giltig innan väntesteget
 ger upp. Implementationen använder tjänstens egen gräns.
 **Avvikelse mot specen:** Specen säger att lösenordsinloggning finns kvar men inte om en
@@ -1029,6 +1178,7 @@ kund som legitimerat sig också ska kunna sätta ett lösenord.
 ---
 
 # A16 · Strukturerad produktdata för sökmotorer
+
 **17 poäng · Kundvänd funktion**
 
 ## Spec
@@ -1094,7 +1244,9 @@ behöver tillbaka till specen.
 **Beroenden.** Inga.
 
 ---
+
 ## Till granskaren
+
 **Ej verifierat:** Om bakgrundsuppgiftens körintervall räcker för att hålla löftet om ett
 dygn vid stora produktkataloger.
 **Avvikelse mot specen:** Specen säger "de fält sökmotorernas handelsprogram kräver" utan
@@ -1105,24 +1257,25 @@ sökmotorn.
 
 # Poängen samlat
 
-| Ankare | Poäng | Typ | Uppdrag |
-| --- | --- | --- | --- |
-| A1 | 0,25 | Kundvänd funktion | Uppdatera texter i en översättningsfil |
-| A2 | 0,75 | Kundvänd funktion | Visa ett kontonummer i användarens kontovy |
-| A3 | 0,75 | Kundvänd funktion | Härled landval ur webbadressens språkdel |
-| A4 | 1 | Kundvänd funktion | Gör en rad i en produktlista klickbar |
-| A5 | 2 | Underhåll | Säkerhetsuppdatering av beroenden |
-| A6 | 2,25 | Kundvänd funktion | Normalisera filnamn vid uppladdning |
-| A7 | 2,5 | Teknisk uppsättning | Konfigurerbart spårningsskript per webbplats |
-| A8 | 3 | Integration | Kundmatchning mot affärssystem via momsnummer |
-| A9 | 4 | Internt verktyg | Låt administratörer sätta en kunds lösenord |
-| A10 | 4 | Kundvänd funktion | Förpackningsstorlek med decimaler |
-| A11 | 7 | Integration | Hantera felaktigt pris vid sidladdning i betalflödet |
-| A12 | 9 | Kundvänd funktion | Förbättrad kartvy för val av upphämtningsplats |
-| A13 | 12 | Internt verktyg | Import av användare och konton från fil |
-| A14 | 13 | Kundvänd funktion | Delad komponent för lägg i varukorg |
-| A15 | 16 | Integration | Inloggning med extern e-legitimation, gränssnittsdelen |
-| A16 | 17 | Kundvänd funktion | Strukturerad produktdata för sökmotorer |
+| Ankare | Poäng | Typ                 | Uppdrag                                                |
+| ------ | ----- | ------------------- | ------------------------------------------------------ |
+| A1     | 0,25  | Kundvänd funktion   | Uppdatera texter i en översättningsfil                 |
+| A2     | 0,75  | Kundvänd funktion   | Visa ett kontonummer i användarens kontovy             |
+| A3     | 0,75  | Kundvänd funktion   | Härled landval ur webbadressens språkdel               |
+| A4     | 1     | Kundvänd funktion   | Gör en rad i en produktlista klickbar                  |
+| A5     | 2     | Underhåll           | Säkerhetsuppdatering av beroenden                      |
+| A6     | 2,25  | Kundvänd funktion   | Normalisera filnamn vid uppladdning                    |
+| A7     | 2,5   | Teknisk uppsättning | Konfigurerbart spårningsskript per webbplats           |
+| A8     | 3     | Integration         | Kundmatchning mot affärssystem via momsnummer          |
+| A9     | 4     | Internt verktyg     | Låt administratörer sätta en kunds lösenord            |
+| A10    | 4     | Kundvänd funktion   | Förpackningsstorlek med decimaler                      |
+| A11    | 7     | Integration         | Hantera felaktigt pris vid sidladdning i betalflödet   |
+| A12    | 9     | Kundvänd funktion   | Förbättrad kartvy för val av upphämtningsplats         |
+| A17    | 10    | Underhåll           | Uppgradering av e-handelsramverket till ny delversion  |
+| A13    | 12    | Internt verktyg     | Import av användare och konton från fil                |
+| A14    | 13    | Kundvänd funktion   | Delad komponent för lägg i varukorg                    |
+| A15    | 16    | Integration         | Inloggning med extern e-legitimation, gränssnittsdelen |
+| A16    | 17    | Kundvänd funktion   | Strukturerad produktdata för sökmotorer                |
 
 ## Ett mönster värt att lägga märke till