From 8e79e4b006785b9ce464c01d0c9168edd70f2aa4 Mon Sep 17 00:00:00 2001
From: Bernt <bernt@aamos.systems>
Date: Thu, 2 Jul 2026 11:45:07 +0000
Subject: [PATCH] docs: Dashboard Principle + Landvex Dashboard audit prep

- DASHBOARD_PRINCIPLE.md (v1.0, LOCKED):

  - Four questions: What, Where, How serious, What now

  - Information hierarchy: Score -> Observations -> Map -> History -> Details

  - Decision Density: Dashboard = 1-3 decisions max

  - Not BI: helps user make decision, not consume statistics

  - Verification checklist

- EXPERIENCE_AUDIT_QA.md updated:

  - Screen 4: Landvex Dashboard (Phase: Manage)

  - Dashboard-specific questions: 3-second understanding, today's decision,

    80% ignorable, primary CTA

  - Dashboard Principle check: What/Where/How serious/What now

  - Decision Density target: 1-3 decisions

  - One-Sentence Test: understand area performance and what to act on

- Ready for Landvex Dashboard screen (stresstest for Foundation v1.0)
---
 docs/design/DASHBOARD_PRINCIPLE.md | 99 ++++++++++++++++++++++++++++++
 docs/design/EXPERIENCE_AUDIT_QA.md | 29 ++++++++-
 2 files changed, 126 insertions(+), 2 deletions(-)
 create mode 100644 docs/design/DASHBOARD_PRINCIPLE.md

diff --git a/docs/design/DASHBOARD_PRINCIPLE.md b/docs/design/DASHBOARD_PRINCIPLE.md
new file mode 100644
index 000000000..e6a737667
--- /dev/null
+++ b/docs/design/DASHBOARD_PRINCIPLE.md
@@ -0,0 +1,99 @@
+# DASHBOARD PRINCIPLE
+
+**Decision-Centered Dashboard Design for Landvex**
+
+| | |
+|---|---|
+| **Version** | 1.0 |
+| **Status** | LOCKED |
+| **Scope** | All Landvex dashboards |
+
+---
+
+## The Four Questions
+
+Every dashboard must answer:
+
+| # | Question | Example |
+|---|----------|---------|
+| 1 | **What is happening?** | "Area score dropped to 87" |
+| 2 | **Where is it happening?** | "In Nacka municipality" |
+| 3 | **How serious is it?** | "Below threshold of 90" |
+| 4 | **What do I do now?** | "Inspect area" / "Order report" |
+
+If any question is missing, the dashboard is not complete.
+
+---
+
+## Information Hierarchy
+
+```
+LEVEL 1: Score
+         (the single most important number)
+
+LEVEL 2: Three most important observations
+         (what changed, why it matters)
+
+LEVEL 3: Map
+         (where things are happening)
+
+LEVEL 4: History
+         (trends over time)
+
+LEVEL 5: Details
+         (drill-down for deeper analysis)
+```
+
+Not the reverse.
+
+---
+
+## Decision Density
+
+| Screen | Target Decisions | Notes |
+|--------|-----------------|-------|
+| Onboarding | 1 | "Should I join?" |
+| Marketplace | 1 | "Should I register?" |
+| Dashboard | 1–3 | "What do I act on?" |
+| Report | 1 | "Should I invest/repair?" |
+
+If a dashboard tries to support ten decisions, it needs to be split or restructured.
+
+---
+
+## Not BI
+
+Landvex is not BI.
+
+**Not:** Tables, charts, widgets, KPIs.
+**But:** Reality → Understanding → Decision.
+
+The dashboard helps the user make a decision, not consume statistics.
+
+---
+
+## Verification
+
+For every dashboard:
+- [ ] Can I understand the situation in 3 seconds?
+- [ ] What is today's most important decision?
+- [ ] Can I ignore 80% of the information?
+- [ ] Is there a primary CTA?
+- [ ] Does it answer: What, Where, How serious, What now?
+
+---
+
+## ändringshistoria
+
+| Version | Datum | Beskrivning |
+|---------|-------|-------------|
+| 1.0 | 2026-07-02 | Initial dashboard principle for Landvex |
+
+---
+
+## STATUS
+
+**LOCKED**
+
+- Mindre revideringar: 1.x-serien
+- Brytande ändringar: Kräver Architecture Review, ny major-version (2.0+)
diff --git a/docs/design/EXPERIENCE_AUDIT_QA.md b/docs/design/EXPERIENCE_AUDIT_QA.md
index 39bdcb88e..5533f8591 100644
--- a/docs/design/EXPERIENCE_AUDIT_QA.md
+++ b/docs/design/EXPERIENCE_AUDIT_QA.md
@@ -240,14 +240,39 @@ If it takes two or three sentences, the screen is trying to do too much.
 
 ---
 
-## Screen 4: Dashboard (Placeholder)
+## Screen 4: Landvex Dashboard (Placeholder)
 
 **Product:** Landvex  
+**Phase:** Manage  
 **Status:** ⏳ Awaiting screen
 
+### Dashboard-Specific Questions
+
+| # | Question | Target |
+|---|----------|--------|
+| 1 | Can I understand the situation in 3 seconds? | Yes — score immediately visible |
+| 2 | What is today's most important decision? | Clear primary action |
+| 3 | Can I ignore 80% of the information? | Hierarchy: score → observations → map → history → details |
+| 4 | Is there a primary CTA? | "Inspect area" / "Order report" / "View changes" |
+
+### Dashboard Principle Check
+
+| Question | Target |
+|----------|--------|
+| What is happening? | Score + key changes |
+| Where is it happening? | Map or location indicator |
+| How serious is it? | Threshold comparison |
+| What do I do now? | Primary CTA |
+
+### Decision Density
+
+Target: 1–3 decisions
+
 ### One-Sentence Test
 
-Target: "I see what I've earned and what to do next."
+Target: "I understand how my area is performing and what to act on."
+
+If it takes two sentences, the dashboard is trying to do too much.
 
 ---