kmuwanga83/Care4AnimalsV2

CARE4ANIMALS: A Microlearning Platform for Empowering Farmers with Bite-Sized Animal Wellness Knowledge. Hybrid mobile + SMS platform to support animal welfare education for smallholder farmers in Africa. # CARE4ANIMALS V2 **CARE4ANIMALS** is a multilingual microlearning platform designed to bridge the veterinary knowledge gap for smallholder farmers in Africa. By combining a modern web experience with a robust SMS fallback, the platform ensures that critical animal welfare education is accessible to everyone, regardless of connectivity or hardware. --- ## 🚀 What’s New in V2 * **Granular Analytics Pipeline:** Integrated tracking for farmer engagement and lesson interactions via the `/analytics/` endpoint. * **Integrated SMS & Chat:** Fully optimized workflows for SMS-formatted lessons and in-app communication. * **DevContainer Support:** Standardized development environment for consistent cross-platform onboarding. * **Refined CMS-to-SMS Pipeline:** Improved logic for publishing multilingual content across Web and SMS channels. --- ## 🛠 Core Features * **Multilingual Experience:** Bite-sized lessons available in English (**en**), Luganda (**lg**), and Swahili (**sw**). * **Hybrid Delivery:** * **Smartphone:** React-based PWA for high-engagement learning. * **Feature Phone:** Plain-text SMS flows (`TOPICS`, `LESSON `) for offline access. * **Behavioral Analytics:** Real-time logging of interactions to measure educational impact and behavioral change. * **Admin CMS:** Simplified API for authoring, translating, and publishing content. --- ## 🏗 System Architecture & Structure The platform uses a decoupled FastAPI backend and React frontend, supported by a PostgreSQL database and SMS gateway integration. ```text care4animals/ ├── backend/ # FastAPI, SQLAlchemy models, & Analytics logic ├── frontend/ # React (Vite) + TypeScript PWA ├── analytics/ # Data processing & engagement assets ├── sms-flows/ # USSD logic and SMS response templates ├── docs/ # Architecture diagrams and system documentation ├── scripts/ # Root helper scripts (bootstrap & automation) └── .devcontainer/ …