dachui/order_site
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,199 Commits 3 Branches 0 Tags
a6ccb2e2d80c670aae5529f5990aec31b01117e7
Commit Graph
877 Commits
Author SHA1 Message Date
yml2213 a6ccb2e2d8 perf(finance): 统一把 Intl.DateTimeFormat 提到模块级，消除逐行构造开销 
承接 14b595b0。以下 7 处仍在函数体内 `new Intl.DateTimeFormat(...)`，
单次构造约 0.5ms，按行/按条调用时会线性放大：

- utils/finance-date-range.ts         formatShanghaiDate
- utils/http.ts                       （已在上一个提交修复）
- scheduler/cost-finance-sync-job.ts  today
- finance/sales-facts-service.ts      formatDateOnly
- finance/order-refund-service.ts     toChinaDate
- admin/admin-finance-service.ts      chinaDateParts
- admin/admin-dashboard-service.ts    resolveChinaTodayRange
- scripts/sync-cost-finance.ts        formatShanghaiDate

均为同选项的纯 hoist，输出逐字节不变：formatShanghaiDate 用 9 例跨时区/
毫秒/闰日语料与旧实现比对一致；其余为相同 en-CA/en-US + Asia/Shanghai
选项的等价替换，formatToParts 的取值改为单次遍历、去掉 fromEntries/reduce。
 2026-10-30 21:23:31 +08:00
yml2213 14b595b0db perf(http): 修复响应日期格式化每次重建 ICU formatter 导致的 CPU 热点 
formatResponseDateTime 在函数内部 `new Intl.DateTimeFormat(...)`，而
buildSuccessPayload 会对每个成功响应的每个日期字段调用它。ICU formatter
单次构造约 0.5~0.8ms，V8 CPU 采样显示该函数占后端主线程约 30% CPU（约 0.33 核）。

改动：
- formatter 提到模块级只构造一次；formatToParts 直取字段，去掉
  Object.fromEntries + filter + map 的三次分配
- isIsoDateTimeString 增加 O(1) 位置预判，避免对每个字段值跑正则
- normalizeResponseDateTime 用显式循环替代 entries/fromEntries 双重分配
- 同类问题一并修复：open-91 formatOpen91ExpireTime、redeem formatGrantTime

输出逐字节一致：新增等价性测试，以修复前实现为参考覆盖跨时区/毫秒/
闰日/跨年/非法日期语料。同形态响应（200 行 × 6 日期字段）实测
35.2ms → 2.6ms（13.6x）。
 2026-10-30 21:20:11 +08:00
yml2213 fb485f7e36 feat(risk-control): 新增 IP/账号手动封禁，并收口财务同步的全表更新 
- 风控：worker_risk_bans 表 + 前置封禁中间件（登录一并拦截）+ 后台列表/新增/解封
- 财务：成本快照补商品维度收口到本批 order_item_id，不再整表扫 899MB 的 order_items
- 性能：order_items 覆盖索引（迁移 110）、大厅 pageSize 上限 20、已读/上传接口限流
 2026-10-30 20:15:14 +08:00
yml2213 1b170d3f45 perf(worker-platform): 店铺筛选下拉加 5 分钟缓存，避免全表扫描拖垮生产 2026-10-30 19:30:56 +08:00
yml2213 dc78dc92d1 feat(cost-center): 接单模板商品全量同步，改价默认立即生效 2026-10-29 21:44:29 +08:00
yml2213 c7d650b482 fix(worker): 售后追缴自动驳回提现并扣冻结资金，修复欠款抵扣 500 
- 修复欠款抵扣 SQL 参数类型冲突（debt_amount = $1 与 $1 = 0 推断不一致），
  此前手动偿还、验收报酬抵扣、充值/押金解冻/寄卖自动抵扣都会 500
- 追缴顺序改为 待解冻押金 → 提现冻结 → 可用余额 → 欠款：
  驳回待审核提现并直接扣走冻结资金，扣不完的部分退回可用余额
