端到端流程详图¶

一张大图把 "需求→故事→实现→测试→上线→运维" 拉直。每一步都标注谁干 + 用什么工具。

全景流程¶

┌───────────────────────────────────────────────────────────────────────┐
│  STAGE 1：需求收敛与故事生产 （PM 主导）                                       │
└───────────────────────────────────────────────────────────────────────┘

   零散原料 ┬─ Notion (调研 / 访谈)
            ├─ 钉钉 (会议纪要 / 群讨论)
            ├─ 微信 (客户聊天)
            └─ Figma (探索性原型)
                       │
                       │ [PM] 走 plugin: czerp-pm/
                       │   - notion-research-distill
                       │   - dingtalk-meeting-distill
                       │   - wechat-distill
                       │   - user-story-author
                       │   - figma-to-axure
                       │   - pingcode-sync
                       ▼
   PingCode CZKB 用户故事页 (按模板)
   PingCode CZPRD 需求池
   Axure Cloud 原型 (+ LLM Wiki 同步)


┌───────────────────────────────────────────────────────────────────────┐
│  STAGE 2：计划会 (Scrum)                                                  │
└───────────────────────────────────────────────────────────────────────┘

   PingCode CZPRJ Sprint Backlog
                       │
                       │ [PM + Dev + QA + Tech Lead] 计划会
                       │   - 拆任务 / 估点 / 分配
                       │   - PingCode CZPRJ 创建 issue 关联故事
                       │   - QA 当场起测试计划 (czerp-qa/testplan-author)
                       ▼
   开发任务 (CZPRJ-X)
   测试计划 (CZTST/<sprint>/plan.md)


