926872a082
- ai-service/convert.py: converts Office/PDF files to markdown with frontmatter - database/seeders/data/: folder structure for themas, projects, documents, etc. - database/seeders/data/raw/: drop zone for Office/PDF files to convert - wiki/: project architecture, concepts, and knowledge graph documentation - Remove unused Laravel example tests Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
70 lines
3.1 KiB
Markdown
70 lines
3.1 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
|
|
|
|
## 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
|