- 迁移 109：售后单记录 withdraw_deduction_amount，补 pending 提现部分索引
- 新增流水类型 after_sales_withdraw_deduction，前后端展示与标签同步
- 提现驳回退回余额后补调欠款自动抵扣，与充值/结算/解冻/寄卖路径对齐
- 补追缴分配单测与 SQL 参数类型静态门禁
 2026-10-29 19:05:37 +08:00
yml2213 fba0a13d44 fix(fulfillment): 履约回填改用 keyset 分页并补充待回填部分索引 
- 迁移 108：order_items (id) WHERE fulfillment_mode IS NULL 部分索引
  生产已 CONCURRENTLY 预建；取 5000 条待回填 id 4.8s → 4.9ms
- reconcilePendingFulfillmentModes 增加 afterId / lastScannedId，批内固定 id > 游标
- 新增 resolveReconcileCursor：游标单调前进，未前进或不足一批即结束
- backfill-fulfillment-mode 支持 --afterId 断点续跑
 2026-10-29 15:10:28 +08:00
yml2213 16b62a8e6d fix(cost-center): 修复接单模板改价 SQL 参数类型推断冲突 
同一个 $1 在 reward_amount 处按 bigint 推断，在 CASE ... THEN $1 ELSE 0 处
因字面量 0 被推断成 integer，node-pg 不发送参数类型时 PostgreSQL 直接报
inconsistent types deduced for parameter $1，导致改价 500。
显式写成 $1::bigint / 0::bigint，并补源码级回归测试。
 2026-10-29 14:38:20 +08:00
yml2213 979a1bfa41 fix: 免审验收容错与成本中心归一回填超时修复 
- worker：等级升级计数移出验收事务，瞬时错误重试一次，最终失败转人工待办且不再返回 500
- worker：待验收阶段修改验收资料时保留 reviewMode/evidenceStatus/evidenceDueAt
- cost-center：迁移 107 新增人工待归一覆盖部分索引（生产实测候选聚合 19.6s → 391ms）
- cost-center：归一人工商品/按工单回填商品/模板预览前端超时放宽到 300s
- cost-center：批处理接口语句超时放宽到 60s（SET LOCAL，在线接口仍为 15s）
 2026-10-29 14:33:35 +08:00
yml2213 915ce017f3 perf(finance): 消除定时同步与后台页面的重查询 
- 新增 order_items.manual_sku_key 生成列（迁移 106），统一内部 SKU 口径（skuNick → outSkuSn → sku_code → sku_name，去空格）
- 人工渠道匹配 8.4s → 62ms；人工商品归一写回 7.0s → 307ms
- 销售事实重算改为物化订单集合 + 预聚合成本/退款，6.9s → 0.5s 内
- 成本异常写入去掉逐项 LATERAL 工单探测，收口按最近 7 天窗口，7–8s → 0.5s 内
- 销售毛利订单统计去掉重复 NOT EXISTS，9.4s → 0.4s
- 接单平台店铺下拉改 EXISTS 半连接，3.1s → 0.3s
- cost-finance-sync 默认间隔 5 分钟 → 15 分钟；完整同步 51.2s → 34.9s
 2026-10-28 13:41:11 +08:00
yml2213 9d5af359fa feat(finance): 完成财务控制、L1 钱包硬化与迁移收敛 
- P0/P1：影子总账追加调整、关账/退款/资金/积分幂等、成本版本追溯、对账订单项维度
- 迁移收敛：原 103–114 合并为 103_finance_foundation、104_finance_controls、105_work_order_consignment
- 数据：L1 钱包 BIGINT/CHECK/奖励幂等；重复奖励审计口径修正与人工核对清单
- 报表：销售毛利缺失成本收入提示，旧收支页明确现金流口径
- 文档：同步迁移基线、合并评估、代码复核与上线说明
 2026-10-27 16:08:16 +08:00
zhaoxing a53321ef30 feat:寄卖增加对接客服，db脚本迁移修复 2026-10-27 13:56:08 +08:00
zhaoxing 622bd779dd feat:寄卖增加对接客服，db脚本迁移修复 2026-10-27 13:39:48 +08:00
yml2213 0de0fd7b58 chore(db): 将 108–115 补丁迁移收敛为 108–111 
- 原 108/111/112/113/114 合并为 108_finance_cost_integrity：
  成本异常归档、人工成本完整性、影子总账、商品页/模板查询索引
