Food Recipes Nutrition (FRN) platform - User manual

FOR NEW USERS - GETTING STARTED

Login and registration

Your first login:
- LOGIN using your existing Microsoft or Google account
- You are ready to start exploring the app, be assigned to a scope or request your own scope.

Manage your profile
- Login every time with the same Microsoft or Google account used for registration
- Open your user profile page by clicking your name on the top navigation menu
- Expand your profile details by clicking [LOGIN OPTIONS] button under your contact info
- Check your current login details. (These are provided by Microsoft or Google)
- Click [RESET SESSION] button to login with another user account
- Click [ACCOUNT SIGN OUT] to sign out from the app and from your Microsoft or Google account session. This is required only when you work on a shared computer, to prevent other users from accessing your account.

Switch between users
- You can switch between multiple users logged in on the same device, without signing out.
- Click RESET SESSION button on your user profile page and choose another Microsoft or Google account

LOGOUT
- When working on a shared computer is important to LOGOUT at the end of the session
- Open your profile page by clicking your name on the main navigation menu
- Expand your profile by clicking [LOGIN OPTIONS] button - Click [ACCOUNT SIGN OUT] button on the bottom of the page
- Note: By clicking [ACCOUNT SIGN OUT], you will sign out not only from FRN platform, but also from your Microsoft or Google account used for login.

Join your first team

What are scopes in FRN:
- Scopes are private workspaces dedicated for a team or project
- You won't be able to create foods or recipes, unless you are a member of one or multiple scopes
- You can either join an existing scope, or you can create your own
- The scope owners can invite other team members, and assign clients to their team

How to join an existing scope:
- You need to be accepted by the existing scope owner to join their team
- Open your profile page by clicking your name on the top navigation menu
- Identify your user Login ID from your profile page, under [LOGIN OPTIONS]
- Copy your Login ID code and send it to the owner of the scope you want to join
- Once the owner has added you to the scope, you will be able to see it on your profile page.

How to see your assigned scopes:
- From the top navigation menu go to your profile page by clicking your username on the top navigation menu
- You will see each assigned scope and your role. Only OWNERS and ADMINS can open and edit the scope.
- If you are invited as a GUEST you can only open foods and recipes, but you cannot save them.
- If you are invited as a MEMBER you can edit any food or recipe in the scope.

FOODS

View existing foods

Search and filter foods
- From the top navigation menu, click [FOODS], then select from drop-down list either [ALL FOODS], or a specific scope
- Foods will be displayed on a new page, 100 foods per page
- Change scope, by choosing from the corresponding drop-down filter options menus from the top-left page.
- This menu looks like FOODS/[selected scope]/[selected category]
- If results contain more pages you can move to the next page from the corresponding button
- Search food by name, type one or more keywords separated by space in the [I am looking for..] box, then click [SEARCH]

View food composition
- Click on the corresponding Food ID button from the list
- Food composition and details will open on a new page
- Available nutrients will be displayed ordered by nutrient group

Create and modify foods

Create a new food
- From the top navigation menu, click [FOODS], then select from drop-down list [CREATE FOOD]
- This will open a new page with a form for the new food. First, only the basic details are required, composition will be handled later on
- Select a scope, where you are invited as member, select food category, enter the desired food name then optional some notes with more details about the food
- Confirm by clicking [CREATE FOOD]

Edit food composition
- After the food is created you will have the options to edit the new food
- You can change the food name or category if you wish
- You can edit each nutrient value, add or delete nutrients by clicking [✎] button corresponding to the desired row.
- This will open a small window where you can operate the changes
- You can either add a new row, modify or delete the existing row.
- Nutrients are ordered by default based on the following groups:

Group ID Description
SOLIDS Total Solids and moisure
ENERGY Calculated Energy
PROTEINS Protein Components
FATS Fat Components
CARBS Carbohydrate Components
MINERALS Mineral Components
VITAMINS Vitamin Components
FATTYACIDS Fatty Acids
AMINOACIDS Aminoacids
ACIDS Organic Acids
OTHER Other Components
CONTAMINANTS Contaminants
CUSTOM Custom Components
- Save changes when ready by clicking [SAVE FOOD] button.

Build foods with AI

Create or edit food
- Follow the same steps described above to create a new food
- If the food is already created, you can open the details, and select [EDIT FOOD] at the bottom of the page.

Build Food with AI
- After the food is created you have the option to build the entire composition from scratch or update an existing food using the integrated powerful AI models
- First, review and change if necesary the food name and category
- Then edit Food notes by describing in detail the characteristics of your food. This will help the AI model to understand your requirements
- Save changes when ready by clicking [SAVE FOOD] button. - Click [BUILD WITH AI] button and confirm the request.
- A new screen will appear while waiting for the results. The AI will analyse the data you have provided and will search the web to find the relevant composition data from multiple sources.
Do not close or change the page until you receive the response, otherwise you will lose the results. This might take couple of minutes.
- When the results are ready the waiting screen will automatically close, and the results will automatically load for your food.
- Review the data, and adjust if necesary any nutrients or results.
- Save changes when ready, by clicking [SAVE FOOD] button to keep the results or click [Back To Food] to discard all the changes.
- Note: Although AI models are very powerful, and the results are astonishing, always check the data and adjust any inaccuracy as required
Each AI request will use one credit from your existing scope credits.

