Merge branch 'emdash/lemon-shrimps-bake-7q6xl' into refactor/rag-chunking-strategy

# Conflicts: # AGENTS.md # CLAUDE.md # src/main/resources/application.yml
2026-06-23 11:06:34 +08:00
parent ac08345369 a3d806ed68
commit caef477cec
27 changed files with 7741 additions and 1 deletions
@@ -0,0 +1,56 @@
+-- V001: 创建诊断记录表
+-- 核心业务表，存储每次诊断任务的完整记录
+-- 设计理念：兼容多种故障类型（外部接口、内部错误、数据库、缓存等）
+
+CREATE TABLE diagnosis_record (
+    -- 主键
+    id BIGINT PRIMARY KEY AUTO_INCREMENT,
+    diagnosis_id VARCHAR(64) UNIQUE NOT NULL COMMENT '诊断唯一ID（UUID）',
+
+    -- 关联信息
+    session_id VARCHAR(64) COMMENT '会话ID（关联Redis）',
+    business_id VARCHAR(128) COMMENT '业务标识（订单号/请求ID/线程ID/任务ID...）',
+    trace_id VARCHAR(64) COMMENT '链路追踪ID',
+
+    -- 故障分类（泛化设计）
+    fault_category VARCHAR(32) COMMENT '故障类别（EXTERNAL_API/INTERNAL_ERROR/DATABASE/CACHE/NETWORK/THREAD/MEMORY/CONFIG）',
+    fault_source VARCHAR(128) COMMENT '故障源（省份/服务名/类名/数据库实例...）',
+    fault_target VARCHAR(256) COMMENT '故障目标（接口URL/方法名/SQL语句/缓存键...）',
+
+    -- 错误信息（通用）
+    error_code VARCHAR(64) COMMENT '错误码（业务错误码/HTTP状态码/异常类名）',
+    error_message TEXT COMMENT '错误消息',
+    stack_trace TEXT COMMENT '堆栈信息（内部错误时记录）',
+
+    -- 诊断结果
+    problem_type VARCHAR(32) COMMENT '问题类型（参数/网络/权限/逻辑/空指针/死锁...）',
+    root_cause TEXT COMMENT '根因分析',
+    solution TEXT COMMENT '修复方案',
+    report_markdown TEXT COMMENT '完整诊断报告（Markdown格式）',
+
+    -- 评估指标
+    status VARCHAR(16) DEFAULT 'PENDING' COMMENT '诊断状态（PENDING/RUNNING/SUCCESS/FAILED）',
+    confidence INT COMMENT '诊断置信度（0-100）',
+    duration INT COMMENT '诊断耗时（毫秒）',
+
+    -- 用户反馈
+    feedback VARCHAR(16) COMMENT '用户反馈（useful/not_useful/null）',
+
+    -- 调试字段
+    tool_calls JSON COMMENT '工具调用记录',
+
+    -- 元数据
+    created_by VARCHAR(64) COMMENT '创建人',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+
+    -- 索引
+    INDEX idx_business_id (business_id),
+    INDEX idx_trace_id (trace_id),
+    INDEX idx_session_id (session_id),
+    INDEX idx_fault_category (fault_category),
+    INDEX idx_fault_source_target (fault_source, fault_target(100)),
+    INDEX idx_error_code (error_code),
+    INDEX idx_created_at (created_at),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='诊断记录表（v2.0 泛化版）';
@@ -0,0 +1,41 @@
+-- V002: 创建案例库表
+-- 知识沉淀表，存储高质量诊断案例，支持相似案例推荐
+-- 设计理念：质量过滤，只存储成功诊断 + 用户反馈有用的案例
+
+CREATE TABLE case_library (
+    -- 主键
+    id BIGINT PRIMARY KEY AUTO_INCREMENT,
+    case_id VARCHAR(64) UNIQUE NOT NULL COMMENT '案例唯一ID（UUID）',
+
+    -- 来源关联
+    diagnosis_id VARCHAR(64) COMMENT '关联诊断记录（可选，人工录入时为空）',
+    source_type VARCHAR(16) DEFAULT 'AUTO' COMMENT '来源类型（AUTO:自动生成/MANUAL:人工录入）',
+
+    -- 案例分类
+    fault_category VARCHAR(32) COMMENT '故障类别（EXTERNAL_API/INTERNAL_ERROR/DATABASE...）',
+    fault_source VARCHAR(128) COMMENT '故障源（省份/服务名/类名...）',
+    fault_target VARCHAR(256) COMMENT '故障目标（接口URL/方法名/SQL...）',
+    error_code VARCHAR(64) COMMENT '错误码',
+
+    -- 案例内容
+    title VARCHAR(256) NOT NULL COMMENT '案例标题（简短描述）',
+    root_cause TEXT NOT NULL COMMENT '根因分析',
+    solution TEXT NOT NULL COMMENT '解决方案',
+
+    -- 简单统计
+    reference_count INT DEFAULT 0 COMMENT '引用次数（被推荐的次数）',
+
+    -- 元数据
+    created_by VARCHAR(64) COMMENT '创建人',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+
+    -- 索引
+    INDEX idx_fault_category (fault_category),
+    INDEX idx_error_code (error_code),
+    INDEX idx_fault_source (fault_source),
+    INDEX idx_fault_target (fault_target(100)),
+    INDEX idx_diagnosis_id (diagnosis_id),
+    INDEX idx_reference_count (reference_count),
+    INDEX idx_created_at (created_at)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='案例库表（MVP版）';
@@ -0,0 +1,38 @@
+-- V003: 创建文档元数据表
+-- 文档管理表，管理接口文档的元信息
+-- 设计理念：MySQL 负责元数据管理，Milvus 负责内容检索，通过 doc_id 关联
+
+CREATE TABLE api_document (
+    -- 主键
+    id BIGINT PRIMARY KEY AUTO_INCREMENT,
+    doc_id VARCHAR(64) UNIQUE NOT NULL COMMENT '文档唯一ID（UUID），关联Milvus',
+
+    -- 文档分类
+    fault_category VARCHAR(32) DEFAULT 'EXTERNAL_API' COMMENT '文档类别',
+    fault_source VARCHAR(128) COMMENT '文档归属（省份/服务名）',
+    api_name VARCHAR(128) COMMENT '接口名称',
+    version VARCHAR(32) DEFAULT 'v1.0' COMMENT '文档版本',
+
+    -- 文件信息
+    file_name VARCHAR(256) NOT NULL COMMENT '原始文件名',
+    file_path VARCHAR(512) COMMENT '文件存储路径',
+    file_hash VARCHAR(64) COMMENT '文件MD5 hash（用于去重）',
+    file_size BIGINT COMMENT '文件大小（字节）',
+
+    -- 索引状态
+    status VARCHAR(16) DEFAULT 'PENDING' COMMENT '索引状态（PENDING/PROCESSING/INDEXED/FAILED）',
+    chunk_count INT DEFAULT 0 COMMENT '分块数量',
+    error_message TEXT COMMENT '失败原因',
+
+    -- 时间字段
+    indexed_at DATETIME COMMENT '索引完成时间',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+
+    -- 索引
+    UNIQUE INDEX uk_file_hash (file_hash),
+    INDEX idx_doc_id (doc_id),
+    INDEX idx_fault_source (fault_source),
+    INDEX idx_status (status),
+    INDEX idx_created_at (created_at)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='文档元数据表（MVP版）';