Fkenogo/kirimba-banking

KIRIMBA is a digital group savings and lending platform for informal groups in Burundi. Members pool their savings, which are held safely at a licensed microfinance institution (Umuco microfinance for the pilot phase). KIRIMBA then offers members loans funded from Kirimba's own loan fund backed by the collective savings held at Umuco as collateral. # KIRIMBA KIRIMBA is a digital group savings and lending platform for informal groups and market vendors in Burundi. Members pool their savings, which are held safely at a licensed microfinance institution (Umuco), while KIRIMBA provides loans from its own fund backed by that collateral. ## Tech Stack - Firebase Firestore - Firebase Authentication - Firebase Cloud Functions (Node.js 20) - Firebase Hosting (multi-site) - React + Vite + TailwindCSS ## Project Structure ```text /functions Cloud Functions backend (business logic entrypoint) /apps/member Member app (served at /app) /apps/agent Agent app (served at /agent) /apps/admin Admin app (served at /admin) /apps/umuco Umuco dashboard app (served at /umuco) /firebase.json Firebase services + hosting + emulator config .firebaserc Firebase project alias + hosting targets ``` ## Setup ```bash nvm use npm install npm run emulators:core firebase deploy ``` ## Local App Routes Use `npm run dev:all` for live development or `npm run build:all && npm run preview:all` for production bundle preview. - Member app: `127.0.0.1` in dev, `127.0.0.1` in preview - Agent app: `127.0.0.1` in dev, `127.0.0.1` in preview - Admin app: `127.0.0.1` in dev, `127.0.0.1` in preview - Umuco app: `127.0.0.1` in dev, `127.0.0.1` in preview ## Firebase Hosting Targets - `firebase.json` expects hosting targets for `app`, `agent`, `admin`, and `umuco`. - `.firebaserc` currently defines only `app` and `admin`. - Add the real Firebase Hosting site IDs for `agent` and `umuco` before using Firebase Hosting preview channels or multi-site deploys. ## Notes - Cloud Functions currently include member onboarding, group management, savings/deposit-batch flows, loan lifecycle callables, and health check …