1 line
28 KiB
JSON
1 line
28 KiB
JSON
{"openapi":"3.1.0","info":{"title":"Gig POC API","description":"Gig POC 接口文档。\n\n接口分组：系统、抽取、入库、匹配、查询。\n完整业务说明请参考项目文档 `docs/API.md`。","version":"0.1.0"},"paths":{"/health":{"get":{"tags":["系统"],"summary":"服务健康检查","description":"检查 API 服务、数据库与 RAG 检索组件状态。","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthStatus"}}}}}}},"/poc/extract/job":{"post":{"tags":["抽取"],"summary":"岗位文本抽取","description":"将岗位自然语言文本抽取为结构化 JobCard。","operationId":"extract_job_poc_extract_job_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtractTextRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtractResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/poc/extract/worker":{"post":{"tags":["抽取"],"summary":"工人文本抽取","description":"将工人自然语言文本抽取为结构化 WorkerCard。","operationId":"extract_worker_poc_extract_worker_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtractTextRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtractResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/poc/ingest/job":{"post":{"tags":["入库"],"summary":"岗位入库","description":"写入或更新岗位卡片，并同步更新检索索引。","operationId":"ingest_job_poc_ingest_job_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngestJobRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobCard-Output"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/poc/ingest/worker":{"post":{"tags":["入库"],"summary":"工人入库","description":"写入或更新工人卡片，并同步更新检索索引。","operationId":"ingest_worker_poc_ingest_worker_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngestWorkerRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkerCard"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/poc/ingest/job/async":{"post":{"tags":["入库"],"summary":"岗位异步入库","description":"将岗位入库请求写入异步队列，快速返回任务 ID。","operationId":"ingest_job_async_poc_ingest_job_async_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngestJobRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngestAsyncResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/poc/ingest/worker/async":{"post":{"tags":["入库"],"summary":"工人异步入库","description":"将工人入库请求写入异步队列，快速返回任务 ID。","operationId":"ingest_worker_async_poc_ingest_worker_async_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngestWorkerRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngestAsyncResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/poc/ingest/queue/{task_id}":{"get":{"tags":["入库"],"summary":"异步入库任务状态","description":"根据 task_id 查询异步入库任务状态。","operationId":"ingest_task_status_poc_ingest_queue__task_id__get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngestAsyncResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/poc/ingest/bootstrap":{"post":{"tags":["入库"],"summary":"样本数据初始化","description":"导入内置样本数据（岗位、工人、技能、类目、区域）并构建检索数据。","operationId":"bootstrap_poc_ingest_bootstrap_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BootstrapResponse"}}}}}}},"/poc/match/workers":{"post":{"tags":["匹配"],"summary":"岗位匹配工人","description":"支持通过 job_id 或内联 job 进行匹配，返回 top_n 条结果。","operationId":"match_workers_poc_match_workers_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchWorkersRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchResponse"}}}},"404":{"description":"岗位不存在"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/poc/match/jobs":{"post":{"tags":["匹配"],"summary":"工人匹配岗位","description":"支持通过 worker_id 或内联 worker 进行匹配，返回 top_n 条结果。","operationId":"match_jobs_poc_match_jobs_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchJobsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchResponse"}}}},"404":{"description":"工人不存在"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/poc/match/workers/async":{"post":{"tags":["匹配"],"summary":"岗位异步匹配工人","description":"将匹配任务放入队列异步计算，适合高并发削峰。","operationId":"match_workers_async_poc_match_workers_async_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchAsyncWorkersRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchAsyncResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/poc/match/jobs/async":{"post":{"tags":["匹配"],"summary":"工人异步匹配岗位","description":"将匹配任务放入队列异步计算，适合高并发削峰。","operationId":"match_jobs_async_poc_match_jobs_async_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchAsyncJobsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchAsyncResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/poc/match/queue/{task_id}":{"get":{"tags":["匹配"],"summary":"异步匹配任务状态","description":"根据 task_id 查询异步匹配任务状态，完成后返回匹配结果。","operationId":"match_task_status_poc_match_queue__task_id__get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchAsyncResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/poc/match/explain/{match_id}":{"get":{"tags":["匹配"],"summary":"匹配结果解释","description":"根据 match_id 获取匹配明细和解释理由。","operationId":"explain_match_poc_match_explain__match_id__get","parameters":[{"name":"match_id","in":"path","required":true,"schema":{"type":"string","description":"匹配记录 ID","title":"Match Id"},"description":"匹配记录 ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExplainResponse"}}}},"404":{"description":"匹配记录不存在"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/poc/match/feedback":{"post":{"tags":["匹配"],"summary":"匹配反馈学习","description":"提交单条匹配的接受/拒绝反馈，用于在线更新排序权重。","operationId":"feedback_match_poc_match_feedback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchFeedbackRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchWeightResponse"}}}},"404":{"description":"匹配记录不存在"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/poc/match/weights":{"get":{"tags":["匹配"],"summary":"当前排序权重","description":"查看当前生效的排序权重（默认权重或学习后的权重）。","operationId":"get_match_weights_poc_match_weights_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchWeightResponse"}}}}}}},"/poc/ops/ai/metrics":{"get":{"tags":["系统"],"summary":"AI 观测指标","description":"返回 AI 调用的限流、熔断、降级与 fallback 命中率指标。","operationId":"ai_metrics_poc_ops_ai_metrics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIObservabilityResponse"}}}}}}},"/poc/ops/system/metrics":{"get":{"tags":["系统"],"summary":"系统运行指标","description":"返回全局流量护栏、缓存与异步队列指标。","operationId":"system_metrics_poc_ops_system_metrics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SystemOpsResponse"}}}}}}},"/poc/jobs":{"get":{"tags":["查询"],"summary":"岗位列表查询","description":"查询岗位列表，当前返回全量数据。","operationId":"list_jobs_poc_jobs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse"}}}}}}},"/poc/workers":{"get":{"tags":["查询"],"summary":"工人列表查询","description":"查询工人列表，当前返回全量数据。","operationId":"list_workers_poc_workers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse"}}}}}}},"/poc/jobs/{job_id}":{"get":{"tags":["查询"],"summary":"岗位详情查询","description":"根据岗位 ID 查询单个岗位详情。","operationId":"get_job_poc_jobs__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","description":"岗位 ID","title":"Job Id"},"description":"岗位 ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobCard-Output"}}}},"404":{"description":"岗位不存在"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/poc/workers/{worker_id}":{"get":{"tags":["查询"],"summary":"工人详情查询","description":"根据工人 ID 查询单个工人详情。","operationId":"get_worker_poc_workers__worker_id__get","parameters":[{"name":"worker_id","in":"path","required":true,"schema":{"type":"string","description":"工人 ID","title":"Worker Id"},"description":"工人 ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkerCard"}}}},"404":{"description":"工人不存在"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AIObservabilityResponse":{"properties":{"metrics":{"additionalProperties":{"anyOf":[{"type":"number"},{"type":"integer"}]},"type":"object","title":"Metrics","description":"AI 调用观测指标"}},"type":"object","required":["metrics"],"title":"AIObservabilityResponse"},"BootstrapResponse":{"properties":{"jobs":{"type":"integer","title":"Jobs","description":"导入岗位数量"},"workers":{"type":"integer","title":"Workers","description":"导入工人数量"},"skills":{"type":"integer","title":"Skills","description":"技能词条数量"},"categories":{"type":"integer","title":"Categories","description":"类目数量"},"regions":{"type":"integer","title":"Regions","description":"区域数量"}},"type":"object","required":["jobs","workers","skills","categories","regions"],"title":"BootstrapResponse"},"ExplainResponse":{"properties":{"match":{"$ref":"#/components/schemas/MatchResult","description":"单条匹配结果详情"}},"type":"object","required":["match"],"title":"ExplainResponse"},"ExtractResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"抽取是否成功"},"data":{"anyOf":[{"$ref":"#/components/schemas/JobCard-Output"},{"$ref":"#/components/schemas/WorkerCard"},{"type":"null"}],"title":"Data","description":"抽取结果对象，可能为空"},"errors":{"items":{"type":"string"},"type":"array","title":"Errors","description":"错误信息列表"},"missing_fields":{"items":{"type":"string"},"type":"array","title":"Missing Fields","description":"缺失字段列表"}},"type":"object","required":["success"],"title":"ExtractResponse"},"ExtractTextRequest":{"properties":{"text":{"type":"string","minLength":5,"title":"Text","description":"待抽取的自然语言文本，最少 5 个字符"}},"type":"object","required":["text"],"title":"ExtractTextRequest","example":{"text":"明天下午南山会展中心需要2个签到协助，5小时，150/人，女生优先"}},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthStatus":{"properties":{"service":{"type":"string","title":"Service","description":"服务状态，通常为 ok"},"database":{"type":"string","title":"Database","description":"数据库状态：ok 或 error"},"rag":{"type":"string","title":"Rag","description":"RAG 组件状态：ok 或 error"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"服务端当前时间"}},"type":"object","required":["service","database","rag","timestamp"],"title":"HealthStatus"},"IngestAsyncResponse":{"properties":{"task_id":{"type":"string","title":"Task Id","description":"异步任务 ID"},"status":{"type":"string","title":"Status","description":"任务状态"}},"type":"object","required":["task_id","status"],"title":"IngestAsyncResponse"},"IngestJobRequest":{"properties":{"job":{"$ref":"#/components/schemas/JobCard-Input","description":"岗位卡片对象"}},"type":"object","required":["job"],"title":"IngestJobRequest"},"IngestWorkerRequest":{"properties":{"worker":{"$ref":"#/components/schemas/WorkerCard","description":"工人卡片对象"}},"type":"object","required":["worker"],"title":"IngestWorkerRequest"},"JobCard-Input":{"properties":{"job_id":{"type":"string","title":"Job Id","description":"岗位唯一 ID"},"title":{"type":"string","title":"Title","description":"岗位标题"},"category":{"type":"string","title":"Category","description":"岗位类别"},"description":{"type":"string","title":"Description","description":"岗位描述"},"skills":{"items":{"type":"string"},"type":"array","title":"Skills","description":"岗位技能要求列表"},"city":{"type":"string","title":"City","description":"城市"},"region":{"type":"string","title":"Region","description":"区域"},"location_detail":{"type":"string","title":"Location Detail","description":"详细地点描述"},"start_time":{"type":"string","format":"date-time","title":"Start Time","description":"岗位开始时间，ISO-8601"},"duration_hours":{"type":"number","exclusiveMinimum":0.0,"title":"Duration Hours","description":"工时（小时），必须大于 0"},"headcount":{"type":"integer","exclusiveMinimum":0.0,"title":"Headcount","description":"招聘人数，必须大于 0"},"salary":{"$ref":"#/components/schemas/Salary","description":"薪资信息"},"work_mode":{"type":"string","title":"Work Mode","description":"工作模式，如兼职、全职、活动"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"业务标签列表"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence","description":"数据置信度，范围 0~1"}},"type":"object","required":["job_id","title","category","description","city","region","location_detail","start_time","duration_hours","headcount","salary","work_mode","confidence"],"title":"JobCard"},"JobCard-Output":{"properties":{"job_id":{"type":"string","title":"Job Id","description":"岗位唯一 ID"},"title":{"type":"string","title":"Title","description":"岗位标题"},"category":{"type":"string","title":"Category","description":"岗位类别"},"description":{"type":"string","title":"Description","description":"岗位描述"},"skills":{"items":{"type":"string"},"type":"array","title":"Skills","description":"岗位技能要求列表"},"city":{"type":"string","title":"City","description":"城市"},"region":{"type":"string","title":"Region","description":"区域"},"location_detail":{"type":"string","title":"Location Detail","description":"详细地点描述"},"start_time":{"type":"string","format":"date-time","title":"Start Time","description":"岗位开始时间，ISO-8601"},"duration_hours":{"type":"number","exclusiveMinimum":0.0,"title":"Duration Hours","description":"工时（小时），必须大于 0"},"headcount":{"type":"integer","exclusiveMinimum":0.0,"title":"Headcount","description":"招聘人数，必须大于 0"},"salary":{"$ref":"#/components/schemas/Salary","description":"薪资信息"},"work_mode":{"type":"string","title":"Work Mode","description":"工作模式，如兼职、全职、活动"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"业务标签列表"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence","description":"数据置信度，范围 0~1"}},"type":"object","required":["job_id","title","category","description","city","region","location_detail","start_time","duration_hours","headcount","salary","work_mode","confidence"],"title":"JobCard"},"ListResponse":{"properties":{"items":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Items","description":"列表项"},"total":{"type":"integer","title":"Total","description":"总数"}},"type":"object","required":["items","total"],"title":"ListResponse"},"MatchAsyncJobsRequest":{"properties":{"worker_id":{"type":"string","title":"Worker Id","description":"工人 ID"},"top_n":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Top N","description":"返回条数，范围 1~50","default":10}},"type":"object","required":["worker_id"],"title":"MatchAsyncJobsRequest"},"MatchAsyncResponse":{"properties":{"task_id":{"type":"string","title":"Task Id","description":"异步任务 ID"},"status":{"type":"string","title":"Status","description":"任务状态"},"items":{"anyOf":[{"items":{"$ref":"#/components/schemas/MatchResult"},"type":"array"},{"type":"null"}],"title":"Items","description":"任务完成后返回的匹配结果"}},"type":"object","required":["task_id","status"],"title":"MatchAsyncResponse"},"MatchAsyncWorkersRequest":{"properties":{"job_id":{"type":"string","title":"Job Id","description":"岗位 ID"},"top_n":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Top N","description":"返回条数，范围 1~50","default":10}},"type":"object","required":["job_id"],"title":"MatchAsyncWorkersRequest"},"MatchBreakdown":{"properties":{"skill_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Skill Score","description":"技能匹配分，范围 0~1"},"region_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Region Score","description":"地域匹配分，范围 0~1"},"time_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Time Score","description":"时间匹配分，范围 0~1"},"experience_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Experience Score","description":"经验匹配分，范围 0~1"},"reliability_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Reliability Score","description":"可靠性匹配分，范围 0~1"}},"type":"object","required":["skill_score","region_score","time_score","experience_score","reliability_score"],"title":"MatchBreakdown"},"MatchFeedbackRequest":{"properties":{"match_id":{"type":"string","title":"Match Id","description":"匹配记录 ID"},"accepted":{"type":"boolean","title":"Accepted","description":"反馈是否接受该推荐"}},"type":"object","required":["match_id","accepted"],"title":"MatchFeedbackRequest"},"MatchJobsRequest":{"properties":{"worker_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Worker Id","description":"工人 ID（与 worker 二选一）"},"worker":{"anyOf":[{"$ref":"#/components/schemas/WorkerCard"},{"type":"null"}],"description":"内联工人对象（与 worker_id 二选一）"},"top_n":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Top N","description":"返回条数，范围 1~50","default":10}},"type":"object","title":"MatchJobsRequest"},"MatchResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/MatchResult"},"type":"array","title":"Items","description":"匹配结果列表"}},"type":"object","required":["items"],"title":"MatchResponse"},"MatchResult":{"properties":{"match_id":{"type":"string","title":"Match Id","description":"匹配记录 ID"},"source_type":{"$ref":"#/components/schemas/SourceType","description":"匹配方向：job_to_worker 或 worker_to_job"},"source_id":{"type":"string","title":"Source Id","description":"源实体 ID"},"target_id":{"type":"string","title":"Target Id","description":"目标实体 ID"},"match_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Match Score","description":"综合匹配分，范围 0~1"},"breakdown":{"$ref":"#/components/schemas/MatchBreakdown","description":"多维打分拆解"},"reasons":{"items":{"type":"string"},"type":"array","minItems":3,"title":"Reasons","description":"匹配理由，至少 3 条"}},"type":"object","required":["match_id","source_type","source_id","target_id","match_score","breakdown"],"title":"MatchResult"},"MatchWeightResponse":{"properties":{"weights":{"additionalProperties":{"type":"number"},"type":"object","title":"Weights","description":"当前生效的排序权重"},"learning_enabled":{"type":"boolean","title":"Learning Enabled","description":"是否开启在线学习"}},"type":"object","required":["weights","learning_enabled"],"title":"MatchWeightResponse"},"MatchWorkersRequest":{"properties":{"job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id","description":"岗位 ID（与 job 二选一）"},"job":{"anyOf":[{"$ref":"#/components/schemas/JobCard-Input"},{"type":"null"}],"description":"内联岗位对象（与 job_id 二选一）"},"top_n":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Top N","description":"返回条数，范围 1~50","default":10}},"type":"object","title":"MatchWorkersRequest"},"QueueStatusResponse":{"properties":{"queued":{"type":"integer","title":"Queued","description":"当前队列中任务数量"},"processed":{"type":"integer","title":"Processed","description":"历史处理成功数量"},"failed":{"type":"integer","title":"Failed","description":"历史处理失败数量"}},"type":"object","required":["queued","processed","failed"],"title":"QueueStatusResponse"},"Salary":{"properties":{"type":{"$ref":"#/components/schemas/SalaryType","description":"薪资类型：daily/hourly/monthly/task","default":"daily"},"amount":{"type":"number","title":"Amount","description":"薪资金额","default":0},"currency":{"type":"string","title":"Currency","description":"货币类型，默认 CNY","default":"CNY"}},"type":"object","title":"Salary"},"SalaryType":{"type":"string","enum":["daily","hourly","monthly","task"],"title":"SalaryType"},"SkillScore":{"properties":{"name":{"type":"string","title":"Name","description":"技能名称"},"score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Score","description":"技能熟练度，范围 0~1"}},"type":"object","required":["name","score"],"title":"SkillScore"},"SourceType":{"type":"string","enum":["job_to_worker","worker_to_job"],"title":"SourceType"},"SystemOpsResponse":{"properties":{"traffic":{"additionalProperties":{"anyOf":[{"type":"number"},{"type":"integer"}]},"type":"object","title":"Traffic","description":"全局流量护栏与错误窗口指标"},"cache":{"additionalProperties":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"string"}]},"type":"object","title":"Cache","description":"缓存命中与大小"},"ingest_queue":{"$ref":"#/components/schemas/QueueStatusResponse","description":"异步入库队列状态"},"match_queue":{"$ref":"#/components/schemas/QueueStatusResponse","description":"异步匹配队列状态"}},"type":"object","required":["traffic","cache","ingest_queue","match_queue"],"title":"SystemOpsResponse"},"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"},"WorkerCard":{"properties":{"worker_id":{"type":"string","title":"Worker Id","description":"工人唯一 ID"},"name":{"type":"string","title":"Name","description":"工人姓名或昵称"},"description":{"type":"string","title":"Description","description":"工人自我描述"},"skills":{"items":{"$ref":"#/components/schemas/SkillScore"},"type":"array","title":"Skills","description":"技能及熟练度列表"},"cities":{"items":{"type":"string"},"type":"array","title":"Cities","description":"可接单城市列表"},"regions":{"items":{"type":"string"},"type":"array","title":"Regions","description":"可接单区域列表"},"availability":{"items":{"type":"string"},"type":"array","title":"Availability","description":"可上岗时间描述"},"experience_tags":{"items":{"type":"string"},"type":"array","title":"Experience Tags","description":"经验标签列表"},"reliability_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Reliability Score","description":"履约可靠性分，范围 0~1"},"profile_completion":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Profile Completion","description":"档案完善度，范围 0~1"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence","description":"数据置信度，范围 0~1"}},"type":"object","required":["worker_id","name","description","reliability_score","profile_completion","confidence"],"title":"WorkerCard"}}},"tags":[{"name":"系统","description":"服务与依赖组件状态检查接口"},{"name":"抽取","description":"自然语言文本抽取为结构化卡片"},{"name":"入库","description":"结构化岗位/工人数据写入与初始化"},{"name":"匹配","description":"岗位与工人双向匹配及结果解释"},{"name":"查询","description":"岗位/工人列表与详情查询"}]} |