dashboard/CLAUDE.md

Feuerwehr Dashboard — Project Rules

Stack

• Frontend: React / Vite / MUI / TypeScript (frontend/)
• Backend: Node / Express / TypeScript (backend/)
• DB: PostgreSQL — migrations in backend/src/database/migrations/
• Deployment: Docker Compose — never run Docker commands locally

Migrations

• All migrations must be idempotent (safe to run multiple times)
• Verify column and table names match existing schema before writing
• Never rename env vars used by external systems without explicit approval

Data Safety

• "Purge user data" means delete records / preferences / history only — never delete user accounts

Debugging Scope

• When debugging, only touch files directly related to the change you made
• Never edit files in another layer without explicit permission
• If a fix requires a cross-layer change, report it rather than making it unilaterally

Multi-Agent Work

• After all agents complete, run a verification pass: build, migrations, UI states, modal behavior
• All agent task descriptions must be self-contained (file paths, patterns, acceptance criteria)