RECEIPTS — Complete Blueprint

Click Copy All, then paste into your super-agent chat.

# RECEIPTS — COMPLETE APPLICATION BLUEPRINT
# For super-agent ingestion. This is the full system blueprint.

================================================================
1. IDENTITY & MISSION
================================================================
PRODUCT: RECEIPTS
CREATOR: 3 Solutions Inc.
TAGLINE: "Your claim. His Word. The receipt."
CORE PREMISE: "Show me where God said that."

RECEIPTS is a biblically-grounded, AI-guided truth-verification ecosystem. It takes any claim, teaching, sermon, headline, or cultural assertion and produces a "receipt" — a structured, source-cited, theologically rigorous verdict on whether it aligns with Scripture and the historic Christian faith. Around that single engine it has grown into a full discipleship ecosystem: a Bible reader, a theological study library, AI devotionals with a podcast, prayer circles, a 24/7 radio station, and a live "Man Says / God Says" news feed — all guided by an AI companion named "Peace the Living Word."

MISSION: Give every believer the power to verify what they're taught, hold teachers accountable to Scripture, and grow in a connected community — while centering the African and African-Diaspora Christian tradition that gave Christianity to the world.

================================================================
2. THE CORE ENGINE — "MAN SAYS / GOD SAYS"
================================================================
The truth-verification engine is the heart of the platform. One claim in → one structured receipt out.

FIVE FIXED VERDICTS (no vibes, no opinions):
- Receipt Confirmed — aligns with Scripture
- Partial Receipt — partly true, partly missing/added
- No Receipt Found — contradicts Scripture
- Needs Context — true but incomplete/misapplied
- Denomination-Dependent — Scripture supports it but application varies by tradition (honest naming of disagreement)

EVERY RECEIPT INCLUDES:
- Verdict + verdict summary + title summary
- Biblical accuracy score (0–100) + confidence level (High/Medium/Low)
- Receipt Score (composite)
- Claims analyzed (the claim in circulation)
- What's right / What's wrong / Why 50-50
- Key scriptures (LIVE-VERIFIED against KJV, not LLM memory)
- Biblical support, historical context, original-language insight
- Heresy alert (named historically), early church says, spread analysis, historical origin
- Context Receipt (author/audience/time/covenant/genre/summary)
- Theology Receipt (side-by-side tradition A/B/C views + summary)
- Source trail (mini bibliography: Bible translation/lexicon/commentary/church history/archaeology/academic)
- Source timeline + source breakdown table
- Evidence meter (for/against/contested %)
- Web sources consulted (live web search)
- Pastoral escalation flag + reason (routes real-wound topics to real pastors)
- Peace's conclusion (narrative, voiced)
- OG preview image for sharing
- Public shareable receipt page (/receipt/:id)

TWO DEPTHS:
- Quick Answer (fast, analogy + standing-proof scripture) → quickTruthAnalyze
- Full Diagnosis (scholarly, multi-layer) → truthAnalyze

ENGINE PRINCIPLES:
- Live scripture verification, never LLM memory
- Steel-man the opposing view; engage counter-texts
- Intellectual humility as a feature (names genuine uncertainty)
- Tradition-aware (Denomination-Dependent + Theology Receipt)
- African / African-Diaspora center of gravity (not bolted on)
- Pastoral escalation for topics needing real care

================================================================
3. PEACE THE LIVING WORD — THE AI GUIDE
================================================================
Peace is the persona that wraps the engine and the whole ecosystem.
- Voice via ElevenLabs (warm, clear, trustworthy) — peaceSpeak / generatePeaceVoice
- Memory: cumulative user profile (theological background, mastered topics, ongoing inquiries)
- Thread-weaving: builds on prior conversations, never repeats foundations
- Self-introduction protocol; color-coded text for divine speech vs apocryphal sources
- Scholarly framework: biblical, historical, lexical, denominational analysis
- Centers African and Black-church tradition (Augustine, Athanasius, Origen, Tertullian, Desert Fathers, Ethiopian eunuch, Black church)
- Has an in-app conversation UI (/peace) + agent config (peace_the_living_word.jsonc)
- Reads/writes Devotional + TruthCheck entities; calls theoSearch function

