协作里程碑

checkpoint-collaborative-work 不考新语法，而考 能否与他人（或未来的你）协作：GitHub profile、仓库命名、README、截图、LICENSE、PR 习惯。它是把 fsm-crud、fsm-cli、fsm-frontend 等散落练习 整理成可展示作品集 的关卡，并与 github-actions-essentials 的 PR 检查文化衔接。

学习目标

• 对照 /roadmaps/full-stack checkpoint-collaborative-work，整理 GitHub 上 全部里程碑项目，每仓具备 README、截图、LICENSE
• 遵循仓库命名与文档规范，使他人 git clone 后 10 分钟内可跑通主流程
• 说清协作流：branch → PR → review → merge，与 fullstack-roadmap Git 节点一致

路线图推荐规范

项	建议
仓库名	小写 + 连字符，如 todo-cli、weather-dashboard
README	项目是什么、如何安装、如何运行、示例命令/截图
LICENSE	choosealicense.com 选 MIT/Apache-2.0 等
截图	终端或浏览器真实界面，非占位图
Profile	置顶 2–3 个代表项目，bio 一句话定位

README 模板

# 项目名称

一句话描述。对应 CodeRoadMap 里程碑：fsm-xxx / checkpoint-xxx。

## 功能

- 功能点 1
- 功能点 2

## 本地运行

### 依赖

- Node 20 / Java 21 / PostgreSQL 16 …

### 步骤

1. clone
2. install
3. run

## 截图

![demo](docs/demo.png)

## 许可证

MIT

与 CI 的协作

为至少一个仓库添加 github-actions-essentials 工作流：PR 上跑 npm test 或 mvn test。绿勾成为 协作信号——reviewer 敢 merge。Secrets 不进日志；fork PR 不泄露密钥。

跨里程碑仓库策略

• 一里程碑一仓库（清晰，适合 portfolio）
• monorepo（apps/cli、apps/web、infra/ansible）——需在 README 说明子目录命令

无论哪种，在 README 底部链接 /roadmaps/full-stack 已勾选节点，方便招聘方对照能力。

与后端/前端专项的展示

• spring-boot-essentials 练习可合并为 api/ 模块
• react-essentials 练习作为 web/ 子包
• docker-essentials 提供 docker compose up 一键体验——协作友好的「第一印象」

练习

• 将至少 3 个 里程碑项目 push 到 GitHub，README 与 LICENSE 齐全
• 每个 README 含 一张截图 与 复制即用的运行命令
• 在 /roadmaps/full-stack 勾选 checkpoint-collaborative-work，Profile 置顶代表仓

小结

协作里程碑 = 会写代码，也会写给人看的仓库。 它是求职与开源参与的通行证。下一课 基础设施里程碑 用 Terraform 把 AWS 控制台手工建资源代码化。