📚 EVL MASTER LIBRARY
All credentials, API keys, URLs, Claude integrations, and build log — internal use only.
🔐 Passwords & Access
| Platform | URL | Credential |
|---|
| Admin Dashboard | expressvehiclelocators.com/admin.html | PW: 1027 |
| WS-EVL Wholesale | expressvehiclelocators.com/ws-login | PW: 1027 |
| GitHub | github.com/timogrady01/evl-decode | timogrady01 |
| Vercel | vercel.com/vehicle-locator-service/evl-decode | tog1027-8006 |
| Cloudinary | console.cloudinary.com | Cloud: dv8cpebgp |
| EmailJS | dashboard.emailjs.com | Service: service_rvscjt3 |
| Dealer Email | togradyevl@gmail.com | ACTIVE |
🔑 API Keys
| Service | Key / ID | Purpose |
|---|
| MarketCheck | MC-****SEE MARKETCHECK DASHBOARD**** | VIN decode, market values |
| Cloudinary Preset | evl_photos | Photo uploads — trade-in flow |
| EmailJS Template | service_rvscjt3 | Trade submission notifications |
| Firebase Project | evl-acquisition-radar | Firestore live bids, dealer data, auction engine |
| Firebase API Key | FB-EVL-****SEE FIREBASE CONSOLE**** | Web app config — EVL-RADAR-WEB |
| Firebase App ID | 1:84195145348:web:b10f837bee92ce2e4674d1 | EVL-RADAR-WEB app identifier |
🤖 Claude AI — How It Integrates P&P + BBP
Claude (Anthropic) is embedded into EVL in two ways — as a build partner and as a live AI engine on the Compare page.
| Role | How It Works | EVL Application |
|---|
| 🔧 Build Partner |
Claude writes, edits, and deploys all code directly to GitHub → Vercel via API token. No developer needed. |
Every page on the site was built this way — HTML, CSS, JS, API routes, all of it. |
| 📋 P&P Integration |
Policies & Procedures are fed into Claude as context in each session. Claude applies EVL rules (no delivery without payment, 72hr timeline, deposit structure) automatically. |
Every customer flow, authorization language, and disclosure was written by Claude using EVL P&P as the foundation. |
| 💡 BBP / BITOP |
Best Business Practices and Best In Theory, Optimal Practice — Claude references the EVL journal and blueprint to keep all builds aligned with the business model. |
Pricing logic, deal sequencing, trade card structure, WS exchange flow — all built to BBP spec. |
| ⚡ Live AI Engine |
The Compare page calls Claude Sonnet via api/compare.js — a Vercel serverless function — in real time. |
Vehicle comparisons, trim breakdowns, cost of ownership — all powered by Claude on demand. |
| 📖 Session Memory |
Claude retains EVL build history across sessions via the project memory system and past conversation search. |
No need to re-explain the business — Claude picks up exactly where we left off every session. |
🏢 Dealer Hub — Locked Card Schema & 13-Metro Roadmap (Jun 15, 2026)
Every dealer card in ws-hub.html's DEALER_DATA array follows this 9-role contact roster, locked in to avoid a retrofit pass later. New entries start with all 9 slots (placeholder phone/cell/ext where real names aren't yet known); existing entries get retrofitted as we touch them.
| Role Code | Title | Purpose / P&P Stage |
|---|
| GM | General Manager | Dealership-level escalation & authority |
| GSM | General Sales Manager | Oversees new & used sales depts |
| UCD | Used Car Director | 1st in command, Used dept — bid/sale decisions (Stages 1-3) |
| UCM | Used Car Manager | 2nd in command, Used dept — bid/sale decisions, prep oversight (Stages 1-4) |
| BOM | Business Office Manager | Funds release / wire confirmation (Stage 7) |
| TC-NEW | New Car Title Clerk | Title paperwork — new-car side |
| TC-USED | Used Car Title Clerk | Title scan/send — Title, Reassignment, ODS, BOS (Stage 6) |
| REC | Receptionist | Front door / first point of contact (Stage 2 routing) |
| OTHER | Flexible / Catch-all | Any role not covered above (e.g. Porter Lead, IT contact) |
Each role carries: name (placeholder generic title until real name known), direct phone + ext, cell, email.
13-Metro Build Roadmap:
| Phase | Scope | Status |
|---|
| Phase 1 | All 13 major metros seeded with R/Y/G title-tier flags (lien/payoff complexity for trade-in flow). Includes CA and NY metros. | In progress — DFW, Houston, Atlanta seeded |
| Phase 2 | Per metro, drill down to all dealers within 50mi radius for each of the 12 manufacturers, each card built to the 9-role schema above | Reference benchmark: DFW Hyundai = 7 dealers (Jun 15) |
Note: 9-role expansion is primarily a template/schema change — placeholder slots for GM/GSM/BOM/Title Clerks added alongside existing REC/UCD/UCM, not 9x research per dealer. Differentiated research (dealer name, address, main phone) stays the same per dealer; placeholder org-chart slots get filled in during actual onboarding.
🗺️ Dealer Hub — Statewide Coverage Criteria — LOCKED (Jun 16, 2026)
Texas template scope expanded beyond DFW + Houston. Geographic completeness across Central, South, and West Texas confirmed — no metro is excluded by population size. EVL is a digital, largely automated platform; the marginal cost of adding one more dealer card is low, so size/location-based exclusion isn't necessary or desired.
| Criterion | Rule | Rationale |
|---|
| Franchise Status | HARD GATE — must be a manufacturer-franchised rooftop (official Toyota/Ford/Honda/etc. dealer). Independent used-car lots are never given a manufacturer dealer card — they belong in the separate WS Exchange bidding-dealer (BD) category, not the Dealer Hub. | Keeps the Dealer Hub aligned to actual manufacturer franchise networks; independents are already handled through a different mechanism (auction/bid side). |
| Volume | NO ARTIFICIAL FLOOR. Let the volume number speak for itself — captured in the vol field on every card. A small dealer still gets a card; the number just shows what it is. No minimum threshold excludes a franchised dealer. | "Try all comers within reason" — the platform's automation means there's no meaningful marginal cost to including smaller-volume dealers. Avoids any appearance of favoring only the largest stores. |
| Geographic / Population | NOT A GATING CRITERION. Every major Texas region gets coverage: Central (Austin, San Antonio), South (RGV/McAllen, Corpus Christi, Laredo), West (El Paso, Midland/Odessa, Lubbock), plus Waco, Tyler/Longview, Amarillo as applicable. No metro is skipped for being "too small." | Avoids structurally locking out dealers/customers outside the 2 biggest metros. Coverage scales with where dealers and customers actually are, not an artificial market-size cutoff. |
| Proximity / Redundancy | NOT A CONCERN. Two same-brand dealers close together (e.g., Toyota of Plano vs. Toyota of Dallas) both get full cards — both face the same aged-inventory problem EVL solves for, regardless of distance between them. | EVL's value isn't picking a "best" dealer for the customer — it's being plugged into all of them. Redundancy in coverage is a feature, not waste. |
| Capacity | The only real brake on inclusion is EVL's own ability to onboard/manage the volume of relationships — not the market or dealer size itself. | Acknowledges a real operational ceiling exists, but it's a capacity question for EVL to manage, not a reason to exclude dealers in advance. |
Build sequencing note: Texas remains the proving-ground template. DFW + Houston are furthest along (166 entries as of Jun 16). Central/South/West Texas metros are queued next under this same criteria — full franchised-dealer pulls per manufacturer, no population-based thinning.
🗂️ Tabled for Later — TOL Concerns (Jun 16, 2026)
Captured so the thread isn't lost, but intentionally not being built right now — current focus stays on Dealer Hub / Texas template completion. Revisit after core build is stable.
| Topic | Core Idea | Why Tabled |
|---|
| Proactive Customer FAQ / Command & Control | AI-driven (not static database) help system, segmented by category (Title/Payoff, Trade-In Items, Registration, Payments, Tech, Status). AI generalizes to the specific deal's ID/BD contact info pulled from the 9-role schema, rather than EVL acting as a call center. | Needs the "SaaS not dealership" framing locked first, plus escalation-chain logic (REC → topic role → fallback) before this is buildable correctly. |
| "We Are SaaS, Not a Dealership" Framing | Explicit customer-facing statement that EVL doesn't hold inventory/title/funds, so most day-to-day deal questions are fastest resolved by the issuing/bidding dealer directly — stated BEFORE routing, not as an after-the-fact brush-off. | Load-bearing piece underneath the FAQ system above — needs to be written and approved before the FAQ routing logic is finalized. |
| Escalation Chain Protocol | Receptionist (REC) as first stop always → topic-matched role (TC-NEW/TC-USED for title, UCM for trade items, BOM for payments, UCD for disputes, GSM for general) → fallback to UCD/GM if no response within X hours → OTHER (porter) as live-body fallback. Proactively sets expectation that sales/UC managers are often busy with floor customers. | Open question never resolved: does REC-first apply to every category, or should "gone silent for days" issues skip straight to GM/UCD as an escalation signal? |
| Review Funnel / Avoiding "Keyboard Warriors" | Ask for review only at confirmed positive outcome (vehicle delivered, deal closed clean) — soft-gate with "how was your experience?" first; route happy responses to public review link (Google + one other major platform, name TBD), route unhappy responses to private internal feedback instead of public posting. | Needs the delivery-confirmation trigger point nailed down first (ties to Firebase + EmailJS already wired) — should be quick to build once prioritized. |
| Automated Review Requests | Firestore trigger on "deal marked delivered" fires EmailJS/text with direct review link after a set delay. | Buildable now with existing infra — just not yet sequenced into the build order. |
| Social Media / Guerrilla Marketing (Retail) | Free/low-cost social push to drive customer-facing page traffic — content calendars, captions, posting scripts. | Different skillset than current build (content/growth strategy vs. code/data) — Tim flagged wanting to upgrade to other Claude products to help execute this at scale. |
| D2D Marketing (Wholesale Side) | Door-to-door / direct dealer outreach strategy to recruit independent dealers (IDs/BDs) into the WS Exchange network. | Same as above — strategy/outreach thread, separate from current Dealer Hub data-build work. |
📖 Build Log
| Date | What Was Built / Changed | Status |
|---|
| Jun 15, 2026 | Dealer Hub: DFW expanded to all 12 mfgs (31 entries). Hyundai/DFW completed as full 50mi-radius reference (7 dealers). Locked 9-role dealer card schema (GM/GSM/UCD/UCM/BOM/TC-New/TC-Used/REC/Other) + 13-metro roadmap. | Next: Toyota/DFW full 50mi pass + Hyundai/DFW retrofit to 9-role schema |
| Jun 14, 2026 | Dealer Hub: fixed critical syntax error in ws-hub.html (unescaped apostrophe in "Randall Reed's Planet Ford" broke entire script — Dealer Network/Aged Radar/Porter Dispatch were all dead). Houston now complete with all 6 original mfgs (added Mac Haik Chevrolet, South Houston Nissan, both real dealers with verified addr/phone). Standard expanded 6→12 manufacturers: Toyota, Ford, Chevrolet, Honda, Nissan, Jeep/RAM/Dodge, Hyundai, Kia, Subaru, GMC/Buick/Cadillac, Volkswagen, Mazda. REMAINING: DFW + Houston + Atlanta each need a follow-up pass for the new 6 mfgs (Hyundai/Kia/Subaru/GMC-Buick-Cadillac/VW/Mazda). 10 of 13 metros not yet started (need all 12 mfgs each). Also built EVL-UNIT-SOLD template (live, tested ✅) and full WS Dealer-to-Dealer Settlement P&P (no-escrow model) — see dedicated section above. | IN PROGRESS |
| Jun 10, 2026 | Firebase integrated — EVL-ACQUISITION-RADAR project wired to WS Exchange. Live bids save to Firestore in real time. | DONE |
| Jun 10, 2026 | WS Exchange — Deal Math + Tax Credit Calculator built in. All "Corporate Floor" language replaced with clean "RESERVE" throughout. | DONE |
| Jun 10, 2026 | Trade-In Exchange (/trade-in-exchange) — NEW retail customer-facing page. Live auction tracker, equity options drawer (keep all / split / all in), negative equity paths with LTV calculator (125-130% rule), EVL Finance Advantage savings bubble, Full Lifecycle services section. SaaS badge — "Digital Live Auction — Not a Dealer". | DONE |
| Jun 10, 2026 | WS Vault Master Library — all passwords unified to 1027, LIVE badges made clickable, Firebase config keys documented, Claude AI integration documented (P&P + BBP/BITOP). | DONE |
| Jun 10, 2026 | P&P / BBP / BITOP session — full deal math engine locked in. CarMax as reserve floor. Tax credit arbitrage. Bridge loan timing solution. LTV neg equity paths. EVL Finance advantage (2pt markup elimination). Full lifecycle services activated. | DONE |
| Jun 9, 2026 | WS Vault — Master Library section added | DONE |
| May 31, 2026 | Cloudinary photo upload — 8 slots, odometer required, trade-in flow Step 3 | DONE |
| May 27, 2026 | Admin dashboard — password protected, VIN lookup, offer sheet generator | DONE |
| May 25, 2026 | MarketCheck API integration — VIN decode + market values | DONE |
| May 2026 | WS-EVL platform — login, dashboard, exchange, vault, dealers, intelligence, onboarding | DONE |
| Jun 10, 2026 | Trade-In page — Title Eligibility Gate added. Two-step gate: lien check + state tier (R/Y/G). Red states require acknowledgment checkbox. Progress bar hidden until gate complete. Form only opens after gate passed. | DONE |
| Jun 10, 2026 | State Tier System — 23 states coded R/Y/G. Red: CA, NY, NJ, CT, MA. Yellow: FL, IL, PA, MD, VA, MO, IN, SC. Green: TX, GA, TN, CO, AZ, WA, MN, NC, MI, OH. Each state has specific title/lien issues documented in drawer. | DONE |
| Jun 10, 2026 | Trade-In Exchange — BCS 4-option comparison calculator. BD Submit / EVL Auction / Private Sale / DIY. EVL Auction highlighted gold as best value+speed. EVL advantage bubble shows net savings vs going alone. | DONE |
| Jun 10, 2026 | P&P locked in — Title eligibility rules, 20-day payoff policy, per diem, escrow fee structure ($150 split $75/$75), CarMax as reserve floor, tax credit arbitrage, bridge loan timing, LTV 125-130% rule, state R/Y/G tiers. | DONE |
| Jun 10, 2026 | NEXT UP — BD Submit dedicated flow page, Private Sale Assist tiers ($149/$299/$499), Dealer Hub 13 metros → manufacturer grouping → dealer contact cards → aged inventory (MarketCheck API) | NEXT SESSION |
| Roadmap | Spanish language toggle — customer-facing pages | QUEUED |
| Roadmap | Electronic Glove Box SaaS | QUEUED |
| Roadmap | vAuto trade card PDF export | QUEUED |
💰 Revenue Model & Expansion Roadmap
Last updated: Jun 11, 2026 — Confidential. Internal use only.
① Current Build Priority (Do Now)
| Priority | Item | Status |
|---|
| #1 | BD Submit page — dedicated flow (CarMax · Carvana · SMTV) | DONE — Jun 11 |
| #2 | Private Sale Assist — 3-tier pricing (49 / 99 / 99) | IN PROGRESS |
| #3 | Dealer Hub — 13 metros, mfg grouping, contact cards, aged inventory | QUEUED |
| #4 | Firebase live data — WS Dashboard, Exchange, Dealers | QUEUED |
② Layer 1 — EVL Core Revenue (Active Now)
| Revenue Bucket | Fee | Target Volume | Est. Monthly |
|---|
| Find My Car | 95 flat | 20/mo | ,900 |
| BD Submit (CarMax · Carvana · SMTV) | 99 flat | 20/mo | ,980 |
| EVL Auction | 95 flat | 15/mo | ,425 |
| Private Sale Assist Tier 1 | 49 | 10/mo | ,490 |
| Private Sale Assist Tier 2 | 99 | 8/mo | ,392 |
| Private Sale Assist Tier 3 | 99 | 5/mo | ,495 |
| Escrow / Title Fee | 5 EVL share | 30/mo | ,250 |
| LAYER 1 TOTAL | | 50–60 deals/mo | ~3,900/mo |
③ Layer 2 — BD Provider Partnerships (90-Day Target)
| Provider | Current Status | Revenue Model | Target Date |
|---|
| CarMax / MaxOffer | NOT YET — Build deals first | Tech referral fee per qualified lead. Approach via corporate BD — NOT MaxOffer dealer form (wrong door). | Sep 2026 |
| Carvana | NOT YET — Build deals first | Affiliate program (1–4% per transaction). Start via affiliate network, escalate to direct BD agreement. | Sep 2026 |
| SMTV | NOT YET — Build deals first | Direct revenue-share negotiation. Smaller network = more accessible. Easiest first BD win. | Aug 2026 |
⚠️ POLICY: Do NOT approach BD providers until EVL has 50+ documented closed deals. Negotiate from strength, not need.
④ Layer 3 — Smart Path SaaS Model (6–18 Month Target)
| Phase | What | Target | Est. Revenue |
|---|
| 4A | Smart Path Pilot — 1 dealer group, 5–10 rooftops. White-label EVL flow under dealer branding. | Q4 2026 | 99/mo × 10 = ,990/mo |
| 4B | Smart Path Regional — 1 manufacturer pilot program. EVL licensed to franchised dealer network. | Q1 2027 | 99/mo × 50 = 4,950/mo |
| 4C | Smart Path National — Full manufacturer licensing. Ford, Toyota, GM, Honda target. | Q2–Q3 2027 | 99/mo × 500+ = 50K+/mo |
What Is Smart Path?
- → EVL's entire customer flow (pre-qual gate, state tier, trade eval, comparison calc, BD routing) packaged as a white-label SaaS product.
- → Pitched to manufacturers (Ford, Toyota, GM, Honda) to deploy across franchised dealer networks under their own branding.
- → Dealer receives pre-qualified, pre-evaluated customers who already know their trade value. No more 4-hour negotiation drama.
- → EVL does NOT become a dealer. EVL stays Switzerland — neutral, technology-driven, customer-first at every layer.
- → Minimal re-engineering required. Platform already built. Only change is white-label skin per client.
- → Ford alone = 3,000+ franchised dealers. At 99/mo that is 97,000/mo from one manufacturer relationship.
⑤ Milestone Gates — Do Not Skip Steps
| Gate | Requirement | Unlocks |
|---|
| Gate 1 | 10 closed deals documented | Internal proof of concept — refine the flow |
| Gate 2 | 50 closed deals with outcomes tracked | BD provider outreach — CarMax, Carvana, SMTV |
| Gate 3 | BD provider agreement signed (1 of 3) | Smart Path dealer pilot conversations |
| Gate 4 | Smart Path pilot — 5 rooftops, 90 days data | Manufacturer-level pitch deck ready |
| Gate 5 | 1 manufacturer pilot signed | National licensing negotiations |
⚠️ BBP RULE: Every gate must be earned with real transaction data — not projected. Negotiate from strength at every stage.
🏢 Layer 4 — ESS Enterprise Suite (Full Dealership OS)
Last updated: Jun 11, 2026 — Target: 12–24 months post Gate 1
EVL's endgame is a complete dealership operating system — manufacturer-agnostic, AI-powered, full lifecycle. No single competitor currently offers all four layers in one integrated platform. EVL does not replace existing tools — it integrates with and amplifies them. This is the key to removing dealer resistance.
① Subscription Tiers (Per Rooftop / Per Month)
| Tier | What Is Included | $/Rooftop/Mo | 100 Rooftops | 500 Rooftops |
|---|
| Smart Path Only | Consumer flow + trade eval + BD routing + pre-qual gate + state tier system | $299 | $29,900 | $149,500 |
| Smart Path + ESS | Above + BDC controls + sales floor tools + deal desk + sales cycle timer | $599 | $59,900 | $299,500 |
| Full Enterprise Suite | Everything + EVL Revenue Radar + DS Revenue Radar integration + Mastermind + AutoAlert + all 4 profit centers | $999 | $99,900 | $499,500/mo |
BITOP: One manufacturer. 500 rooftops. Full suite. $499,500/mo pure recurring SaaS. This is the target.
② Module 1 — BDC (Express Sales System)
| Feature | What It Does |
|---|
| Inbound Lead Management | Auto-routes internet leads by source, model, urgency. Response time tracked to the minute. |
| Outbound Campaign Engine | Equity mining campaigns, service-to-sales outreach, conquest targeting — all scheduled and tracked. |
| Appointment Setting | Show rate tracking, no-show follow-up automation, confirmation sequences. |
| BDC Rep Scorecards | Calls made, contacts reached, appointments set, shows, sold. Per rep, per day. |
| CRM Integration | Feeds into DealerSocket, VinSolutions, Reynolds — amplifies, does not replace. |
③ Module 2 — Sales Floor Controls (ESS Floor)
| Feature | What It Does |
|---|
| Traffic Log / Up Management | Every customer logged on arrival. Salesperson assigned. Time-stamped throughout the visit. |
| Deal Desk / Penciling | Worksheet builder, payment scenarios, trade integration, F&I pre-load. |
| Manager To-Do Board | Real-time deal status — who is working, who needs a T.O., who is stuck. |
| Sales Cycle Timer | Every step timed — meet/greet to demo to write-up to close. Compression targets flagged in real time. |
| Salesperson Scorecard | Daily ups, demos, write-ups, closes, gross per deal, CSI — all in one view. |
④ Module 3 — Revenue Radar (Dual Engine)
TWO COMPONENTS — SAME DASHBOARD:
| Component | Source | What It Does |
|---|
| DS Revenue Radar | DealerSocket App (existing) | Mines dealer's existing customer database daily. Flags customers currently in equity position. Monitors SERVICE DRIVE DAILY for upgrade opportunities — customers who purchased from the dealer and are currently servicing with them. Highest-conversion segment in any dealership. This is the pipeline engine. |
| EVL Revenue Radar | EVL Native Build | Real-time gross profit per deal. F&I penetration rates (VSC, GAP, appearance). Finance reserve tracking. Parts and service absorption rate. Daily/weekly/monthly scorecards by all four profit centers. Flags when any department is underperforming vs target. |
| Combined Output | Integrated EVL Dashboard | DS surfaces the opportunity. EVL tracks the outcome. Closed loop from equity identification to gross profit capture. Nothing leaks. No manual handoff between systems. |
⑤ Module 4 — Mastermind + AutoAlert (Equity and Conquest Intelligence)
| Platform | Role | EVL Integration |
|---|
| Mastermind | Equity mining — who in the database is in position to upgrade today. Service-to-sales pipeline. Competitive owner conquest targeting by model and geography. | Mastermind alert fires → EVL ESS creates BDC outreach task automatically → Rep works it → Outcome tracked in EVL Revenue Radar. Full closed loop, no manual handoff. |
| AutoAlert | Real-time alerts when a customer hits an equity trigger. Rate change alerts for finance customers. Inventory match alerts for previous shoppers who left without buying. | AutoAlert trigger → EVL ESS task created → BDC works it → deal tracked to close. Every alert has an outcome — no alerts fall into a void. |
KEY INSIGHT: EVL does not replace Mastermind or AutoAlert. EVL becomes the execution layer that makes those alerts actually produce results — because every follow-through is now tracked, timed, and scored.
⑥ The Four Dealer Profit Centers — EVL Coverage
| Profit Center | EVL Covers | Tools Integrated |
|---|
| Sales | Customer acquisition, trade eval, pre-qual, Smart Path flow, deal desk, cycle compression, salesperson scorecard | EVL Core + ESS Floor + Smart Path |
| Finance / F&I | Deal math engine, tax credit arbitrage, LTV rules, payment scenarios, VSC/GAP tracking, reserve visibility per deal | EVL Revenue Radar + ESS Deal Desk |
| Service | Electronic Glove Box, service-to-sales pipeline, DS Revenue Radar daily service traffic mining, Mastermind service alerts | DS Revenue Radar + Mastermind + AutoAlert |
| Parts | Absorption rate tracking. Flags when parts is not covering fixed overhead. Management alert triggers before end of month. | EVL Revenue Radar |
⑦ EVL vs Smart Path — The Manufacturer Pitch
| Capability | Toyota Smart Path | EVL Enterprise Suite |
|---|
| Manufacturer Agnostic | No — Toyota only | Yes — Ford, Toyota, GM, Honda, any brand |
| Consumer Flow | Basic | Full — pre-qual + state tier + trade eval + BD routing |
| Wholesale Network | None | Full WS dealer exchange + CarMax + Carvana + SMTV |
| BDC Controls | None | Full ESS BDC — scorecards, campaigns, show rate tracking |
| Sales Floor Tools | None | Traffic log, deal desk, cycle timer, manager board, scorecard |
| Revenue Tracking | None | EVL Revenue Radar — all 4 profit centers in real time |
| DS Revenue Radar | None | Native integration — service traffic mined daily |
| Mastermind / AutoAlert | None | Integrated — alerts become BDC tasks automatically |
| AI-Powered | Limited | Claude AI at every decision point |
| Full Lifecycle | Front-end only | First touch through F&I close through service retention |
EVL Integration Philosophy — We Amplify, Not Replace
- → DealerSocket stays. EVL integrates with it and adds the execution tracking layer on top.
- → Mastermind stays. EVL routes its alerts into the BDC workflow automatically.
- → AutoAlert stays. EVL closes the loop — alert fires, task created, outcome tracked to gross.
- → The dealer keeps every tool they trust. EVL is the connective tissue that makes them all produce together.
- → This eliminates the single biggest dealer objection: "We already have tools." EVL answer: "We make your tools produce measurable results."
⑧ Master Timeline — All Four Layers
| Phase | Layer | Milestone | Target |
|---|
| 1 | 1 + 2 | EVL Core live — first real deals closing. WS platform operational. | Now — Jul 2026 |
| 2 | 1 + 2 | 50 closed deals documented with outcomes. Revenue model proven at Layer 1. | Aug – Sep 2026 |
| 3 | 2 | BD provider agreement — SMTV first, then Carvana, then CarMax. Referral revenue activates. | Sep – Oct 2026 |
| 4 | 3 | Smart Path pilot — 1 dealer group, 5–10 rooftops, 90 days data collected. | Q4 2026 |
| 5 | 3 | Smart Path regional — 1 manufacturer pilot, 50 rooftops. Recurring SaaS begins. | Q1 2027 |
| 6 | 4 | ESS Enterprise pilot — full suite, 1 dealer group, all 4 profit centers tracked. | Q2 2027 |
| 7 | 4 | Manufacturer ESS pitch — full enterprise suite, national licensing conversation opens. | Q3 – Q4 2027 |
| 8 | All | National SaaS licensing — multiple manufacturers, hundreds of rooftops, $499K+/mo target. | 2028 |
BBP RULE: No phase is skipped. Every gate is earned with documented transaction data and measurable outcomes. We negotiate from strength at every stage — never from need.
⚖️ Legal Framework — No Dealer License Required
Last updated: Jun 12, 2026 — Confidential. Internal use only. Not legal advice.
This section documents the legal and business model foundation that confirms EVL does not require a dealer license to operate — supported by industry precedent, Texas law framework, and direct competitive validation.
① The Core Legal Position
-
✓
EVL is a technology and advisory platform — not a dealer. EVL never takes title to any vehicle at any point in any transaction.
-
✓
EVL never holds inventory, never purchases vehicles for resale, and never acts as a principal in any buy/sell transaction.
-
✓
EVL coordinates, facilitates, and earns service fees — the same model as a real estate broker, an escrow company, or a technology marketplace.
-
✓
In Texas, a dealer license is required only when buying and selling vehicles in your own name for profit — taking title, holding inventory, and reselling. EVL does none of these.
-
✓
Every EVL page carries the disclaimer: "EVL is a vehicle advisory platform — not a dealer." This is not just positioning — it is the legal foundation of the business model.
② Industry Precedent — Liquid Motors
| Factor | Liquid Motors | EVL |
|---|
| Dealer License | ❌ None — never required | ❌ None — same model |
| Takes Title | Never | Never |
| Holds Inventory | Never | Never |
| Business Model | Technology + marketing service fees | Technology + advisory service fees |
| Location | Richardson TX (DFW) | Plano TX (DFW) |
| Founded | Early 2000s | 2025 |
| Outcome | Acquired by XLerate Group 2021 — $20M+ est. | Building now |
| eBay Motors listings | ✅ Core product | ✅ Building — Channel Launcher |
| Wholesale syndication | ✅ Core product | ✅ WS Hub + Aged Unit Radar |
| Consumer facing | ❌ No | ✅ Full platform — EVL advantage |
| AI powered | ❌ No | ✅ Claude AI at every layer |
BITOP CONCLUSION: Liquid Motors built and sold a $20M+ business in the same DFW market, using the same technology-not-dealer model, with no dealer license — ever. They are the proof of concept that EVL's legal structure is correct and that the market pays for this service. Liquid Motors was acquired by XLerate Group (auction house) in July 2021. Their founder retired June 2023. Their focus has shifted to the auction lane. The independent advisory model they vacated is the space EVL is entering — with a more complete, AI-powered, consumer-plus-wholesale platform they never had.
③ Analog Business Models — Same Legal Framework
| Model | What They Do | License Required? | EVL Parallel |
|---|
| Real Estate Broker | Connects buyer and seller. Never owns the property. Earns commission. | Real estate license — NOT dealer license | EVL connects vehicle buyer and seller. Never takes title. Earns advisory fee. |
| Zillow | Technology platform. Lists homes. Connects parties. Earns referral/advertising fees. | No dealer/broker license for the platform itself | EVL technology platform. Lists vehicles. Connects parties. Earns service fees. |
| Escrow Company | Holds funds during transaction. Never owns the asset. Earns escrow fee. | Escrow license — NOT dealer license | EVL holds process, not title. Earns $75 escrow fee split per transaction. |
| CarMax Affiliate | Routes qualified leads to CarMax. Never touches the vehicle. Earns referral fee. | No dealer license for the referral platform | EVL routes qualified sellers to BD providers. Earns referral + service fees. |
| Liquid Motors | Lists dealer inventory on eBay and classifieds. Never takes title. Earns SaaS/service fees. | No dealer license — ever | EVL Channel Launcher. Lists aged units across channels. Earns listing service fee. |
④ eBay Motors Channel Launcher — Specific Legal Note
-
→
When EVL lists a dealer's aged unit on eBay Motors, the dealer is the seller of record — not EVL. EVL is the listing service agent.
-
→
Title transfers directly from the dealer to the buyer. EVL never appears on any title document.
-
→
EVL charges the dealer a listing service fee — same as Liquid Motors charged their clients. This is a technology service fee, not a dealer transaction fee.
-
→
This model has been validated by Liquid Motors operating in the same DFW market for 15+ years without a dealer license.
-
→
RECOMMENDATION: Have a Texas automotive attorney review EVL's service agreements before the first paid transaction. One-time review — not ongoing counsel. Estimated cost $500–$1,500. Worth every dollar at this stage.
⚠️ BBP RULE: This section documents the legal framework as understood at the time of writing. It is NOT legal advice. EVL should have a Texas automotive attorney review all service agreements, fee structures, and the dealer/non-dealer distinction before the first paid customer transaction. The Liquid Motors precedent and analog models above support the no-dealer-license position — but only a licensed attorney can confirm it applies to EVL's specific agreements and operations.
📺 Channel Staircase — Aged Unit Disposal Process
Last updated: Jun 12, 2026 — Applies to both WS dealer units and consumer Private Sale Assist.
EVL starts where it costs the least and escalates only as far as necessary to get the vehicle sold at the right number. The dealer or customer never pays for a channel they do not need.
① The Math Gate — Before Any Listing Is Created
MarketCheck wholesale predicted price is pulled for every unit BEFORE EVL accepts any listing. This is the non-negotiable floor check. No unit goes live until the math works.
| Formula | Result | EVL Action |
|---|
| MC Wholesale − Dealer Minimum = EVL Gross Spread | POSITIVE | Green light — proceed to staircase |
| MC Wholesale − Dealer Minimum = EVL Gross Spread | ZERO | Review — no margin, discuss with dealer before committing |
| MC Wholesale − Dealer Minimum = EVL Gross Spread | NEGATIVE | Pass — dealer floor above market. Show MC data. Dealer adjusts or EVL declines. |
SECOND MATH CHECK — NET EVL MARGIN:
EVL Gross Spread
− EVL Service Fee ($250–$495)
− Ad Spend (if escalated to paid channels)
− Transport/Porter (if applicable)
─────────────────────────────────
= NET EVL MARGIN → APPROVE / REVIEW / PASS
② The 6-Step Channel Staircase
| Step | Channel | Timeline | EVL Cost | Ad Spend | EVL Fee | Who Pays Ad |
|---|
| 1 | EVL Hub Network — matched dealers within 50 miles | Days 1–7 | $0 | $0 | $250 flat | N/A |
| 2 | Facebook Marketplace + Craigslist — local retail | Days 7–14 | $5/post | $0 | Included in tier | EVL absorbs |
| 3 | CarGurus + Cars.com — in-market retail buyers | Days 14–21 | Time only | $99–$299 | $349 Managed | Passed to dealer |
| 4 | eBay Motors — national buyer pool (180M users) | Days 21–31 | Time + $79 | $79 listing | $495 Full Service | Included in $495 |
| 5 | MarketCheck National (future) — all 13 hubs syndicated | Days 21–31 | API upgrade | Plan upgrade | $495 Full Service | EVL plan cost |
| 6 | EVL WS Exchange fallback — 72hr dealer auction | Day 14 or 31+ | $0 | $0 | $250 flat | N/A |
⚠️ BBP RULE: EVL does not skip steps. Each step is only activated when the previous step has not produced results within the defined window. Ad spend is only committed when the free channels have been exhausted.
MarketCheck National Expansion — When Ready
Current plan: DFW 100-mile radius. When upgraded to national plan — all 13 hubs activate simultaneously. The Aged Unit Radar, Channel Launcher, and Dealer Network tabs all scale with zero code changes. One API key upgrade unlocks the national model. This is the trigger for the manufacturer pitch conversations.
③ When the Math Does Not Add Up — The Three Scenarios
| Scenario | Problem | EVL Response | Outcome |
|---|
| Scenario 1 |
Dealer minimum ABOVE MC wholesale (most common) |
Show dealer the MC data directly. Not EVL opinion — market opinion. 89 sold comps at $31,200 avg vs dealer floor of $34,500. Present auction lane comparison. Dealer adjusts or EVL declines listing. |
Dealer adjusts floor → green light. OR dealer holds → EVL passes. EVL never lists overpriced units — it destroys close rate metrics. |
| Scenario 2 |
Spread exists but EVL net margin too thin after fees |
Lower service tier offered. Use as relationship builder for dealer with better inventory coming. Or pass cleanly — protect EVL's time. |
Lower tier accepted → proceed. OR pass → no hard feelings, keep relationship for future units. |
| Scenario 3 |
Math works but MDS very high (slow market for that model) |
Flag on WS Deal Card. Recommended path skips Steps 1–2 and goes straight to eBay Motors for national exposure. Staircase starts at Step 4. Explain why to dealer upfront. |
Dealer approves accelerated path → eBay Motors Day 1. Better chance of finding buyer in national pool vs saturated local market. |
④ WS Deal Card — Full Specification
Every aged unit that enters EVL's pipeline generates a WS Deal Card before any listing or outreach begins. The card is the deal approval document. No unit moves without an approved card.
| Section | Contents | Source |
|---|
| 1 — Vehicle ID | Year/Make/Model/Trim · VIN · Mileage · Condition · Color · Photos | Dealer intake / VIN decode |
| 2 — Market Intelligence | Retail predicted price · Wholesale predicted price · Price range low/high · Active comps · Sold comps avg · Days on lot · MDS · 30-day depreciation | MarketCheck API |
| 3 — Dealer Profile | Dealer name · Contact · State tier (R/Y/G) · Relationship status · Orphan unit flag | EVL Dealer Network |
| 4 — The Math | MC Wholesale · Dealer Minimum · EVL Spread · Service Fee · Ad Spend · Net EVL Margin · APPROVE / REVIEW / PASS | EVL calculation |
| 5 — Recalls | Open recall count · Component · Summary · NHTSA safety rating | NHTSA API (free) |
| 6 — Matched Buyers | Top 3 dealer matches · Match score · Turn rate · Stock vs need | EVL Buyer Network |
| 7 — Staircase Path | Recommended starting step · Rationale · Timeline · Escalation triggers | EVL algorithm |
| 8 — Approval Gate | 🟢 APPROVED · 🟡 REVIEW · 🔴 PASS · Reason · EVL operator signature · Timestamp | EVL operator |
⑤ Consumer Side — Same Staircase, Same Math
| Tier | Fee | Channels | eBay Motors |
|---|
| Tier 1 — Listing Assist | $149 | FB Marketplace + Craigslist | ❌ Not included |
| Tier 2 — Full Assist | $299 | Above + CarGurus + Cars.com | ❌ Not included |
| Tier 3 — Concierge | $499 | All above + national syndication | ✅ Full Premium listing — national buyer pool |
| Tier 4 — eBay Elite | $699 | eBay Motors primary + all above | ✅ Professional photos + video + full national management — vehicles $30K+ |
Consumer math gate: EVL pulls KBB consumer value (public reference) and MC wholesale as the floor anchor. If customer's minimum expectation is above retail market — conversation happens before listing. Same BBP rule applies — EVL does not list vehicles priced to fail.
THE ONE-LINE PITCH
"EVL starts where it costs the least and escalates only as far as necessary to get your vehicle sold at the right number. You never pay for a channel you do not need."
📋 Build Log — Jun 26, 2026 — Session 2
Appointment notification engine, dealer contact routing, payment collection, Firestore rules update completed.
① Pages Built / Updated
| Page | URL | What Changed | Status |
|---|
| Payment Collection | /payment-collection | NEW. $199 EVL platform fee activation. No credit cards — check/wire/ACH only. Five acknowledgment checkboxes. Saves to evl_activations Firestore collection with full session data and confirmation number. | LIVE |
| WS Onboarding | /ws-onboarding | UPDATED. GSM and Salesperson contact fields added to Step 2. Both saved to evl_ws_dealers under gsm{} and salesperson{} objects. Notification explainer added. | LIVE |
| Appointment Confirm | /appointment-confirm | NEW. Full appointment notification engine. Four simultaneous EmailJS notifications on submit — GSM, SP, Customer, EVL Admin. Saves to evl_appointments Firestore collection with full customer profile, dealer contacts, credit tier, payment range, and confirmation number. | LIVE |
| WS Dashboard | /ws-dashboard | FIXED. evl_dealers → evl_ws_dealers collection name corrected on line 646. Brand match engine now reads correct collection. | LIVE |
| Firestore Rules | firestore.rules | UPDATED. Added evl_appointments (public create, owner/admin read) and evl_activations (public create, owner/admin read). Pushed to GitHub. Needs paste into Firebase Console to activate. | PENDING FIREBASE |
② EmailJS Templates — Written — Pending Creation
| Template Name | Template ID | Fires To | Status |
|---|
| EVL-APPT-DEALER | template_appt_dealer | GSM + Salesperson simultaneously | PENDING |
| EVL-APPT-CUSTOMER | template_appt_customer | Customer appointment confirmation | PENDING |
| EVL-APPT-ADMIN | template_appt_admin | Tim — togradyevl@gmail.com admin alert | PENDING |
③ Key Decisions Locked
| Decision | Detail |
|---|
| No Vehicle Hold | EVL does not hold or reserve vehicles. No deposit. No courtesy hold. Speed is the model — pre-qualified customer moves fast and arrives at scheduled time. |
| No Money Through EVL | EVL never holds or processes funds of any kind. $199 platform fee is the only EVL charge — paid by check/wire/ACH only. No credit cards ever. |
| GSM + SP Routing | Every appointment notification fires simultaneously to GSM AND Salesperson. Both captured during onboarding. No lead ever goes to a single inbox. |
| Four-Party Notification | GSM (email) + Salesperson (email) + Customer (confirmation) + EVL Admin Tim (alert). All four simultaneous on every appointment submission. |
| Twilio Business Number | +14694043192 is both the FROM number and test recipient. Old test number +14698772165 is retired. |
④ Outstanding — Needs Desktop Session
| Item | Action Required | Where |
|---|
| Firestore Rules | Copy firestore.rules from GitHub → paste into Firebase Console → Firestore → Rules tab → Publish | console.firebase.google.com → evl-acquisition-radar |
| EmailJS Template 1 | Create EVL-APPT-DEALER at emailjs.com | emailjs.com → Email Templates → Create New |
| EmailJS Template 2 | Create EVL-APPT-CUSTOMER at emailjs.com | emailjs.com → Email Templates → Create New |
| EmailJS Template 3 | Create EVL-APPT-ADMIN at emailjs.com | emailjs.com → Email Templates → Create New |
| Twilio SMS | Vercel → Settings → Env Vars → confirm 3 vars present → hit /api/debug-env → test to +14694043192 | vercel.com → evl-decode project |
| WordPress Audit | WP Admin → Pages → All Pages → screenshot and send to Claude for cross-reference | expressvehiclelocators.com/wp-admin |
📋 Full Repo Audit — Jun 26, 2026 — All 49 Pages Documented
Complete audit of all HTML pages in the public/ directory. 14 pages were previously undocumented in the vault. All are now logged below.
① Previously Undocumented Pages — Now Logged
| Page | URL | What It Does | Category |
|---|
| Admin Calls | /admin-calls | EVL Call Center admin tool — logs inbound consumer calls, captures name/phone/vehicle interest/notes, saves to Firestore evl_consumer_calls collection, "Add to Mastermind" flow wires call records into the retail CRM. Admin-only access. | ADMIN |
| Admin Comms | /admin-comms | EVL Communication Templates admin page — outreach email and SMS template library for dealer and consumer communications. Admin-only access. | ADMIN |
| Admin Docs | /admin-docs | EVL Legal & Documents admin page — stores and manages legal documents, agreements, and compliance materials. Admin-only access. | ADMIN |
| Admin Scripts | /admin-scripts | EVL Script Repository — call scripts, BDC scripts, dealer outreach scripts, customer-facing advisory scripts. Organized by use case. Admin-only access. | ADMIN |
| Auto Alert | /auto-alert | Automated vehicle alert system — customer signs up to be notified when a specific vehicle matching their criteria becomes available. Feeds into EVL lead pipeline. | RETAIL |
| Find My Car | /find | AI-powered vehicle research and comparison tool — consumer-facing. Category cards (Trucks/SUVs/Luxury/Electric), search bar, AI chat interface for vehicle comparisons, specs, and recommendations. Free lead generator — no login required. | RETAIL |
| Finder | /finder | Vehicle Finder flow — step-by-step vehicle identification tool. Multi-step card-based flow for customer to specify year/make/model/trim/color/options. Feeds into EVL deal pipeline. | RETAIL |
| Mastermind | /mastermind | EVL Mastermind — retail-side customer intelligence CRM. Tracks consumer deal progress, contact info, vehicle interest, trade status, payment estimate, notes. Saves to Firestore evl_mastermind_customers collection. Receives records from admin-calls via "Add to Mastermind" flow. Admin-only access. | ADMIN |
| Privacy Policy | /privacy | Full Privacy Policy — EVL data collection practices, cookie policy, third-party services, customer rights, contact information. Legally required. Linked from footer on all pages. | LEGAL |
| Refund Policy | /refund | EVL Refund Policy — $199 platform fee refund conditions, timeline, process. Covers no-sale waiver condition (fee waived if no auction sale occurs). Legally required. | LEGAL |
| Revenue Radar | /revenue-radar | EVL Revenue Radar — admin financial intelligence dashboard. Tracks platform fee revenue, auction close rates, deal pipeline value, hub performance metrics. Admin-only access. | ADMIN |
| Service Agreement | /service-agreement | EVL Service Agreement — full platform services agreement covering EVL's role as technology platform (not dealer/lender), customer obligations, fee structure, limitation of liability, dispute resolution. Legally required. Customer signs before deal activation. | LEGAL |
| Terms of Service | /terms | EVL Terms of Service — platform usage terms, prohibited uses, intellectual property, disclaimers, governing law (Texas). Legally required. Linked from footer on all pages. | LEGAL |
| Trade-In Evaluator | /trade-in | Original customer-facing trade-in evaluation flow — VIN entry, vehicle details capture, photo upload (Cloudinary), condition assessment, Title Eligibility Gate (lien status + state tier detection with Green/Yellow/Red tiers), equity calculation, EVL auction submission. Feeds into evl_auctions Firestore collection. | RETAIL |
② Complete Page Inventory — All 49 Pages — GitHub Verified Dates
| Page | URL | Category | First Built | Vault |
|---|
| CRM Dashboard | /crm | Unified customer relationship management — 4 tabs (Incoming Leads, Active Deals, Appointments, Closed/Sold). Tracks all customer interactions with full audit trail. Real-time Firebase sync. Status progression: new → contacted → qualified → booked → sold. Includes appointment scheduling with SP confirmation and Internet Dept nudge system. |
| Lead Dashboard | /admin-leads | Real-time customer lead management. Shows all leads from evl_leads collection. Advisors (logged-in only) can view lead details, change status (new → contacted → qualified → booked). Firestore synced, timestamped audit trail. |
| Admin Bid Board | /admin-bid-board | Admin | Jun 13, 2026 | ✅ |
| Admin Calls | /admin-calls | Admin | Jun 24, 2026 | ✅ |
| Admin Comms | /admin-comms | Admin | Jun 3, 2026 | ✅ |
| Admin Docs | /admin-docs | Admin | Jun 3, 2026 | ✅ |
| Admin Scripts | /admin-scripts | Admin | Jun 4, 2026 | ✅ |
| Admin Dashboard | /admin | Admin | Jun 3, 2026 | ✅ |
| Appointment / Schedule | /appointment | Retail | Jun 5, 2026 | ✅ |
| Auto Alert | /auto-alert | Retail | Jun 5, 2026 | ✅ |
| BD Submit | /bd-submit | Retail | Jun 14, 2026 | ✅ |
| Compare / Research | /compare | Retail | Jun 10, 2026 | ✅ |
| Contact | /contact | Retail | Jun 18, 2026 | ✅ |
| Credit Score | /credit-score | Retail | Jun 26, 2026 | ✅ |
| Dealer Onboard | /dealer-onboard | Wholesale | Jun 13, 2026 | ✅ |
| Dealer Outreach Hub | /dealer-outreach-hub | Admin | Jun 13, 2026 | ✅ |
| EVL Notif Engine | /evl-notif-engine | Admin | Jun 14, 2026 | ✅ |
| FAQ | /faq | Retail | Jun 5, 2026 | ✅ |
| Financing | /financing | Retail | Jun 5, 2026 | ✅ |
| Find My Car | /find | Retail | Jun 5, 2026 | ✅ |
| Finder | /finder | Retail | Jun 5, 2026 | ✅ |
| Home | /home | Retail | Jun 10, 2026 | ✅ |
| How It Works | /how | Retail | Jun 5, 2026 | ✅ |
| Index (Landing) | / | Retail | May 31, 2026 | ✅ |
| Leasing | /leasing | Retail | Jun 10, 2026 | ✅ |
| Live Bid Board | /live-bid-board | Wholesale | Jun 13, 2026 | ✅ |
| Login (Customer) | /login | Retail | Jun 25, 2026 | ✅ |
| Mastermind CRM | /mastermind | Admin | Jun 24, 2026 | ✅ |
| Moment of Truth | /moment-of-truth | Retail | Jun 26, 2026 | ✅ |
| My Deal | /my-deal | Retail | Jun 26, 2026 | ✅ |
| Payment Estimator | /payment-estimator | Retail | Jun 26, 2026 | ✅ |
| Privacy Policy | /privacy | Legal | May 29, 2026 | ✅ |
| Private Sale Assist | /private-sale | Retail | Jun 14, 2026 | ✅ |
| Protection | /protection | Retail | May 29, 2026 | ✅ |
| Refund Policy | /refund | Legal | May 31, 2026 | ✅ |
| Revenue Radar | /revenue-radar | Admin | Jun 4, 2026 | ✅ |
| Reviews / Client Wins | /reviews | Retail | Jun 10, 2026 | ✅ |
| Savings | /savings | Retail | Jun 10, 2026 | ✅ |
| Schedule a Call | /schedule | Retail | Jun 26, 2026 | ✅ |
| Service Agreement | /service-agreement | Legal | Jun 5, 2026 | ✅ |
| Terms of Service | /terms | Legal | May 29, 2026 | ✅ |
| Trade-In Exchange | /trade-in-exchange | Retail | Jun 26, 2026 | ✅ |
| Trade-In Evaluator | /trade-in | Retail | Jun 18, 2026 | ✅ |
| WS Dashboard | /ws-dashboard | Wholesale | Jun 25, 2026 | ✅ |
| WS Dealers | /ws-dealers | Wholesale | Jun 23, 2026 | ✅ |
| WS Exchange | /ws-exchange | Wholesale | Jun 25, 2026 | ✅ |
| WS Hub | /ws-hub | Wholesale | Jun 23, 2026 | ✅ |
| WS Intelligence | /ws-intelligence | Wholesale | Jun 5, 2026 | ✅ |
| WS Login | /ws-login | Wholesale | Jun 25, 2026 | ✅ |
| WS Onboarding | /ws-onboarding | Wholesale | Jun 9, 2026 | ✅ |
| WS Vault | /ws-vault | Admin | Jun 9, 2026 | THIS PAGE |
⚡ All dates verified from GitHub commit history — accurate to the day each file was first pushed to the repository.
Last full audit: Jun 26, 2026.
📋 Build Log — Jun 26, 2026 Session
Full retail consumer build session. Completed the Title Eligibility Gate, Credit Score Hand-Off, Payment Estimator enhancements, Moment of Truth screen. Entire retail sequence from login through deal activation now built and deployed.
① Pages Built / Updated Today
| Page | URL | What It Does | Status |
|---|
| Trade-In Exchange — Title Gate | /trade-in-exchange | Title Eligibility Gate added — Step 1: lien status (financed vs paid off). Step 2: two separate state dropdowns — physical location AND title state. Mismatch detection fires gold warning if states differ. Green/Yellow/Red tier detection runs on title state. Red state (CA/NJ/NY) requires acknowledgment checkbox before Continue unlocks. Gate saves lien status, physical state, title state, and tier to sessionStorage. | LIVE |
| Credit Score Hand-Off | /credit-score | NEW PAGE. 5-step progress bar. EVL never pulls credit disclosure. Six credit tier range buttons (Excellent/Very Good/Good/Fair/Rebuilding/Challenged). Exact score input (300–850). Four free third-party check options (Credit Karma, Experian, AnnualCreditReport, Capital One CreditWise). Proceed anyway door with acknowledgment checkbox. Score saves to sessionStorage and auto-carries to payment estimator. | LIVE |
| Payment Estimator — Enhancements | /payment-estimator | UPDATED. Added: (1) Term slider — drags 36/48/60/72/84 months with live label update. (2) Backward calculator tab — "What Can I Afford?" — target payment slider $200–$1,500, down payment input, term slider, calculates max vehicle price + out-the-door estimate + required down for specific vehicle + term tradeoff table. (3) Custom rate input box — customer enters their own quoted rate, estimate uses actual rate instead of Experian average. (4) Manufacturer rate disclaimer — fires automatically when entered rate drops below 3% (incentive rate warning with rebate tradeoff). (5) Credit score auto-carries from credit-score page via sessionStorage. (6) Full disclosure system — ⓘ buttons on all calculation surfaces. | LIVE |
| Moment of Truth | /moment-of-truth | NEW PAGE. Deal reality check screen — Step 4 of 5. Pulls all sessionStorage data into one clean summary: vehicle price, down payment, trade equity, amount financed, credit score, rate used, term, EVL platform fee, estimated tax/title/fees. Large payment range display with target payment comparison (over/under/match). Three doors: (1) See Vehicles In My Range → /find, (2) What If I Put More Down? → expands with live calculator showing new payment and monthly savings, (3) Adjust My Loan Term → expands with 4-column term tradeoff table showing payment/total paid/extra interest with honest tradeoff warning. Proceed Anyway acknowledgment checkbox unlocks Activate button → /payment-collection. Clean exit → /my-deal. Full ⓘ disclosures on payment range and tax/title estimates. | LIVE |
② Key Decisions Locked Today
| Decision | Detail |
|---|
| Two-State Gate | Title Eligibility Gate captures both physical location AND title state separately. Title state drives tier detection (Green/Yellow/Red). Physical state captured for EVL operating footprint. Mismatch notice fires if they differ. |
| EVL Never Pulls Credit | Hard rule confirmed — EVL is a technology platform, not a lender or CRA. Customer self-reports from third-party source. Credit Karma / Experian / AnnualCreditReport / Capital One CreditWise offered as free hand-off options. Score stored in sessionStorage only — never transmitted to EVL backend. |
| Manufacturer Rate Disclaimer | Auto-fires when entered rate is below 3%. Covers: top-tier credit requirement, model eligibility, captive lender requirement, expiration risk, and the rebate tradeoff ($1,500–$3,000 cash rebate often forfeited to get incentive rate). Customer must see this before calculating. |
| Moment of Truth — Informs, Never Blocks | The screen is a reality check, not a gate. Three doors plus proceed anyway plus clean exit. A fully-informed customer who still wants to move forward can do so — EVL does not decide for them. Proceed anyway requires acknowledgment checkbox (informed consent protection). |
| Term Tradeoff — Shown Honestly | Every term calculation shows: payment, total paid over life of loan, AND extra interest paid. Longer term lower payment must always be shown alongside the true cost. No hiding the math. |
| Rate Tables | Experian Q4 2025 averages baked in. New car: Super-prime 4.66% / Prime 6.27% / Near-prime 9.57% / Subprime 13% / Deep subprime 16.01%. Used car: +3pts across all tiers. Update quarterly — approximately 6–10 weeks after each quarter ends. |
| Disclosures | Every calculation surface has a tappable ⓘ disclosure button. Never shortened. Forward results, backward results, custom rate, manufacturer rate, tax/title/fees — all covered. Legal language confirmed: not a financing offer, not a pre-approval, EVL not a lender/dealer/CRA. |
③ Retail Build Sequence — Current Status
| Step | Page | Status |
|---|
| 1 | login.html — Customer login + Firebase Auth + security rules | COMPLETE |
| 2 | home.html — Credibility front door | COMPLETE |
| 3 | my-deal.html — Post-login deal hub with trade fork | COMPLETE |
| 4 | schedule.html — Schedule a Call | COMPLETE |
| 5 | payment-estimator.html — Forward + backward calculator | COMPLETE |
| 6 | trade-in-exchange.html — Title Eligibility Gate | COMPLETE |
| 7 | credit-score.html — Credit hand-off page | COMPLETE |
| 8 | moment-of-truth.html — Deal reality check | COMPLETE |
| 9 | payment-collection.html — $199 platform fee activation | NEXT |
| 10 | Twilio SMS — confirm delivery to test number | OUTSTANDING |
| 11 | ws-dashboard.html — Firestore error resolution | OUTSTANDING |
| 12 | ID/BD dealer logins — held until real dealers onboard | QUEUED |
④ SessionStorage Keys — Retail Flow
| Key | Set By | Used By |
|---|
| evl_lien | trade-in-exchange gate | moment-of-truth |
| evl_physical_state | trade-in-exchange gate | moment-of-truth, EVL ops |
| evl_title_state | trade-in-exchange gate | moment-of-truth, EVL ops |
| evl_tier | trade-in-exchange gate | moment-of-truth |
| evl_credit_score | credit-score.html | payment-estimator, moment-of-truth |
| evl_credit_label | credit-score.html | payment-estimator, moment-of-truth |
| evl_credit_tier | payment-estimator | moment-of-truth |
| evl_vehicle_price | payment-estimator | moment-of-truth |
| evl_down_payment | payment-estimator | moment-of-truth |
| evl_trade_equity | trade-in-exchange | moment-of-truth |
| evl_term | payment-estimator | moment-of-truth |
| evl_custom_rate | payment-estimator | moment-of-truth |
| evl_mot_acknowledged | moment-of-truth | payment-collection |
📋 Build Log — Jun 12, 2026 Session
Full day session. Major infrastructure built across EVL WS platform, ESS, and the real-time auction engine.
① Pages Built Today
| Page | URL | What It Does | Status |
|---|
| BD Submit | /bd-submit | Dedicated BD flow — CarMax/Carvana/SMTV partner selection, fee breakdown, acknowledgment, success screen | LIVE |
| Private Sale Assist | /private-sale | 3-tier ($149/$299/$499) + EVL vs Alone comparison, net math, state warnings, eBay Motors as Tier 3 differentiator | LIVE |
| Dealer Onboarding | /dealer-onboard | 4-step dealer network signup — MarketCheck + Google Places + OSM dual-source auto-populate, full contact profile UCM1+UCM2, buying prefs, notification setup, Firebase save | LIVE |
| Live Bid Board | /live-bid-board | Dealer-facing anonymous auction board — EVL-WS-XXXXXX bid IDs only, real-time countdown, Firebase sync, bid validation, sort by amount DESC | LIVE |
| CRM Dashboard | /crm | Unified customer relationship management — 4 tabs (Incoming Leads, Active Deals, Appointments, Closed/Sold). Tracks all customer interactions with full audit trail. Real-time Firebase sync. Status progression: new → contacted → qualified → booked → sold. Includes appointment scheduling with SP confirmation and Internet Dept nudge system. |
| Lead Dashboard | /admin-leads | Real-time customer lead management. Shows all leads from evl_leads collection. Advisors (logged-in only) can view lead details, change status (new → contacted → qualified → booked). Firestore synced, timestamped audit trail. |
| Admin Bid Board | /admin-bid-board | Internal EVL operator view — dealer identities revealed behind bid IDs, winner box, nudge controls, transaction coordinator, dealer directory, new auction launcher | LIVE · PIN: 1027EVL |
| ESS Login (Front Door) | expresssalessystem.com/login.html | ESS marketing page — hero, features, tools, pricing ($299/$599/$999), dealer login gate via Firebase access codes, demo request modal | LIVE |
| ESS Admin Subscriptions | expresssalessystem.com/admin-sub.html | ESS subscription admin — active dealers, MRR calc, demo requests, add/edit/pause dealers, Firebase — PIN: 1027ESS | LIVE |
| ESS Demo Sandbox | expresssalessystem.com/demo.html | Interactive ESS sandbox — Prestige Ford McKinney pre-loaded, all 7 tools, real data, no login required | LIVE |
| ESS Walkthrough | expresssalessystem.com/walkthrough.html | Video walkthrough page — 7 chapters, key moments, shareable link, sandbox CTA, video placeholder ready for Loom recording | LIVE |
② WS Hub Expansions (ws-hub.html — now 9 tabs)
| Tab | What Was Added |
|---|
| 🏪 Dealer Network | Manufacturer-grouped dealer cards, contact profiles UCM1+UCM2, metro filter, status filter, outreach buttons, CSV export |
| 📊 Aged Unit Radar | ALL aged units (not just orphans), live MarketCheck pull, orphan detection, buyer match score algorithm, dealer pain calc (floor plan + depreciation), NHTSA recall check, staircase recommendation, CSV export |
| 📋 WS Deal Card | Unit approval gate — VIN decode, MarketCheck pricing, math gate (MC wholesale vs dealer minimum), APPROVE/REVIEW/PASS decision, staircase recommendation, matched buyers, dealer conversation script |
| 📺 Channel Launcher | 6-channel simultaneous deployment — eBay Motors, FB Marketplace, CarGurus, Craigslist, Cars.com, EVL WS Exchange. EVL algorithm timing per channel. Pricing auto-calc. Legal note embedded. |
③ Key Decisions Locked In Today
| Decision | Detail |
|---|
| Bid Anonymity | ALL bids identified by EVL-WS-XXXXXX dealer network ID only. Zero dealer names visible to other bidders. EVL internal only sees identity mapping. Winner identity revealed to source dealer ONLY after auction closes. |
| Channel Staircase | Hub Network first (free) → FB/CL → CarGurus/Cars.com → eBay Motors → WS Exchange fallback. Escalate only when necessary. Never pay for a channel before the free channels are exhausted. |
| Math Gate | MC wholesale = the floor. Dealer minimum must be at or below MC wholesale before EVL accepts any listing. Non-negotiable. Protects EVL close rate metrics which are the foundation of BD provider negotiations. |
| Dual Notification | Email (EmailJS) + SMS (Twilio) for all bid notifications. UCM #1 primary. UCM #2 backup after 2 hours no response. Both configured at onboarding. |
| All Aged Units | EVL targets ALL units 60+ days — orphan and native brand. Orphan flag just tells us who to call first. Native aged units routed to undersupplied same-brand dealers, competitors, or independents. |
| Auto-Population | Maximum auto-fill on every form. MarketCheck + OpenStreetMap + NHTSA + EVL logic. Receptionist call script auto-generated for missing UCM contact data. |
| No Dealer License | Confirmed via Liquid Motors precedent. Same DFW market, same model, 15+ years, zero dealer license. EVL is a technology platform. See Legal Framework section. |
④ Next Session Priorities
| Priority | Item | Status |
|---|
| #1 | EmailJS + Twilio notification engine — wire hourly nudge, unit card distribution, outbid alerts, winner notification | NEXT |
| #2 | Marketing outreach templates — 13 metro hub dealer acquisition campaign, call scripts, one-page EVL pitch deck | QUEUED |
| #3 | Firebase evl_units collection — full auction schema for live Deal Card → Bid Board pipeline | QUEUED |
| #4 | Twilio account setup + SMS template configuration | QUEUED |
| #5 | ESS video walkthrough recording — Loom screen record for walkthrough.html embed | QUEUED |
⑤ URLs Reference — All Live Pages
| Platform | URL | PIN/Access |
|---|
| EVL Consumer | www.expressvehiclelocators.com | Public |
| EVL WS Platform | expressvehiclelocators.com/ws-dashboard | 1027 |
| WS Hub (9 tabs) | expressvehiclelocators.com/ws-hub | 1027 |
| WS Vault | expressvehiclelocators.com/ws-vault | 1027 |
| Dealer Onboarding | expressvehiclelocators.com/dealer-onboard | Public (dealer fills out) |
| Live Bid Board (Dealer) | expressvehiclelocators.com/live-bid-board | EVL-WS-XXXXXX dealer ID |
| Admin Bid Board (EVL) | expressvehiclelocators.com/admin-bid-board | 1027EVL |
| BD Submit | expressvehiclelocators.com/bd-submit | Public |
| Private Sale Assist | expressvehiclelocators.com/private-sale | Public |
| ESS Platform | www.expresssalessystem.com | Dealer access code |
| ESS Front Door | expresssalessystem.com/login.html | Public |
| ESS Admin Subs | expresssalessystem.com/admin-sub.html | 1027ESS |
| ESS Sandbox Demo | expresssalessystem.com/demo.html | Public |
| ESS Walkthrough | expresssalessystem.com/walkthrough.html | Public |
| Firebase Project | evl-acquisition-radar (Blaze plan) | See credentials |
| GitHub Repo | github.com/timogrady01/evl-decode | See credentials |
| ESS GitHub Repo | github.com/timogrady01/express-sales-system | See credentials |
🔐 Master Credentials — All Keys, All Pages
Last updated: Jun 13, 2026 — Confidential. Internal use only. Never share publicly.
① API Keys & Credentials
| Service | Key / ID | Purpose | Date Added | Where to Find |
|---|
| GitHub Token |
ghp_****SEE GITHUB SETTINGS**** |
Allows Claude to read/write all files in the EVL GitHub repo directly. Used in every build session. |
Jun 2026 |
github.com → Settings → Developer Settings → Personal Access Tokens |
| MarketCheck API |
MC-****SEE MARKETCHECK DASHBOARD**** |
Vehicle inventory data, wholesale/retail pricing, days on lot, market comps. Used in Aged Unit Radar, WS Deal Card, Channel Launcher, Dealer Onboarding auto-populate. |
Jun 2026 |
marketcheck.com → Dashboard → API Keys. Current plan: DFW 100-mile radius. Upgrade for national. |
| Firebase — EVL |
FB-EVL-****SEE FIREBASE CONSOLE**** |
Real-time database for all EVL WS platform data — bids, auctions, dealer profiles, WS exchange submissions. Project: evl-acquisition-radar. Blaze plan. |
Jun 2026 |
console.firebase.google.com → evl-acquisition-radar → Project Settings |
| Firebase — ESS |
FB-ESS-****SEE FIREBASE CONSOLE**** |
Real-time database for ESS platform — Big Board, CVE submissions, SP scorecards, dealer subscriptions. Project: express-sales-system. |
Jun 2026 |
console.firebase.google.com → express-sales-system → Project Settings |
| Twilio Account SID |
TWILIO-SID-****SEE TWILIO CONSOLE**** |
SMS notification engine identifier. Required for all Twilio API calls. Combined with Auth Token to send bid alerts, nudges, winner notifications to dealer UCMs. |
Jun 13, 2026 |
console.twilio.com → Account Dashboard → Account Info |
| Twilio Auth Token |
TWILIO-TOKEN-****SEE TWILIO CONSOLE**** |
Private auth key for Twilio SMS API. NEVER store in code files — GitHub will reject. Enter via evl-notif-engine config page only. Stored in browser localStorage. |
Jun 13, 2026 |
console.twilio.com → Account Dashboard → Auth Token → Show |
| Twilio Phone Number |
+18444675644 · (844) 467-5644 |
Toll-free number SMS sends FROM. Verification submitted Jun 13 2026 — pending approval 1-3 business days. Until approved: SMS restricted to verified numbers only. |
Jun 13, 2026 |
console.twilio.com → Phone Numbers → Active Numbers |
| EmailJS Service ID |
service_rvscjt3 |
EmailJS service connected to togradyevl@gmail.com. Sends all bid notification emails — unit cards, nudges, outbid alerts, final calls, winner notifications. |
Jun 2026 |
dashboard.emailjs.com → Email Services |
| EmailJS Public Key |
⚠️ NOT YET ENTERED — NEEDED |
Required to initialize EmailJS SDK. Without this, no emails fire. Get from dashboard.emailjs.com → Account → Public Key. Enter in evl-notif-engine config page. |
Pending |
dashboard.emailjs.com → Account (left nav) → Public Key field |
| Cloudinary |
Cloud: dv8cpebgp · Preset: evl_photos |
Photo uploads for trade-in flow. Customer vehicle photos stored and served via Cloudinary CDN. |
Jun 2026 |
console.cloudinary.com |
② All PINs & Access Codes
| Page / System | PIN / Code | Who Uses It |
|---|
| All WS Platform pages | 1027 | EVL operators — WS Dashboard, Vault, Hub, Exchange, Intelligence |
| Admin Bid Board | 1027EVL | EVL internal only — reveals dealer identities behind anonymous bid IDs |
| ESS Admin Subscriptions | 1027ESS | EVL internal only — manage ESS dealer accounts, MRR, demo requests |
| Live Bid Board (dealers) | EVL-WS-XXXXXX | Each dealer gets their own unique network ID at onboarding |
③ Complete Page Directory — Every Page Explained
Every page on the EVL platform — what it is, who uses it, when it was built, and why it exists.
| URL | Page Name | Who Uses It | What It Does | Built |
|---|
| EVL CONSUMER SIDE — expressvehiclelocators.com |
| /home | Home Page | Public | EVL main landing page — hero, category cards (Trucks/SUVs/Luxury/Electric), search bar, nav | Jun 2026 |
| /find | Find My Car | Customers | Customer vehicle search and advisory tool | Jun 2026 |
| /trade-in | Trade-In Gate | Customers | Pre-qualification gate — lien check, state tier (R/Y/G), routes to Exchange | Jun 2026 |
| /trade-in-exchange | Trade-In Exchange | Customers | Live bid display, equity options (keep/split/all-in), LTV calc, BCS 4-option comparison calculator, EVL Finance Advantage bubble | Jun 2026 |
| /bd-submit | BD Submit | Customers | Dedicated BD flow — customer selects CarMax/Carvana/SMTV partners, fee breakdown, acknowledgment, confirmation. Built Jun 11 2026. | Jun 11, 2026 |
| /private-sale | Private Sale Assist | Customers | 3-tier selling service ($149/$299/$499). EVL vs Alone comparison, net math calculator, state R/Y/G warnings, eBay Motors as Tier 3 national channel. Built Jun 11 2026. | Jun 11, 2026 |
| /compare | Research / Compare | Customers | AI-powered vehicle comparison tool using Claude API | Jun 2026 |
| /leasing | Leasing | Customers | Leasing advisory page | Jun 2026 |
| /contact | Contact | Customers | Contact form | Jun 2026 |
| /financing | Financing | Customers | EVL Finance Advantage — eliminates 2-point dealer markup | Jun 2026 |
| EVL WHOLESALE SIDE — expressvehiclelocators.com/ws-* |
| /ws-dashboard | WS Dashboard | EVL operators · PIN: 1027 | Main WS control panel — deal flow overview, active units, stats | Jun 2026 |
| /ws-exchange | WS Exchange | EVL operators · PIN: 1027 | Live wholesale auction — dealer bids, deal math, tax credit calculator, Firebase real-time | Jun 2026 |
| /ws-hub | WS Hub (9 tabs) | EVL operators · PIN: 1027 | Hub Map · Deal Pipeline · Bid System · Porter · Dealer Network · Aged Unit Radar · WS Deal Card · Channel Launcher · Pricing Calc. Built incrementally Jun 11-12 2026. | Jun 11-12, 2026 |
| /ws-vault | WS Vault | EVL operators · PIN: 1027 | THIS PAGE — master documentation, all credentials, P&P, build log, revenue model, legal framework, Smart Path roadmap | Jun 2026 |
| /ws-dealers | WS Dealers | EVL operators · PIN: 1027 | Dealer management — WS network dealer directory | Jun 2026 |
| /ws-intelligence | WS Intelligence | EVL operators · PIN: 1027 | Market intelligence dashboard | Jun 2026 |
| /ws-login | WS Login | EVL operators | WS platform login gate | Jun 2026 |
| EVL AUCTION SYSTEM — Built Jun 12, 2026 |
| /dealer-onboard | Dealer Onboarding | WS dealers (public) | 4-step dealer network signup. MarketCheck + OpenStreetMap auto-populate address/phone/brand. Full contact profile — Receptionist, UCD, UCM #1, UCM #2 (name/office/ext/cell/email). Buying preferences, notification setup. Saves to Firebase evl_ws_dealers. Built Jun 12 2026. | Jun 12, 2026 |
| /live-bid-board | Live Bid Board | WS dealers (their network ID) | Anonymous real-time auction board for dealers. Enter EVL-WS-XXXXXX dealer ID to access. See active auctions, current high bids, time remaining. Place bids — sorted by amount DESC, highest wins. Bid IDs only — zero dealer names visible to other bidders. Firebase live sync. Built Jun 12 2026. | Jun 12, 2026 |
| /admin-bid-board | Admin Bid Board | EVL internal only · PIN: 1027EVL | Internal operator view — REVEALS real dealer identities behind every bid ID. Winner box shows dealer name, UCM name, cell, email. Nudge controls, transaction coordinator (5-step checklist), dealer directory, new auction launcher. Built Jun 12 2026. | Jun 12, 2026 |
| /evl-notif-engine | Notification Engine | EVL internal only | EmailJS + Twilio configuration and test page. Enter API keys once — saves to browser localStorage. 5 email templates documented (unit card, hourly nudge, outbid, final call, winner). 5 SMS templates. Test buttons for every notification type. Credentials NEVER stored in code — localStorage only. Built Jun 12 2026. | Jun 12, 2026 |
| EVL MARKETING — Built Jun 12, 2026 |
| /dealer-outreach-hub | Dealer Outreach Hub | EVL internal only | Complete marketing campaign toolkit. 6 tabs: Personalized Outreach Generator (enter dealer data → get custom call script + email), Call Scripts (cold/warm/followup/voicemail), Email Templates (4 templates), Pitch Deck (5 slides), Campaign Tracker (stage tracking per dealer, localStorage), Objection Handlers (8 objections + exact responses). Built Jun 12 2026. | Jun 12, 2026 |
| ESS PLATFORM — expresssalessystem.com |
| /login.html | ESS Front Door | Prospective dealer clients (public) | ESS marketing landing page — hero, 6 feature cards, 8 tool descriptions, 3-tier pricing ($299/$599/$999), dealer login gate (checks Firebase for access code), 3-step demo request modal with 5 W qualification. Built Jun 12 2026. | Jun 12, 2026 |
| /admin-sub.html | ESS Subscription Admin | EVL internal · PIN: 1027ESS | Manage all ESS dealer subscriptions. Active dealers tab (add/edit/pause), MRR auto-calculated, demo requests tab (convert to dealer), inactive tab. Firebase connected. Built Jun 12 2026. | Jun 12, 2026 |
| /demo.html | ESS Live Sandbox | Prospective clients (public) | Full interactive ESS demo pre-loaded with Prestige Ford McKinney. All 7 tools — Big Board, FM Floor, Greeter, CVE, PP Scripts, EOD, UCM Dashboard. Real data, no login. Demo banner at bottom. Built Jun 12 2026. | Jun 12, 2026 |
| /walkthrough.html | ESS Video Walkthrough | Prospective clients (public) | 7-chapter video walkthrough page. Key moments highlighted. Shareable link. Video placeholder — ready for Loom recording embed. Links to sandbox. Built Jun 12 2026. | Jun 12, 2026 |
| /big-board.html | Big Board | Dealership SPs + managers | Live store scoreboard — MTD units, projected EOM, avg FE gross, SP performance table, walk reasons, benchmark calculator. Firebase connected. Pat Lobb Toyota McKinney deployment (dealer name is dynamic). | Pre-Jun 2026 |
| /cve.html | CVE | Dealership SPs | 5-step customer vehicle evaluation — VIN lookup, customer Q&A, 13-point walk-around, PP hooks with scripts, commitment close. Submits to Firebase. On-site and site-unseen modes. | Pre-Jun 2026 |
| /ucm-dashboard.html | UCM Dashboard | Used Car Managers · PIN protected | Manager view of all CVE submissions live. PP temperature counts (YES/SOMEWHAT/HESITANT). Real-time Firebase refresh. | Pre-Jun 2026 |
④ Notification Engine Status — Jun 13, 2026
| Component | Status | What Is Needed |
|---|
| Twilio Account | ✅ ACTIVE | Account: AC6a3a61... · Auth Token saved in localStorage via /evl-notif-engine |
| Twilio Phone Number | ⏳ PENDING | +18444675644 · Toll-free verification submitted Jun 13 · Approves in 1-3 business days |
| EmailJS Service | ✅ ACTIVE | service_rvscjt3 connected to togradyevl@gmail.com |
| EmailJS Public Key | ❌ NEEDED | Get from dashboard.emailjs.com → Account → Public Key. Enter in /evl-notif-engine config page. |
| EmailJS Templates | ✅ ALL 6 LIVE | 6 templates active in EmailJS dashboard — confirmed Jun 23 2026. 4,985 requests remaining. Personal Plan ($15/mo) · 5,000 emails/month. |
| Unit Card Email | ✅ LIVE | template_5xxsm0m — Fires when auction launches — all matched buyers notified simultaneously |
| Hourly Nudge Email | ✅ LIVE | template_h8ka8lx — Fires every hour — current high bid, time remaining, personalized status |
| Outbid Alert | ✅ LIVE | template_bjy763u — Fires instantly when a dealer is outbid |
| Final Call | ✅ LIVE | template_8k0u7bw — Fires 1 hour before auction close |
| Winner Notification | ✅ LIVE | template_4w8mvtm — Fires at auction close to winning dealer |
| Unit Sold Notice | ✅ LIVE | template_ze974sd — Fires to ID's porter/UC rep, title clerk, and business office at auction close |
| SMS Layer | ⏳ PENDING TWILIO APPROVAL | All 5 SMS versions ready. Fires when Twilio toll-free verification approves. |
TO ACTIVATE FULL NOTIFICATION ENGINE — TWO STEPS
Step 1
Go to dashboard.emailjs.com → Account → copy Public Key → go to /evl-notif-engine → paste in Public Key field → click Save Config
Step 2
In EmailJS → Email Templates → create 5 templates using the text on /evl-notif-engine → paste each Template ID into the config page → Save Config
Step 3
On /evl-notif-engine → enter test email → click each test button → confirm emails arrive → Email layer is LIVE
Step 4
Wait 1-3 days for Twilio toll-free verification → SMS layer activates automatically
🤝 WS Dealer-to-Dealer Settlement P&P — No Escrow (Locked Jun 14, 2026)
Replaces the old $150 escrow / $75-$75 split model for WS auction winners. "Express" = speed. Direct dealer-to-dealer settlement, standard wholesale paperwork, no third-party holding funds or title. EVL's platform fee is invoiced separately (same pattern as the $199 BD Submit fee) — never part of the vehicle transaction.
TERMINOLOGY NOTE
On the WS Exchange side: ID = the dealer who currently holds the unit being auctioned (source/seller — same role as {{source_dealer}} in templates). BD = Bidding Dealer, the winning buyer. Note: this differs from the retail-side definition of ID (Issuing Dealer = delivers a replacement vehicle to the customer) — same letters, different context, kept separate intentionally.
THE 9-STAGE FLOW
| Stage | What Happens | Who's Involved |
|---|
| 1. Listing | ID lists unit on WS Exchange, checks box agreeing to EVL Minimum Condition Standard as a condition of listing. | ID |
| 2. Sold Notice | Auction closes → "EVL-UNIT-SOLD" notice fires to 3 people at the ID: porter/UC rep (prep checklist + pickup window), title clerk (heads-up: scan-and-send same-day), business office (heads-up: incoming wire/check). | ID (3 roles) |
| 3. Pickup Window | BD notified via EVL-WINNER email. BD and ID agree on pickup time — target 6 business hours, cap 12 business hours. | BD + ID |
| 4. Prep | ID's porter/UC rep brings vehicle to Minimum Condition Standard: washed, vacuumed, 1/4 tank fuel, lens/windshield/dash-light check. | ID porter/UC rep |
| 4.5 Proactive Disclosure | If prep inspection finds an undisclosed issue (e.g. windshield chip), ID flags it to EVL/BD before pickup with a proposed resolution from the standardized credit table. BD acknowledges — resolved before anyone's on the lot. | ID → EVL → BD |
| 5. Pickup / BOL | BD's porter arrives at agreed time. 8-exterior + 8-interior photo walkaround + 70mph test drive (steering shimmy, noises, brake pull). Both reps digitally sign BOL. Vehicle is now BD's. | BD porter + ID porter/rep |
| 6. Digital Paperwork | ID's title clerk scans signed Title w/ Dealer Reassignment + Odometer Disclosure Statement + Bill of Sale → emails to BD's business office same-day. | ID title clerk |
| 7. Funds Release | BD's business office wires or company-checks payment to ID based on the digital packet — same day, no waiting on mail. Wire instructions verified against EVL platform record (fraud control — see below). | BD business office |
| 8. Physical Originals | ID mails physical Title/ODS/Bill of Sale to BD — non-blocking, for the file. If not received within a set window, EVL facilitates a duplicate. | ID title clerk |
MINIMUM CONDITION STANDARD (ONE RULE SET, NATIONWIDE)
Windshield: any crack/chip inside the wiper-swept area = flagged. Outside that area, chips under ~1" = acceptable.
Lenses (head/tail/brake/turn): must be uncracked and intact. Light color must match position (red rear/brake, amber turn, white front) — clear housings with correctly-colored LEDs are fine.
Dash: photo with engine running; any illuminated warning light flagged/disclosed on BOL, doesn't auto-fail.
Conservative enough to pass inspection in the strictest state in the network — removes "well my state allows it" disputes entirely.
⚠️ WIRE FRAUD MITIGATION — BUILD FROM DAY ONE
BD and ID often meet for the first time via EVL — classic Business Email Compromise target (fraudulent wire instructions sent via intercepted email). Mitigation: EVL displays each dealer's verified banking/wire info directly on the platform (captured at onboarding), so BD's business office confirms wire details against EVL's record — never solely from an emailed packet.
OPEN BUILD ITEMS (NOT YET BUILT)
1. Minimum Condition Standard acknowledgment checkbox on ws-exchange.html listing flow
2. New EmailJS template "EVL-UNIT-SOLD" — fires to ID's porter/UC rep, title clerk, and business office at auction close
3. Standardized minor-defect credit table (for Stage 4.5 Proactive Disclosure)
4. Remove $75/$75 escrow references from trade-in-exchange.html BCS calculator and the Legal Framework table (Escrow Company row) — no longer applicable
5. EVL-WINNER template updated Jun 14 (template_4w8mvtm) — wire-first sequence, dealer-to-dealer settlement, no escrow language — LIVE
📧 EmailJS Templates — All 5 Bid Notification Templates
Last updated: Jun 13, 2026 · ALL 5 TEMPLATES LIVE & TEST-CONFIRMED ✅ · Service ID: service_xua01ed · Gmail: togradyevl@gmail.com · Personal Plan ($15/mo) · 5,000 emails/month
All templates created at dashboard.emailjs.com/admin/templates/[TEMPLATE_ID]. To edit any template go directly to that URL. Template IDs are used by the EVL Notification Engine at /evl-notif-engine — enter them in the config page.
| Template Name |
Template ID |
Direct URL |
Subject Line |
When It Fires |
Date Created |
| EVL-UNIT-CARD |
template_5xxsm0m |
dashboard.emailjs.com/admin/templates/5xxsm0m
|
⚡ EVL OPPORTUNITY — {{vehicle}} — Auction Open |
When auction launches — fires to ALL matched buyers simultaneously |
Jun 13, 2026 |
| EVL-HOURLY-NUDGE |
template_h8ka8lx |
dashboard.emailjs.com/admin/templates/h8ka8lx
|
📡 {{vehicle}} — High Bid: {{high_bid}} — {{time_remaining}} Left |
Every hour during active auction — personalized per bidder status |
Jun 13, 2026 |
| EVL-OUTBID |
template_bjy763u |
dashboard.emailjs.com/admin/templates/bjy763u
|
⚠️ You've Been Outbid — {{vehicle}} — Counter Now |
Instantly when a dealer is outbid — fires to outbid dealer only |
Jun 13, 2026 |
| EVL-FINAL-CALL |
template_8k0u7bw |
dashboard.emailjs.com/admin/templates/8k0u7bw
|
🚨 FINAL HOUR — {{vehicle}} — Closes in 60 Minutes |
1 hour before auction close — fires to all active bidders |
Jun 13, 2026 |
| EVL-WINNER |
template_4w8mvtm |
dashboard.emailjs.com/admin/templates/4w8mvtm
|
✅ CONGRATULATIONS — You Won {{vehicle}} |
At auction close — fires to winning dealer only with next steps |
Jun 13, 2026 |
| EVL-UNIT-SOLD |
template_ze974sd |
Edit in EmailJS ↗
|
✅ UNIT SOLD — {{vehicle}} — Action Needed |
At auction close — fires to ID's UCM, contains 3 sections: Porter/UC prep checklist, Title Clerk scan-and-send, Business Office payment heads-up. Code wired Jun 14 — template HTML pending creation in EmailJS. |
Jun 14, 2026 |
EMAIL TEMPLATE VARIABLES REFERENCE
{{to_email}} — recipient email address
{{to_name}} — UCM first name
{{vehicle}} — Year Make Model Trim
{{vin}} — 17-digit VIN
{{miles}} — mileage
{{condition}} — Excellent/Good/Fair
{{source_dealer}} — selling dealer name
{{days}} — days on lot
{{retail_value}} — MC retail predicted
{{ws_floor}} — MC wholesale value
{{recalls}} — NHTSA recall count
{{auction_id}} — AUC-2026-XXX
{{make}} — vehicle make
{{deadline}} — auction close time
{{bid_url}} — live bid board URL
{{high_bid}} — current high bid $
{{my_status}} — winning/outbid status
{{active_bidders}} — number of bidders
{{time_remaining}} — e.g. 3h 22m
{{nudge_message}} — personalized action message
{{your_bid}} — dealer's last bid amount
{{difference}} — gap between bids
{{winning_bid}} — final winning amount
{{evl_fee}} — $250 broker fee
{{ucm_name}} — winner UCM name
{{ucm_cell}} — winner UCM cell
{{ref_number}} — EVL-WIN-XXXXXX
✅ EMAIL ENGINE STATUS — FULLY LIVE & TESTED (Jun 13, 2026)
All 5 templates wired, configured, and test-sent successfully to togradyevl@gmail.com.
Each arrived correctly formatted with EVL branding and all variables populated.
| EmailJS Public Key | iilAte2T5SzOKb-fn |
| EmailJS Service ID | service_xua01ed |
| Account Security — Use Private Key | UNCHECKED (must stay off — site sends Public Key only) |
| Account Security — Allowed Domains | Empty / unrestricted |
⚠️ TROUBLESHOOTING NOTE: If emails start failing again with "Public Key is invalid," check
EmailJS → Account → Security tab. If "Use Private Key (recommended)" got re-checked
(e.g. after a plan change), uncheck it and Save. Also re-verify the Public Key on
Account → General matches the value above — EmailJS may regenerate keys via "Refresh Keys."