- 原 115 注释迁移改为 111_work_order_share_cancel_reason_comment
- 新增 reconcile-migration-history.sql，用于已跑旧 112–115 的库
  重建 schema_migrations 顺序，不重复执行 DDL
- 已验证：001→111、101→111 两条升级路径；
  旧 115 与新 111 的 pg_dump schema 完全一致
- 测试/文档迁移编号同步到 103–111

验证：backend check 853（849 pass / 4 skip）；frontend check 172 + build。
 2026-10-27 12:37:21 +08:00
zhaoxing ebab13633c fix:拼单明细状态补齐中文映射 2026-10-27 10:47:26 +08:00
zhaoxing 919e228452 fix:拼单明细状态补齐中文映射 2026-10-27 10:34:21 +08:00
yml2213 c8b7e80979 perf(template): 补模板证据日期/覆盖索引，预览降到秒级 2026-10-26 16:43:56 +08:00
zhaoxing 7743d2019c fix:优化再拼一次bug,优化打手端移动端拼单列表显示 2026-10-26 16:36:26 +08:00
yml2213 2b967ddd4c feat(cost-center): 商品初始化/回填增加时间范围，默认最近 30 天 
- 接单模板初始化预览/执行支持 dateFrom/dateTo，只使用范围内工单证据；
  范围外模板不再先建商品
- 按工单回填商品支持时间范围；人工商品归一 UI 传时间范围
- 模板初始化重置只清理范围内导入映射/订单项，避免误伤范围外数据
- 初始化/回填默认最近 30 天，自动发货仍固定 30 天
- 文档更新初始化口径与页面操作
 2026-10-26 16:26:48 +08:00
yml2213 288a0526ad perf(cost-center): 建索引后立即刷新统计信息 2026-10-26 16:08:06 +08:00
yml2213 25012c30f4 perf(cost-center): 商品页跳过无关 affiliate 聚合并补部分索引 2026-10-26 16:04:52 +08:00
yml2213 f0dda3842b test(worker): 校验拼单验收统一收口函数的寄卖钩子 2026-10-26 15:51:38 +08:00
yml2213 6dc1e7e727 fix(scheduler): 成本财务同步默认回退最近 7 天，避免小库语句超时 2026-10-26 15:49:51 +08:00
zhaoxing 2bfcdd5b1f Merge branch 'dev1023' into dev 2026-10-26 15:26:43 +08:00
yml2213 6b0078f680 fix(finance): 收口快手退款路由并修复销售事实变更后的总账同步 
- 平台退款路由从通用订单路径改为
  POST /api/v1/admin/kuaishou-industry/orders/:orderId/refunds/approve-and-record，
  服务改名 approveAndRecordKuaishouRefund，明确仅快手 91
- 总账同步改为未关账期间按日整体重建销售凭证，解决收入回填/退款重算后
  旧凭证金额不更新的问题；删除与重建放在同一事务，已关账期间保持不动
- 文档明确 revenue:backfill 是存量订单退款的前置条件：
  revenue_amount_fen=0 会导致退款登记按钮置灰
- 本地生产副本已执行 revenue:backfill：375,447 行全部回填，
  order 375483 可退金额恢复为 237.00 元

验证：backend check 844（840 pass / 4 skip）；frontend check 172 + build；
集成测试通过（代录、总账平衡、关账阻断、对账）。
 2026-10-26 13:48:53 +08:00
yml2213 62763ddf0c feat(finance): 支持代录指定客服账户，并上线影子总账/对账/关账/快手平台退款 
- 人工确认履约：管理员/财务/运营可传 fundAccountId / creditOwnerAdminUserId
  指定客服备用金/积分账户；客服仍强制本人账户
- 新增迁移 112：finance_accounts / journal_entries / journal_lines /
  periods / reconciliations / reconciliation_items，种子 11 个科目
- 影子总账：销售事实按日生成收入/退款/成本凭证，支持手工凭证、试算平衡；
  不接管钱包余额；总账同步接入定时任务与退款重算
