
## LawRisk V2 接口（结构化结果）
- Base URL: http://www.chinaweal.com.cn:8090
- 路径: /fs-ai-asistant/api/workflow/lawrisk/v2
- 方法: POST（推荐）, GET（调试）
- Content-Type: application/x-www-form-urlencoded 或 application/json
- 鉴权: 无

### 请求参数
- query | q | text (string，必填): 用户问题。
- debug (boolean-like，可选): 1/true/yes/on 视为开启调试信息。
- top (int，可选): 用于推荐问题数量，默认 5。
- region | region_id (string/list，可选): 限定地区，可传地区 ID、名称（市级、南海区、禅城区、顺德区、高明区、三水区，目前只能传市级，其他地区数据库中还没有）。

### 响应结构

成功响应示例（结构化结果，含调试开关）：

```json
{
  "success": true,
  "message": "OK",
  "data": {
    "workflowStatus": "ok",
    "executionTime": 412,
    "questionExtend": ["电影院需要哪些许可？", "电影放映许可证办理条件？"],
    "risk_subject": [
      {
        "id": "2:18",
        "display_name": "市级 · 开办电影院",
        "region": {"id": "2", "name": "市级"},
        "theme": {"id": "18", "name": "开办电影院"},
        "permits": [
          {
            "id": "509",
            "name": "电影放映单位设立审批",
            "permit_status": "许可",
            "subitem_summary": "设立固定电影院",
            "responsible_contact": "市文化广电旅游局",
            "jurisdiction_scope": "佛山市行政区域",
            "business_scopes": [{"id": "901", "description": "电影放映"}],
            "risks": [
              {
                "id": "1205",
                "risk_content": "未取得审批擅自放映电影属于违法行为。",
                "legal_basis": "《电影产业促进法》第四十四条",
                "document_no": "",
                "summary": "**第四十四条** …"
              }
            ]
          }
        ]
      }
    ],
    "debug": {
      "catalog_total": 123,
      "catalog_used_for_llm": 78,
      "selected_option_ids": ["2:18"]
    }
  }
}
```

字段说明：
- success/message/data：与 V1 保持一致。
- data.risk_subject: 数组。每项包含所选地区、主题及关联许可。
  - id/display_name: LLM 选择的 `地区ID:主题ID` 和展示名。若直接命中许可名称，为空字符串。
  - region/theme: 结构体，含 id/name。
  - permits: 许可列表，含 `business_scopes`（经营范围数组）；`risks`（风险提示数组），其中risks[n].document_no(文号)、risks[n].id(风险id)、risks[n].legal_basis（法律依据）、risks[n].risk_content（风险提示内容）、risks[n].summary（摘要）；以及可选的 `permit_status`（许可情况
（前置事项/后置事项/备案事项））、`subitem_summary`（许可（备案）事项子项）、`responsible_contact`（负责部门及联系方式 ）、`jurisdiction_scope`（区镇街权限划分）。
- data.debug: 仅在 debug=1 时返回，包含 catalog 规模、选中项、命中策略（直接命中许可时为 `strategy: permit_exact` 等）。

失败响应：
- 400: { "error": "query is required" }
- 500: { "success": false, "message": "<错误信息>", "data": {} }