RECIPES

View existing recipes

Search and filter recipes
- From the top navigation menu, click [RECIPES], then select from drop-down list either [ALL RECIPES], or a specific scope
- Recipes will be displayed on a new page, 100 recipes per page
- Change scope, by choosing from the corresponding drop-down filter options menus from the top-left page.
- This menu looks like RECIPES/[selected scope]/[selected category]
- If results contain more pages you can move to the next page from the corresponding button
- Search recipe by name, type one or more keywords separated by space in the [I am looking for..] box, then click [SEARCH]

View recipe details
- Click on the corresponding Recipe ID button from the list
- Recipe details and steps will open on a new page
- Recipe steps are shown in a table containing the type of the step, the corresponding id and name, the quantity of the ingredient or the value for a process, any specific instructions and the retention profile
- Each recipe step can be either an ingredient (INGRED_G) or a process (PROCESS)
- For ingredient steps the id represents the corresponding food.
- Step value represents the quantity of the ingredient, for an ingredient step, or the value of the process with the corresponding unit of measure shown in the process id.
- Notes are optional and contain any specific instructions or observations for each step
- Retention profile take into account a specific set of nutrient retention factors for a given ingredient that suffers a specific process. For example heating the milk causes some vitamin losses, therefore their retention factors will be less than one.
- By default retention profile 'RET_0' does not take in consideration any loses. All the processes will show RET_0 profile as the nutrient losses are only applicable to ingredients.
- By clicking the id for any ingredient step, the food details will open in a new page, including the selected retention profile.

Create and modify recipes

Create a new recipe
- From the top navigation menu, click [RECIPES], then select from drop-down list [CREATE RECIPE]
- This will open a new page with a form for the new recipe. First, only the basic details are required, recipe steps will be handled later on
- Select a scope, where you are invited as member, select recipe category, enter the desired recipe name then optional some notes with more details about the recipe
- Confirm by clicking [CREATE RECIPE]
- Note: Any recipe will also create a new food with the same ID with the corresponding nutrients composition. This can be used as an ingredient for other recipes.

Edit recipe details
- After the recipe is created you will have the options to edit the details
- You can change the recipe name or category if you wish
- You can also fill in the serving size, which is the amount of the product that is usualy consumed by a person
- Steps are ordered based on the processing and addition order
- Each recipe must contain at least one ingredient steps
- You can edit each recipe step, add or delete steps by clicking [✎] button corresponding to the desired row.
- This will open a small window where you can operate the changes
- Each step can be either an ingredient step or process step
- Ingredients can be searched by name using one or more keywords
- Processes and retention profiles (explained above) can be selected from a drop-down list
- Confirm any step by clicking [MODIFY STEP] to overwrite existing row, [ADD STEP] to add as a new row or [DELETE STEP] to delete the row
- Recipe step rows can be dragged to change their order.
- Save all changes when ready by clicking [SAVE RECIPE] button.

Build recipes with AI

Create or edit recipe
- Follow the same steps described above to create a new recipe
- If the recipe is already created, you can open the details, and select [EDIT RECIPE] at the bottom of the page.

Build Recipe with AI
- After the recipe is created you have the option to build the entire composition from scratch or update an existing recipe using the integrated powerful AI models
- First, review and change if necesary the recipe name and category
- Then edit Recipe notes by describing in detail the characteristics of your recipe. This will help the AI model to understand your requirements
- Save changes when ready by clicking [SAVE RECIPE] button. - Click [BUILD WITH AI] button and confirm the request.
- A new screen will appear while waiting for the results. The AI will analyse the data you have provided and will search the web to find the relevant ingredients and processing steps from multiple sources.
Do not close or change the page until you receive the response, otherwise you will lose the results. This might take couple of minutes.
- When the results are ready the waiting screen will automatically close, and the results will automatically load for your recipe.
- Review the data, and adjust if necesary any ingredients or processing steps.
- Save changes when ready, by clicking [SAVE RECIPE] button to keep the results or click [Back To Recipe] to discard all the changes.
- If you want a different outcome, or to swap any ingredients, write the desired changes in the notes, save the recipe and run the AI request again
- Note: Although AI models are very powerful, and the results are astonishing, always check the data and adjust any inaccuracy as required
Each AI request will use one credit from your existing scope credits.

NUTRITION AND LABELS

Nutrition management page

Nutrition page details
- Open the recipe details page as shown above
- Click [VIEW NUTRITION] button at the bottom of the page
- The nutrition page will open with the following sections:
- Recipe details, ID, name, serving size and total recipe size
- Ingredients used in the recipe in the order of processing and their contribution
- Nutrition Information Panel showing the selected nutrients and their contribution
- Optimisation Panel showing the defined rules and limits.

