zonecrest/lottery

Ghana VAT e-lottery # Ghana E-VAT Receipt Lottery Prototype A complete working prototype demonstrating "Instant Win" lottery mechanics to gamify VAT tax compliance in Ghana. ## Overview The E-VAT Receipt Lottery encourages consumers to request VAT receipts by offering instant prize opportunities. When a consumer scans the QR code on their VAT receipt, they have a chance to win airtime prizes instantly. **Key Features:** - QR code scanning from VAT receipts - Instant win/lose result with celebratory animations - Transparent, verifiable lottery results using cryptographic hashes - Leaderboard with gamification badges - Mobile-first PWA design ## Quick Start ### Option 1: Local Demo (No Backend Required) 1. Open `frontend/index.html` in a web browser 2. The app runs in demo mode with simulated data stored locally 3. Use `frontend/admin.html` to generate test QR codes ### Option 2: Deploy to Netlify 1. Push this repo to GitHub 2. Connect to Netlify 3. Deploy the `frontend/` directory 4. Access your live URL ### Option 3: Full Setup with n8n Backend See n8n/README.md for backend setup instructions. ## Project Structure ``` ghana-lottery-prototype/ ├── frontend/ │ ├── index.html # Scanner page │ ├── leaderboard.html # Leaderboard page │ ├── transparency.html # Audit log page │ ├── admin.html # Demo admin page │ ├── css/ │ │ └── styles.css # All styles (Ghana themed) │ ├── js/ │ │ ├── app.js # Main app logic │ │ ├── scanner.js # QR scanning logic │ │ ├── api.js # Backend API calls │ │ └── config.js # Configuration │ ├── assets/ │ │ ├── logo.svg # App logo │ │ └── icons/ # PWA icons │ ├── manifest.json # PWA manifest │ └── netlify.toml # Netlify config ├── n8n/ │ ├── lottery-workflow.json # Importable n8n workflow │ └── README.md # n8n setup instructions ├── assets/ │ └── qr-cod …