当传入具体的许可名时，会直接返回具体的许可事项，如：  
query="公共场所卫生许可"
```json
{
    "data": {
        "conversationId": "",
        "conversationInfo": {},
        "costStatistics": {},
        "debug": {
            "catalog_after_region_filter": 57,
            "catalog_total": 57,
            "matched_permit_ids": [
                "34f0d1eb-1454-4170-8fdf-5cdf77b044c5"
            ],
            "matched_permit_name": "公共场所卫生许可",
            "region_filter": [
                "市级"
            ],
            "strategy": "permit_exact"
        },
        "executionSteps": [],
        "executionTime": 529,
        "knowledgeSources": [],
        "lawRisk": "",
        "llmRespond": "",
        "messageId": "",
        "questionExtend": [
            "开办动物隔离、无害化处理企业",
            "开办病媒生物预防控制有偿服务企业",
            "开办洗浴场所",
            "开办旅馆",
            "开办公路旅客班车运输企业"
        ],
        "risk_subject": [
            {
                "display_name": "",
                "id": "",
                "permits": [
                    {
                        "business_scopes": [
                            {
                                "description": "洗浴服务",
                                "id": "00b447b4-451d-48f0-aa7c-b9b9e867f147"
                            },
                            {
                                "description": "理发服务",
                                "id": "b9613e0b-9aac-41af-b4f6-c83cf83fb6ca"
                            },
                            {
                                "description": "生活美容服务",
                                "id": "99487dcd-618f-4028-a27d-d43905ad0214"
                            },
                            {
                                "description": "足浴服务。",
                                "id": "5669799f-8a38-4832-83d8-3be08b8389a8"
                            }
                        ],
                        "id": "34f0d1eb-1454-4170-8fdf-5cdf77b044c5",
                        "jurisdiction_scope": "市级：市直管公共场所及跨区公共场所。",
                        "name": "公共场所卫生许可",
                        "permit_status": "后置事项",
                        "responsible_contact": "佛山市卫生健康局：0757-83390129；市疾病预防控制中心（市卫生监督所）公共场所卫生监督科：0757-83109692。",
                        "risks": [
                            {
                                "document_no": "中华人民共和国卫生部令第80号",
                                "id": "1a3b2271-31a9-422e-8193-9efff4783ef6",
                                "legal_basis": "《公共场所卫生管理条例实施细则》",
                                "risk_content": "《卫生许可证》需每四年进行一次延续。",
                                "summary": "《公共场所卫生管理条例实施细则》\n**第二十五条**第二款：公共场所卫生许可证有效期为四年。"
                            },
                            {
                                "document_no": "2019年4月23日(国务院令第714号)第二次修改；\n中华人民共和国卫生部令第80号",
                                "id": "a0cd6f10-18f2-41a5-bcaa-8d3bd1e69ec1",
                                "legal_basis": "《公共场所卫生管理条例》《公共场所卫生管理条例实施细则》",
                                "risk_content": "公共场所经营者不得安排未获得有效健康合格证明的从业人员从事直接为顾客服务工作。",
                                "summary": "《公共场所卫生管理条例》\n**第七条** ：公共场所直接为顾客服务的人员，持有“健康合格证”方能从事本职工作。《公共场所卫生管理条例实施细则》\n**第十条**第一款：公共场所经营者应当组织从业人员每年进行健康检查，从业人员在取得有效健康合格证明后方可上岗。"
                            },
                            {
                                "document_no": "2019年4月23日(国务院令第714号)第二次修改；\n中华人民共和国卫生部令第80号",
                                "id": "18467d48-6998-4b38-97a2-2c61833fca08",
                                "legal_basis": "《公共场所卫生管理条例》《公共场所卫生管理条例实施细则》",
                                "risk_content": "公共场所经营者对发生的危害健康事故未立即\n采取处臵措施，导致危害扩大，或者隐瞒、缓\n报、谎报。",
                                "summary": "《公共场所卫生管理条例》\n**第九条**：公共场所因不符合卫生标准和要求造成危害健康事故的，经营单位应妥善处理。并及时报告卫生防疫机构。《公共场所卫生管理条例实施细则》\n**第二十一条**：公共场所发生危害健康事故的，经营者应当立即处臵，防止危害扩大，并及时向县级人民政府卫生行政部门报告。任何单位或者个人对危害健康事故不得隐瞒、缓报、谎报或者授意他人隐瞒、缓报、谎报。"
                            },
                            {
                                "document_no": "中华人民共和国卫生部令第80号",
                                "id": "9f20a1da-dd2f-4155-b082-bd5bd77b42e3",
                                "legal_basis": "《公共场所卫生管理条例实施细则》",
                                "risk_content": "公共场所集中空调通风系统经卫生检测或者\n评价不合格不得投入使用。",
                                "summary": "《公共场所卫生管理条例实施细则》\n**第十一条**第二款：公共场所采用集中空调通风系统的，应当符合公共场所集中空调通风系统相关卫生规范和规定的要求。"
                            },
                            {
                                "document_no": "2019年4月23日(国务院令第714号)第二次修改；\n中华人民共和国卫生部令第80号",
                                "id": "30ebbaf7-e671-49cf-aa26-00b701f83f19",
                                "legal_basis": "《公共场所卫生管理条例》《公共场所卫生管理条例实施细则》",
                                "risk_content": "未依法取得公共场所卫生许可证不得擅自营业。",
                                "summary": "《公共场所卫生管理条例》\n**第八条**：经营单位须取得“卫生许可证”后，方可向工商行政管理部门申请登记，办理营业执照。《公共场所卫生管理条例实施细则》\n**第二十二条** “国家对除公园、体育场馆、公共交通工具外的公共场所实行卫生许可证管理。“公共场所经营者取得工商行政管理部门颁发的营业执照后，还应当按照规定向县级以上地方人民政府卫生计生行政部门申请卫生许可证，方可营业。"
                            },
                            {
                                "document_no": "中华人民共和国卫生部令第80号",
                                "id": "c2c9fe71-6526-497d-ba02-2ae65c0d0dbc",
                                "legal_basis": "《公共场所卫生管理条例实施细则》",
                                "risk_content": "要按照规定公示公共场所卫生许可证、卫生检\n测结果和卫生信誉度等级。",
                                "summary": "《公共场所卫生管理条例实施细则》\n**第二十五条**第三款：公共场所卫生许可证应当在经营场所醒目位置公示。\n**第三十条**第二款：公共场所卫生信誉度等级应当在公共场所醒目位置公示。"
                            },
                            {
                                "document_no": "中华人民共和国卫生部令第80号",
                                "id": "a36e6afc-1bec-4fc8-9b8e-7b9165b9dffe",
                                "legal_basis": "《公共场所卫生管理条例实施细则》",
                                "risk_content": "要按照规定对公共场所的空气、微小气候、水质、采光、照明、噪声、顾客用品用具等进行卫生检测，并且在醒目位置如实公示检测结果。",
                                "summary": "《公共场所卫生管理条例实施细则》\n**第十九条** 公共场所经营者应当按照卫生标准、规范的要求对公共场所的空气、微小气候、水质、采光、照明、噪声、顾客用品用具等进行卫生检测，检测每年不得少于一次；检测结果不符合卫生标准、规范要求的应当及时整改。公共场所经营者应当在醒目位置如实公示检测结果，并对其卫生检测的真实性负责，依法依规承担相应后果。"
                            },
                            {
                                "document_no": "中华人民共和国卫生部令第80号",
                                "id": "6fb4b4db-5730-4853-b4ec-7a0dcbdb25ac",
                                "legal_basis": "《公共场所卫生管理条例实施细则》",
                                "risk_content": "要按照规定对顾客用品用具进行清洗、消毒、保洁，不得重复使用一次性用品用具。",
                                "summary": "《公共场所卫生管理条例实施细则》\n**第十四条** 公共场所经营者提供给顾客使用的用品用具应当保证卫生安全，可以反复使用的用品用具应当一客一换，按照有关卫生标准和要求清洗、消毒、保洁。禁止重复使用一次性用品用具。"
                            },
                            {
                                "document_no": "2019年4月23日(国务院令第714号)第二次修改；\n中华人民共和国卫生部令第80号",
                                "id": "8bcd4786-fe03-436c-b918-fd81bca20637",
                                "legal_basis": "《公共场所卫生管理条例》《公共场所卫生管理条例实施细则》",
                                "risk_content": "要按照规定建立卫生管理制度、设立卫生管理\n部门或者配备专（兼）职卫生管理人员，要建立卫生管理档案。",
                                "summary": "《公共场所卫生管理条例》\n**第六条**：经营单位应当负责所经营的公共场所的卫生管理，建立卫生责任制度，对本单位的从业人员进行卫生知识的培训和考核工作。《公共场所卫生管理条例实施细则》\n**第七条**：公共场所的法定代表人或者负责人是其经营场所卫生安全的第一责任人。公共场所经营者应当设立卫生管理部门或者配备专（兼）职卫生管理人员，具体负责本公共场所的卫生工作，建立健全卫生管理制度和卫生管理档案。"
                            },
                            {
                                "document_no": "中华人民共和国卫生部令第80号",
                                "id": "783d3b9f-fc95-4839-83a5-9a5c64c5e306",
                                "legal_basis": "《公共场所卫生管理条例实施细则》",
                                "risk_content": "要按照规定索取公共卫生用品检验合格证明和\n其他相关资料。",
                                "summary": "《公共场所卫生管理条例实施细则》\n**第八条**：公共场所卫生管理档案应当主要包括下列内容：\n- （七） 公共卫生用品进货索证管理情况。"
                            },
                            {
                                "document_no": "中华人民共和国卫生部令第80号",
                                "id": "6aba9f47-3b4d-4cef-adcb-f1828fae04ba",
                                "legal_basis": "《公共场所卫生管理条例实施细则》",
                                "risk_content": "要按照规定组织从业人员进行相关卫生法律知识和公共场所卫生知识培训，不得安排未经相关卫生法律知识和公共场所卫生知识培训考核的从业人员上岗。",
                                "summary": "《公共场所卫生管理条例实施细则》\n**第九条**：公共场所经营者应当建立卫生培训制度，组织从业人员学习相关卫生法律知识和公共场所卫生知识，并进行考核。对考核不合格的，不得安排上岗。"
                            },
                            {
                                "document_no": "中华人民共和国卫生部令第80号",
                                "id": "7e35662f-d9b9-4854-93ff-f3e213a4b4ae",
                                "legal_basis": "《公共场所卫生管理条例实施细则》",
                                "risk_content": "要按照规定设臵与其经营规模、项目相适应的清洗、消毒、保洁、盥洗等设施设备和公共卫生间，不得擅自停止使用、拆除上述设施设备，或者挪作他用。",
                                "summary": "《公共场所卫生管理条例实施细则》\n**第十五条** 公共场所经营者应当根据经营规模、项目设臵清洗、消毒、保洁、盥洗等设施设备和公共卫生间。公共场所经营者应当建立卫生设施设备维护制度，定期检查卫生设施设备，确保其正常运行，不得擅自拆除、改造或者挪作他用。"
                            },
                            {
                                "document_no": "中华人民共和国卫生部令第80号",
                                "id": "a358e9b5-7b24-4dd2-846c-a88c3bc0bac9",
                                "legal_basis": "《公共场所卫生管理条例实施细则》",
                                "risk_content": "要按照规定配备预防控制鼠、蚊、蝇、蟑螂和\n其他病媒生物的设施设备以及废弃物存放专用\n设施设备。不得擅自停止使用、拆除预防控制\n鼠、蚊、蝇、蟑螂和其他病媒生物的设施设备以及废弃物存放专用设施设备。",
                                "summary": "《公共场所卫生管理条例实施细则》\n**第十六条**：公共场所经营者应当配备安全、有效的预防控制蚊、蝇、蟑螂、鼠和其他病媒生物的设施设备及废弃物存放专用设施设备，并保证相关设施设备的正常使用，及时清运废弃物。"
                            }
                        ],
                        "subitem_summary": "公共场所卫生许可新证、变更、延续、注销、补办"
                    }
                ],
                "region": {
                    "id": "2c29ca08-efc6-4e2c-abc2-d73685e0bdd1",
                    "name": "市级"
                },
                "theme": {
                    "id": "",
                    "name": ""
                }
            }
        ],
        "roundNumber": 0,
        "totalKnowledgeSources": 0,
        "workflowStatus": "ok",
        "workflowTrackingId": ""
    },
    "message": "OK",
    "success": true
}
```
此时display_name（主题名） 和 id（主题id）为空，可以以此为判断查询的是具体事项还是主题，如果是具体事项，则按照事项进行展示，否则按照原有的逻辑






