KitchenLens

Module 5 – Recipe Linking & Sharing

Version 1.0 Active ← Module 4

🎯 Module Overview

Primary Purpose: Build, link, and share consistent recipes across multiple kitchens with traceable versions, cost accuracy, and controlled local variations.

👑

Admin / Org Owner

Create, manage, share master recipes system-wide

👨‍🍳

Venue Manager / Head Chef

Import shared recipes, fork local versions

🧑‍🍳

Chef / Team Member

View, propose edits, duplicate recipes

👀

Staff / Viewer

View-only for prep and training

5
Workflow Stages
Multi
Venue Sharing
Tree
Hierarchy System
Auto
Cost Updates

🎯 User Goals

🔗

Build Linked Recipes

Create hierarchical recipes with components and sub-recipes

🌍

Share Across Venues

Consistent recipes across multiple kitchens with live sync

📊

Traceable Versions

Version history with cost tracking and GP accuracy

🏠

Controlled Variations

Fork recipes for local adaptations while maintaining links

🌳 Recipe Hierarchy System

🍽️ Dish Pan-Seared Salmon
↓
🧩 Components Lemon Butter Sauce, Herb Crust
↓
📋 Sub-Recipes Herb Mix, Compound Butter
↓
🥬 Ingredients Salmon fillet, Butter, Herbs, Lemon

Recipe Link Types:

🔗 Shared (Live Link) 🏠 Local Copy 🧩 Sub-recipe 🌍 Global Library

🔄 Workflow Stages

1

Create or Import

📝
  1. Open "Recipe Library" → Tap "+ New Recipe"
  2. Choose:
    • Create from Scratch
    • Import from Photo / PDF
  3. If importing → AI extracts: ingredients, method, yield, allergens
  4. System matches ingredients to Product Master
  5. User reviews and confirms matches
AI Import Manual Create
2

Build Structure & Link

🔗
  1. Add ingredients or existing sub-recipes (sauce, garnish, etc.)
  2. For each link, choose:
    • 🔗 Shared (live link)
    • 🏠 Local Copy
  3. Set yield and portion size
  4. Attach photos (prep + plating)
  5. Save as: "Component," "Prep Item," or "Dish"
Linking Hierarchy
3

Share / Fork / Duplicate

🌍
  1. Tap "Share" → Choose option:
    • Share within Organisation (live link)
    • Duplicate (Fork) for local variation
    • Export Snapshot (JSON / CSV / read-only link)
  2. When editing linked recipe → prompt: "Edit Master or Fork Copy?"
Sharing Forking
4

Versions & Updates

📜
  1. Each save creates version log (v1.1, v1.2) with: author, date, GP %, notes
  2. Managers compare versions (ingredients, cost, yield)
  3. System auto-recalculates parent recipes when costs change
  4. If GP variance > threshold → alert: "Review Cost Changes?"
Versioning Auto-Calc
5

Approve & Merge

✅
  1. HQ can approve venue forks
  2. Merge back to shared library
  3. New shared recipes appear under "Global Components"
  4. All venues receive update notification
Approval Sync

⚙️ System Logic & Architecture

🌳 Hierarchical Recipe Tree

  • Builds tree structure: Dish → Components → Sub-Recipes → Ingredients
  • Tracks lineage (parent / child IDs) for cascade updates
  • Maintains version history at each node
  • Supports circular dependency detection

🔄 Sync & Sharing Engine

  • Syncs shared recipes across venues within same org ID
  • Manages role-based permissions (edit / share / view)
  • Supports offline editing with queued sync
  • Conflict resolution when multiple edits occur

💰 Cascade Cost Calculation

Example: Ingredient Cost Update

1. Cost Change Detected

Butter: $8.50/kg → $9.20/kg (+8.2%)

↓
2. Update Sub-Recipes

Compound Butter: $2.15 → $2.32 (+7.9%)

↓
3. Update Components

Lemon Butter Sauce: $4.80 → $5.12 (+6.7%)

↓
4. Update Dishes

Pan-Seared Salmon: $12.50 → $12.82 (+2.6%)

↓
5. Alert Manager

GP% changed: 68% → 66.5% (−1.5%)

🚨 Smart Alerts & Triggers

  • GP variance alerts when threshold exceeded
  • Sends notifications to managers for review
  • Impact summary: "Editing Aioli affects 6 dishes"
  • Quiet alerts during service hours with "Review Later" option

📝 Audit Trail & History

  • Maintains complete audit trail (user, timestamp, affected recipes)
  • Version comparison with side-by-side diff view
  • Change attribution for accountability
  • Rollback capability to previous versions

🗄️ Data Inputs & Dependencies

📦 Product Master

  • Ingredient costs
  • Supplier data
  • Unit conversions
  • SKU mappings

📄 Invoice OCR Feed

  • Real-time cost updates
  • Price change detection
  • Automatic recalculation triggers

📚 Recipe Database

  • Existing recipes for linking
  • Shared library components
  • Version history
  • Lineage tracking

👤 User Roles & Permissions

  • Edit rights management
  • Share permissions
  • View-only access
  • Approval authority

📸 Media Uploads

  • Recipe photos (prep & plating)
  • PDF imports
  • AI image recognition
  • Storage management

⚕️ Allergen & Nutrition Data

  • Allergen metadata
  • Nutritional information
  • Dietary tags
  • Compliance tracking

🎨 UI Elements & Features

Main Interface Components

🌳
Recipe Tree View

Expand / collapse linked components with visual hierarchy

🔗
Link Type Icons

🔗 Shared / 🏠 Local / 🧩 Sub-recipe / 🌍 Global Library

💬
Share Dialog

Organisation / Public / Export options with permissions

📜
Version Timeline Drawer

Author, date, GP %, changes with compare view

⚠️
Impact Summary Popup

"Editing Aioli affects 6 dishes" with affected list

Status Badges & Indicators

Out-of-Date
Local Edit
Approved
Shared
Forked
Pending Review

Interactive Features

📊 Real-Time GP Bar

Live gross profit percentage at bottom of recipe editor

🔄
Version Compare View

Side-by-side ingredient and GP variance comparison

🎨 Drag-and-Drop Linking

Visual tree layout with drag components to link

🔀 Inline Fork Button

"Fork & Edit" appears when no edit rights

UX Design Guidelines

Visual Tree Layout

Drag-and-drop interface for linking components with clear hierarchy

Large Tap Zones

Mobile and tablet optimized with generous touch targets

Role Color Coding

Blue = editable, Grey = read-only, Purple = shared

Inline Fork Button

"Fork & Edit" button appears when no edit rights

Version Compare

Side-by-side view with ingredient and GP variance

Real-Time GP Display

Live gross profit bar at bottom of recipe editor

Quiet Service Alerts

Alerts display quietly during service with "Review Later"

Impact Warnings

Show affected dishes before editing shared components

Offline Capability

Edit recipes offline with automatic sync when online

📈 Complete Process Flow

Start Create / Import Recipe
↓
AI Processing Extract ingredients & method
↓
Build Structure Link components & sub-recipes
↓
Link Type?
🔗 Shared
→
Live Link
↓
🏠 Local
→
Copy
💰 Calculate Costs Auto-cascade through tree
↓
Share / Fork Organisation or local variation
↓
Version Control Track changes & history
↓
✅ Synced Available across organisation