{"openapi":"3.1.0","info":{"title":"AI 消防员政民互动智能体","description":"济南市历下区消防救援大队 AI 消防员政民互动智能体 · 独立交付后端（/fire/v1）","version":"1.0.0"},"paths":{"/fire/v1/auth/login":{"post":{"tags":["认证"],"summary":"登录","operationId":"login_fire_v1_auth_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/auth/me":{"get":{"tags":["认证"],"summary":"当前用户信息","operationId":"me_fire_v1_auth_me_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/auth/me/password":{"post":{"tags":["认证"],"summary":"修改密码","operationId":"change_password_fire_v1_auth_me_password_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangePasswordIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/health":{"get":{"tags":["健康检查"],"summary":"服务健康检查","description":"无需鉴权的存活探针。","operationId":"health_fire_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/fire/v1/llm/health":{"get":{"tags":["健康检查"],"summary":"大模型健康检查","description":"检查大模型推理路由是否可用。","operationId":"llm_health_api_fire_v1_llm_health_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/wecom/health":{"get":{"tags":["健康检查"],"summary":"企业微信健康检查","description":"检查企业微信 Token 配置与会话存档游标。","operationId":"wecom_health_fire_v1_wecom_health_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/wecom/callback/{app_key}":{"get":{"tags":["企业微信"],"summary":"企业微信回调 URL 验证","description":"URL 验证：校验签名后回明文 echostr。","operationId":"callback_verify_fire_v1_wecom_callback__app_key__get","parameters":[{"name":"app_key","in":"path","required":true,"schema":{"type":"string","title":"App Key"}},{"name":"msg_signature","in":"query","required":false,"schema":{"type":"string","default":"","title":"Msg Signature"}},{"name":"timestamp","in":"query","required":false,"schema":{"type":"string","default":"","title":"Timestamp"}},{"name":"nonce","in":"query","required":false,"schema":{"type":"string","default":"","title":"Nonce"}},{"name":"echostr","in":"query","required":false,"schema":{"type":"string","default":"","title":"Echostr"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["企业微信"],"summary":"企业微信事件回调","description":"接收加密事件：验签 → 解密 → 分发 → 回 success。\n\nSandbox / 未配置 Token+AESKey：允许明文 XML（无 Encrypt 节点）直接分发，便于联调。\n生产：必须 Encrypt + 签名校验。","operationId":"callback_event_fire_v1_wecom_callback__app_key__post","parameters":[{"name":"app_key","in":"path","required":true,"schema":{"type":"string","title":"App Key"}},{"name":"msg_signature","in":"query","required":false,"schema":{"type":"string","default":"","title":"Msg Signature"}},{"name":"timestamp","in":"query","required":false,"schema":{"type":"string","default":"","title":"Timestamp"}},{"name":"nonce","in":"query","required":false,"schema":{"type":"string","default":"","title":"Nonce"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/wecom/token/refresh":{"post":{"tags":["企业微信"],"summary":"刷新企业微信 Token","operationId":"token_refresh_fire_v1_wecom_token_refresh_post","parameters":[{"name":"scope","in":"query","required":false,"schema":{"type":"string","default":"app","title":"Scope"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/archive/pull":{"post":{"tags":["企业微信"],"summary":"拉取会话存档","description":"手动触发存档拉取（sandbox 下模拟推进游标）。","operationId":"archive_pull_fire_v1_archive_pull_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/simulate/inbound":{"post":{"tags":["联调模拟"],"summary":"模拟入站消息","description":"模拟居民发消息 → 走回调分发（紧急/上报/问答）。","operationId":"simulate_inbound_fire_v1_simulate_inbound_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InboundIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/simulate/add_contact":{"post":{"tags":["联调模拟"],"summary":"模拟添加联系人","operationId":"simulate_add_contact_fire_v1_simulate_add_contact_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddContactIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/residents/insight":{"get":{"tags":["居民管理"],"summary":"居民洞察概览","description":"居民画像洞察聚合（年龄段/来源/区域/标签分布/群覆盖），供千人千面定向分析。","operationId":"residents_insight_fire_v1_residents_insight_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/residents":{"get":{"tags":["居民管理"],"summary":"居民列表","operationId":"list_residents_fire_v1_residents_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":20,"title":"Page Size"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["居民管理"],"summary":"创建居民","operationId":"create_resident_fire_v1_residents_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResidentIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/residents/{resident_id}/tags":{"post":{"tags":["居民管理"],"summary":"为居民打标签","operationId":"tag_resident_fire_v1_residents__resident_id__tags_post","parameters":[{"name":"resident_id","in":"path","required":true,"schema":{"type":"integer","title":"Resident Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__residents__TagIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/residents/target":{"post":{"tags":["居民管理"],"summary":"定向触达预览","description":"标签表达式定向预览（千人千面 / 群发目标）。","operationId":"target_preview_fire_v1_residents_target_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TargetIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/tags":{"get":{"tags":["标签"],"summary":"标签列表","operationId":"list_tags_fire_v1_tags_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["标签"],"summary":"创建或更新标签","operationId":"upsert_tag_fire_v1_tags_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__tags__TagIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/tags/rules":{"post":{"tags":["标签"],"summary":"创建打标规则","operationId":"create_rule_fire_v1_tags_rules_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RuleIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["标签"],"summary":"打标规则列表","operationId":"list_rules_fire_v1_tags_rules_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/groups":{"get":{"tags":["群组"],"summary":"群组列表","operationId":"list_groups_fire_v1_groups_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["群组"],"summary":"创建群组","operationId":"create_group_fire_v1_groups_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/groups/tree":{"get":{"tags":["群组"],"summary":"群组组织树","operationId":"group_tree_fire_v1_groups_tree_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/groups/coverage":{"get":{"tags":["群组"],"summary":"群组覆盖率","operationId":"coverage_fire_v1_groups_coverage_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/materials":{"get":{"tags":["素材"],"summary":"素材列表","operationId":"list_materials_fire_v1_materials_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":20,"title":"Page Size"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["素材"],"summary":"创建素材","operationId":"create_material_fire_v1_materials_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MaterialIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/materials/{material_id}/review":{"post":{"tags":["素材"],"summary":"素材审核","operationId":"review_fire_v1_materials__material_id__review_post","parameters":[{"name":"material_id","in":"path","required":true,"schema":{"type":"integer","title":"Material Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/materials/{material_id}/radar":{"get":{"tags":["素材"],"summary":"素材阅读雷达","operationId":"material_radar_fire_v1_materials__material_id__radar_get","parameters":[{"name":"material_id","in":"path","required":true,"schema":{"type":"integer","title":"Material Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/m/{token}":{"get":{"tags":["素材"],"summary":"素材落地页（H5）","description":"素材落地页：记录 open 事件并注入停留埋点。","operationId":"landing_fire_v1_m__token__get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/m/{token}/track":{"post":{"tags":["素材"],"summary":"素材阅读埋点","operationId":"track_fire_v1_m__token__track_post","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/campaigns":{"get":{"tags":["发布"],"summary":"活动 campaign 列表","operationId":"list_campaigns_fire_v1_campaigns_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["发布"],"summary":"创建 campaign","operationId":"create_campaign_fire_v1_campaigns_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/publish/tasks":{"get":{"tags":["发布"],"summary":"发布任务列表","operationId":"list_tasks_fire_v1_publish_tasks_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["发布"],"summary":"创建发布任务","operationId":"create_task_fire_v1_publish_tasks_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/publish/tasks/{task_id}/execute":{"post":{"tags":["发布"],"summary":"立即执行发布任务","description":"执行发布任务（高危：记审计）。","operationId":"execute_task_fire_v1_publish_tasks__task_id__execute_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"integer","title":"Task Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/publish/tasks/{task_id}/schedule":{"post":{"tags":["发布"],"summary":"定时发布任务","description":"将草稿任务排入 scheduled，供 Celery Beat 到点执行（D2）。","operationId":"schedule_task_fire_v1_publish_tasks__task_id__schedule_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"integer","title":"Task Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/activities":{"get":{"tags":["活动"],"summary":"活动列表","operationId":"list_activities_fire_v1_activities_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["活动"],"summary":"创建活动","operationId":"create_activity_fire_v1_activities_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/activities/{activity_id}/submit":{"post":{"tags":["活动"],"summary":"提交活动报名","description":"居民作答（公开，供 H5）。","operationId":"submit_fire_v1_activities__activity_id__submit_post","parameters":[{"name":"activity_id","in":"path","required":true,"schema":{"type":"integer","title":"Activity Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/reports":{"post":{"tags":["举报"],"summary":"提交举报","description":"公开上报入口（供 H5 表单/小程序）：文字/定位/图片/视频。","operationId":"create_report_fire_v1_reports_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["举报"],"summary":"举报列表","operationId":"list_reports_fire_v1_reports_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Page Size"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/tickets":{"get":{"tags":["工单"],"summary":"工单列表","operationId":"list_tickets_fire_v1_tickets_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":20,"title":"Page Size"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/tickets/{ticket_id}":{"get":{"tags":["工单"],"summary":"工单详情","operationId":"get_ticket_fire_v1_tickets__ticket_id__get","parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"integer","title":"Ticket Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/tickets/{ticket_id}/assign":{"post":{"tags":["工单"],"summary":"分派工单","operationId":"assign_fire_v1_tickets__ticket_id__assign_post","parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"integer","title":"Ticket Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/tickets/{ticket_id}/transition":{"post":{"tags":["工单"],"summary":"工单状态流转","operationId":"transition_fire_v1_tickets__ticket_id__transition_post","parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"integer","title":"Ticket Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransitionIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/tickets/{ticket_id}/satisfaction":{"post":{"tags":["工单"],"summary":"提交满意度评价","operationId":"satisfaction_fire_v1_tickets__ticket_id__satisfaction_post","parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"integer","title":"Ticket Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SatIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/tickets/scan-overdue":{"post":{"tags":["工单"],"summary":"扫描逾期工单","operationId":"scan_overdue_fire_v1_tickets_scan_overdue_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/venues":{"get":{"tags":["场所巡检"],"summary":"场所列表","operationId":"list_venues_fire_v1_venues_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":20,"title":"Page Size"}},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},{"name":"inspected","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Inspected"}},{"name":"risk_level","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Risk Level"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["场所巡检"],"summary":"创建场所","operationId":"create_venue_fire_v1_venues_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VenueIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/venues/{venue_id}/code":{"post":{"tags":["场所巡检"],"summary":"生成场所二维码","operationId":"issue_code_fire_v1_venues__venue_id__code_post","parameters":[{"name":"venue_id","in":"path","required":true,"schema":{"type":"integer","title":"Venue Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/venue/code/{token}.png":{"get":{"tags":["场所巡检"],"summary":"下载场所二维码图片","operationId":"code_png_fire_v1_venue_code__token__png_get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"sign","in":"query","required":false,"schema":{"type":"string","default":"","title":"Sign"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/venue/scan/{token}":{"get":{"tags":["场所巡检"],"summary":"场所扫码落地页","description":"负责人扫码落地页：验签 → 展示场所信息 + 引导加好友建档。","operationId":"scan_landing_fire_v1_venue_scan__token__get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"sign","in":"query","required":false,"schema":{"type":"string","default":"","title":"Sign"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/venues/{venue_id}/inspections":{"post":{"tags":["场所巡检"],"summary":"下发巡检任务","operationId":"push_inspection_fire_v1_venues__venue_id__inspections_post","parameters":[{"name":"venue_id","in":"path","required":true,"schema":{"type":"integer","title":"Venue Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InspectPushIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/inspections/{task_id}/submit":{"post":{"tags":["场所巡检"],"summary":"提交巡检结果","operationId":"submit_inspection_fire_v1_inspections__task_id__submit_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"integer","title":"Task Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InspectSubmitIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/rectifies":{"get":{"tags":["场所巡检"],"summary":"整改任务列表","operationId":"list_rectifies_fire_v1_rectifies_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/rectifies/{rectify_id}/verify":{"post":{"tags":["场所巡检"],"summary":"验收整改","operationId":"verify_rectify_fire_v1_rectifies__rectify_id__verify_post","parameters":[{"name":"rectify_id","in":"path","required":true,"schema":{"type":"integer","title":"Rectify Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RectifyVerifyIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/rectifies/{rectify_id}/rebound":{"post":{"tags":["场所巡检"],"summary":"整改退回","operationId":"rebound_rectify_fire_v1_rectifies__rectify_id__rebound_post","parameters":[{"name":"rectify_id","in":"path","required":true,"schema":{"type":"integer","title":"Rectify Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/venues/compliance/report":{"get":{"tags":["场所巡检"],"summary":"场所合规报表","operationId":"compliance_report_fire_v1_venues_compliance_report_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/dashboard/overview":{"get":{"tags":["数据看板"],"summary":"运营看板概览","operationId":"overview_fire_v1_dashboard_overview_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/files/upload":{"post":{"tags":["文件"],"summary":"上传文件","operationId":"upload_file_fire_v1_files_upload_post","parameters":[{"name":"scope","in":"query","required":false,"schema":{"type":"string","default":"material","title":"Scope"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_file_fire_v1_files_upload_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/files/upload/public":{"post":{"tags":["文件"],"summary":"Upload Public","description":"居民 H5 公开上传（仅允许 report 作用域；备案前可用局域网/内网联调）。","operationId":"upload_public_fire_v1_files_upload_public_post","parameters":[{"name":"scope","in":"query","required":false,"schema":{"type":"string","default":"report","title":"Scope"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_public_fire_v1_files_upload_public_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/files/{scope}/{name}":{"get":{"tags":["文件"],"summary":"下载文件","operationId":"download_file_fire_v1_files__scope___name__get","parameters":[{"name":"scope","in":"path","required":true,"schema":{"type":"string","title":"Scope"}},{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/governors":{"get":{"tags":["治理员"],"summary":"治理员列表","operationId":"list_governors_fire_v1_governors_get","parameters":[{"name":"role","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["治理员"],"summary":"创建治理员","operationId":"create_governor_fire_v1_governors_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GovernorIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/governors/{gid}":{"patch":{"tags":["治理员"],"summary":"更新治理员","operationId":"update_governor_fire_v1_governors__gid__patch","parameters":[{"name":"gid","in":"path","required":true,"schema":{"type":"integer","title":"Gid"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GovernorIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/h5/report":{"get":{"tags":["移动端页面"],"summary":"H5 举报页","description":"统一隐患上报入口（专用链接 / 会话卡片落地）。","operationId":"report_form_fire_v1_h5_report_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/fire/v1/h5/ticket":{"get":{"tags":["移动端页面"],"summary":"Ticket Progress Page","description":"工单进度页；支持 ?token= 直达。","operationId":"ticket_progress_page_fire_v1_h5_ticket_get","parameters":[{"name":"token","in":"query","required":false,"schema":{"type":"string","default":"","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/h5/activity/{activity_id}":{"get":{"tags":["移动端页面"],"summary":"H5 活动页","operationId":"activity_page_fire_v1_h5_activity__activity_id__get","parameters":[{"name":"activity_id","in":"path","required":true,"schema":{"type":"integer","title":"Activity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/h5/contact-guide":{"get":{"tags":["移动端页面"],"summary":"H5 联系指引页","operationId":"contact_guide_fire_v1_h5_contact_guide_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/fire/v1/h5/tickets/progress":{"get":{"tags":["移动端页面"],"summary":"Public Progress","description":"公开查询工单进度（token 或 工单号+手机后4位）。","operationId":"public_progress_fire_v1_h5_tickets_progress_get","parameters":[{"name":"token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"}},{"name":"ticket_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ticket Id"}},{"name":"contact_tail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact Tail"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/h5/tickets/satisfaction":{"post":{"tags":["移动端页面"],"summary":"Public Satisfaction","operationId":"public_satisfaction_fire_v1_h5_tickets_satisfaction_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SatisfactionIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/h5/feed":{"get":{"tags":["居民Feed"],"summary":"Public Feed","description":"已审核素材公开列表；audience 按素材 tags_json 交集过滤。","operationId":"public_feed_fire_v1_h5_feed_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"搜索标题/正文","title":"Q"},"description":"搜索标题/正文"},{"name":"audience","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"人群标签 code，如 old/renter/vehicle","title":"Audience"},"description":"人群标签 code，如 old/renter/vehicle"},{"name":"scene","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"festival|fire_season|routine","title":"Scene"},"description":"festival|fire_season|routine"},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"article|image|video|pdf|poster","title":"Type"},"description":"article|image|video|pdf|poster"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/h5/activities":{"get":{"tags":["居民Feed"],"summary":"Public Activities","operationId":"public_activities_fire_v1_h5_activities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/fire/v1/h5/meta":{"get":{"tags":["居民Feed"],"summary":"Public Meta","description":"原型页元信息（品牌/入口），不依赖企微。","operationId":"public_meta_fire_v1_h5_meta_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/fire/v1/knowledge/graph":{"get":{"tags":["知识库"],"summary":"知识图谱","operationId":"list_graph_fire_v1_knowledge_graph_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/knowledge/lookup":{"get":{"tags":["知识库"],"summary":"知识检索","operationId":"lookup_fire_v1_knowledge_lookup_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","title":"Q"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/kb/push/preview":{"post":{"tags":["知识推送"],"summary":"Preview","operationId":"preview_fire_v1_kb_push_preview_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/kb/push/run":{"post":{"tags":["知识推送"],"summary":"Run Push","operationId":"run_push_fire_v1_kb_push_run_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PushIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/kb/push/scene/{scene}":{"post":{"tags":["知识推送"],"summary":"Scene Push","operationId":"scene_push_fire_v1_kb_push_scene__scene__post","parameters":[{"name":"scene","in":"path","required":true,"schema":{"type":"string","title":"Scene"}},{"name":"execute","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Execute"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/aigc/jobs":{"post":{"tags":["AIGC"],"summary":"Create Job","operationId":"create_job_fire_v1_aigc_jobs_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["AIGC"],"summary":"List Jobs","operationId":"list_jobs_fire_v1_aigc_jobs_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/aigc/jobs/{job_id}":{"get":{"tags":["AIGC"],"summary":"Get Job","operationId":"get_job_fire_v1_aigc_jobs__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"integer","title":"Job Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/aigc/callback":{"post":{"tags":["AIGC"],"summary":"Callback","description":"云函数完成回调（公开；生产应加签名校验）。","operationId":"callback_fire_v1_aigc_callback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CallbackIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/flywheel/status":{"get":{"tags":["知识飞轮","知识飞轮"],"summary":"Flywheel Bridge Status","description":"桥接就绪状态（运营页自检）。","operationId":"flywheel_bridge_status_fire_v1_flywheel_status_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/flywheel/summary":{"get":{"tags":["知识飞轮","知识飞轮"],"summary":"Flywheel Summary","description":"飞轮运营汇总（代理 NIP，默认消防专库）。","operationId":"flywheel_summary_fire_v1_flywheel_summary_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":7,"title":"Days"}},{"name":"kb_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kb Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/flywheel/tickets":{"get":{"tags":["知识飞轮","知识飞轮"],"summary":"Flywheel Tickets","description":"飞轮工单列表（代理 NIP，默认消防专库）。","operationId":"flywheel_tickets_fire_v1_flywheel_tickets_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","default":"todo","title":"Status"}},{"name":"ticket_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticket Type"}},{"name":"kb_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kb Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/flywheel/tickets/{ticket_id}":{"get":{"tags":["知识飞轮","知识飞轮"],"summary":"Flywheel Ticket Detail","operationId":"flywheel_ticket_detail_fire_v1_flywheel_tickets__ticket_id__get","parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"integer","title":"Ticket Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/flywheel/tickets/{ticket_id}/review":{"post":{"tags":["知识飞轮","知识飞轮"],"summary":"Flywheel Ticket Review","description":"审核工单（admin+）；备注自动标注 8089 操作人。","operationId":"flywheel_ticket_review_fire_v1_flywheel_tickets__ticket_id__review_post","parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"integer","title":"Ticket Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlywheelTicketReviewIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/de/status":{"get":{"tags":["AI 对话"],"summary":"对话桥接状态","operationId":"de_bridge_status_fire_v1_de_status_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response De Bridge Status Fire V1 De Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/de/instances":{"get":{"tags":["AI 对话"],"summary":"数字员工实例列表","operationId":"list_instances_fire_v1_de_instances_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/de/nip-static/{path}":{"get":{"tags":["AI 对话"],"summary":"Proxy Nip Static","description":"代理 NIP 人设静态图（/static/de-avatars/…），供 8089 对话页 img 加载。","operationId":"proxy_nip_static_fire_v1_de_nip_static__path__get","parameters":[{"name":"path","in":"path","required":true,"schema":{"type":"string","title":"Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/de/sessions":{"get":{"tags":["AI 对话"],"summary":"对话会话列表","description":"会话历史列表（经桥接账号读取 NIP agent_sessions，再按 8089 登录用户隔离）。\n\nNIP 侧会话归单一桥接账号，故拉取后用本地归属表按当前用户过滤；\n仅 super 角色可见全部（运维/审计）。","operationId":"list_sessions_fire_v1_de_sessions_get","parameters":[{"name":"instance_id","in":"query","required":true,"schema":{"type":"integer","minimum":1,"title":"Instance Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":30,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/de/sessions/{session_id}/history":{"get":{"tags":["AI 对话"],"summary":"会话历史消息","description":"单会话消息回放（agent_messages）；仅本人会话（super 除外）可回放。","operationId":"session_history_fire_v1_de_sessions__session_id__history_get","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/de/chat/route-turn":{"post":{"tags":["AI 对话"],"summary":"对话轮次路由","operationId":"route_turn_fire_v1_de_chat_route_turn_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteTurnIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/de/workflow/run":{"post":{"tags":["AI 对话"],"summary":"Submit Workflow","description":"提交编排任务（固定流程），代理 NIP POST /workflow/run。","operationId":"submit_workflow_fire_v1_de_workflow_run_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowRunIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/de/workflow/run/{run_id}":{"get":{"tags":["AI 对话"],"summary":"Get Workflow Run","description":"查询编排任务状态与步骤。","operationId":"get_workflow_run_fire_v1_de_workflow_run__run_id__get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"integer","title":"Run Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/de/workflow/run/{run_id}/cancel":{"post":{"tags":["AI 对话"],"summary":"Cancel Workflow Run","description":"取消进行中的编排任务。","operationId":"cancel_workflow_run_fire_v1_de_workflow_run__run_id__cancel_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"integer","title":"Run Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/de/chat/upload-attachment":{"post":{"tags":["AI 对话"],"summary":"Upload Chat Attachment","description":"对话附件上传，代理 NIP POST /agent/upload-attachment。","operationId":"upload_chat_attachment_fire_v1_de_chat_upload_attachment_post","parameters":[{"name":"de_instance_id","in":"query","required":true,"schema":{"type":"integer","minimum":1,"title":"De Instance Id"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_chat_attachment_fire_v1_de_chat_upload_attachment_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/de/flywheel/feedback":{"post":{"tags":["AI 对话"],"summary":"Flywheel Feedback","description":"问答赞踩飞轮，代理 NIP POST /knowledge/flywheel/feedback。","operationId":"flywheel_feedback_fire_v1_de_flywheel_feedback_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlywheelFeedbackIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fire/v1/de/chat/rag":{"post":{"tags":["AI 对话"],"summary":"RAG 流式问答","operationId":"rag_stream_fire_v1_de_chat_rag_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string","default":"","title":"Authorization"}},{"name":"X-Fire-Service-Token","in":"header","required":false,"schema":{"type":"string","default":"","title":"X-Fire-Service-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RagChatIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"ActivityIn":{"properties":{"type":{"type":"string","title":"Type","default":"survey"},"title":{"type":"string","title":"Title"},"config_json":{"additionalProperties":true,"type":"object","title":"Config Json","default":{}},"target_tag_expr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Tag Expr"}},"type":"object","required":["title"],"title":"ActivityIn"},"AddContactIn":{"properties":{"external_userid":{"type":"string","title":"External Userid"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["external_userid"],"title":"AddContactIn"},"AssignIn":{"properties":{"assignee_userid":{"type":"string","title":"Assignee Userid"},"assignee_name":{"type":"string","title":"Assignee Name"}},"type":"object","required":["assignee_userid","assignee_name"],"title":"AssignIn"},"Body_upload_chat_attachment_fire_v1_de_chat_upload_attachment_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_chat_attachment_fire_v1_de_chat_upload_attachment_post"},"Body_upload_file_fire_v1_files_upload_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_file_fire_v1_files_upload_post"},"Body_upload_public_fire_v1_files_upload_public_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_public_fire_v1_files_upload_public_post"},"CallbackIn":{"properties":{"client_job_id":{"type":"integer","title":"Client Job Id"},"status":{"type":"string","title":"Status"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["client_job_id","status"],"title":"CallbackIn"},"CampaignIn":{"properties":{"name":{"type":"string","title":"Name"},"scene":{"type":"string","title":"Scene","default":"routine"},"target_tag_expr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Tag Expr"},"schedule_cron":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Schedule Cron"},"peak_window":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Peak Window"}},"type":"object","required":["name"],"title":"CampaignIn"},"ChangePasswordIn":{"properties":{"current_password":{"type":"string","title":"Current Password"},"new_password":{"type":"string","title":"New Password"}},"type":"object","required":["current_password","new_password"],"title":"ChangePasswordIn"},"FlywheelFeedbackIn":{"properties":{"vote":{"type":"integer","title":"Vote","description":"1=有用, -1=无用"},"kb_query_log_id":{"type":"integer","minimum":1.0,"title":"Kb Query Log Id"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"instance_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Instance Id"},"comment":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Comment"},"correction":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Correction"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"},"answer_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Answer Summary"}},"type":"object","required":["vote","kb_query_log_id"],"title":"FlywheelFeedbackIn"},"FlywheelTicketReviewIn":{"properties":{"action":{"type":"string","title":"Action","description":"start_review | reject | dismiss | resolve_verified | resolve_supplement"},"admin_note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Admin Note"},"linked_document_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Linked Document Id"}},"type":"object","required":["action"],"title":"FlywheelTicketReviewIn"},"GovernorIn":{"properties":{"userid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Userid"},"name":{"type":"string","title":"Name"},"role":{"type":"string","title":"Role","default":"gov"},"scope_area":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope Area"},"contact":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact"},"enabled":{"type":"boolean","title":"Enabled","default":true}},"type":"object","required":["name"],"title":"GovernorIn"},"GroupIn":{"properties":{"name":{"type":"string","title":"Name"},"level":{"type":"string","title":"Level"},"parent_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parent Id"},"member_count":{"type":"integer","title":"Member Count","default":0},"wecom_chat_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wecom Chat Id"}},"type":"object","required":["name","level"],"title":"GroupIn"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"InboundIn":{"properties":{"from_userid":{"type":"string","title":"From Userid"},"content":{"type":"string","title":"Content","default":""},"msgtype":{"type":"string","title":"Msgtype","default":"text"},"roomid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Roomid"},"media_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Media Key"}},"type":"object","required":["from_userid"],"title":"InboundIn"},"InspectPushIn":{"properties":{"cycle":{"type":"string","title":"Cycle","default":"monthly"}},"type":"object","title":"InspectPushIn"},"InspectSubmitIn":{"properties":{"items":{"additionalProperties":true,"type":"object","title":"Items"},"filler_userid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filler Userid"}},"type":"object","required":["items"],"title":"InspectSubmitIn"},"JobIn":{"properties":{"kind":{"type":"string","title":"Kind","default":"image"},"prompt":{"type":"string","maxLength":2000,"minLength":1,"title":"Prompt"},"script":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Script"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"content_tags":{"items":{"type":"string"},"type":"array","title":"Content Tags","default":[]},"scene":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scene"}},"type":"object","required":["prompt"],"title":"JobIn"},"LoginIn":{"properties":{"username":{"type":"string","title":"Username"},"password":{"type":"string","title":"Password"}},"type":"object","required":["username","password"],"title":"LoginIn"},"MaterialIn":{"properties":{"type":{"type":"string","title":"Type","default":"article"},"title":{"type":"string","title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"storage_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Storage Url"},"cover_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Url"},"scene":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scene"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]}},"type":"object","required":["title"],"title":"MaterialIn"},"PreviewIn":{"properties":{"tag_expr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag Expr"},"scene":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scene"},"material_ids":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Material Ids"}},"type":"object","title":"PreviewIn"},"PublishIn":{"properties":{"channel":{"type":"string","title":"Channel","default":"group"},"material_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Material Id"},"target_expr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Expr"},"campaign_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Campaign Id"},"exec_mode":{"type":"string","title":"Exec Mode","default":"auto"}},"type":"object","title":"PublishIn"},"PushIn":{"properties":{"channel":{"type":"string","title":"Channel","default":"single"},"tag_expr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag Expr"},"scene":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scene"},"material_ids":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Material Ids"},"campaign_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Campaign Id"},"execute":{"type":"boolean","title":"Execute","default":false}},"type":"object","title":"PushIn"},"RagChatIn":{"properties":{"query":{"type":"string","title":"Query"},"instance_id":{"type":"integer","title":"Instance Id"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"history":{"items":{"$ref":"#/components/schemas/RagHistoryTurn"},"type":"array","title":"History"},"force_knowledge":{"type":"boolean","title":"Force Knowledge","default":false},"speed_mode":{"type":"string","title":"Speed Mode","default":"auto"}},"type":"object","required":["query","instance_id"],"title":"RagChatIn"},"RagHistoryTurn":{"properties":{"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"}},"type":"object","required":["role","content"],"title":"RagHistoryTurn"},"RectifyVerifyIn":{"properties":{"ok":{"type":"boolean","title":"Ok"}},"type":"object","required":["ok"],"title":"RectifyVerifyIn"},"ReportIn":{"properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"channel":{"type":"string","title":"Channel","default":"h5"},"reporter_resident_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reporter Resident Id"},"contact":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"location_geo":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Location Geo"},"media":{"items":{"type":"string"},"type":"array","title":"Media","default":[]}},"type":"object","title":"ReportIn"},"ResidentIn":{"properties":{"external_userid":{"type":"string","title":"External Userid"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"area_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Area Code"},"source":{"type":"string","title":"Source","default":"import"}},"type":"object","required":["external_userid"],"title":"ResidentIn"},"ReviewIn":{"properties":{"approved":{"type":"boolean","title":"Approved"},"note":{"type":"string","title":"Note","default":""}},"type":"object","required":["approved"],"title":"ReviewIn"},"RouteTurnIn":{"properties":{"message":{"type":"string","title":"Message"},"de_instance_id":{"type":"integer","title":"De Instance Id"},"has_smart_qa":{"type":"boolean","title":"Has Smart Qa","default":true},"has_attachments":{"type":"boolean","title":"Has Attachments","default":false},"force_knowledge_mode":{"type":"boolean","title":"Force Knowledge Mode","default":false},"force_agent":{"type":"boolean","title":"Force Agent","default":false}},"type":"object","required":["message","de_instance_id"],"title":"RouteTurnIn"},"RuleIn":{"properties":{"tag_id":{"type":"integer","title":"Tag Id"},"trigger":{"type":"string","title":"Trigger"},"params_json":{"additionalProperties":true,"type":"object","title":"Params Json","default":{}},"enabled":{"type":"boolean","title":"Enabled","default":true}},"type":"object","required":["tag_id","trigger"],"title":"RuleIn"},"SatIn":{"properties":{"score":{"type":"integer","title":"Score"}},"type":"object","required":["score"],"title":"SatIn"},"SatisfactionIn":{"properties":{"token":{"type":"string","minLength":4,"title":"Token"},"score":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Score"}},"type":"object","required":["token","score"],"title":"SatisfactionIn"},"ScheduleIn":{"properties":{"scheduled_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scheduled At"}},"type":"object","title":"ScheduleIn"},"SubmitIn":{"properties":{"answers":{"additionalProperties":true,"type":"object","title":"Answers"},"resident_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Resident Id"}},"type":"object","required":["answers"],"title":"SubmitIn"},"TargetIn":{"properties":{"expr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expr"}},"type":"object","title":"TargetIn"},"TrackIn":{"properties":{"event":{"type":"string","title":"Event"},"duration_sec":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Sec"},"node":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Node"},"visitor_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visitor Key"},"resident_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Resident Id"}},"type":"object","required":["event"],"title":"TrackIn"},"TransitionIn":{"properties":{"to_status":{"type":"string","title":"To Status"},"note":{"type":"string","title":"Note","default":""}},"type":"object","required":["to_status"],"title":"TransitionIn"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VenueIn":{"properties":{"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type","default":"nine_small"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"risk_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Risk Level"},"owner_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner Name"},"owner_contact":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner Contact"},"facilities":{"additionalProperties":true,"type":"object","title":"Facilities","default":{}},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]}},"type":"object","required":["name"],"title":"VenueIn"},"WorkflowRunIn":{"properties":{"intent":{"type":"string","maxLength":4000,"minLength":2,"title":"Intent"},"instance_id":{"type":"integer","minimum":1.0,"title":"Instance Id"}},"type":"object","required":["intent","instance_id"],"title":"WorkflowRunIn"},"app__api__residents__TagIn":{"properties":{"tag_code":{"type":"string","title":"Tag Code"}},"type":"object","required":["tag_code"],"title":"TagIn"},"app__api__tags__TagIn":{"properties":{"code":{"type":"string","title":"Code"},"name":{"type":"string","title":"Name"},"category":{"type":"string","title":"Category","default":"attr"},"description":{"type":"string","title":"Description","default":""}},"type":"object","required":["code","name"],"title":"TagIn"}}},"tags":[{"name":"认证","description":"登录、当前用户信息与密码修改"},{"name":"健康检查","description":"服务存活、大模型路由与企业微信连通性"},{"name":"企业微信","description":"回调验签、事件接收、Token 刷新与会话存档"},{"name":"联调模拟","description":"本地/沙箱模拟入站消息与添加联系人"},{"name":"居民管理","description":"居民档案、标签与定向触达预览"},{"name":"标签","description":"标签库与自动打标规则"},{"name":"群组","description":"企微群组列表、组织树与覆盖率"},{"name":"素材","description":"宣传素材库、审核、落地页与阅读雷达"},{"name":"发布","description":"活动 campaign 与群发/定时发布任务"},{"name":"活动","description":"线下活动创建与 H5 报名提交"},{"name":"举报","description":"群众举报受理与列表查询"},{"name":"工单","description":"工单分派、流转、满意度与逾期扫描"},{"name":"场所巡检","description":"重点场所、二维码、巡检与整改闭环"},{"name":"数据看板","description":"运营概览指标"},{"name":"文件","description":"附件上传与下载"},{"name":"治理员","description":"网格/社区治理员账号管理"},{"name":"移动端页面","description":"H5 举报、活动与联系指引页"},{"name":"知识库","description":"知识图谱与关键词检索"},{"name":"AI 对话","description":"数字员工对话桥接、会话与 RAG 流式问答"}]}