From c08704340806fa1eaf24409871014fa8b9525bc0 Mon Sep 17 00:00:00 2001 From: Bernt Date: Thu, 2 Jul 2026 11:39:37 +0000 Subject: [PATCH] docs: quiXzoom Web vs App Principle + Public Map audit - WEB_APP_PRINCIPLE.md (v1.0, LOCKED): - Web = discover, understand, administer - App = execute - Public web: map-centric, no mission acceptance - Logged-in web: My pages, no mission execution - App: camera-first, offline, GPS, quick submission - Feature matrix verifying separation - EXPERIENCE_AUDIT_QA.md updated: - Added Product Principle: Web vs App - Screen 3: quiXzoom Public Map (proposed design audited) - 3-Second Rule: pass - Three-Step Rule: pass - Primary Decision: pass - Information Hierarchy: pass - Call to Action: pass - One-Sentence Test: I can see how many missions are near me - Issues: income estimate needs disclaimer, add real-time activity - Updated priority order: Dashboard -> Results -> Search -> Settings --- docs/design/EXPERIENCE_AUDIT_QA.md | 118 ++++++++++++++++++++++++---- docs/design/WEB_APP_PRINCIPLE.md | 121 +++++++++++++++++++++++++++++ 2 files changed, 223 insertions(+), 16 deletions(-) create mode 100644 docs/design/WEB_APP_PRINCIPLE.md diff --git a/docs/design/EXPERIENCE_AUDIT_QA.md b/docs/design/EXPERIENCE_AUDIT_QA.md index 61ebf86b4..77bb8a5d1 100644 --- a/docs/design/EXPERIENCE_AUDIT_QA.md +++ b/docs/design/EXPERIENCE_AUDIT_QA.md @@ -136,7 +136,105 @@ If it takes two or three sentences, the screen is trying to do too much. --- -## Screen 3: Dashboard (Placeholder) +## Product Principle: Web vs App + +**quiXzoom has two experiences:** + +### 1. Public Web (Discover) + +**Purpose:** Make the visitor think "There is money to be made here." + +**Allowed:** +- See missions on map +- Zoom and pan +- Filter (category, compensation, distance, difficulty) +- See approximate compensation +- See approximate mission count +- Read how it works +- Register +- Log in + +**Not allowed:** +- Accept missions +- Upload photos/video +- Complete missions + +**Blocker:** "To perform missions, you need the quiXzoom app." + QR code to App Store/Google Play. + +### 2. Logged-in Web Account (Manage) + +**Purpose:** "My pages" β€” administration, not execution. + +**Allowed:** +- Profile (personal info, KYC status, bank account, Stripe Connect status, tax info, notifications) +- Economy (balance, upcoming payout, historical payouts, export CSV/PDF, tax history) +- History (completed missions, approved, rejected, under review) +- Statistics (earned this month, total, approval rate, activity, ranking) +- Mission history (not active missions β€” execution is mobile-only) + +**Not allowed:** +- Accept new missions +- Upload mission data +- Complete missions + +--- + +## Screen 3: quiXzoom Public Map (Proposed) + +**Product:** quiXzoom +**Status:** 🟑 Proposed design + +### Proposed Design + +``` +β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” +β”‚ β”‚ +β”‚ [Google Map] β”‚ +β”‚ β”‚ +β”‚ 442 missions near you β”‚ +β”‚ β”‚ +β”‚ Estimated opportunity: β”‚ +β”‚ $320–$760 / month β”‚ +β”‚ β”‚ +β”‚ [ Register ] β”‚ +β”‚ β”‚ +β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ +``` + +### Audit + +| # | Control | Answer | Notes | +|---|---------|--------|-------| +| 1 | 3-Second Rule | βœ… | "442 missions near you" β€” instantly clear | +| 2 | Three-Step Rule | βœ… | Map (Input) β†’ Stats (Processing) β†’ Register (Outcome) | +| 3 | Primary Decision | βœ… | "Should I register?" | +| 4 | Information Hierarchy | βœ… | Map largest, then number, then CTA | +| 5 | Cognitive Load | β€” | Clean, minimal | +| 6 | Call to Action | βœ… | "Register" button clear | + +### One-Sentence Test + +**"I can see how many missions are near me and how much I could earn."** + +### Issues + +| Severity | Issue | Recommendation | +|----------|-------|----------------| +| Medium | Income estimate sounds like promise | Add disclaimer: "Many active Zoomers in similar areas earn approximately..." | +| Low | No real-time activity | Add: "18 new today", "127 completed last 24h" | + +### Core Principle Alignment + +**Verdict:** βœ… Strong β€” follows "From Reality β†’ Decision" flow. + +**Improvements:** +1. Add real-time activity indicators +2. Soften income estimate with disclaimer +3. Add localized message: "You seem to be in Nacka. Currently approximately 440 missions within reasonable distance." + +--- + +## Screen 4: Dashboard (Placeholder) **Product:** Landvex **Status:** ⏳ Awaiting screen @@ -147,17 +245,6 @@ Target: "I see what I've earned and what to do next." --- -## Screen 4: Map View (Placeholder) - -**Product:** Landvex / quiXzoom -**Status:** ⏳ Awaiting screen - -### One-Sentence Test - -Target: "I find missions near me." - ---- - ## Screen 5: Results/Decision View (Placeholder) **Product:** Landvex @@ -174,10 +261,9 @@ Target: "I get a decision basis based on real observations." | Priority | Screen | Product | Status | |----------|--------|---------|--------| | 1 | Dashboard | Landvex | ⏳ Awaiting screen | -| 2 | Map View | Landvex/quiXzoom | ⏳ Awaiting screen | -| 3 | Results/Decision View | Landvex | ⏳ Awaiting screen | -| 4 | Search | Landvex | ⏳ Awaiting screen | -| 5 | Settings/Profile | Both | ⏳ Awaiting screen | +| 2 | Results/Decision View | Landvex | ⏳ Awaiting screen | +| 3 | Search | Landvex | ⏳ Awaiting screen | +| 4 | Settings/Profile | quiXzoom | ⏳ Awaiting screen | --- diff --git a/docs/design/WEB_APP_PRINCIPLE.md b/docs/design/WEB_APP_PRINCIPLE.md new file mode 100644 index 000000000..cf1920d83 --- /dev/null +++ b/docs/design/WEB_APP_PRINCIPLE.md @@ -0,0 +1,121 @@ +# WEB VS APP PRINCIPLE + +**Product Responsibility Division for quiXzoom** + +| | | +|---|---| +| **Version** | 1.0 | +| **Status** | LOCKED | +| **Scope** | quiXzoom web and mobile applications | + +--- + +## The Principle + +**Web is used to discover, understand, and administer.** +**App is used to execute.** + +--- + +## Web (Public + Logged-in) + +### Public Web β€” Discover + +**Purpose:** Make the visitor think "There is money to be made here." + +**Allowed:** +- See missions on map +- Zoom and pan +- Filter (category, compensation, distance, difficulty) +- See approximate compensation +- See approximate mission count +- Read how it works +- Register +- Log in + +**Not allowed:** +- Accept missions +- Upload photos/video +- Complete missions + +**Blocker message:** "To perform missions, you need the quiXzoom app." + QR code. + +### Logged-in Web β€” Administer + +**Purpose:** "My pages" β€” administration, not execution. + +**Allowed:** +- Profile (personal info, KYC, bank account, Stripe status, tax info) +- Economy (balance, payouts, history, export) +- History (completed missions, approved, rejected, under review) +- Statistics (earned this month, total, approval rate, activity, ranking) +- Mission history (not active missions) + +**Not allowed:** +- Accept new missions +- Upload mission data +- Complete missions + +--- + +## App (Mobile) + +### Purpose: Execute + +**Allowed:** +- Accept missions +- Navigate to mission location +- Capture photos/video +- Submit mission data +- Track mission progress + +**Not allowed:** +- View detailed statistics +- Export financial data +- Manage profile settings + +--- + +## Verification + +| Feature | Web | App | Status | +|---------|-----|-----|--------| +| Discover missions | βœ… | βœ… | Verified | +| Accept missions | ❌ | βœ… | Verified | +| Upload data | ❌ | βœ… | Verified | +| View statistics | βœ… | ❌ | Verified | +| Manage profile | βœ… | ❌ | Verified | +| Export data | βœ… | ❌ | Verified | + +--- + +## Design Implications + +### Web Design +- Map-centric landing page +- Real-time activity indicators +- Clear registration CTA +- Transparent income estimates (not promises) + +### App Design +- Camera-first interface +- Offline capability +- GPS navigation +- Quick submission flow + +--- + +## Γ€ndringshistoria + +| Version | Datum | Beskrivning | +|---------|-------|-------------| +| 1.0 | 2026-07-02 | Initial web vs app principle for quiXzoom | + +--- + +## STATUS + +**LOCKED** + +- Mindre revideringar: 1.x-serien +- Brytande Γ€ndringar: KrΓ€ver Architecture Review, ny major-version (2.0+)