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>
This commit is contained in:
2026-05-27 10:34:14 +02:00
parent 46065836a6
commit 1d85656e96
34 changed files with 788 additions and 85 deletions

124
_metode/00-konvensjoner.md Normal file
View File

@@ -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