How benildavid/meal_planner works
NutriFamily is a private, household-based South Indian meal-planning and nutrition app. A signed-in user onboards a household and member profiles, then uses the weekly planner to generate or manually edit meals; planning calculates deterministic nutrition targets, optionally requests AI-generated meals, and persists plans. Separate branches cover grocery stock tracking and health monitoring, reports, and revocable sharing. The graph uses README descriptions for major capabilities and the supplied source excerpts and index for implementation links; unsampled subsystem internals are not inferred.
Main entry points: planning/service.ts Plan service · db.ts Application database · share.ts Report sharing · health/service.ts Health monitoring
Components 21
Identity & household
- Authentication
src/app/actions/auth.ts - Household access
src/lib/household.ts - Member profiles
src/components/member-form.tsx
Meal planning
- Weekly planner
src/components/weekly-planner.tsx - Planning actions
src/app/actions/planning.ts - Plan service
src/lib/planning/service.ts - Food catalog
src/lib/planning/catalog.ts - AI generation
src/lib/ai/client.ts
Nutrition data
- Nutrition engine
src/lib/nutrition/engine.ts - Nutrient model
src/lib/nutrition/nutrients.ts - Food management
src/app/(app)/foods/page.tsx
Household operations
- Grocery ledger
src/lib/groceries/service.ts - Grocery planner
src/components/grocery-planner.tsx
Health & sharing
- Health monitoring
src/lib/health/service.ts - Health dashboard
src/components/health/dashboard.tsx - Report sharing
src/lib/health/share.ts - Shared report view
src/app/share/[token]/page.tsx - PDF reports
src/lib/health/pdf.tsx
Other components
- Household user
- AI providers
- Application database
src/lib/db.ts
Connections 23
- Household user → Authentication: signs in
- Authentication → Household access: establishes access
src/app/actions/auth.ts - Household user → Member profiles: manages profiles
README.md - Weekly planner → Planning actions: requests generation
src/components/weekly-planner.tsx - Planning actions → Plan service: dispatches planning
src/app/actions/planning.ts - Plan service → Household access: checks ownership
src/lib/planning/service.ts - Plan service → Application database: reads and writes plans
src/lib/planning/service.ts - Plan service → Food catalog: loads candidates
src/lib/planning/service.ts - Plan service → Nutrition engine: calculates targets
src/lib/planning/service.ts - Plan service → AI generation: generates day
src/lib/planning/service.ts - AI generation → AI providers: sends requests
src/lib/ai/client.ts - Weekly planner → Member profiles: plans for member
- Nutrition engine → Nutrient model: scales and totals
src/lib/nutrition/engine.ts - Food management → Application database: reads foods
src/app/(app)/foods/page.tsx - Food management → Nutrient model: uses nutrient data
src/app/(app)/foods/page.tsx - Grocery planner → Grocery ledger: manages stock
- Grocery ledger → Application database: reads and records ledger
src/lib/groceries/service.ts - Health dashboard → Health monitoring: shows monitoring
- Health monitoring → Application database: accesses health data
- Report sharing → Health monitoring: builds report data
src/lib/health/share.ts - Shared report view → Report sharing: loads shared report
src/app/share/[token]/page.tsx - Report sharing → Application database: reads share records
src/lib/health/share.ts - Shared report view → PDF reports: offers PDF report