170 lines
4.5 KiB
Markdown
170 lines
4.5 KiB
Markdown
|
# V2 API 许可证名称匹配和审批部门显示修复总结
|
|||
|
|
|
|||
|
|
## 提交信息
|
|||
|
|
- **Commit**: 60b94d8
|
|||
|
|
- **日期**: 2025-12-23
|
|||
|
|
- **类型**: feat (新功能)
|
|||
|
|
|
|||
|
|
## 问题描述
|
|||
|
|
|
|||
|
|
### 1. 许可证名称匹配问题
|
|||
|
|
用户查询"药品经营许可"时，系统无法直接匹配到数据库中的"药品经营许可证"，导致触发LLM而不是直接数据库查询。
|
|||
|
|
|
|||
|
|
### 2. 审批部门显示问题
|
|||
|
|
查询"营业执照"时，返回的 `unit_name` 字段为 `null`，即使已经导入了审批部门数据。
|
|||
|
|
|
|||
|
|
## 根本原因
|
|||
|
|
|
|||
|
|
1. **严格的精确匹配**: `find_permit_contexts_by_name` 只支持完全相同的名称匹配
|
|||
|
|
2. **缺失的数据表**: `permit_approval_departments` 表不存在
|
|||
|
|
3. **错误的SQL语法**: 模糊匹配使用了 `||` 连接符，在某些数据库中不兼容
|
|||
|
|
4. **缺少数据**: 即使表存在，也没有审批部门映射数据
|
|||
|
|
|
|||
|
|
## 解决方案
|
|||
|
|
|
|||
|
|
### 1. 许可证名称前缀匹配 (licensing_repo.py)
|
|||
|
|
|
|||
|
|
**修改函数**: `find_permit_contexts_by_name`
|
|||
|
|
|
|||
|
|
```python
|
|||
|
|
# 添加前缀匹配逻辑
|
|||
|
|
if not rows and len(permit_name) >= 2:
|
|||
|
|
sql_fuzzy = """
|
|||
|
|
SELECT ... FROM ... WHERE p.name LIKE %s
|
|||
|
|
"""
|
|||
|
|
cur.execute(sql_fuzzy, (permit_name + "%",))
|
|||
|
|
rows = cur.fetchall()
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**效果**:
|
|||
|
|
- "药品经营许可" 现在可以匹配 "药品经营许可证"
|
|||
|
|
- "营业执照" 可以匹配 "营业执照（副本）"等
|
|||
|
|
|
|||
|
|
### 2. 审批部门表自动创建 (licensing_repo.py)
|
|||
|
|
|
|||
|
|
**新增函数**:
|
|||
|
|
- `_create_permit_approval_departments_schema()`: 创建表结构
|
|||
|
|
- `_ensure_permit_approval_departments_schema()`: 确保表存在
|
|||
|
|
|
|||
|
|
**表结构**:
|
|||
|
|
```sql
|
|||
|
|
CREATE TABLE IF NOT EXISTS permit_approval_departments (
|
|||
|
|
id uuid PRIMARY KEY,
|
|||
|
|
permit_name text NOT NULL,
|
|||
|
|
department_name text NOT NULL,
|
|||
|
|
created_at timestamptz NOT NULL DEFAULT now(),
|
|||
|
|
updated_at timestamptz NOT NULL DEFAULT now()
|
|||
|
|
)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 修复SQL JOIN逻辑 (licensing_repo.py)
|
|||
|
|
|
|||
|
|
**修改前**:
|
|||
|
|
```sql
|
|||
|
|
LEFT JOIN permit_approval_departments pad
|
|||
|
|
ON (pad.permit_name = p.name OR p.name LIKE pad.permit_name || '%')
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**修改后**:
|
|||
|
|
```sql
|
|||
|
|
LEFT JOIN permit_approval_departments pad
|
|||
|
|
ON (p.name = pad.permit_name OR p.name LIKE CONCAT(pad.permit_name, '%'))
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**改进**:
|
|||
|
|
- 使用 `CONCAT()` 函数，兼容性更好
|
|||
|
|
- 支持精确匹配和前缀匹配
|
|||
|
|
|
|||
|
|
### 4. 新增管理API端点 (v2.py)
|
|||
|
|
|
|||
|
|
**端点**: `POST /fs-ai-asistant/api/workflow/lawrisk/admin/approval-departments/setup`
|
|||
|
|
|
|||
|
|
**功能**:
|
|||
|
|
- 自动插入常见的审批部门映射
|
|||
|
|
- 支持更新已存在的映射
|
|||
|
|
- 返回操作统计信息
|
|||
|
|
|
|||
|
|
**预置映射**:
|
|||
|
|
- 营业执照 → 市场监管部门
|
|||
|
|
- 食品经营许可证 → 市场监管部门
|
|||
|
|
- 药品经营许可证 → 市场监管部门
|
|||
|
|
- 医疗器械经营许可证 → 市场监管部门
|
|||
|
|
- 特种设备使用登记 → 市场监管部门
|
|||
|
|
|
|||
|
|
### 5. 更新 .gitignore
|
|||
|
|
|
|||
|
|
**新增规则**:
|
|||
|
|
```gitignore
|
|||
|
|
# 临时脚本
|
|||
|
|
analyze_*.py
|
|||
|
|
final_importer.py
|
|||
|
|
ultimate_importer.py
|
|||
|
|
*_importer.py
|
|||
|
|
|
|||
|
|
# Excel文件（除模板外）
|
|||
|
|
*.xlsx
|
|||
|
|
!样表.xlsx
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 文件变更
|
|||
|
|
|
|||
|
|
### 修改的文件
|
|||
|
|
1. `lawrisk/services/licensing_repo.py` (+1200行)
|
|||
|
|
- 新增审批部门表管理
|
|||
|
|
- 修复许可证名称匹配逻辑
|
|||
|
|
- 修复SQL JOIN语法
|
|||
|
|
|
|||
|
|
2. `lawrisk/api/v2.py` (+89行)
|
|||
|
|
- 新增审批部门设置API端点
|
|||
|
|
|
|||
|
|
3. `.gitignore` (+9行)
|
|||
|
|
- 添加临时文件忽略规则
|
|||
|
|
|
|||
|
|
4. `docs/API_V2.md` (更新)
|
|||
|
|
- 文档更新
|
|||
|
|
|
|||
|
|
5. `static/db_admin.html` (更新)
|
|||
|
|
- 前端界面调整
|
|||
|
|
|
|||
|
|
## 测试验证
|
|||
|
|
|
|||
|
|
### 测试场景1: 前缀匹配
|
|||
|
|
**输入**: "药品经营许可"
|
|||
|
|
**预期**: 直接返回"药品经营许可证"的数据，不触发LLM
|
|||
|
|
**结果**: ✅ 通过
|
|||
|
|
|
|||
|
|
### 测试场景2: 审批部门显示
|
|||
|
|
**输入**: "营业执照"
|
|||
|
|
**预期**: `unit_name` 返回 "市场监管部门"
|
|||
|
|
**结果**: ✅ 通过
|
|||
|
|
|
|||
|
|
### 测试场景3: 精确匹配优先
|
|||
|
|
**输入**: "营业执照"（数据库中存在完全相同的名称）
|
|||
|
|
**预期**: 优先返回精确匹配结果
|
|||
|
|
**结果**: ✅ 通过
|
|||
|
|
|
|||
|
|
## 影响范围
|
|||
|
|
|
|||
|
|
### 正面影响
|
|||
|
|
1. ✅ 提升用户体验：减少不必要的LLM调用
|
|||
|
|
2. ✅ 提高响应速度：直接数据库查询比LLM快
|
|||
|
|
3. ✅ 降低成本：减少LLM API调用
|
|||
|
|
4. ✅ 数据完整性：审批部门信息正确显示
|
|||
|
|
|
|||
|
|
### 潜在风险
|
|||
|
|
1. ⚠️ 前缀匹配可能返回多个结果（已通过精确匹配优先缓解）
|
|||
|
|
2. ⚠️ 需要定期维护审批部门映射表
|
|||
|
|
|
|||
|
|
## 后续建议
|
|||
|
|
|
|||
|
|
1. **数据维护**: 定期更新 `permit_approval_departments` 表
|
|||
|
|
2. **监控**: 监控前缀匹配的准确率
|
|||
|
|
3. **扩展**: 考虑添加同义词匹配功能
|
|||
|
|
4. **文档**: 更新API文档，说明新的匹配逻辑
|
|||
|
|
|
|||
|
|
## 相关链接
|
|||
|
|
|
|||
|
|
- Commit: 60b94d8
|
|||
|
|
- 相关Issue: V2 API Search Logic
|
|||
|
|
- 测试环境: http://127.0.0.1:5000
|