feat: 重构首页回执营业统计并增加企业返还金额

docs/testing-progress.md

@@ -5139,3 +5139,25 @@ CUA本轮可用，实际后端文档三尺寸1600×1000/1366×768/390×844无页
 - 文档：优化方案第8节、上行诊断第6节、需求/测试用例/清退设计同步。本地提交仅纳入本轮代码、两项迁移、验收脚本及相关文档精确新增段落；已有metrics、版本、部署和发布工具修改保留。推送：未执行；测试部署：未执行；预生产部署：未执行。历史日报补建、真实外部MO投递、线上权限/供应商扩展码、午夜冻结过程、现场恢复/回退及完整容量指标未验证，按后续授权实施。
 
 - 最终补充：API全量覆盖率语句67.76%/分支52.88%/函数68.62%/行70.54%，增量覆盖率87.98%/77.03%/95.91%/91.22%，均通过各自门槛；前端覆盖率88.48%/85.09%/84%/88.19%，163项通过。固定日报refreshFor为任务启动日后，类型检查、9项日期测试及真实PG模拟跨午夜通过：T-1跨日仍记录原启动日，T-3跨入T-4拒绝发布且回滚。最终browser-final仍为三尺寸28请求、页面异常0。最后停止本轮本机PG/Redis/预览服务，保留验收库及日志资产。测试基于受保护工作区，发布时仍由标准工具核验精确提交证据；未把本轮本地检查冒称部署验收。
+
+
+## 2026-09-17 首页运营数据整改方案与 UI V1（未实施）
+
+- 当前授权仅编写方案和设计图。main为627fa7e，实际远端main为4eb7b16，本地领先2提交，暂存区为空；已有修改保留。本轮未连接线上环境或改业务代码。
+- 已核对AdminHome、dashboard查询、Prisma字段、Gateway回执时间、intake、分片补偿、货币单位和现有规范。旧统计按queuedAt，而新需求按今日收到回执；billingUnits适合作为去重后的业务分片当量，segmentTotal用于完整性核验；gatewayReceivedAt保留当前Gateway实际接收时刻。线上时间覆盖和成本数据仍待核验。
+- 新增[方案](homepage-receipt-metrics-redesign-20260917.md)及[UI V1](designs/homepage-20260917/homepage-v1.png)，内置imagegen生成，提示词同目录保留。明确9指标、两个点击才查询的日期明细、跨日整条成功/一次收入、成本快照、返还和运营状态。消费排行暂按替换为返还区域设计，待用户反馈。
+- 需求和HOME0917-01～14待执行用例入口已同步。完成图中文字/层级和示例加总检查、文档相对路径与diff检查；这不是业务、浏览器或性能验收。未运行回归/类型/构建，因为未修改业务代码或CSS。
+- 本地修改：方案、UI图/提示词及三份文档追加。本地提交、推送、测试部署、预生产部署：均未执行。未发送/补发/重投短信，未改账务、客户或通道配置。
+
+## 2026-09-17 首页 UI V2 修订（仅设计）
+
+用户要求顶部三组缩小至原约三分之一，改为一行三块紧凑指标；“今日回执收益”改为“今日营业状况”，今日企业消费排行按现有六列及详情/导出入口保留，不替换为返还模块，运营状态保留。此修订优先于前轮方案的返还区域解释；方案顶部已标明替代关系。内置imagegen基于V1重绘[UI V2](designs/homepage-20260917/homepage-v2.png)，原图保留，提示词同目录。已视觉核对指标、排行列和运营状态；全部数字为示例，无业务代码/CSS修改，无业务验收、提交、推送或部署。
+
+
+## 2026-09-17 首页整改实施（提交推送前核验）
+
+- 按V2完成紧凑三栏、9指标、两个按需日期明细；保留企业消费排行并增加今日返还金额列，详情/CSV同步，运营状态保留。新增独立home接口，旧客户端不变；长短信以业务单位补齐分母、完整成功才计成功片/收入，跨日与重复回执、通道成功片成本分别核算。
+- 四个统计表、两项迁移（本地新库110迁移通过），耐久触发失效、原子批次投影、版本快照、15分钟用户绑定与安全回收；原始短信/回执/账务不改写。本地真实PG、Nest API、Redis验收通过，三尺寸和完整桌面截图见[实施方案第9节](homepage-receipt-metrics-redesign-20260917.md#9-2026-09-17-实施与验收结果)。无Browser技能，使用既有授权Edge/Playwright。无短信发送或外部投递。
+- API854、前端163及覆盖率门禁通过；类型/生产构建/定向ESLint/样式/结构/CSS治理/包体检查通过。真实数据库故障与并发认领、四日及缺片/跨日/重复/退款边界通过；页面无明细预请求，错误保留真值、CSV/详情通过，页面异常0。本地样本2020消息/6000新增片，总览p95约55ms、明细约20ms，不推断线上CPU/容量。
+- 原始证据 `.local-data/homepage-implementation-20260917/`。数据库端口、Redis旧RDB、浏览器两个定位失败已修正并保留原日志；Redis版本建议保留。尚未验证线上源时间覆盖、真实大数据与现场回退、完整供应商短信闭环。
+- 起点main627fa7e、实际远端4eb7b16、暂存区空；67项原工作已备份并核对保护。仅本轮代码、迁移、方案/UI/截图、验收脚本和文档精确追加进入提交；版本/metrics/发布工具等不夹带。用户授权提交推送，不含部署；测试环境、预生产环境均未改动。最终提交与推送结果单独补记。