# 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

## Wiki (Knowledge Base)

The project wiki lives in `wiki/` and follows the wiki-template schema. It is the canonical knowledge base for agents.

**Quick access:**
- `python wiki/tools/query.py health` — project health overview
- `python wiki/tools/query.py entity "project"` — everything about an entity
- `python wiki/tools/query.py test "phpunit"` — test results
- `python wiki/tools/query.py status "proven"` — all pages with status
- `bash wiki/tools/search.sh "keyword"` — full-text search
- `bash wiki/tools/lint.sh` — check wiki health (orphans, missing frontmatter)

**Source of truth hierarchy:** test results > code > knowledge-graph.yaml > wiki pages > chat

**After making significant changes:** update relevant wiki pages, `knowledge-graph.yaml`, and `wiki/log.md`.

## What Requires Human Validation
- Architecture decisions
- Domain model changes
- UX/design choices
- Scope changes
- AI behavior and prompt templates
- Security findings
- Handover process definitions