Devportalen
Dokumentationen
En sida per del av ekosystemet: vad den ansvarar för, var koden bor, vad den exporterar och vad som återstår. Identiteten – namn, status, källa – bor i katalogen och upprepas inte här.
Dokumentationskontraktet
En funktion är inte klar förrän den har ett dok som uppfyller det här. Listan är samtidigt granskningslistan: saknas ett obligatoriskt fält är dokumentationen inte färdig, och då är inte funktionen det heller.
| Fält | Krävs | Vad som gäller |
|---|---|---|
| id | Alltid | Samma id som katalogposten. Finns ingen katalogpost skrivs den först – identiteten bor där, inte här. |
| sammanfattning | Alltid | En mening om vad delen ansvarar för. Inte vad den innehåller, inte hur den är byggd. |
| ansvar | Alltid | Tre till sex punkter. Varje punkt är något delen svarar för – och därmed något ingen annan ska göra. |
| filer | Alltid | Varje fil som bär funktionen, med en rad om vad den gör. Filkartan är det som gör doket användbart för någon som ska ändra. |
| api | Villkorat | Exporterade funktioner och typer med signatur. Obligatoriskt så snart delen exporterar något som någon annan importerar. |
| kontrakt | Villkorat | Datakontrakt, manifestform eller turkontrakt – det andra måste följa. Obligatoriskt när delen ställer krav på sin omgivning. |
| beroenden | Alltid | Katalog-id på det delen bygger på. Tom lista är ett giltigt svar och betyder fristående. |
| beslut | Villkorat | ADR-nummer som styr delen. Utelämnas bara när inget beslut rör den. |
| kvarstar | Alltid | Känt som inte är gjort. Tom lista betyder färdig; ett utelämnat fält betyder att ingen har tänkt efter. Det är skillnaden. |
| uppdaterad | Alltid | ISO-datum. Sätts om varje gång delen ändras, i samma commit som ändringen. |
Täckning
Varje katalogpost som inte är ett externt system ska ha ett dok. Listan nedan räknas fram ur katalogen och dokumentationen, så den kan inte bli inaktuell.
34 dokumenteradeInga luckor
Ingångar
- Prototypens ingång
introStartar demon på /portal genom ett rollval, och förklarar under det vad startsidan och ekosystemet är.4 filer · 3 kvarstår · 2026-10-08 - Åtkomstspärren
atkomstLåser startsideportalens demo bakom en delad kod så att den kan ligga på en publik adress utan att vara öppen. Ingången /portal och devportalen /portal/dev ligger utanför spärren; projektportalen på roten har ingen spärr alls (ADR-040).6 filer · 3 kvarstår · 2026-10-19 - Devportalen
devportalSamlar allt en byggare behöver om ekosystemet och renderar det i en människovy och en agentvy ur samma data.23 filer · 3 kvarstår · 2026-09-02 - Designsystemet
designsystemBeskriver tokens, primitiver, mönster och regler som data, och renderar dem som sida, JSON och plattext.9 filer · 1 kvarstår · 2026-10-05
Skalet och grunden
- Skalet (apps/portal)
skalKomponerar modulerna till en sammanhängande sida och äger allt krom, all identitet och all layout.30 filer · 4 kvarstår · 2026-10-07 - @startsidan/module-sdk
module-sdkKontraktet mellan skalet och modulerna, plus urvalsfunktionerna skalet använder för att komponera dem.8 filer · 3 kvarstår · 2026-10-07 - @startsidan/ui
uiPrimitiverna modulerna bygger av: V3:s form och mått ovanpå shadcn/ui, så att Radix bär tillgängligheten.9 filer · 2 kvarstår · 2026-08-28 - @startsidan/tokens
tokensDefinierar varje färg, mått och rörelse i systemet som Tailwind-tema, och är det enda stället där ett värde får uppstå.3 filer · 2 kvarstår · 2026-08-31
Modulerna
- oversikt
oversiktLevererar nyckeltalsraden: mätvärden som skiljer sig åt mellan chef och medarbetare.6 filer · 1 kvarstår · 2026-08-28 - agera
ageraRenderar kortet "Att agera på" ur de rader andra moduler bidrar med, och äger ingen egen data.5 filer · 4 kvarstår · 2026-10-20 - arenden
arendenVisar användarens ärenden som tabell och lyfter de ärenden som kräver något till "Att agera på".6 filer · 2 kvarstår · 2026-08-28 - kalender
kalenderVisar dagens händelser, och för chef även årshjulets återkommande åtaganden.4 filer · 2 kvarstår · 2026-08-28 - ledighet
ledighetVisar ledighetssaldon för medarbetare och attesthögen för chef, och lyfter färdiga attester till "Att agera på".3 filer · 1 kvarstår · 2026-08-28 - kompetens
kompetensHåller ordning på vad varje medarbetare kan, vad rollen kräver och när det går ut – och gör utvecklingssamtalet till en plan som chefen bekräftar.18 filer · 6 kvarstår · 2026-10-09 - felanmalan
felanmalanDet första samtalsflödet: användaren beskriver felet i fri text och ser i realtid vad assistenten uppfattat.8 filer · 3 kvarstår · 2026-08-30 - utvecklingsarende
utvecklingsarendeBeslutsunderlag för utvecklingsinitiativ: fjorton avsnitt enligt kommunens mall, där fyra är typade radlistor med summeringar i stället för fritext.21 filer · 5 kvarstår · 2026-09-04
Server och bygge
- GET /api/mock/*
api-mockSpeglar varje moduls datafunktion som en HTTP-endpoint, för att visa vilken form ett riktigt mikrotjänst-API skulle ha.8 filer · 2 kvarstår · 2026-08-28 - POST /api/flows/felanmalan
api-felanmalanSamtalsflödets enda serverända: äger prompten, validerar turen och fattar beslutet om ärendet får skapas.3 filer · 3 kvarstår · 2026-08-30 - POST /api/flows/utvecklingsarende/*
api-utvecklingsarendeDokumentflödets serverändar: en som skriver hela utkastet ur uppladdat material, en som ändrar ett avsnitt i samtalet.7 filer · 5 kvarstår · 2026-09-04 - AI-adaptern
ai-adapterKapslar in modellanropet så att turkontraktet garanteras av API:et och providern kan bytas utan kodändring.3 filer · 2 kvarstår · 2026-08-28 - Grindar och bygge
byggeGrindarna och paketeringen: lint, test och typecheck över hela repot, och en container per applikation som Dokploy kan bygga (ADR-040).11 filer · 3 kvarstår · 2026-09-02