diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..1f7237f --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,149 @@ +# CLAUDE.md — Standard Online (oppdrag) + +This file provides guidance to Claude Code (claude.ai/code) when working in this repository. + +## Repository Purpose + +Arbeidsmappe for kartleggings- og anbefalingsarbeidet Forte Digital gjør for **Standard Online**: masterdata, arkitektur og operasjonelt rammeverk for AI-agenter på tvers av SuperOffice, Business Central og nopCommerce. Repoet inneholder selve gjennomføringsdokumenter, leveranser, møtenotater, funn og handlingsplaner. + +Strukturen følger Forte sitt `startklar-malverk` (Nivå 1 — avgrenset strategisk, 6-8 uker). + +## Om kunden + +- **Selskap:** Standard Online +- **Søsterselskap:** Standard Digital (utviklingskapasitet i Riga) +- **Beslutningskontakt:** Direktør produkt og kundeopplevelse +- **Forte-ansvarlig:** Petter Schultz + +Bedrifts- og brukerdata lever parallelt i flere av kundens systemer uten klare master-systemer eller etablerte dataeiere — det er det vi skal kartlegge og foreslå løsninger for. + +## Systemlandskap + +| System | Type | Eier | +|---|---|---| +| SuperOffice | CRM | Standard Online | +| Business Central | ERP | Standard Online | +| nopCommerce (egenutviklet) | E-handel | Standard Online | + +## Forte-team + +| Rolle | Navn | Allokering | +|---|---|---| +| Ledende konsulent | Ragnhild Aaraas Hånde | 80% | +| Senior rådgiver | Petter Schultz | 20% | + +Ragnhild driver det daglige arbeidet (kartlegging, workshops, dialog med Standard Digital, sammenstilling). Petter eier metodikk og maler fra Oras og DNK, kvalitetssikrer ved hver fasegrense. + +## Gjennomføring — 4 faser + +| Fase | Uker | Hovedaktivitet | Milestone | +|---|---|---|---| +| A — Oppstart | 1 | Kickoff, scope, datakilde-inventar | — | +| B — Kartlegging | 2-3 | Intervjuer, workshops, datakvalitet | Delleveranse 1: Nåsituasjon + risiko (uke 3) | +| C — Anbefalinger | 3-5 | Masterdata, arkitektur, AI, personvern | Delleveranse 2: Målbilde + masterdata (uke 5) | +| D — Forankring | 6-7 | Presentasjon, overlevering | Sluttleveranse (uke 6-7) | + +Detaljer i `../../Salg/_mal/startklar-malverk/02-gjennomforing.md`. + +## Mappestruktur — 9 nummererte mapper + +| Mappe | Formål | +|---|---| +| `1.oppdrag-og-kontekst/` | Scope, leveranser, interessenter, møtelogg | +| `2.organisasjonsforstaelse/` | Roller, beslutningsveier, nøkkelpersoner | +| `3.system-og-datalandskap/` | Systemer, integrasjoner, as-is | +| `4.informasjonsarkitektur/` ⭐ | Begrepskatalog, masterdata, governance — kjerne | +| `5.personvern-og-sikkerhet/` | GDPR, Privacy by Design | +| `6.ai-rammeverk/` | Operasjonelle AI-prinsipper | +| `7.standardisering-og-handlingsplan/` | Avvik, prioritering, tiltak | +| `8.kontinuerlig-laering-og-referanser/` | Intervjuguider, åpne spørsmål, funn | +| `9.leveranser-og-oppsummeringer/` | Executive Summary, sluttrapport | + +Komplett innholdsfortegnelse: [_index.md](_index.md). + +## Konvensjoner + +Felles konvensjoner følger Forte sitt startklar-malverk: `../../Salg/_mal/startklar-malverk/00-konvensjoner.md`. + +### Frontmatter + +Alle leveranse-/analysedokumenter har YAML-frontmatter: + +```yaml +--- +title: "Dokumenttittel — Standard Online" +date: "YYYY-MM-DD" +tags: [...] +refs: + - "relativ/sti/til/relatert.md" +qa: + status: "draft | final-candidate | needs-fix" + reviewed_on: "YYYY-MM-DD" +version: 1 +--- +``` + +### ID-system + +Strukturerte ekstrakter får IDer som kan refereres på tvers av dokumenter: + +- `DEC-YYYY-XXX` — beslutninger +- `ACT-YYYY-XXX` — handlinger +- `RISK-YYYY-XXX` — risikoer + +### ANTAKELSE-markering + +Når noe baseres på begrenset informasjon, marker det eksplisitt: + +``` +ANTAKELSE: [tekst] conf: lav|moderat|høy +``` + +### Andre + +- **Datoformat:** ISO `YYYY-MM-DD` +- **Filnavn:** bindestrek, ikke understrek. Æ/Ø/Å → ae/oe/aa +- **Språk:** Norsk Bokmål + +## Memories — prosjektkunnskap som overlever sesjoner + +Prosjektspesifikke memories lagres i `_memories/`-mappen. Memories er strukturerte oppsummeringer av: + +- **project**: prosjektkontekst, beslutninger, status, viktige funn +- **feedback**: brukerens preferanser og rettelser spesifikt for dette prosjektet +- **reference**: pekere til eksterne systemer og dokumenter (Confluence, Notion, etc.) + +Forskjellen fra Claude's globale auto-memory (`~/.claude/projects/.../memory/`): + +- **Global memory** = Petters generelle preferences på tvers av alle prosjekter +- **Prosjekt-memory (her)** = ting som er spesifikt for Standard Online, og som bør deles med alle som jobber på prosjektet (Ragnhild, andre Forte-konsulenter, fremtidige Claude-sesjoner) + +Når Claude oppdager noe verdt å huske som er prosjekt-spesifikt, skal det lagres her — ikke i global memory. Versjoneringen via git gjør at memories overlever maskinbytter og deles på tvers av teamet. + +**Indeks:** [_memories/MEMORY.md](_memories/MEMORY.md) — oppdateres ved hver ny memory. +**Mal:** [_memories/_template-memory.md](_memories/_template-memory.md). + +## Sentrale referansecase (metodikk og maler) + +Bygger på to ferske oppdrag: + +- **Oras Group** (`../../Salg/Oras/`): Data Health Assessment for CRM-anskaffelse. Risikoregister-mønster, Executive Summary-struktur, integrasjonslandskap-tabell. +- **Den norske kirke / Nstat** (`../../../Kirken/`): Informasjonsarkitektur for offentlig organisasjon. 9-mappe-struktur, Begrepseier/Dataforvalter/Master-vokabular, Privacy by Design, 3-nivå governance. + +## Repository-konvensjoner + +- Default branch: `main` +- Direkte commits til main er tillatt (ingen branch protection — 2-personers prosjekt) +- Issues sporer arbeid per fase (labels: `fase-A/B/C/D/milepel`) +- Milestones: Delleveranse 1, Delleveranse 2, Sluttleveranse +- Commits som inkluderer Claude-bidrag merkes med `Co-Authored-By: Claude Opus 4.7 (1M context) ` + +## Salgsmaterialet — kilden til oppdraget + +`../../Salg/Standard/` inneholder: +- Forslaget vi sendte (`Forslag - Masterdata, arkitektur og AI-klargjøring.md`) +- Kundens oppdragsbeskrivelse (PDF) +- Pitch-presentasjon (PPTX) +- CV-er for teamet + +Når du trenger å verifisere "hva vi lovet kunden" — slå opp der. diff --git a/_memories/MEMORY.md b/_memories/MEMORY.md new file mode 100644 index 0000000..4a24176 --- /dev/null +++ b/_memories/MEMORY.md @@ -0,0 +1,11 @@ +# MEMORY — Standard Online + +Prosjektspesifikke memories. Hver linje peker til en memory-fil i denne mappen. + +Format: `- [Tittel](fil.md) — én-linjes hook` + +Hold listen kort og scannbar. Bruk `[[fil-navn]]`-lenker innen memory-filer for kryssreferanser. + +--- + +- [Standard Online — prosjektkontekst](project_standard-online-kontekst.md) — kunde, scope, team, sentrale aktører og bakgrunn fra salgsfasen diff --git a/_memories/_template-memory.md b/_memories/_template-memory.md new file mode 100644 index 0000000..1cede7b --- /dev/null +++ b/_memories/_template-memory.md @@ -0,0 +1,39 @@ +--- +name: kort-kebab-case-slug +description: én-linjes oppsummering som hjelper å vurdere relevans i fremtidige sesjoner — vær spesifikk +metadata: + type: project | feedback | reference +--- + +# Tittel på memory-en + +For **feedback** og **project** memories — strukturér slik: + +**[Hovedregel eller fakta i én setning]** + +**Hvorfor:** [Grunnen — typisk en hendelse, en preferanse, en kunde-beslutning. Lar fremtidige Claude-sesjoner vurdere edge cases istedenfor å følge regelen blindt.] + +**Hvordan brukes:** [Når og hvor regelen/faktumet kicker inn. Konkret: "ved planlegging av X", "i samtaler om Y", "før beslutninger om Z".] + +--- + +For **reference** memories — strukturér slik: + +**Hva:** [Hvilken ekstern ressurs det er — Notion-side, Confluence-rom, dashboard, etc.] + +**Hvor:** [URL eller plassering] + +**Når brukes:** [Hva slags spørsmål eller arbeid sender deg dit] + +--- + +## Lenker til relaterte memories + +Bruk wikilink-stil: `[[andre-memory-navn]]`. Det er greit å lenke til memories som ikke finnes ennå — markerer at de er verdt å skrive. + +## Sjekkliste når du oppretter en ny memory + +- [ ] Frontmatter-felter fylt ut (`name`, `description`, `metadata.type`) +- [ ] Lagt til linje i `MEMORY.md` (alfabetisk eller tematisk gruppert) +- [ ] Filnavn følger mønster `_.md` (f.eks. `project_kickoff-funn.md`) +- [ ] ANTAKELSE-er markert eksplisitt med confidence-nivå hvis innholdet er hypotetisk diff --git a/_memories/project_standard-online-kontekst.md b/_memories/project_standard-online-kontekst.md new file mode 100644 index 0000000..869abd1 --- /dev/null +++ b/_memories/project_standard-online-kontekst.md @@ -0,0 +1,92 @@ +--- +name: standard-online-kontekst +description: Kunde, scope, team og sentrale aktører for Standard Online-oppdraget — etablert fra salgsfasen før oppdragsstart +metadata: + type: project +--- + +# Standard Online — prosjektkontekst + +Etablert fra salgsfasen (mai 2026). Oppdater ved oppstart med faktiske datoer, navn og bekreftet scope. + +## Kunde og søsterselskap + +**Standard Online** er en norsk e-handels-/SaaS-aktør. Bedrifts- og brukerdata lever parallelt i tre systemer uten tydelige master-systemer eller etablerte dataeiere. Samtidig ser kunden konturene av en utvikling der AI-agenter skal konsumere, berike og handle på disse dataene — masterdata-grunnlaget må derfor være AI-ready fra start, ikke etterarbeid. + +**Standard Digital** er søsterselskap i Riga, med utviklingskapasitet. De er **både bidragsyter og mottaker** av kartleggingen — sentral kontakt for å forstå dagens arkitektur og praksis. + +## Beslutningsstruktur + +**Beslutningskontakt:** Direktør produkt og kundeopplevelse hos Standard Online (navn ikke i frontmatter — bekreft og oppdater ved kickoff). + +**Hvorfor det betyr noe:** Beslutninger om systemvalg og arkitektur ligger hos kunden, eventuelt i samråd med ERP-/CRM-leverandører. Vi leverer beslutningsgrunnlag, ikke implementering. Direktøren er styringspunkt — rask responstid på avklaringer forutsettes. + +## Systemlandskap + +- **SuperOffice** (CRM) +- **Business Central** (ERP) +- **nopCommerce** (egenutviklet nettbutikk) + +ANTAKELSE: Bedrifts- og brukerdata er duplisert mellom CRM og ERP. conf: høy (eksplisitt i kundens oppdragsbeskrivelse) + +ANTAKELSE: nopCommerce har egen brukermaster for nettbutikk-konti, separat fra SuperOffice-kontakter. conf: moderat (typisk e-handelsmønster, men ikke verifisert hos kunden) + +## Scope og avgrensninger + +**Innenfor:** kartlegging og anbefaling. 7 leveranser: +1. Nåsituasjon med gap og risiko +2. Arkitekturskisser (as-is + to-be) +3. Masterdata-modell med System-of-Record +4. Operasjonelt AI-rammeverk +5. GDPR/personvern +6. Handlingsplan +7. Governance-modell + +**Utenfor:** implementering, leverandørvalg, detaljert teknisk design. Eventuell implementeringsfase prises som egen leveranse. + +## Team + +| Rolle | Navn | Allokering | Eier | +|---|---|---|---| +| Ledende konsulent | Ragnhild Aaraas Hånde | 80% | Daglig arbeid, workshops, dialog Standard Digital, sammenstilling | +| Senior rådgiver | Petter Schultz | 20% | Metodikk-eier, masterdata + arkitektur, KS ved fasegrenser | + +**Hvorfor 80/20:** Lavere totalpris enn én senior på 100%, redundans, kombinerer teknisk dybde + senior rådgivning. Bekreftet modell i pitch (PPTX slide 14). + +## Kommersiell modell + +- 6-8 ukers løp (effektivt) +- Time & materials, fakturert løpende +- Blandet timepris ca. 1 480 NOK/time (Ragnhild 1 400, Petter 1 800 — endelig satt før utsending) +- 30 dager netto, reise og utlegg separat + +## Hvorfor dette oppdraget er litt annerledes enn Oras og DNK + +| Aspekt | Standard | Oras | DNK | +|---|---|---|---| +| Dybde | Nivå 1 (avgrenset strategisk) | Nivå 1 men dyp teknisk | Nivå 2 (pågående 6+ mnd) | +| Hovedfokus | Masterdata + arkitektur + **AI-rammeverk** | CRM-konsolidering | Informasjonsarkitektur | +| AI-spor | **Eksplisitt leveranse** (ny dimensjon) | Ikke i scope | Ikke i scope | +| Antall systemer | 3 | 2 CRM + ERP + flere | 10+ fagsystemer | + +Konsekvens: Vi skal IKKE replikere Oras' entity-by-entity-dybde. Vi stopper på domene-nivå. AI-rammeverket er det nye sporet (mappe 6) — operasjonelle prinsipper, ikke arkitektur-spec. + +## Referansecase som danner grunnlag + +- **Oras** (Salg/Oras/): risikoregister-mønster, Executive Summary, integrasjonslandskap +- **Den norske kirke / Nstat** (Kirken/): 9-mappe-struktur, masterdata-vokabular (Begrepseier/Dataforvalter/Master), Privacy by Design, governance på 3 nivåer + +## Salgsmaterialet som etablerer kontekst + +- `../../Salg/Standard/Forslag - Masterdata, arkitektur og AI-klargjøring.md` — fullstendig forslag +- `../../Salg/Standard/Oppdragsbeskrivelse masterdataprosjekt.pdf` — kundens RFP +- `../../Salg/Standard/Standard_Digital2.pptx` — pitch-presentasjonen + +## Sjekkpunkter ved oppstart + +- [ ] Bekreft direktør-navn og stedfortreder +- [ ] Bekreft kontaktperson(er) hos Standard Digital +- [ ] Avtal kommunikasjonsstruktur (Slack? Teams? E-post?) +- [ ] Identifiser 8-12 personer til intervjurunde +- [ ] Få tilgang til eksisterende underlag (arkitekturskisser, dataflyt) +- [ ] Bekreft endelig timepris og total ramme