How hoanganhcq/nutriplan works
NutriPlan is a project scaffold for a family-oriented nutrition PWA: users manage household profiles, capture meals, review AI analysis, keep a diary, and plan menus around health conditions. The README describes a backend that coordinates analysis, nutrition calculations, medical rules, privacy, media, and exports, alongside AI vision, portion estimation, retrieval, and LLM capabilities. The frontend route and layout links are visible in sampled code; backend and AI implementation details are not sampled, so those branches reflect documented responsibilities rather than verified call paths.
Main entry points: api API layer · App.jsx App router · meal_analysis Analysis orchestration · rag Knowledge retrieval
Components 27
Family nutrition PWA
- App router
frontend/src/App.jsx - App layout
frontend/src/layouts/AppLayout.jsx - Navigation
frontend/src/layouts/NavBar.jsx - Home page
frontend/src/features/home/HomePage.jsx - Meal capture
frontend/src/features/meal_capture/CapturePage.jsx - Family profiles
frontend/src/features/family_profiles/FamilyPage.jsx - Meal diary
frontend/src/features/meal_diary/DiaryPage.jsx - Menu planning UI
frontend/src/features/menu_planning/MenuPage.jsx
Backend services
- API layer
backend/src/api - Analysis orchestration
backend/src/services/meal_analysis - Profile services
backend/src/services/profiles - Media handling
backend/src/services/media - Nutrition calculation
backend/src/services/nutrition - Medical rules
backend/src/services/rule_engine - Menu generation
backend/src/services/menu_planning - Diary services
backend/src/services/meal_diary - Privacy services
backend/src/services/privacy - PDF export
backend/src/services/pdf_export
AI analysis
- Food recognition
ai/src/vision - Portion estimation
ai/src/portion_estimation - Knowledge retrieval
ai/src/rag - LLM explanation
ai/src/llm
Data and persistence
- Nutrition and source data
data - Application storage
database - Vector store
database/vector_store
Shared contracts
- API schemas
contracts
Other components
- Family user
Connections 32
- Family user → App router: uses
README.md - App router → App layout: renders routes in
frontend/src/App.jsx - App router → Home page: routes to
frontend/src/App.jsx - App router → Meal capture: routes to
frontend/src/App.jsx - App router → Family profiles: routes to
frontend/src/App.jsx - App router → Meal diary: routes to
frontend/src/App.jsx - App router → Menu planning UI: routes to
frontend/src/App.jsx - App layout → Navigation: renders
frontend/src/layouts/AppLayout.jsx - App router → API layer: exchanges data with
- API layer → Analysis orchestration: coordinates
README.md - Analysis orchestration → Media handling: uses
- Analysis orchestration → Food recognition: analyzes meals with
- Analysis orchestration → Portion estimation: estimates portions with
- Analysis orchestration → Nutrition calculation: coordinates
README.md - Analysis orchestration → Knowledge retrieval: uses retrieval
- Analysis orchestration → LLM explanation: uses
- Analysis orchestration → Profile services: uses profiles
- Analysis orchestration → Medical rules: applies constraints
README.md - Menu planning UI → API layer: requests planning
- Meal diary → API layer: requests diary data
- Family profiles → API layer: requests profiles
- API layer → Diary services: coordinates
- API layer → Menu generation: coordinates
README.md - API layer → Privacy services: coordinates
README.md - API layer → PDF export: coordinates
README.md - API layer → Application storage: reads and writes
- Nutrition calculation → Nutrition and source data: uses nutrition data
README.md - Medical rules → Nutrition and source data: uses medical rules
README.md - Knowledge retrieval → Nutrition and source data: retrieves from
README.md - Knowledge retrieval → Vector store: queries
README.md - API layer → API schemas: uses shared schemas
README.md - App router → API schemas: shares API schemas
README.md