track-production-10 — 模块 10(10-production)构建汇报
模块 10 专属状态文件(协调者验收用)。track 整体状态仍在 track-production.md(由负责 M9–M12 的协调流维护);本文件是模块 10 的细粒度交付记录。
模块 10 — ✅ 完成
- 产出文件:
10-production/README.md — 主课:环境分层/配置/secrets、可观测性与可审计性(记什么/不记什么/trace 结构)、故障三件套+熔断+超时预算、成本/延迟/可靠性三角(prompt caching、Batches、模型分层路由,价格与倍率全部标注「截至 2026-08-30」)、模型升级策略(版本锁定/灰度/回归评估)、完整参考架构 Mermaid 图(Users → Gateway → Orchestrator[Claude/Retrieval/MCP/Tools/State] → Human escalation + 可观测/审计面)、bad vs better 架构对比(2 张 Mermaid)、tradeoffs 表、common mistakes ×10、英文术语 ×20、认证相关性
10-production/examples/01_resilient_call_orchestrator.py — 超时预算+指数退避+熔断+降级+人工升级的调用编排模拟器(无 key,模拟上游+模拟时钟)
10-production/examples/02_cost_latency_estimator.py — 成本/延迟/可靠性权衡估算器(无 key,内置截至 2026-08-30 官方价格与 1.25×/2×/0.1×/半价倍率,含规则化推荐决策链)
flashcards/flashcards-10.csv — 28 张(列头与既有分模块文件一致)
10-production/questions/exam-style.md — 12 题(单选 6+多选 2+判断 1+场景决策 3,场景题全部含 Scenario/Constraints/Options/Best choice/Why/Why others are weaker/Tradeoffs/What would change the answer 八段;答案与逐项解析在文末独立小节)
10-production/questions/architect-questions.md — 10 道架构师问答题(含答题要点)
10-production/labs/lab.md — 7 个 lab(Lab 0–6,每步标注是否需要 key;全部无需 key;复用两个示例脚本)
glossary/glossary-10-production.md — 新建独立文件;「## 模块 10 — 生产架构」23 条(五列表头齐全)
sources/sources-10-production.csv — 新建独立文件;PR01–PR12(列同 sources/sources.csv;全部 VERIFIED + accessed 2026-08-30)
- 来源核验(全部 web_fetch 实际抓取于 2026-08-30,均 200 OK):
- PR01 errors / PR02 rate-limits / PR03 prompt-caching / PR04 batch-processing / PR05 versioning / PR06 authentication / PR07 model-deprecations / PR08 models-overview / PR09 usage-cost-api(以上 platform.claude.com;docs.claude.com 旧路径已确认 301 重定向至 platform.claude.com)
- PR10 Agent SDK observability(code.claude.com)
- PR11 building-effective-agents(anthropic.com/engineering,注意:该页自带「部分内容已过时」横幅,正文中仅引用其不过时的核心论断)
- PR12 AWS Claude Platform monitoring(docs.aws.amazon.com,priority 2)
- 关键数字核验方式:缓存倍率 1.25×/2×/0.1× 取自 prompt-caching 页定价表原文;Batches 半价/100k/256MB/29 天取自 batch-processing 页;tier 月上限 $500/$1k/$200k、token bucket、cache-aware ITPM 取自 rate-limits 页;60 天退役通知与 Usage Export 审计取自 model-deprecations 页;四档模型价格取自 models/overview 页
- 未采用:搜索结果中的第三方博客/目录站(仅作发现线索);observability/overview 与 models/deprecations 等 404 路径未收录
- 示例实跑结果(本机 python3 3.12,退出码 0):
01_resilient_call_orchestrator.py:7 个场景 + 熔断器状态机断言全部通过(末行「全部断言通过」)。开发中修过 1 个 bug:熔断器冷却期比较的浮点边界(10_000ms 恰好等于 cooldown 时 >= 判定失败),以 1e-6 容差修复后通过
02_cost_latency_estimator.py:3 个 workload(客服交互式/夜间批量/高可靠合同)成本表 + 推荐决策链 + 缓存手工核算(命中 $0.0012 vs 写入 $0.0150 vs 全额 $0.0120,断言 hit<full<write 通过)全部输出正常
- README 两张对比 Mermaid 图 + 参考架构图(flowchart TB/LR 语法,需在渲染器里目检一次)
- 价格/倍率类「截至 2026-08-30」标注是否符合季度重验节奏(与 sources.csv 主表合并时保留 PR01–PR12 编号段)
- flashcards-10.csv 28 张并入 flashcards.csv 时的去重与列映射
- glossary-10-production.md 23 条并入 glossary-production.md / GLOSSARY.md(模块 10 小节独立可整段搬移)
- exam-style.md 3 道场景题格式是否作为 14-certification-prep 模拟题的素材底稿
- 遗留问题:
- 延迟系数(1.6×/1.3×/1.0×/0.6×)是启发式映射:官方 models/overview 仅给 slower/moderate/fast/fastest 定性排序,脚本与 README 均已显式注明「启发式假设」;若官方日后给出定量延迟数据应替换
- building-effective-agents 页自带过时横幅(指向 managed-agents 新文档):本模块仅引用其恒真的核心论断(workflows vs agents、三角权衡),未引用已过时的工具生态描述;Wave 3 质量检查时可评估是否需要为 managed-agents 补充来源
- 平台掩码坑自查已做:9 个文件全部回读,无意外星号/掩码残留;示例代码不读取任何密钥,无需环境变量即可运行
📚 目录