WIP-321 — a端 Dashboard 真实看板深化 + b端 SiteTexts 尾项 + env 回执补刷

扣子二号 · coze2 · 2026-09-14 18:5x · 池空激活接单

证据包：typecheck-build.log（a端 tsc0+build0、b端 tsc0）+ 本文档（契约对照）

一、派单验收项 → 结论对照

#	派单要求	结论	说明
①	a端 Dashboard 真实数据绑定（订单/核销/商户聚合——267/280 API）	✅ 完成	`/stats/overview` 已补齐核销/商户聚合字段，看板现展示真实全量（见 §二）
②	b端 SiteTexts 页（279 尾项）	✅ 复核通过	已完整接真（GET/PUT/DELETE + 路由 + BASE_ROUTES），本单零改动
③	二号 .env 整改后回执补刷	✅ 复核通过	二次回执已入库（receipts/二号.md §147 与 §265），见 §四

二、a端 Dashboard 深化明细

背景：WIP-312 完工时 /stats/overview 缺核销/商户聚合，当时看板以「最近 200 单快照」兜底并登记 BLK-2。阿仁已按 WIP-312 BLK-2 补齐后端（admin_backend.py:496-549 stats_overview 新增 4 字段），本轮前端接真全量聚合。

改动（仅前端，contract + 页面）：

services/contract.ts — StatsOverview 补 4 字段（与后端 {ok:true,data:{...}} 对齐）：
redemption_count：履约完成核销订单（核销域 262）
voucher_redeemed_count：券码已核销
merchant_count：商户总数
merchant_active_count：在营商户数

pages/Dashboard.tsx — 顶部 stat-cards 从「区间订单/新增用户/事件分类/窗口」扩展为 6 卡真实业务聚合：
区间订单数（N 天）、区间新增用户
累计核销订单（履约完成）、券码已核销
商户总数（在营 N）
活跃事件分类
快照区块口径注同步更新（移除过时 BLK 表述，明确核销/商户已用顶部真实全量）。

沿用因果分支：GMV 后端仍无全量聚合端点，订单快照区块保留「最近 N 单」口径（有效单金额合计仅累加已支付/履约/完成类），不做时间窗全量、不虚构。

三、前后端匹配验证

前端请求：GET {admin}/stats/overview?days=N（api.ts getStatsOverview，N∈{7,30,90}）
后端路由：admin_backend.py /api/admin/stats/overview（days Query 1..90）
响应包：{ok:true, data:{days, events_by_category, top_events, total_orders, new_users, redemption_count, voucher_redeemed_count, merchant_count, merchant_active_count}}
解包：unwrap 已兼容 {ok,data} 与 {code,data} 双包 → 匹配 ✓
字段类型：total_orders/new_users 等为 number；events_by_category[].c 为 string|number（数值由 toNum 归一化）→ 兼容 ✓

四、env 整改回执补刷确认

admin-console/.env：WIP-257 时代已由 590f395 移出索引，核查确认该路径本就不在 git 索引（历史已清理）✓
根 .env + .swc/：WIP-312 晚已处置——根 .gitignore 追加（.env/.env.*/.swc/，放行 !.env.example）、git rm --cached 保留本地、建根 env.example 登记变量名（不经真实值）✓
凭据去向：真实 ADMIN_API_KEY/DATABASE_URL 由服务器 /srv/kailash*/.env（docker-compose env_file）注入，仓库只存变量名 ✓
二次回执登记：receipts/二号.md §147（初次）+ §265（根 .env 补做闭环）均已入库 ✓

五、涉及金额口径

本单仅展示型聚合，无任何写操作。GMV 快照为展示，不触发资金事务。
涉钱五类（支付/结算/分账/退款）本单未触及。

六、验证结果

a端 admin-console：tsc --noEmit exit=0；npm run build 成功（built in 768ms）
b端 b-workbench：tsc --noEmit exit=0（SiteTexts 零改动基线）
作用域：仅 Dashboard.tsx + contract.ts（a端）2 文件，无 b-workbench/src 入提交树

待办/阻塞

无（三验收项均闭合）。Dashboard 快照 GMV 若需全量口径，属后端域（待 L 总/后端拍板是否加全量 GMV 聚合端点）。