Aline-eng/U-mwiza-Rwanda

Modern web platform for U’mwiza Rwanda to manage sponsored families, staff workflows, events and community records. # U'mwiza Rwanda - Humanitarian Platform A comprehensive, modern, secure, API-driven platform for managing humanitarian operations, family sponsorships, and community development in Rwanda. ## 📋 Table of Contents - Overview - Features - Technology Stack - Project Structure - Getting Started - Development - Deployment - Documentation - Contributing ## 🌟 Overview U'mwiza Rwanda is a full-stack web application designed to: - Support poor families through structured programs - Connect sponsors with children in need - Manage scholarships for bright but disadvantaged students - Coordinate volunteers and community services - Track family progress and development - Facilitate communication between sponsors and families ## ✨ Features ### Public Website - ✅ Modern, responsive landing page - ✅ Mission, vision, and values presentation - ✅ Programs overview - ✅ Impact statistics - ✅ Success stories - ✅ Upcoming events - ✅ Contact information ### Staff Portal - ✅ Community-specific dashboard - ✅ Family and child management - ✅ Health records tracking - ✅ Education progress monitoring - ✅ Budget preparation and submission - ✅ Yearly action plan creation - ✅ File uploads (letters, videos, photos) - ✅ Sponsor letter management - ✅ Real-time notifications - ✅ Task management - ✅ Activity reporting ### Admin Portal - ✅ System-wide dashboard - ✅ Staff management - ✅ Task approval workflow - ✅ Event management - ✅ Activity monitoring - ✅ Report generation - ✅ System analytics - ✅ Audit logs ## 🛠️ Technology Stack ### Frontend - **Framework**: Next.js 14 (React 18) - **Language**: TypeScript - **Styling**: TailwindCSS - **Animations**: Framer Motion - **State Management**: Zustand - **Data Fetching**: React Query - **Forms**: React Hook Form + Zod - **Icons**: Lucide React ### Backend - **Runtime**: Node.js - **Framework**: Express.js - **Language**: TypeScript - **Database**: PostgreSQL - **ORM**: Prisma - **Authentication**: JWT + Refresh Tokens - **File Storage**: AWS S3 - …