๐Ÿ“– Sprint Storyboard

15-frame click-through โ€” WhatsApp intake โ†’ AI proposal โ†’ broker review โ†’ seller sign

1
Broker
๐Ÿ“ฑ Opens WhatsApp
Broker sends a message to "Auction Central AI" on WhatsApp Business. The conversation looks like a normal WhatsApp chat. The broker types the property address, or sends a Property24 link. The AI responds: "Got it! 21 West Road, Morningside. I'll pull the data. In the meantime, what's the seller's name?"
โœ… Screen exists: whatsapp-intake.html
2
Broker
๐Ÿ“ Provides Remaining Details
AI asks 3โ€“4 structured questions: seller name, reason for selling, preferred auction date, any special features. The broker responds naturally. AI confirms: "All set. Generating your proposal now โ€” ready in ~3 minutes. I'll send you a link."
โœ… Screen exists: whatsapp-intake.html (continued)
3
System โ€” AI Engine
โš™๏ธ AI Generates Proposal (Behind the Scenes)
While the broker waits, the AI engine: (1) Pulls Lightstone data โ€” comps, transfers, municipal valuation, (2) Scrapes P24 listing โ€” photos, features, description, (3) Generates AI property description matching AC brand voice, (4) Calculates reserve recommendation from 5 closest comparable sales + suburb trend.

The broker sees a progress indicator: "Pulling property data... Analysing comparable sales... Writing description... Almost done."
โœ… Screen exists: whatsapp-intake.html (progress state)
4
Broker
๐Ÿ”” Receives Notification
WhatsApp message arrives: "Your proposal for 21 West Road, Morningside is ready! Review it here โ†’ [link]. Suggested reserve: R2.75M based on 5 comparable sales."

The broker taps the link โ†’ opens the proposal review dashboard in their browser.
โœ… Screen exists: whatsapp-intake.html (notification)
5
Broker
๐Ÿ“Š Opens Proposal Review Dashboard
The broker lands on the proposal preview screen โ€” the core sprint test moment. They see the complete AI-generated proposal with sections: property overview, comparable sales, suburb trends, AI valuation, cover letter. Each section has an "Edit" button.
โœ… Screen exists: proposal-preview.html
๐Ÿงช Sprint Question #3: Does the output quality match or exceed the current Word template?
6
Broker
๐Ÿ“„ Reviews Property Description
AI-written property description matching AC's brand voice. The broker reads through and checks: Does this sound like something AC would write? Are the facts correct? Would I be comfortable presenting this to a seller?
โœ… Screen exists: property-overview.html
๐Ÿงช Friday observation: Does the broker try to edit the description? What do they change?
7
Broker
๐Ÿ“‹ Reviews Comparable Sales
Interactive table of 5 closest comparable sales โ€” sorted by distance from subject property. Shows: address, sale price, date, size, distance. Each comp has a map pin. The broker checks: Are these actually comparable? Would I have picked these same comps manually?
โœ… Screen exists: cma.html
8
Broker
๐Ÿ“ˆ Reviews Suburb Trends
Median price graph with 12-month trend line and direction indicator. Shows: YoY price change, number of transactions, average days on market. Contextualises the valuation within market momentum.
โœ… Screen exists: suburb-trends.html
9
Broker
๐ŸŽฏ THE TRUST MOMENT โ€” Reviews AI Valuation
This is the single most important frame in the entire storyboard.

The broker sees the AI-suggested reserve: "R2.75M โ€” Based on 5 most similar properties (avg R2.8M, median R2.65M, 6% YoY increase in Morningside). Municipal valuation: R2.4M. Confidence: High (4 of 5 comps within 15% of subject)."

The reasoning chain is fully visible. The broker can see exactly why the AI chose this number. They can agree, override, or ask for more detail.
โœ… Screen exists: valuation.html โœ… Variant A: conversational โœ… Variant B: confidence dashboard
๐Ÿงช CORE SPRINT QUESTION #1: Will the broker trust this AI valuation enough to present it to a seller? Do they override? How far?
10
Broker
โœ๏ธ Overrides Valuation (Optional)
The broker adjusts the reserve from R2.75M to R2.9M and adds a note: "Strong street demand, recent neighbour sale at R3.1M not yet in system." The AI acknowledges the override but the system records both values โ€” building the accuracy feedback loop.
โœ… Override UI in variant-b-confidence.html
๐Ÿงช Friday observation: Expected behaviour โ€” brokers will override. Track HOW MUCH they override (5%? 20%? 50%?)
11
Broker
๐Ÿ’Œ Reviews Cover Letter
AI-generated personalised cover letter addressed to the seller. Uses property-specific details and AC's brand voice. The broker reviews and can edit before finalising.
โœ… Screen exists: cover.html
12
Broker
๐Ÿ“‘ Generates Branded PDF
Broker clicks "Generate PDF". The system renders a complete, pixel-matched branded proposal PDF using the Handlebars template and proposal CSS. Output: a 7-section PDF identical in quality and branding to AC's current hand-crafted Word template โ€” but generated in seconds.
โœ… PDF exists: Auction-Central-Proposal.pdf โœ… Print template: proposal-print.html
13
Broker
๐Ÿ”— Shares with Seller
Broker clicks "Share with Seller" โ†’ gets a unique tracked link. Can share via WhatsApp, email, or SMS. The link opens an interactive web version of the proposal (Qwilr-style) where the seller can explore maps, charts, and comps. Every view is tracked.
โœ… Screen exists: share-dialog.html
14
Broker
๐Ÿ“Š Views Engagement Analytics
Broker checks the analytics: "Seller opened proposal 3 times. Spent 4 min on comparable sales, 2 min on valuation, 45 sec on cover letter. Last viewed: 2 hours ago." This gives the broker intelligence about what the seller cares about before the meeting.
โœ… Screen exists: analytics.html
15
Seller
โœ๏ธ Signs Mandate Inline
The seller, after reviewing the interactive web proposal, clicks "Accept & Sign Mandate" at the bottom of the proposal. A digital signature flow captures their agreement to the 10-clause, 60-day auction mandate. No separate document. No printer. No in-person meeting required.

The deal is closed without leaving the proposal.
โœ… Mandate terms: mandate-terms.html โœ… Screen exists: e-sign-overlay.html

Storyboard Coverage

15
All frames implemented
0
Gaps remaining
1
Core trust moment (Frame 9)

โœ… All Gaps Filled โ€” Thursday Complete