common_agent/docs/数据库设计/4.Workflow数据库设计.md

Workflow 数据库设计

1. 表结构

表	说明
studio_project	Studio 项目空间
workflow_definition	Workflow 主定义
workflow_version	Workflow 版本快照
workflow_run	Workflow 运行记录
workflow_run_step	Workflow 节点步骤日志

2. 关键约束

• studio_project.project_code 唯一。
• workflow_definition.workflow_code 唯一。
• workflow_version 使用 (workflow_id, version_no) 唯一。
• workflow_run.request_id 唯一。
• workflow_definition.bound_agent_id 可引用 agent_definition。

3. 脚本

• script/sql/studio_project.sql
• script/sql/workflow.sql
• docs/STUDIO_PROTOTYPE_SCHEMA.sql

4. JSON 字段

• workflow_version.graph_json 保存流程图快照。
• workflow_run.input_json 与 output_json 保存运行输入输出摘要。
• workflow_run_step.input_json 与 output_json 保存节点级输入输出摘要。

JSON 字段只保存运行必要摘要，不保存敏感密钥。