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:
Bernt
2026-07-02 13:50:38 +00:00
parent a08e897f96
commit b4391f9600
+54
View File
@@ -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.
---