Gå til indholdet

Melsens — AI Website Factory · dokumentation

Central videns- og dokumentationsbase for Melsens: en AI-drevet virksomhed (to brødre) der leverer semi-automatiseret udvikling af software og websites til nichemarkeder. Dette repo indeholder strategi, arkitektur, research, produkter og beslutninger — ikke selve applikationskoden. Alt materiale er på dansk.

Meget bygger på webresearch (juli 2026) — feltet skifter hurtigt; verificér mod leverandørernes egne sider før endelige beslutninger. Anbefalinger i dokumenterne er forslag, ikke trufne beslutninger, før de er fanget som en ADR (se Konventioner).

🤖 For AI-agenter (læs først)

Arbejder du i dette repo med en AI-agent, så følg AGENTS.md — den kanoniske, værktøjs-neutrale instruktionsfil (proces, konventioner, beslutnings-livscyklus). Den gælder uanset værktøj:

  • Codex / Cursor / andre → læs AGENTS.md.
  • Claude Code → læser CLAUDE.md, som peger på (og importerer) AGENTS.md.

Ny på projektet? Start i ONBOARDING.md — kort guide + en paste-klar prompt der introducerer din AI-agent til hele projektet.

Vil du se dokumentationen som et pænt, privat site? Se docs-portal.md (MkDocs + Cloudflare, auto-opdateret ved git-push). Arkitektur-diagrammer er C4 via LikeC4 — se arkitektur/c4/.

🌐 Live-tjenester (Cloudflare)

Kørende deployments i vores Cloudflare-konto (Workers & Pages):

Tjeneste URL Hvad
📚 Docs-portal documentation-304.pages.dev Denne dokumentation som privat site (bag Cloudflare Access — kun vores e-mails). Bygger automatisk ved push til main.
🔎 CVR-leads (pilot) dkcvrlookup.allan-1f3.workers.dev Worker bag CVR-produktet — se produkter/cvr-leads-hjemmesider/.

Opsætning/hosting af portalen: docs-portal.md. Nye deployments tilføjes her.

Projektet på ét blik

To produktlinjer, to arkitekturer: - A — isoleret pr. kunde: skræddersyet SaaS/app, egen deployment pr. kunde, salgbar som kode. Til få–snese kunder. - B — delt Website OS (fabrikken): ét multi-tenant kodebase → tusindvis af SMV-websites; nyt modul = ét git-push til alle. Til volumen.

Foreslået stak (til beslutning — se [Decision]-issues): Next.js på Vercel → Cloudflare ved skala · Neon (Postgres, multi-tenant + RLS) · Payload CMS · Inngest (agent-workflows) · MobilePay + Frisbii → Dinero (billing) · TypeScript som standardsprog.

Fast krav: MobilePay som betalingsmåde (engangs + recurring) er ufravigeligt.

De fem søjler

Søjle Hvad Start her
🧭 administration/ Strategi, forretningsmodel, roadmap, roller, projektledelse 00-overblik.md
🏗️ arkitektur/ Teknisk fundament + beslutningsgrundlag (+ adr/) 07-website-os-multi-tenant-arkitektur.md
📊 markeds-research/ Markedsanalyse, nichevalg, ICP, go-to-market niche-og-icp.md
📦 produkter/ Ét underbibliotek pr. produkt/tilbud + skabelon produktiserede-tilbud.md
🎨 artifacts/ Committede kopier af visuelle/interaktive artifacts artifacts/

Plus GitHub Issues: [Idé]-issues (idéer/moduler, label idé) og [Decision]-issues (åbne beslutninger, label decision).

Indhold pr. søjle

🧭 administration/

🏗️ arkitektur/

📊 markeds-research/

📦 produkter/

🎨 artifacts/

  • README.md — katalog: hvert visuelt artifact har en committet kopi med link til live-URL + kilde-dokumenter.

Konventioner

  • Arbejdsmåde med AI: følg AGENTS.md (verificér fakta mod primærkilder, anbefalinger ≠ beslutninger, kilder nederst, vær ærlig om trade-offs).
  • Beslutnings-livscyklus: åbne beslutninger lever som [Decision]-issues (label decision). Når en træffes → sæt hak + skriv en ADR i arkitektur/adr/ + opdatér det relevante dokument.
  • Levende dokumentation: opdatér den relevante side når noget ændres/besluttes. Diskussionsoplæg markeres tydeligt øverst.
  • Artifacts spejles: hvert visuelt artifact har en committet kopi i artifacts/, opdateret hver gang den hostede version ændres.
  • Ét produkt = ét underbibliotek under produkter/, kopieret fra _skabelon/.
  • Kildehenvisninger står nederst i de enkelte dokumenter.

Struktur etableret 2026-07-07; konsolideret og udvidet løbende. Arbejdskonventioner: se AGENTS.md.