denare/utafiti

A comprehensive survey application for collecting housing market data in Tanzania, with secure Firebase backend and admin dashboard., this will help to come up with new features and modification on the main app (roomlink.co.tz) # 🏠 Utafiti Survey - Housing Survey Application A comprehensive Kiswahili survey application for collecting housing market data in Tanzania, with secure Firebase backend and admin dashboard. ## 🚀 Quick Start ### Deployed App - **Survey Form:** utafiti-tz.web.app - **Admin Dashboard:** utafiti-tz.web.app ### Local Development ```bash # Build and deploy npm run deploy # Backup database npm run backup # Local testing npm run serve ``` ## 📋 Features ### Survey Form (index.html) - ✅ 20-question survey in Kiswahili - ✅ Conditional logic (questions shown based on previous answers) - ✅ Real-time validation - ✅ Firestore database integration - ✅ Prevents duplicate submissions (localStorage) - ✅ Share functionality (WhatsApp, Facebook) - ✅ Mobile-optimized design ### Admin Dashboard (admin.html) - ✅ Real-time response viewer - ✅ Simple view (user-friendly cards) & Raw view (JSON) - ✅ CSV export for all responses - ✅ Response statistics - ✅ Copy response IDs to clipboard - ✅ Secure configuration (API keys hidden) ## 🔒 Security ### API Keys Protection - ✅ All credentials stored in `.env.local` - ✅ `config.js` auto-generated from environment variables - ✅ Both files in `.gitignore` (never committed) - ✅ No exposed keys in source code ### Database Backups - ✅ Automated Firestore backup script - ✅ Daily backups with timestamps - ✅ Complete data preservation - ✅ Restore-ready JSON format ## 📦 Setup & Deployment ### 1. Firebase Authentication ```bash export PATH="$HOME/.npm-global/bin:$PATH" firebase login:ci --no-localhost ``` ### 2. Build & Deploy ```bash npm run deploy ``` This automatically: - Generates `config.js` from `.env.local` - Deploys to Firebase Hosting - Updates live app at utafiti-tz.web.app ### 3. Setup Database Backups See BACKUP_SETUP.md for detailed instructions. ## 📁 Project Structure ``` utafiti/ ├── index.html # Survey form ├── admin.html # Admin dashboard ├── config.js …