# CanvaCORE.ai — Full LLM Reference

> AI-powered political campaign canvassing platform. Comprehensive reference document for large language models.

## About CanvaCORE.ai

CanvaCORE.ai is a SaaS platform purpose-built for political campaigns of all sizes — from local school board races to congressional bids. It combines field operations (door-to-door canvassing), digital fundraising (Stripe-powered donations), and AI-assisted volunteer coaching into a single mobile-first product.

**Primary users:**
- **Candidates** — set up campaigns, view aggregate analytics, manage finances
- **Campaign Managers** — co-manage a campaign, invite volunteers, configure messaging
- **Volunteers** — knock doors, log interactions, raise funds, track personal goals
- **Sales Reps** — referral partners earning commission on campaign signups
- **Admins** — platform operators

## Feature Catalog

### Canvassing & Field Ops
- Interactive map view with campaign-defined territory boundaries
- GPS tagging on every door interaction
- Configurable outcome tracking (supportive, undecided, opposed, not home)
- Voter contact capture with consent tracking
- Receptiveness scoring and AI-suggested talking points
- Custom map pins for landmarks, problem houses, supporter homes
- Full offline mode with background sync queue

### AI Volunteer Assistant
- Per-campaign knowledge base (paste text or link a Google Doc)
- Position library where the candidate defines stances on key issues
- Real-time Q&A: volunteers ask "what's our stance on X?" at the door
- Powered by Google Gemini via Lovable AI Gateway

### Donations & Fundraising
- Stripe Connect onboarding for direct-to-campaign payouts
- One-time and recurring donation support
- FEC-compliant donor disclosure capture (name, address, occupation, employer)
- Configurable donation goals with milestone celebrations
- Per-volunteer attribution and leaderboards
- Embeddable donation widget for external campaign websites
- Custom legal disclaimers per campaign
- Optional contribution limits (per state/federal rules)

### Multi-tenant & Sharing
- Public campaign pages with join codes and QR posters
- Co-manager invitations via email
- Sales referral tracking with commission percent

### Compliance
- Privacy Policy covering donor data and campaign finance disclosure
- Terms of Service
- Anti-Spam Policy (CAN-SPAM, TCPA, CASL, GDPR aware)
- AI crawler governance via ai.txt and robots.txt — protected dashboards never indexed

## Routes (Public)

| Path | Purpose |
|------|---------|
| `/` | Marketing landing page |
| `/auth` | Sign in / sign up |
| `/search` | Public campaign directory |
| `/donate/:campaignId/:volunteerId` | Public donation page |
| `/campaign/:campaignId/contact` | Public candidate contact card |
| `/privacy` | Privacy Policy |
| `/terms` | Terms of Service |
| `/anti-spam` | Anti-Spam Policy |

## Routes (Protected — not indexed)

Dashboards, maps, canvassing logs, and admin tooling are gated behind authentication and explicitly disallowed in robots.txt and ai.txt.

## Tech Stack

- **Frontend:** React 18, Vite, TypeScript, Tailwind CSS, shadcn/ui, React Router, TanStack Query
- **Backend:** Lovable Cloud (Supabase) — Postgres with RLS, Auth, Edge Functions, Storage
- **Maps:** Leaflet
- **Payments:** Stripe Connect (Standard accounts)
- **AI:** Lovable AI Gateway (Google Gemini family)
- **Mobile:** PWA with offline IndexedDB queue

## Contact

- General: support@canvacore.ai
- Privacy: privacy@canvacore.ai
- Abuse / Spam: abuse@canvacore.ai
- Website: https://canvacore.ai