# LeadPilot — Ingestion & Capture Sources UX Architecture

**Document Version:** 1.0.0 (Phase 3 UX Architecture Lock)  
**Status:** Approved & Formally Recorded  
**Primary Screen IDs:** `LP-SRC-001` (Sources Hub), `LP-SRC-002` (Form Generator), `LP-SRC-003` (Capture Page), `LP-SRC-004` (Webhook Mapper), `LP-IMP-001` (CSV Importer)  

---

## 1. Guided 3-Step CSV Importer (`LP-IMP-001`)

```
+---------------------------------------------------------------------------------------------------------------+
| Import Leads from CSV / Step 2: Map Columns                                                                   |
+---------------------------------------------------------------------------------------------------------------+
| File: `client_leads_august.csv` (248 rows detected)                      [ Re-upload File ]                   |
+---------------------------------------------------------------------------------------------------------------+
| CSV COLUMN HEADER           | SAMPLE ROW VALUE               | LEADPILOT FIELD MAPPING                        |
|-----------------------------+--------------------------------+------------------------------------------------|
| "Full Name"                 | Priya Sharma                   | [ First & Last Name                        v ] |
| "E-mail Address"            | priya@apexstudio.in            | [ Lead Email                               v ] |
| "Phone Number"              | +91 98765 43210                | [ Phone Number                             v ] |
| "Company Name"              | Apex Studio                    | [ Company Name                             v ] |
| "Project Budget"            | $12,000                        | [ Estimated Deal Value ($)                 v ] |
| "Inquiry Message"           | Looking for agency website...  | [ Inquiry Notes                            v ] |
+---------------------------------------------------------------------------------------------------------------+
| DUPLICATE RESOLUTION: ( * ) Skip duplicates  ( ) Update existing records  ( ) Import as separate leads        |
+---------------------------------------------------------------------------------------------------------------+
|                                                                     [ Cancel ]  [ Start Async Import (248) ->]|
+---------------------------------------------------------------------------------------------------------------+
```

---

## 2. Inbound Webhook Dynamic Key Mapper (`LP-SRC-004`)

Allows non-technical users to connect Typeform, Webflow, or Jotform by pasting a sample webhook payload and mapping keys visually:

```
+---------------------------------------------------------------------------------------------------------------+
| Webhook: "Webflow Contact Form"                                        Endpoint: `/api/v1/webhooks/inbound/..`|
+---------------------------------------------------------------------------------------------------------------+
| RAW INCOMING PAYLOAD (JSON)                     | FIELD MAPPING TARGET                                        |
|-------------------------------------------------+-------------------------------------------------------------|
| `data.fields.name` ("Priya")                    | Maps to ──► [ First Name                                  v]|
| `data.fields.email` ("priya@apex.in")           | Maps to ──► [ Email Address                               v]|
| `data.fields.phone` ("+919876543210")           | Maps to ──► [ Phone Number                                v]|
| `data.fields.message` ("Need website...")       | Maps to ──► [ Inquiry Text                                v]|
+---------------------------------------------------------------------------------------------------------------+
|                                                    [ Send Test Payload ]   [ Save Webhook Mapping ]           |
+---------------------------------------------------------------------------------------------------------------+
```