Python · 面向对象与工程化阶段 25 项必做
命令行待办事项工具（含测试，覆盖率 > 70%）
能写可维护的多文件项目
难度
建议投入 24–42 小时· 5 条需求验收权重
项目有清晰目录结构；单测全部通过；能用 Git 管理版本40%
核心功能可独立跑通，无阻断性 bug25%
关键路径有测试或可复现的验收脚本15%
README 写清运行方式、架构与踩坑10%
能在 5 分钟内讲清设计与取舍10%
总分 100。低于 60 分说明这个阶段还没过，回去补知识点，不丢人。
项目背景
这是「Python」路径第 2 阶段（阶段二 · 面向对象与工程化）的验收项目。本阶段目标是：能写可维护的多文件项目。项目不是练习题的堆砌，而是把这一阶段的知识点压缩成一个能演示、能讲清楚取舍的成品。
MVP 目标
- 能写可维护的多文件项目
- 做出可运行、可演示的「命令行待办事项工具」
- 把 类/继承/魔法方法、装饰器与生成器、类型注解 + mypy 真正用进项目，而不是停在笔记里
功能需求清单
5 项必做 · 0 项建议- 1任务 CRUD必做
新增、编辑、完成、删除；支持优先级与截止日期。
- 2持久化必做
数据存 JSON 或 SQLite，重启不丢。
- 3测试覆盖必做
pytest 覆盖率 > 70%，覆盖增删改查与异常分支。
- 4类型与静态检查必做
全量类型注解，mypy 通过。
- 5可安装必做
pyproject.toml 打包，pip install -e . 后可用命令运行。
技术约束
类/继承/魔法方法装饰器与生成器类型注解 + mypypytest 单元测试Git 基础
交付物
- Git 仓库（含分阶段提交记录，不是最后一次性上传）
- README：项目简介、架构/流程图、运行方式、已知限制
- 演示材料：截图，或 1–2 分钟录屏
- 复盘：做错的 3 个决定与改进方案
加分项
- 优先级排序与筛选
- 同步到云端
- GitHub Actions CI
最容易翻车的地方
- 没有测试
- 用全局变量存状态
- 异常被 except: pass 吞掉
做完之后，简历怎么写
「命令行待办事项工具」：独立完成 含测试，覆盖率 > 70%，使用 类/继承/魔法方法、装饰器与生成器、类型注解 + mypy；通过「项目有清晰目录结构」验收。
写「做了什么 + 用了什么 + 结果如何」，不要写「参与了 XX 系统」。