# LeadPilot — Follow-Up Center & Scheduler UX Architecture

**Document Version:** 1.0.0 (Phase 3 UX Architecture Lock)  
**Status:** Approved & Formally Recorded  
**Primary Screen IDs:** `LP-FLW-001` (Follow-up Hub), `LP-FLW-002` (Scheduler Modal)  

---

## 1. Follow-Up Center Layout (`LP-FLW-001`)

```
+---------------------------------------------------------------------------------------------------------------+
| Follow-Up Center                                                                          [ + Schedule Task ] |
+---------------------------------------------------------------------------------------------------------------+
| TABS: [ Due Today (5) ]       [ Overdue (2) ]       [ Upcoming (14) ]       [ Completed History (86) ]        |
+---------------------------------------------------------------------------------------------------------------+
| DUE TIME  | LEAD & INQUIRY         | STAGE      | AI SCORE  | RECOMMENDED MESSAGE TEMPLATE     | ACTIONS      |
|-----------+------------------------+------------+-----------+----------------------------------+--------------|
| 10:00 AM  | Priya Sharma           | Proposal   | [HOT 92]  | Agency Proposal Follow-up Nudge  | [Send] [Resch|
| (Due Now) | Apex Web Redesign      |            |           | "Hi Priya, checking in on the..."| [Complete]   |
|-----------+------------------------+------------+-----------+----------------------------------+--------------|
| 02:00 PM  | David Miller           | Contacted  | [WARM 65] | Day 1 Discovery Follow-up        | [Send] [Resch|
|           | Brand Identity         |            |           | "Hi David, following up on our..."| [Complete]   |
|-----------+------------------------+------------+-----------+----------------------------------+--------------|
| 04:30 PM  | Alex Turner            | Contacted  | [HOT 88]  | Custom Scope Clarification       | [Send] [Resch|
|           | Custom API Package     |            |           | "Hi Alex, quick question about..."| [Complete]   |
+---------------------------------------------------------------------------------------------------------------+
```

---

## 2. 1-Click Execution & Template Launcher

Clicking `[Send]` opens the focused **Template Quick-Dispatcher Modal**:
* Dynamic merge tags (`{{lead.name}}`, `{{workspace.name}}`) are instantly interpolated.
* 1-Click `[Copy to Clipboard & Mark Sent]` copies the message and transitions the follow-up status to `completed` in a single motion.

---

## 3. The Golden Auto-Pause Invariant (Visual Feedback)

If a lead replies or is marked `Won`/`Lost`, the attached follow-up sequence is automatically paused. The UI displays an informational badge:
```
+-----------------------------------------------------------------------------------+
|  [i] Sequence Auto-Paused: Lead responded via Email at 10:14 AM. Future follow-ups|
|      held to prevent accidental duplicate messaging.                              |
+-----------------------------------------------------------------------------------+
```
