git init

backend/seed-rules.md

@@ -0,0 +1,82 @@
+# Seed Data Rules
+
+The generator must create a **Prisma seed script** so the development database contains minimal sample data. This allows the frontend and API to be used immediately after migration.
+
+---
+
+# Seed Script Location
+
+**File:** `server/prisma/seed.ts`
+
+(Or `server/prisma/seed.js` if the project uses JavaScript; TypeScript is preferred and may require `ts-node` or `tsx` to run.)
+
+---
+
+# Seed Data Requirements
+
+The seed script must create **minimal sample data** for at least one record per main entity, so that:
+
+- List views show data.
+- Reference fields (e.g. equipment type, equipment) have valid options.
+- The app is demo-ready without manual data entry.
+
+## Example scope (TOiR-style domain)
+
+- **One EquipmentType** (e.g. code `"pump"`, name `"Pump"`).
+- **One Equipment** (e.g. linked to that type, with required fields filled).
+- **One RepairOrder** (e.g. linked to that equipment, with required fields filled).
+
+Order matters: create EquipmentType first, then Equipment (references type), then RepairOrder (references equipment). Use Prisma `create` with the generated client; respect unique constraints and foreign keys.
+
+---
+
+# Prisma Seed Configuration
+
+The generator must add the following to **`server/package.json`**:
+
+```json
+"prisma": {
+  "seed": "ts-node prisma/seed.ts"
+}
+```
+
+If the project uses a different runner (e.g. `tsx`), use that instead:
+
+```json
+"prisma": {
+  "seed": "tsx prisma/seed.ts"
+}
+```
+
+Ensure the seed runner is installed (e.g. `ts-node` as dev dependency) so that:
+
+```bash
+npx prisma db seed
+```
+
+runs successfully.
+
+---
+
+# Running the Seed
+
+After migrations:
+
+```bash
+cd server
+npx prisma migrate dev
+npx prisma db seed
+```
+
+Or document that the user can run `npx prisma db seed` once after the first migration to populate sample data.
+
+---
+
+# Summary
+
+| Requirement        | Action |
+|--------------------|--------|
+| Seed script        | Create `server/prisma/seed.ts` (or equivalent). |
+| Sample data        | At least one EquipmentType, one Equipment, one RepairOrder (or equivalent for the DSL). |
+| package.json       | Add `"prisma": { "seed": "ts-node prisma/seed.ts" }` (or tsx). |
+| Seed runner        | Ensure ts-node (or tsx) is available so `prisma db seed` works. |