Finn fram i Simpl-dokumentasjonen
Arkitektur- og brukerdokumentasjonen for Simpl ligger nå som Markdown-filer i GitLab, uten noen egen publiseringsside. Denne siden er en veiledning til hvor du finner hva.
Slik er dokumentasjonen organisert
Simpl-programmet har flyttet dokumentasjonen fra Confluence til Git høsten 2026. GitLab brukes nå som en slags wiki: README-filene fungerer som inngangsportaler med en «Du er her»-sti øverst og lenker videre ned.
Strukturen følger kapabilitetskartet. Under simpl-open er det én gruppe for hver dimensjon: administration, data, integration, infrastructure, governance og security. I tillegg kommer cross-cutting, med blant annet installasjonsguide og brukerhåndbok, og foundations, med forretningsprosesser, ikke-funksjonelle krav og arkitektur. Den gamle strukturen under «development» fases ut, men i overgangsperioden kan innhold ligge begge steder.
Inngangsportaler
| Portal | Innhold |
|---|---|
| Simpl-Open | Startsiden: hvordan repoene henger sammen, kom i gang |
| Foundations | Forretningsprosesser (BP01 og videre), ikke-funksjonelle krav, arkitektur |
| Architecture | Innholdsfortegnelse til all arkitekturdokumentasjon |
| Installasjonsguide | Installasjon, versjonert per release |
| Brukerhåndbok | Konfigurasjon og drift |
De viktigste arkitekturfilene
| Fil | Hva du finner |
|---|---|
| description.md | Generell introduksjon til Simpl og aktørene |
| capability-map.md | Kapabilitetskartet: dimensjoner, kapabiliteter og tjenester |
| architecture-principles.md | De ti arkitekturprinsippene |
| architectural-patterns.md | Arkitekturmønstre som går igjen |
| agent-anatomy.md | Deltakere på nivå 1 og 2 (Tier I/II), og hvordan en Simpl-tjeneste er bygd opp |
| connector.md | Dataspace Protocol og connectoren |
| identification-authentication-and-authorisation.md | Identitet, autentisering og autorisasjon |
| functional-architecture.md | Tjenestene i hver agent og hvordan de samvirker |
| interface-catalogue.md | Oversikt over API-er |
| technology-choices.md | Valgte åpen kildekode-teknologier |
| adr/ | Arkitekturbeslutninger (ADR-er) |
| controlled_vocabulary/ | Kontrollert vokabular og ordliste |
Hoveddokumentet D1.3.4
Den samlede arkitekturspesifikasjonen, D1.3.4 Functional and Technical Architecture Specifications, finnes fortsatt som én stor Markdown-fil på rundt 18 800 linjer. Den ble sist endret i juli 2026 og kaller seg versjon 0.1. De mindre filene og ADR-ene oppdateres jevnlig og er derfor ofte nyere enn hoveddokumentet. Det gjelder særlig teknologivalg, grensesnitt og beslutninger.
Tips
- Arkitekturmodellen ligger i ArchiMate-format (Archi med coArchi) i mappen «model» i arkitekturrepoet. Den kan åpnes i Archi.
- For å lese alt samlet er det enklest å klone arkitekturrepoet og åpne det i en Markdown-leser eller editor.
- Det gamle arkitekturrepoet (simpl/simpl-open/architecture) er arkivert. Siste versjon der er fra september 2025.