Last Updated: September 18, 2025
Source: services/domain/models.py
Total Models: 39 (38 dataclass models + 1 enum)
Architecture: Hub-and-spoke documentation by technical layers
Navigate by architectural concern and DDD purity level:
Pure Domain Models (8 models) Business concepts with no infrastructure dependencies
Supporting Domain Models (7 models) Business concepts requiring data structures or complex state
Integration & Transfer Models (16 models) External system contracts, DTOs, data transfer objects, and enums
Infrastructure Models (8 models) System mechanisms, events, and technical concerns
Navigate by business capability and domain area:
#pm - Product Management (12 models) Products, features, stakeholders, work items, projects
#workflow - Process Orchestration (5 models) Workflows, tasks, intents, results, execution
#knowledge - Information Management (9 models) Documents, summaries, knowledge graphs, analysis
#spatial - Spatial Intelligence (5 models) Spatial metaphor, events, objects, context, navigation
#ai - AI Enhancement (3 models) Humanization, insights, confidence scoring
#ethics - Safety & Boundaries (2 models) Ethical decisions, boundary violations, safety
#system - Infrastructure (10 models) Events, lists, todos, conversations, system tracking
#integration - External Systems (6 models) GitHub, Jira, external tool integrations
#files - File Management (4 models) Upload, validation, type detection, processing
| Layer | Count | Primary Functions | DDD Purity |
|---|---|---|---|
| Pure Domain | 8 | Business rules and concepts | ⚠️ Highest - No infrastructure |
| Supporting Domain | 7 | Business with data needs | ⚠️ High - Minimal infrastructure |
| Integration & Transfer | 16 | External contracts and enums | ⚠️ Medium - External dependencies |
| Infrastructure | 8 | System mechanisms | ⚠️ Low - Technical concerns |
| Tag | Model Count | Percentage | Primary Layer |
|---|---|---|---|
| #pm | 12 | 31.6% | Mixed (Pure + Integration) |
| #system | 10 | 26.3% | Infrastructure |
| #knowledge | 9 | 23.7% | Supporting + Integration |
| #workflow | 5 | 13.2% | Pure Domain |
| #spatial | 5 | 13.2% | Supporting Domain |
| #integration | 6 | 15.8% | Integration |
| #files | 4 | 10.5% | Integration |
| #ai | 3 | 7.9% | Mixed |
| #ethics | 2 | 5.3% | Pure Domain |
Note: Some models have multiple tags, percentages sum > 100%
Product Management Domain - Managing products, features, stakeholders, and work items
| Model | Layer | Purpose | File |
|---|---|---|---|
| Product | Pure Domain | Core product entity | pure-domain.md |
| Feature | Pure Domain | Product capabilities | pure-domain.md |
| Stakeholder | Pure Domain | People with product interest | pure-domain.md |
| WorkItem | Integration | External work tracking | integration.md |
| Project | Integration | PM workspace | integration.md |
| ProjectIntegration | Integration | Tool configurations | integration.md |
| ProjectContext | Integration | Workflow context | integration.md |
Process Orchestration - Managing workflows, tasks, and execution
| Model | Layer | Purpose | File |
|---|---|---|---|
| Intent | Pure Domain | User intent classification | pure-domain.md |
| Task | Pure Domain | Individual workflow tasks | pure-domain.md |
| Workflow | Pure Domain | Workflow definitions | pure-domain.md |
| WorkflowResult | Pure Domain | Execution results | pure-domain.md |
Information Management - Documents, analysis, and knowledge graphs
| Model | Layer | Purpose | File |
|---|---|---|---|
| Document | Supporting | Document memory system | supporting-domain.md |
| KnowledgeNode | Supporting | Knowledge graph concepts | supporting-domain.md |
| KnowledgeEdge | Supporting | Knowledge relationships | supporting-domain.md |
| DocumentSample | Integration | Document processing | integration.md |
| ContentSample | Integration | Content analysis | integration.md |
| AnalysisResult | Integration | Analysis outputs | integration.md |
| SummarySection | Integration | Summary structure | integration.md |
| DocumentSummary | Integration | Document summaries | integration.md |
Spatial Intelligence - Spatial metaphor system for navigation and context
| Model | Layer | Purpose | File |
|---|---|---|---|
| SpatialEvent | Supporting | Spatial metaphor events | supporting-domain.md |
| SpatialObject | Supporting | Spatial environment objects | supporting-domain.md |
| SpatialContext | Supporting | Spatial navigation context | supporting-domain.md |
AI Enhancement - AI-generated insights and humanization
| Model | Layer | Purpose | File |
|---|---|---|---|
| Intent | Pure Domain | User intent classification | pure-domain.md |
| ActionHumanization | Supporting | AI text enhancement | supporting-domain.md |
| InsightGenerated | Infrastructure | AI-generated insights | infrastructure.md |
Ethics & Safety - Ethical decisions and boundary violations
| Model | Layer | Purpose | File |
|---|---|---|---|
| EthicalDecision | Pure Domain | Recorded ethical decisions | pure-domain.md |
| BoundaryViolation | Pure Domain | Safety boundary events | pure-domain.md |
⚠️ DDD Purity Warning: Models in this layer must have NO infrastructure dependencies, NO database concerns, and NO external system references. These represent pure business concepts and rules.
8 models representing core business domain: Product management (Product, Feature, Stakeholder), workflow orchestration (Intent, Task, Workflow, WorkflowResult), and ethical decision making (EthicalDecision, BoundaryViolation).
View detailed specifications →
⚠️ DDD Purity Warning: Models in this layer represent business concepts but require data structures, complex state, or specialized methods. Minimal infrastructure acceptable.
7 models supporting business capabilities: Document memory system (Document), spatial intelligence (SpatialEvent, SpatialObject, SpatialContext), knowledge graphs (KnowledgeNode, KnowledgeEdge), and AI enhancement (ActionHumanization).
View detailed specifications →
⚠️ DDD Purity Warning: Models in this layer handle external system contracts and data transfer. External dependencies expected but should be contained.
16 models managing external integration: Work item synchronization (WorkItem), project configuration (Project, ProjectIntegration, ProjectContext), file handling (UploadedFile, ValidationResult, FileTypeInfo), document processing (DocumentSample, ContentSample, AnalysisResult, SummarySection, DocumentSummary), and analysis enums (AnalysisType).
View detailed specifications →
⚠️ DDD Purity Warning: Models in this layer support system operations and technical concerns. Full infrastructure dependencies acceptable.
8 models providing system capabilities: Event tracking (Event, FeatureCreated, InsightGenerated), list management (List, ListItem, ListMembership), task tracking (Todo, TodoList), and conversation logging (Conversation, ConversationTurn).
View detailed specifications →
This hub-and-spoke architecture replaces the outdated domain-models.md with current model documentation reflecting all 38 models in services/domain/models.py.
domain-models.md#[model-name]models/[layer].md#[model-name]Status: ✅ CURRENT - All models documented with complete field definitions and architectural context