- 期间关账/反关账：关账先补凭证并校验试算平衡，closed 期间禁止新增凭证
- 平台对账：JSON 账单导入，按 provider + platform_order_id 匹配订单/退款，
  标记 matched/amount_mismatch/missing_order/missing_refund/duplicate
- 平台退款：快手行业（91）同意退款 API 接入，成功后落 source=platform；
  抖音/拼多多返回 501，保留手工退款
- 新增后台「财务 → 总账与对账」页面（总账/期间/对账三个 Tab）
- 集成测试扩展到代录、总账平衡、关账阻断、手工凭证、对账匹配

验证：backend check 844（840 pass / 4 skip）；frontend check 172 + build；
迁移 112 在 scratch 库全量执行并重跑幂等；本地生产副本已升级到 112，
销售事实同步 56 条凭证，借贷合计 1,885,351,864 = 1,885,351,864。
 2026-10-26 13:32:47 +08:00
yml2213 a3e2bdb7c4 feat(finance): 人工成本单事务/幂等 + 配置自动匹配 + 缺成本监控 
- 确认履约改为单事务：锁订单项 → 复查快照 → 扣积分/备用金 → 写成本快照；
  快照失败整体回滚，不再出现「钱扣了、成本没记」
- manual_case 的 subject_id 统一为 order_item_id，新增订单项级唯一索引（迁移 111），
  消除 manual_expenses.id / platform_credit_entries.id 跨表撞车
- 人工 SKU 匹配增加 sku_code / sku_name 兜底；保存配置立即回填最近 30 天，
  定时任务按窗口 rematch，确认时再按 SKU 兜底匹配
- 新增 manual_cost_missing 异常队列：从首次人工配置起算，确认履约立即收口
- 补单元测试与真实 PostgreSQL 集成测试（并发、重复、强制快照失败回滚、双资金链路）
- 校准财务文档并新增上线初始化/验收手册（历史人工不补录，只保证配置后的新单）

验证：backend typecheck/lint/format/check:sql/test 843（839 pass / 4 skip）；
frontend typecheck/lint/test 172；迁移 111 在 scratch 库全量执行 + 重跑幂等。
 2026-10-26 13:04:51 +08:00
zhaoxing 2c9f741873 fix:撤单之后 重新指派给你同一个打手 同一个订单 不显示订单号不显示任何信息 2026-10-26 12:41:07 +08:00
zhaoxing 6a5a8d70b0 feat:拼单订单新增一个取消部分的按钮功能，点击之后，打手进行中和待接单的都会取消订单 2026-10-26 12:15:52 +08:00
yml2213 73908119dc style(backend): 修复 4 个文件的 Prettier 格式告警 
仅按仓库 Prettier 规则换行/去多余空行，无逻辑变更：
- routes/admin/cost-center-catalog.ts
- services/cost-center/affiliate-dash-prices-baseline.ts
- services/cost-center/affiliate-product-service.ts
- services/cost-center/product-catalog-service.ts

验证：backend format:check / typecheck / lint / check:sql 通过，
tests 833 pass（3 skipped）；frontend format:check 通过。
 2026-10-26 12:13:08 +08:00
yml2213 31a8b6fc65 Merge branch 'dev1023' into dev 
解决 9 个冲突文件，并修复合并后遗留问题：

- 大厅候选集：采用 FIFO 窗口 + 全部置顶单 UNION（列表与抢单/拼单复核同源）
- 拼单份额：采用多次参与模型（每次参与 INSERT 新份额、requestId 幂等），
  取消后可重新参与；移除 HEAD 已废弃的单行 rejoin 逻辑与对应测试
- 工单迁移与成本中心 103–108 编号撞车：合并重写为
  109_work_order_share_participation / 110_work_order_hall_and_shop_indexes；
  临时库全量执行与重跑幂等验证通过（10 列、唯一键已删、7 个索引）
- 实时补丁：保留个性化字段、置顶重排、分页总数同步；补回 orderTimelineVisible 类型
- 打手大厅：保留 memo 组件化，移植「再拼一次」多份额按钮逻辑
- 全项目表格统一 PercentTable：WorkerOrderShareTable 改造

