PayFriend Atlas

Atlas forklarer hvordan PayFriend reelt virker, side for side. Én sandhed i YAML og Markdown, to renderinger: denne side til mennesker, og senere atlas.json til agenter.

Formål

En udvikler skal kunne finde hver handling, regel, indstilling og hvert job og følge det ned i koden og ud til udbyderen. Kundeservice skal kunne læse toppen af en side uden at forstå kode. En agent skal kunne slå en entitet op på ID og få fil, symbol og verificerede fakta tilbage.

Kun main tæller. Alt læses mod origin/main på app og admin, aldrig mod en lokal feature-branch.

Nordstjernen

Kort pr. menupunkt: faste regler, indstillinger kunden kan ændre, og eksterne services.

Hver side åbner med det kort, før alt andet. Tre kolonner, genereret fra katalogen, så kortet ikke kan glide fra resten af siden.

Nordstjernen

side.eksempel.kvitteringer

Faste regler 1

• Eksempeltærskel70 procent

Indstillinger kunden kan ændre 1

• Auto-bogføring (eksempel)Indstillinger, Kvitteringer

Eksterne services 1

• e-conomic (eksempel)Tager imod et bilagsudkast i eksemplet.

Sådan læser du en side

Siderne følger den samme løg-model. Lag 0, lag 1 og de menneskelige trin i lag 2 er skrevet uden kode. Resten er teknisk. Et skille siger "Herfra er det teknisk".

Lag	Sektion	Indhold
K	Kortet	Faste regler, indstillinger kunden kan ændre, eksterne services
0	På 30 sekunder	Hvad siden er til, hvem der bruger den, og hvad der sker uden at nogen trykker
1	Sidens anatomi	Annoteret skærmbillede. Hvert nummer linker til en handling eller indstilling
2	Handlinger	Et kort pr. handling, grupperet efter hvor på siden den sidder
3	Livscyklus	Tilstandsdiagrammer. Hver overgang mærket med hvad der udløser den
4	Hvor kommer data fra	Pipeline over indgangene, med tidsplan og link til domænerne
5	Adgang	Rolle, tilladelse, modul, plan og admin-provisionering
6	Indstillinger	Niveau, hvor den sættes, default, effekt, læses af, status
7	Regler	Nummererede regler med værdi og kilde
8	Teknisk flow	Sekvensdiagram pr. hovedhandling, fra UI til udbyder
9	Data	Tabeller, nøglekolonner og prod-tal hvor de er målt
10	Kendte fælder	Symptom, årsag, sådan undgås
11	Kilder og dækning	Dækning mod inventaret, drift-status, verificeret SHA

Domænesider bruger samme skabelon uden lag 1, og med lag 4 som hovedsektion.

Her starter du

Menuen til venstre har syv grupper. En tom gruppe viser "Endnu intet indhold", indtil siderne bliver skrevet.

• Sider: designsproget, komponenterne og et diagram. De rigtige sider kommer senere.
• Domæner
• Platform
• Katalog: handlinger, regler, indstillinger og de øvrige entitetstyper
• Integrationer
• Ordliste
• Dækning: hvor meget af inventaret kataloget dækker.

---

Served from AgentTask Git spike. Release train: feature -> release/spike -> main.