docs: PR-001 Domain Model v1.1 — Human Intelligence as future module
- Added Human Intelligence as separate external module (not in core domain) - Positioning: External Intelligence Module, not part of Epic-001 - Architecture: Reality Intelligence with four branches: - Infrastructure Intelligence (core, Epic-001) - Operational Intelligence (future) - Human Intelligence (future module) - External Intelligence (future) - Human Insight Artifact: Source, Geography, Period, Metrics, Confidence - Usage: Linked to Area or Decision Case, never mixed with raw observations - Example: Decision Case enriched with 'Many complaints last 30 days' - When: After Epic-001 stable and 20+ Decision Cases exist Rationale: Keep core domain clean. Human data is context, not observation. Add after basic pipeline is proven.
This commit is contained in:
@@ -521,6 +521,60 @@ The concepts `Session`, `Mission`, `Artifact`, `Observation`, `Evidence`, `Findi
|
||||
| HTTP endpoints | API concern |
|
||||
| Bucket code | Infrastructure concern |
|
||||
| AI logic | Separate concern |
|
||||
| Human Intelligence | Separate module, not core domain |
|
||||
|
||||
---
|
||||
|
||||
## Future Module: Human Intelligence (Not in Epic-001)
|
||||
|
||||
**Positioning:** External Intelligence Module, not part of core domain.
|
||||
|
||||
**Why separate:** Customer satisfaction data is not an observation from reality like a road crack. It is **context** that can influence priorities and decisions.
|
||||
|
||||
**Architecture:**
|
||||
```
|
||||
Reality Intelligence
|
||||
│
|
||||
├── Infrastructure Intelligence ← Core (Epic-001)
|
||||
│ Roads, Buildings, Parks, Signs
|
||||
│
|
||||
├── Operational Intelligence ← Future
|
||||
│ SLA, Tickets, Costs, Times
|
||||
│
|
||||
├── Human Intelligence ← Future module
|
||||
│ Customer satisfaction
|
||||
│ Citizen surveys
|
||||
│ NPS, Complaints, Feedback
|
||||
│
|
||||
└── External Intelligence ← Future
|
||||
│ Weather, Traffic, Demographics
|
||||
```
|
||||
|
||||
**Human Insight Artifact:**
|
||||
```
|
||||
Human Insight
|
||||
├── Source: "Kommunenkät 2026"
|
||||
├── Geography: [Stockholm, Nacka]
|
||||
├── Period: "Q2 2026"
|
||||
├── Metrics:
|
||||
│ ├── CSAT: 4.2
|
||||
│ ├── NPS: 62
|
||||
│ └── Complaint Index: 0.34
|
||||
└── Confidence: 0.83
|
||||
```
|
||||
|
||||
**Usage:** Linked to Area or Decision Case, but never mixed with raw field observations.
|
||||
|
||||
**Decision Case with Human Intelligence:**
|
||||
```
|
||||
Observation: "Crack on main street"
|
||||
Evidence: [Image, Video, History, GIS]
|
||||
Human Intelligence: "Many complaints last 30 days, low satisfaction index"
|
||||
Decision: "Prioritize repair within 14 days"
|
||||
Business Impact: "Reduced risk, lower future cost, improved citizen satisfaction"
|
||||
```
|
||||
|
||||
**When:** After Epic-001 is stable and 20+ Decision Cases exist.
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user