Bruce/common_agent
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(database): 规范脚本顺序并补全字段注释

Browse Source
This commit is contained in:
bruce
2026-06-01 02:10:34 +08:00
parent d92496854d
commit 6fe1209801
70 changed files with 695 additions and 178 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
docs/ARCHITECTURE.md
View File

@@ -238,3 +238,4 @@
3. 建设 Agent 工具注册与调用协议，补齐任务状态与执行日志。
4. 补齐索引任务、重试、重建索引和前端任务视图。
5. 衔接模型供应商、Spring AI 适配层、工作流编排和前端管理台。

1
docs/MODEL_PROVIDER_DESIGN.md
View File

@@ -896,3 +896,4 @@ OpenAI-compatible 客户端使用 Mock Web Server 或类似方式测试：
- Ollama Embeddings: https://docs.ollama.com/capabilities/embeddings
- Spring AI OpenAI Embeddings: https://docs.spring.io/spring-ai/reference/api/embeddings/openai-embeddings.html
- SiliconFlow Embedding 模型列表: https://www.siliconflow.com/models/embedding

1
docs/MODEL_PROVIDER_REQUIREMENTS.md
View File

@@ -446,3 +446,4 @@ Embedding 批量生成应支持批处理，减少网络请求次数。批量大
- Ollama Embeddings: https://docs.ollama.com/capabilities/embeddings
- Spring AI OpenAI Embeddings: https://docs.spring.io/spring-ai/reference/api/embeddings/openai-embeddings.html
- SiliconFlow Embedding 模型列表: https://www.siliconflow.com/models/embedding

1
docs/MODEL_PROVIDER_SCHEMA.sql
View File

@@ -260,3 +260,4 @@ COMMENT ON COLUMN model_call_log.update_time IS '更新时间';
COMMENT ON COLUMN model_call_log.remark IS '备注';
COMMENT ON COLUMN model_call_log.create_by IS '创建者';
COMMENT ON COLUMN model_call_log.update_by IS '更新者';

1
docs/ROADMAP.md
View File

@@ -149,3 +149,4 @@ Agent 主线能力按以下顺序继续推进：
### 里程碑 4：平台管理化
- 补齐前端占位页面联调与后台配置能力，形成完整平台雏形。

168
docs/STUDIO_PROTOTYPE_SCHEMA.sql
View File

