Budget-aware healthy meal planning for South African routines. Angular 20 + Node.js/Express + MongoDB, with Excel import, explainable food suggestions, recipe videos and a calorie/gym roadmap.
# EatHealthy
EatHealthy is a budget-aware healthy meal planner designed around real South African routines and food choices. It transforms familiar foods, pantry items, dietary preferences, an optional Excel schedule and a monthly grocery budget into a practical daily eating plan—without requiring a paid AI subscription.
> Eat familiar. Live healthier. Spend smarter.
## Why EatHealthy?
Many nutrition applications assume expensive ingredients, unfamiliar recipes or a permanent AI subscription. EatHealthy starts with what a person already eats and can afford. Its explainable planning engine filters unsafe or unwanted ingredients, favours pantry reuse and affordable combinations, estimates plan cost and creates a schedule that can realistically fit around work and commuting.
The long-term product brings healthy meal planning, calorie tracking and guided gym workouts into one connected experience. The current repository intentionally closes Phase 1 around the meal-planning MVP before those connected modules are added.
## Phase 1 features
- Personal wellness profile, goal and activity level
- Familiar-food and pantry capture
- Monthly grocery budget in ZAR
- Deterministic meal planner (no paid AI required)
- Allergy and dietary exclusions
- 7, 10 or 14-day plans with meal times
- Estimated calories, protein and daily cost
- Budget status and consolidated shopping list
- YouTube recipe links and embedded direct videos
- Daily meal, water, movement and sleep tracking
- Import of `.xlsx` schedules shaped like the included reference workbook
- MongoDB plan persistence when configured, with a stateless demo fallback
- Swagger/OpenAPI endpoint documentation
- Member profile and appearance API contracts
- Subscription status and entitlement contracts
- Notification preference and schedule-outcome endpoints
- Weekly/monthly report-summary endpoint
## Stack
- Angular 20 standalone frontend
- Angular Material
- Node.js + Express + TypeScript backend
- MongoDB + Mongoose ( …