================================================================
4. FEATURE SURFACES (one engine, many surfaces)
================================================================
A. TRUTH CHECKER (/) — paste a quote/claim, pull a receipt. Quick or Full depth.
B. SERMON SCANNER (/sermon-scanner) — drop a sermon (text/audio/video), get a claim-by-claim report with verdicts, risk flags, biblical corrections, scriptures-used analysis, what-got-right, what-needs-correction, Peace's final conclusion. Depths: Quick/Standard/Deep. Saved as SermonScan.
C. BIBLE READER (/bible) — full Bible with:
   - Word lookup: tap any word → pronunciation (IPA), English meaning, Hebrew/Greek root, Strong's number, "Hear It" TTS
   - Recall: highlights, notes, study layers, cross-references
   - Immersion audio (bibleImmersionAudio)
   - Proper-noun factbook, drawing canvas, search, chapter/book selectors
D. THEOSEARCH (/theo-search) — study library spanning: church fathers, heresies, doctrine, misquotes, frameworks, reformation, black church, african christianity, intertestamental, jewish roots, psalms & paul, global christianity, deuterocanon, ethiopian unique books, eastern orthodox, church fathers missing. Peace weaves a synthesis (peaceSynthesis).
E. DEVOTIONALS + PODCAST (/today, /devotional/:id, /library) — AI-generated devotions; read or listen; podcast player; daily email (sendDailyDevotionalEmail). Generated via podcastGenerator + podcastOrchestrator.
F. PRAYER CIRCLES (/prayer-circles) — community: circles (private/pool/church/public/invite-only/anonymous/emergency), members, posts (text/video/voice/testimony/update/funding), interactions (prayed/scripture/comment/follow/report), updates, chat, reactions, testimonies, invites, moderation reports, funding.
G. RECEIPTS RADIO (/receipts-radio) — 24/7 station: station blocks, hosts, tracks, bumpers, favorites, equalizer/visualizer, admin CMS. Voice hosts (Amanda, Asher, Flaco, Sweets) have agent functions.
H. LIVE RECEIPT FEED — daily "Man Says / God Says" news (dailyLivingReceiptFeed), drawn as a drawer on Truth Checker; categories: World News, Christian Community, Gospel Music, Pastors & Churches, Culture, Biblical Response.
I. TRENDING (/trending) — trending claims, verdict filters.
J. LISTENER PIPELINE (/listener-pipeline) — listener questions → podcast episodes.
K. ADMIN (/admin) — users, subscriptions, payments (Stripe), podcast analytics, feature-visibility toggles, white-label usage.
L. WHITE-LABEL — branded truth-checking tool for ministries/orgs (WhiteLabel entity, trackWhiteLabelUsage, whiteLabelMonthlyBilling).
M. AFFILIATE (/affiliate) — ?ref= capture, referral economy.
N. ONBOARDING + TOUR (/tour) — onboarding flow, tour overlay.
O. PRICING (/pricing), APP BRIEF (/app-brief), LIBRARY INDEX (/library-index), BOOKMARKS (/bookmarks), TRUTH HISTORY (/truth-history).

================================================================
5. TECH STACK
================================================================
- Frontend: React + Vite + Tailwind CSS + shadcn/ui + lucide-react
- Animation: framer-motion; Charts: recharts; Maps: react-leaflet; 3D: three.js; DnD: @hello-pangea/dnd; Quill; react-hook-form; date-fns; lodash; react-markdown; @tanstack/react-query
- Backend: Base44 BaaS (auth, entities, functions, automations, hosting, integrations)
- Runtime: functions are Deno Deploy handlers (base44/functions/<name>/entry.ts)
- AI: InvokeLLM (multi-model: automatic, gpt_5_*, gemini_3_*, claude_*); web search via gemini models + add_context_from_internet
- Voice: ElevenLabs (ELEVENLABS_API_KEY)
- Scraping/verify: SUPADATA_API_KEY_2; OpenAI fallback (OPENAI_API_KEY)
- Payments: Stripe (createStripeCheckout, stripeWebhook, setStripeSecrets)
- Email: SendEmail (registered users only) + sendWelcomeEmail, sendAnalysisEmail, sendDailyDevotionalEmail

================================================================
6. DATA MODEL — ENTITIES (see Raw Data Dump for full schemas)
================================================================
Core truth: TruthCheck, SermonScan, TrendingClaim, LiveReceiptFeed, TheoSearch
Bible/Study: StudyLibrary
Devotional: Devotional, Bookmark
Prayer community: PrayerCircle, PrayerCircleMember, CircleInvite, CirclePendingInvite, CircleChatMessage, ChatReaction, CircleLastSeen, PrayerPost, PrayerInteraction, PrayerUpdate, TestimonyReceipt, ModerationReport, CircleFunding
Radio: ReceiptsRadioStationBlock, ReceiptsRadioHost, ReceiptsRadioTrack, ReceiptsRadioBumper, ReceiptsRadioFavorite
Platform: User, Subscription, UsageLog, WhiteLabel, WhiteLabelUsage, OnboardingProgress, ListenerQuestion, SfxAsset