验证：backend typecheck/lint/check:sql/test(833 pass)、
frontend typecheck/lint/test(172 pass)/build 全绿。
 2026-10-26 12:10:53 +08:00
zhaoxing 42961dd789 fix:打手端/我的订单/验收：验收视频和验收图片至少上传一个就好了，其他逻辑按照上传图片走 2026-10-25 16:48:26 +08:00
zhaoxing 60fe00b28c fix:打手端/我的订单/验收：验收视频和验收图片至少上传一个就好了，其他逻辑按照上传图片走 2026-10-25 16:45:38 +08:00
yml2213 12f370de15 feat(cost-center): 将统计与自动发货同步统一收敛至最近一个月并自愈历史非标SKU 
- 范围收敛：将财务日期范围默认窗口、自动发货履约任务扫描、成本快照重算及定时任务默认窗口统一收敛为最近一个月（30 天），不再扫描混乱的历史遗留数据
- 脏数据清洗与自愈：在自动发货同步与基线导入时自动识别并清理历史把中文名当做 SKU 插入的 21 个非标脏商品，将关联的 116 个订单项平滑重定向至标准 38 款基线商品
- 标准提取：从履约任务 context_json 中按优先级提取标准上游 sku，通过正则仅允许合规英数标识符入库，避免中文名称污染商品目录
- 界面对齐：前端销售毛利概览默认查询最近 30 天，自动发货与目录改价追溯生效时间默认设置为近一个月（30 天前）
- 验证方式：全量单测 783 项通过、tsc 0 error、容器内执行同步后脏商品归零且销售事实精准重算
 2026-10-25 16:24:50 +08:00
yml2213 e61d003342 fix(cost-center): 将自动发货价格基线转为内建常量并修复参数类型 
- 提取并内建 38 条自动发货采购成本基线常量，消除生产镜像缺失 scripts 目录的 ENOENT 问题
- 在 jsonb_build_object 中增加 $5::text 类型显式强转，避免 Postgres 参数类型推断错误
- 增加同生效日期的版本就地更新逻辑，保障基线可重复无损导入
- 验证方式：npm run typecheck、npm test、生产镜像容器内真实触发导入接口返回 200
 2026-10-25 16:03:16 +08:00
yml2213 b7ad69831a feat(cost-center): 统一商品成本中心为全系统唯一标准价格源并闭环改价与工单同步 
- 核心架构：将商品与成本中心确立为全系统唯一标准价格源，接单模板价格在接单平台禁止编辑并提示收敛至成本中心，后端 saveAdminWorkProductRule 严格拦截价格篡改
- 改价与同步：标准商品目录与自动发货专属面板提供统一改价弹窗，支持追溯/立即生效/指定时间；改价后自动或手动将新价格同步至接单大厅待抢单工单，保持下游业务一致
- 缺陷修复：修复 cost_versions 追溯改价时因同生效时间违反 chk_cost_versions_period 检查约束及 uq_cost_versions_scope 唯一索引冲突的问题，采用 active 版本就地更新机制
- 分类树优化：工单二级分类树限定仅在工单来源展示，自动发货与人工客服彻底隐藏分类树并重置过滤条件
- 验证方式：通过后端 784 项全量测试、前后端 tsc 类型检查及前端生产构建打包
 2026-10-25 15:21:34 +08:00
zhaoxing d787d3c364 feat:抢单大厅数据排列优化 2026-10-25 14:41:13 +08:00
yml2213 88ba87efff feat(cost-center): 总览统计支持按来源收敛 
页面顶部的 6 张统计卡原本是全局口径：选了「自动发货」，商品数还是 2017、
异常数还是 108,314，和下面的列表对不上。

- overview 接口接受 scope（all / affiliate_dash / work_order / manual）；
- 商品、映射、成本项、生效版本、待处理异常、未映射订单项全部按来源过滤：
  商品看 canonical_sku 前缀（aff: / tpl:+wo: / man:），
  成本项与版本看 cost_model，异常与未映射订单项看 order_items.fulfillment_mode；
- 额外返回 productTotalCount（全局商品数），供「全部」徽标使用，
  避免切到单一来源后「全部」也被算成 49。

