Finn fram i Simpl-dokumentasjonen

Sist endret: 2026-11-16 23:19av bruker: Erik Hagen ID: 65e24b6e-d64e-4922-8147-1593f887bc02 SAMT-X/content-insight

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

PortalInnhold
Simpl-OpenStartsiden: hvordan repoene henger sammen, kom i gang
FoundationsForretningsprosesser (BP01 og videre), ikke-funksjonelle krav, arkitektur
ArchitectureInnholdsfortegnelse til all arkitekturdokumentasjon
InstallasjonsguideInstallasjon, versjonert per release
BrukerhåndbokKonfigurasjon og drift

De viktigste arkitekturfilene

FilHva du finner
description.mdGenerell introduksjon til Simpl og aktørene
capability-map.mdKapabilitetskartet: dimensjoner, kapabiliteter og tjenester
architecture-principles.mdDe ti arkitekturprinsippene
architectural-patterns.mdArkitekturmønstre som går igjen
agent-anatomy.mdDeltakere på nivå 1 og 2 (Tier I/II), og hvordan en Simpl-tjeneste er bygd opp
connector.mdDataspace Protocol og connectoren
identification-authentication-and-authorisation.mdIdentitet, autentisering og autorisasjon
functional-architecture.mdTjenestene i hver agent og hvordan de samvirker
interface-catalogue.mdOversikt over API-er
technology-choices.mdValgte å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.