Built-in on every record: id, created_date, updated_date, created_by_id.

================================================================
7. BACKEND FUNCTIONS (see Raw Data Dump for full list)
================================================================
~41 functions covering: truth analysis (truthAnalyze, quickTruthAnalyze, updateTruthCheck), sermon scanning (sermonScanner), theology (theoSearch, peaceSynthesis, getAllStudyEntries, guardedStudyInsert, importStudyEntries, exportStudyLibrary, libraryIndexRaw), voice (peaceSpeak, generatePeaceVoice, bibleImmersionAudio), podcast (podcastGenerator, podcastOrchestrator, saveEpisode44, updateDevotionalById, updateDevotionalScript, loadJuneDevotionals, notifyListenerAired), radio agents (amandaAgent, asherAgent, flacoAgent, sweetsAgent), feed (dailyLivingReceiptFeed), sharing/OG (getPublicReceipt, getReceiptOGTags, receiptOgImage, receiptOrchestrator), email (sendWelcomeEmail, sendAnalysisEmail, sendDailyDevotionalEmail), payments (createStripeCheckout, stripeWebhook, setStripeSecrets), white-label (trackWhiteLabelUsage, whiteLabelMonthlyBilling), media (uploadApplauseClip, uploadSfxAssets, convertSfxToPcm), cross-refs (getCrossReferences).

================================================================
8. INTEGRATIONS / SECRETS
================================================================
Core package: InvokeLLM, SendEmail, UploadFile, GenerateImage, GenerateSpeech, GenerateVideo, TranscribeAudio, ExtractDataFromUploadedFile, CreateFileSignedUrl, UploadPrivateFile
Secrets (names only): SUPADATA_API_KEY_2, OPENAI_API_KEY, ELEVENLABS_API_KEY
Connectors available (not yet authorized): Google suite, Slack, Notion, Salesforce, HubSpot, Wix, GitHub, Outlook, Linear, Airtable, Asana, Jira, etc. Gmail workspace connectors registered (RESTORED Gmail / RESTORED Gmail (New)).

================================================================
9. DESIGN SYSTEM
================================================================
- Fonts: Playfair Display (headings), Inter (body)
- Light + dark themes via CSS tokens (src/index.css → tailwind.config.js)
- Primary: warm gold (hsl 36 60% 50%). Dark mode: deep slate-blue backgrounds, white text.
- Glassmorphism cards, rounded-2xl, soft shadows, wallpaper backgrounds (custom upload + presets), Peace orb (violet-gold glow)
- Mobile-first responsive; tap-target minimums; scrollbar-hide utilities

================================================================
10. GROWTH & BUSINESS MODEL
================================================================
- Subscription tiers: Free, Pro, Ultimate, Scholar, Ministry, White-label (exact pricing TBD)
- Affiliate program (?ref= referral capture stored on user)
- White-label licensing for ministries, churches, media orgs
- Recurring revenue + relationship lock-in (Peace memory compounds)
- Pastoral-escalation routing (potential referral/professional network)

================================================================
11. WHY NOW
================================================================
- Democratized pulpits: every phone is a pulpit; heresy travels faster than pastors can rebut
- Secular fact-checkers have no theological framework (unserved category)
- AI companionship is the new interface
- African/Diaspora heritage recovery moment
- Believers drowning in claims with no verification tool

================================================================
12. DIFFERENTIATORS
================================================================
- "Receipt" verdict metaphor + fixed 5-verdict scale
- Live scripture verification (not memory)
- Tradition-aware (Denomination-Dependent + Theology Receipt)
- African/Diaspora centered, not erased
- Intellectual humility as a feature
- Pastoral escalation
- One engine → many surfaces (truth, sermon, bible, study, devotional, prayer, radio, feed)
- Voice + audio throughout (Peace, devotionals, radio, immersion)
- White-label ready
- Peace memory = relationship lock-in

================================================================
13. KNOWN GAPS / TO STRENGTHEN
================================================================
- Exact subscription pricing & per-tier feature gates
- Active user counts / traction metrics
- Affiliate payout economics
- Signed white-label/ministry partnerships
- Founding team & funding stage
- Named competitive comparison
- Verified market-size statistics
- Creator-of-record confirmation (3 Solutions Inc.)

================================================================
END OF BLUEPRINT
================================================================