Gibosi/mtotocare-africa

# MtotoCare Africa > **AI-powered child health & parenting platform for families across Africa.** > Parents track their children's growth, vaccinations, nutrition, and book appointments. > Healthcare workers manage their patients. Administrators run the whole platform. --- ## 📋 Table of contents (all instructions in one place) 1. Quick start (5 minutes) 2. Where to find everything 3. Default admin account 4. Add your first parent / doctor / facility 5. Run on Windows 10 (your PC) 6. Test the AI Assistant 7. Test the offline mode 8. Test the Activity Log (audit) 9. Build the Android APK 10. Production deployment (Render.com) 11. Optional: enable real Gmail emails 12. Optional: enable real Groq AI streaming 13. Troubleshooting 14. Configuration reference 15. Tech stack 16. FRS & NFRS compliance --- ## At a glance | App | Who it's for | What it does | Tech | |---|---|---|---| | **Mobile** (parent) | Parents and families | Track child's growth, vaccinations, nutrition, AI assistant, book appointments, biometric login, real-time language switching (EN / SW) | React Native 0.74 + Expo SDK 51 + TypeScript + Redux Toolkit | | **Web admin** | Healthcare workers & administrators | Manage users & roles, facilities, view all patients, audit logs, reports. Bilingual. | React 18 + Vite 5 + Tailwind 3 + Recharts | | **Backend** | All clients | 146 REST endpoints, JWT auth + refresh rotation, Groq AI, Gmail SMTP, Flyway migrations | Spring Boot 2.7.18 + Java 21 + Lombok + H2 (dev) / MySQL 8 (prod) | | **Database** | — | 30 tables, only the admin is seeded. Everything else is created by users. | MySQL 8 (prod) / H2 in-memory (dev) | **Total: 52 mobile screens, 13 web pages, 25 backend controllers, 146 endpoints, 30 database tables, 100% mobile↔backend match.** --- ## ✨ Highlights - **Real AI Assistant** — powered by Groq Llama 3.3 70B (free), with safe offline canned responses when no API key is set, **and live streaming tokens** (type "What food is good for my chil …