85 lines
7.6 KiB
Markdown
85 lines
7.6 KiB
Markdown
# 需求解析流程建表 SQL
|
|
|
|
在 `cadworld-api` 使用的 MySQL 数据库中执行以下建表语句。新增五张独立业务表,现有 `component` 表不变。应用启动不建表、不执行迁移;仓库 `.sql` 文件未修改。
|
|
|
|
自动生成流程复用以下五张表,无需修改表结构或执行新的迁移。新消息完成需求理解、选件和装配校验后,将解析结果与匹配快照一起保存;`ready` 表示方案已生成。`needs_clarification` 仅保留兼容旧记录,新流程不生成该状态。下方已有 DDL 的确认相关注释保留作为旧结构说明。
|
|
|
|
会话、消息、附件、解析和匹配均使用唯一编码对外访问,数据库主键只在内部使用。`owner_hash` 保存服务端认证主体的 `SHA-256("user:" + userCode)`;历史匿名归属保留至过期,已有表的注释调整见[登录迁移 SQL](auth-api.md#4-发布前手动执行的迁移-sql)。完整解析结果只由所属用户访问;模型配置、内部匹配快照和图片磁盘路径不返回前端。
|
|
|
|
```sql
|
|
CREATE TABLE `robot_demand_conversation` (
|
|
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '会话主键ID,仅内部使用',
|
|
`conversation_code` varchar(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '需求会话唯一编码',
|
|
`owner_hash` char(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '登录用户归属摘要,历史匿名归属保留至过期',
|
|
`revision` int unsigned NOT NULL DEFAULT '0' COMMENT '当前需求版本号,每次新用户消息递增',
|
|
`created_at` datetime(3) NOT NULL COMMENT '创建时间',
|
|
`updated_at` datetime(3) NOT NULL COMMENT '最近更新时间',
|
|
`expires_at` datetime(3) NOT NULL COMMENT '会话过期时间,默认最近新消息后七天',
|
|
PRIMARY KEY (`id`),
|
|
UNIQUE KEY `uk_demand_conversation_code` (`conversation_code`) COMMENT '会话编码唯一索引',
|
|
KEY `idx_demand_conversation_owner` (`owner_hash`,`updated_at`) COMMENT '用户会话查询索引',
|
|
KEY `idx_demand_conversation_expiry` (`expires_at`,`id`) COMMENT '过期会话清理索引'
|
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='机器人需求会话表';
|
|
|
|
CREATE TABLE `robot_demand_attachment` (
|
|
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '附件主键ID,仅内部使用',
|
|
`attachment_code` varchar(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '需求图片唯一编码',
|
|
`conversation_code` varchar(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '所属需求会话编码',
|
|
`message_code` varchar(80) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '' COMMENT '绑定的用户消息编码,未发送时为空',
|
|
`mime_type` varchar(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '图片格式,仅PNG、JPEG、WebP',
|
|
`size_bytes` bigint unsigned NOT NULL COMMENT '图片字节数,每张不超过8MiB',
|
|
`sha256` char(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '图片SHA-256,用于内容完整性校验',
|
|
`created_at` datetime(3) NOT NULL COMMENT '上传时间',
|
|
PRIMARY KEY (`id`),
|
|
UNIQUE KEY `uk_demand_attachment_code` (`attachment_code`) COMMENT '图片编码唯一索引',
|
|
KEY `idx_demand_attachment_conversation` (`conversation_code`,`id`) COMMENT '会话图片查询及清理索引'
|
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='机器人需求图片附件表';
|
|
|
|
CREATE TABLE `robot_demand_message` (
|
|
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '消息主键ID,仅内部排序使用',
|
|
`message_code` varchar(80) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '消息编码,用户消息由客户端生成并保持稳定',
|
|
`conversation_code` varchar(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '所属需求会话编码',
|
|
`message_role` varchar(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '消息角色:user或assistant,只由服务端设置',
|
|
`message_text` mediumtext NOT NULL COMMENT '用户原文或服务端生成的追问,每条最多20000字符',
|
|
`attachment_codes` json NOT NULL COMMENT '该消息的图片编码数组,文字消息写空数组',
|
|
`created_at` datetime(3) NOT NULL COMMENT '消息创建时间',
|
|
PRIMARY KEY (`id`),
|
|
UNIQUE KEY `uk_demand_message_code` (`conversation_code`,`message_code`) COMMENT '会话内消息幂等索引',
|
|
KEY `idx_demand_message_history` (`conversation_code`,`id`) COMMENT '按实际写入顺序加载历史'
|
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='机器人需求对话消息表';
|
|
|
|
CREATE TABLE `robot_demand_analysis` (
|
|
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '解析记录主键ID,仅内部使用',
|
|
`analysis_code` varchar(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '需求解析唯一编码',
|
|
`conversation_code` varchar(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '所属需求会话编码',
|
|
`source_message_code` varchar(80) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '触发本次解析的用户消息编码',
|
|
`revision` int unsigned NOT NULL COMMENT '解析对应的需求版本号',
|
|
`status` varchar(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '解析状态:processing、ready、needs_clarification、failed、cancelled、superseded',
|
|
`result_json` json NOT NULL COMMENT '完整标准化request和analysis,未完成时写空对象',
|
|
`model_version` varchar(128) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '本次使用的模型版本,仅服务端记录',
|
|
`failure_code` varchar(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '' COMMENT '通用失败编码,不保存上游响应正文或凭证',
|
|
`created_at` datetime(3) NOT NULL COMMENT '解析开始时间',
|
|
`updated_at` datetime(3) NOT NULL COMMENT '解析最近更新时间',
|
|
PRIMARY KEY (`id`),
|
|
UNIQUE KEY `uk_demand_analysis_code` (`analysis_code`) COMMENT '解析编码唯一索引',
|
|
UNIQUE KEY `uk_demand_analysis_revision` (`conversation_code`,`revision`) COMMENT '每个会话版本只有一份解析结果',
|
|
KEY `idx_demand_analysis_message` (`conversation_code`,`source_message_code`,`revision`) COMMENT '重复消息查询对应解析结果'
|
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='机器人需求解析记录表';
|
|
|
|
CREATE TABLE `robot_demand_match` (
|
|
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '匹配记录主键ID,仅内部使用',
|
|
`match_code` varchar(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '已确认需求的匹配方案唯一编码',
|
|
`analysis_code` varchar(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL COMMENT '对应的已确认解析编码',
|
|
`revision` int unsigned NOT NULL COMMENT '确认时的需求版本号',
|
|
`result_json` json NOT NULL COMMENT '匹配响应及内部组件版本快照,快照不对外返回',
|
|
`degradation_accepted` tinyint unsigned NOT NULL DEFAULT '0' COMMENT '是否接受明确降级:0-未接受,1-已接受,不代表要求已满足',
|
|
`created_at` datetime(3) NOT NULL COMMENT '首次确认匹配时间',
|
|
`updated_at` datetime(3) NOT NULL COMMENT '方案刷新或降级确认时间',
|
|
PRIMARY KEY (`id`),
|
|
UNIQUE KEY `uk_demand_match_code` (`match_code`) COMMENT '匹配编码唯一索引',
|
|
UNIQUE KEY `uk_demand_match_analysis` (`analysis_code`) COMMENT '解析版本确认幂等索引'
|
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='机器人需求确认匹配表';
|
|
```
|
|
|
|
图片文件存放于 `APP_DEMAND_ATTACHMENT_DIRECTORY` 指定的私有目录,不写入这些表,不发布为静态文件。生产部署需要持久化卷;多实例部署需要挂载同一个私有文件系统目录。
|