{ "info": { "_postman_id": "maint-full-backend-2026", "name": "Maintenance Full Backend AYA", "description": "مجموعة شاملة لاختبار جميع واجهات API الخلفية للصيانة\n\nUS-001: استلام طلب تسعير (وقائي)\nUS-002: بلاغ عطل (طلب تصحيحي)\nUS-005: إنشاء عقد صيانة من عرض معتمد\nUS-006: تنفيذ زيارة الاستلام\nUS-007: إنشاء وإدارة خطة الزيارات الدورية\nUS-008: تنفيذ زيارة وقائية\nUS-014: مراجعة واعتماد تقرير الزيارة\nUS-015: زيارة طوارئ\nUS-017: خدمة غير مجدولة", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "variable": [ { "key": "base_url", "value": "http://localhost:8000/api/v1" }, { "key": "token", "value": "YOUR_TOKEN_HERE" }, { "key": "customer_id", "value": "1" }, { "key": "contract_id", "value": "1" }, { "key": "project_id", "value": "1" }, { "key": "request_id", "value": "1" }, { "key": "visit_id", "value": "1" }, { "key": "report_id", "value": "1" }, { "key": "asset_id", "value": "1" }, { "key": "technical_offer_id", "value": "1" }, { "key": "price_offer_id", "value": "1" }, { "key": "recurrence_rule_id", "value": "1" }, { "key": "supply_order_id", "value": "1" }, { "key": "technician_id", "value": "1" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] }, "item": [ { "name": " Auth - تسجيل الدخول", "item": [ { "name": "Login - تسجيل دخول", "event": [ { "listen": "test", "script": { "exec": [ "var jsonData = pm.response.json();", "if (jsonData.data && jsonData.data.token) {", " pm.collectionVariables.set('token', jsonData.data.token);", " console.log('Token saved: ' + jsonData.data.token);", "}" ], "type": "text/javascript" } } ], "request": { "method": "POST", "url": "{{base_url}}/auth/login", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"phone_or_email\": \"admin@admin.com\",\n \"password\": \"admin\"\n}" } } } ] }, { "name": "US-001: طلبات التسعير - CRUD كامل", "description": "جميع عمليات CRUD لطلبات تسعير الصيانة الوقائية مع كافة الحقول", "item": [ { "name": "عرض جميع الطلبات (مع pagination)", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests?per_page=15&page=1" } }, { "name": "عرض الطلبات النشطة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/list/active" } }, { "name": "إحصائيات الطلبات", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/statistics" } }, { "name": "تصفية حسب الحالة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/status/new" } }, { "name": "تصفية حسب الأولوية", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/priority/high" } }, { "name": "تصفية حسب العميل", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/customer/{{customer_id}}" } }, { "name": "بحث العملاء", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/search/customers?q=test" } }, { "name": "عقد العميل", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/customer/{{customer_id}}/contract" } }, { "name": "مواقع العميل", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/customer/{{customer_id}}/locations" } }, { "name": "جهات اتصال العميل", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/customer/{{customer_id}}/contacts" } }, { "name": "قائمة المشرفين", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/administrators" } }, { "name": "إنشاء طلب تسعير (حفظ كمسودة)", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": {{customer_id}},\n \"customer_name\": \"شركة النور الطبية\",\n \"location_id\": {{location_id}},\n \"contact_id\": {{contact_id}},\n \"source\": \"هاتف\",\n \"technical_supervisor_id\": {{technical_supervisor_id}},\n \"is_percentage\": false,\n \"request_type\": \"preventive\",\n \"priority\": \"medium\",\n \"status\": \"draft\",\n \"has_active_contract\": false,\n \"system_types\": [\n \"HVAC\",\n \"generators\"\n ],\n \"has_chiller\": true,\n \"approximate_unit_count\": 20,\n \"visit_frequency\": \"monthly\",\n \"consumables_required\": true,\n \"consumable_types\": [\n \"فلاتر\",\n \"زيوت\",\n \"شحوم\"\n ],\n \"scope_of_work\": \"صيانة شاملة لجميع وحدات HVAC مع متابعة أسبوعية\",\n \"scope_of_work_ids\": [1, 2],\n \"has_attachments\": true,\n \"attachments\": [\n {\n \"temporary_folder\": \"{{temp_attachment_folder}}\"\n }\n ],\n \"notes\": \"تم استلام الطلب عبر الهاتف - العميل بانتظار العرض\",\n \"save_as_draft\": true,\n \"is_percentage\": false,\n \"scope_of_work_details\": \"تنظيف الفلاتر، فحص الضواغط، اختبار الأحمال الكهربائية\"\n}" } } }, { "name": "إنشاء طلب تسعير (حفظ وإرسال للمشرف)", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": {{customer_id}},\n \"customer_name\": \"مجمع الأفق الإداري\",\n \"location_id\": {{location_id}},\n \"contact_id\": {{contact_id}},\n \"source\": \"واتساب\",\n \"technical_supervisor_id\": {{technical_supervisor_id}},\n \"is_percentage\": false,\n \"request_type\": \"preventive\",\n \"priority\": \"high\",\n \"status\": \"new\",\n \"has_active_contract\": false,\n \"system_types\": [\n \"HVAC\",\n \"elevators\"\n ],\n \"has_chiller\": false,\n \"approximate_unit_count\": 12,\n \"visit_frequency\": \"quarterly\",\n \"consumables_required\": true,\n \"consumable_types\": [\n \"فلاتر\",\n \"شحوم\"\n ],\n \"scope_of_work\": \"صيانة شاملة لمبنى إداري متعدد الأدوار\",\n \"scope_of_work_ids\": [3],\n \"notes\": \"العميل طلب إرسال الطلب فوراً للمشرف الفني\",\n \"save_as_draft\": false,\n \"requested_at\": \"2026-02-22 10:00:00\"\n}" } } }, { "name": "إنشاء طلب مع عميل جديد", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/create-with-client", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_name\": \"عميل جديد\",\n \"phone_number\": \"0500000000\",\n \"location\": \"الرياض - حي النزهة\",\n \"request_type\": \"preventive\",\n \"priority\": \"medium\",\n \"system_types\": [\n \"HVAC\"\n ],\n \"approximate_unit_count\": 5,\n \"visit_frequency\": \"quarterly\",\n \"notes\": \"عميل جديد - أول تواصل\"\n}" } } }, { "name": "إنشاء عرض فني وقائي من الطلب", "description": "POST /requests/{request}/create-technical-offer\nإنشاء عرض فني جديد مرتبط بطلب التسعير الوقائي\n\nالهدف: تحويل الطلب مباشرة لصفحة إنشاء عرض فني (وليس عرض سعر)", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/create-technical-offer", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"technician_id\": {{technician_id}},\n \"supervisor_id\": {{technical_supervisor_id}},\n \"notes\": \"إنشاء عرض فني بناءً على طلب التسعير الوقائي\",\n \"estimated_duration\": \"3 أيام\",\n \"priority\": \"medium\",\n \"scope_summary\": \"صيانة وقائية شاملة لـ 20 وحدة HVAC + 5 مولدات\",\n \"required_tools\": [\"مجموعة فحص ضغط\", \"أدوات قياس كهربائية\", \"مجموعة تنظيف فلاتر\"],\n \"special_requirements\": \"الوصول إلى السطح مطلوب - تنسيق مع أمن المبنى\"\n}" } } }, { "name": "إنشاء عرض سعر من تفاصيل الطلب", "description": "POST /price-offers/from-breakdown/{request}\nإنشاء عرض سعر بناءً على تفاصيل الطلب مباشرة\n\nالهدف: تحويل الطلب مباشرة لصفحة إنشاء عرض سعر مع بيانات مبدئية من الطلب", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/from-breakdown/{{request_id}}", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": {{customer_id}},\n \"location_id\": {{location_id}},\n \"request_id\": {{request_id}},\n \"contract_type\": \"preventive\",\n \"visit_frequency\": \"quarterly\",\n \"estimated_visits_per_year\": 4,\n \"system_types\": [\"HVAC\", \"generators\"],\n \"approximate_unit_count\": 20,\n \"has_chiller\": true,\n \"consumables_required\": true,\n \"consumable_types\": [\"فلاتر\", \"زيوت\", \"شحوم\"],\n \"scope_of_work\": \"صيانة شاملة لجميع وحدات HVAC مع متابعة أسبوعية\",\n \"initial_pricing\": {\n \"chiller_visit_cost\": 1500,\n \"package_visit_cost\": 800,\n \"is_consumables_included\": true,\n \"consumables_cost\": 5000,\n \"tax_percentage\": 15,\n \"payment_method\": \"quarterly\"\n },\n \"notes\": \"عرض سعر مبدئي بناءً على تفاصيل الطلب\",\n \"status\": \"pending_pricing\"\n}" } } }, { "name": "عرض تفاصيل طلب", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/{{request_id}}" } }, { "name": "[تم التعطيل] عرض التسلسل الهرمي الكامل", "description": "GET /requests/{request}/hierarchy\n⚠️ غير جاهز حالياً - الطلب الوقائي لا يملك هيكلية كاملة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/{{request_id}}/hierarchy" } }, { "name": "[تم التعطيل] عرض أصول الطلب", "description": "GET /requests/{request}/assets\n⚠️ غير جاهز حالياً - الطلب الوقائي لا يملك أصول افتراضياً", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/{{request_id}}/assets" } }, { "name": "[تم التعطيل] عرض زيارات الطلب", "description": "GET /requests/{request}/visits\n⚠️ غير جاهز حالياً - الطلب الوقائي لا يملك زيارات افتراضياً", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/{{request_id}}/visits" } }, { "name": "[تم التعطيل] عرض تقارير الطلب", "description": "GET /requests/{request}/reports\n⚠️ غير جاهز حالياً - الطلب الوقائي لا يملك تقارير افتراضياً", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/{{request_id}}/reports" } }, { "name": "[تم التعطيل] عرض مرفقات الطلب", "description": "GET /requests/{request}/attachments\n⚠️ يحتاج مراجعة آلية المرفقات مع أنس", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/{{request_id}}/attachments" } }, { "name": "تعديل طلب التسعير (جميع الحقول)", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/requests/{{request_id}}", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": 1,\n \"customer_name\": \"اسم العميل المحدث\",\n \"location_id\": 1,\n \"contact_id\": null,\n \"source\": \"بريد\",\n \"technical_supervisor_id\": 1,\n \"is_percentage\": true,\n \"request_type\": \"preventive\",\n \"priority\": \"high\",\n \"has_active_contract\": false,\n \"notes\": \"ملاحظات محدثة\",\n \"system_types\": [\n \"HVAC\",\n \"مصاعد\"\n ],\n \"has_chiller\": true,\n \"approximate_unit_count\": 20,\n \"visit_frequency\": \"monthly\",\n \"consumables_required\": true,\n \"consumable_types\": [\n \"فلاتر\",\n \"شحوم\"\n ],\n \"scope_of_work\": \"نطاق عمل محدث\",\n \"scope_of_work_ids\": [],\n \"impact_level\": \"P2\",\n \"is_unscheduled\": false,\n \"closure_reason\": null\n}" } } }, { "name": "تحديث حالة الطلب", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/requests/{{request_id}}/status", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"awaiting_report_approval\",\n \"change_reason\": \"تم اعتماد الطلب وجدولة التنفيذ\"\n}" } } }, { "name": "[تم الحذف] تعيين فني", "description": "POST /requests/{request}/technician\n❌ تم حذف هذا الـ endpoint - التعيين يتم عبر changeStatus", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/technician", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"technician_id\": 1\n}" } } }, { "name": "تعيين مشرف", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/supervisor", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"supervisor_id\": 1\n}" } } }, { "name": "تعيين موظف", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/staff", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"staff_id\": 1\n}" } } }, { "name": "توزيع جماعي", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/bulk-assign", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"request_ids\": [\n 1,\n 2,\n 3\n ],\n \"administrator_id\": 1\n}" } } }, { "name": "إقرار استلام الطلب", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/acknowledge", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "تحويل الطلب إلى عرض فني", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/convert-to-quote", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"description\": \"عرض سعر لصيانة أنظمة التكييف\",\n \"contract_type\": \"preventive\",\n \"visit_count\": 4,\n \"visit_frequency\": \"quarterly\"\n}" } } }, { "name": "[تم الحذف] إغلاق طلب", "description": "POST /requests/{request}/close\n❌ تم حذف هذا الـ endpoint - الإغلاق له سيناريو مختلف سيضاف لاحقاً", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/close", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"closure_reason\": \"تم إنهاء الطلب\",\n \"notes\": \"الطلب مغلق\"\n}" } } }, { "name": "[تم الحذف] حذف طلب (حذف ناعم)", "description": "DELETE /requests/{request}\n❌ تم حذف هذا الـ endpoint - الحذف الناعم سيضاف لاحقاً", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/requests/{{request_id}}", "header": [ { "key": "Accept", "value": "application/json" } ] } }, { "name": "[تم الحذف] استعادة طلب محذوف", "description": "POST /requests/{request}/restore\n❌ تم حذف هذا الـ endpoint - استعادة الطلبات المحذوفة سيضاف لاحقاً", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/restore", "header": [ { "key": "Accept", "value": "application/json" } ] } }, { "name": "حذف نهائي", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/force-delete", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "رفع مرفق", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/attachments", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"attachments\": [\n {\n \"temporary_folder\": \"temp_folder_uuid\"\n }\n ]\n}" } } }, { "name": "حذف مرفق", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/requests/{{request_id}}/attachments/1" } } ] }, { "name": "US-002: بلاغ عطل (طلب تصحيحي) - CRUD كامل", "description": "إنشاء وتعديل وحذف بلاغات الأعطال والطلبات التصحيحية", "item": [ { "name": "عرض جميع البلاغات", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests?per_page=15&request_type=corrective" } }, { "name": "عرض البلاغات النشطة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/list/active" } }, { "name": "تصفية حسب الحالة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/status/new" } }, { "name": "US-002: إنشاء بلاغ عطل مربوط بتقرير زيارة", "description": "POST /requests\nيُنشئ بلاغ عطل تصحيحي مربوط بتقرير زيارة — يسحب تلقائياً:\n- وصف العطل من التقرير\n- الأصل المعطل من التقرير\n- الأصناف/قطع الغيار من التقرير\nملاحظة: الأصول تُختار من النظام بـ asset_id ولا يتم إضافة جديدة", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": {{customer_id}},\n \"customer_name\": \"مستشفى النور الطبي\",\n \"location_id\": 3,\n \"source\": \"هاتف\",\n \"technical_supervisor_id\": 1,\n \"request_type\": \"corrective\",\n \"priority\": \"high\",\n \"has_active_contract\": false,\n \"is_unscheduled\": true,\n \"impact_level\": \"P2\",\n \"system_types\": [\"HVAC\"],\n \"visit_report_id\": {{report_id}},\n \"notes\": \"بلاغ مربوط بتقرير زيارة — البيانات تُسحب تلقائياً\"\n}" } } }, { "name": "إنشاء بلاغ عطل (تصحيحي)", "event": [ { "listen": "prerequest", "script": { "exec": [ "// Set all required variables with default values", "pm.environment.set('customer_id', '1');", "pm.environment.set('location_id', '1');", "pm.environment.set('contract_id', '1');", "pm.environment.set('asset_id', '1');", "// US-006: Handover visit variables", "pm.environment.set('project_id', '1');", "pm.environment.set('handover_visit_id', '4');", "pm.environment.set('handover_report_id', '2');", "// Report variables", "pm.environment.set('report_id', '1');", "// Asset type IDs from AssetTypesSeeder", "pm.environment.set('chiller_type_id', '1');", "pm.environment.set('package_type_id', '2');", "pm.environment.set('ahu_type_id', '3');", "pm.environment.set('pump_type_id', '4');", "pm.environment.set('generator_type_id', '5');", "pm.environment.set('elevator_type_id', '6');", "pm.environment.set('fire_type_id', '7');", "pm.environment.set('cctv_type_id', '8');", "// Other variables", "pm.environment.set('technician_id', '1');", "pm.environment.set('visit_id', '4');", "// Debug logging", "console.log('=== Postman Variables Debug ===');", "console.log('chiller_type_id: ' + pm.environment.get('chiller_type_id'));", "console.log('package_type_id: ' + pm.environment.get('package_type_id'));", "console.log('handover_visit_id: ' + pm.environment.get('handover_visit_id'));", "console.log('visit_id: ' + pm.environment.get('visit_id'));", "console.log('================================');" ], "type": "text/javascript" } } ], "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": {{customer_id}},\n \"customer_name\": \"شركة الرياض للتطوير العقاري\",\n \"location_id\": {{location_id}},\n \"contact_id\": null,\n \"source\": \"direct\",\n \"technical_supervisor_id\": 1,\n \"is_percentage\": false,\n \"request_type\": \"corrective\",\n \"priority\": \"critical\",\n \"reported_issue\": \"عطل في نظام التكييف المركزي - توقف كامل في الشيلر\",\n \"has_active_contract\": true,\n \"maintenance_contract_id\": {{contract_id}},\n \"notes\": \"العميل يطلب تدخل عاجل\",\n \"save_as_draft\": false,\n \"impact_level\": \"P1\",\n \"is_unscheduled\": true,\n \"system_types\": [\"HVAC\"],\n \"approximate_unit_count\": 3,\n \"assets\": [\n { \"asset_id\": {{asset_id}} }\n ]\n}" } } }, { "name": "إنشاء بلاغ كمسودة", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": {{customer_id}},\n \"customer_name\": \"شركة الرياض للتطوير العقاري\",\n \"location_id\": {{location_id}},\n \"source\": \"واتساب\",\n \"request_type\": \"corrective\",\n \"priority\": \"high\",\n \"reported_issue\": \"تسرب مياه من وحدة التكييف\",\n \"save_as_draft\": true,\n \"system_types\": [\"HVAC\"],\n \"assets\": [\n { \"asset_id\": {{asset_id}} }\n ]\n}" } } }, { "name": "عرض تفاصيل بلاغ", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/{{request_id}}" } }, { "name": "عرض التسلسل الهرمي", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/{{request_id}}/hierarchy" } }, { "name": "تعديل البلاغ", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/requests/{{request_id}}", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": {{customer_id}},\n \"customer_name\": \"شركة الرياض للتطوير العقاري\",\n \"location_id\": {{location_id}},\n \"source\": \"بريد\",\n \"request_type\": \"corrective\",\n \"priority\": \"critical\",\n \"reported_issue\": \"عطل في نظام التكييف - تحديث الوصف\",\n \"has_active_contract\": true,\n \"notes\": \"تم التأكد من العطل\",\n \"impact_level\": \"P1\",\n \"is_unscheduled\": true,\n \"system_types\": [\"HVAC\"],\n \"approximate_unit_count\": 3,\n \"assets\": [\n { \"asset_id\": {{asset_id}} }\n ]\n}" } } }, { "name": "تحديث حالة البلاغ", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/requests/{{request_id}}/status", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"assigned\",\n \"change_reason\": \"تم تعيين فني\"\n}" } } }, { "name": "إقرار استلام البلاغ", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/acknowledge", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "[تم الحذف] تعيين فني للبلاغ", "description": "POST /requests/{request}/technician\n❌ تم حذف هذا الـ endpoint - التعيين يتم عبر changeStatus", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/technician", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"technician_id\": 1\n}" } } }, { "name": "تعيين مشرف", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/supervisor", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"supervisor_id\": 1\n}" } } }, { "name": "إنشاء عرض تصحيحي من البلاغ", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/from-breakdown/{{request_id}}", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": {{customer_id}},\n \"location_id\": {{location_id}},\n \"request_id\": {{request_id}},\n \"contract_type\": \"corrective\",\n \"estimated_repair_duration\": 2,\n \"repair_duration_unit\": \"days\",\n \"needs_asset_stoppage\": true,\n \"warranty_terms\": \"ضمان 90 يوم على قطع الغيار\",\n \"scope_of_work\": \"إصلاح العطل وتغيير القطع التالفة\",\n \"notes\": \"عرض سعر تصحيحي بناءً على البلاغ\",\n \"status\": \"pending_pricing\"\n}" } } }, { "name": "إغلاق البلاغ", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/close", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"تم إصلاح العطل بنجاح\"\n}" } } }, { "name": "حذف بلاغ (ناعم)", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/requests/{{request_id}}" } }, { "name": "استعادة بلاغ", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/restore", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "حذف نهائي", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/force-delete", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } } ] }, { "name": "US-003: عروض أسعار الصيانة - CRUD + Versioning + PDF", "description": "جميع عمليات CRUD لعروض الأسعار مع إدارة النسخ وإنشاء PDF", "item": [ { "name": "عرض جميع عروض الأسعار", "request": { "method": "GET", "url": "{{base_url}}/maintenance/price-offers?per_page=15" } }, { "name": "عرض أحدث نسخة فقط", "request": { "method": "GET", "url": "{{base_url}}/maintenance/price-offers/latest-versions?per_page=15" } }, { "name": "العروض المعلقة للتسعير", "request": { "method": "GET", "url": "{{base_url}}/maintenance/price-offers/pending-pricing" } }, { "name": "إنشاء عرض سعر وقائي (US-003)", "description": "POST /price-offers/preventive/{technicalOffer}\nيُنشئ عرض سعر وقائي كامل من عرض فني معتمد مع بيانات التسعير وشروط التعاقد.\nSection 1 (بيانات العرض الفني) تُسحب تلقائياً.\nSection 2 (التسعير) + Section 3 (شروط التعاقد) يملأها مسؤول المبيعات.\nstatus = pending_pricing (مسودة) أو pending_approval (إرسال للاعتماد)", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/preventive/{{technical_offer_id}}", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"chiller_visit_cost\": 1500,\n \"package_visit_cost\": 800,\n \"is_consumables_included\": true,\n \"consumables_cost\": 5000,\n \"consumable_types\": [\"فلاتر\", \"زيوت\", \"أحزمة\"],\n \"discount_percentage\": 5,\n \"tax_percentage\": 15,\n \"payment_method\": \"quarterly\",\n \"payment_schedule\": [\n {\"amount\": 12500, \"due_date\": \"2026-04-01\"},\n {\"amount\": 12500, \"due_date\": \"2026-07-01\"},\n {\"amount\": 12500, \"due_date\": \"2026-10-01\"},\n {\"amount\": 12500, \"due_date\": \"2027-01-01\"}\n ],\n \"offer_validity_date\": \"2026-03-15\",\n \"inclusions\": \"صيانة وقائية دورية شاملة لجميع وحدات التكييف\\nفحص وتنظيف الفلاتر والمكثفات\\nقياس ضغط الغاز والتيار الكهربائي\",\n \"exclusions\": \"قطع الغيار الرئيسية (ضواغط، مراوح)\\nأعطال ناتجة عن سوء الاستخدام\\nالتمديدات الكهربائية\",\n \"contract_terms\": \"مدة العقد سنة واحدة قابلة للتجديد\\nالدفع ربع سنوي مقدم\\nإشعار قبل 30 يوم لعدم التجديد\",\n \"spare_parts_policy\": \"المستهلكات على حساب الشركة، قطع الغيار الرئيسية على حساب العميل\",\n \"status\": \"pending_pricing\"\n}" } } }, { "name": "إنشاء عرض سعر من عرض فني (بدون بيانات تسعير)", "description": "POST /price-offers/from-technical-offer/{technicalOffer}\nيُنشئ هيكل عرض سعر فارغ بناءً على العرض الفني — يحتاج تعبئة التسعير لاحقاً عبر PUT", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/from-technical-offer/{{technical_offer_id}}", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "إنشاء عرض تصحيحي من بلاغ", "description": "POST /price-offers/from-breakdown/{request}\nيُنشئ عرض سعر تصحيحي مع سحب قطع الغيار من التقرير", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/from-breakdown/{{request_id}}", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": {{customer_id}},\n \"location_id\": {{location_id}},\n \"request_id\": {{request_id}},\n \"contract_type\": \"corrective\",\n \"estimated_repair_duration\": 2,\n \"repair_duration_unit\": \"days\",\n \"needs_asset_stoppage\": true,\n \"warranty_terms\": \"ضمان 90 يوم على قطع الغيار\",\n \"scope_of_work\": \"إصلاح العطل وتغيير القطع التالفة\",\n \"notes\": \"عرض سعر تصحيحي بناءً على البلاغ\",\n \"status\": \"pending_pricing\"\n}" } } }, { "name": "عرض تفاصيل عرض السعر", "request": { "method": "GET", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}" } }, { "name": "تاريخ النسخ (Versions)", "request": { "method": "GET", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/versions" } }, { "name": "مقارنة نسختين", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/compare-versions", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"compare_with_version\": 1\n}" } }, "description": "POST /price-offers/{offer}/compare-versions\nمقارنة النسخة الحالية مع نسخة أخرى" }, { "name": "تحديث بيانات التسعير (جميع الحقول)", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"visit_cost\": 500,\n \"chiller_visit_cost\": 800,\n \"package_visit_cost\": 400,\n \"corrective_visit_cost\": 600,\n \"is_consumables_included\": true,\n \"consumables_cost\": 1500,\n \"discount_amount\": 200,\n \"discount_percentage\": 5,\n \"spare_parts_policy\": \"حسب الحاجة - يتم التسعير بشكل منفصل\",\n \"tax_percentage\": 15,\n \"offer_validity_date\": \"2026-06-30\",\n \"payment_method\": \"quarterly\",\n \"payment_schedule\": [\n {\n \"amount\": 5000,\n \"due_date\": \"2026-04-01\"\n },\n {\n \"amount\": 5000,\n \"due_date\": \"2026-07-01\"\n },\n {\n \"amount\": 5000,\n \"due_date\": \"2026-10-01\"\n },\n {\n \"amount\": 5000,\n \"due_date\": \"2027-01-01\"\n }\n ],\n \"expected_repair_duration\": 3,\n \"repair_duration_unit\": \"days\",\n \"needs_asset_stoppage\": false,\n \"warranty_terms\": \"ضمان سنة على جميع الأعمال\",\n \"parts\": [\n {\n \"part_name\": \"فلتر هواء مركزي\",\n \"part_number\": \"AF-2024-001\",\n \"brand\": \"Carrier\",\n \"asset_unit_number\": \"AC-001\",\n \"quantity\": 4,\n \"unit_cost\": 150\n },\n {\n \"part_name\": \"حزام مروحة\",\n \"part_number\": \"FB-2024-002\",\n \"brand\": \"Daikin\",\n \"asset_unit_number\": \"AC-002\",\n \"quantity\": 2,\n \"unit_cost\": 85\n }\n ]\n}" } } }, { "name": "إضافة تكلفة إضافية", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/costs", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"cost_type\": \"transportation\",\n \"cost_name\": \"تكلفة النقل والتنقل\",\n \"cost_value\": 500,\n \"show_in_offer\": true,\n \"order\": 1\n}" } } }, { "name": "حذف تكلفة إضافية", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/costs/1" } }, { "name": "حفظ كمسودة", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/save-draft", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "إرسال للاعتماد (Finalize)", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/finalize", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] }, "description": "ينقل العرض لمرحلة المراجعة والموافقة الداخلية" }, { "name": "اعتماد داخلي (Approve)", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/approve", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] }, "description": "اعتماد العرض داخلياً ليصبح جاهزاً للإرسال للعميل" }, { "name": "رفض داخلي (Reject)", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/reject", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"التسعير غير مناسب - يرجى المراجعة\"\n}" } } }, { "name": "موافقة العميل", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/customer-approve", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] }, "description": "تسجيل موافقة العميل على العرض" }, { "name": "رفض العميل", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/customer-reject", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"رفض العميل العرض السعري - السعر مرتفع\"\n}" } } }, { "name": "إنشاء إصدار جديد من عرض مرفوض", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/create-version", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] }, "description": "ينسخ العرض بالكامل ويُنشئ إصداراً جديداً بحالة pending_pricing" }, { "name": "معاينة PDF (Stream)", "request": { "method": "GET", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/pdf" } }, { "name": "تحميل PDF", "request": { "method": "GET", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/pdf/download" } }, { "name": "حذف عرض سعر", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}" } } ] }, { "name": "US-004: العروض الفنية - CRUD كامل", "description": "إنشاء وتعديل وحذف العروض الفنية مع إدارة الأصول ونطاق العمل", "item": [ { "name": "عرض جميع العروض الفنية", "request": { "method": "GET", "url": "{{base_url}}/maintenance/technical-offers?per_page=15" } }, { "name": "إنشاء عرض فني من تقرير", "request": { "method": "POST", "url": "{{base_url}}/maintenance/technical-offers/from-report", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"report_id\": 1,\n \"description\": \"عرض فني بناءً على تقرير الزيارة\"\n}" } } }, { "name": "إنشاء عرض فني من طلب", "request": { "method": "POST", "url": "{{base_url}}/maintenance/technical-offers/from-request", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"request_id\": 1,\n \"description\": \"عرض فني بناءً على طلب التسعير\"\n}" } } }, { "name": "عرض تفاصيل عرض فني", "request": { "method": "GET", "url": "{{base_url}}/maintenance/technical-offers/{{technical_offer_id}}" } }, { "name": "تعديل العرض الفني", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/technical-offers/{{technical_offer_id}}", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"description\": \"عرض فني محدث\",\n \"contract_type\": \"preventive\",\n \"visit_count\": 4,\n \"visit_frequency\": \"quarterly\",\n \"system_types\": [\n \"HVAC\"\n ],\n \"has_chiller\": true,\n \"approximate_unit_count\": 15,\n \"notes\": \"ملاحظات فنية\"\n}" } } }, { "name": "إضافة أصول للعرض الفني", "request": { "method": "POST", "url": "{{base_url}}/maintenance/technical-offers/{{technical_offer_id}}/assets", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"assets\": [\n {\n \"asset_type_id\": 1,\n \"equipment_name\": \"وحدة تكييف مركزي\",\n \"code\": \"AC-001\",\n \"model\": \"VRF-500\",\n \"serial_number\": \"SN-001\",\n \"manufacturer\": \"Daikin\"\n },\n {\n \"asset_type_id\": 1,\n \"equipment_name\": \"وحدة تكييف سبليت\",\n \"code\": \"AC-002\",\n \"model\": \"Split-200\",\n \"serial_number\": \"SN-002\",\n \"manufacturer\": \"Carrier\"\n }\n ]\n}" } } }, { "name": "تعديل أصول العرض الفني", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/technical-offers/{{technical_offer_id}}/assets", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"assets\": [\n {\n \"id\": 1,\n \"equipment_name\": \"وحدة تكييف مركزي - محدث\",\n \"code\": \"AC-001-U\"\n }\n ]\n}" } } }, { "name": "إضافة نطاق أعمال", "request": { "method": "POST", "url": "{{base_url}}/maintenance/technical-offers/{{technical_offer_id}}/work-scopes", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"work_scope_ids\": [\n 1,\n 2,\n 3\n ]\n}" } } }, { "name": "تعديل نطاق الأعمال", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/technical-offers/{{technical_offer_id}}/work-scopes", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"work_scope_ids\": [\n 1,\n 2,\n 4,\n 5\n ]\n}" } } }, { "name": "حفظ كمسودة", "request": { "method": "POST", "url": "{{base_url}}/maintenance/technical-offers/{{technical_offer_id}}/save-draft", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "إرسال للتسعير (Finalize)", "request": { "method": "POST", "url": "{{base_url}}/maintenance/technical-offers/{{technical_offer_id}}/finalize", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "اعتماد العرض الفني", "request": { "method": "POST", "url": "{{base_url}}/maintenance/technical-offers/{{technical_offer_id}}/approve", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "رفض العرض الفني", "request": { "method": "POST", "url": "{{base_url}}/maintenance/technical-offers/{{technical_offer_id}}/reject", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"يحتاج مراجعة فنية إضافية\"\n}" } } }, { "name": "حذف عرض فني", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/technical-offers/{{technical_offer_id}}" } } ] }, { "name": "US-005: العقود - CRUD كامل", "description": "إنشاء وتعديل وحذف عقود الصيانة مع إدارة نطاقات العمل", "item": [ { "name": "عرض جميع العقود", "request": { "method": "GET", "url": "{{base_url}}/maintenance/contracts?per_page=15" } }, { "name": "إنشاء عقد من عرض فني", "request": { "method": "POST", "url": "{{base_url}}/maintenance/technical-offers/{{technical_offer_id}}/create-contract", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"title\": \"عقد صيانة وقائية - مبنى المكاتب\",\n \"contract_type\": \"private_sector\",\n \"start_date\": \"2026-03-01\",\n \"duration\": 12,\n \"duration_unit\": \"month\",\n \"payment_method\": \"quarterly\",\n \"contract_value\": 50000,\n \"end_date\": \"2027-02-28\",\n \"customer_id\": {{customer_id}},\n \"location_id\": {{location_id}},\n \"subject\": \"صيانة وقائية شاملة لأنظمة التكييف المركزي\",\n \"contract_types\": [\"preventive\"],\n \"visit_frequency\": \"quarterly\",\n \"annual_visits_count\": 4,\n \"consumables_included\": true,\n \"consumable_types\": [\"filters\", \"oils\"],\n \"consumables_budget\": 5000,\n \"sla_p1_hours\": 4,\n \"sla_p2_hours\": 8,\n \"sla_p3_hours\": 24,\n \"party_one_name\": \"شركة الرياض للخدمات الصناعية\",\n \"party_one_tax_number\": \"300123456789\",\n \"party_one_commercial_register\": \"1012345678\",\n \"party_two_name\": \"شركة الرياض للتطوير العقاري\",\n \"party_two_tax_number\": \"310987654321\",\n \"party_two_commercial_register\": \"1056789123\",\n \"exclusions\": \"الأعطال الناتجة عن سوء الاستخدام أو الكوارث الطبيعية\",\n \"penalties\": \"تتطبق غرامة تأخير 5% من قيمة العقد عن كل شهر تأخير\",\n \"expiry_alert_days\": 60,\n \"addendums\": [\n {\n \"location_id\": {{location_id}},\n \"project_name\": \"صيانة مبنى المكاتب الرئيسي\",\n \"number_of_visits\": 4,\n \"assets\": [\n {\n \"asset_id\": {{asset_id}},\n \"checklist\": {\n \"title\": \"فحص شامل للشيلر\",\n \"description\": \"فحص جميع مكونات الشيلر والتأكد من أدائها\",\n \"items\": [\n {\n \"question_text\": \"فحص ضغط غاز الفريون\",\n \"question_type\": \"yes_no\",\n \"is_required\": true,\n \"order_position\": 1\n },\n {\n \"question_text\": \"فحص درجة حرارة المياه\",\n \"question_type\": \"number\",\n \"is_required\": true,\n \"order_position\": 2\n }\n ]\n }\n }\n ]\n }\n ]\n}" } } }, { "name": "إنشاء عقد مباشر", "request": { "method": "POST", "url": "{{base_url}}/maintenance/contracts", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": 1,\n \"project_id\": 1,\n \"contract_type\": \"preventive\",\n \"start_date\": \"2026-01-01\",\n \"end_date\": \"2026-12-31\",\n \"contract_value\": 50000,\n \"payment_method\": \"quarterly\",\n \"visit_frequency\": \"quarterly\",\n \"annual_visits_count\": 4,\n \"notes\": \"عقد صيانة وقائية\",\n \"is_consumables_included\": true,\n \"system_types\": [\n \"HVAC\"\n ],\n \"has_chiller\": true\n}" } } }, { "name": "عقد ماستر", "request": { "method": "POST", "url": "{{base_url}}/maintenance/contracts/master", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": 1,\n \"contract_type\": \"comprehensive\",\n \"start_date\": \"2026-01-01\",\n \"end_date\": \"2027-12-31\",\n \"contract_value\": 150000\n}" } } }, { "name": "التحقق من العقد", "request": { "method": "POST", "url": "{{base_url}}/maintenance/contracts/check", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": 1,\n \"contract_type\": \"preventive\"\n}" } } }, { "name": "عرض تفاصيل عقد", "request": { "method": "GET", "url": "{{base_url}}/maintenance/contracts/{{contract_id}}" } }, { "name": "عرض قوائم فحص العقد", "request": { "method": "GET", "url": "{{base_url}}/maintenance/contracts/{{contract_id}}/checklists" } }, { "name": "تعديل العقد", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/contracts/{{contract_id}}", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"start_date\": \"2026-02-01\",\n \"end_date\": \"2027-01-31\",\n \"contract_value\": 55000,\n \"payment_method\": \"monthly\",\n \"notes\": \"تم تعديل مدة العقد\"\n}" } } }, { "name": "اعتماد العقد", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/contracts/{{contract_id}}/approve", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "عرض نطاقات العمل", "request": { "method": "GET", "url": "{{base_url}}/maintenance/contracts/{{contract_id}}/work-scopes" } }, { "name": "ربط نطاقات عمل", "request": { "method": "POST", "url": "{{base_url}}/maintenance/contracts/{{contract_id}}/work-scopes", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"work_scope_ids\": [\n 1,\n 2,\n 3\n ]\n}" } } }, { "name": "مزامنة نطاقات العمل", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/contracts/{{contract_id}}/work-scopes", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"work_scope_ids\": [\n 1,\n 2,\n 4\n ]\n}" } } }, { "name": "فصل نطاق عمل", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/contracts/{{contract_id}}/work-scopes/1" } }, { "name": "حذف العقد", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/contracts/{{contract_id}}" } } ] }, { "name": "US-006: تنفيذ زيارة الاستلام ومحضر الاستلام", "description": "إنشاء زيارة استلام أصول، تعيين الفنيين، إكمال الحصر الميداني، مقارنة العقد", "item": [ { "name": "Step 1: عرض الأصول المتوقعة من العقد", "description": "GET /handover-visits/expected-assets-summary?project_id=X", "request": { "method": "GET", "url": "{{base_url}}/maintenance/handover-visits/expected-assets-summary?project_id={{project_id}}" } }, { "name": "Step 2: عرض أنواع أصول العقد", "description": "GET /handover-visits/contract-asset-types?project_id=X", "request": { "method": "GET", "url": "{{base_url}}/maintenance/handover-visits/contract-asset-types?project_id={{project_id}}" } }, { "name": "Step 3: إنشاء زيارة استلام", "request": { "method": "POST", "url": "{{base_url}}/maintenance/handover-visits", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"project_id\": {{project_id}},\n \"location_id\": null,\n \"cost_center_id\": null,\n \"planned_date\": \"2026-03-01\",\n \"notes\": \"زيارة استلام أصول المشروع - التحقق من مطابقة الأصول الفعلية مع العقد قبل بدء الصيانة\",\n \"assigned_technicians\": [{{technician_id}}]\n}" } } }, { "name": "Step 4: عرض الزيارات المعلقة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/handover-visits/pending?project_id={{project_id}}" } }, { "name": "Step 5: عرض الزيارات الجاهزة للجدولة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/handover-visits/ready-to-schedule?project_id={{project_id}}" } }, { "name": "Step 6: التحقق هل الزيارة قابلة للجدولة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/handover-visits/{{visit_id}}/can-schedule" } }, { "name": "Step 7: جدولة زيارة الاستلام", "description": "POST /handover-visits/{visit}/schedule\nجدولة زيارة الاستلام بعد إنشائها\n\nSection 1 — بيانات الزيارة:\n- رقم الزيارة: تلقائي\n- نوع الزيارة: Read Only (زيارة استلام - Handover)\n- رقم المشروع: Read Only\n- اسم العميل: Read Only\n- الموقع: Read Only\n- تاريخ الزيارة: Date Picker\n- الفني المعين: Dropdown (يمكن تعيين أكثر من فني)\n- حالة الزيارة: Read Only (مجدولة)\n\nالأزرار: حفظ وجدولة / إلغاء", "request": { "method": "POST", "url": "{{base_url}}/maintenance/handover-visits/{{handover_visit_id}}/schedule", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"scheduled_at\": \"2026-03-05 09:00:00\",\n \"technician_ids\": [{{technician_id}}],\n \"notes\": \"تم تأكيد الموعد مع العميل لزيارة الاستلام\",\n \"visit_id\": {{handover_visit_id}}\n}" } } }, { "name": "Step 8: إكمال زيارة الاستلام (حصر الأصول)", "description": "POST /handover-visits/{visit}/complete\nالفني يكمل الحصر الميداني ويرفع المحضر\n\nSection 3 — حصر الأصول الفعلية:\n- زر: \"+ إضافة أصل\"\n- لكل أصل:\n * نوع الأصل: Dropdown (من قائمة الأصول المتعاقد عليها)\n * اسم المعدة: Text\n * الموقع داخل المبنى: Text\n * الكود: Text\n * الموديل: Text\n * الرقم التسلسلي: Text\n * الماركة: Text\n * المواصفات: Textarea\n * الجهد الكهربائي: Text\n * الذبذبة: Text\n * السعة / ضغط التشغيل: Text\n * عنوان الصانع: Text\n * الموزع الداخلي: Text\n * تاريخ الإنتاج: Date\n * تاريخ التوريد والتركيب: Date\n * حالة الأصل عند الاستلام: Dropdown (سليم / تالف / بحاجة إصلاح)\n * صور الأصل: Upload (متعدد)\n * ملاحظات: Textarea\n\nالملحقات (اختياري):\n- وحدة المكثف: الشركة المصنعة، الموديل، الرقم التسلسلي، بيانات إضافية\n- وحدة المبخر: الشركة المصنعة، الموديل، الرقم التسلسلي، بيانات إضافية\n\nSection 4 — ملخص المقارنة (يظهر تلقائياً أثناء الإدخال):\n- العدد المتعاقد عليه\n- العدد الفعلي المُدخل\n- الفرق\n- الحالة (✅ مطابق / ⚠️ زيادة / ⚠️ نقص)\n\nSection 5 — التوقيعات:\n- توقيع الفني: توقيع إلكتروني\n- توقيع ممثل العميل: توقيع إلكتروني + اسمه: Text\n- تاريخ التوقيع: Date (تلقائي)\n\nالأزرار: حفظ كمسودة / رفع المحضر للاعتماد", "request": { "method": "POST", "url": "{{base_url}}/maintenance/handover-visits/{{handover_visit_id}}/complete", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"actual_assets\": [\n {\n \"asset_type_id\": 1,\n \"equipment_name\": \"وحدة تكييف مركزي\",\n \"location_building\": \"الطابق الأول - الجناح الشرقي\",\n \"code\": \"AC-001\",\n \"model\": \"VRF-500\",\n \"serial_number\": \"SN-2024-001\",\n \"manufacturer\": \"Daikin\",\n \"brand\": \"Daikin\",\n \"specifications\": \"سعة 5 طن - تبريد وتدفئة\",\n \"electrical_voltage\": \"380V\",\n \"frequency\": \"50Hz\",\n \"capacity_operating_pressure\": \"5 طن\",\n \"manufacturer_address\": \"Osaka, Japan\",\n \"internal_distributor\": \"شركة التبريد العربية\",\n \"manufacturing_date\": \"2024-01-15\",\n \"supply_installation_date\": \"2024-06-01\",\n \"asset_status\": \"سليم\",\n \"notes\": \"الوحدة بحالة ممتازة\",\n \"accessories\": {\n \"condenser\": {\n \"manufacturer\": \"Daikin\",\n \"model\": \"CDU-500\",\n \"serial_number\": \"CSN-001\",\n \"additional_data\": \"مثبتة على السطح\"\n },\n \"evaporator\": {\n \"manufacturer\": \"Daikin\",\n \"model\": \"EVP-500\",\n \"serial_number\": \"ESN-001\",\n \"additional_data\": \"داخل السقف المعلق\"\n }\n }\n },\n {\n \"asset_type_id\": 1,\n \"equipment_name\": \"وحدة تكييف مركزي\",\n \"location_building\": \"الطابق الثاني\",\n \"code\": \"AC-002\",\n \"model\": \"VRF-300\",\n \"serial_number\": \"SN-2024-002\",\n \"manufacturer\": \"Carrier\",\n \"brand\": \"Carrier\",\n \"specifications\": \"سعة 3 طن - تبريد فقط\",\n \"electrical_voltage\": \"220V\",\n \"frequency\": \"50Hz\",\n \"capacity_operating_pressure\": \"3 طن\",\n \"asset_status\": \"بحاجة إصلاح\",\n \"notes\": \"الوحدة بحاجة لصيانة المروحة\"\n }\n ],\n \"signature_technician\": \"base64_tech_signature\",\n \"signature_client\": \"base64_client_signature\",\n \"client_representative_name\": \"أحمد محمد\"\n}" } } } ] }, { "name": "US-007: خطة الزيارات الدورية - CRUD كامل", "description": "تخطيط وجدولة الزيارات الدورية مع قواعد التكرار والاستيراد الجماعي", "item": [ { "name": "عرض جميع الزيارات", "request": { "method": "GET", "url": "{{base_url}}/maintenance/visits?per_page=15" } }, { "name": "عرض الزيارات المخططة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/visits/planned" } }, { "name": "تصفية متقدمة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/visits/filter?status=planned&project_id={{project_id}}&from_date=2026-01-01&to_date=2026-12-31" } }, { "name": "إنشاء زيارة جديدة", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"maintenance_request_id\": null,\n \"project_id\": 1,\n \"location_id\": 1,\n \"visit_type\": \"preventive\",\n \"visit_date\": \"2026-04-01\",\n \"scheduled_at\": \"2026-04-01 09:00:00\",\n \"notes\": \"زيارة وقائية ربع سنوية\",\n \"assigned_technicians\": [\n 1,\n 2\n ]\n}" } } }, { "name": "إنشاء من زيارة المشروع", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/from-project-visit", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"project_visit_id\": 1\n}" } } }, { "name": "إنشاء قاعدة تكرار", "request": { "method": "POST", "url": "{{base_url}}/maintenance/recurrence-rules", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"project_id\": 1,\n \"visit_type\": \"preventive\",\n \"frequency\": \"monthly\",\n \"interval\": 1,\n \"start_date\": \"2026-01-01\",\n \"end_date\": \"2026-12-31\",\n \"day_of_week\": \"sunday\",\n \"time\": \"09:00\"\n}" } } }, { "name": "معاينة قاعدة تكرار", "request": { "method": "POST", "url": "{{base_url}}/maintenance/recurrence-rules/preview", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"project_id\": 1,\n \"frequency\": \"quarterly\",\n \"start_date\": \"2026-01-01\",\n \"end_date\": \"2026-12-31\"\n}" } } }, { "name": "عرض قاعدة تكرار", "request": { "method": "GET", "url": "{{base_url}}/maintenance/recurrence-rules/1" } }, { "name": "تعديل قاعدة تكرار", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/recurrence-rules/1", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"frequency\": \"quarterly\",\n \"interval\": 1,\n \"end_date\": \"2027-06-30\"\n}" } } }, { "name": "توليد زيارات من القاعدة", "request": { "method": "POST", "url": "{{base_url}}/maintenance/recurrence-rules/1/generate-visits", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "حذف قاعدة تكرار", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/recurrence-rules/1" } }, { "name": "جدولة جماعية", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/bulk-schedule", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"visit_ids\": [\n 1,\n 2,\n 3\n ],\n \"scheduled_at\": \"2026-04-15 09:00:00\"\n}" } } }, { "name": "تحميل قالب الاستيراد", "request": { "method": "GET", "url": "{{base_url}}/maintenance/visits/import-template" } }, { "name": "عرض تفاصيل زيارة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/visits/{{visit_id}}" } }, { "name": "تعديل زيارة", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/visits/{{visit_id}}", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"visit_date\": \"2026-04-15\",\n \"scheduled_at\": \"2026-04-15 10:00:00\",\n \"notes\": \"تم تغيير الموعد\"\n}" } } }, { "name": "جدولة زيارة", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/schedule", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"scheduled_at\": \"2026-04-01 09:00:00\"\n}" } } }, { "name": "إعادة جدولة", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/reschedule", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"scheduled_at\": \"2026-04-20 09:00:00\",\n \"reason\": \"تغيير في جدول العميل\"\n}" } } }, { "name": "الفنيين المتاحين", "request": { "method": "GET", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/available-technicians" } }, { "name": "تعيين فني", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/assign-technician", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"technician_id\": 1\n}" } } }, { "name": "إزالة فني", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/technicians/1" } }, { "name": "إضافة أصل للزيارة", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/assets", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"asset_id\": 1\n}" } } }, { "name": "إزالة أصل", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/assets" } }, { "name": "سجل النشاط", "request": { "method": "GET", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/activity-log" } }, { "name": "حذف زيارة (ناعم)", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/visits/{{visit_id}}" } }, { "name": "استعادة زيارة", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/restore", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "حذف نهائي", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/force-delete", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } } ] }, { "name": "US-008: تنفيذ زيارة وقائية - CRUD كامل", "description": "تنفيذ الزيارات مع التعليقات وقطع الغيار والأسئلة الديناميكية والتحقق من القوائم", "item": [ { "name": "زياراتي", "request": { "method": "GET", "url": "{{base_url}}/maintenance/visits/my-visits" } }, { "name": "زياراتي (مع pagination)", "request": { "method": "GET", "url": "{{base_url}}/maintenance/visits/my-visits/paginated?per_page=10" } }, { "name": "التحقق من إكمال قائمة الفحص", "request": { "method": "GET", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/validate-checklist" } }, { "name": "بيانات الفاتورة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/invoice-data" } }, { "name": "عرض تعليقات الزيارة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/comments" } }, { "name": "إضافة تعليق", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/comments", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"comment\": \"تم الوصول للموقع وبدء العمل\",\n \"type\": \"note\"\n}" } } }, { "name": "عرض تعليق", "request": { "method": "GET", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/comments/1" } }, { "name": "تعديل تعليق", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/comments/1", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"comment\": \"تم تحديث التعليق\"\n}" } } }, { "name": "حذف تعليق", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/comments/1" } }, { "name": "استعادة تعليق", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/comments/1/restore", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "عرض الأسئلة الديناميكية", "request": { "method": "GET", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/dynamic-questions" } }, { "name": "إضافة سؤال ديناميكي", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/dynamic-questions", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"question\": \"هل تم فحص مستوى غاز التبريد؟\",\n \"question_type\": \"yes_no\",\n \"is_required\": true,\n \"order\": 1\n}" } } }, { "name": "تعديل سؤال", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/visits/dynamic-questions/1", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"question\": \"هل تم فحص مستوى غاز التبريد وضغطه؟\"\n}" } } }, { "name": "حذف سؤال", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/visits/dynamic-questions/1" } }, { "name": "عرض قطع الغيار", "request": { "method": "GET", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/spare-parts" } }, { "name": "إضافة قطعة غيار", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/spare-parts", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"part_name\": \"فلتر هواء\",\n \"part_number\": \"AF-001\",\n \"quantity\": 2,\n \"unit_cost\": 150,\n \"brand\": \"Carrier\"\n}" } } }, { "name": "عرض قطعة غيار", "request": { "method": "GET", "url": "{{base_url}}/maintenance/visit-spare-parts/1" } }, { "name": "تعديل قطعة غيار", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/visit-spare-parts/1", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"quantity\": 3,\n \"unit_cost\": 140\n}" } } }, { "name": "حذف قطعة غيار", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/visit-spare-parts/1" } } ] }, { "name": "US-014: التقارير - CRUD كامل", "description": "إنشاء وتعديل واعتماد ورفض تقارير الزيارات مع الفواتير وطلبات التوريد", "item": [ { "name": "عرض جميع التقارير", "request": { "method": "GET", "url": "{{base_url}}/maintenance/reports?per_page=15" } }, { "name": "إحصائيات التقارير", "request": { "method": "GET", "url": "{{base_url}}/maintenance/reports/statistics" } }, { "name": "تقارير حسب الطلب", "request": { "method": "GET", "url": "{{base_url}}/maintenance/reports/request/{{request_id}}" } }, { "name": "تقارير حسب الأصل", "request": { "method": "GET", "url": "{{base_url}}/maintenance/reports/asset/{{asset_id}}" } }, { "name": "تقارير بنطاق زمني", "request": { "method": "GET", "url": "{{base_url}}/maintenance/reports/by-date-range?from=2026-01-01&to=2026-12-31" } }, { "name": "إنشاء تقرير زيارة", "request": { "method": "POST", "url": "{{base_url}}/maintenance/reports", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"visit_id\": 1,\n \"report_type\": \"preventive\",\n \"summary\": \"تم إجراء الصيانة الوقائية لجميع الوحدات\",\n \"findings\": \"جميع الوحدات بحالة جيدة - تم تغيير الفلاتر\",\n \"recommendations\": \"يُوصى بتغيير حزام المروحة في الزيارة القادمة\",\n \"work_performed\": \"فحص شامل - تنظيف الفلاتر - فحص غاز التبريد\",\n \"repair_type\": \"preventive\",\n \"status\": \"draft\",\n \"next_visit_date\": \"2026-07-01\",\n \"spare_parts_used\": [\n {\n \"part_name\": \"فلتر هواء\",\n \"quantity\": 4,\n \"unit_cost\": 150\n }\n ]\n}" } } }, { "name": "عرض تفاصيل تقرير", "request": { "method": "GET", "url": "{{base_url}}/maintenance/reports/{{report_id}}" } }, { "name": "عرض مع المرفقات", "request": { "method": "GET", "url": "{{base_url}}/maintenance/reports/{{report_id}}/with-attachments" } }, { "name": "تعديل التقرير", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/reports/{{report_id}}", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"summary\": \"تقرير محدث - تم إضافة ملاحظات إضافية\",\n \"findings\": \"تم اكتشاف تسرب بسيط في الوحدة 3\",\n \"recommendations\": \"إصلاح التسرب في أقرب وقت\"\n}" } } }, { "name": "اعتماد التقرير", "request": { "method": "POST", "url": "{{base_url}}/maintenance/reports/{{report_id}}/approve", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"approval_notes\": \"تمت المراجعة والاعتماد\"\n}" } } }, { "name": "رفض التقرير", "request": { "method": "POST", "url": "{{base_url}}/maintenance/reports/{{report_id}}/reject", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"rejection_reason\": \"يرجى إضافة تفاصيل أكثر عن العمل المنجز\"\n}" } } }, { "name": "إرجاع للفني", "request": { "method": "POST", "url": "{{base_url}}/maintenance/reports/{{report_id}}/return-to-technician", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"يرجى إكمال بيانات قطع الغيار المستخدمة\"\n}" } } }, { "name": "إضافة تعليق على التقرير", "request": { "method": "POST", "url": "{{base_url}}/maintenance/reports/{{report_id}}/comment", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"comment\": \"يرجى مراجعة التوصيات\"\n}" } } }, { "name": "إنشاء طلب توريد", "request": { "method": "POST", "url": "{{base_url}}/maintenance/reports/{{report_id}}/supply-request", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"part_name\": \"حزام مروحة\",\n \"quantity\": 2,\n \"urgency\": \"high\"\n }\n ]\n}" } } }, { "name": "إنشاء فاتورة", "request": { "method": "POST", "url": "{{base_url}}/maintenance/reports/invoice", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"report_ids\": [\n 1,\n 2\n ],\n \"customer_id\": 1,\n \"notes\": \"فاتورة صيانة ربع سنوية\"\n}" } } }, { "name": "رفع مرفقات التقرير", "request": { "method": "POST", "url": "{{base_url}}/maintenance/reports/{{report_id}}/attachments", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"attachments\": [\n {\n \"temporary_folder\": \"temp_folder_uuid\"\n }\n ]\n}" } } }, { "name": "تصدير PDF التقرير", "request": { "method": "GET", "url": "{{base_url}}/maintenance/reports/{{report_id}}/pdf" } }, { "name": "الجدول الزمني للطوارئ", "request": { "method": "GET", "url": "{{base_url}}/maintenance/reports/{{report_id}}/emergency-timeline" } }, { "name": "حذف تقرير (ناعم)", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/reports/{{report_id}}" } }, { "name": "استعادة تقرير", "request": { "method": "POST", "url": "{{base_url}}/maintenance/reports/{{report_id}}/restore", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "حذف نهائي", "request": { "method": "POST", "url": "{{base_url}}/maintenance/reports/{{report_id}}/force-delete", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } } ] }, { "name": "US-015: زيارة طوارئ - CRUD كامل", "description": "إنشاء وإدارة بلاغات ورحلات الطوارئ", "item": [ { "name": "إنشاء طلب طوارئ", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": 1,\n \"location_id\": 1,\n \"source\": \"هاتف\",\n \"request_type\": \"emergency\",\n \"priority\": \"critical\",\n \"reported_issue\": \"توقف كامل في نظام التبريد - مستودع أدوية\",\n \"technical_supervisor_id\": 1,\n \"is_unscheduled\": true,\n \"impact_level\": \"P1\",\n \"notes\": \"حالة طوارئ - خطر على المواد المبردة\",\n \"save_as_draft\": false,\n \"system_types\": [\n \"HVAC\"\n ],\n \"has_active_contract\": true\n}" } } }, { "name": "إقرار البلاغ الطارئ", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/acknowledge", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "[تم الحذف] تعيين فني للطوارئ", "description": "POST /requests/{request}/technician\n❌ تم حذف هذا الـ endpoint - التعيين يتم عبر changeStatus", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/technician", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"technician_id\": 1\n}" } } }, { "name": "إنشاء زيارة طوارئ", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"maintenance_request_id\": 1,\n \"project_id\": 1,\n \"location_id\": 1,\n \"visit_type\": \"emergency\",\n \"visit_date\": \"2026-02-21\",\n \"scheduled_at\": \"2026-02-21 14:00:00\",\n \"notes\": \"زيارة طوارئ عاجلة\",\n \"assigned_technicians\": [\n 1\n ]\n}" } } }, { "name": "إنشاء تقرير الطوارئ", "request": { "method": "POST", "url": "{{base_url}}/maintenance/reports", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"visit_id\": 1,\n \"report_type\": \"emergency\",\n \"summary\": \"تم إصلاح العطل - استبدال ضاغط التبريد\",\n \"findings\": \"ضاغط التبريد تالف بالكامل\",\n \"work_performed\": \"استبدال ضاغط التبريد وشحن الغاز\",\n \"repair_type\": \"corrective\",\n \"status\": \"submitted\",\n \"spare_parts_used\": [\n {\n \"part_name\": \"ضاغط تبريد\",\n \"quantity\": 1,\n \"unit_cost\": 3500\n }\n ]\n}" } } }, { "name": "عرض الجدول الزمني للطوارئ", "request": { "method": "GET", "url": "{{base_url}}/maintenance/reports/{{report_id}}/emergency-timeline" } }, { "name": "إغلاق الطلب بعد الإصلاح", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/close", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"تم إصلاح العطل بنجاح\"\n}" } } } ] }, { "name": "US-017: خدمة غير مجدولة (بدون عقد) - CRUD كامل", "description": "إنشاء طلبات خدمة غير مجدولة للعملاء بدون عقد مع التحويل لعرض سعر", "item": [ { "name": "بحث عن عميل", "request": { "method": "GET", "url": "{{base_url}}/maintenance/requests/search/customers?q=عميل" } }, { "name": "إنشاء عميل + طلب", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/create-with-client", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": {{customer_id}},\n \"customer_name\": \"مستشفى النور الطبي\",\n \"location_id\": 3,\n \"phone_number\": \"0559876543\",\n \"source\": \"هاتف\",\n \"request_type\": \"corrective\",\n \"priority\": \"medium\",\n \"reported_issue\": \"عطل في مكيف سبليت\",\n \"system_types\": [\"HVAC\"],\n \"approximate_unit_count\": 1,\n \"has_active_contract\": false,\n \"notes\": \"عميل بدون عقد - يحتاج عرض سعر\",\n \"assets\": [\n { \"asset_id\": 3 }\n ]\n}" } } }, { "name": "إنشاء طلب (عميل موجود)", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": {{customer_id}},\n \"customer_name\": \"شركة الرياض للتطوير العقاري\",\n \"location_id\": {{location_id}},\n \"source\": \"مباشر\",\n \"request_type\": \"corrective\",\n \"priority\": \"medium\",\n \"reported_issue\": \"صوت غير طبيعي في المكيف\",\n \"has_active_contract\": false,\n \"is_unscheduled\": true,\n \"system_types\": [\"HVAC\"],\n \"notes\": \"عميل بدون عقد\",\n \"assets\": [\n { \"asset_id\": {{asset_id}} }\n ]\n}" } } }, { "name": "تحويل الطلب إلى عرض فني", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/convert-to-quote", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"description\": \"عرض سعر لإصلاح عطل\",\n \"contract_type\": \"corrective\"\n}" } } }, { "name": "إنشاء عرض سعر وقائي من العرض الفني (US-003)", "description": "POST /price-offers/preventive/{technicalOffer}\nيُنشئ عرض سعر وقائي كامل مع بيانات التسعير وشروط التعاقد", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/preventive/{{technical_offer_id}}", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"chiller_visit_cost\": 1500,\n \"package_visit_cost\": 800,\n \"is_consumables_included\": true,\n \"consumables_cost\": 5000,\n \"consumable_types\": [\"فلاتر\", \"زيوت\", \"أحزمة\"],\n \"discount_percentage\": 5,\n \"tax_percentage\": 15,\n \"payment_method\": \"quarterly\",\n \"payment_schedule\": [\n {\"amount\": 12500, \"due_date\": \"2026-04-01\"},\n {\"amount\": 12500, \"due_date\": \"2026-07-01\"},\n {\"amount\": 12500, \"due_date\": \"2026-10-01\"},\n {\"amount\": 12500, \"due_date\": \"2027-01-01\"}\n ],\n \"offer_validity_date\": \"2026-03-15\",\n \"inclusions\": \"صيانة وقائية دورية شاملة لجميع وحدات التكييف\\nفحص وتنظيف الفلاتر والمكثفات\",\n \"exclusions\": \"قطع الغيار الرئيسية (ضواغط، مراوح)\\nأعطال ناتجة عن سوء الاستخدام\",\n \"contract_terms\": \"مدة العقد سنة واحدة قابلة للتجديد\\nالدفع ربع سنوي مقدم\",\n \"spare_parts_policy\": \"المستهلكات على حساب الشركة، قطع الغيار الرئيسية على حساب العميل\",\n \"status\": \"pending_pricing\"\n}" } } }, { "name": "تسعير العرض", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"visit_cost\": 300,\n \"corrective_visit_cost\": 500,\n \"discount_amount\": 0,\n \"tax_percentage\": 15,\n \"offer_validity_date\": \"2026-03-31\",\n \"payment_method\": \"مسبق\",\n \"warranty_terms\": \"ضمان 3 أشهر على الإصلاح\"\n}" } } }, { "name": "إرسال للاعتماد", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/finalize", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "موافقة العميل", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/customer-approve", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "رفض العميل", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/customer-reject", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"السعر مرتفع\"\n}" } } }, { "name": "إغلاق الطلب", "request": { "method": "POST", "url": "{{base_url}}/maintenance/requests/{{request_id}}/close", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"رفض العميل العرض السعري\"\n}" } } } ] }, { "name": "US-011: الزيارة التصحيحية - دورة حياة كاملة", "description": "إنشاء زيارة تصحيحية تلقائية بعد اعتماد عرض السعر، مراجعة، تفعيل بعد استلام القطع، جدولة، بدء، إكمال وتقديم التقرير", "item": [ { "name": "Step 1: إنشاء زيارة تصحيحية من عرض سعر معتمد", "description": "POST /visits/from-price-offer\nيُنشئ زيارة تصحيحية تلقائياً بعد اعتماد العميل لعرض السعر ورفع أمر الشراء", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/from-price-offer", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"price_offer_id\": {{price_offer_id}},\n \"po_number\": \"PO-2026-001\",\n \"po_date\": \"2026-02-22\",\n \"maintenance_request_id\": {{request_id}},\n \"maintenance_asset_id\": {{asset_id}}\n}" } } }, { "name": "Step 2: مراجعة الزيارة التصحيحية (المشرف)", "description": "POST /visits/{id}/review\nالمشرف يراجع الزيارة ويحدد شدة العطل والتكاليف الإضافية", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/review", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"po_number\": \"PO-2026-001\",\n \"po_date\": \"2026-02-22\",\n \"fault_severity\": \"moderate\",\n \"fault_description\": \"عطل في ضاغط التبريد - يحتاج استبدال\",\n \"estimated_duration\": 4,\n \"estimated_duration_unit\": \"hours\",\n \"supervisor_id\": {{technician_id}},\n \"additional_costs\": [\n {\n \"cost_type\": \"transportation\",\n \"description\": \"تكلفة نقل المعدات\",\n \"amount\": 500\n },\n {\n \"cost_type\": \"labor\",\n \"description\": \"عمل إضافي\",\n \"amount\": 300\n }\n ]\n}" } } }, { "name": "Step 3: تفعيل الزيارة بعد استلام القطع", "description": "POST /visits/{id}/activate\nتفعيل الزيارة بعد وصول قطع الغيار المطلوبة", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/activate", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"supply_order_id\": {{supply_order_id}},\n \"actual_delivery_date\": \"2026-02-25\",\n \"notes\": \"تم استلام جميع القطع المطلوبة\"\n}" } } }, { "name": "Step 4: جدولة زيارة غير مجدولة + تعيين فنيين", "description": "POST /visits/{id}/schedule-unscheduled\nجدولة الزيارة وتعيين الفنيين المناسبين", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/schedule-unscheduled", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"scheduled_date\": \"2026-03-01 09:00:00\",\n \"technician_ids\": [{{technician_id}}],\n \"notes\": \"تم التنسيق مع العميل على الموعد\",\n \"visit_id\": {{visit_id}}\n}" } } }, { "name": "Step 5: بدء تنفيذ الزيارة", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/start", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"notes\": \"تم الوصول للموقع وبدء العمل\",\n \"visit_id\": {{visit_id}}\n}" } } }, { "name": "Step 6: إكمال الزيارة وتقديم التقرير", "description": "POST /visits/{id}/complete\nالفني يكمل الزيارة ويقدم تقرير مفصل", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/complete", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"fault_description\": \"صوت غير طبيعي في الشيلر مع ارتفاع درجة حرارة المبنى\",\n \"work_performed\": \"فحص شامل للضاغط وتحديد مصدر الصوت - يحتاج استبدال bearing\",\n \"recommendations\": \"يُوصى باستبدال bearing الضاغط الرئيسي خلال أسبوع لتجنب توقف كامل\",\n \"technician_notes\": \"العميل تم إبلاغه بالتكلفة التقديرية وموعد الصيانة\",\n \"inspected_assets\": [\n {\n \"asset_type\": \"شيلر تكييف مركزي\",\n \"location_in_building\": \"الطابق الأرضي - غرفة التبريد\",\n \"model\": \"York YK-CP\",\n \"serial_number\": \"YK2021A4567\",\n \"brand\": \"York\",\n \"condition\": \"needs_moderate\",\n \"inspection_notes\": \"صوت احتكاك عالي من bearing الضاغط الرئيسي. الوحدة تعمل ولكن مع ضوضاء عالية. درجة حرارة الخروج 45°C بدلاً من 38°C الطبيعية.\",\n \"work_items\": [\n {\n \"description\": \"فحص الضغط والاهتزازات\",\n \"completed\": true\n },\n {\n \"description\": \"قياس درجات الحرارة\",\n \"completed\": true\n },\n {\n \"description\": \"تحديد مصدر الصوت\",\n \"completed\": true\n }\n ]\n },\n {\n \"asset_type\": \"مضخة مياه\",\n \"location_in_building\": \"الطابق الأرضي - غرفة التبريد\",\n \"model\": \"Grundfos UPS 25-80\",\n \"serial_number\": \"GP2022B1234\",\n \"brand\": \"Grundfos\",\n \"condition\": \"good\",\n \"inspection_notes\": \"المضخة تعمل بشكل طبيعي. لا توجد تسريبات أو ضوضاء.\",\n \"work_items\": [\n {\n \"description\": \"فحص الضغط\",\n \"completed\": true\n },\n {\n \"description\": \"فحص التسريبات\",\n \"completed\": true\n }\n ]\n }\n ],\n \"spare_parts\": [\n {\n \"part_name\": \"Bearing الضاغط الرئيسي - York YK-CP\",\n \"quantity\": 1,\n \"notes\": \"قطعة أصلية مطلوبة للصيانة\"\n },\n {\n \"part_name\": \"زيت تشحيم للضاغط\",\n \"quantity\": 2,\n \"notes\": \"زيت خاص بالضاغط\"\n }\n ],\n \"visit_id\": {{visit_id}}\n}" } } } ] }, { "name": "US-014: مراجعة واعتماد تقرير الزيارة التصحيحية", "description": "اعتماد أو رفض أو إعادة تقرير الزيارة التصحيحية من قبل المشرف الفني", "item": [ { "name": "اعتماد تقرير الزيارة", "description": "POST /visits/{id}/report/approve\nالمشرف يعتمد التقرير مع ملاحظات", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/report/approve", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"approval_notes\": \"تمت المراجعة - التقرير مكتمل والعمل مطابق للمطلوب\",\n \"report_id\": {{report_id}}\n}" } } }, { "name": "رفض تقرير الزيارة", "description": "POST /visits/{id}/report/reject\nالمشرف يرفض التقرير مع سبب الرفض", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/report/reject", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"rejection_reason\": \"التقرير غير مكتمل - يرجى إضافة تفاصيل قطع الغيار المستخدمة وصور العمل المنجز\",\n \"report_id\": {{report_id}}\n}" } } }, { "name": "إعادة التقرير للفني", "description": "POST /visits/{id}/report/return\nالمشرف يعيد التقرير للفني لتعديله", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/report/return", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"return_reason\": \"يرجى إكمال بيانات الفحص وإضافة صور قبل وبعد الإصلاح\",\n \"report_id\": {{report_id}}\n}" } } }, { "name": "إنشاء فاتورة من التقرير المعتمد", "description": "POST /reports/invoice\nإنشاء فاتورة للزيارة بعد اعتماد التقرير", "request": { "method": "POST", "url": "{{base_url}}/maintenance/reports/invoice", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"report_ids\": [{{report_id}}],\n \"invoice_date\": \"2026-02-22\",\n \"due_date\": \"2026-03-22\",\n \"notes\": \"فاتورة زيارة تصحيحية - استبدال bearing الضاغط\"\n}" } } } ] }, { "name": "US-006: تنفيذ زيارة الاستلام وإنشاء محضر الاستلام - السيناريو التشغيلي الكامل", "description": "المسار الأساسي: بعد تفعيل العقد، المشرف ينشئ زيارة استلام → الفني ينفذ الحصر الميداني → إدخال بيانات الأصول الفعلية → التحقق من المطابقة مع العقد → الاعتماد أو الإعادة → السماح ببدء الصيانة الدورية", "item": [ { "name": "Step 1: إنشاء زيارة استلام من المشروع", "description": "POST /projects/{project_id}/handover-visit\nإنشاء زيارة استلام للأصول المتعاقد عليها\n\nSection 1 — بيانات الزيارة:\n- رقم الزيارة: تلقائي\n- نوع الزيارة: Read Only (زيارة استلام - Handover)\n- رقم المشروع: Read Only\n- اسم العميل: Read Only\n- الموقع: Read Only\n- تاريخ الزيارة: Date Picker\n- الفني المعين: Dropdown (يمكن تعيين أكثر من فني)\n- حالة الزيارة: Read Only (مجدولة)\n\nالأزرار: حفظ وجدولة / إلغاء", "request": { "method": "POST", "url": "{{base_url}}/maintenance/projects/{{project_id}}/handover-visit", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"scheduled_date\": \"2026-03-05 10:00:00\",\n \"technician_ids\": [{{technician_id}}],\n \"notes\": \"زيارة استلام لأصول العقد الجديد\",\n \"project_id\": {{project_id}}\n}" } } }, { "name": "Step 2: بدء زيارة الاستلام", "description": "POST /handover-visits/{visit}/start\nالفني يبدأ تنفيذ زيارة الاستلام\n\nSection 1 — البيانات التلقائية:\n- رقم الزيارة: Read Only\n- اسم العميل: Read Only\n- الموقع: Read Only\n- نوع الزيارة: Read Only\n- تاريخ الزيارة: Read Only\n\nSection 2 — الأصول المتوقعة من العقد (Read Only للمقارنة):\n- عرض جدول بالأصول المتعاقد عليها\n- نوع الوحدة: Read Only\n- العدد المتعاقد عليه: Read Only\n\nSection 3 — حصر الأصول الفعلية:\n- زر: \"+ إضافة أصل\"\n- لكل أصل: جميع الحقول المطلوبة\n\nSection 4 — ملخص المقارنة (يظهر تلقائياً أثناء الإدخال):\n- العدد المتعاقد عليه\n- العدد الفعلي المُدخل\n- الفرق\n- الحالة (✅ مطابق / ⚠️ زيادة / ⚠️ نقص)\n\nSection 5 — التوقيعات:\n- توقيع الفني: توقيع إلكتروني\n- توقيع ممثل العميل: توقيع إلكتروني + اسمه\n- تاريخ التوقيع: Date (تلقائي)\n\nالأزرار: حفظ كمسودة / رفع المحضر للاعتماد", "request": { "method": "POST", "url": "{{base_url}}/maintenance/handover-visits/{{handover_visit_id}}/start", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"notes\": \"بدء حصر الأصول الفعلية في الموقع\",\n \"visit_id\": {{handover_visit_id}}\n}" } } }, { "name": "Step 3: إدخال الأصول الفعلية والمقارنة", "description": "POST /visits/{id}/complete\nإكمال الحصر مع إدخال الأصول الفعلية ومقارنتها بالعقد", "request": { "method": "POST", "url": "{{base_url}}/maintenance/handover-visits/{{handover_visit_id}}/complete", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"actual_assets\": [\n {\n \"asset_type_id\": {{chiller_type_id}},\n \"equipment_name\": \"وحدة تكييف مركزي\",\n \"location_building\": \"الطابق الأول - الجناح الشرقي\",\n \"code\": \"AC-001\",\n \"model\": \"VRF-500\",\n \"serial_number\": \"SN-2024-001\",\n \"manufacturer\": \"Daikin\",\n \"brand\": \"Daikin\",\n \"specifications\": \"سعة 5 طن - تبريد وتدفئة\",\n \"electrical_voltage\": \"380V\",\n \"frequency\": \"50Hz\",\n \"capacity_operating_pressure\": \"5 طن\",\n \"manufacturer_address\": \"Osaka, Japan\",\n \"internal_distributor\": \"شركة التبريد العربية\",\n \"manufacturing_date\": \"2024-01-15\",\n \"supply_installation_date\": \"2024-06-01\",\n \"asset_status\": \"سليم\",\n \"notes\": \"الوحدة بحالة ممتازة - مطابقة للمواصفات التعاقدية\",\n \"accessories\": {\n \"condenser\": {\n \"manufacturer\": \"Daikin\",\n \"model\": \"CDU-500\",\n \"serial_number\": \"CSN-001\",\n \"additional_data\": \"مثبتة على السطح - مطابقة للعقد\"\n },\n \"evaporator\": {\n \"manufacturer\": \"Daikin\",\n \"model\": \"EVP-500\",\n \"serial_number\": \"ESN-001\",\n \"additional_data\": \"داخل السقف المعلق - مطابقة للعقد\"\n }\n }\n },\n {\n \"asset_type_id\": {{package_type_id}},\n \"equipment_name\": \"وحدة تكييف باكيج\",\n \"location_building\": \"الطابق الثاني\",\n \"code\": \"AC-002\",\n \"model\": \"VRF-300\",\n \"serial_number\": \"SN-2024-002\",\n \"manufacturer\": \"Carrier\",\n \"brand\": \"Carrier\",\n \"specifications\": \"سعة 3 طن - تبريد فقط\",\n \"electrical_voltage\": \"220V\",\n \"frequency\": \"50Hz\",\n \"capacity_operating_pressure\": \"3 طن\",\n \"asset_status\": \"بحاجة إصلاح\",\n \"notes\": \"الوحدة بحاجة لصيانة المروحة - سجل في تقرير الحالة\"\n },\n {\n \"asset_type_id\": {{ahu_type_id}},\n \"equipment_name\": \"وحدة مناولة هواء\",\n \"location_building\": \"الطابق الثالث\",\n \"code\": \"AHU-001\",\n \"model\": \"AHU-2000\",\n \"serial_number\": \"SN-2024-003\",\n \"manufacturer\": \"York\",\n \"brand\": \"York\",\n \"specifications\": \"سعة 2000 CFM - فلترة هواء\",\n \"electrical_voltage\": \"220V\",\n \"frequency\": \"50Hz\",\n \"capacity_operating_pressure\": \"2000 CFM\",\n \"asset_status\": \"سليم\",\n \"notes\": \"الوحدة تعمل بكفاءة عالية\"\n }\n ],\n \"signature_technician\": \"base64_tech_signature_data\",\n \"signature_client\": \"base64_client_signature_data\",\n \"client_representative_name\": \"أحمد محمد\",\n \"visit_id\": {{handover_visit_id}},\n \"comparison_summary\": {\n \"total_contracted\": 3,\n \"total_actual\": 3,\n \"difference\": 0,\n \"status\": \"مطابق\",\n \"asset_types_comparison\": [\n {\n \"type\": \"شيلر تكييف مركزي\",\n \"contracted\": 1,\n \"actual\": 1,\n \"difference\": 0,\n \"status\": \"✅ مطابق\"\n },\n {\n \"type\": \"وحدة تكييف باكيج\",\n \"contracted\": 1,\n \"actual\": 1,\n \"difference\": 0,\n \"status\": \"✅ مطابق\"\n },\n {\n \"type\": \"وحدة مناولة هواء\",\n \"contracted\": 1,\n \"actual\": 1,\n \"difference\": 0,\n \"status\": \"✅ مطابق\"\n }\n ]\n }\n}" } } }, { "name": "Step 4: مراجعة واعتماد محضر الاستلام", "description": "POST /visits/{id}/handover-approve\nالمشرف يعتمد محضر الاستلام مع التحقق من المطابقة\n\nSection 1 — بيانات المحضر:\n- عرض جميع البيانات المُدخلة من الفني كـ Read Only\n\nSection 2 — نتيجة التحقق التلقائي:\n- عرض جدول المقارنة\n- إذا يوجد اختلاف ← تنبيه واضح باللون الأحمر\n- إذا تطابق تام ← رسالة باللون الأخضر\n\nالأزرار (تتغير بناءً على نتيجة التحقق):\n- إذا تطابق تام: اعتماد المحضر ← يُفعّل بدء الصيانة الدورية\n- إذا يوجد اختلاف: رفع بلاغ لتعديل العقد / إعادة المحضر للفني للمراجعة\n\n⚠️ النظام يمنع بدء أي صيانة دورية", "request": { "method": "POST", "url": "{{base_url}}/maintenance/handover-visits/{{handover_visit_id}}/approve", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"approval_notes\": \"تم التحقق من مطابقة الأصول الفعلية مع العقد - العدد مطابق 100% - يمكن اعتماد المحضر وبدء الصيانة الدورية\",\n \"verification_result\": {\n \"total_contracted\": 3,\n \"total_actual\": 3,\n \"difference\": 0,\n \"status\": \"مطابق\",\n \"allows_maintenance_start\": true,\n \"requires_contract_modification\": false\n },\n \"visit_id\": {{handover_visit_id}}\n}" } } }, { "name": "Step 5: رفض محضر الاستلام (إذا لزم)", "description": "POST /visits/{id}/handover-reject\nالمشرف يرفض المحضر لإعادة الحصر", "request": { "method": "POST", "url": "{{base_url}}/maintenance/handover-visits/{{handover_visit_id}}/reject", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"rejection_reason\": \"بيانات الأصول غير مكتملة - يرجى إكمال حصر جميع الوحدات\",\n \"return_reason\": \"إعادة المحضر للفني لإكمال الحصر الناقص\",\n \"visit_id\": {{handover_visit_id}}\n}" } } }, { "name": "Step 6: عرض الأصول المتوقعة من العقد", "description": "GET /handover-visits/expected-assets\nعرض الأصول المتعاقد عليها للمقارنة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/handover-visits/expected-assets?project_id={{project_id}}", "header": [ { "key": "Accept", "value": "application/json" } ] } }, { "name": "Step 7: عرض ملخص المقارنة", "description": "GET /handover-visits/comparison-summary\nعرض ملخص المقارنة بين المتعاقد عليه والفعلي", "request": { "method": "GET", "url": "{{base_url}}/maintenance/handover-visits/comparison-summary?visit_id={{handover_visit_id}}", "header": [ { "key": "Accept", "value": "application/json" } ] } }, { "name": "Step 8: التحقق من إمكانية بدء الصيانة", "description": "GET /handover-visits/can-schedule-maintenance\nالتحقق مما إذا كان يمكن بدء الصيانة الدورية", "request": { "method": "GET", "url": "{{base_url}}/maintenance/handover-visits/{{handover_visit_id}}/can-schedule-maintenance", "header": [ { "key": "Accept", "value": "application/json" } ] } }, { "name": "Step 6: إنشاء تذكرة تعديل العقد", "description": "POST /contracts/adjustment-request\nإنشاء تذكرة تلقائية لتعديل العقد بسبب الاختلاف", "request": { "method": "POST", "url": "{{base_url}}/maintenance/contracts/{{contract_id}}/adjustment-request", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"adjustment_type\": \"asset_count_change\",\n \"current_assets\": {\n \"chiller\": 1,\n \"pumps\": 1,\n \"ahu\": 1\n },\n \"contracted_assets\": {\n \"chiller\": 1,\n \"pumps\": 2,\n \"ahu\": 2\n },\n \"reason\": \"نقص في العدد الفعلي عند الاستلام\",\n \"handover_report_id\": {{handover_report_id}},\n \"contract_id\": {{contract_id}}\n}" } } } ] }, { "name": "US-015: جدولة وتنفيذ الزيارة الطارئة - CRUD كامل", "description": "إنشاء زيارة طوارئ، إرسال الفني، تسجيل الوصول، إكمال الزيارة مع التقرير، تصعيد", "item": [ { "name": "Step 1: إنشاء زيارة طوارئ من بلاغ", "description": "POST /visits/emergency\nإنشاء زيارة طوارئ عاجلة مع تعيين الفنيين وتتبع SLA", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/emergency", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"maintenance_request_id\": {{request_id}},\n \"maintenance_location_id\": {{location_id}},\n \"maintenance_asset_id\": {{asset_id}},\n \"technician_ids\": [{{technician_id}}],\n \"scheduled_at\": \"2026-02-22 14:00:00\",\n \"fault_severity\": \"critical\",\n \"estimated_duration\": 3,\n \"estimated_duration_unit\": \"hours\",\n \"supervisor_id\": {{technician_id}},\n \"notes\": \"توقف كامل في نظام التبريد - مستودع أدوية - حالة طوارئ\"\n}" } } }, { "name": "Step 2: إرسال الفني (Dispatch)", "description": "POST /visits/{id}/dispatch\nإرسال الفني للموقع مع ملاحظات", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/dispatch", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"technician_ids\": [{{technician_id}}],\n \"dispatch_notes\": \"تم إرسال الفني أحمد - الوصول المتوقع خلال 30 دقيقة\"\n}" } } }, { "name": "Step 3: تسجيل وصول الفني", "description": "POST /visits/{id}/technician-arrived\nتسجيل وصول الفني للموقع وحساب وقت الاستجابة", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/technician-arrived", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "Step 4: إكمال زيارة الطوارئ + التقرير", "description": "POST /visits/{id}/complete-emergency\nإكمال الزيارة مع تقرير مفصل وإغلاق البلاغ", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/complete-emergency", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"report\": {\n \"fault_description\": \"توقف ضاغط التبريد بسبب ارتفاع الحرارة\",\n \"work_performed\": \"تم استبدال الضاغط وشحن غاز الفريون وفحص التسرب\",\n \"recommendations\": \"فحص دوري كل شهر لمنع تكرار المشكلة\",\n \"root_cause\": \"انسداد في مجرى الهواء أدى لارتفاع حرارة الضاغط\",\n \"actual_severity\": \"critical\",\n \"repair_type\": \"emergency\"\n },\n \"close_request\": true\n}" } } }, { "name": "تصعيد زيارة الطوارئ", "description": "POST /visits/{id}/escalate\nتصعيد الزيارة لمشرف أعلى أو تغيير الفني", "request": { "method": "POST", "url": "{{base_url}}/maintenance/visits/{{visit_id}}/escalate", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"technician_ids\": [{{technician_id}}],\n \"supervisor_id\": {{technician_id}},\n \"notes\": \"الفني الأول لم يتمكن من الإصلاح - تصعيد لفني متخصص\"\n}" } } } ] }, { "name": "US-003: إنشاء عرض سعر صيانة وقائية", "description": "إنشاء عرض سعر وقائي من عرض فني معتمد مع كل حقول التسعير وشروط التعاقد", "item": [ { "name": "إنشاء عرض سعر من عرض فني", "description": "POST /price-offers/from-technical-offer/{technicalOffer}\nإنشاء عرض سعر وقائي من عرض فني معتمد (بدون بيانات تسعير)\n\nالهدف: تحويل العرض الفني مباشرة لصفحة إنشاء عرض سعر مع بيانات مبدئية من العرض الفني", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/from-technical-offer/{{technical_offer_id}}", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": {{customer_id}},\n \"location_id\": {{location_id}},\n \"contract_type\": \"preventive\",\n \"visit_frequency\": \"quarterly\",\n \"estimated_visits_per_year\": 4,\n \"system_types\": [\"HVAC\", \"generators\"],\n \"approximate_unit_count\": 20,\n \"has_chiller\": true,\n \"consumables_required\": true,\n \"consumable_types\": [\"فلاتر\", \"زيوت\", \"شحوم\"],\n \"scope_of_work\": \"صيانة شاملة لجميع وحدات HVAC مع متابعة أسبوعية بناءً على العرض الفني\",\n \"notes\": \"عرض سعر مبدئي بناءً على العرض الفني المعتمد\",\n \"status\": \"pending_pricing\"\n}" } } }, { "name": "Step 1: حفظ كمسودة (Draft)", "description": "POST /price-offers/preventive/{technicalOffer}\nحفظ عرض السعر كمسودة مع بيانات التسعير الأساسية", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/preventive/{{technical_offer_id}}", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"chiller_visit_cost\": 1500,\n \"package_visit_cost\": 800,\n \"is_consumables_included\": true,\n \"consumables_cost\": 5000,\n \"consumable_types\": [\"فلاتر\", \"زيوت\", \"أحزمة\"],\n \"tax_percentage\": 15,\n \"payment_method\": \"quarterly\",\n \"payment_schedule\": [\n {\"amount\": 12500, \"due_date\": \"2026-04-01\"},\n {\"amount\": 12500, \"due_date\": \"2026-07-01\"},\n {\"amount\": 12500, \"due_date\": \"2026-10-01\"},\n {\"amount\": 12500, \"due_date\": \"2027-01-01\"}\n ],\n \"offer_validity_date\": \"2026-03-15\",\n \"inclusions\": \"صيانة وقائية دورية شاملة لجميع وحدات التكييف\\nفحص وتنظيف الفلاتر والمكثفات\\nقياس ضغط الغاز والتيار الكهربائي\",\n \"exclusions\": \"قطع الغيار الرئيسية (ضواغط، مراوح)\\nأعطال ناتجة عن سوء الاستخدام\\nالتمديدات الكهربائية\",\n \"contract_terms\": \"مدة العقد سنة واحدة قابلة للتجديد\\nالدفع ربع سنوي مقدم\\nإشعار قبل 30 يوم لعدم التجديد\",\n \"spare_parts_policy\": \"المستهلكات على حساب الشركة، قطع الغيار الرئيسية على حساب العميل\",\n \"status\": \"pending_pricing\"\n}" } } }, { "name": "Step 2: حفظ وإرسال للاعتماد", "description": "POST /price-offers/preventive/{technicalOffer}\nحفظ عرض السعر وإرساله للاعتماد مباشرة", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/preventive/{{technical_offer_id}}", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"chiller_visit_cost\": 1500,\n \"package_visit_cost\": 800,\n \"is_consumables_included\": true,\n \"consumables_cost\": 5000,\n \"tax_percentage\": 15,\n \"payment_method\": \"quarterly\",\n \"offer_validity_date\": \"2026-03-15\",\n \"inclusions\": \"صيانة وقائية دورية شاملة\",\n \"exclusions\": \"قطع الغيار الرئيسية\",\n \"status\": \"pending_approval\"\n}" } } }, { "name": "Step 3: تحديث التسعير", "description": "PUT /price-offers/{offer}\nتحديث بيانات التسعير لعرض موجود", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"chiller_visit_cost\": 1800,\n \"package_visit_cost\": 900,\n \"is_consumables_included\": true,\n \"consumables_cost\": 6000,\n \"discount_percentage\": 5,\n \"payment_method\": \"monthly\"\n}" } } }, { "name": "Step 4: اعتماد العرض (داخلي)", "description": "POST /price-offers/{offer}/approve", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/approve", "header": [ { "key": "Accept", "value": "application/json" } ] } }, { "name": "Step 5: اعتماد العميل", "description": "POST /price-offers/{offer}/customer-approve", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/customer-approve", "header": [ { "key": "Accept", "value": "application/json" } ] } }, { "name": "معاينة PDF", "description": "GET /price-offers/{offer}/pdf\nمعاينة فورية للعرض بدون حفظ", "request": { "method": "GET", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/pdf", "header": [ { "key": "Accept", "value": "application/pdf" } ] } }, { "name": "تصدير PDF", "description": "GET /price-offers/{offer}/pdf/download\nتحميل ملف PDF", "request": { "method": "GET", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/pdf/download", "header": [ { "key": "Accept", "value": "application/pdf" } ] } }, { "name": "إنشاء نسخة جديدة (Versioning)", "description": "POST /price-offers/{offer}/create-version\nإنشاء نسخة جديدة من عرض مرفوض", "request": { "method": "POST", "url": "{{base_url}}/maintenance/price-offers/{{price_offer_id}}/create-version", "header": [ { "key": "Accept", "value": "application/json" } ] } } ] }, { "name": "US-005: إنشاء عقد صيانة (الحقول الجديدة)", "description": "اختبار إنشاء عقد صيانة مع جميع الحقول الجديدة المضافة في US-005", "item": [ { "name": "إنشاء عقد مع كل الحقول الجديدة", "description": "POST /contracts\nإنشاء عقد صيانة شامل مع أطراف العقد، SLA، طريقة الدفع، الاستثناءات، الغرامات، التوقيعات", "request": { "method": "POST", "url": "{{base_url}}/maintenance/contracts", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": 1,\n \"project_id\": 1,\n \"contract_type\": \"preventive\",\n \"start_date\": \"2026-01-01\",\n \"end_date\": \"2026-12-31\",\n \"contract_value\": 120000,\n \"payment_method\": \"quarterly\",\n \"visit_frequency\": \"monthly\",\n \"annual_visits_count\": 12,\n \"notes\": \"عقد صيانة وقائية شامل\",\n \"is_consumables_included\": true,\n \"system_types\": [\"HVAC\"],\n \"has_chiller\": true,\n \"customer_contract_number\": \"CC-2026-0045\",\n \"contract_type_detail\": \"comprehensive\",\n \"first_party_name\": \"شركة نوارد للتقنية\",\n \"first_party_representative\": \"أحمد محمد\",\n \"first_party_id_number\": \"1234567890\",\n \"second_party_name\": \"مؤسسة العميل التجارية\",\n \"second_party_representative\": \"خالد عبدالله\",\n \"second_party_id_number\": \"0987654321\",\n \"contract_subject\": \"صيانة وقائية شاملة لأنظمة التكييف المركزي\",\n \"consumables_included\": [\"فلاتر\", \"زيوت\", \"شحوم\"],\n \"sla_response_hours\": 4,\n \"sla_resolution_hours\": 24,\n \"payment_method_detail\": \"دفعات ربع سنوية متساوية\",\n \"exclusions\": [\"أعطال سوء الاستخدام\", \"الكوارث الطبيعية\", \"التعديلات غير المصرح بها\"],\n \"penalties\": [\"غرامة 1% عن كل يوم تأخير\", \"خصم 5% في حال عدم الالتزام بالجدول\"],\n \"first_party_signature\": \"أحمد محمد - المدير العام\",\n \"second_party_signature\": \"خالد عبدالله - المدير التنفيذي\",\n \"expiry_alert_days\": 30,\n \"status\": \"draft\"\n}" } } } ] }, { "name": "الإعدادات: الأصول وأنواعها والمشاريع والمواقع", "description": "CRUD كامل للإعدادات والبيانات الأساسية", "item": [ { "name": "--- الأصول ---", "request": { "method": "GET", "url": "{{base_url}}/maintenance/assets?per_page=15" } }, { "name": "إنشاء أصل", "request": { "method": "POST", "url": "{{base_url}}/maintenance/assets", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"asset_type_id\": 1,\n \"equipment_name\": \"وحدة تكييف مركزي\",\n \"code\": \"AC-NEW-001\",\n \"model\": \"VRF-500\",\n \"serial_number\": \"SN-NEW-001\",\n \"manufacturer\": \"Daikin\",\n \"brand\": \"Daikin\",\n \"location_building\": \"المبنى الرئيسي\",\n \"electrical_voltage\": \"380V\",\n \"frequency\": \"50Hz\",\n \"asset_status\": \"سليم\",\n \"project_id\": 1\n}" } } }, { "name": "عرض أصل", "request": { "method": "GET", "url": "{{base_url}}/maintenance/assets/1" } }, { "name": "تعديل أصل", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/assets/1", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"equipment_name\": \"وحدة تكييف مركزي - محدث\",\n \"asset_status\": \"بحاجة إصلاح\"\n}" } } }, { "name": "حذف أصل", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/assets/1" } }, { "name": "استعادة أصل", "request": { "method": "POST", "url": "{{base_url}}/maintenance/assets/1/restore", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "أصولي", "request": { "method": "GET", "url": "{{base_url}}/maintenance/assets/my-assets" } }, { "name": "قوائم فحص الأصل", "request": { "method": "GET", "url": "{{base_url}}/maintenance/assets/1/checklists" } }, { "name": "جميع القوائم المطبقة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/assets/1/checklists/all" } }, { "name": "قوائم مع الأنواع", "request": { "method": "GET", "url": "{{base_url}}/maintenance/assets/1/checklists/with-types" } }, { "name": "إنشاء قائمة فحص", "request": { "method": "POST", "url": "{{base_url}}/maintenance/assets/1/checklists", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"فحص غاز التبريد\",\n \"items\": [\n \"فحص الضغط\",\n \"فحص التسرب\",\n \"قياس الحرارة\"\n ]\n}" } } }, { "name": "مزامنة القوائم", "request": { "method": "POST", "url": "{{base_url}}/maintenance/assets/1/checklists/sync", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"checklist_ids\": [\n 1,\n 2,\n 3\n ]\n}" } } }, { "name": "--- أنواع الأصول ---", "request": { "method": "GET", "url": "{{base_url}}/maintenance/asset-types" } }, { "name": "أنواع الأصول النشطة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/asset-types/active" } }, { "name": "الأنواع الجذرية", "request": { "method": "GET", "url": "{{base_url}}/maintenance/asset-types/roots" } }, { "name": "بحث أنواع", "request": { "method": "GET", "url": "{{base_url}}/maintenance/asset-types/search?q=تكييف" } }, { "name": "إنشاء نوع أصل", "request": { "method": "POST", "url": "{{base_url}}/maintenance/asset-types", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"مولد كهربائي\",\n \"parent_id\": null,\n \"is_active\": true\n}" } } }, { "name": "تعديل نوع أصل", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/asset-types/1", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"تكييف مركزي - محدث\"\n}" } } }, { "name": "حذف نوع أصل", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/asset-types/1" } }, { "name": "--- نطاقات العمل ---", "request": { "method": "GET", "url": "{{base_url}}/maintenance/scopes-of-work" } }, { "name": "نطاقات نشطة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/scopes-of-work/active" } }, { "name": "بحث نطاقات", "request": { "method": "GET", "url": "{{base_url}}/maintenance/scopes-of-work/search?q=فحص" } }, { "name": "إنشاء نطاق عمل", "request": { "method": "POST", "url": "{{base_url}}/maintenance/scopes-of-work", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"فحص وتنظيف المكثفات\",\n \"description\": \"فحص وتنظيف المكثفات الخارجية\"\n}" } } }, { "name": "تعديل نطاق عمل", "request": { "method": "PATCH", "url": "{{base_url}}/maintenance/scopes-of-work/1", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"فحص وتنظيف المكثفات - محدث\"\n}" } } }, { "name": "تفعيل/تعطيل نطاق", "request": { "method": "POST", "url": "{{base_url}}/maintenance/scopes-of-work/1/toggle-status", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "حذف نطاق عمل", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/scopes-of-work/1" } }, { "name": "--- أنواع العيوب ---", "request": { "method": "GET", "url": "{{base_url}}/maintenance/defect-types" } }, { "name": "أنواع عيوب نشطة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/defect-types/active" } }, { "name": "إنشاء نوع عيب", "request": { "method": "POST", "url": "{{base_url}}/maintenance/defect-types", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"تسرب غاز\",\n \"severity\": \"high\"\n}" } } }, { "name": "تعديل نوع عيب", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/defect-types/1", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"تسرب غاز - محدث\"\n}" } } }, { "name": "حذف نوع عيب", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/defect-types/1" } }, { "name": "--- سياسات SLA ---", "request": { "method": "GET", "url": "{{base_url}}/maintenance/sla-policies" } }, { "name": "سياسات نشطة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/sla-policies/list/active" } }, { "name": "إنشاء سياسة SLA", "request": { "method": "POST", "url": "{{base_url}}/maintenance/sla-policies", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"SLA طوارئ P1\",\n \"request_type\": \"emergency\",\n \"priority\": \"critical\",\n \"response_time_hours\": 2,\n \"resolution_time_hours\": 8\n}" } } }, { "name": "تعديل سياسة SLA", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/sla-policies/1", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"response_time_hours\": 1\n}" } } }, { "name": "حذف سياسة", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/sla-policies/1" } }, { "name": "--- تتبع SLA ---", "request": { "method": "GET", "url": "{{base_url}}/maintenance/sla-tracking" } }, { "name": "المخالفات", "request": { "method": "GET", "url": "{{base_url}}/maintenance/sla-tracking/breaches" } }, { "name": "الملتزم بها", "request": { "method": "GET", "url": "{{base_url}}/maintenance/sla-tracking/compliant" } }, { "name": "المقاييس", "request": { "method": "GET", "url": "{{base_url}}/maintenance/sla-tracking/metrics" } }, { "name": "التقرير", "request": { "method": "GET", "url": "{{base_url}}/maintenance/sla-tracking/report" } }, { "name": "--- المشاريع ---", "request": { "method": "GET", "url": "{{base_url}}/maintenance/projects?per_page=15" } }, { "name": "إنشاء مشروع", "request": { "method": "POST", "url": "{{base_url}}/maintenance/projects", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"مشروع صيانة مبنى A\",\n \"customer_id\": 1,\n \"contract_id\": 1,\n \"start_date\": \"2026-01-01\",\n \"status\": \"active\"\n}" } } }, { "name": "عرض مشروع", "request": { "method": "GET", "url": "{{base_url}}/maintenance/projects/1" } }, { "name": "تفاصيل مشروع", "request": { "method": "GET", "url": "{{base_url}}/maintenance/projects/1/details" } }, { "name": "تعديل مشروع", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/projects/1", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"مشروع صيانة - محدث\"\n}" } } }, { "name": "حذف مشروع", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/projects/1" } }, { "name": "مواقع المشروع", "request": { "method": "GET", "url": "{{base_url}}/maintenance/projects/1/locations" } }, { "name": "إنشاء موقع", "request": { "method": "POST", "url": "{{base_url}}/maintenance/projects/1/locations", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"المبنى الرئيسي - الطابق 1\",\n \"address\": \"الرياض\"\n}" } } }, { "name": "تعديل موقع", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/projects/1/locations/1", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"موقع محدث\"\n}" } } }, { "name": "حذف موقع", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/projects/1/locations/1" } }, { "name": "--- المواقع ---", "request": { "method": "GET", "url": "{{base_url}}/maintenance/locations/1" } }, { "name": "ملخص الموقع", "request": { "method": "GET", "url": "{{base_url}}/maintenance/locations/1/summary" } }, { "name": "أصول الموقع", "request": { "method": "GET", "url": "{{base_url}}/maintenance/locations/1/assets" } }, { "name": "زيارات الموقع", "request": { "method": "GET", "url": "{{base_url}}/maintenance/locations/1/visits" } }, { "name": "ربط أصول بالموقع", "request": { "method": "POST", "url": "{{base_url}}/maintenance/locations/1/link-assets", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"asset_ids\": [\n 1,\n 2\n ]\n}" } } }, { "name": "تغيير حالة الموقع", "request": { "method": "PATCH", "url": "{{base_url}}/maintenance/locations/1/status", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"active\"\n}" } } }, { "name": "تعديل موقع", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/locations/1", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"موقع محدث\"\n}" } } }, { "name": "حذف موقع", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/locations/1" } }, { "name": "--- الفواتير ---", "request": { "method": "GET", "url": "{{base_url}}/maintenance/invoices?per_page=15" } }, { "name": "إنشاء فاتورة", "request": { "method": "POST", "url": "{{base_url}}/maintenance/invoices", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"customer_id\": 1,\n \"contract_id\": 1,\n \"amount\": 5000,\n \"notes\": \"فاتورة ربع سنوية\"\n}" } } }, { "name": "عرض فاتورة", "request": { "method": "GET", "url": "{{base_url}}/maintenance/invoices/1" } }, { "name": "تعديل فاتورة", "request": { "method": "PUT", "url": "{{base_url}}/maintenance/invoices/1", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"amount\": 5500\n}" } } }, { "name": "حذف فاتورة", "request": { "method": "DELETE", "url": "{{base_url}}/maintenance/invoices/1" } }, { "name": "استعادة فاتورة", "request": { "method": "POST", "url": "{{base_url}}/maintenance/invoices/1/restore", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ] } }, { "name": "--- سجل الطلبات ---", "request": { "method": "GET", "url": "{{base_url}}/maintenance/request-history" } }, { "name": "سجل طلب معين", "request": { "method": "GET", "url": "{{base_url}}/maintenance/request-history/request/{{request_id}}" } }, { "name": "الجدول الزمني", "request": { "method": "GET", "url": "{{base_url}}/maintenance/request-history/timeline/{{request_id}}" } }, { "name": "--- بيانات النماذج ---", "request": { "method": "GET", "url": "{{base_url}}/maintenance/form/scope-of-works" } }, { "name": "إنشاء نطاق عمل (نموذج)", "request": { "method": "POST", "url": "{{base_url}}/maintenance/form/scope-of-works", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"نطاق جديد\"\n}" } } }, { "name": "أنواع الأصول (نموذج)", "request": { "method": "GET", "url": "{{base_url}}/maintenance/form/asset-types" } }, { "name": "إنشاء موقع (نموذج)", "request": { "method": "POST", "url": "{{base_url}}/maintenance/form/locations", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"موقع جديد\",\n \"project_id\": 1\n}" } } }, { "name": "إنشاء جهة اتصال (نموذج)", "request": { "method": "POST", "url": "{{base_url}}/maintenance/form/contacts", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"جهة اتصال جديدة\",\n \"phone\": \"0500000000\",\n \"customer_id\": 1\n}" } } } ] } ] }