austinLorenzMccoy/JuaPesa

Enable near-instant, low-cost, compliant cross-wallet transfers across African mobile money rails by routing liquidity through regulated stablecoin pools and an AI-driven router. Interoperable, affordable, and instant money movement across Africa. # Jua Pesa — AI Liquidity Network Enable near-instant, low-cost, compliant cross-wallet transfers across African mobile money rails by routing liquidity through regulated stablecoin pools and an AI-driven router. > Interoperable, affordable, and instant money movement across Africa. --- ## Team Members - Adachukwu Okafor - github.com (Frontend engineer) - Austin Chibueze - github.com (Backend/AI Engineer) ## ✨ Highlights - FastAPI backend with modular architecture and 100% test coverage gate - React + Vite + TypeScript frontend (shadcn/ui + Tailwind, Radix primitives) - Solidity Hardhat scaffold with `LiquidityPool.sol` and tests - Prometheus metrics endpoint (`/metrics`) and health probes (`/healthz`) - Config via `.env` using `pydantic-settings`; safe fallbacks for dev - Monorepo with `git subtree` for `frontend/` to preserve independent history --- ## 🗂️ Repository Structure ``` JuaPesa/ ├─ backend/ # FastAPI service and tests │ ├─ app/ │ │ ├─ api/ # API routes (USSD, convert, rebalance, etc.) │ │ ├─ core/ # Config, DB, cache │ │ ├─ models/ # Pydantic schemas & SQLAlchemy models │ │ ├─ services/ # Business logic (wallet, liquidity, forecast, auth) │ │ ├─ integrations/ # External integrations (Daraja, CCTP, Hedera) │ │ └─ ai/ # Groq AI client wrapper (mock-friendly) │ ├─ tests/ # Pytest suite (coverage target 100%) │ ├─ environment.yml # Conda environment (includes pip -e .[dev]) │ ├─ pyproject.toml # Dependencies, tooling configs │ └─ README.md # Backend-specific docs │ ├─ frontend/ # React + Vite + TS UI (added via git subtree) │ ├─ src/ # Components, hooks, contexts │ ├─ public/ # Static assets │ ├─ package.json # Scripts and deps │ └─ README.md # Frontend-specific docs and usage │ ├─ contract/ # Hard …