{
  "apis": [
    {
      "method": "GET",
      "path": "/api/products/overview",
      "description": "Lấy tổng quan Catalog: total products, avg price, top product lines, gender breakdown."
    },
    {
      "method": "GET",
      "path": "/api/products/list",
      "description": "Lấy danh sách sản phẩm Performance kèm Smart Search Relevance. Hỗ trợ filter: gender, age, product_line, color, is_new."
    },
    {
      "method": "GET",
      "path": "/api/product/lookup",
      "description": "Truy xuất nhanh thông tin product detail (colors, sizes) để hiển thị trong Lead Popup theo chuẩn base_code."
    },
    {
      "method": "POST",
      "path": "/api/stock/check",
      "description": "Nhận base codes, expand qua StarRocks lấy đầy đủ sizes, fetch song song tồn kho từ Canifa Middleware ERP."
    },
    {
      "method": "GET",
      "path": "/api/agent/n8n/stock",
      "description": "N8N Proxy: Check tồn kho Canifa API đơn giản phục vụ Agent Flow."
    }
  ]
}