Gjør all dokumentasjon tilgjengelig i repo og fiks alle lenker

Tidligere refererte repoet til dokumentasjon som lå utenfor (i Salg/_mal/), og brukte Obsidian-wikilinks [[...]] som ikke er klikkbare i Gitea. Begge deler gjorde at lenker var døde i Gitea-web. Endringer: - Hentet inn arbeidsdokumentene som faktisk brukes under oppdraget: _metode/ (00-konvensjoner, 01-startklar-sjekkliste, 02-gjennomforing) artefakter/ (risikoregister, integrasjonslandskap, workshop-agenda, domenemodell-skjema) - Konverterte 82 Obsidian-wikilinks til standard markdown-lenker med korrekte relative stier — klikkbare både i Gitea og lokalt - Begrepsord i begrepskatalogen ([[Bedrift]] etc.) ble til ren tekst (de var aldri filer) - Oppdaterte konvensjonsdokumentet til å foreskrive standard markdown, ikke wikilinks (med begrunnelse: Gitea rendrer ikke [[...]]) - Oras/Kirken/salgsmateriale er nå tydelig merket som eksterne arbeidsområde-referanser (andre kunder / salgsfase), ikke dinglende lenker som lot som de var i repoet Verifisert: 133 ekte interne lenker resolver korrekt. De 4 gjenværende treffene i validering er kodeeksempler i backticks (viser lenke-syntaks), ikke faktiske lenker. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-27 10:34:14 +02:00
parent 46065836a6
commit 1d85656e96
34 changed files with 788 additions and 85 deletions
--- a/_metode/00-konvensjoner.md
+++ b/_metode/00-konvensjoner.md
@@ -0,0 +1,124 @@
+---
+title: "Konvensjoner — Startklar-malverk"
+date: "2026-05-21"
+tags: ["konvensjoner", "frontmatter", "metode"]
+version: 1
+---
+
+# Konvensjoner
+
+Felles konvensjoner for alle dokumenter i et oppdrag som bruker dette malverket. Arvet og generalisert fra Den norske kirke-oppdraget.
+
+## Frontmatter
+
+Alle leveranse- og analysedokumenter skal ha YAML-frontmatter:
+
+```yaml
+---
+title: "Dokumenttittel — Kundenavn"
+date: "YYYY-MM-DD"
+source: "Kilder dokumentet bygger på (komma-separert)"
+tags: ["tag1", "tag2"]
+refs:
+  - "relativ/sti/til/relatert-dokument.md"
+qa:
+  status: "draft | final-candidate | needs-fix"
+  reviewed_on: "YYYY-MM-DD"
+  reviewer: "Navn eller rolle"
+version: 1
+---
+```
+
+**Status-verdier:**
+- `draft` — under arbeid
+- `final-candidate` — klar for sluttgjennomgang
+- `needs-fix` — funn å adressere
+
+For mindre interne arbeidsdokumenter (intervjunotater, hypoteseskisser) kan frontmatter forenkles til kun `title`, `date`, `tags`.
+
+## ID-system
+
+Strukturerte ekstrakter får IDer slik at de kan refereres på tvers av dokumenter:
+
+| Prefiks | Type | Eksempel |
+|---|---|---|
+| `DEC-YYYY-XXX` | Beslutning | DEC-2026-005 |
+| `ACT-YYYY-XXX` | Handling | ACT-2026-012 |
+| `RISK-YYYY-XXX` | Risiko | RISK-2026-003 |
+
+**Format:** ID + tittel, deretter strukturerte felter:
+
+```markdown
+### DEC-2026-005 — Bedrift som master-entitet ligger i Business Central
+
+**Dato:** 2026-06-03
+**Kilde:** Kickoff med Standard Online + Standard Digital
+**Status:** Bekreftet
+**Konsekvens:** SuperOffice og nopCommerce konsumerer; ingen skriving direkte i CRM/nettbutikk.
+```
+
+ID-numre allokeres fortløpende per type per år. Sjekk eksisterende dokumenter for siste brukte nummer før nytt ID utstedes.
+
+## Citation-format
+
+Når du refererer til kildemateriale:
+
+| Kildetype | Format | Eksempel |
+|---|---|---|
+| Markdown | `sti/til/fil.md#L12-L34` | `3.system-og-datalandskap/hovedsystemer.md#L42-L58` |
+| DOCX | `docx:avsnitt-N-M` eller `docx:side-N` | `oppdragsbeskrivelse.docx:avsnitt-3-5` |
+| PDF | `pdf:side-N` | `Startklar.pdf:side-1` |
+| Ekstern URL | Full URL i lenke | `[Tittel](https://...)` |
+| Møte | Dato + tema | `Møte 2026-06-03: Kickoff` |
+
+Lenker til andre dokumenter i samme oppdrag bruker **standard markdown med relativ sti**: `[masterdata-og-eierskap](../4.informasjonsarkitektur/masterdata-og-eierskap.md)`. Vi bruker IKKE Obsidian-wikilinks `[[...]]` — de er klikkbare i Obsidian lokalt, men Gitea rendrer dem ikke som lenker. Standard markdown fungerer i begge. Relative stier fungerer både i Gitea-web og lokalt så lenge målet ligger inne i repoet.
+
+## ANTAKELSE-markering
+
+Når du formulerer noe basert på begrenset informasjon, marker det eksplisitt:
+
+```
+ANTAKELSE: Bedriftsdata i SuperOffice er kanonisk for kundetjenesten, men ikke for fakturering. conf: moderat
+```
+
+Confidence-nivåer:
+- **lav** — gjetning basert på kontekst, må verifiseres
+- **moderat** — basert på indirekte informasjon, sannsynlig korrekt
+- **høy** — basert på direkte kilde, men ikke formelt bekreftet
+
+Bekreftede fakta trenger ingen markering.
+
+## Datoformat
+
+ISO 8601 alltid: `YYYY-MM-DD` (f.eks. `2026-05-21`). Aldri `21.05.2026` eller `21/5-26`.
+
+## Språk
+
+Norsk Bokmål er standard. Engelsk for kundefasade ved internasjonale kunder (avklares i `01-startklar-sjekkliste.md`).
+
+## Versjonering
+
+`version: N` i frontmatter inkrementeres ved hver meningsfull endring etter første ferdigstilling. Mindre rettinger trenger ikke version-bump. Bruk `endringslogg`-seksjon nederst i dokumenter som endrer seg ofte:
+
+```markdown
+## Endringslogg
+
+| Versjon | Dato | Endring | Forfatter |
+|---|---|---|---|
+| 1 | 2026-06-03 | Første utkast | Ragnhild |
+| 2 | 2026-06-10 | Lagt til SuperOffice-avhengighet | Ragnhild |
+```
+
+## Klassifisering
+
+Alle leveranser klassifiseres nederst:
+
+- **Åpen** — kan deles eksternt
+- **Begrenset** — kun for kunden og Forte-teamet (default)
+- **Konfidensiell** — kun for navngitte personer
+
+## Filnavn
+
+- Bruk bindestrek, ikke understrek: `masterdata-og-eierskap.md`, ikke `masterdata_og_eierskap.md`
+- Æ/Ø/Å erstattes med ae/oe/aa i filnavn for kompatibilitet: `kontinuerlig-laering`, ikke `kontinuerlig-læring`
+- Datert prefix kun når relevant: `2026-06-03-kickoff.md` for møtenotater
--- a/_metode/01-startklar-sjekkliste.md
+++ b/_metode/01-startklar-sjekkliste.md
@@ -0,0 +1,141 @@
+---
+title: "Startklar-sjekkliste — pre-flight"
+date: "YYYY-MM-DD"
+tags: ["startklar", "sjekkliste", "pre-flight"]
+qa:
+  status: "draft"
+version: 1
+---
+
+# Startklar — sjekkliste
+
+> *Du tar ikke av før laget vet hvor det skal.*
+
+Pre-flight før kundedialog og oppstart. Fyll ut **internt** før kickoff. Resultat: felles mandat, tydelige prioriteringer, kundedialog på riktig grunnlag.
+
+Strukturen følger Startklar "keep it simple"-versjonen (8 punkter). For Nivå 2/3-oppdrag, se utvidet sjekkliste i `Salg/Startklar.pdf`.
+
+---
+
+## 01 · Retning — Hvor skal vi?
+
+**Spørsmål:**
+- Hva er strategisk plattform/ambisjon dette oppdraget tjener?
+- Hva er ønsket tilstand 1-2 år etter oppdragets slutt?
+- Hvilket konkret verdibidrag skal oppdraget gi?
+
+**Svar:**
+
+---
+
+## 02 · Hensikt — Hvorfor skal vi dit?
+
+**Spørsmål:**
+- Hva er hovedproblemet vi løser? (én setning)
+- For hvem løser vi det?
+- Hva skjer hvis vi *ikke* gjør dette?
+
+**Svar:**
+
+---
+
+## 03 · Team — Hvem er med?
+
+**Spørsmål:**
+- Hvem fra Forte? (rolle + allokering)
+- Hvem fra kunden? (rolle + tilgjengelighet)
+- Hvem fra tredjepart (utviklingspartner, leverandør)? (rolle + samspillsform)
+
+**Svar:**
+
+| Person | Organisasjon | Rolle | Allokering | Kontakt |
+|---|---|---|---|---|
+
+---
+
+## 04 · Eierskap — Hvem eier beslutningene?
+
+**Spørsmål:**
+- Hvem er primært beslutningspunkt hos kunden?
+- Hvem signerer av på scope og leveranser?
+- Hvem er stedfortreder ved fravær?
+- Hvor i organisasjonen er mandatet forankret? (avdeling, ledergruppe, styre)
+
+**Svar:**
+
+---
+
+## 05 · Scope — Hva er innenfor, og hva er ikke?
+
+**Spørsmål:**
+- Hvilke systemer/domener er innenfor scope?
+- Hvilke er eksplisitt **utenfor**?
+- Hva er dybden? (oversikt, fagvurdering, dyp teknisk analyse)
+- Implementering inkludert eller ikke?
+
+**Innenfor scope:**
+-
+
+**Utenfor scope:**
+-
+
+---
+
+## 06 · Innsikt — Hva vet vi om problemet?
+
+**Spørsmål:**
+- Hvilken eksisterende dokumentasjon finnes? (arkitekturskisser, dataflytdiagrammer, tidligere utredninger)
+- Hvilke tidligere oppdrag eller pågående initiativer er relevante?
+- Hva er kunnskapshullene? Hvem må vi snakke med for å lukke dem?
+
+**Tilgjengelig underlag:**
+-
+
+**Kunnskapshull / hovedspørsmål:**
+-
+
+---
+
+## 07 · Risiko — Hvilke avhengigheter må håndteres?
+
+**Spørsmål:**
+- Hvilke andre prosjekter er kritiske avhengigheter? (ERP-skifte, CRM-migrasjon, etc.)
+- Hvilke harde tidsfrister finnes? (lisens, regulatorisk, kontraktuelt)
+- Hvilke organisatoriske risikoer? (kapasitet, beslutningshastighet, motstand)
+
+**Avhengigheter:**
+-
+
+**Risikoer (kort liste):**
+-
+
+---
+
+## 08 · Teknologi — Hvilke kapabiliteter trengs?
+
+**Spørsmål:**
+- Hva er kundens teknologisk landskap i hovedtrekk?
+- Hvilke kapabiliteter trenger vi (datamodellering, integrasjonsanalyse, AI-rammeverk, GDPR)?
+- Hvilke verktøy bruker vi? (Neo4j for relasjoner, Mermaid for diagrammer, etc.)
+- Hvilke tilganger trenger vi
+
+**Svar:**
+
+---
+
+## Resultat — felles mandat
+
+Etter utfylling:
+
+- [ ] **Felles mandat** internt i Forte-teamet
+- [ ] **Tydelige prioriteringer** for første ukene
+- [ ] **Kundedialog på riktig grunnlag** — vi vet hva vi skal spørre om og hva vi allerede vet
+
+**Sign-off:**
+
+| Navn | Rolle | Dato |
+|---|---|---|
+
+---
+
+*Klassifisering: Begrenset — internt Forte-dokument*
--- a/_metode/02-gjennomforing.md
+++ b/_metode/02-gjennomforing.md
@@ -0,0 +1,140 @@
+---
+title: "Gjennomføring — 4-fase-modell"
+date: "2026-05-21"
+tags: ["gjennomføring", "metode", "faseplan"]
+version: 1
+---
+
+# Gjennomføring — 4 faser
+
+Standard gjennomføringsmodell for Nivå 1-oppdrag (6-12 uker). Følger Standards forslag (slide 11) og Fortes Startklar-metodikk.
+
+## Oversikt
+
+| Fase | Varighet | Hovedaktivitet | Delleveranse |
+|---|---|---|---|
+| **A — Oppstart og avgrensning** | Uke 1 | Kickoff, scope, datakilde-inventar | Bekreftet scope og plan |
+| **B — Kartlegging og analyse** | Uke 2-3 | Intervjuer, workshops, datakvalitet | **Delleveranse 1**: Nåsituasjon + risiko (uke 3) |
+| **C — Anbefalinger og målbilde** | Uke 3-5 | Masterdata-modell, arkitektur, AI, personvern | **Delleveranse 2**: Målbilde + masterdata (uke 5) |
+| **D — Forankring og overlevering** | Uke 6-7 | Presentasjon, forankring, overlevering | **Sluttleveranse**: Handlingsplan + governance |
+
+## Fase A — Oppstart og avgrensning (uke 1)
+
+**Mål:** Bekrefte felles forståelse av scope, mandat og arbeidsform. Etablere grunnlag for kartlegging.
+
+**Aktiviteter:**
+- Kickoff med kunden (60-90 min) — felles gjennomgang av scope, leveranser, tidslinje
+- Avklare beslutningspunkter og styringspunkter
+- Få tilgang til eksisterende underlag (arkitekturskisser, dataflytdiagrammer, tidligere utredninger)
+- Datakilde-inventar (første utkast) — hvilke systemer, dataflyt, integrasjoner
+- Sett opp møtekadens, kommunikasjonsstruktur, mappe-tilgang
+- Identifiser de 8-12 personene som skal intervjues i Fase B
+
+**Leveranser fra Fase A:**
+- `1.oppdrag-og-kontekst/oppdragsbeskrivelse.md` — bekreftet versjon
+- `1.oppdrag-og-kontekst/mal-og-leveranser.md` — operasjonalisert
+- `1.oppdrag-og-kontekst/interessenter-og-kontaktinfo.md`
+- `1.oppdrag-og-kontekst/rammer-og-avklaringer.md`
+- `3.system-og-datalandskap/hovedsystemer.md` — første utkast
+- Intervjuplan for Fase B
+
+**Styringspunkt:** Avstemming med beslutningskontakt på slutten av uke 1 — bekreft scope og plan før Fase B starter.
+
+## Fase B — Kartlegging og analyse (uke 2-3)
+
+**Mål:** Bygge en faktabasert forståelse av nåsituasjon, datakvalitet, integrasjoner og risiko.
+
+**Aktiviteter:**
+- **8-12 intervjuer** (1-2 timers økter) med:
+  - Forretningseiere per domene
+  - IT-ansvarlige per system
+  - Potensielle dataeiere
+  - Sluttbrukere (utvalg)
+- **Workshops:**
+  - Dataflyt-workshop (visualiser hvordan data oppstår, dupliseres, konsumeres)
+  - Datakvalitet-workshop (per system: hva fungerer, hva er problematisk)
+- Bygg `3.system-og-datalandskap/*` ferdig
+- Start `4.informasjonsarkitektur/begrepskatalog.md` (løpende gjennom hele oppdraget)
+- Bruk `artefakter/integrasjonslandskap.md` til å strukturere integrasjonsfunn
+- Fyll inn `artefakter/risikoregister.md` med funn etter hvert som de identifiseres
+
+**Leveranser fra Fase B:**
+- `3.system-og-datalandskap/integrasjoner-og-flyt.md`
+- `3.system-og-datalandskap/systemkart-as-is.md`
+- `3.system-og-datalandskap/teknologier-og-leverandorer.md`
+- `8.kontinuerlig-laering-og-referanser/funn-og-hypoteser.md`
+- `artefakter/risikoregister.md`
+
+**Delleveranse 1 (uke 3):** Nåsituasjon + risikobilde — sammenstilling av mappe 3 + risikoregister + funn. Presenteres i styringsmøte med beslutningskontakt.
+
+## Fase C — Anbefalinger og målbilde (uke 3-5)
+
+**Mål:** Bygge masterdata-modell, målarkitektur, AI-rammeverk, personvern-vurdering og handlingsplan basert på funnene fra Fase B.
+
+**Aktiviteter:**
+- **Masterdata-modellering:**
+  - Identifiser kjernedomener (typisk 4-6 for Nivå 1)
+  - For hver entitet: bestem System-of-Record, Begrepseier, Dataforvalter
+  - Bygg `4.informasjonsarkitektur/masterdata-og-eierskap.md` + `informasjonsdomener.md`
+- **Målarkitektur:**
+  - Skisser to-be-arkitektur basert på funn
+  - Identifiser anbefalte komponenter (MDM, integrasjonsplattform, datakatalog)
+  - Vurder hub-and-spoke der det gir mening
+- **AI-rammeverk:**
+  - Operasjonelle prinsipper, ikke arkitektur-spec
+  - Fyll ut `6.ai-rammeverk/*`
+- **Personvern:**
+  - Privacy by Design-tiltak per domene (`5.personvern-og-sikkerhet/*`)
+  - Identifiser mangler og foreslå tiltak
+- **Workshops for validering:**
+  - Masterdata-workshop med potensielle dataeiere
+  - Målarkitektur-workshop med IT-eierskap
+- Skriv `4.informasjonsarkitektur/data-governance-prinsipper.md`
+
+**Delleveranse 2 (uke 5):** Målbilde + masterdata-modell + AI-rammeverk + GDPR-vurdering. Sammenstilling av mappe 4, 5, 6 + arkitekturskisser. Presenteres i workshop med beslutningskontakt og dataeiere.
+
+## Fase D — Forankring og overlevering (uke 6-7)
+
+**Mål:** Forankre anbefalingene, levere handlingsplan og governance-modell, klargjøre for neste fase.
+
+**Aktiviteter:**
+- Bygg `7.standardisering-og-handlingsplan/*` — prioritert handlingsplan basert på Fase B-C
+- Sammenstill `9.leveranser-og-oppsummeringer/executive-summary.md`
+- Bygg `9.leveranser-og-oppsummeringer/sluttrapport.md`
+- **Presentasjon for beslutningskontakt og hennes/hans linje** (90 min)
+- Bredere intern forankring hos kunden (workshop eller leder-runde)
+- Overlevering av alle leveranser (Nextcloud / SharePoint / kundens valgte plattform)
+- Anbefalinger for videre fase (skissér mulig implementeringsfase som egen leveranse)
+
+**Sluttleveranse (uke 6-7):** Komplett leveransesett, inkludert Executive Summary (standalone for ledelse) og Sluttrapport (5-delt).
+
+## Møtekadens
+
+| Møte | Frekvens | Deltakere | Varighet |
+|---|---|---|---|
+| Standup Forte-team | Daglig | Forte-team internt | 15 min |
+| Statusmøte med beslutningskontakt | Ukentlig | + 1 fra kunden | 30 min |
+| Workshop / intervju | Per behov | Forte + relevant rolle | 60-120 min |
+| Styringspunkt | Fase-overgang | Forte + beslutningskontakt | 60 min |
+
+## Forutsetninger (jf. Standard slide 16)
+
+- Beslutningskontakt eller utpekt stedfortreder tilgjengelig for rask respons
+- 8-12 nøkkelpersoner tilgjengelige for 1-2 timers intervju i Fase B
+- Dedikert kontakt hos kundens utviklingspartner (om aktuelt)
+- Eksisterende underlag (arkitekturskisser, dataflyt) tilgjengelig fra Fase A
+- Potensielle dataeiere deltar i workshops og validering
+
+## Avgrensninger
+
+- Dette er kartlegging og anbefaling — implementering er **ikke** inkludert
+- Endelige beslutninger om systemvalg og arkitektur ligger hos kunden
+- Detaljert teknisk implementeringsdesign er utenfor scope
+- Eventuell implementeringsfase prises som egen leveranse
+
+## Metodisk fundament
+
+- **Startklar** — Fortes egen metodikk for data readiness (`Salg/Startklar.pdf`)
+- **Personvern by design** — GDPR som premiss, ikke etterarbeid
+- **Hub-and-spoke der det gir mening** — fra DNK-erfaring, ikke et obligatorisk valg
+- **Funn først, anbefaling etterpå** — ingen tiltak uten dokumentert grunnlag