第十一章读者视角自审

日期：2026-10-20。状态：0.1.25 更新并复审后，用户确认进入下一章。正文：按时间分析。下文保留本章自审范围。

主线与措辞

• 接上一章的聚合指标，顺序为创建时间模型、月度汇总、月度环比，再简短扩展同比。三个业务提示词加一个建模提示词，创建与查询分开。
• 原账单模型没有年月字段，明确先新增时间分析 TM/QM；使用同一份 Invoice 数据，不要求读者凭空猜出 $yearMonth。后续查询模型名称单独写明。
• 明确 yearMonth 是本章新增属性，注明 TM 文件及 dimensions → invoiceDate → properties 位置；代码保留模型与日期维度外层，其他配置标为省略，与真实 TM 对照一致，不重复整份源码。
• 解释 Foggy 可使用主表日期自维度，无须独立日期维表。大数据量、频繁分析时建议考虑预存年月的日期维表，性能收益仍看数据库、索引和关联计划，不声称本例已做大数据量对比。参考 Microsoft 日期维表设计及 SQLite 表达式索引说明。
• 用字段表说明日期键、年份、月序号和年月，避免把日期维度 $id 误认为账单 ID。年月必须保留年份，日期范围与分组粒度各讲一次。
• 月度汇总讲日期筛选与分组；一个完整 timeWindow 示例讲当前期范围与上期读取。同比通过修改 comparison 扩展，不再贴相似请求。比例与百分数、展示舍入在结果处说明。
• LAG 放补充段，展示在第二步请求中增加的配置，使用已有 totalAmount 别名。重点说明上一结果行和上一自然月的区别，不展开窗口函数清单。
• 旧版失败和工具外算路径留在 lab，正文以 0.1.25 已验证能力为准。Decimal 只承担独立核对；Markdown 从已加载代码实时生成，不要求预先维护。
• 缺上期与空期间集中在验收段，不补零。缺月只是语义说明，不冒充已经构造样例验证。
• 章末四个知识点对应实际内容；下章转向维度成员与多级关联，未提前展开。

验证与边界

教学服务 18067 已切换为 Launcher 0.1.25，CLI 仍是 0.1.24。按发行包 README 与原启动脚本操作，PID/JAR/监听核对一致。原绑定、六个模型与数据库未变，不重复卸载或校验已验证且未修改的模型目录。

本轮 11 项检查：10 项执行结果与原件只读行及 Decimal 独立计算一致，1 项嵌套聚合在校验阶段明确拒绝。月度、环比、跨年、同比、缺上期、空期间、LAG 及后续计算均有记录；原账单固定均额和明细汇总也通过升级回归。数据、模型与注册文件哈希未变。

正文 DSL 与实际 payload 对照、链接、措辞和前后衔接已检查。未另开干净 Codex 会话只发短提示词；没有执行用户暂缓的 Text-to-SQL 正确性对比。其他数据库、人工缺月/零上期样例、完整旧题库、生产权限或 Console/FAP 未在本轮验证。

当前交付为第十一章更新稿，待用户审阅后再进入第十二章。见本轮实操记录；旧记录仍保留原验收范围。

新增说明后的整体复审

• 日期自维度与独立维表的取舍合并到代码前。随后连续讲文件位置、外层结构、实时元数据，避免性能说明插在“定义 → 加载”之间打断阅读。
• 明确年月是语义层派生属性，Invoice 表保持原样。外层源码与文件位置保留，省略项标清，不让读者把片段当完整 TM。
• 同比紧接十月、十一月环比，跨年例子放在其后，避免切换期间后再说“这两个月”造成误读；同比提示词明确年份和月份。
• 合并重复的实时元数据说明，压缩方言、聚合、比例和 LAG 表述。保留自然月与上一行、缺上期与零值、校验与执行的必要区别。
• 四条短提示词不增加操作清单；创建与查询仍分开。正文 JSON 与已执行 payload 对照一致，链接和源码位置已复核。

本次仅修改正文与自审记录，未修改模型、数据、查询或服务；沿用现有实测证据，不重复运行查询。

2026-10-21 基础与高级时间分析拆分

当前第十一章改为《按日期与月份汇总数据》，只保留日期自维度、年月属性、日期范围与月度汇总。同比、环比与 LAG 迁为高级备课素材，累计、滚动也在高级篇统一讲。以上旧记录保留当时验证范围，不意味着当前正文仍有全部窗口用例。

本轮只调整文案与编排，模型、数据、payload、日志和原实操记录未改动；未重复执行查询。整体衔接与引用检查见本轮复审。