# 开发产线 (SDLC Pipeline) 架构概览

## 客户可以输入什么

开发产线的入口是「项目管理」，客户分多阶段输入：

### 项目创建阶段
- 项目名称、描述、项目类型 (web_app / mobile / api_service)
- 技术栈配置 (JSON: 框架、语言、数据库等)
- 代码仓库 URL
- 关联的 Pipeline 定义 ID（选哪个产线模板）

### 迭代创建阶段
- 迭代名称、迭代类型 (new_feature / bugfix / refactor / upgrade)
- 迭代范围 (JSON: 功能点、用户故事)
- 优先级 (1-10)
- 创建迭代时**自动触发 Pipeline 任务**（project.py：auto-submit）

### 各阶段人工交互输入
| 阶段 | 步骤 | 输入内容 |
|------|------|----------|
| 需求 | requirement_gathering | 需求文档表单 |
| 需求 | requirement_review | 审批 (approve/reject) |
| 设计 | table_design | 确认 LLM 生成的表结构 |
| 设计 | crud_design | 确认 LLM 生成的 CRUD 定义 |
| 设计 | api_design | 确认 LLM 生成的 API 规范 |
| 设计 | design_review | 架构负责人审批 |
| 开发 | code_review | 高级开发审批代码 |
| 开发 | code_fix | 提交修复说明 |
| 测试 | test_plan_create | 编写测试方案 |
| 测试 | bug_fix | 修复说明 + commit SHA |
| 测试 | acceptance_test | 产品经理验收 |
| 部署 | deploy_env_collect | SSH 信息 + 数据库连接 |
| 部署 | deploy_test_approve | 发布经理确认 |
| 运维 | incident_response | 故障处理方案 |
| 升级 | upgrade_plan | 新版本规划 |

### 统一输入形式（驾驶舱模式）
- **正文输入**：多行文本框，支持自然语言
- **文件附件**：上传需求文档、设计稿、代码文件等
- 类似与大模型对话的交互体验

## 客户应该看到什么

### 仪表盘驾驶舱
- 项目总数 / 活跃数
- 活跃迭代数
- 待处理 Bug（按严重程度分布：critical/major/minor/trivial）
- 待审批数
- 最近 5 个迭代及进度条

### 时间线面板
- 产线步骤的线性时间线
- 实时状态更新（completed/running/pending/waiting/failed）
- 点击步骤展开详情（产物、日志、审批表单）
- 按阶段分组（需求/设计/开发/测试/部署/运维）

### 对话面板
- Agent ↔ 用户对话历史
- Agent 自动推送：分析结果、设计产出预览、测试结果
- 用户在输入框中回复、审批、补充信息
- 系统事件通知（步骤开始/完成）

### 步骤详情弹窗
- 步骤描述和配置
- 输入/输出 artifact（JSON 树形查看）
- 执行日志
- human_task：表单 + 提交按钮
- approval_gate：approve / reject 按钮
- failed：错误详情 + 重试

### 项目管理页面
- 项目列表：状态、类型、关联产线
- 迭代列表：状态流转 (planning → in_progress → testing → completed)
- Bug 管理：严重程度、状态、关联迭代、提交人类型

### 测试/部署页面
- 测试用例列表、结果统计
- 测试计划、部署环境配置

## 产线信息交互

当前开发产线定义了 **7 个阶段、28 个步骤类型**：

| 阶段 | 步骤数 | 自动 | 人工 | 审批 |
|------|--------|------|------|------|
| Phase 1: 需求 | 2 | 0 | 1 | 1 |
| Phase 2: 设计 | 4 | 3 | 1 | 1 |
| Phase 3: 开发 | 5 | 3 | 1 | 1 |
| Phase 4: 测试 | 8 | 4 | 3 | 0 |
| Phase 5: 部署 | 6 | 3 | 1 | 1 |
| Phase 6: 运维 | 2 | 1 | 1 | 0 |
| Phase 7: 升级 | 1 | 0 | 1 | 0 |

### DAG 依赖图
```
requirement_gathering → requirement_review
    → table_design ──┬──→ design_review
    → crud_design  ──┤
    → api_design    ──┘
design_review → code_generate → code_compliance_check
    → code_auto_fix → code_review
code_review → test_plan_create → test_case_generate
    → functional_test ──┬──→ bug_report
    → performance_test──┘
bug_report → bug_fix → bug_verify → acceptance_test
acceptance_test → deploy_env_collect → deploy_test
    → deploy_test_verify → deploy_test_approve
deploy_test_approve → deploy_production
    → deploy_production_verify → monitor
monitor → incident_response (if alerts)
```

### 步骤间信息传递
信息通过 artifact 传递 — handler 的 output_data 存入 `pipeline_artifacts` 表，
下游通过 `input_data[dep_step_name]` 获取上游产物。

### 对话层信息流
- 用户在驾驶舱输入框发送消息 → 存储到 sd_conversations → DSPY 处理
- Agent 分析后可能在对话中回复，同时触发产线步骤流转
- 关键步骤完成时 Agent 推送结果到对话面板

## 开发规范遵循

### 模块架构
- 产线专属 UI（pipeline-sdlc）与引擎层（pipeline_task）严格分离
- 跨模块调用：`entire_url('/pipeline_task/api/task_list.dspy')` 绝对路径
- pipeline_task 零数据表，纯薄交互层

### UI 规范
- index.ui 统一三层布局：Title (cheight:6) → 卡片区 (cheight:18) → VScrollPanel (css:filler)
- 白底卡片 + SVG 图标（严禁暗色主题、emoji、backgroundColor）
- Tabular popup → Tree 步骤树弹窗
- toolbar 按钮 script 中用 `this` 取选中行

### DSPY 规范
- 零 import（预加载：json、DBPools、get_user、params_kw、getID）
- `return` 代替 `print`
- `getID()` 代替 `uuid()`
- `await get_user()` 不是 `get_user()`
- 禁 `ServerEnv()`，用 `request._run_ns`
- `sor.U()` 只要 2 个参数 (table, data_dict)
- `await sor.sqlExe(sql, {})` 第二参数必须是 dict

### models/*.json 规范
- summary[0].primary 必须是数组
- float/double 字段必须有 len + dec
- indexes idxfields 必须是数组
- codes 引用 appcodes_kv 必须用 parentid= 不是 id=

### CRUD json/*.json 规范
- 根键必须是 `tblname` + `params`
- editable 必须有 new/update/delete_data_url
- 使用 `{{entire_url('../api/xxx.dspy')}}` 格式

### 部署规范（铁律）
- 本地改 → git commit → git push → 服务器 git pull → pip install(如需) → 重启
- 禁直接在服务器改源文件
- curl 200 ≠ 功能正常，必须浏览器验证