52 lines
2.5 KiB
Markdown
52 lines
2.5 KiB
Markdown
# 案例库表：case_library
|
||
|
||
**状态**：当前表
|
||
**来源**：`V002__create_case_library.sql`、`CaseLibrary`
|
||
|
||
## 定位
|
||
|
||
`case_library` 保存高质量诊断案例，用于后续相似案例推荐和知识沉淀。当前自动沉淀路径来自 `useful` 用户反馈：新数据把 `diagnosis_run` 中的 query 和 answer 映射为案例内容。
|
||
|
||
## 字段
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
|---|---|---|---|
|
||
| `id` | BIGINT | 是 | 自增主键 |
|
||
| `case_id` | VARCHAR(64) | 是 | 案例唯一 ID |
|
||
| `diagnosis_id` | VARCHAR(64) | 否 | 关联诊断来源；新自动生成时存 `diagnosis_run.run_id`，历史数据可能是 `diagnosis_session.session_id` |
|
||
| `source_type` | VARCHAR(16) | 否 | 来源类型：`AUTO` 或 `MANUAL` |
|
||
| `fault_category` | VARCHAR(32) | 否 | 故障类别，实体侧使用 `FaultCategory` |
|
||
| `fault_source` | VARCHAR(128) | 否 | 故障源，例如服务、系统或省份 |
|
||
| `fault_target` | VARCHAR(256) | 否 | 故障目标，例如接口、方法、SQL 或组件 |
|
||
| `error_code` | VARCHAR(64) | 否 | 错误码或异常类型 |
|
||
| `title` | VARCHAR(256) | 是 | 案例标题 |
|
||
| `root_cause` | TEXT | 是 | 根因分析 |
|
||
| `solution` | TEXT | 是 | 解决方案 |
|
||
| `reference_count` | INT | 否 | 被推荐次数 |
|
||
| `created_by` | VARCHAR(64) | 否 | 创建人 |
|
||
| `created_at` | DATETIME | 是 | 创建时间 |
|
||
| `updated_at` | DATETIME | 是 | 更新时间 |
|
||
|
||
## 索引
|
||
|
||
| 索引 | 字段 | 用途 |
|
||
|---|---|---|
|
||
| `idx_fault_category` | `fault_category` | 按故障类别筛选 |
|
||
| `idx_error_code` | `error_code` | 按错误码精确匹配 |
|
||
| `idx_fault_source` | `fault_source` | 按故障源筛选 |
|
||
| `idx_fault_target` | `fault_target(100)` | 按故障目标筛选 |
|
||
| `idx_diagnosis_id` | `diagnosis_id` | 追溯来源运行或历史会话 |
|
||
| `idx_reference_count` | `reference_count` | 推荐排序 |
|
||
| `idx_created_at` | `created_at` | 时间排序 |
|
||
|
||
## 关系
|
||
|
||
- `case_library.diagnosis_id` 是过渡字段：新自动案例逻辑关联 `diagnosis_run.run_id`，历史自动案例可能仍是 `diagnosis_session.session_id`。
|
||
- 人工录入案例可以不填写 `diagnosis_id`。
|
||
|
||
## 注意点
|
||
|
||
- 旧文档里提到的 `diagnosis_record` 已被 `V007` 删除，不再是当前主模型。
|
||
- 查询新自动案例时优先按 `run_id` 追溯；遇到旧值时再按历史 `session_id` 解释。
|
||
- 当前自动沉淀仍比较粗：`root_cause` 和 `solution` 都可能来自完整 answer。后续可从结构化结论中拆分根因、证据和修复建议。
|