Nutrition optimisation

Optimisation panel
- Open the nutrition page as above
- Click [OPTIMISATION PANEL] to expand
- Edit each rule, add or remove rules
- Component - Select either INGRED_G for overall quantity or specific nutrient
- From ingredients - Select one or more ingredients affected by the rule. Press Ctrl key to select multiple ingredients.

Run Optimisation
- Open the nutrition page as above
- Edit optimisation rules as required and [SAVE RECIPE] to update any changes.
- Click [OPTIMISE] to perform quick classic optimisation, or click [OPTIMISE WITH AI] for advanced AI-Assisted optimisation based on your rules and any additional notes
- A new screen will appear while waiting for the results. The optimisation tool or AI models will analyse the data you have provided and will try to find the best solution.
- Do not close or change the page until you receive the response, otherwise you will lose the results. This might take couple of minutes.
- When the results are ready the waiting screen will automatically close, and the results will automatically load for your recipe.
- Review the data, and adjust if necesary.
- Save changes when ready, by clicking [SAVE RECIPE] button to keep the results or click [Back To Recipe] to discard all the changes.
- Note: Classic optimisation is fast and won't use any credits, but is limited and requires a very well defined set of rules.
AI optimisation is way more powerful, can resolve very complicated problems, and will give you feedback when conditions cannot be satisfied, suggesting possible changes in the rules or recipe. Although the results are astonishing, always check the data and adjust any inaccuracy as required
Each AI request will use one credit from your existing scope credits.

Label management

Label page details
- Open the nutrition page as above
- Click [VIEW LABEL] button at the bottom of the page
- The label page will open with the following sections:
- General information - Ingredient list ordered by quantity from highest to lowest
- Nutrition Information Panel showing the selected nutrients
- Edit the notes you wish to appear on the label
- Edit the names of the ingredients and nutrients as you wish to appear on the label
- Click [UPDATE LABEL] button to generate the final label.
- Review and repeat editing if required.
- Download the label as image or copy the content and paste it into another document

SCOPE OWNERS AND ADMINS

Create and manage your scope

Request a new scope
- Contact us by email to request a new scope. This will help us understand your needs give you the best solution
- Email us at admin@smbidigital.com.au
- Let us know your preferred scope name and how many licenses you need
Each license will give you extra AI credits and a vacant spot for any potential team member you will decide to invite later on
- Provide us with following contact details:
- First name
- Last Name
- Your email address used for login
- Contact email address if different from the one used for login
- Contact phone number
- Postal address (street name and number, city, post code)
- Business name if applicable
- We will get back to you and activate your new scope.
- You will become the default owner for your new scope
- Note: You must agree with our TERMS OF SERVICE and PRIVACY POLICY
After we activate your scope we will send you the first invoice which you must pay within 14 days.

Manage your scope
- Your can view and access your scopes from your profile page
- From the top navigation menu go to your profile page by clicking your username.
- You will see each assigned scope and your role.
- If you are the OWNER or ADMIN you can open the scope by clicking the id
- The scope page contains the scope contact details, and the existing team members
- You can request changing your contact details by sending us an email.

Manage your team

Add a new team member
- Open your scope page as described above
- If you have available licenses you can add a new team member to your scope
- First ask the Login ID from the new members. They can see their Login ID in their profile page as shown at the begining of the guide
- Click [✎] button next to the Team members title
- Paste the Login ID for the new user and confirm.
- If the user is found will be added to the Team Members list.
- Any new member will be added by default as a GUEST.

Manage team member roles
- Open your scope page as described above
- Click [MANAGE] button corresponding to a team member
- Change the role from the drop-down list and update
- The available roles are:

GUEST Can only view existing foods and recipes
Cannot create or modify foods or recipes
MEMBER Can create or modify any food or recipe in the scope
ADMIN Can open the scope page but cannot modify team members
OWNER Can manage team members, custom components and processes

Remove team member
- Open your scope page as described above
- Click [MANAGE] button corresponding to a team member
- Copy the user id for that member
- Click [REMOVE MEMBER] paste the user id and confirm
- The member will be removed and the spot will become vacant.

Manage custom components and processes

Default and Custom Components (Nutrients)
- Open the scope page as described above
- Click [COMPONENTS] button at the bottom of the page
- A new page will open with al standard components
- Add custom components if required by clicking [+] button at the bottom of the list
- Fill in the details and confirm
- Your new component will be added under CUSTOM group
- Note: You can edit or delete your custom components, but this will affect any foods and recipes that are using them.

Default and Custom Processes
- Open the scope page as described above
- Click [PROCESSES] button at the bottom of the page
- A new page will open with al standard processes
- Add custom processes if required by clicking [+] button at the bottom of the list
- Fill in the details and confirm
- Your new component will be added under CUSTOM group
- Note: You can edit or delete your custom processes, but this will affect any recipes that are using them.