@@ -251,14 +251,182 @@ CREATE INDEX IF NOT EXISTS idx_skill_version_skill_id ON skill_version (skill_id
CREATE INDEX IF NOT EXISTS idx_skill_version_publish_status ON skill_version (publish_status);
COMMENT ON TABLE studio_project IS 'Studio项目空间表';
COMMENT ON COLUMN studio_project.id IS 'ID';
COMMENT ON COLUMN studio_project.project_code IS '项目编码';
COMMENT ON COLUMN studio_project.project_name IS '项目名称';
COMMENT ON COLUMN studio_project.environment IS '环境';
COMMENT ON COLUMN studio_project.publish_status IS '发布状态';
COMMENT ON COLUMN studio_project.current_version IS '当前发布版本';
COMMENT ON COLUMN studio_project.version IS '版本';
COMMENT ON COLUMN studio_project.create_time IS '创建时间';
COMMENT ON COLUMN studio_project.update_time IS '更新时间';
COMMENT ON COLUMN studio_project.remark IS '备注';
COMMENT ON COLUMN studio_project.create_by IS '创建者';
COMMENT ON COLUMN studio_project.update_by IS '更新者';
COMMENT ON TABLE workflow_definition IS 'Workflow定义表';
COMMENT ON COLUMN workflow_definition.id IS 'ID';
COMMENT ON COLUMN workflow_definition.project_id IS '所属项目ID';
COMMENT ON COLUMN workflow_definition.workflow_code IS 'Workflow编码';
COMMENT ON COLUMN workflow_definition.workflow_name IS 'Workflow名称';
COMMENT ON COLUMN workflow_definition.description IS 'Workflow描述';
COMMENT ON COLUMN workflow_definition.bound_agent_id IS '绑定Agent ID';
COMMENT ON COLUMN workflow_definition.status IS '状态';
COMMENT ON COLUMN workflow_definition.version IS '版本';
COMMENT ON COLUMN workflow_definition.create_time IS '创建时间';
COMMENT ON COLUMN workflow_definition.update_time IS '更新时间';
COMMENT ON COLUMN workflow_definition.remark IS '备注';
COMMENT ON COLUMN workflow_definition.create_by IS '创建者';
COMMENT ON COLUMN workflow_definition.update_by IS '更新者';
COMMENT ON TABLE workflow_version IS 'Workflow版本快照表';
COMMENT ON COLUMN workflow_version.id IS 'ID';
COMMENT ON COLUMN workflow_version.workflow_id IS 'Workflow定义ID';
COMMENT ON COLUMN workflow_version.version_no IS '版本号';
COMMENT ON COLUMN workflow_version.snapshot_name IS '快照名称';
COMMENT ON COLUMN workflow_version.graph_json IS '编排图JSON';
COMMENT ON COLUMN workflow_version.publish_status IS '发布状态';
COMMENT ON COLUMN workflow_version.published_time IS '发布时间';
COMMENT ON COLUMN workflow_version.version IS '版本';
COMMENT ON COLUMN workflow_version.create_time IS '创建时间';
COMMENT ON COLUMN workflow_version.update_time IS '更新时间';
COMMENT ON COLUMN workflow_version.remark IS '备注';
COMMENT ON COLUMN workflow_version.create_by IS '创建者';
COMMENT ON COLUMN workflow_version.update_by IS '更新者';
COMMENT ON TABLE workflow_run IS 'Workflow运行记录表';
COMMENT ON COLUMN workflow_run.id IS 'ID';
COMMENT ON COLUMN workflow_run.request_id IS '请求唯一ID';
COMMENT ON COLUMN workflow_run.workflow_id IS 'Workflow定义ID';
COMMENT ON COLUMN workflow_run.workflow_version_id IS 'Workflow版本ID';
COMMENT ON COLUMN workflow_run.agent_id IS '执行Agent ID';
COMMENT ON COLUMN workflow_run.run_source IS '运行来源';
COMMENT ON COLUMN workflow_run.status IS '运行状态';
COMMENT ON COLUMN workflow_run.input_json IS '输入参数JSON';
COMMENT ON COLUMN workflow_run.output_json IS '输出结果JSON';
COMMENT ON COLUMN workflow_run.duration_ms IS '耗时(毫秒)';
COMMENT ON COLUMN workflow_run.estimated_cost IS '预估成本';
COMMENT ON COLUMN workflow_run.version IS '版本';
COMMENT ON COLUMN workflow_run.create_time IS '创建时间';
COMMENT ON COLUMN workflow_run.update_time IS '更新时间';
COMMENT ON COLUMN workflow_run.remark IS '备注';
COMMENT ON COLUMN workflow_run.create_by IS '创建者';
COMMENT ON COLUMN workflow_run.update_by IS '更新者';
COMMENT ON TABLE workflow_run_step IS 'Workflow运行步骤表';
COMMENT ON COLUMN workflow_run_step.id IS 'ID';
COMMENT ON COLUMN workflow_run_step.run_id IS '运行记录ID';
COMMENT ON COLUMN workflow_run_step.node_id IS '节点ID';
COMMENT ON COLUMN workflow_run_step.node_type IS '节点类型';
COMMENT ON COLUMN workflow_run_step.node_name IS '节点名称';
COMMENT ON COLUMN workflow_run_step.status IS '步骤状态';
COMMENT ON COLUMN workflow_run_step.input_json IS '步骤输入JSON';
COMMENT ON COLUMN workflow_run_step.output_json IS '步骤输出JSON';
COMMENT ON COLUMN workflow_run_step.duration_ms IS '耗时(毫秒)';
COMMENT ON COLUMN workflow_run_step.error_message IS '错误信息';
COMMENT ON COLUMN workflow_run_step.version IS '版本';
COMMENT ON COLUMN workflow_run_step.create_time IS '创建时间';
COMMENT ON COLUMN workflow_run_step.update_time IS '更新时间';
COMMENT ON COLUMN workflow_run_step.remark IS '备注';
COMMENT ON COLUMN workflow_run_step.create_by IS '创建者';
COMMENT ON COLUMN workflow_run_step.update_by IS '更新者';
COMMENT ON TABLE mcp_server IS 'MCP服务表';
COMMENT ON COLUMN mcp_server.id IS 'ID';
COMMENT ON COLUMN mcp_server.server_code IS '服务编码';
COMMENT ON COLUMN mcp_server.server_name IS '服务名称';
COMMENT ON COLUMN mcp_server.import_type IS '导入方式';
COMMENT ON COLUMN mcp_server.endpoint_url IS '服务端点地址';
COMMENT ON COLUMN mcp_server.package_name IS '安装包名称';
COMMENT ON COLUMN mcp_server.manifest_json IS 'Manifest声明JSON';
COMMENT ON COLUMN mcp_server.auth_type IS '鉴权类型';
COMMENT ON COLUMN mcp_server.secret_ref IS '密钥引用';
COMMENT ON COLUMN mcp_server.health_status IS '健康状态';
COMMENT ON COLUMN mcp_server.enabled IS '是否启用';
COMMENT ON COLUMN mcp_server.version IS '版本';
COMMENT ON COLUMN mcp_server.create_time IS '创建时间';
COMMENT ON COLUMN mcp_server.update_time IS '更新时间';
COMMENT ON COLUMN mcp_server.remark IS '备注';
COMMENT ON COLUMN mcp_server.create_by IS '创建者';
COMMENT ON COLUMN mcp_server.update_by IS '更新者';
COMMENT ON TABLE mcp_capability IS 'MCP能力表';
COMMENT ON COLUMN mcp_capability.id IS 'ID';
COMMENT ON COLUMN mcp_capability.server_id IS '所属服务ID';
COMMENT ON COLUMN mcp_capability.capability_code IS '能力编码';
COMMENT ON COLUMN mcp_capability.capability_name IS '能力名称';
COMMENT ON COLUMN mcp_capability.capability_type IS '能力类型';
COMMENT ON COLUMN mcp_capability.schema_json IS '能力Schema JSON';
COMMENT ON COLUMN mcp_capability.enabled IS '是否启用';
COMMENT ON COLUMN mcp_capability.version IS '版本';
COMMENT ON COLUMN mcp_capability.create_time IS '创建时间';
COMMENT ON COLUMN mcp_capability.update_time IS '更新时间';
COMMENT ON COLUMN mcp_capability.remark IS '备注';
COMMENT ON COLUMN mcp_capability.create_by IS '创建者';
COMMENT ON COLUMN mcp_capability.update_by IS '更新者';
COMMENT ON TABLE skill_definition IS 'Skill定义表';
COMMENT ON COLUMN skill_definition.id IS 'ID';
COMMENT ON COLUMN skill_definition.skill_code IS 'Skill编码';
COMMENT ON COLUMN skill_definition.skill_name IS 'Skill名称';
COMMENT ON COLUMN skill_definition.skill_type IS 'Skill类型';
COMMENT ON COLUMN skill_definition.description IS 'Skill描述';
COMMENT ON COLUMN skill_definition.status IS '状态';
COMMENT ON COLUMN skill_definition.version IS '版本';
COMMENT ON COLUMN skill_definition.create_time IS '创建时间';
COMMENT ON COLUMN skill_definition.update_time IS '更新时间';
COMMENT ON COLUMN skill_definition.remark IS '备注';
COMMENT ON COLUMN skill_definition.create_by IS '创建者';
COMMENT ON COLUMN skill_definition.update_by IS '更新者';
COMMENT ON TABLE skill_version IS 'Skill版本表';
COMMENT ON COLUMN skill_version.id IS 'ID';
COMMENT ON COLUMN skill_version.skill_id IS 'Skill定义ID';
COMMENT ON COLUMN skill_version.version_no IS '版本号';
COMMENT ON COLUMN skill_version.prompt_text IS '提示词内容';
COMMENT ON COLUMN skill_version.code_text IS '代码内容';
COMMENT ON COLUMN skill_version.config_json IS '运行配置JSON';
COMMENT ON COLUMN skill_version.variable_schema_json IS '变量Schema JSON';
COMMENT ON COLUMN skill_version.test_result_json IS '测试结果JSON';
COMMENT ON COLUMN skill_version.publish_status IS '发布状态';
COMMENT ON COLUMN skill_version.published_time IS '发布时间';
COMMENT ON COLUMN skill_version.version IS '版本';
COMMENT ON COLUMN skill_version.create_time IS '创建时间';
COMMENT ON COLUMN skill_version.update_time IS '更新时间';
COMMENT ON COLUMN skill_version.remark IS '备注';
COMMENT ON COLUMN skill_version.create_by IS '创建者';
COMMENT ON COLUMN skill_version.update_by IS '更新者';
COMMENT ON TABLE agent_session IS 'Agent会话表';
COMMENT ON COLUMN agent_session.id IS 'ID';
COMMENT ON COLUMN agent_session.session_code IS '会话编码';
COMMENT ON COLUMN agent_session.agent_id IS 'Agent ID';
COMMENT ON COLUMN agent_session.workflow_run_id IS '来源Workflow运行ID';
COMMENT ON COLUMN agent_session.title IS '会话标题';
COMMENT ON COLUMN agent_session.status IS '会话状态';
COMMENT ON COLUMN agent_session.metadata_json IS '会话元数据JSON';
COMMENT ON COLUMN agent_session.version IS '版本';
COMMENT ON COLUMN agent_session.create_time IS '创建时间';
COMMENT ON COLUMN agent_session.update_time IS '更新时间';
COMMENT ON COLUMN agent_session.remark IS '备注';
COMMENT ON COLUMN agent_session.create_by IS '创建者';
COMMENT ON COLUMN agent_session.update_by IS '更新者';
COMMENT ON TABLE agent_message IS 'Agent消息表';
COMMENT ON COLUMN agent_message.id IS 'ID';
COMMENT ON COLUMN agent_message.session_id IS '会话ID';
COMMENT ON COLUMN agent_message.role IS '消息角色';
COMMENT ON COLUMN agent_message.content IS '消息内容';
COMMENT ON COLUMN agent_message.citation_json IS '引用信息JSON';
COMMENT ON COLUMN agent_message.token_count IS 'Token数量';
COMMENT ON COLUMN agent_message.version IS '版本';
COMMENT ON COLUMN agent_message.create_time IS '创建时间';
COMMENT ON COLUMN agent_message.update_time IS '更新时间';
COMMENT ON COLUMN agent_message.remark IS '备注';
COMMENT ON COLUMN agent_message.create_by IS '创建者';
COMMENT ON COLUMN agent_message.update_by IS '更新者';
COMMENT ON TABLE agent_capability_binding IS 'Agent能力绑定表';
COMMENT ON COLUMN agent_capability_binding.id IS 'ID';
COMMENT ON COLUMN agent_capability_binding.owner_type IS '绑定主体类型';
COMMENT ON COLUMN agent_capability_binding.owner_id IS '绑定主体ID';
COMMENT ON COLUMN agent_capability_binding.capability_type IS '能力类型';
COMMENT ON COLUMN agent_capability_binding.capability_id IS '能力ID';
COMMENT ON COLUMN agent_capability_binding.enabled IS '是否启用';
COMMENT ON COLUMN agent_capability_binding.config_json IS '绑定配置JSON';
COMMENT ON COLUMN agent_capability_binding.version IS '版本';
COMMENT ON COLUMN agent_capability_binding.create_time IS '创建时间';
COMMENT ON COLUMN agent_capability_binding.update_time IS '更新时间';
COMMENT ON COLUMN agent_capability_binding.remark IS '备注';
COMMENT ON COLUMN agent_capability_binding.create_by IS '创建者';
COMMENT ON COLUMN agent_capability_binding.update_by IS '更新者';

1
docs/前端实现文档/0.前端模块总览.md
View File

@@ -25,3 +25,4 @@ Studio 原型页面位于 `frontend/src/pages/studio/`，路由集中在 `fronte
- Long ID 继续按字符串处理，避免 JS 精度问题。
- 枚举值按整型协议处理，页面展示通过枚举字典或常量映射。
- 管理后台保持信息密度、稳定布局和清晰状态提示。

1
docs/前端实现文档/1.系统基础模块前端实现.md
View File

@@ -26,3 +26,4 @@
- 文件解析管道复用附件上传能力。
- 知识资产、模型路由、Workflow、Agent 等页面复用枚举字典。
- 运行观测页面复用统一状态颜色和错误提示格式。

1
docs/前端实现文档/2.知识资产与文件解析模块前端实现.md
View File

@@ -43,3 +43,4 @@
- 索引中显示进行中状态，不允许误标为可检索。
- 切片参数变更后提示需要重建索引。
- Embedding 模型变更后提示会影响当前知识库向量空间。

1
docs/前端实现文档/3.模型与路由模块前端实现.md
View File

@@ -28,3 +28,4 @@
- Embedding 模型维度变更时提示知识库需要重建索引。
- 草稿路由不得用于生产发布就绪校验。
- Fallback 模型为空时在发布检查中提示风险。

1
docs/前端实现文档/4.Workflow编排模块前端实现.md
View File

@@ -29,3 +29,4 @@
- 运行测试生成 `workflow_run` 和 `workflow_run_step`。
- 发布前调用发布就绪检查。
- 节点 Inspector 只编辑当前节点配置，不直接改其他节点。

1
docs/前端实现文档/5.Agent会话模块前端实现.md
View File

@@ -31,3 +31,4 @@
- 未召回知识切片时给出明确提示。
- 模型调用失败时展示 `request_id` 和错误摘要。
- 会话保存失败不得清空用户输入。

1
docs/前端实现文档/6.MCP能力接入模块前端实现.md
View File

@@ -17,3 +17,4 @@
- 能力预览成功后才允许保存。
- 未授权能力显示待授权状态。
- 已停用 Server 的能力不可被 Workflow 新增选择。

1
docs/前端实现文档/7.Skill编辑模块前端实现.md
View File

@@ -17,3 +17,4 @@
- 草稿变更后提示未发布。
- 测试结果保存到版本草稿。
- Workflow 只能选择发布版本或明确选择草稿测试。

1
docs/前端实现文档/8.运行观测模块前端实现.md
View File

@@ -26,3 +26,4 @@
- 异常运行高亮展示。
- 步骤日志按执行时间排序。
- 导出日志不包含密钥或完整敏感请求体。

4
docs/后端实现文档/0.后端模块总览.md
View File

@@ -32,5 +32,7 @@
- Java 枚举定义。
- `sys_enum` 初始化测试。
- `script/sql/studio_enum.sql` 或对应模块枚举脚本。
- `script/sql/18.studio_enum.sql` 或对应模块枚举脚本。
- 前端枚举常量或字典接口。

1
docs/后端实现文档/1.系统基础模块后端实现.md
View File

@@ -37,3 +37,4 @@ Controller 只接收请求 DTO 或基础参数，不直接暴露实体。响应
- 不调整 `sys_enum` 表字段。
- 新增枚举时同步初始化测试和 SQL 初始化脚本。
- 文档解析器新增类型时，只扩展解析器实现和工厂注册，不影响 RAG 业务服务。

1
docs/后端实现文档/2.知识资产与文件解析模块后端实现.md
View File

@@ -37,3 +37,4 @@ Studio 聚合接口后续新增在知识资产模块，不替代旧接口。
- 只有解析成功的文档允许切片。
- 向量化必须读取知识库生效模型配置。
- 重新切片或模型变更后，索引状态必须回到待索引或索引中。

1
docs/后端实现文档/3.模型与路由模块后端实现.md
View File

@@ -39,3 +39,4 @@
- 路由主模型必须启用。
- 路由任务类型必须来自枚举。
- 知识库 Embedding 维度必须与模型配置一致。

1
docs/后端实现文档/4.Workflow编排模块后端实现.md
View File

@@ -36,3 +36,4 @@
- 节点类型必须来自枚举。
- LLM 节点必须配置任务类型。
- Knowledge Retrieval 节点必须配置知识库或继承项目默认知识库。

1
docs/后端实现文档/5.Agent会话模块后端实现.md
View File

@@ -27,3 +27,4 @@
- 消息内容不能为空。
- `citation_json` 必须是数组结构。
- 会话关闭后不允许继续写入消息。

1
docs/后端实现文档/6.MCP能力接入模块后端实现.md
View File

@@ -18,3 +18,4 @@
- 能力编码在 Server 下唯一。
- 导入方式必须来自枚举。
- 能力 schema 必须为合法 JSON。

1
docs/后端实现文档/7.Skill编辑模块后端实现.md
View File

@@ -18,3 +18,4 @@
- 版本号在 Skill 内唯一。
- Prompt、Code、Config 至少一种非空。
- 变量 schema 必须为合法 JSON。

1
docs/后端实现文档/8.运行观测模块后端实现.md
View File

@@ -22,3 +22,4 @@
- 只允许查询脱敏后的运行摘要。
- 导出接口必须过滤密钥和完整请求内容。
- requestId 不存在时返回空结果而不是内部异常。

21
docs/数据库设计/0.数据库与枚举总览.md
View File

@@ -8,7 +8,7 @@
| 脚本位置 | 作用 |
|----------|------|
| `script/sql/` | 可执行的模块化建表或初始化脚本 |
| `script/` | 可执行的模块化建表或初始化脚本 |
| `docs/MODEL_PROVIDER_SCHEMA.sql` | 模型平台 schema 汇总 |
| `docs/STUDIO_PROTOTYPE_SCHEMA.sql` | Studio 原型 schema 汇总 |
@@ -16,7 +16,7 @@
## 3. 必须保持不变的内容
`script/sql/enum.sql` 中 `sys_enum` 表结构不变：
`script/sql/1.enum.sql` 中 `sys_enum` 表结构不变：
- `catalog`
- `type`
@@ -37,13 +37,13 @@ Java 枚举契约 `PersistableSysEnumDefinition` 的格式不变。后续如果
| 脚本 | 内容 |
|------|------|
| `script/sql/studio_project.sql` | Studio 项目空间表 |
| `script/sql/workflow.sql` | Workflow 定义、版本、运行、步骤日志 |
| `script/sql/mcp.sql` | MCP Server 与能力表 |
| `script/sql/skill.sql` | Skill 定义与版本表 |
| `script/sql/agent_session.sql` | Agent 会话与消息表 |
| `script/sql/agent_capability_binding.sql` | Agent/Workflow 与 MCP/Skill/知识能力绑定表 |
| `script/sql/studio_enum.sql` | Studio 相关枚举初始化 |
| `script/sql/11.studio_project.sql` | Studio 项目空间表 |
| `script/sql/12.workflow.sql` | Workflow 定义、版本、运行、步骤日志 |
| `script/sql/14.mcp.sql` | MCP Server 与能力表 |
| `script/sql/15.skill.sql` | Skill 定义与版本表 |
| `script/sql/13.agent_session.sql` | Agent 会话与消息表 |
| `script/sql/16.agent_capability_binding.sql` | Agent/Workflow 与 MCP/Skill/知识能力绑定表 |
| `script/sql/18.studio_enum.sql` | Studio 相关枚举初始化 |
## 5. 校验规则
@@ -52,3 +52,6 @@ Java 枚举契约 `PersistableSysEnumDefinition` 的格式不变。后续如果
- 需要跨模块引用的字段必须在文档中说明外键关系。
- JSON 扩展字段统一使用 `JSONB`。
- 枚举初始化脚本必须使用 `ON CONFLICT (catalog, type, name) DO UPDATE`，与现有脚本风格一致。

13
docs/数据库设计/2.知识资产数据库设计.md
View File

@@ -13,11 +13,11 @@
## 2. 脚本清单
- `script/sql/rag_store.sql`
- `script/sql/rag_document.sql`
- `script/sql/rag_document_parse_result.sql`
- `script/sql/rag_chunk.sql`
- `script/sql/rag_chunk_embedding.sql`
- `script/sql/3.rag_store.sql`
- `script/sql/4.rag_document.sql`
- `script/sql/5.rag_document_parse_result.sql`
- `script/sql/6.rag_chunk.sql`
- `script/sql/7.rag_chunk_embedding.sql`
- `docs/MODEL_PROVIDER_SCHEMA.sql` 中的 `rag_store_model_config`
## 3. 枚举组
@@ -35,3 +35,6 @@
- `rag_chunk` 使用 `(document_id, chunk_index)` 保证同文档切片序号唯一。
- `rag_chunk_embedding` 使用 `(chunk_id, embedding_model)` 防止同模型重复写入。
- RAG 现有脚本与本文档一致，本轮不调整 `sys_enum` 格式。

5
docs/数据库设计/3.模型与路由数据库设计.md
View File

@@ -33,5 +33,8 @@
## 4. 脚本
- `docs/MODEL_PROVIDER_SCHEMA.sql` 是完整 schema 快照。
- `script/sql/model_provider.sql` 是后续执行入口。
- `script/sql/9.model_provider.sql` 是后续执行入口。
- 若模型枚举变更，需要同步 Java 枚举、初始化测试和 SQL 枚举脚本。

6
docs/数据库设计/4.Workflow数据库设计.md
View File

@@ -20,8 +20,8 @@
## 3. 脚本
- `script/sql/studio_project.sql`
- `script/sql/workflow.sql`
- `script/sql/11.studio_project.sql`
- `script/sql/12.workflow.sql`
- `docs/STUDIO_PROTOTYPE_SCHEMA.sql`
## 4. JSON 字段
@@ -31,3 +31,5 @@
- `workflow_run_step.input_json` 与 `output_json` 保存节点级输入输出摘要。
JSON 字段只保存运行必要摘要，不保存敏感密钥。

9
docs/数据库设计/5.Agent会话数据库设计.md
View File

@@ -26,7 +26,10 @@
## 4. 脚本
- `script/sql/agent_definition.sql`
- `script/sql/agent_session.sql`
- `script/sql/agent_capability_binding.sql`
- `script/sql/8.agent_definition.sql`
- `script/sql/13.agent_session.sql`
- `script/sql/16.agent_capability_binding.sql`
- `docs/STUDIO_PROTOTYPE_SCHEMA.sql`

6
docs/数据库设计/6.MCP数据库设计.md
View File

@@ -15,6 +15,8 @@
## 3. 脚本
- `script/sql/mcp.sql`
- `script/sql/14.mcp.sql`
- `docs/STUDIO_PROTOTYPE_SCHEMA.sql`
- `script/sql/studio_enum.sql`
- `script/sql/18.studio_enum.sql`

6
docs/数据库设计/7.Skill数据库设计.md
View File

@@ -15,6 +15,8 @@
## 3. 脚本
- `script/sql/skill.sql`
- `script/sql/15.skill.sql`
- `docs/STUDIO_PROTOTYPE_SCHEMA.sql`
- `script/sql/studio_enum.sql`
- `script/sql/18.studio_enum.sql`

9
docs/数据库设计/8.运行观测数据库设计.md
View File

@@ -23,7 +23,10 @@
索引分散在：
- `script/sql/workflow.sql`
- `script/sql/model_provider.sql`
- `script/sql/agent_session.sql`
- `script/sql/12.workflow.sql`
- `script/sql/9.model_provider.sql`
- `script/sql/13.agent_session.sql`
- `docs/STUDIO_PROTOTYPE_SCHEMA.sql`

23
docs/数据库设计/9.模块一致性校验.md
View File

@@ -9,7 +9,7 @@
- `数据库设计/`
- `前端实现文档/`
- `后端实现文档/`
- `script/sql/*.sql`
- `script/*.sql`
- `docs/MODEL_PROVIDER_SCHEMA.sql`
- `docs/STUDIO_PROTOTYPE_SCHEMA.sql`
@@ -21,17 +21,17 @@
| 模块 | 汇总 schema | 模块化脚本 | 结论 |
|------|-------------|------------|------|
| 模型与路由 | `docs/MODEL_PROVIDER_SCHEMA.sql` | `script/sql/model_provider.sql` | 已补齐 `rag_store_model_config.store_id` 外键 |
| Studio 项目 | `docs/STUDIO_PROTOTYPE_SCHEMA.sql` | `script/sql/studio_project.sql` | 表、唯一约束、索引一致 |
| Workflow | `docs/STUDIO_PROTOTYPE_SCHEMA.sql` | `script/sql/workflow.sql` | 定义、版本、运行、步骤表一致 |
| Agent 会话 | `docs/STUDIO_PROTOTYPE_SCHEMA.sql` | `script/sql/agent_session.sql` | 会话和消息表一致 |
| 能力绑定 | `docs/STUDIO_PROTOTYPE_SCHEMA.sql` | `script/sql/agent_capability_binding.sql` | 唯一约束和索引一致 |
| MCP | `docs/STUDIO_PROTOTYPE_SCHEMA.sql` | `script/sql/mcp.sql` | Server 与 Capability 表一致 |
| Skill | `docs/STUDIO_PROTOTYPE_SCHEMA.sql` | `script/sql/skill.sql` | 定义与版本表一致 |
| 模型与路由 | `docs/MODEL_PROVIDER_SCHEMA.sql` | `script/sql/9.model_provider.sql` | 已补齐 `rag_store_model_config.store_id` 外键 |
| Studio 项目 | `docs/STUDIO_PROTOTYPE_SCHEMA.sql` | `script/sql/11.studio_project.sql` | 表、唯一约束、索引一致 |
| Workflow | `docs/STUDIO_PROTOTYPE_SCHEMA.sql` | `script/sql/12.workflow.sql` | 定义、版本、运行、步骤表一致 |
| Agent 会话 | `docs/STUDIO_PROTOTYPE_SCHEMA.sql` | `script/sql/13.agent_session.sql` | 会话和消息表一致 |
| 能力绑定 | `docs/STUDIO_PROTOTYPE_SCHEMA.sql` | `script/sql/16.agent_capability_binding.sql` | 唯一约束和索引一致 |
| MCP | `docs/STUDIO_PROTOTYPE_SCHEMA.sql` | `script/sql/14.mcp.sql` | Server 与 Capability 表一致 |
| Skill | `docs/STUDIO_PROTOTYPE_SCHEMA.sql` | `script/sql/15.skill.sql` | 定义与版本表一致 |
## 4. 枚举一致性
`script/sql/studio_enum.sql` 保持 `sys_enum` 既有格式：
`script/sql/18.studio_enum.sql` 保持 `sys_enum` 既有格式：
- `catalog`
- `type`
@@ -75,5 +75,8 @@
- Java 枚举类。
- `SysEnumDataInitTests` 初始化入口。
- `EnumDefinitionTests` 稳定性断言。
- `script/sql/studio_enum.sql` 初始化数据。
- `script/sql/18.studio_enum.sql` 初始化数据。
- 前端字典或常量映射。

1
docs/设计文档/0.模块设计总览.md
View File

@@ -48,3 +48,4 @@ flowchart LR
- 枚举设计必须保留 `sys_enum` 当前格式。
- 数据库中状态字段允许继续使用 `VARCHAR` 保存枚举代码，前后端协议层对结构化枚举继续传整型值。
- 页面展示文案来自枚举定义或前端常量映射，不在业务逻辑中散落硬编码。

1
docs/设计文档/1.系统基础模块设计.md
View File

@@ -30,3 +30,4 @@
## 5. 依赖关系
系统基础模块不能依赖其他业务模块。业务模块可依赖系统基础模块的枚举、附件、解析、返回体和异常处理。

1
docs/设计文档/2.知识资产与文件解析模块设计.md
View File

@@ -42,3 +42,4 @@ flowchart LR
- `rag_chunk_embedding` 必须记录模型和维度，防止向量空间混用。
- 知识库模型配置由模型与路由模块维护，但知识资产模块负责消费。
- 检索配置要面向 Workflow 和 Agent 复用，不绑定某一个页面。

1
docs/设计文档/3.模型与路由模块设计.md
View File

@@ -45,3 +45,4 @@
- 知识资产模块使用 Embedding 路由和知识库模型绑定。
- Workflow 和 Agent 使用 Chat 路由。
- 运行观测读取 `model_call_log`。

1
docs/设计文档/4.Workflow编排模块设计.md
View File

@@ -44,3 +44,4 @@ flowchart LR
- MCP Tool 节点依赖 MCP 模块。
- Skill 节点依赖 Skill 模块。
- 运行记录被运行观测模块消费。

1
docs/设计文档/5.Agent会话模块设计.md
View File

@@ -48,3 +48,4 @@
- 依赖模型与路由模块完成 Chat 调用。
- 可依赖 Workflow 模块执行复杂流程。
- 运行观测模块读取会话关联的运行记录。

1
docs/设计文档/6.MCP能力接入模块设计.md
View File

@@ -24,3 +24,4 @@ flowchart LR
- `manifest_json` 保存原始能力声明摘要。
- `schema_json` 保存单个能力输入输出 schema。
- Server 停用时，其能力不应被新运行选择。

1
docs/设计文档/7.Skill编辑模块设计.md
View File

@@ -21,3 +21,4 @@
- `config_json` 保存运行配置。
- `variable_schema_json` 保存输入输出变量定义。
- `test_result_json` 保存最近测试结果摘要。

1
docs/设计文档/8.运行观测模块设计.md
View File

@@ -33,3 +33,4 @@
- 观测模块只读业务运行数据。
- 不保存完整 Prompt 或敏感密钥。
- 错误信息只保存摘要，详细日志由运行环境负责。

3
docs/需求分析/0.模块总览.md
View File

@@ -33,7 +33,7 @@
本轮 SQL 脚本属于正式交付范围：
- `script/sql/*.sql`：面向落库执行的模块化脚本。
- `script/*.sql`：面向落库执行的模块化脚本。
- `docs/MODEL_PROVIDER_SCHEMA.sql`：模型平台 schema 汇总。
- `docs/STUDIO_PROTOTYPE_SCHEMA.sql`：Studio 原型 schema 汇总。
@@ -64,3 +64,4 @@
- 关联后端接口草案。
最终以 `数据库设计/9.模块一致性校验.md` 统一检查跨模块冲突。

5
docs/需求分析/1.系统基础模块需求.md
View File

@@ -33,6 +33,9 @@
- 表：`sys_enum`、`sys_attachment`
- 枚举：`common/enable_status`、`common/common_status`
- 脚本：`script/sql/enum.sql`、`script/sql/attachment.sql`
- 脚本：`script/sql/1.enum.sql`、`script/sql/2.attachment.sql`
- 后端入口：`SysEnumController`、`SysAttachmentController`、`DocumentParserFactory`
- 前端入口：系统枚举 API、文件上传组件、枚举字典调用

5
docs/需求分析/2.知识资产与文件解析模块需求.md
View File

@@ -32,5 +32,8 @@
- 表：`rag_store`、`rag_document`、`rag_document_parse_result`、`rag_chunk`、`rag_chunk_embedding`、`rag_store_model_config`
- 枚举：`rag/parse_status`、`rag/index_status`、`rag/chunk_strategy`
- 脚本：`script/sql/rag_store.sql`、`script/sql/rag_document.sql`、`script/sql/rag_document_parse_result.sql`、`script/sql/rag_chunk.sql`、`script/sql/rag_chunk_embedding.sql`
- 脚本：`script/sql/3.rag_store.sql`、`script/sql/4.rag_document.sql`、`script/sql/5.rag_document_parse_result.sql`、`script/sql/6.rag_chunk.sql`、`script/sql/7.rag_chunk_embedding.sql`
- 前端原型：`KnowledgeWorkspacePage.vue`、`IngestionPipelinePage.vue`

5
docs/需求分析/3.模型与路由模块需求.md
View File

@@ -35,5 +35,8 @@
- 表：`model_provider`、`model_config`、`model_route_rule`、`rag_store_model_config`、`model_call_log`
- 枚举：`model_provider/provider_type`、`protocol_type`、`model_type`、`task_type`、`route_strategy`、`call_status`、`health_status`
- 脚本：`docs/MODEL_PROVIDER_SCHEMA.sql`、`script/sql/model_provider.sql`
- 脚本：`docs/MODEL_PROVIDER_SCHEMA.sql`、`script/sql/9.model_provider.sql`
- 前端原型：`ModelWorkspacePage.vue`

4
docs/需求分析/4.Workflow编排模块需求.md
View File

@@ -23,5 +23,7 @@ Workflow 编排模块负责把知识检索、模型调用、MCP 工具、Skill
- 表：`studio_project`、`workflow_definition`、`workflow_version`、`workflow_run`、`workflow_run_step`
- 枚举：`studio/environment`、`studio/publish_status`、`workflow/status`、`workflow/run_status`、`workflow/node_type`
- 脚本：`script/sql/studio_project.sql`、`script/sql/workflow.sql`
- 脚本：`script/sql/11.studio_project.sql`、`script/sql/12.workflow.sql`
- 前端原型：`StudioDashboardPage.vue`、`WorkflowBuilderPage.vue`

5
docs/需求分析/5.Agent会话模块需求.md
View File

@@ -24,6 +24,9 @@ Agent 会话模块负责 Agent 定义、对话调试、会话持久化、消息
## 4. 关联资料
- 表：`agent_definition`、`agent_session`、`agent_message`、`agent_capability_binding`
- 脚本：`script/sql/agent_definition.sql`、`script/sql/agent_session.sql`、`script/sql/agent_capability_binding.sql`
- 脚本：`script/sql/8.agent_definition.sql`、`script/sql/13.agent_session.sql`、`script/sql/16.agent_capability_binding.sql`
- 前端原型：`AgentWorkspacePage.vue`
- 后端入口：`AgentDefinitionController`、`AgentDefinitionServiceImpl`

4
docs/需求分析/6.MCP能力接入模块需求.md
View File

@@ -16,5 +16,7 @@ MCP 能力接入模块负责导入外部 MCP Server，读取能力清单，并
- 表：`mcp_server`、`mcp_capability`
- 枚举：`mcp/import_type`、`mcp/capability_type`、`mcp/health_status`
- 脚本：`script/sql/mcp.sql`、`script/sql/studio_enum.sql`
- 脚本：`script/sql/14.mcp.sql`、`script/sql/18.studio_enum.sql`
- 前端原型：`McpImportPage.vue`

4
docs/需求分析/7.Skill编辑模块需求.md
View File

@@ -16,5 +16,7 @@ Skill 编辑模块负责维护可复用的提示词、代码片段、配置和
- 表：`skill_definition`、`skill_version`
- 枚举：`skill/skill_type`、`skill/status`、`studio/publish_status`
- 脚本：`script/sql/skill.sql`、`script/sql/studio_enum.sql`
- 脚本：`script/sql/15.skill.sql`、`script/sql/18.studio_enum.sql`
- 前端原型：`SkillWorkspacePage.vue`

5
docs/需求分析/8.运行观测模块需求.md
View File

@@ -15,5 +15,8 @@
## 3. 关联资料
- 表：`workflow_run`、`workflow_run_step`、`model_call_log`、`agent_session`、`agent_message`
- 脚本：`script/sql/workflow.sql`、`script/sql/model_provider.sql`、`script/sql/agent_session.sql`
- 脚本：`script/sql/12.workflow.sql`、`script/sql/9.model_provider.sql`、`script/sql/13.agent_session.sql`
- 前端原型：`ObservabilityPage.vue`