# benildavid/meal_planner architecture

> Architecture diagram of the GitHub repository benildavid/meal_planner, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/benildavid/meal_planner
- Repository: https://github.com/benildavid/meal_planner

## Overview

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: [`src/lib/planning/service.ts`](https://github.com/benildavid/meal_planner/blob/main/src/lib/planning/service.ts) (Plan service), [`src/lib/db.ts`](https://github.com/benildavid/meal_planner/blob/main/src/lib/db.ts) (Application database), [`src/lib/health/share.ts`](https://github.com/benildavid/meal_planner/blob/main/src/lib/health/share.ts) (Report sharing), [`src/lib/health/service.ts`](https://github.com/benildavid/meal_planner/blob/main/src/lib/health/service.ts) (Health monitoring)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; household"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_household["Household access<br/>[household.ts]"]
  node_members["Member profiles<br/>[member-form.tsx]"]
end

subgraph group_planning["Meal planning"]
  node_planner_ui["Weekly planner<br/>[weekly-planner.tsx]"]
  node_plan_actions["Planning actions<br/>[planning.ts]"]
  node_planning_service["Plan service<br/>[service.ts]"]
  node_catalog["Food catalog<br/>[catalog.ts]"]
  node_ai["AI generation<br/>[client.ts]"]
end

subgraph group_nutrition["Nutrition data"]
  node_nutrition_engine["Nutrition engine<br/>[engine.ts]"]
  node_nutrients["Nutrient model<br/>[nutrients.ts]"]
  node_food_pages["Food management<br/>[page.tsx]"]
end

subgraph group_operations["Household operations"]
  node_groceries["Grocery ledger<br/>[service.ts]"]
  node_grocery_ui["Grocery planner"]
end

subgraph group_health["Health &amp; sharing"]
  node_health_service["Health monitoring<br/>[service.ts]"]
  node_health_ui["Health dashboard<br/>[dashboard.tsx]"]
  node_sharing["Report sharing<br/>[share.ts]"]
  node_share_page["Shared report view<br/>[page.tsx]"]
  node_pdf["PDF reports<br/>[pdf.tsx]"]
end

node_user(("Household user"))
node_provider{{"AI providers"}}
node_database[("Application database<br/>[db.ts]")]

node_user -->|"signs in"| node_auth
node_auth -->|"establishes access"| node_household
node_user -->|"manages profiles"| node_members
node_planner_ui -->|"requests generation"| node_plan_actions
node_plan_actions -->|"dispatches planning"| node_planning_service
node_planning_service -->|"checks ownership"| node_household
node_planning_service -->|"reads and writes plans"| node_database
node_planning_service -->|"loads candidates"| node_catalog
node_planning_service -->|"calculates targets"| node_nutrition_engine
node_planning_service -->|"generates day"| node_ai
node_ai -->|"sends requests"| node_provider
node_planner_ui -.->|"plans for member"| node_members
node_nutrition_engine -->|"scales and totals"| node_nutrients
node_food_pages -->|"reads foods"| node_database
node_food_pages -->|"uses nutrient data"| node_nutrients
node_grocery_ui -.->|"manages stock"| node_groceries
node_groceries -->|"reads and records ledger"| node_database
node_health_ui -.->|"shows monitoring"| node_health_service
node_health_service -.->|"accesses health data"| node_database
node_sharing -->|"builds report data"| node_health_service
node_share_page -->|"loads shared report"| node_sharing
node_sharing -->|"reads share records"| node_database
node_share_page -.->|"offers PDF report"| node_pdf

click node_auth "https://github.com/benildavid/meal_planner/blob/main/src/app/actions/auth.ts"
click node_household "https://github.com/benildavid/meal_planner/blob/main/src/lib/household.ts"
click node_members "https://github.com/benildavid/meal_planner/blob/main/src/components/member-form.tsx"
click node_planner_ui "https://github.com/benildavid/meal_planner/blob/main/src/components/weekly-planner.tsx"
click node_plan_actions "https://github.com/benildavid/meal_planner/blob/main/src/app/actions/planning.ts"
click node_planning_service "https://github.com/benildavid/meal_planner/blob/main/src/lib/planning/service.ts"
click node_catalog "https://github.com/benildavid/meal_planner/blob/main/src/lib/planning/catalog.ts"
click node_ai "https://github.com/benildavid/meal_planner/blob/main/src/lib/ai/client.ts"
click node_nutrition_engine "https://github.com/benildavid/meal_planner/blob/main/src/lib/nutrition/engine.ts"
click node_nutrients "https://github.com/benildavid/meal_planner/blob/main/src/lib/nutrition/nutrients.ts"
click node_food_pages "https://github.com/benildavid/meal_planner/blob/main/src/app/(app)/foods/page.tsx"
click node_groceries "https://github.com/benildavid/meal_planner/blob/main/src/lib/groceries/service.ts"
click node_grocery_ui "https://github.com/benildavid/meal_planner/blob/main/src/components/grocery-planner.tsx"
click node_health_service "https://github.com/benildavid/meal_planner/blob/main/src/lib/health/service.ts"
click node_health_ui "https://github.com/benildavid/meal_planner/blob/main/src/components/health/dashboard.tsx"
click node_sharing "https://github.com/benildavid/meal_planner/blob/main/src/lib/health/share.ts"
click node_share_page "https://github.com/benildavid/meal_planner/blob/main/src/app/share/%5Btoken%5D/page.tsx"
click node_pdf "https://github.com/benildavid/meal_planner/blob/main/src/lib/health/pdf.tsx"
click node_database "https://github.com/benildavid/meal_planner/blob/main/src/lib/db.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auth,node_household,node_members,node_user toneBlue
class node_planner_ui,node_plan_actions,node_planning_service,node_catalog,node_ai,node_database toneAmber
class node_nutrition_engine,node_nutrients,node_food_pages toneMint
class node_groceries,node_grocery_ui toneRose
class node_health_service,node_health_ui,node_sharing,node_share_page,node_pdf,node_provider toneIndigo
```

## Components

### Identity & household

- [Authentication](https://github.com/benildavid/meal_planner/blob/main/src/app/actions/auth.ts): `src/app/actions/auth.ts`
- [Household access](https://github.com/benildavid/meal_planner/blob/main/src/lib/household.ts): `src/lib/household.ts`
- [Member profiles](https://github.com/benildavid/meal_planner/blob/main/src/components/member-form.tsx): `src/components/member-form.tsx`

### Meal planning

- [Weekly planner](https://github.com/benildavid/meal_planner/blob/main/src/components/weekly-planner.tsx): `src/components/weekly-planner.tsx`
- [Planning actions](https://github.com/benildavid/meal_planner/blob/main/src/app/actions/planning.ts): `src/app/actions/planning.ts`
- [Plan service](https://github.com/benildavid/meal_planner/blob/main/src/lib/planning/service.ts): `src/lib/planning/service.ts`
- [Food catalog](https://github.com/benildavid/meal_planner/blob/main/src/lib/planning/catalog.ts): `src/lib/planning/catalog.ts`
- [AI generation](https://github.com/benildavid/meal_planner/blob/main/src/lib/ai/client.ts): `src/lib/ai/client.ts`

### Nutrition data

- [Nutrition engine](https://github.com/benildavid/meal_planner/blob/main/src/lib/nutrition/engine.ts): `src/lib/nutrition/engine.ts`
- [Nutrient model](https://github.com/benildavid/meal_planner/blob/main/src/lib/nutrition/nutrients.ts): `src/lib/nutrition/nutrients.ts`
- [Food management](https://github.com/benildavid/meal_planner/blob/main/src/app/(app)/foods/page.tsx): `src/app/(app)/foods/page.tsx`

### Household operations

- [Grocery ledger](https://github.com/benildavid/meal_planner/blob/main/src/lib/groceries/service.ts): `src/lib/groceries/service.ts`
- [Grocery planner](https://github.com/benildavid/meal_planner/blob/main/src/components/grocery-planner.tsx): `src/components/grocery-planner.tsx`

### Health & sharing

- [Health monitoring](https://github.com/benildavid/meal_planner/blob/main/src/lib/health/service.ts): `src/lib/health/service.ts`
- [Health dashboard](https://github.com/benildavid/meal_planner/blob/main/src/components/health/dashboard.tsx): `src/components/health/dashboard.tsx`
- [Report sharing](https://github.com/benildavid/meal_planner/blob/main/src/lib/health/share.ts): `src/lib/health/share.ts`
- [Shared report view](https://github.com/benildavid/meal_planner/blob/main/src/app/share/%5Btoken%5D/page.tsx): `src/app/share/[token]/page.tsx`
- [PDF reports](https://github.com/benildavid/meal_planner/blob/main/src/lib/health/pdf.tsx): `src/lib/health/pdf.tsx`

### Other components

- **Household user**
- **AI providers**
- [Application database](https://github.com/benildavid/meal_planner/blob/main/src/lib/db.ts): `src/lib/db.ts`

## Connections

- Household user → Authentication: signs in
- Authentication → Household access: establishes access (evidence: `src/app/actions/auth.ts`)
- Household user → Member profiles: manages profiles (evidence: `README.md`)
- Weekly planner → Planning actions: requests generation (evidence: `src/components/weekly-planner.tsx`)
- Planning actions → Plan service: dispatches planning (evidence: `src/app/actions/planning.ts`)
- Plan service → Household access: checks ownership (evidence: `src/lib/planning/service.ts`)
- Plan service → Application database: reads and writes plans (evidence: `src/lib/planning/service.ts`)
- Plan service → Food catalog: loads candidates (evidence: `src/lib/planning/service.ts`)
- Plan service → Nutrition engine: calculates targets (evidence: `src/lib/planning/service.ts`)
- Plan service → AI generation: generates day (evidence: `src/lib/planning/service.ts`)
- AI generation → AI providers: sends requests (evidence: `src/lib/ai/client.ts`)
- Weekly planner → Member profiles: plans for member
- Nutrition engine → Nutrient model: scales and totals (evidence: `src/lib/nutrition/engine.ts`)
- Food management → Application database: reads foods (evidence: `src/app/(app)/foods/page.tsx`)
- Food management → Nutrient model: uses nutrient data (evidence: `src/app/(app)/foods/page.tsx`)
- Grocery planner → Grocery ledger: manages stock
- Grocery ledger → Application database: reads and records ledger (evidence: `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 (evidence: `src/lib/health/share.ts`)
- Shared report view → Report sharing: loads shared report (evidence: `src/app/share/[token]/page.tsx`)
- Report sharing → Application database: reads share records (evidence: `src/lib/health/share.ts`)
- Shared report view → PDF reports: offers PDF report