┌───────────────────────────────────────────────────────────────────────┐
│  STAGE 3：开发实现 （后端 / 前端）                                            │
└───────────────────────────────────────────────────────────────────────┘

   [Dev] 在本地 Claude Code (或 Codex):
   /user-story-impl CZPRJ-X         ← 拉故事 + 定位仓库
   /openspec-new <change-name>      ← 起 change proposal
   /brainstorming                   ← Superpowers, 方案推敲（如需）
   /test-driven-development         ← Superpowers, 写测试 + 实现

   实现过程中按需触发:
     czerp-backend/* skills          ← IFinmate 框架范式
     czerp-frontend/* skills         ← Avue / Element / metadata
     czerp-context/* skills          ← 仓库地图 / 字段术语

   /pre-pr-review                    ← czerp 特有检查
   /code-review                      ← 通用代码质量（环境内置命令）
   /pr-describe                      ← 按模板生成 PR 描述

   git push → 创建 PR


┌───────────────────────────────────────────────────────────────────────┐
│  STAGE 4：PR Review + 合并 （Gitee）                                          │
└───────────────────────────────────────────────────────────────────────┘

   Gitee PR
       │ [自动化] Gitee Go 流水线
       │   - 当前仅一个 Maven 编译 stage（mvn package -Dmaven.test.skip=true，跳单测）
       │   - 失败飞书/钉钉通知；无 lint / sonar / 评审门禁
       │ [AI 评审] Qodo PR-Agent — 自建 GitLab 对 czerp-demo 试点中，
       │   尚未覆盖 Gitee 主仓（推广目标）；主仓暂靠本地 /review 自检
       │ [开发组长] 人工复核 + approve（主仓当前的实际合并把关）
       ▼
   合并到 develop / release/test


┌───────────────────────────────────────────────────────────────────────┐
│  STAGE 5：CI 构建 + 部署 （Jenkins + ArgoCD）                                │
└───────────────────────────────────────────────────────────────────────┘

   Jenkins (czerp-api 等仓库的 Jenkinsfile)
       │
       │ mvn build → docker build → push 镜像
       │ → 直接 commit + push czerp-gitops(main)，改 overlays/<env>/patch-deployment.yaml 镜像 tag
       │   (分支映射: develop→dev / release/test→test / release/uat→uat；无 PR 人审门)
       ▼
   ArgoCD AutoSync (selfHeal, targetRevision: main) 立即自动同步
       │
       ▼
   k8s 更新 Pod（业务多为 Recreate、短暂不可用；gateway 走 RollingUpdate）→ 服务上线（dev / test / uat；当前无独立 prod）


┌───────────────────────────────────────────────────────────────────────┐
│  STAGE 6：测试验收 （QA + AI 回归）                                            │
└───────────────────────────────────────────────────────────────────────┘

   [QA] 起用例 (czerp-qa/testcase-author) → 上传 CZTST
   功能测试（dev 环境；test/uat 回归在批量提测/发版后，见 03_release）
       │
       ▼
   AI 驱动回归 (czerp-qa/ai-driven-regression)
   定时 / PR 合并触发 nightly
       │ 失败
       ▼
   缺陷自动提交 (czerp-qa/defect-submission) → PingCode CZTST 缺陷库 → 关联开发


┌───────────────────────────────────────────────────────────────────────┐
│  STAGE 7：监控与故障响应 （运维）                                                 │
└───────────────────────────────────────────────────────────────────────┘

   Prometheus + Sentinel Dashboard + 日志中心 + Skywalking (如有)
       │
       │ 告警 → 钉钉 oncall
       ▼
   [Ops] 走 czerp-ops/* skills:
     - environment-info
     - k8s-troubleshooting
     - gitops-deploy (回滚 / 紧急部署)
     - monitoring-and-alerts

   严重故障 → 复盘 → PingCode CZKB 事故复盘页


┌───────────────────────────────────────────────────────────────────────┐
│  STAGE 8：闭环 (Sprint Retro + Spec Archive)                                │
└───────────────────────────────────────────────────────────────────────┘

   [Tech Lead] openspec archive <name>   ← 把已完成 change 落成正式 spec
   [全员] Sprint Retrospective + 调整流程
   [PM] 已上线功能 → CZPRD 状态置"已上线"

关键交接点（容易掉链子的地方）¶

交接	风险	缓解
PM → 开发：故事是否完整？	验收标准模糊 / 原型链接缺失	计划会上 QA 与 Dev 强制核对自检清单
开发 → QA：实现是否在 dev 环境跑通？	开发说"好了"实际没跑	必须附 dev 环境验证证据（截图 / 日志）
QA → 运维：是否需要特殊上线步骤？	配置 / 数据 / 中间件没说	PR 描述模板的"部署清单"必填
运维 → PM：是否影响线上业务？	部署完不通知	当前运维手动广播给 PM；计划接 argocd-notifications 按服务订阅推钉钉
失败 → 修复：缺陷分配是否准？	缺陷指给错人	PingCode 模块 → 负责人映射表（运维维护）

节奏推荐¶

频率	事件
每日	站会（15min） — 阻塞点 / 协作需求
每 PR	自动化 review + 人工 approve
每晚	AI 驱动回归（全量）
每周	Sprint Review + Retrospective
每两周	Sprint 切换
每月	AI 协作指标复盘 + skill 库治理
每季	流程 / 工具栈大版本评估

AI 工具决策树（"我现在该用哪个？"）¶

我要…
├── 起新需求 / 改文档                        → czerp-pm/* + Notion MCP
├── 拿到一个故事编号准备实现                       → /user-story-impl + czerp-workflow
├── 新功能技术方案没定                          → /brainstorming (Superpowers)
├── 方案定了写实现                            → /test-driven-development (Superpowers) + czerp-backend / czerp-frontend
├── 不知道这个能力框架有没有                       → czerp-backend / czerp-frontend 对应 skill
├── 写完准备提 PR                            → /pre-pr-review + /code-review + /pr-describe
├── 跑测试 / 起用例                          → czerp-qa/*
├── 部署 / 故障排查                          → czerp-ops/*
└── 完全摸不着头脑                            → docs/02_roles/<我的角色>/README.md