Skip to content

Scenario 3: Adding New Dietary‐Specific Food Item and Recipe

nuriba edited this page Oct 16, 2025 · 1 revision

Requirement Scenario: Adding New Dietary-Specific Food Item and Recipe

Actor

Registered User: Elif (A consumer with celiac disease)

User Persona

  • Name: Elif
  • Situation: Elif has celiac disease and must follow a strictly gluten-free diet. She enjoys creating simple recipes and has discovered a new type of gluten-free flour not yet listed in the platform.
  • Goal: Elif wants to add the newly discovered gluten-free flour to the platform's database, use it in a flatbread recipe, and incorporate that recipe into her weekly meal plan.

Preconditions

  1. Elif is logged into the Affordable & Healthy Eating Hub platform. (Requirement 1.7.2)
  2. Elif has selected "Gluten" from the allergen list in her profile. (Requirement 1.2.1)
  3. The platform's Food Database does not currently include the specific gluten-free flour she discovered.
  4. The food database exists with at least 500 common food items. (Requirement 1.1.1)
  5. Content Administrators or Community Moderators are available to review food item submissions. (Requirement 1.8.4)

Main Flow

  1. Elif searches the Food Database for the specific gluten-free flour (buckwheat flour).
  2. Finding no match, Elif selects "Propose New Food Item" to contribute to the database.
  3. Elif fills in the mandatory fields for the food item proposal:
    • Food Name: Buckwheat Flour
    • Food Category: Grain
    • Macronutrient Information (per 100g):
      • Calories: 335 kcal
      • Carbohydrates: 71 g
      • Protein: 13 g
      • Fat: 3.4 g (Requirement 1.1.2.1)
  4. Elif adds optional micronutrient data to provide comprehensive information:
    • Iron: 4.1 mg per 100g
    • Magnesium: 251 mg per 100g
    • Vitamin B6: 0.6 mg per 100g (Requirement 1.1.2.2)
  5. Elif submits her proposal to moderators for review.
  6. A Content Administrator reviews and approves the submission in the moderation dashboard. (Requirement 1.8.4, 1.8.6)
  7. The system calculates a nutrition score for the new flour using the formula:
    • FoodScore = 0.30 * ProteinZ + 0.30 * CarbQuality + 0.40 * NutrientBalance
    • The score is displayed with a tooltip containing the formula reference (Requirement 1.1.3)
  8. The buckwheat flour is now listed in the database and supports the "Gluten-free" and "Celiac-friendly" dietary options. (Requirement 1.1.4.e, 1.1.4.f)
  9. Elif receives a notification that her food item proposal has been approved.
  10. Elif navigates to the recipe creation page to create a new recipe called "Gluten-Free Flatbread".
  11. Elif lists all ingredients including her newly added buckwheat flour, olive oil, water, and salt. (Requirement 1.3.1)
  12. Elif links each ingredient to its entry in the Food Database. (Requirement 1.3.2)
  13. The system automatically calculates the recipe cost by summing the prices of all included ingredients from marketfiyati.org API data. (Requirement 1.3.4, 1.3.5, 1.1.5)
  14. Elif adds detailed step-by-step instructions for preparing the flatbread (mixing, kneading, resting, cooking). (Requirement 1.3.3)
  15. The system calculates an aggregated nutrition score for the recipe based on ingredient quality and nutritional balance. (Requirement 1.3.7)
  16. Elif adds appropriate tags to her recipe including "Recipe" and additional descriptive tags. (Requirement 1.4.1, 1.4.7.b)
  17. Elif acknowledges community guidelines by agreeing to the responsibility prompt. (Requirement 1.4.14)
  18. Elif posts the recipe to the forum. (Requirement 1.4.2)
  19. Elif navigates to the meal planner to create her weekly plan.
  20. The system generates a meal plan using a seeded pseudo-random algorithm, filtering for gluten-free recipes based on Elif's allergen preferences. (Requirement 1.5.3)
  21. Elif manually adds her new Gluten-Free Flatbread recipe to specific days in her meal plan. (Requirement 1.5.4)
  22. Elif saves her meal plan for future reference and reuse. (Requirement 1.5.4)
  23. Elif receives a nutritional summary for her complete weekly meal plan. (Requirement 1.5.5)
  24. Elif's contribution is tracked in her personal dashboard, showing her impact on the community. (Requirement 1.2.14)

Outcome

  • The new gluten-free buckwheat flour is now available in the Food Database with an appropriate nutrition score and dietary tags.
  • A Content Administrator has verified the nutritional data through the moderation process. (Requirement 1.8.4)
  • Elif's Gluten-Free Flatbread recipe is published in the forum with complete nutritional information, cost estimates, and nutrition score.
  • The recipe is tagged appropriately to be discoverable by other users with gluten allergies or celiac disease.
  • Elif has successfully incorporated the recipe into her weekly meal plan with allergen-safe options.
  • The meal plan provides nutritional summaries ensuring Elif meets her dietary needs. (Requirement 1.5.5)
  • Other users with celiac disease can now benefit from Elif's contribution to both the Food Database and recipe collection.
  • Elif's contributions are recognized in her impact metrics, encouraging further community participation. (Requirement 1.2.13, 1.2.14)
  • The platform's database is more inclusive for users with specific dietary restrictions.

Mockups

use-case-4-food-database-search use-case-4-propose-food-item use-case-4-recipe-creation use-case-4-meal-planner

Clone this wiki locally