# DRE Portal — Full Technical Specifications

## Claim Numbering & Client IDs

| Type | Format | Example |
|---|---|---|
| Claim number | `DRE-YYYY-NNNN` | DRE-2026-0001 |
| Client ID | `CLT-YYYY-NNNN` | CLT-2026-0001 |

Auto-generated on claim submission / account creation.

## Closed Case Binders

Two PDF binders auto-generated on case close:

**Binder 1 — DRE Internal:** `DRE-YYYY-NNNN_CLOSED_DRE.pdf`
- Intake form, uploaded evidence, AI claim analysis, AI debtor research, AI weakness analysis, internal team notes, signed/notarized LPOA, certified mail receipts, communication log, settlement agreement, fee disclosure, payment confirmation

**Binder 2 — Client Package:** `DRE-YYYY-NNNN_CLOSED_Client.pdf`
- Claim summary, signed/notarized LPOA, settlement/payment confirmation, fee statement
- **EXCLUDES:** AI analysis, debtor research, internal notes

**Evidence Archive:** `DRE-YYYY-NNNN_evidence.zip` — original uploaded documents

PDF text is extracted on close and stored in database for full-text search.

## Full 5-Phase Workflow

### Phase 1 — Intake
- Client at debtrecoveryexperts.com fills intake form
- Form order: Your Info (name, business, email, phone) → Debtor Info → Claim Details → Document Upload
- Google reCAPTCHA verification before submit
- ToS signed via DocuSeal
- Claim number auto-assigned, enters DRE queue

### Phase 2 — AI Review
- AI Claim Analysis (Claude Opus 4.7) → score 0-100 + weakness analysis
- AI Debtor Research (ScrapingAnt + Sherlock) → LinkedIn, property records, legal history
- Texas SoS business search (if debtor is registered TX business)
- Team reviews → Approve / Request More Docs / Reject

### Phase 3 — Legal Setup
- LPOA sent via DocuSeal → notarized via Proof (online RON)
- DRE now authorized to collect

### Phase 4 — Tiered Recovery

| Tier | Action | Timeline | DRE-led? |
|---|---|---|---|
| 1 | Soft Touch — email + ACH link | Day 1-5 | ✅ Yes |
| 2 | Formal Demand — certified mail via LetterStream | Day 7-14 | ✅ Yes |
| 2.5 | Lien Threat — pre-lien notice (construction claims) | Day 15-21 | ⚠️ Notice only; filing needs attorney |
| 3 | Escalation — final notice | Day 21-30 | ✅ Yes |
| 4 | Legal Action — referral to partner law firm | Day 30+ | ❌ Referral |

### Phase 5 — Settlement
- Payment via Stripe ACH
- Fee deducted per schedule
- Costs deducted (notary, certified mail, filing fees)
- Balance disbursed → case closed → two binders auto-generated

## Fee Structure

| Tier | DRE Fee | Client Gets |
|---|---|---|
| 1 — Soft Touch | 20-25% | 75-80% |
| 2 — Formal Demand | 30% | 70% |
| 2.5 — Lien Threat | 30% (+ attorney if filed) | 70% |
| 3 — Escalation | 33% | 67% |
| 4 — Legal Action | 10% DRE + 25% law firm | 65% |

**$15,000 example:**
- Tier 1: DRE $3,300 (22%) · Client $11,700
- Tier 2: DRE $4,500 (30%) · Client $10,500
- Tier 3: DRE $4,950 (33%) · Client $10,050
- Tier 4: DRE $1,500 + Firm $3,750 · Client $9,750

## Repeat Clients

- Account system with login
- ToS signed once per client
- Pre-filled info on new claims
- Dashboard: active cases (tier progress bar), past cases with outcomes, payment history
- Download own case binders
- Optional loyalty pricing after 3+ claims

## Client Tier Progress Indicator

Visual 4-step bar in active claim card:
- Numbered circles (green=complete, blue=current, gray=pending)
- Connecting lines between circles
- Label centered under each circle
- Text summary: "✓ Tier 1 complete · Tier 2 in progress · Tier 3 pending · Tier 4 pending"

## Required Services (not yet configured)

| Service | Purpose | Status |
|---|---|---|
| Proof.com | Online notarization | ❌ Need account |
| LetterStream | Certified mail | ❌ Need account |
| Stripe Connect | ACH payments | ❌ Need keys |
| Partner law firm | Litigation (Tier 4) | ❌ Need agreement |
| Google reCAPTCHA | Anti-spam | ❌ Need site key |

## Texas Secretary of State Integration

AI Debtor Research scrapes TX SoS business search for:
- Business status, registered agent, filing date, annual report status, officers/directors
- Informs debtor profile score component