{
  "ok": true,
  "app": "Carpentry Workshop System",
  "baseUrl": "http://localhost:4101",
  "auth": {
    "required": false,
    "note": "Set AI_AGENT_TOKEN before starting the server if you want to protect AI agent writes."
  },
  "endpoints": {
    "createOrder": "POST /api/agent/orders",
    "getContext": "GET /api/agent/context",
    "listOrders": "GET /api/orders",
    "updateOrder": "PATCH /api/orders/:id",
    "createSale": "POST /api/sales"
  },
  "allowedValues": {
    "status": [
      "new_lead",
      "qualified",
      "needs_photos",
      "inspection_scheduled",
      "quotation_needed",
      "quotation_sent",
      "deal_won",
      "in_progress",
      "completed",
      "lost_cancelled"
    ],
    "priority": [
      "low",
      "normal",
      "high",
      "urgent"
    ],
    "commonChannels": [
      "WhatsApp",
      "Facebook",
      "Phone",
      "Walk-in",
      "AI Agent"
    ],
    "commonProjectTypes": [
      "مطبخ",
      "غرفة نوم",
      "دولاب",
      "باب",
      "ترابيزة",
      "مكتبة",
      "وحدة حمام",
      "صيانة"
    ]
  },
  "orderJsonSchema": {
    "type": "object",
    "required": [
      "customerName"
    ],
    "properties": {
      "customerName": {
        "type": "string",
        "description": "اسم العميل"
      },
      "customerPhone": {
        "type": "string",
        "description": "رقم الهاتف"
      },
      "customerAddress": {
        "type": "string",
        "description": "العنوان"
      },
      "channel": {
        "type": "string",
        "examples": [
          "WhatsApp",
          "Facebook",
          "Phone",
          "Walk-in",
          "AI Agent"
        ]
      },
      "projectType": {
        "type": "string",
        "description": "نوع الشغل: مطبخ، دولاب، باب..."
      },
      "description": {
        "type": "string",
        "description": "تفاصيل الطلب كما قالها العميل"
      },
      "measurements": {
        "type": "string",
        "description": "المقاسات الخام أو المراجعة"
      },
      "status": {
        "type": "string",
        "enum": [
          "new_lead",
          "qualified",
          "needs_photos",
          "inspection_scheduled",
          "quotation_needed",
          "quotation_sent",
          "deal_won",
          "in_progress",
          "completed",
          "lost_cancelled"
        ]
      },
      "priority": {
        "type": "string",
        "enum": [
          "low",
          "normal",
          "high",
          "urgent"
        ]
      },
      "dueDate": {
        "type": "string",
        "format": "date"
      },
      "totalAmount": {
        "type": "number"
      },
      "depositAmount": {
        "type": "number"
      },
      "materialCost": {
        "type": "number"
      },
      "laborCost": {
        "type": "number"
      },
      "notes": {
        "type": "string"
      },
      "items": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            },
            "woodType": {
              "type": "string"
            },
            "dimensions": {
              "type": "string"
            },
            "quantity": {
              "type": "number"
            },
            "unitPrice": {
              "type": "number"
            },
            "notes": {
              "type": "string"
            }
          }
        }
      },
      "agent": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "conversationId": {
            "type": "string"
          },
          "confidence": {
            "type": "number"
          }
        }
      }
    }
  },
  "exampleRequest": {
    "customerName": "أحمد محمود",
    "customerPhone": "01000000000",
    "channel": "WhatsApp",
    "projectType": "مطبخ",
    "description": "مطبخ خشب MDF، وحدات علوية وسفلية، العميل طلب معاينة قبل التسعير النهائي.",
    "measurements": "طول الحائط 3.2 متر، ارتفاع 2.6 متر",
    "dueDate": "2026-07-15",
    "priority": "high",
    "totalAmount": 45000,
    "depositAmount": 5000,
    "notes": "تأكيد اللون بعد زيارة المعاينة",
    "agent": {
      "name": "sales-agent",
      "conversationId": "whatsapp-thread-123",
      "confidence": 0.92
    }
  }
}