Process map — acquisition to exit

1. Lead source map

Every funnel-top channel funnels into the same Postgres lead_inbound table and emits a crm_sync_event mirrored to Dataverse. Ad-network pixels (Meta CAPI, TikTok, Google Ads, Plausible) fan out client-side + server-side, deduped by event_id.

flowchart LR
  subgraph PaidChannels["Paid channels"]
    fb[Facebook Lead Ad]
    google[Google Ads search]
    tiktok[TikTok Lead Ad]
  end
  subgraph OrganicChannels["Organic + offline"]
    driveby[Drive-by sign]
    referral[Resident referral]
    walkin[Walk-in tablet]
    phone[Inbound phone]
  end
  subgraph LandingForms["crosbyheights.com / willislakes.com"]
    inq[/inquire form/]
    tour[/tour form/]
    call[/schedule-call form/]
    apply[Apply Now]
  end
  fb-->|FB Leadgen webhook| api
  google-->|landing visit| LandingForms
  tiktok-->|landing visit| LandingForms
  driveby-->LandingForms
  referral-->LandingForms
  walkin-->|tablet POST| api
  phone-->|operator logs| api
  inq-->|POST /api/intake/inquire| api
  tour-->|POST /api/intake/tour| api
  call-->|POST /api/intake/schedule-call| api
  apply-->|POST /api/apply/inquire| api[(portal-api)]
  api-->|insert| li[(lead_inbound)]
  api-->|emit| sync[(crm_sync_event)]
  sync-->|drain worker| dv[(Dataverse · lead)]
  api-.->|fan out| pixels[Meta CAPI / TikTok / Google / Plausible]

2. Applicant flow (ADR-0030 v3)

Mobile-first form, OTP-gated, with Plaid IDV up front for both primary and co-applicant before the application fee — so we screen out bad data before paying $25/applicant for Kredifi background checks.

sequenceDiagram
  participant App as Applicant
  participant Form as apply.<site>.com
  participant API as portal-api
  participant Plaid
  participant ACS as ACS SMS
  participant AN as AuthNet
  participant Kr as Kredifi
  App->>Form: visits apply
  Form->>API: POST /apply/signup (email, phone)
  API->>ACS: send OTP
  ACS-->>App: SMS code
  App->>Form: enters code
  Form->>API: POST /apply/otp/verify
  API-->>Form: applicant_id + session
  Form->>API: POST /plaid/link-token (product=idv)
  API->>Plaid: create IDV session
  Plaid-->>API: link_token
  API-->>Form: link_token
  Form->>App: Plaid Link iframe — gov-ID + selfie
  Form->>API: POST /plaid/idv/result
  Note over Form,API: ↓ if co-applicant
  Form->>API: POST /apply/coapp/invite (email, phone)
  API->>ACS: SMS deep link to co-app
  Note over App: Co-app does the same flow on their device
  Form->>API: POST /payment/charge (Accept.js opaque_data)
  API->>AN: createTransaction
  AN-->>API: trans_id
  API->>API: emit application.fee_paid sync event
  API->>Plaid: trigger income link_token (both applicants)
  API->>Kr: createOrder (background check, both)
  Kr-->>API: order_id + status
  API->>ACS: SMS decision to primary

3. Payment + screening (autofire chain)

flowchart TB
  pay[application.fee_paid] -->|cron 60s| adv[apply_state_advancer]
  adv -->|both IDV success?| inc[fire Plaid income link tokens]
  inc -->|both income success?| krfan[fire Kredifi for both applicants]
  krfan -->|poll status / webhook| dec[decision rules]
  dec -->|score >= threshold| ok[approve]
  dec -->|score < threshold| cond[conditional / manual review]
  dec -->|disqualified| deny[deny → adverse action letter]
  ok --> docs[lease envelope via Documenso]
  cond --> pm[PM review queue]
  deny --> fcra[FCRA adverse action notice + 30d dispute hold]

4. Move-in prep

flowchart LR
  signed[lease signed in Documenso] -->|webhook| portal[portal-api]
  portal -->|emit| lc[lease.signed sync event]
  portal --> inspect[inspection.scheduled]
  inspect --> tech[Tech does inspection]
  tech -->|inspection cleared| ppsk[PPSK code generation]
  tech -->|inspection has holds| holds[blockers queue · PM review]
  ppsk -->|Assa Abloy API| gate[Gate code programmed]
  gate --> flip[Portal mode flip → resident]
  flip --> welcome[Welcome email + first invoice]

5. Resident steady state

flowchart LR
  cron[weekly cron] --> inv[invoice.created · rent + utilities]
  inv -->|AuthNet ARB or ACH| capture[payment.captured]
  inv -->|NSF / decline| failed[payment.failed → arrears flag]
  resident[Resident submits ticket] --> maint[maintenance.requested]
  maint -->|PM assigns| tech[Technician]
  tech -->|completes| done[maintenance.completed]
  cron2[lease renewal cron · 60/30/14d before end] --> offer[lease.renewal_offered]
  offer -->|sign| ren[lease.renewed → chained lease row]

6. Exit + SODA + refund

flowchart LR
  ntv[Resident NTV] -->|portal/PM| ntvd[lease.ntv_given]
  ntvd --> mout[move-out inspection scheduled]
  mout -->|tech submits| moutc[inspection.move_out_completed]
  moutc --> drft[soda.drafted — auto from move-out form]
  drft -->|PM reviews| fin[soda.finalized — 7-day rule]
  fin --> dmg[damages.invoiced if applicable]
  fin --> ref[refund.issued — AuthNet first, check fallback]
  ref -->|unclaimed 90d| esc[refund.escheated]
  fin --> mo[resident.moved_out → lease.closed]

7. Role responsibilities at a glance

8. System of record matrix

9. External integrations

10. Failure paths + escalations

Generated 2026-05-15 · Updates when ADRs change · Mermaid renders via cdn.jsdelivr.net