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 |
|
| HTTP endpoints | API concern |
|
||||||
| Bucket code | Infrastructure concern |
|
| Bucket code | Infrastructure concern |
|
||||||
| AI logic | Separate 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