实测四种口径：
  all            商品 2017 / 映射 4897 / 成本项 3 / 版本 712 / 异常 108314 / 未映射 53901
  affiliate_dash 商品   49 / 映射    0 / 成本项 1 / 版本   0 / 异常  53204 / 未映射     0
  work_order     商品  773 / 映射 4897 / 成本项 1 / 版本 711 / 异常   1209 / 未映射     0
  manual         商品 1195 / 映射    0 / 成本项 1 / 版本   1 / 异常      0 / 未映射     0
 2026-10-25 13:55:25 +08:00
zhaoxing 9c620d39cb feat:拼单明细管理加一个撤份额的功能，指定数量 2026-10-25 13:44:34 +08:00
yml2213 39fe448b48 feat(cost-exceptions): 支持 --days=0 一次性归档 
一次性清理需要「不按时间过滤」的语义，但 CLI 把 days 下限钳在 1：
本地库的 15.2 万条 resolved 异常是 17 小时前重建生成的，
--days=1 一条都命中不了，只能手写 SQL。

- --days=0 表示不过滤时间，归档全部已处理行（open 仍不归档）；
- 执行时打印一次性清理提示，避免日常误用；
- 记录 2026-10-25 的实际清理结果：151,939 行 / 152 批 / 3.9 秒，
  热表 260,253 → 108,314（全为 open），VACUUM FULL 后 155 MB → 51 MB，
  归档表 61 MB，主键重叠 0 条。

验证：--days=0 --dry-run 返回 retentionDays=0、archivableRows=0（已清空）。
 2026-10-25 13:34:09 +08:00
yml2213 ccc71e0aab Merge branch 'main' into dev 2026-10-25 13:33:05 +08:00
yml2213 2fb7aae13f feat(auth): 登录态改为滑动续期（后台 24h/7d，打手 7d/30d） 2026-10-25 13:28:58 +08:00
yml2213 81edf530db fix(worker-platform): 拼单取消后可重入，大厅置顶始终优先 2026-10-25 13:08:19 +08:00
zhaoxing a7a8634a96 feat:加一个网站发布公告会弹出来点确定我已知晓的弹窗;mock数据自动匹配接单模板;本地访问模式修改 2026-10-25 12:27:32 +08:00
yml2213 d90c066888 feat(cost-center): 成本异常 60 天归档 
cost_exceptions 只增不减：本地快照 260,253 行（resolved 151,939 / open 108,314），
已处理的行只是审计痕迹，留在热表会拖慢「状态 + 时间」分页，并让唯一索引持续膨胀。

- 迁移 108：新增 cost_exceptions_archive（保留原 id 与时间字段，加 archived_at），
  热表补部分索引 idx_cost_exceptions_archivable
  (COALESCE(resolved_at, created_at)) WHERE status <> 'open'，让每日任务不扫全表；
- cost-exception-archive-service：只归档 status <> 'open' 且超期的行，每批 1000 行，
  DELETE ... RETURNING + INSERT 在同一语句内完成，单批原子，不存在「删了没归档」；
- data-retention 每日任务接入；保留期走 COST_EXCEPTION_RETENTION_DAYS（默认 60）；
- 新增 npm run cost-exceptions:archive（--dry-run / --days / --batch-size）。

为什么 open 行不归档：open 是待办队列，超期不等于已解决，归档等于把问题藏起来。

验证：
- 3 条 resolved 回拨到 90 天前 → 归档 3 条，热表 resolved 151,939 → 151,936；
- 1 条 open 回拨到 90 天前 → 仍在热表，未被归档；
- 归档表保留原 id 与时间，archived_at 记录归档时刻；
- 恢复测试数据后计数回到 151,939 / 108,314。
 2026-10-25 12:09:20 +08:00
yml2213 fcd9b607d4 refactor(cost-center): 共享层按职责拆为四个模块 
cost-center-shared.ts 804 行同时装枚举、行类型、映射、归一化，任何一处改动都会
让 8 个引用方重新编译。按职责拆开，本文件退化为统一出口（export *）：

