Skip to content

De mappen

Seifer/ is één git-repo met tien deelprojecten. Elk deelproject installeert en draait zelfstandig.

npm install in de root doet niets

Er is geen root-package.json en er komt er ook geen. Dat is geen omissie maar het hele punt — zie Conventies.

Overzicht

MapWat het isAan de slag
foundation/De onderlaag: 22 kits + 9 capability-modules + spec/core/scaffolder, 35 losse npm-packages, elk met een eigen integratie-skill. Geen fase in de keten maar de voorraad waaruit de keten put.bin/local-registry upbin/foundation installnpm run verify. Vereist Docker.
solution-explorer/Fase 1 · Ideation. Data- en outputmap van de exploratie-skills: opportunities, solutions, personas, wireframes. VitePress-site.npm install && npm run dev
scaffolder/Fase 2 · Scaffold. CLI die uit een scaffolder.config.yaml een runnende NestJS + Nuxt + Postgres-skeleton genereert.npm install && npm run build, daarna npm run dev
design-system/De derde funderingstier: het merkneutrale white-label design system dat elk product kopieert en rebrandt. Draagt de rebrand- en theming-skills. Eigen Nuxt-docssite onder server/.npm install && npm --prefix server install && npm run dev
wireframe-ds/@for-the-people-initiative/wireframe-kit — de publieke Rough.js-wireframecomponenten voor spoor 4 van de ideation-fase. Eigen npm-release.npm install && npm run storybook
deployment/Fase 4 · Deploy. OpenTofu + docker-compose + platform.yaml als declaratieve registratie van elk live product. Geen Node-project.bin/platform-validate, bin/tofu-deploy
showcase/De negen-module-assemblagepoort. Consumeert de foundation als gepubliceerde tarball, nooit als zustermap — dat is precies wat het bewijst.npm install && npm run test:integration. Vereist Docker + registry.
control-panel/Lokaal bedieningspaneel + dunne orchestrator over de keten. Leidt zijn paden af van zijn eigen locatie.npm install && npm starthttp://localhost:4700
user-stories/Product-backlog over de keten heen (epics → features → stories). Alleen markdown.
documentation-site/Deze site.npm install && npm run dev

Hoe de mappen zich verhouden

De fundering staat in drie mappen

foundation/, design-system/ en wireframe-ds/ zijn samen de laag ónder de keten. Ze staan naast elkaar in plaats van in één map, omdat het design system en de wireframe-kit een eigen build en lockfile hebben die een gedeelde workspace-fan-out niet overleven.

design-system/ — merkneutraal, wordt per product gekopieerd en gerebrand via één bestand (tokens/brand.json). Draagt acht skills, waaronder rebrand en theme-manager.

wireframe-ds/@for-the-people-initiative/wireframe-kit, hand-getekende Rough.js-componenten voor de prototypes in spoor 4. Het enige publieke package in deze repo.

Design system

Wat hier niet in zit

  • De gegenereerde producten. deployment/platform.yaml beheert negen live producten; die wonen allemaal in ~/Projects/seifer-projects/….
  • De exploratie-skills van fase 1. Die leven in claude-code-plugins; solution-explorer is hun data- en outputmap.
  • De npm-artefacten. De 34 @seifer-webapp-factory/*-packages bereiken elkaar via een registry — lokaal Verdaccio op :4873, npmjs bij release.

Seifer — interne documentatie. Bron van waarheid blijft de repo zelf.