Nutritional Plans

You can combine Nutritional Plans with Daily Nutritional Goal, Recommended Daily Intake and Remaining Daily Intake to guide users toward their targets throughout the day.

Plan & Token Requirements

Feature available in the following LogMeal Plans:

Accessible by the following User Types:

What It Does

Nutritional Plans provide ready‑to‑use plan types (e.g., Balanced Diet, Weight Loss, Muscle Gain) and tools to assign them to users or simulate outcomes before assignment. Each plan automatically defines the Daily Nutritional Goals required to accomplish it. These include energy, macronutrients and, when available, micronutrients, all personalized from the user’s sex, age, weight, height and lifestyle/activity. Healthcare professionals (🔵 APIUserManager) can oversee multiple users and manage each user’s active plan.

✕

✕

When to Use It / Outcomes

• You want to kick‑start guidance with a structured plan that auto‑computes daily goals.
• You need to simulate a plan (e.g., weight objective) before assigning it.
• You want professional oversight to assign, update or remove a user’s plan.
• Output: JSON with plan definitions, assigned plans per user, creation/deletion acknowledgements, or simulation results.

Feature-Specific Details

• Available plan types: Balanced Diet, Weight Loss, Muscle Gain.
• Personalization inputs: user profile (sex, age, weight, height) and activity/lifestyle; some plans may accept target weight or goal timeline for simulation.
• Automatic daily goals: assigning a plan automatically creates or updates the Daily Nutritional Goals to match the plan requirements.
• Safety checks: simulations/assignments may flag unrealistic targets (e.g., outside healthy BMI bands).
• Localization: plan names and descriptions can be localized; use the language parameter where supported.

Related Endpoints

Use the following endpoints to discover, simulate and manage nutritional plans:

• GET /nutritional_plan/info → ⚫ 🔴 🔵 List available plan types and their required fields.
• GET /nutritional_plan/{user_id} → 🔵 🔴 Retrieve plans assigned to a specific user.
• POST /nutritional_plan → 🔵 🔴 Assign a new plan to a user (automatically defines their Daily Nutritional Goals).
• DELETE /nutritional_plan → 🔵 🔴 Delete a plan by its identifier.
• POST /nutritional_plan/simulate → 🔵 🔴 Simulate a plan and return personalized estimations before assignment.

Remember to check applicable request limitations inside each of the endpoints.

Typical Workflow

1. Discover plan types with GET /nutritional_plan/info.
2. Simulate outcomes via POST /nutritional_plan/simulate using the user profile (and target weight if applicable). This will allow the user to visualize the objectives before committing to a plan.
3. Assign the chosen plan using POST /nutritional_plan. This automatically sets the Daily Nutritional Goals required to accomplish the plan.
4. Review active plans with GET /nutritional_plan/{user_id} and remove old ones via DELETE /nutritional_plan.
5. Display daily goals & remaining intake sourced from the plan using your existing goals/history flows.