毕业项目：团队规范与 SRX 工作流

第 12 章 · 毕业项目：团队规范与 SRX 工作流

本章目标：独立完成 shop-demo 商城组 毕业演练——从 打开项目 到 PR 合并、可选发版 全流程；能说清 菜单 / SRX / GitHub 网页 各在哪一步；交付可验收的 PR 链接与说明；复盘常见踩坑与对应章节。

学时建议：4～5 小时（含 3 小时跟练）

前置：git-collab ch01～ch11；srx-v7 ch09、quick-start ch07 建议已读。

12.1 毕业场景（虚构团队，真实流程）

shop-demo 商城组 约定：

你要证明：不只会单章操作，而是能 像团队成员一样交付一次完整功能。

12.2 标准清单（打印贴屏，逐项打勾）

□ 1. 项目 → 打开项目（shop-demo 仓库根，ch02 色标正常）
□ 2. 切 main → 从 GitHub 拉取（ch06/ch08）
□ 3. 创建 feature/product-filter（ch04）
□ 4. 终端 git status → clean（ch03/srx-v7）
□ 5. SRX：描述需求 + @ 相关文件（如 README 或列表相关文件）
□ 6. 审阅条：逐条确认 → 落盘（quick-start ch07）
□ 7. 自测：按你写的步骤能验证「筛选」或文档 checklist
□ 8. 暂存 → 提交：feat: 商品列表分类筛选（小步可多次 commit）
□ 9. 推送到 GitHub（ch07/ch08）
□ 10. GitHub 开 PR → main，写清变更与测试步骤（ch09）
□ 11. Review：自审或请同伴 Comment → Approve
□ 12. Merge pull request
□ 13. 本地切 main → pull（ch09）
□ 14. 选修：tag v1.0.0-graduate + Release（ch10）
□ 15. 选修：Actions 绿勾截图（ch11）

预计时间：熟练 2～3 小时；首次 4～5 小时正常。

12.3 分步跟练（带「你应该看到什么」）

步骤 1～2：打开与同步

项目 → 打开项目 → 选含 .git 的 shop-demo 根。

cd ~/dev-workspace/shop-demo
git checkout main
git pull origin main
git status

你应该看到：working tree clean；左侧文件树有 Git 色标。

步骤 3～4：分支与干净工作区

仓库 → 分支 → 创建分支 → feature/product-filter

若有未提交 M：先 暂存提交 或 stash（ch06），再建分支。

步骤 5～7：SRX 与自测

示例需求（可简化）：

在 README 增加「商品筛选」章节：说明按分类过滤的 API 或前端行为；列出验收 checklist。

SRX 对话中 @README.md（或团队指定文件）。

审阅条：每条改动你确认过再接受——这是毕业硬性要求。

自测：打开 README，checklist 每一项你能口头说明怎么验（真实代码项目则跑 go test 或手动点页面）。

步骤 8～9：提交与推送

暂存 → 提交 → 说明示例：

• feat: 商品列表分类筛选说明与 checklist
• 若分两次：docs: 补充筛选 API 说明

推送到 GitHub → 确认推的是 feature/product-filter。

你应该看到：GitHub Branches 出现该分支与 commits。

步骤 10～12：PR 与合并

GitHub → Compare & pull request

PR 说明模板（复制改）：

## 变更摘要
- 商品列表支持按分类筛选（文档/代码说明）

## 测试步骤
1. git checkout feature/product-filter
2. （若代码）启动 API，GET /products?category=mug
3. 确认返回仅该分类；或 README checklist 逐项打勾

## SRX 使用说明
- 分支：feature/product-filter
- @ 文件：README.md
- 审阅条：已全部确认

## 截图
（可选）

Merge 后 Delete branch（可选）。

步骤 13～15：同步与选修发版