{
  "app": "Catering Order Platform",
  "description": "Order and event management platform for a catering business — staff create orders, configure event menus, assign vendors, and generate PDFs.",
  "version": "2026-04-23",
  "auth": {
    "login_url": "/login",
    "fields": {
      "username": "Contact number",
      "password": "Password",
      "submit": "Sign in"
    },
    "note": "The contact number field has a '+91' prefix pre-filled. Enter only the 10-digit number.",
    "success_indicator": "Sidebar appears showing user name and contact number; page shows 'Orders' heading."
  },
  "gotchas": [
    "Contact number field shows '+91' prefix — type only the 10-digit number, not the full country code.",
    "All routes except /login redirect to /login when unauthenticated.",
    "PDF button on the Events page is disabled until at least one event row checkbox is selected.",
    "Session filters (search, active tab, page number) persist across refreshes via sessionStorage. Use 'Reset filters' in the user menu (bottom-left avatar) to clear all.",
    "Some action buttons (Create Order, Add Vendor, Add Category, Add Item, Setup Vendors) are hidden for users without the required permission role.",
    "Param-based routes (/orders/:id, /events/:eventId/setup-menu, etc.) require navigating to the parent list page first — click any row to reach the detail page, then proceed.",
    "Modal submit button labels vary by mode: add mode uses 'Add Vendor' / 'Add event' / 'Create Template'; edit mode uses 'Update Vendor' / 'Update event' / 'Save Changes'.",
    "Order status transitions are limited: Estimated → Confirmed or Cancelled; Confirmed → Cancelled only; Cancelled has no further transitions."
  ],
  "areas": [
    {
      "id": "auth",
      "label": "Authentication",
      "url": "/.well-known/ai-guide/auth.json",
      "tasks": ["sign_in", "sign_out"]
    },
    {
      "id": "orders",
      "label": "Orders",
      "url": "/.well-known/ai-guide/orders.json",
      "tasks": [
        "browse_orders",
        "create_order",
        "view_order_details",
        "edit_order",
        "change_order_status",
        "generate_order_pdf",
        "add_event_to_order"
      ]
    },
    {
      "id": "events",
      "label": "Events",
      "url": "/.well-known/ai-guide/events.json",
      "tasks": ["browse_events", "generate_event_pdfs", "setup_event_menu", "manage_event_vendors"]
    },
    {
      "id": "master_data",
      "label": "Master Data (Menu, Materials, Vendors)",
      "url": "/.well-known/ai-guide/master_data.json",
      "tasks": [
        "add_menu_category", "add_menu_item", "edit_menu_item", "reorder_menu",
        "add_material_category", "add_material", "edit_material",
        "add_vendor", "edit_vendor"
      ]
    },
    {
      "id": "templates",
      "label": "Menu Templates",
      "url": "/.well-known/ai-guide/templates.json",
      "tasks": ["create_template", "edit_template", "manage_template_items", "duplicate_template"]
    },
    {
      "id": "settings",
      "label": "Settings",
      "url": "/.well-known/ai-guide/settings.json",
      "tasks": ["view_profile"]
    }
  ]
}
