# Domain Model

## Hoofdaggregaten

### Workspace
Beveiligings- en administratieve grens. Bezit applications, knowledge spaces en policies.

### Application
Project/client dat RAGCore gebruikt. Heeft service accounts, grants, quota en standaardprofielen.

### KnowledgeSpace
Logische kennisgrens met databeleid, retentie, trustvereisten en toegangsgrants.

### Source
Read-only oorsprong en synchronisatieconfiguratie. Voorbeelden: upload, folder, Git of website.

### Document
Stabiele logische identiteit van content door versies heen.

### DocumentVersion
Immutable snapshot met source fingerprint, blob, canonical artifact, status en timestamps.

### IndexBuild
Afgeleide indexering van een set documentversies onder exact één embedding/indexprofiel.

### RetrievalRun
Auditbare uitvoering met caller, effective spaces, profiel, kandidaten en timings.

### Citation
Immutable verwijzing naar documentversion, location, excerptchecksum en source URI.

### Job
Idempotente achtergrondopdracht met type, payloadversie, lease, attempts en events.

## Identiteiten

- Extern zichtbare objecten: UUIDv7.
- Deterministische chunks/citations: UUIDv5 op immutable inputs.
- Geen incrementele database-ID in publieke contracten.

## Domeinregels

- Exact één actieve documentversion per document.
- Een version wordt nooit inhoudelijk aangepast.
- Een indexbuild mengt nooit embeddingmodel/dimensie/profielversies.
- Een inactive/deleted/quarantined version is nooit actief zoekbaar.
- Een citation blijft naar de gebruikte version verwijzen na latere updates.