- cost-center-constants.ts    131  枚举、常量、SQL 片段
- cost-center-types.ts        220  行结构与 DTO 类型
- cost-center-mappers.ts      250  行映射与口径判断（含 CostPreview）
- cost-center-normalizers.ts  254  入参归一化与断言

同时消掉一个类型环：CostPreview 用 ReturnType<typeof mapProduct> 反推 mapper 的
返回类型，导致 types → mappers → types 互指；CostPreview 随 mapper 一起放进
mappers，依赖恢复单向。

出口保持向后兼容，8 个引用方无需改动；71 个导出逐一比对无缺失。
验证：typecheck / lint / 773 测试通过。
 2026-10-25 12:02:36 +08:00
yml2213 ad1e1bc884 perf(db): 收入口径回填改为分批脚本 
迁移 104 里对 order_items 的全表 UPDATE 实测 34.4 秒（375,447 行），
远超默认语句超时 15s，单事务迁移会拖住启动甚至直接失败。

- 104 只保留 DDL 与索引/约束，删除全表 UPDATE；
- 新增 scripts/backfill-revenue-basis.ts：按 id 分批、幂等、支持
  --dry-run / --batch-size / --max-batches（kebab 与 camel 两种写法）；
- package.json 增加 revenue:backfill；
- migrate.ts 启动时做一次带索引计数，仍有 unknown 时打印告警并给出命令，
  不阻塞启动；
- 文档补充回填步骤与「不执行的后果」。

验证：
- 实测 37.5 万行全表更新 34.4s → 脚本按批执行，单批 5000 行；
- 功能验证：单条订单项置 unknown → 脚本回填 → 金额与 basis 恢复正确；
- 启动告警验证：保留 1 条 unknown 重启 → 日志出现告警；回填后计数归零；
- 全新库从 102 迁移到 107 仍成功（2s）。
 2026-10-25 12:02:26 +08:00
yml2213 f10fefc303 refactor(cost-center): 拆分模板引导与成本解析服务 
两个千行级服务按「变化原因」拆开，函数体逐字保留：

template-bootstrap-service.ts 1407 行 →
  - template-bootstrap-service.ts   745  preview/apply、映射计划、模板商品编码
  - affiliate-product-service.ts    199  自动发货商品同步与 SKU 回填
  - work-order-product-service.ts   467  接单平台商品回填与模板发单金额同步

cost-definition-service.ts 1382 行 →
  - cost-definition-service.ts      727  成本项/成本版本/成本异常 CRUD
  - cost-resolution-service.ts      680  预览、解析上下文、快照生成

依赖方向是单向的：CRUD 依赖解析层的 4 个校验/取值函数，解析层不反向依赖；
rebuildFactsForRange 因跨文件复用改为导出。

验证：9 个导出函数全部保留（无丢失），typecheck / lint / 773 测试通过。
 2026-10-25 11:49:27 +08:00
yml2213 b033746172 refactor(admin): 成本中心路由按域拆分 
cost-center.ts 从 898 行、48 个端点拆成 4 个子路由 + 54 行入口：

- cost-center-catalog  商品主数据、渠道映射、模板/自动发货/接单平台回填
- cost-center-cost     成本项、成本版本、快照、异常
- cost-center-manual   人工履约 SKU 配置
- cost-center-credits  客服平台积分钱包

入口只保留角色校验、overview/options 与挂载顺序；子路由路径仍是完整路径，
不需要再加前缀。

验证：
- 静态核对：拆分前后 (method, path) 集合完全一致，48 → 48；
- 运行时核对：遍历 Express router stack，仍注册 48 条 /cost-center 路由；
- 端点正文逐字保留，只有 import 与文件边界变化。
 2026-10-25 11:49:21 +08:00
yml2213 26c70143db refactor(admin): 路由请求助手去重 
finance / fund / cost-center 三个路由文件各自复制了 sessionOf / idOf / bodyOf，
语义相同写法不同。统一到 routes/admin/request-helpers.ts，路由文件只保留业务
差异（fund.ts 的 accountIdOf / expenseIdOf）。

无行为变更：typecheck、lint、773 个测试全部通过。
 2026-10-25 11:38:19 +08:00