1.5 KiB
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.