### 便捷请求示例

POST（推荐）：

```bash
curl -s -X POST "http://www.chinaweal.com.cn:8090/fs-ai-asistant/api/workflow/lawrisk/v2" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "query=我要开电影院&debug=1&region=市级"
```

GET 调试：

```bash
curl -s "http://www.chinaweal.com.cn:8090/fs-ai-asistant/api/workflow/lawrisk/v2?query=%E6%88%91%E8%A6%81%E5%BC%80%E7%94%B5%E5%BD%B1%E9%99%A2&debug=1"
```

前端 fetch 示例：

```ts
const params = new URLSearchParams({ query: "我要开电影院", debug: "1" });
fetch("/fs-ai-asistant/api/workflow/lawrisk/v2", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: params.toString(),
})
  .then((res) => res.json())
  .then(({ data }) => {
    // data.risk_subject[0].permits[0].risks ...
  });
```

### 地区列表接口
- 路径: /fs-ai-asistant/api/workflow/lawrisk/v2/regions
- 方法: GET
- 响应:

```json
{
  "success": true,
  "data": {
    "regions": [
      {"id": "2", "name": "市级"},
      {"id": "5", "name": "禅城区"}
    ]
  }
}
```

该接口返回所有可用地区，以便前端构建地区筛选下拉框。调用搜索接口时，可将 `region` 参数设置为选中的 `id` 或 `name`。

## 兼容与跨域
- 服务端已启用 CORS，可在 .env 中配置：ALLOWED_ORIGINS、CORS_STRICT、CORS_DEBUG、NGINX_CORS_MODE 等。
- 如需鉴权（例如加 Token），建议在网关或反代层统一处理。
