User Stories: Grocery & Meal Planning¶

Overview¶

Stories covering ingredient management, recipe organization, meal planning, shopping trips, and pantry inventory tracking.

Stories¶

US-GRO-001: Manage Ingredient Catalog¶

As a Mindful Planner, I want to maintain a catalog of ingredients with nutritional categories, so that I can build recipes from a consistent, reusable ingredient list.

Acceptance Criteria:

• Create, update, and delete ingredients with name and category
• Search ingredients by name
• Prevent duplicate ingredient names

US-GRO-002: Create and Edit Recipes¶

As a Mindful Planner, I want to create recipes with ingredients and quantities, so that I can plan meals and generate shopping lists automatically.

Acceptance Criteria:

• Create a recipe with a name, description, and list of ingredients with quantities
• Edit recipe ingredients and quantities
• View all recipes with search and filtering

US-GRO-003: Plan Weekly Meals¶

As a Household Coordinator, I want to assign recipes to days of the week, so that my family knows what we're eating and I can shop efficiently.

Acceptance Criteria:

• Assign recipes to specific dates on a weekly calendar
• View the current week's meal plan at a glance
• Generate a consolidated shopping list from the meal plan

US-GRO-004: Create Shopping Trips¶

As a Household Coordinator, I want to create a shopping trip with items from my meal plan, so that I have a clear list to follow at the store.

Acceptance Criteria:

• Create a shopping trip with a list of items and quantities
• Add items manually or from a generated meal plan list
• Check off items during the shopping trip on mobile

US-GRO-005: Complete Shopping Trip and Update Inventory¶

As a Self-Hosting Tinkerer, I want completing a shopping trip to automatically update my pantry inventory, so that I don't have to manually track what I bought.

Acceptance Criteria:

• Completing a trip creates inventory batches for purchased items
• Each batch records the acquisition date for FIFO tracking
• Inventory quantities reflect the purchased amounts

US-GRO-006: Track Pantry Inventory with Expiry¶

As a Mindful Planner, I want to see what's in my pantry and when items expire, so that I can reduce food waste and plan meals around what I have.

Acceptance Criteria:

• View current inventory with quantities and expiry dates
• Highlight items expiring within the next 3 days
• Oldest batches are consumed first (FIFO)

US-GRO-007: Check Recipe Cookability¶

As a Self-Hosting Tinkerer, I want to see which recipes I can cook with my current inventory, so that I can plan meals without an extra shopping trip.

Acceptance Criteria:

• Compare recipe requirements against active inventory batches
• Show a cookability status (fully available, partially available, not available)
• List missing ingredients and quantities

US-GRO-008: Manage Products and Retailers¶

As a Household Coordinator, I want to associate ingredients with specific products at retailers, so that I know exactly what to buy and where.

Acceptance Criteria:

• Create products linked to ingredients with retailer information
• View product options when adding items to a shopping trip
• Filter shopping lists by retailer