# LeadPilot — Lead Management Core Overview

**Document Version:** 1.0.0 (Phase 7 Lead Management Lock)  
**Status:** Implemented, Tested & Verified (77 Automated Assertions)  
**Positioning:** The system that makes sure every enquiry gets answered and followed up.  
**Signature Concept:** No Lead Left Behind  

---

## 1. Module Responsibilities

The Lead Management Core serves as the central operational engine of LeadPilot:
* **Manual & Ingested Lead Entry:** Fast prospect creation capturing name, email, phone, company, inquiry text, deal value, stage, and tags.
* **Linear Pipeline Management:** Direct 5-stage funnel progression (`New` → `Contacted` → `Qualified` → `Proposal` → `Won` / `Lost`) with strict foreign-key integrity.
* **360° Lead Detail Workflows:** Comprehensive customer history, internal private notes feed, and immutable chronological activity timelines.
* **Operational Attention State:** Highlighting uncontacted leads, overdue callbacks, and high-value proposal staleness.
* **REST API v1 Endpoints:** Fully authenticated endpoints (`/api/v1/leads`) supporting token-hashed integration with external tools.