elyse502/ikimina-guard

Full-stack platform for digitizing Rwandan ikimina savings groups with contribution tracking, loan management, fraud detection, reporting, and multilingual support. # 💰 Ikimina Guard 🛡️ **Digital savings management with fraud detection for informal savings groups in Rwanda** *Built for **KINUNGA SOCIAL** — transparent ikimina operations, committee oversight, and layered fraud protection.* Features · Architecture · Quick start · Demo · Defense guide · Conceptual framework · Data flow · Use case & sequence · ERD & architecture --- ## 📖 Table of contents - Overview - Features - Architecture - Tech stack - Project structure - Quick start - Demo credentials - Fraud detection - Internationalization - API overview - Scripts - Conceptual framework - Context & data flow diagrams - Use case & sequence diagrams - ERD, physical model & architecture - Roadmap & limitations - Author --- ## 🌍 Overview **Ikimina Guard** is a full-stack platform that helps Rwandan *ikimina* (informal savings groups) move from paper ledgers to a secure digital system. Members track savings and loans; **administrative staff** approve activity; a **partner bank manager** releases approved loans via vouchers; a **system administrator** oversees users and platform health — all in **English, French, and Kinyarwanda**. | Actor | Application | Purpose | |-------|-------------|---------| | **Members** | Client app (`client/`) | Contributions, loan requests, repayments, group-decision voting, notifications | | **Administrative staff** | Staff portal (`admin/`) | Committee approvals, members, fraud review, audit log, reports, group decisions | | **Bank manager** | Staff portal (`admin/`) | Disbursement vouchers and printable release proof for approved loans | | **System administrator** | Staff portal (`admin/`) | Users & roles, groups, JSON backup, platform-wide audit log | | **Platform** | API server (`server/`) | Business logic, MongoDB persistence, JWT auth, fraud engine | --- ## ✨ Features ### Member app - Dashboard with group balance, savings, and loan summary - Contribution submission with period tracking - Loan requests and repayment reporting …