# LeadPilot — Dashboard UX & Operational Command Architecture

**Document Version:** 1.0.0 (Phase 3 UX Architecture Lock)  
**Status:** Approved & Formally Recorded  
**Primary Question:** *"What should I do today?"*  

---

## 1. Dashboard Layout Wireframe (`LP-DASH-001`)

```
+---------------------------------------------------------------------------------------------------------------+
| Good morning, Rajesh!                              Workspace: Apex Studio               [ + Add Lead (N) ]    |
+---------------------------------------------------------------------------------------------------------------+
| ! ATTENTION REQUIRED (P0)                                                             [ View All 7 Items -> ] |
| ┌───────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────┐ |
| │ Priya Sharma — Website Package                │ │ Alex Turner — Custom API Integration                    │ |
| │ [HOT 92] • Stage: Proposal • Idle: 3 days     │ │ [HOT 88] • Stage: New • Inbound: 2.5 hours ago          │ |
| │ Recommended: Send Proposal Follow-up Nudge    │ │ Recommended: First Response Overdue — Contact Now       │ |
| │ [ Send Follow-up ]        [ Snooze 24h ]      │ │ [ Send Intro Template ]    [ View Details ]             │ |
| └───────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────┘ |
+---------------------------------------------------------------------------------------------------------------+
| OPERATIONAL KPI STRIP (P1)                                                                                    |
| ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌─────────────────────┐ |
| │ NEW TODAY    │ │ NEEDS RESP.  │ │ FOLLOW-UPS   │ │ HOT LEADS    │ │ WON DEALS    │ │ CONVERSION RATE     │ |
| │ 8 leads      │ │ 3 leads      │ │ 5 due today  │ │ 12 active    │ │ $42,500 (3)  │ │ 24.8% (+3.2%)       │ |
| └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ └─────────────────────┘ |
+---------------------------------------------------------------------------------------------------------------+
| SPEED-TO-LEAD & REVENUE RECOVERY (P1)                                                                         |
| ┌───────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────┐ |
| │ MEDIAN FIRST RESPONSE TIME: 14 minutes        │ │ RECOVERED REVENUE (NLLB): $28,000 (4 leads rescued)     │ |
| │ Target: < 15 min • [ Fast Response Badge ]    │ │ Surfaced from Stale Proposals & Closed Successfully     │ |
| └───────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────┘ |
+---------------------------------------------------------------------------------------------------------------+
| LIVE WORKSPACE ACTIVITY FEED (P2)                                                                             |
| • 10:14 AM — Ananya marked lead "David Miller" as Contacted (Stage: Contacted)                               |
| • 09:45 AM — Webhook ingested new lead "Sophia Loren" from Webflow Landing Page                              |
| • 09:12 AM — Follow-up Day 1 Nudge executed for "Marcus Brody"                                               |
+---------------------------------------------------------------------------------------------------------------+
```

---

## 2. Visual Hierarchy & Priority Levels

```
+---------------------------------------------------------------------------------------------------------------+
| TIER | COMPONENT                         | PURPOSE & UX BEHAVIOR                                              |
+------+-----------------------------------+--------------------------------------------------------------------+
| P0   | Attention Required Cards          | Highest visual contrast; displays immediate action triggers.       |
| P1   | Operational KPI Strip             | Clean metrics measuring uncontacted volume and pipeline velocity.  |
| P1   | Response Time & Recovery Bar      | Direct proof of commercial speed-to-lead and saved revenue.        |
| P2   | Live Activity Feed                | Compact chronological audit stream of team interactions.           |
+---------------------------------------------------------------------------------------------------------------+
```

---

## 3. Micro-Interactions & Operational Speed

* **Keyboard Shortcut:** Pressing `N` anywhere on the dashboard opens the Quick Lead Creation modal.
* **Instant Action Dismissal:** Clicking `[Send Follow-up]` or `[Snooze]` on an attention card smoothly animates and removes the card from the strip without refreshing the page.
* **Live Refresh:** Background polling via Alpine.js updates uncontacted counters if a new lead arrives from a website form.