Best Deal On platform handbook (technical)
Written Nov 3, 2026 from the code (living document, updated as the platform changes): bestdealon-v2 master @ 678aabf and rfsafe-phone-agent bestdealon @ ee5b1f2. Only features that exist in that code are described. Anything planned is marked (planned); anything a person does by hand is marked (manual).
Public contact: (727) 632-0002 (phone bot) · support@bestdealon.app
| Page | What it covers |
|---|---|
| architecture.md | System diagram and call-flow diagram (Mermaid) |
| components.md | Every component: what it does, where it lives |
| feature-inventory.md | Master checklist: every feature, how to check it, and its status |
| feature-flags.md | Every flag, its default and its current live state |
| onboarding-workflow.md | Step-by-step business onboarding, manual and planned steps marked |
| caller-recognition.md | Caller lookup + recognition and the spoofing rules |
| settings.md | Every option and setting with defaults, current state and examples |
| services.md | Third-party services with official links |
| callbots/ | Phone side (Callbots draft, verified and corrected by Coder): how it works, settings, KB, texting, verify by call, phone-side agents |
| changelog.md | Every deploy so far, newest first (easy to append) |
| agents/ | One AGENT.md per teammate: Coder, Jarvis, Callbots, Bizinator, Publish Bot, Research Bot, Text & Voicemail front desk |
Ground rules (apply to every page and every agent)
- Nothing goes live without John's explicit approval (deploys, env changes, data fixes, emails to customers, calls, texts).
- No secrets anywhere: no keys, tokens or passwords in docs, logs, chats or commits. Check secrets by name or length only.
- Best Deal On is separate from RF Safe. Own tenant, own number, own secrets. Never touch RF Safe's number, service or the
mainbranch. - Caller ID is never verification. It can be spoofed. It may personalise a greeting; it never unlocks data or changes.