W01-L02 教材目录

本文档是"实现最小 FastAPI 契约"的阅读入口。全部 6/6 章节已编写完成，教材集合 状态为 complete；这个状态只表示章节集合是否完整，不表示课程已阅读、已完成 或已掌握。

课程概览

维度	内容
课程名称	实现最小 FastAPI 契约
预计时长	3 小时，共 180 分钟
实践目标	将 W01-L01 的 typed core 暴露为一个最小 HTTP 操作，使有效输入、无效输入、可预期业务失败和服务生命周期均有明确公开语义
阅读主线	从内部类型直接暴露的后果开始，逐步建立 HTTP 公开契约设计、输入校验边界、错误映射、服务生命周期和 OpenAPI 可发现性，最后综合核对它们是否形成语义一致的最小 HTTP 服务
明确不包含	多用户业务 API、数据库依赖、认证、流式 HTTP、WebSocket、模型调用和公网部署

章节

顺序	Problem	章节阅读目标	时间	状态	章节
1	W01-L02-P01	区分内部函数签名和 HTTP 公开契约的设计目标和组成	25 分钟	已编写	阅读
2	W01-L02-P02	说明 Pydantic 模型策略如何决定接受、转换和拒绝	30 分钟	已编写	阅读
3	W01-L02-P03	区分三类失败并将其映射为不同的 HTTP 状态和结构	30 分钟	已编写	阅读
4	W01-L02-P04	说明 lifespan 为何使启动和关闭显式可见	20 分钟	已编写	阅读
5	W01-L02-P05	用 OpenAPI 定位成功和已知错误契约并发现偏差	25 分钟	已编写	阅读
6	W01-L02-P06	从一个请求-响应数据流同时核对契约、输入、错误、lifespan 和 OpenAPI	50 分钟	已编写	阅读
		总计	180 分钟

阅读说明

• 章节按认知依赖排序；已编写章节可以独立阅读，后续章节会重新调用必要的前序 概念。
• 教材中的代码和材料用于理解工程关系，不表示主作品已经实现。
• 每章的练习与完整解析用于自检，不形成评分、完成记录或掌握判定。

范围说明

全部 6 章节已编写完成。索引状态为 complete。该状态表示教材集合已完整， 不表示课程已经阅读、完成或掌握。