# Onboarding & First-Run Experience — Overview

**Document Version:** 1.0.0 (Phase 20)  
**Status:** Production Ready · 674 Automated Test Assertions Passing

---

## 1. Executive Summary

Phase 20 delivers a high-conversion, low-friction onboarding flow designed to achieve immediate **Time to First Value**:

```
New Installation
        │
        ▼
Workspace & Business Configuration (Currency, Timezone, Industry)
        │
        ▼
Lead Capture Hub Provisioning (Website Forms, Inbound URLs, API)
        │
        ▼
Automated Follow-Up Sequences Initialized
        │
        ▼
One-Click "Send Test Lead" (HOT AI Score: 88/100, Immediate Action)
        │
        ▼
First Follow-Up Completed & Workspace Activated (`activated_at`)
```

---

## 2. Primary Activation Event

The product defines activation as:
> **A workspace successfully captures/creates its first lead and schedules/sends a follow-up action.**

Activation events are tracked server-side and trigger persistent `activated_at` timestamps on the workspace record.