# Capital Forge League — Full Charitable Auction Package

## Contents

### 1. Program Plan (Compliance & Operations)
- `CFL_Online_Charity_Auction_Program_Plan.docx`  
  Original detailed operating plan (registration, §6115 disclosure, authenticity, restricted funds, platform recommendation, solicitation letter, listing templates, checklist, open items).

### 2. Technical Proposal + Mockups
- `CFL_Auction_Donor_System_Proposal.docx`  
  Architecture (Laravel 11 + Livewire 3 + Reverb + Stripe), all 8 UI mockups (charitable versions), donor tracking screens, Reverb & Stripe code patterns, Livewire component examples, roadmap.

### 3. Mockups (PNG)
Folder `mockups/` contains the 8 high-fidelity screens with charitable messaging:
01 Homepage, 02 Lot Detail, 03 Donor CRM, 04 Progress, 05 Live Display, 06 AI Analysis, 07 Donor Profile, 08 Tracking Analytics.

### 4. Starter Code
- Models: Lot, Donor
- AiLotAnalyzer service
- Migration for core tables
- Controllers: AuctionController, DonorController
- Blade views: auctions/index, auctions/show (with §6115 disclosure footer)
- Livewire BidForm pattern (see proposal)

### 5. AI Recommendations
- `AI_Recommendations.md` — concrete suggestions for auction AI, outreach AI, and dashboard insights, with stack recommendation (xAI Grok preferred).

## Key Compliance Reminders (from Program Plan)
- Florida FDACS registration before solicitation.
- Publish good-faith FMV on every lot before bidding.
- Winning bidder receipts must show deductible amount (payment − FMV).
- Restricted funds if proceeds are designated for helmet safety research.
- Authenticity only — certified or documented provenance.
- Do not call it a raffle.

## Next Steps for Development
1. Review both Word documents with counsel/CPA.
2. Scaffold Laravel + install Reverb, Cashier/Stripe, Spatie, Livewire.
3. Implement models & migration.
4. Wire AI vision (start mock → real).
5. Build public auction + admin donor CRM + progress + live display.
6. Test full path including §6115 receipt language.

Prepared for Mark Jones / Capital Forge League — August 2026
