foodplanner/conductor/product.md

Initial Concept\nAn existing Meal Planner application built with FastAPI, SQLAlchemy, and Jinja2 for managing foods, meals, and nutritional plans.

Product Definition - FoodPlanner

Vision

A performance-oriented meal planning application designed for health-conscious households (specifically 2-person units) to hit precise nutritional and macronutrient targets. The application prioritizes speed, data reliability, and structured planning over complex external integrations.

Target Users

• Macro-Trackers: Individuals who meticulously track their caloric and macronutrient intake.
• 2-Person Households: Users who need to coordinate meal plans for a small, consistent group.

Core Goals

• Nutritional Precision: Enable users to reach specific daily and weekly macro/calorie goals through structured 2-week planning.
• Efficiency: Reduce the friction of meal prep by providing tools to save, reuse, and template successful plans and meals.
• Reliability: Provide a fast, local-first experience with robust data storage (SQLite/PostgreSQL).

Key Features

• Nutritional Totaling: Automated, real-time calculation of macros and calories for individual foods, combined meals, and full daily/weekly plans.
• Detailed Daily Planner: A granular view of each day to visualize meal distribution and ensure macro balance across the day.
• Meals Library: A centralized repository to create and save custom meals from individual food components.
• Template System: Save and apply successful daily or weekly structures to future plans to minimize repetitive data entry.
• Open Food Facts Integration: Rapidly expand the local food database by importing data directly from the Open Food Facts API.

Technical Philosophy

• Local-First & Fast: The UI must be highly responsive, prioritizing a smooth user experience for frequent data entry.
• Structured Data: Use a relational database to ensure data integrity across foods, meals, and plans.