Skip to content

Scenario 7: Searching for and Proposing a Food Item

nuriba edited this page Oct 16, 2025 · 1 revision

Requirement Scenario: Searching for and Proposing a Food Item

Actor

Registered User: Arda (A health-conscious university student looking for affordable, nutritious food)

User Persona

  • Name: Arda
  • Situation: Arda is a university student who wants to maintain a healthy diet while staying within a limited budget. He is interested in tracking the nutritional content of foods and exploring new food options that fit his dietary preferences.
  • Goal: Find a nutritious food item in the database and, if missing, propose a new one with detailed nutritional values to help expand the platform's food catalog.

Preconditions

  1. Arda is logged into the Affordable & Healthy Eating Hub platform. (Requirement 1.7.2)
  2. The system contains at least 500 food items with nutritional details. (Requirement 1.1.1)
  3. Content Administrators or Community Moderators are available to review food item submissions. (Requirement 1.8.4)
  4. The food database supports searching and filtering functionality.

Main Flow

  1. Arda navigates to the Food Database section to search for nutritious grains.
  2. Arda searches for "Quinoa" in the food database by entering the exact name.
  3. The system displays the exact match for Quinoa, including its complete nutritional profile:
    • Food Name: Quinoa
    • Food Category: Grain
    • Calories: 120 kcal per 100g
    • Carbohydrates: 21g per 100g
    • Protein: 4g per 100g
    • Fat: 1.9g per 100g
    • Nutrition Score: 8.5/10.00 (Requirement 1.1.1)
  4. Arda views the nutrition score tooltip to understand how the 8.5/10.00 score was calculated using the formula. (Requirement 1.1.3)
  5. Arda sorts the food database results by protein content (highest to lowest) to compare quinoa with other high-protein grain options.
  6. Arda browses the sorted results and evaluates different grains based on their protein content and nutrition scores.
  7. Arda searches for "Teff" (a nutrient-dense Ethiopian grain he learned about) but does not find it in the database.
  8. Arda decides to propose Teff as a new food item to help expand the platform's offerings.
  9. Arda selects "Propose New Food Item" and accesses the submission form.
  10. Arda fills in the mandatory fields for the food item proposal:
    • Food Name: Teff
    • Food Category: Grain
    • Macronutrient Information (per 100g):
      • Calories: 367 kcal
      • Carbohydrates: 73g
      • Protein: 13g
      • Fat: 2.4g (Requirement 1.1.2.1)
  11. Arda adds optional micronutrient data to provide comprehensive nutritional information:
    • Iron: 7.6 mg per 100g
    • Calcium: 180 mg per 100g
    • Magnesium: 184 mg per 100g
    • Vitamin C: 0 mg per 100g (Requirement 1.1.2.2)
  12. Arda submits his proposal to moderators for review.
  13. The system marks the submission as "Pending Review" and displays this status to Arda.
  14. A Content Administrator accesses the moderation dashboard to review pending food item submissions. (Requirement 1.8.6)
  15. The moderator reviews the Teff submission, examining all provided nutritional data. (Requirement 1.8.4)
  16. The moderator verifies the nutritional data against reliable sources (USDA database, academic publications).
  17. The moderator approves the submission, adding Teff to the food database. (Requirement 1.8.4)
  18. The system automatically calculates the nutrition score for Teff using the formula:
    • FoodScore = 0.30 * ProteinZ + 0.30 * CarbQuality + 0.40 * NutrientBalance
    • The calculated score is 8.7/10.00 (Requirement 1.1.3)
  19. Arda receives a notification that his food item proposal for Teff has been approved and is now available in the database.
  20. Arda searches for Teff again and successfully finds it in the food database with complete nutritional information and calculated nutrition score.
  21. Arda's contribution is tracked in his personal dashboard, updating his impact metrics. (Requirement 1.2.14)
  22. Arda creates a recipe using Teff as a main ingredient, linking to its nutritional information. (Requirement 1.3.1, 1.3.2)

Outcome

  • Arda successfully found quinoa in the food database and compared it to other protein-rich grains using sorting functionality.
  • Arda viewed detailed nutrition scores with explanatory tooltips understanding how food quality is calculated. (Requirement 1.1.3)
  • Arda proposed Teff as a new food item with complete mandatory macronutrient data and optional micronutrient information.
  • A Content Administrator reviewed and approved the Teff submission, ensuring data quality. (Requirement 1.8.4)
  • The system automatically calculated a nutrition score for Teff, making it immediately useful to other users. (Requirement 1.1.3)
  • Teff is now available in the food database, expanding the platform's catalog with a nutrient-dense African grain.
  • Arda's contribution is recognized in his impact metrics, encouraging continued community participation. (Requirement 1.2.13, 1.2.14)
  • Other users can now search for, view, and use Teff in their recipes and meal plans.
  • The platform's food database is more comprehensive and inclusive, serving users with diverse cultural dietary preferences.
  • The moderation process ensured data accuracy while maintaining reasonable approval times. (Requirement 2.1.4)

Mockups

use-case-8-quinoa-search use-case-8-teff-proposal use-case-8-approval-notification

Clone this wiki locally