eugeneadade81-design/foodtrace-gh

Food and drug safety traceability platform for Ghana # FoodTrace GH ## Scan It. Trace It. Trust It. FoodTrace GH is a Ghana-focused food traceability platform for consumers, farmers, manufacturers, and FDA regulators. It helps people verify product safety from a QR code, gives farmers and manufacturers a practical way to log traceability data, and gives regulators a faster view of recalls, consumer reports, and high-risk products across districts. **Live app:** foodtrace-inc.github.io (web) · backend API at foodtrace-gh.onrender.com ## Key Features - Food traceability from farm input to packaged product. - QR scanning on mobile and web, with typed fallback for damaged labels. - Recall workflows for manufacturers and regulators. - Farmer portal for farms, crop cycles, pesticide logs, and safe harvest timing. - FDA dashboard with compliance metrics, alerts, reports, and emergency recall actions. - USSD and SMS fallback for feature-phone users. - Multilingual audio summaries for scan results. The medicine/pharmacy module is available behind `VITE_ENABLE_DRUG_MODULE=true`. Local/pilot defaults keep it **off** (see `.env.example`). The live GitHub Pages deploy intentionally sets it **on** so demo drug QR codes work for reviewers. ## Tech Stack | Layer | Technology | | --- | --- | | Backend | Java 21 / 17, Spring Boot (**microservices**: Core API + Analytics Service) | | Mobile | React Native, Expo | | Web | React, Vite, TypeScript | | Database | PostgreSQL | | SMS / USSD | Africa's Talking | | Audio | Google Text-to-Speech, Expo Speech fallback | **Architecture & business docs (CODEQUEST):** - docs/APP_GUIDE.md — **how the whole app works** (start here) - docs/MICROSERVICES.md — how the two Spring services split work - docs/BUSINESS_MODEL.md — manufacturer SaaS + regulator licensing - docs/architecture.md — regulator / analytics deep dive ## Local Setup 1. Clone the repo. ```bash git clone github.com cd foodtrace-gh ``` 2. Copy `.env. …