Files
innovatieplatform/CLAUDE.md
znetsixe 46a1279cd6 Initial Laravel scaffold for innovatieplatform
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-01 12:34:23 +02:00

54 lines
2.4 KiB
Markdown

# Innovatieplatform — R&D Lab Waterschap Brabantse Delta
## Project
Innovation governance platform supporting the full lifecycle of innovation trajectories — from signal to handover — with built-in AI support.
**Wiki (source of truth):** https://gitea.wbd-rd.nl/vps1_gitea_admin/innovatieplatform/wiki/
**Repo:** https://gitea.wbd-rd.nl/vps1_gitea_admin/innovatieplatform
## Tech Stack
- **Backend:** Laravel (latest LTS) — service-oriented, event-driven, API-first
- **Frontend:** Vue 3 + Composition API + Vite + Inertia.js
- **Database:** PostgreSQL 16+ with pgvector extension
- **AI Service:** Python (FastAPI + LangGraph + RAG pipeline)
- **Queue:** Redis + Laravel Horizon
- **Infrastructure:** Docker Compose (nginx, php-fpm, queue worker, scheduler, ai-service, postgresql, redis)
## Architecture Principles
- Service-oriented: domain logic in service classes, not controllers
- Event-driven: status transitions via events → listeners
- API-first: all functionality available via API
- Audit trail: all mutations logged (append-only)
- AI content labeled: never auto-published without human confirmation
## Build Agents
All agent definitions are in `.claude/agents/`:
1. **orchestrator** — coordination, planning, task distribution
2. **domain-architect** — domain model, functional design, acceptance criteria
3. **solution-architect** — technical architecture, integration, technology
4. **backend-engineer** — Laravel development, APIs, services, tests
5. **frontend-engineer** — Vue 3 components, Inertia pages, UX
6. **data-modeler** — database schema, migrations, pgvector, seeds
7. **ai-engineer** — Python AI service, RAG, LangGraph, prompts
8. **devops-engineer** — Docker, deployment, infrastructure
9. **security-specialist** — RBAC, audit, compliance, review
10. **doc-designer** — documentation structure, handover, knowledge design
## MVP Scope (8 weeks)
- Project CRUD with innovation lifecycle phases
- Commitments & actions with owner/deadline
- Basic documentation (upload, link, search)
- Simple roadmap visualization
- RBAC (admin, project_owner, team_member, viewer)
- Basic AI chat + project summaries + semantic search
- Dashboard with personal overview
## What Requires Human Validation
- Architecture decisions
- Domain model changes
- UX/design choices
- Scope changes
- AI behavior and prompt templates
- Security findings
- Handover process definitions