pcb-defect-detector-project/Finql-Project

1{"openapi":"3.1.0","info":{"title":"PCB Defect Detection API","description":"API لكشف عيوب PCB مع تحديد الخطورة وتوصيات ذكية","version":"3.0.0"},"paths":{"/":{"get":{"tags":["General"],"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Root  Get"}}}}}}},"/health":{"get":{"tags":["General"],"summary":"Health Check","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/detect":{"post":{"tags":["Detection"],"summary":"Detect Defects","operationId":"detect_defects_detect_post","parameters":[{"name":"conf_threshold","in":"query","required":false,"schema":{"type":"number","maximum":0.9,"minimum":0.1,"default":0.5,"title":"Conf Threshold"}},{"name":"iou_threshold","in":"query","required":false,"schema":{"type":"number","maximum":0.9,"minimum":0.1,"default":0.45,"title":"Iou Threshold"}},{"name":"max_det","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":300,"title":"Max Det"}},{"name":"imgsz","in":"query","required":false,"schema":{"type":"integer","maximum":1280,"minimum":320,"default":640,"title":"Imgsz"}},{"name":"classes_filter","in":"query","required":false,"schema":{"type":"string","title":"Classes Filter"}},{"name":"agnostic_nms","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Agnostic Nms"}},{"name":"half_precision","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Half Precision"}},{"name":"return_annotated","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Return Annotated"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","pattern":"^(ar|en)$","default":"en","title":"Lang"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_detect_defects_detect_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DetectResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/report":{"post":{"tags":["Reports"],"summary":"Generate Board Report","operationId":"generate_board_report_report_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_generate_board_report_report_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Body_detect_defects_detect_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["file"],"title":"Body_detect_defects_detect_post"},"Body_generate_board_report_report_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"},"board_id":{"type":"string","title":"Board Id"},"conf_threshold":{"type":"number","maximum":0.9,"minimum":0.1,"title":"Conf Threshold","default":0.5},"iou_threshold":{"type":"number","maximum":0.9,"minimum":0.1,"title":"Iou Threshold","default":0.45},"max_det":{"type":"integer","maximum":1000.0,"minimum":1.0,"title":"Max Det","default":300},"imgsz":{"type":"integer","maximum":1280.0,"minimum":320.0,"title":"Imgsz","default":640},"classes_filter":{"type":"string","title":"Classes Filter"},"agnostic_nms":{"type":"boolean","title":"Agnostic Nms","default":false},"half_precision":{"type":"boolean","title":"Half Precision","default":false},"lang":{"type":"string","title":"Lang","default":"en"}},"type":"object","required":["file","board_id"],"title":"Body_generate_board_report_report_post"},"DetectResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"num_defects":{"type":"integer","title":"Num Defects"},"detections":{"items":{"$ref":"#/components/schemas/Detection"},"type":"array","title":"Detections"},"annotated_image_base64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Annotated Image Base64"},"processing_time_ms":{"type":"number","title":"Processing Time Ms"},"timestamp":{"type":"string","title":"Timestamp"},"parameters_used":{"type":"object","title":"Parameters Used"},"summary":{"type":"object","title":"Summary"},"recommendations":{"type":"object","title":"Recommendations"},"board_decision":{"type":"string","title":"Board Decision"}},"type":"object","required":["success","num_defects","detections","processing_time_ms","timestamp","parameters_used","summary","recommendations","board_decision"],"title":"DetectResponse"},"Detection":{"properties":{"defect_type":{"type":"string","title":"Defect Type","description":"نوع العيب (بالإنجليزية)"},"defect_type_ar":{"type":"string","title":"Defect Type Ar","description":"نوع العيب (بالعربية)"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence","description":"نسبة الثقة (0-1)"},"bbox":{"items":{"type":"integer"},"type":"array","title":"Bbox","description":"مربع الإحاطة [x1, y1, x2, y2]"},"severity_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Severity Score","description":"نسبة الخطورة (0-10)"},"severity_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Severity Level","description":"مستوى الخطورة"},"severity_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Severity Color","description":"لون الخطورة"},"severity_icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Severity Icon","description":"أيقونة الخطورة"},"description_ar":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description Ar","description":"وصف العيب بالعربية"},"recommendation_ar":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recommendation Ar","description":"توصية مقترحة"}},"type":"object","required":["defect_type","defect_type_ar","confidence","bbox"],"title":"Detection","description":"معلومات عيب واحد"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"model_loaded":{"type":"boolean","title":"Model Loaded"},"model_path":{"type":"string","title":"Model Path"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","model_loaded","model_path","timestamp"],"title":"HealthResponse"},"ReportResponse":{"properties":{"board_id":{"type":"string","title":"Board Id"},"inspection_date":{"type":"string","title":"Inspection Date"},"total_defects":{"type":"integer","title":"Total Defects"},"defects":{"items":{"$ref":"#/components/schemas/Detection"},"type":"array","title":"Defects"},"summary":{"type":"object","title":"Summary"},"parameters_used":{"type":"object","title":"Parameters Used"},"recommendations":{"type":"object","title":"Recommendations"},"board_decision":{"type":"string","title":"Board Decision"},"report_html":{"type":"string","title":"Report Html"}},"type":"object","required":["board_id","inspection_date","total_defects","defects","summary","parameters_used","recommendations","board_decision","report_html"],"title":"ReportResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}