From 70a625510bde26e7fd1fd6d714af573abe937315 Mon Sep 17 00:00:00 2001
From: Bernt <bernt@aamos.systems>
Date: Thu, 2 Jul 2026 11:42:32 +0000
Subject: [PATCH] docs: Journey Principle + Mission Marketplace naming +
 Dashboard prep

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

  - Five phases: Discover, Capture, Process, Outcome, Manage

  - Maps to both quiXzoom and Landvex

  - Screen mapping table

  - Balance check reveals Capture/Process/Outcome are empty

  - Verification: every screen must belong to a phase

- EXPERIENCE_AUDIT_QA.md updated:

  - Screen 3 renamed: Public Map -> Mission Marketplace

  - Added Phase column: Discover

  - One-Sentence Test updated: which missions not how much

  - Added Journey Principle reference

  - Screen 4: Dashboard (Landvex) - awaiting screen

  - Screen 5: Results/Decision View (Landvex) - awaiting screen

- Next: Landvex Dashboard audit (stresstest for Foundation v1.0)

Rationale: Journey Principle prevents screens from floating without

context. Mission Marketplace better reflects the page's purpose.

Dashboard is the most complex screen - best stresstest for principles.
---
 docs/design/EXPERIENCE_AUDIT_QA.md | 12 +++--
 docs/design/JOURNEY_PRINCIPLE.md   | 76 ++++++++++++++++++++++++++++++
 2 files changed, 85 insertions(+), 3 deletions(-)
 create mode 100644 docs/design/JOURNEY_PRINCIPLE.md

diff --git a/docs/design/EXPERIENCE_AUDIT_QA.md b/docs/design/EXPERIENCE_AUDIT_QA.md
index 77bb8a5d1..39bdcb88e 100644
--- a/docs/design/EXPERIENCE_AUDIT_QA.md
+++ b/docs/design/EXPERIENCE_AUDIT_QA.md
@@ -179,10 +179,12 @@ If it takes two or three sentences, the screen is trying to do too much.
 
 ---
 
-## Screen 3: quiXzoom Public Map (Proposed)
+## Screen 3: quiXzoom Mission Marketplace (Proposed)
 
 **Product:** quiXzoom  
-**Status:** 🟡 Proposed design
+**Internal Name:** Mission Marketplace (not "Public Map")  
+**Status:** 🟡 Proposed design  
+**Phase:** Discover
 
 ### Proposed Design
 
@@ -214,7 +216,9 @@ If it takes two or three sentences, the screen is trying to do too much.
 
 ### One-Sentence Test
 
-**"I can see how many missions are near me and how much I could earn."**
+**Target:** "I can see which missions are near me and what they pay."
+
+**Result:** ✅ Pass — concrete, avoids income promise
 
 ### Issues
 
@@ -227,6 +231,8 @@ If it takes two or three sentences, the screen is trying to do too much.
 
 **Verdict:** ✅ Strong — follows "From Reality → Decision" flow.
 
+**Journey Principle:** Discover phase ✅
+
 **Improvements:**
 1. Add real-time activity indicators
 2. Soften income estimate with disclaimer
diff --git a/docs/design/JOURNEY_PRINCIPLE.md b/docs/design/JOURNEY_PRINCIPLE.md
new file mode 100644
index 000000000..4d99f1d40
--- /dev/null
+++ b/docs/design/JOURNEY_PRINCIPLE.md
@@ -0,0 +1,76 @@
+# JOURNEY PRINCIPLE
+
+**Common Journey Framework for quiXzoom and Landvex**
+
+| | |
+|---|---|
+| **Version** | 1.0 |
+| **Status** | LOCKED |
+| **Scope** | All quiXzoom and Landvex screens |
+
+---
+
+## The Five Phases
+
+Every screen must belong to one of five phases:
+
+| Phase | quiXzoom | Landvex | Purpose |
+|-------|----------|---------|---------|
+| **Discover** | Find missions | Define the question | Understand what is available |
+| **Capture** | Take photos/video | Collect observations | Gather reality |
+| **Process** | Review/Approval | AI analysis | Transform input into value |
+| **Outcome** | Payment | Decision index | Deliver value to user |
+| **Manage** | Profile, history, economy | Dashboard, reports, administration | Maintain and optimize |
+
+---
+
+## Screen Mapping
+
+| Screen | Product | Phase | Status |
+|--------|---------|-------|--------|
+| Onboarding | quiXzoom | Discover | ✅ Mapped |
+| Mission Marketplace (Public Map) | quiXzoom | Discover | ✅ Mapped |
+| Mission Camera | quiXzoom | Capture | ⏳ Pending |
+| Review | quiXzoom | Process | ⏳ Pending |
+| Wallet | quiXzoom | Outcome | ⏳ Pending |
+| My Pages | quiXzoom | Manage | ⏳ Pending |
+| Dashboard | Landvex | Manage | ⏳ Pending |
+| Decision Report | Landvex | Outcome | ⏳ Pending |
+
+---
+
+## Verification
+
+For every new screen:
+- [ ] Which phase does this screen belong to?
+- [ ] Does it support the phase's purpose?
+- [ ] Is the phase visible to the user?
+
+---
+
+## Balance Check
+
+| Phase | quiXzoom | Landvex | Risk |
+|-------|----------|---------|------|
+| Discover | 2 screens | 1 screen | Low |
+| Capture | 0 screens | 0 screens | High — core function |
+| Process | 0 screens | 0 screens | High — core function |
+| Outcome | 0 screens | 0 screens | High — value delivery |
+| Manage | 0 screens | 0 screens | Medium |
+
+---
+
+## ändringshistoria
+
+| Version | Datum | Beskrivning |
+|---------|-------|-------------|
+| 1.0 | 2026-07-02 | Initial journey principle for both products |
+
+---
+
+## STATUS
+
+**LOCKED**
+
+- Mindre revideringar: 1.x-serien
+- Brytande ändringar: Kräver Architecture Review, ny major-version (2.0+)