Add document converter, seeder data structure, and project wiki

- 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>
2026-04-08 08:33:30 +02:00
parent 302c790c13
commit 926872a082
23 changed files with 1785 additions and 76 deletions
--- a/wiki/architecture/domain-model.md
+++ b/wiki/architecture/domain-model.md
@@ -0,0 +1,112 @@
+---
+title: Domain Model
+created: 2026-04-08
+updated: 2026-04-08
+status: evolving
+tags: [domain, models, relationships, lifecycle]
+sources: [app/Models/, app/Enums/, database/migrations/]
+---
+
+# Domain Model
+
+21 Eloquent models organized in 8 layers, with 14 enums for type safety.
+
+## Entity Relationship Overview
+
+```
+Thema (strategic theme)
+  └── Speerpunt (focus area)
+        └── Project (innovation project)
+              ├── Fase (lifecycle phase)
+              ├── Risico (risk)
+              ├── Commitment → Actie (action)
+              ├── Besluit (decision) → Commitment
+              ├── Budget → Besteding (expenditure)
+              ├── Document ← Tag (M:N)
+              ├── LessonLearned
+              ├── Afhankelijkheid (dependency, Project ↔ Project)
+              ├── Overdrachtsplan (handover plan)
+              │     ├── Criterium
+              │     └── Acceptatie
+              └── ProjectUser (team membership, pivot)
+
+User ──── Role (M:N)
+AuditLog (append-only, all mutations)
+KennisArtikel ← Tag (M:N)
+```
+
+## Layer Details
+
+### Strategic Layer
+| Model | Key Fields | Relationships |
+|---|---|---|
+| **Thema** | naam, beschrijving, prioriteit, periode | has many Speerpunten |
+| **Speerpunt** | naam, beschrijving, eigenaar, status | belongs to Thema, has many Projects |
+| **RoadmapItem** | titel, start, eind, type, status | belongs to Thema |
+
+### Project Layer
+| Model | Key Fields | Relationships |
+|---|---|---|
+| **Project** | naam, beschrijving, eigenaar_id, status, prioriteit, startdatum, streef_einddatum | SoftDeletes, belongs to Speerpunt + User (eigenaar), has many of everything |
+| **Fase** | type (enum), status (enum), startdatum, einddatum, opmerkingen | belongs to Project |
+| **Risico** | beschrijving, impact, kans, mitigatie, eigenaar | belongs to Project |
+| **Afhankelijkheid** | type, beschrijving, status | self-referential N:M between Projects |
+
+### Commitment Layer
+| Model | Key Fields | Relationships |
+|---|---|---|
+| **Commitment** | beschrijving, eigenaar_id, deadline, status, bron | belongs to Project + Besluit, has many Acties |
+| **Actie** | beschrijving, eigenaar_id, deadline, status, prioriteit | belongs to Commitment |
+
+### Governance Layer
+| Model | Key Fields | Relationships |
+|---|---|---|
+| **Besluit** | titel, beschrijving, datum, type, status, onderbouwing | belongs to Project, has many Commitments |
+| **Budget** | bedrag, type, periode, status | belongs to Project, has many Bestedingen |
+| **Besteding** | bedrag, beschrijving, datum, categorie | belongs to Budget |
+
+### Knowledge Layer
+| Model | Key Fields | Relationships |
+|---|---|---|
+| **Document** | titel, type, inhoud, versie, auteur, datum, **embedding** (vector) | belongs to Project + Fase, M:N Tags |
+| **KennisArtikel** | titel, inhoud, tags, auteur, datum, **embedding** (vector) | M:N Tags |
+| **LessonLearned** | titel, inhoud, project, fase, tags | belongs to Project + Fase |
+| **Tag** | naam, categorie | M:N with Documents, KennisArtikels |
+
+### Handover Layer
+| Model | Key Fields | Relationships |
+|---|---|---|
+| **Overdrachtsplan** | type, status, eigenaar_rnd, eigenaar_ontvanger | belongs to Project, has many Criteria + Acceptaties |
+| **Criterium** | beschrijving, status, verificatie | belongs to Overdrachtsplan |
+| **Acceptatie** | datum, door, opmerkingen, status | belongs to Overdrachtsplan |
+
+### Auth Layer
+| Model | Key Fields | Relationships |
+|---|---|---|
+| **User** | name, email, password, phone, afdeling, functie, 2FA fields | has many ProjectUsers, can own Projects/Commitments/Risicos |
+| **Role** | naam, beschrijving, permissies | M:N with Users |
+| **ProjectUser** | project_id, user_id, rol (enum) | pivot table |
+
+### System Layer
+| Model | Key Fields | Relationships |
+|---|---|---|
+| **AuditLog** | user_id, action, entity_type, entity_id, payload (JSON) | append-only |
+
+## Innovation Lifecycle Phases (FaseType enum)
+
+```
+signaal → verkenning → concept → experiment → pilot → besluitvorming → overdracht_bouwen → overdracht_beheer → evaluatie
+```
+
+Special statuses (ProjectStatus only, not FaseType):
+- `geparkeerd` — temporarily halted
+- `gestopt` — permanently stopped
+- `afgerond` — completed
+
+## Key Design Decisions
+
+1. **Dutch naming** — all models, fields, enums use Dutch names to match domain language
+2. **Soft deletes on Project only** — projects are never hard-deleted
+3. **Embedding vectors on Document + KennisArtikel** — pgvector columns for semantic search
+4. **ProjectUser pivot with role** — team membership is role-typed (Eigenaar, Lid, Reviewer, Stakeholder)
+5. **FaseType maps 1:1 to first 9 ProjectStatus values** — `FaseType::tryFrom($projectStatus->value)` is used for phase transitions