# 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 字段只保存运行必要摘要，不保存敏感密钥。