Gå til indholdet

ONBOARDING — kom i gang med Melsens-projektet

Kort guide til at blive introduceret til projektet — også hvis du bruger en AI-agent (Codex, Claude Code m.fl.). Alt materiale er på dansk.

1. Hent den rigtige version

Meget af indholdet er udviklet på en feature-branch. Indtil den er merget til main:

  • Reviewer du via en pull request? Så læs diffen dér — den samler alle ændringerne.
  • Arbejder du lokalt? Efter merge ligger alt på main. Er det endnu ikke merget, så checkout branchen: git checkout claude/melsens-architecture-hosting-2jdx4l

2. Læs arbejdskonventionerne først

  • Codex / Cursor / andre agenter: læs AGENTS.md — den kanoniske, værktøjs-neutrale arbejds-/konventionsfil. (Codex indlæser den automatisk fra repo-roden.)
  • Claude Code: læser CLAUDE.md, som peger på og importerer AGENTS.md.

Kernereglerne: dansk · anbefalinger er forslag, ikke beslutninger (før de er ADR'er) · verificér foranderlige fakta (priser/limits) mod primærkilder og dato-stempl · kilder nederst i hvert dokument.

3. Læserækkefølge (menneske)

  1. README.md — projekt-overblik.
  2. administration/00-overblik.md — strategi, de 5 låse-beslutninger.
  3. arkitektur/07-website-os-multi-tenant-arkitektur.md — fabrikken (produktlinje B).
  4. arkitektur/06-isolation-hosting-og-overdragelse.md — isoleret pr. kunde (produktlinje A).
  5. arkitektur/08-modul-system.md + 09-billing-og-betaling.md — moduler + billing (MobilePay/Frisbii/Dinero).
  6. Åbne beslutninger: GitHub Issues → filter label:decision. Modul-idéer → label:idé.
  7. Visuelt overblik: se artifacts/ (fx den interaktive arkitektur-/prissimulering).
  8. Live-tjenester (Cloudflare): docs-portalen på documentation-304.pages.dev (privat, bag Access) og CVR-pilot-workeren dkcvrlookup.allan-1f3.workers.dev. Fuld liste + hosting: README.md → Live-tjenester og docs-portal.md.

4. Introducér din AI-agent (paste-klar prompt)

Peg din agent på repoet og indsæt:

Du skal introduceres til dette repo (Melsens — AI Website Factory, et dansk dokumentations-/beslutningsprojekt). Svar på dansk.

  1. Læs først AGENTS.md i repo-roden — vores kanoniske arbejds- og konventionsfil. Følg den (dansk; anbefalinger er forslag, ikke beslutninger; verificér foranderlige fakta mod primærkilder; markér usikkerhed).
  2. Læs README.md for overblik.
  3. Læs derefter i rækkefølge: administration/00-overblik.md → arkitektur/07-website-os-multi-tenant-arkitektur.md (produktlinje B) → arkitektur/06-isolation-hosting-og-overdragelse.md (produktlinje A) → arkitektur/08-modul-system.md + arkitektur/09-billing-og-betaling.md (moduler + billing: MobilePay/Frisbii/Dinero).
  4. Skim de åbne beslutninger: GitHub Issues med label decision (og modul-idéer med label idé).

Giv mig så en struktureret introduktion: - Hvad er projektet, og hvad er de to produktlinjer (A isoleret vs. B delt Website OS)? - Den foreslåede stak — og hvad er besluttet (fx MobilePay-kravet) vs. stadig åbent? - De vigtigste åbne beslutninger (fra [Decision]-issues), grupperet efter tema. - Hvor finder jeg hvad i repoet (søjlerne)? - 3–5 spørgsmål eller uklarheder du vil rejse for at komme videre.

Verificér ikke priser/limits fra hukommelsen; hvis noget er tidsfølsomt, så markér det og henvis til kildelisten nederst i dokumenterne.

5. Hvor finder jeg hvad?

Se søjle-oversigten i README.md: administration/ (forretning), arkitektur/ (teknik + adr/), markeds-research/ (marked), produkter/ (produkter), artifacts/ (visuelle artifacts), plus GitHub Issues (idé + decision).

Spørgsmål til processen? Se AGENTS.md. Spørgsmål til indholdet? Start i det relevante dokument ovenfor.