Files
boc/docs/design/FIELD_TRIAL_LOG.md
T

114 lines
2.7 KiB
Markdown
Raw Normal View History

# FIELD TRIAL LOG
**Observation Protocol for Decision Model Validation**
| | |
|---|---|
| **Version** | 1.0 |
| **Status** | ACTIVE |
| **Purpose** | Collect raw data from real customer cases |
---
## Log Entry Template
| Field | Example | Notes |
|-------|---------|-------|
| **Date** | 2026-07-15 | |
| **Customer Type** | Municipality / Property Owner / Contractor | |
| **Decision** | Inspect Road A12 | What the system recommended |
| **Decision Accepted** | Yes / No | Did the user accept? |
| **Action Executed** | Yes / No / Pending | Was the action carried out? |
| **Outcome** | Crack confirmed | What actually happened |
| **Time to Decision** | 3 minutes | How long from login to decision |
| **User Feedback** | "We trusted the recommendation." | Verbatim or summary |
| **Confidence** | 87% | System confidence at decision time |
| **Notes** | Free text | Anything else observed |
---
## Example Entries
### Entry 1
| Field | Value |
|-------|-------|
| Date | 2026-07-15 |
| Customer Type | Municipality |
| Decision | Inspect Road A12 |
| Decision Accepted | Yes |
| Action Executed | Yes |
| Outcome | Crack confirmed, repaired within 14 days |
| Time to Decision | 3 minutes |
| User Feedback | "We trusted the recommendation." |
| Confidence | 87% |
| Notes | User clicked through Explainability chain |
### Entry 2
| Field | Value |
|-------|-------|
| Date | 2026-07-16 |
| Customer Type | Property Owner |
| Decision | Repair facade immediately |
| Decision Accepted | No |
| Action Executed | No |
| Outcome | Deferred, user chose to wait |
| Time to Decision | 5 minutes |
| User Feedback | "Too expensive right now." |
| Confidence | 92% |
| Notes | Confidence was high but user rejected due to cost |
---
## Questions This Log Answers
After collecting entries:
- Were recommendations accepted? (Decision Adoption Rate)
- Were actions executed? (Execution Rate)
- Did outcomes match predictions? (Decision Accuracy)
- Was confidence reasonable? (Calibration)
- Which recommendations were ignored? (Rejection Analysis)
- How long did decisions take? (Time to Decision)
---
## Future KPIs
### Decision Adoption Rate
```
Recommendations accepted
────────────────────────
Total recommendations
```
Example: 72 of 100 = **72%**
### Decision Accuracy
```
Decisions that proved correct
─────────────────────────────
Total decisions
```
Example: 65 of 72 executed = **90%**
**Note:** These require months of data. Start collecting now, calculate later.
---
## Status
**ACTIVE — Awaiting first customer case**
---
## ändringshistoria
| Version | Datum | Beskrivning |
|---------|-------|-------------|
| 1.0 | 2026-07-02 | Initial field trial log template |