# TitaniumChat — Master README (v6_11i)

## Overview
TitaniumChat (TIA) is a custom AI-powered website chat widget built for Titanium Auto London, ON.  
It integrates inventory search, financing calculators, warranty details, Carfax handling, and lead capture — styled to match the Titanium Auto brand.

## Frontend Features (widget.js)
- One-time consent card, desktop auto-open, mobile bubble only
- Session persistence across pages
- Unread badge with pulse animation
- Typing indicator under header
- Modern theme (gradient header, rounded corners, Poppins font)
- Responsive design

## Backend Features (webhook.php)
- Guardrails (only Titanium Auto topics)
- Inventory search with clickable buttons
- Stock number flows with Carfax integration
- Financing calculator (price or monthly budget, HST incl.)
- Warranty comparison card (Titanium, Platinum, Gold, Complimentary)
- Lead capture with consent, sent to leads@titaniumauto.ca
- Relevance guard for off-topic queries

## Files
- widget.js — frontend
- server/webhook.php — backend logic
- server/config.json — settings
- server/sessions/ — session state (safe to clear)
- server/leads.json — captured leads
- README.txt — release notes
- MASTER-README.txt — full documentation

## Deployment
1. Upload widget.js, server/webhook.php, server/config.json to hosting.
2. Add to every page:
   <script src="https://chat.titaniumauto.ca/widget.js" defer></script>
3. Clear WordPress/CDN cache.

## Smoke Tests
- First visit → consent + greeting
- Ask for brand → clickable button or no-stock message
- Ask for stock# history → Carfax or lead capture
- Financing query → payment options
- Close panel → unread badge on bot reply
- Send message → typing indicator shows until reply

## Roadmap
- Offline lead capture if webhook unreachable
- Analytics dashboard
- CRM integration