git init

generation/scaffolding-rules.md

@@ -0,0 +1,78 @@
+# Project Scaffolding Rules
+
+The generator must use **official CLI tools** to create base project structures.
+
+The AI must **not** manually generate the entire project skeleton (e.g. by writing all config files and folder structure by hand). Using the CLI reduces errors and ensures compatibility with current tool versions.
+
+---
+
+# Backend Scaffolding
+
+Use **NestJS CLI**.
+
+## Command
+
+```bash
+npx @nestjs/cli@10.3.2 new server --package-manager npm --skip-git
+```
+
+## Rules
+
+- **Project directory** must be `server`.
+- **TypeScript** must be used (default for Nest CLI).
+- **npm** must be the package manager (`--package-manager npm`).
+- **Git** initialization must be skipped (`--skip-git`).
+
+## After scaffolding — install required dependencies
+
+Run from the `server` directory:
+
+```bash
+npm install @prisma/client
+npm install prisma --save-dev
+npm install @nestjs/config
+```
+
+---
+
+# Frontend Scaffolding
+
+Use **Vite CLI**.
+
+## Command
+
+```bash
+npm create vite@5.2.0 client -- --template react-ts
+```
+
+## Rules
+
+- **Project directory** must be `client`.
+- **React + TypeScript** template must be used (`--template react-ts`).
+
+## After scaffolding — install required dependencies
+
+Run from the `client` directory:
+
+```bash
+npm install react-admin
+npm install ra-data-simple-rest
+npm install @mui/material @emotion/react @emotion/styled
+```
+
+---
+
+# Scaffolding Strategy
+
+Generation pipeline order:
+
+1. **Parse DSL** — Read domain, DTO, API, and UI DSL files.
+2. **Run CLI scaffolding** — Create `server` with NestJS CLI and `client` with Vite CLI; install dependencies as above.
+3. **Code generation** — Generate Prisma schema, NestJS modules/DTOs/PrismaService, and React Admin resources.
+4. **Runtime infrastructure** — Generate `.env`, `.env.example`, package lifecycle scripts, and runtime config files.
+5. **Database runtime** — Generate `docker-compose.yml` in project root with PostgreSQL service (`postgres`, image `postgres:16`, port `5432:5432`).
+6. **Migration** — Apply schema with `npx prisma migrate dev`.
+7. **Seed** — Populate minimal development data with `npx prisma db seed`.
+8. **Validation** — Run checks from `generation/post-generation-validation.md`.
+
+Scaffolding (steps 1–2) must be done with the CLI; steps 3–8 are generated from the DSL and project docs.