This commit is contained in:
hectorzhao
@@ -4750,3 +4750,17 @@ git diff --check
|
||||
- 验收脚本问题与边界：独立Vite开发服务器曾出现本机连接超时，改用同一验收进程创建/关闭生产预览后通过；一次脚本假定Escape关闭Select导致等待超时，按当前触发按钮关闭方式修正后全流程通过，未扩改Select。错误/乱序以隔离测试验证；未报备真实非空、热力图超过100个维度、全部旧分页消费者的逐页人工验收未覆盖。真实API数据来自现有服务及PostgreSQL查询；本轮不修改数据库，未另取得测试受限数据库配置作直接SQL对账。
|
||||
- 证据位于%TEMP%/cmpp-pagination-20260908：before-quality/report截图、acceptance.json、filter-acceptance.json、三视口截图、frontend-tests.log、build.log、format.log、lint.log和开工diff快照。截图/脚本/凭据不进入提交。临时预览已关闭。
|
||||
- 交付边界：本地代码、需求、设计和用例完成；本节随本轮精确文件/追加hunk作本地提交，提交号见Git记录。不推送、不测试部署、不预生产部署；不发送/补发/重投/入队短信，不变更余额、通道、客户配置或恢复管理员。测试环境仍运行旧2c228a9，本地提交不等于已上线。
|
||||
|
||||
|
||||
## 2026-09-08 17:14 日报生成超时修复与本地提交前验收
|
||||
|
||||
- 授权：修改代码并本地提交，不推送、不测试部署、不预生产部署、不补跑历史报表。开工 main/HEAD 为 2a9d03be2edc06dbd9a494e971e6b04a8336619f，暂存空；只读 ls-remote 回读远端 main 为 50ae37242bc33acf1038fb62618fc4cd95409956，本地领先 3 提交。17 个已有脏跟踪文件及原未跟踪发布工具/诊断脚本继续保护；涉及三份旧脏文档仅追加并精确暂存本轮增量。
|
||||
- 需求/设计：[可靠性补充](first-version-development-requirements.md#2026-09-08-报表生成可靠性补充)、[日报生成超时修复](report-generation-reliability-20260908.md)；TC-DAILY-0908-01～09。明确单日期三类报表原子事务、T-4～T-1 和既有财务口径，历史缺口不自动扩窗。
|
||||
- 根因证据：预生产 633ba597754c1b89943ea3a819f45042f41b019a 三类表最新 reportDate 均为 9 月 2 日；9 月 3～7 日源短信非空。保留日志 93 次事务超时，9 月 8 日 16:12 的上限 5000ms、实际 7510ms。成本 CTE 扫全部 accepted 历史提交，单条 SELECT 实测 9090.976ms 已超过整日报表事务预算。
|
||||
- 实现：应用成本 CTE 按原短信 queuedAt 限定日期，保留全部跨日提交的成功分片成本；日事务默认 30000ms、maxWait 5000ms，REPORT_REFRESH_TRANSACTION_TIMEOUT_MS 正整数覆盖且最大 120000ms，并设置事务局部 statement_timeout。删除前获取 PostgreSQL 日期 advisory lock；单日失败保留旧报表并继续其他日期，最终汇总抛错，只有全成功才标记本日完成。启动/周期定时器销毁清理，调度日与窗口共用同一时刻。未新增迁移/API 写入口/历史重算队列。两份已修改 TS 按当前 Prettier 门禁格式化，并显式忽略原 refundCents 解构值以修复该文件既有 lint 错误，列表/CSV 语义不变。
|
||||
- 预生产只读结果一致性：在同一 REPEATABLE READ READ ONLY 事务中、statement_timeout=15000ms，9 月 4 日原 SELECT 8919ms、当前候选 SELECT 100ms；两行全部结果列（含金额，按数组避免同名列丢失）摘要均为 576592fc45b7f3137882229321eaf905d1e9bba12631ccfe1a0b2016c759231b。仅移除 INSERT 头部执行 SELECT，防写入检查通过；事务最终 ROLLBACK，不调用线上生成服务。这是单日查询对照，缓存可能影响耗时，不宣称完整任务同比提速或全日期金额对账已完成。
|
||||
- 代码验收：API 全量 64 套 694 项通过（工作区包含原保护 metrics 的 1 项额外测试，未夹带提交）；最终报表定向 1 套 29 项通过。API TypeScript 生产构建、前端 TypeScript（既有 lint 组成）、changed-code Prettier/ESLint、结构检查、Stylelint、CSS 治理及 15 项工具测试、安全/部署静态门禁、git diff --check 通过。npm 当前不在 PATH，执行 package.json 对应 Node CLI；未安装依赖。API 命令为 node node_modules/jest/bin/jest.js --runInBand、node node_modules/typescript/bin/tsc -p tsconfig.build.json。
|
||||
- 真实数据库/API：新增 tools/testing/verify-report-refresh.mjs，强制独立 REPORT_TEST_DATABASE_URL、loopback 地址及 cmpp_report_test_ 数据库前缀，不使用业务 DATABASE_URL。独立本机 PostgreSQL 8 组通过：7 个报表维度与完整自然日、跨日补发/审计优先/历史兼容、重复幂等、真实 SQL 失败三表回滚且后续日期成功、跨连接日期锁、超过旧 5 秒的成功事务、200ms 限额超时回滚恢复、真实 ReportsController HTTP 筛选/分页/汇总及三类 CSV。10 条消息/10 次提交的应用 9 月 4 日收入 4000、成本 800、利润 3200（0.0001 元整数单位）一致；单次注入 5.2 秒延迟后单日事务实际 5248ms 成功。金额源列采用生产 bigint，报表表完整列/类型/唯一约束，源表只建查询用列，未做全库迁移验收。测试 schema 残留 0，临时 PostgreSQL 已停止；测试资料目录保留。
|
||||
- 证据：%TEMP%/cmpp-report-fix-20260908/{baseline.json,api-tests.log,report-tests-final.log}；%TEMP%/cmpp-report-diagnosis-20260908/{profile-select.cjs.result.jsonl,compare-candidate.cjs.result.jsonl}；%TEMP%/cmpp-report-pg-1788858316792/integration.log。脚本、源库结果未输出凭据或短信正文。
|
||||
- 未执行：预生产完整任务写入验收/自然定时观察、两环境部署、历史缺口补齐、完整应用登录与浏览器。本轮无前端改动；本地 HTTP 是独立真实报表 Controller/Service/PG，不代表完整认证/UI 验收。旧 api/tools/verify-report-recalculation.ts 含过期金额断言和业务造数，不执行也不在本轮改写。T-5 更早缺口仍须部署修复后单独授权补齐。
|
||||
- 交付：本地报表代码、测试工具、需求/设计/用例和本节一起按精确 7 文件/文档增量提交，提交号以 Git 为准；未推送、未测试部署、未预生产部署、未短信发送/补发/重投/入队，未修改业务余额、通道、客户配置或管理员。提交前保护校验确认全部已有跟踪修改未被覆盖。
|
||||
|
||||
Reference in New Issue
Block a user