Architecture

System-level documentation for the ChurchWiseAI portfolio. If you're new to the codebase, start at system-overview.md — it maps the five properties, the shared Supabase instance, LiveKit voice, and where each code repo lives.

Start here

• system-overview.md — portfolio shape, shared infra, deploy branches
• infrastructure.md — Vercel, LiveKit, Supabase, Telnyx, Cartesia, Deepgram
• agent-tooling.md — CLIs + MCP plugins an agent can use without asking the founder, and which actions require confirmation

Data

• database-schema.md — shared Supabase — churches, premium_churches, unified_rag_content, voice_*
• multi-vertical-schema.md — 2026-04-21 shared-core + per-vertical-tenant-tables design
• db/plan-column-contract.md — how premium_churches.plan holds canonical Stripe tier keys
• db/ — per-table schema specs

Pipelines

• voice-pipeline.md — Telnyx SIP → LiveKit Agents → Deepgram + Cartesia
• voice-agent-resilience.md — LLM fallback chains and latency targets
• chatbot-pipeline.md — /api/chatbot/stream SSE + RAG cascade
• chatbot-tool-deferral.md — when the chatbot escalates to a tool call
• chatbot-excellence-blueprint.md — the quality bar for chatbot responses

APIs and routes

• api-catalog.md — every HTTP route across the three web repos (184 today)
• routes-catalog.md — every page under churchwiseai-web's src/app/ and the hostname rewrite it serves (sermonwise.ai, sharewiseai.com, wiseaiagency.com, funeralwiseai.com, vetwiseai…)
• payment-flow.md — Stripe checkout → webhook inbox → cron processor → provisioning
• pre-conversation-journey.md — what happens before a pastor ever talks to the agent

Admin dashboard

• admin-nav-capability-map.md — what every tab does, which tier unlocks it
• admin-rbac-2026-04-18.md — role-based access rules
• admin-rbac-api-enforcement-map.md — where the rules get enforced in code

Integrations

• supabase-auth-config.md — auth providers, email templates, redirect rules
• lifecycle-email-system.md — MailerLite sequences + Resend transactional
• pro-website-file-map.md — every file involved in a Pro Website render

Security

• protection-audit.md — input validation, rate limits, auth gates

Also look at

• integrations/ — per-service integration specs (Stripe, Resend, Telnyx, Vercel, etc.)
• processes/ — runnable procedures that touch these architectures
• decisions/ — why the shape is what it is