60 lines
5.4 KiB
Markdown
60 lines
5.4 KiB
Markdown
# 名单模板尾行兼容修复
|
||
|
||
- Task ID: `20260911-roster-template-tail-01a0858b`
|
||
- Mode: Feature
|
||
- Status: Complete (local implementation and validation)
|
||
- Authorization: 用户明确要求保留原始表格，通过修改程序兼容没有旅客资料的表尾模板行。
|
||
|
||
## Concurrent Worktree Check
|
||
|
||
- Branch: `main`
|
||
- Worktree: `/Users/andy/IdeaProjects/LWLT-AIBOT`
|
||
- Base commit: `07b23fce9e96badbd266bbda682fd16cd6733e22`
|
||
- Existing changes: 未跟踪 `.idea/` 和上一任务生成的 `dist/ltjt-order-assistant-0.5.173.zip`，均保留且不涉及；已有忽略的 Finder 文件也保留。
|
||
- Other local worktrees: 无。
|
||
- Overlap result: Clear；服务端名单 normalizer 及测试无既有改动。
|
||
|
||
## Scope and constraints
|
||
|
||
- 服务端只在读取时识别表尾的无旅客资料模板行，原始 XLS 不修改、不复制进仓库。
|
||
- 有实际旅客信息、位于名单中间或无法确定用途的行继续严格校验；保留全局不安全公式/外链/宏及隐藏数据检查。
|
||
- 本次不修改插件、多关键词搜索、数据库或 canonical 项目记忆；不部署、重启、访问或写入 ERP、发送外部通知。
|
||
- 使用合成测试夹具；本地原始 XLS 复验只输出结构、计数及哈希，不输出旅客信息。
|
||
- 遵守仓库不经用户同意不使用子 Agent 的约束，本任务自行实现与复核。
|
||
|
||
## Findings
|
||
|
||
- 原文件与生产日志的大小/哈希一致。表头在第 2 行，第 3–30 行共 28 条已填写名单。
|
||
- 第 31、32 行没有姓名和护照数据，但保留序号 29/30 及性别、出生日期、有效期公式；D31/E31/D32/E32 含失效 `#REF!` 引用。
|
||
- 当前 normalizer 在识别实际数据范围前校验整张工作表必需列的公式，因此在 D31 返回 `roster_workbook_formula_not_allowed`。
|
||
- 第 33–34 行是跨越全部名单列的合并备注区；只处理空公式行仍会把该备注当成名单，因此纳入有明确标签的表尾说明识别。
|
||
|
||
## Implementation
|
||
|
||
- Normalizer 更新为 `ltjt-passenger-roster-workbook-v1.5.0`；接口、数据库及 canonical TSV 格式保持原样。
|
||
- 从表尾倒序确定数据结束行，仅裁掉连续尾部空行、正整数序号占位行、没有任何实填旅客字段且仅含已知模板公式的行，以及覆盖全部导入列、带明确备注/说明标签且没有独立附加单元格内容的合并说明行。
|
||
- 对失效身份证派生的性别/出生日期公式仅识别原模板的确切公式形式；已有同一行 `EDATE` 日期派生公式仍可作为空模板标识。任意其他公式或任一实填字段都会保留该行为数据并严格校验。
|
||
- 识别只发生于连续尾部，不能越过有旅客信息或未知内容的行。名单中间仅有序号的占位行现在明确报 `roster_workbook_incomplete_row`；中间空行、公式错误和无效序号继续阻断。
|
||
- 全工作簿的宏、外链、危险公式、超链接、隐藏行/列检查仍保留，尾部识别不会绕开这些检查。
|
||
|
||
## Verification
|
||
|
||
- 回归先行：新增 8 项测试在旧实现上有 6 项失败，重现实际模板尾部问题；修复后新增和已有名单测试合计 20/20 PASS。
|
||
- 定向验证覆盖原始布局、列重排、序号占位、跨行合并备注、全空模板、实填部分数据、名单中间占位/空行/备注、未知公式和跨工作簿安全检查。
|
||
- 原始 XLS 只读链路 PASS：生产转换器 → normalizer → Program Parser → 插件派发校验；表头第 2 行，28 条完整 13 列记录，序号 1–28 原样保留，原文件哈希不变。未访问 ERP。
|
||
- `node --run check`：PASS；`node --run build`：PASS；`node --run test:control-plane`：202/202 PASS。
|
||
- `node --run check:repo`：原工作目录 8/10，通过项包含发布文件与哈希；两项失败仅为既有 `.idea/`/Finder 文件，已保留。在 `/private/tmp/ltjt-roster-tail-verify-f4emlqgc` 的当前源码与发布物副本中，排除上述杂项及秘密后 10/10 PASS。
|
||
- `node --run test:legacy`：累计 290/290 PASS。首次 288 项通过，另两项因沙箱禁止本地 127.0.0.1 监听而失败；单独申请权限时自动审批超时，按工具允许重试一次后获准，两项 HTTP 边界测试均通过。
|
||
- `git diff --check`：PASS。源码改动只涉及一个服务端 normalizer；新增测试和本任务记录，不改动现有插件与交付物。
|
||
- 最终自行复核完成：本任务仅涉及上述源码、新增测试及任务记录三个文件，既有改动均保留；未执行部署、外部发送或 ERP 操作。
|
||
|
||
## Outcome and follow-ups
|
||
|
||
- 原表无需编辑；服务端镜像重建并部署后，可在当前等待附件的任务中重新上传同一文件。现有接收逻辑会重新校验之前 rejected 的同一 SHA-256 附件，无需更换文件名或新建任务。
|
||
- 本次不需要更新插件或数据库。部署后的附件校验日志应显示 normalizer `v1.5.0` 和 `row_count: 28`。
|
||
- 生产部署及实际 ERP 验收由用户后续执行，本任务不自动重试业务任务或写入 ERP。
|
||
|
||
## Promotion Candidates
|
||
|
||
- Target: canonical current state / 名单输入契约。集成时登记 normalizer `v1.5.0` 对连续表尾空模板与明确合并备注的有限兼容，以及中间占位行错误码。证据为本任务合成回归和用户原始文件只读全链路验证。不等同于放开任意公式、跳过不完整旅客或声明 ERP 写入成功；本任务不写共享索引或集成快照。
|