happy-web

byशब्द यात्रा

Create a complete, production-ready PRIVATE web application called "Gulf Community Barju (GCB)". TECH STACK: - Frontend: Flutter Web (preferred) OR React.js (if better for web) - Backend: Firebase (FREE Spark Plan only) - Firebase Authentication - Cloud Firestore - Firebase Storage - Firebase Hosting IMPORTANT RULES: - This is NOT a payment system - No online transactions - This is a PRIVATE internal system - Only Admin can input data - Members have view-only access - All data is manually entered by admin ------------------------------------- 🔐 AUTHENTICATION SYSTEM - No public signup - Admin creates users - Login using Email & Password - Role-based access: - Super Admin - Admin - Member ------------------------------------- 👥 MEMBER MANAGEMENT Admin can: - Add, Edit, Soft Delete members Fields: - Full Name - Country (Qatar, Saudi, UAE, Kuwait, Malaysia, Oman, Nepal) - Phone Number - Profile Photo - Member ID - Family Group (optional) - isDeleted flag ------------------------------------- 💰 DONATION SYSTEM (RECORD ONLY) Admin manually records donations. Fields: - Member ID / Name - Country - Amount (Original) - Currency (QAR, AED, KWD, SAR, OMR, MYR, NPR) - Conversion Rate (manual input) - Final Amount (NPR) - Date - Receipt ID (auto-generated) - Proof Image (optional) - Entered By Rules: - No automatic currency conversion - Store both original and NPR values ------------------------------------- 💸 EXPENSE MANAGEMENT Admin can: - Add expenses - Link expenses to projects Fields: - Amount (NPR) - Category - Description - Date - File uploads ------------------------------------- 🏗 PROJECT MANAGEMENT Admin can: - Create projects - Set budget - Track progress Fields: - Project Name - Budget - Used Amount - Progress % - Linked expenses - Files ------------------------------------- 📊 DASHBOARD Show: - Total Donations (NPR) - Total Expenses - Remaining Balance Include charts: - Monthly donations (line chart) - Expense breakdown (pie chart) ------------------------------------- 📊 TRANSPARENCY SYSTEM Members can view: - All donation records - Donor name - Amount (original + NPR) - Date Include: - Search by name - Filter by country/date ------------------------------------- 📜 AUDIT LOG SYSTEM Track all actions: - Add/Edit/Delete - Currency updates - Login activity Fields: - action - user - old value - new value - timestamp ------------------------------------- 🗑 SOFT DELETE SYSTEM Use: - isDeleted = true - deletedAt - deletedBy ------------------------------------- 🔔 NOTIFICATIONS - Simple announcement system - Display inside dashboard ------------------------------------- 📊 REPORTS Generate: - Member report - Monthly report - Expense report Export: - PDF - Excel (basic) ------------------------------------- 🎨 UI DESIGN - Clean, simple, village-friendly UI - Sidebar dashboard layout - Mobile responsive Colors: - Primary: #0F9D58 - Secondary: #1A237E - Background: #F5F7FA UI Features: - Card-based dashboard - Tables with search & filter - Forms with validation - Large readable text ------------------------------------- 📱 REQUIRED PAGES - Login Page - Dashboard - Members Page - Donations Page - Projects Page - Expenses Page - Reports Page - Notifications Page - Profile Page - Admin Panel - Audit Logs Page ------------------------------------- 🗄 FIRESTORE DATABASE STRUCTURE Collections: - users - members - donations - expenses - projects - currency_rates - audit_logs - announcements ------------------------------------- 🔐 SECURITY RULES - Only authenticated users can read - Only admin can write - Role-based access control ------------------------------------- 🚀 DEPLOYMENT - Build for web - Deploy using Firebase Hosting (FREE) ------------------------------------- ⚡ EXTRA REQUIREMENTS - Clean and modular code - Proper folder structure - Error handling - Input validation - Easy for beginners to understand ------------------------------------- FINAL OUTPUT: - Complete working website code - Firebase setup instructions - Step-by-step deployment guide - Ready to run project