Thema
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
| Map | Wat het is | Aan 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 up → bin/foundation install → npm 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 start → http://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.
Wat hier niet in zit
- De gegenereerde producten.
deployment/platform.yamlbeheert negen live producten; die wonen allemaal in~/Projects/seifer-projects/…. - De exploratie-skills van fase 1. Die leven in
claude-code-plugins;solution-exploreris 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.