Commit Graph

2 Commits

Author SHA1 Message Date
rmac 971d5054f8 Correct schema architecture: YAML is source of truth, not Prisma
Key Corrections:
- Remove manually copied Prisma schema (should be auto-generated from YAML)
- DBAL YAML schemas at /dbal/shared/api/schema/entities/ are source of truth
- Prisma schema is auto-generated from YAML via codegen:prisma
- Update CLAUDE.md and ARCHITECTURE.md to clarify this hierarchy

Schema Layers:
1. /schemas/package-schemas/ - Package system architecture (top-level)
2. /dbal/shared/api/schema/entities/ - Database structure (DBAL source of truth)
3. /prisma/schema.prisma - Generated Prisma schema (derived artifact)

Correct Workflow:
- Edit YAML schemas at /dbal/shared/api/schema/entities/
- Run: npm --prefix dbal/development run codegen:prisma (generates Prisma)
- Run: npm --prefix dbal/development run db:push (applies to DB)

This prevents bot errors of manually editing Prisma schema.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-01-14 18:41:40 +00:00
rmac 8bcc85a470 Implement DBAL Phase 1: Move database ownership from Next.js to DBAL
DBAL Improvements:
- Move Prisma schema to DBAL ownership (dbal/development/prisma/schema.prisma)
- Create Prisma client factory (getPrismaClient, createPrismaClient)
- Create DBAL client factory (getDBALClient, useDBAL)
- Set up seed orchestration structure to load from /seed/ folder
- Add db scripts to DBAL package.json (db:generate, db:push, db:studio)
- Export all factories and seedDatabase from DBAL

Architecture Documentation:
- Create ARCHITECTURE.md: Complete blueprint and data flow explanation
- Update CLAUDE.md: Clear guidance to avoid common bot errors
- Clarify /schemas folder as source of truth for architecture
- Emphasize seed data in /seed/, not in TypeScript code
- Show correct patterns: getDBALClient(), entity operations

Status:
- Phase 1 (DBAL Improvements): COMPLETE
- Phase 2 (Next.js Cleanup): PENDING
- Phase 3 (Build System): PENDING

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-01-14 18:38:16 +00:00