W01-L01 教材目录¶
本文档是"建立 typed 工程与模块边界"的阅读入口。P01-P07 全部章节已完成编写，
教材集合状态为 complete；这个状态只表示章节是否齐全，不表示课程已阅读、
已完成或已掌握。
课程概览¶
| 维度 | 内容 |
|---|---|
| 课程名称 | 建立 typed 工程与模块边界 |
| 预计时长 | 3 小时，共 180 分钟 |
| 实践目标 | 把 P1 的最小服务切分为可说明的 HTTP 适配、业务操作和数据契约边界，并用 type hints 与 Pydantic 表达公开输入输出 |
| 阅读主线 | 从一条不可信输入开始，逐步连接静态契约、运行时边界、业务类型、模块依赖、失败语义、Git artifact 与 README，最后审查它们是否形成一致的工程基线 |
| 明确不包含 | FastAPI 路由细节、数据库、认证、模型调用、完整部署说明、Docker 和自动质量门禁 |
章节¶
| 顺序 | Problem | 章节阅读目标 | 时间 | 状态 | 章节 |
|---|---|---|---|---|---|
| 1 | W01-L01-P01 |
区分静态类型契约、运行时数据边界和业务正确性 | 25 分钟 | 已编写 | 阅读 |
| 2 | W01-L01-P02 |
从调用方需要处理的业务状态推导公开类型 | 25 分钟 | 已编写 | 阅读 |
| 3 | W01-L01-P03 |
用职责、公开接口和依赖方向判断模块边界 | 30 分钟 | 已编写 | 阅读 |
| 4 | W01-L01-P04 |
把成功数据流、失败语义和边界转换放在正确位置 | 30 分钟 | 已编写 | 阅读 |
| 5 | W01-L01-P05 |
按交付目标、可重建性和跟踪状态判断 Git artifact | 20 分钟 | 已编写 | 阅读 |
| 6 | W01-L01-P06 |
让 README 成为与当前工程事实一致的导航入口 | 20 分钟 | 已编写 | 阅读 |
| 7 | W01-L01-P07 |
联合审查类型、模块、Git 与 README 是否形成最小可扩展基线 | 30 分钟 | 已编写 | 阅读 |
| 总计 | 180 分钟 |
阅读说明¶
- 章节按认知依赖排序；已编写章节可以独立阅读，后续章节会重新调用必要的前序 概念。
- 教材中的代码、文件和命令用于理解工程关系，不表示 P1 主作品已经实现。
- 每章的练习与完整解析用于自检，不形成评分、完成记录或掌握判定。
范围说明¶
P01-P07 全部章节已编写完成。每章按单个 Problem 独立生成并通过校验，索引状态
为 complete。该状态表示教材集合完整，不表示课程已经阅读、完成或掌握。