dachui/order_site
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,184 Commits 6 Branches 0 Tags
a53321ef30dbfe3ddf0572ce82511971b19a7bee
Commit Graph
234 Commits
Author SHA1 Message Date
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 2b967ddd4c feat(cost-center): 商品初始化/回填增加时间范围，默认最近 30 天 
- 接单模板初始化预览/执行支持 dateFrom/dateTo，只使用范围内工单证据；
  范围外模板不再先建商品
- 按工单回填商品支持时间范围；人工商品归一 UI 传时间范围
- 模板初始化重置只清理范围内导入映射/订单项，避免误伤范围外数据
- 初始化/回填默认最近 30 天，自动发货仍固定 30 天
- 文档更新初始化口径与页面操作
 2026-10-26 16:26:48 +08:00
zhaoxing 2bfcdd5b1f Merge branch 'dev1023' into dev 2026-10-26 15:26:43 +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
zhaoxing 6a5a8d70b0 feat:拼单订单新增一个取消部分的按钮功能，点击之后，打手进行中和待接单的都会取消订单 2026-10-26 12:15:52 +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
yml2213 dfc01db4ae feat(admin): 整合财务模块导航为侧边栏子菜单与顶部联动Tab 
- 侧边栏收敛：将散落在运营分组下的销售毛利、商品与成本、钱包管理、收支明细整合入「财务」二级子菜单，并支持智能展开与角色权限隔离
- 顶部导航联动：新增 FinanceSubNav 通用组件，在销售毛利、商品与成本中心、钱包管理、收支明细 4 个页面顶部统一提供一键切换 Tab
- 语义规范化：将原“财务”流水页面标题明确为“收支明细”，消除模块与页面的命名歧义
- 验证方式：npm run check 全量检查通过（Prettier、ESLint、tsc、单测 100% 通过），构建产物已同步至运行容器并验证路由与交互
 2026-10-25 20:39:11 +08:00
yml2213 eaffae4af0 fix(frontend): 支持请求级自定义超时并将接单模板初始化与批量回填超时延长至5分钟 
- 在 http 客户端封装中增加可选 RequestOptions 参数透传，允许对耗时较长的数据初始化/大批量回填接口单独配置超时
- 将 applyAdminTemplateProductBootstrap、syncAdminAffiliateDashCostSnapshots、backfillAdminProductMappings 及 backfillAdminNormalizedQuantities 客户端超时由 50 秒延长至 300 秒（5分钟）
- 彻底解决生产全量订单数据规模下接单模板初始化触发 50 秒网络超时提示的问题
- 验证方式：npm --prefix apps/frontend run typecheck 通过，生产镜像构建运行正常
 2026-10-25 17:29:58 +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
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 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 790de676c6 feat(admin): 收口人工履约入口并修复履约筛选 2026-10-24 17:42:07 +08:00
yml2213 faf56e567e feat(finance): P2 手动退款登记与成本异常闭环 
- 迁移 112：order_refunds（订单项级退款，整单拆多条共享 batch_no，source/external_ref 预留平台 API）+ cost_exceptions.resolution_note
- 新服务 order-refund-service：整单/指定商品退款、可退金额校验、撤销、全额退完同步 pay_status
- 销售事实改为按有效退款记录冲减；无记录时仍兼容 pay_status=refunded 的历史全额退款
- 订单详情新增退款登记与退款记录表，商品明细显示收入/已退/可退
- 全额退款自动关闭该订单项成本异常并写处理备注；成本异常处理改为带备注弹窗
- 财务事件 UNION 接入退款记录，文档同步 P2 状态与 API
 2026-10-24 17:18:51 +08:00
yml2213 a78cc1f984 feat(finance): P1 人工商品归一，按内部 SKU 生成 man 商品并回填 
- 新服务 manual-product-normalization-service：skuNick → outSkuSn → sku_code 兜底，按内部 SKU 生成 man:<sku> 商品
- 订单项按 id 分批（2 万/批）回填，避免 15s 语句超时；同步补齐人工成本快照的商品维度
- 新增 POST /cost-center/manual-products/normalize（支持 dryRun/日期窗口），成本中心「标准商品」加「归一人工商品」按钮
- 每日 cost_finance_sync 接入最近 N 天的增量归一
- 渠道映射未归一队列增加人工单提示：人工单不能用平台 sku_code 建映射
- 文档同步：P1 标记完成，补充归一接口契约与销售事实重算结果
 2026-10-24 16:54:55 +08:00
yml2213 e5122d116a feat(cost-center): 渠道映射改为诊断优先，新增未归一队列 
- 顶部统计卡：标准商品 / 映射 / 未归一订单项 / 未归一 SKU 组
- 新增「未归一」队列：按来源+店铺+平台SKU+履约方式聚合，行内建映射并预填
- 目录表从 7 列精简到 4 列，匹配方式移入展开明细
- 回填订单项后自动把已归一的 product_mapping_missing 异常收口
- 新增 /cost-center/mappings/diagnostics 与 /mappings/unmapped，按履约方式拆分聚合避免全表扫描
 2026-10-24 16:36:16 +08:00
zhaoxing 0ee5554f57 add:新增验证视频可选上传功能 2026-10-24 16:12:56 +08:00
yml2213 956ef5d695 refactor(cost-center): 精简成本中心，人工成本以 SKU 配置为唯一真源 
- 删除「成本项目」「成本版本」「成本预览」三个 Tab：成本项只有 3 条系统内置，版本金额只是快照挂载点
- 新增只读「发单价格」面板，仅在接单平台来源显示，改价仍走接单模板后同步
- 成本预览改为弹窗，从成本异常行和订单详情「查成本」进入；人工单显示 SKU 配置成本并禁止生成快照
- 成本异常新增按原因聚合摘要接口，列表支持 reason/since 筛选，默认只看近 24 小时
- 迁移 111：把 sys_manual_service 的历史 ¥88 全局版本清零；预估同步与成本缺失判定排除 manual_actual
 2026-10-24 16:07:25 +08:00
yml2213 a96229a106 feat(finance): 完善客服钱包与人工履约成本流水 2026-10-24 14:34:28 +08:00
yml2213andClaude Opus 4.5 d07d88e25c feat(finance): 积分钱包操作 + 客服「确认履约」闭环 
把「配置 → 待办 → 确认履约 → 扣额度 → 写成本快照」整条链路打通，
客服点一下就完成履约，不需要填复杂的东西。

积分钱包（P1.3）：
- platform-credit-service.ts：充值 / 调整 / 消耗 / 流水查询。
- 三平台积分互不通用，每客服每平台一个账户；余额只能由流水产生，
  消耗不足直接拒绝（409），不允许负余额，与备用金口径一致。
- 换算率按平台：南航、乐玩 1 积分 = 1 分，ROCK 1 积分 = 1 元。
- 充值 / 调整只对 admin/operator/finance 开放；客服只能看自己的钱包。
- 备用金现金不在这里，走现有 fund_* 链路。

确认履约（P1.4）：
- manual-fulfillment-service.ts：待办列表 + 确认履约。
- 待办口径：order_items.fulfillment_mode='manual' 且已配 fulfillment_config_id。
  人工单**不建 fulfillment_tasks**——那是自动发货通道的体系，人工单历来不走它
  （本地 102,955 个人工单的任务行数为 0）。
- 「已履约」判定：该订单项存在有效 manual_case 成本快照。
- 固定成本（消耗积分 > 0）→ 零输入；成本不固定（= 0）→ 只填实际成本金额。
- 确认时：积分平台扣积分钱包、备用金现金走 writeFundExpense，
  随后写 actual 成本快照（主体 = 积分流水 id 或备用金支出单 id）。
- 渠道与消耗积分永远提前配好，客服不选；重复履约直接拒绝。

前端：
- 新增「人工履约」页（客服菜单）：待确认 / 已履约 / 全部，确认履约弹窗。
- 备用金页新增「平台积分」Tab（客服端与管理端各一份）：
  余额卡片、积分流水、管理员充值与调整。

E2E 实测：配置 ROCK 100 积分 → 成本 ¥100.00（1 积分 = 1 元）；充值 5000 积分
= ¥5000；确认履约后积分 5000 → 4900，成本快照 actual ¥100.00 写入；
重复履约被拒绝。测试数据已清理，登记表保留 357 条扫描结果供运营使用。

校验：后端 765 项 / 0 失败，前端 143 项全通过（含 tsc -b 与 build）。

Co-Authored-By: Claude Opus 4.5 (1M context) <noreply@anthropic.com>
 2026-10-24 13:21:34 +08:00
yml2213andClaude Opus 4.5 4bcb4e6b57 feat(finance): 人工履约 SKU 配置清单 + 四钱包（南航/乐玩/ROCK积分 + 备用金现金） 
客服人工履约有四个钱包，成本与渠道在后台配置好，客服确认履约时零输入。

口径（2026-10-24 确认）：
- 四个钱包：南航积分 / 乐玩积分 / ROCK 积分 / 备用金现金。三平台积分互不通用，
  每客服每平台一个积分账户；现金复用现有 fund_accounts / fund_entries。
- 积分换算率按平台不同：南航 1 积分 = 1 分，乐玩 1 积分 = 1 分，
  ROCK 1 积分 = 1 元（100 分）。真源是履约档案 config_json.rechargeUnitPriceFen。
- 积分是货币，幸运币是商品；消耗积分与成本金额按换算率一一对应。
- 配置主键是**内部 SKU**（快手 spec_json.skuNick / 拼多多 spec_json.outSkuSn），
  不是商品标题（标题是引流）。同名 SKU 算同一商品，跨渠道共用一份配置。
- 配置链路没有匹配引擎、没有打分：扫描 → 配置 → 重新匹配。
  10 月口径下人工单 17,469 单 / 357 个内部 SKU，Top 50 覆盖 88% 单量。
  更早的老单没配置意义，不纳入统计口径。
- 消耗积分填 0 = 成本不固定，客服在确认履约时手填实际成本；
  渠道始终提前配好，客服不选。

迁移 110：
- manual_sku_registry：扫描到的内部 SKU 登记表（统计 + 配置状态）。
- manual_fulfillment_configs：内部 SKU → 渠道 + 消耗积分 + 成本模式。
- platform_credit_accounts / platform_credit_entries：三平台积分钱包与流水。
- order_items.fulfillment_config_id：订单项挂配置，重新匹配时回填。
- 4 条 manual_* 履约档案（manual_dispatch 执行器 + config_json 区分平台）。
  不复用 kuaishou_ct_assisted / kuaishou_feifei——那是已下线的历史自动发货通道。

性能：spec_json->>'skuNick' 无索引时扫描 2.4s / 回填 5.4s；
新增 idx_order_items_manual_internal_sku 表达式索引后回填降到 1.7s。

后端：manual-fulfillment-config-service.ts（扫描/清单/配置CRUD/重新匹配），
成本中心挂 7 个接口。
前端：成本中心新增「人工 SKU 配置」Tab（扫描、清单、配置弹窗、重新匹配）。

校验：后端 765 项 / 0 失败（含 check:sql 迁移护栏），前端 143 项全通过；
E2E 实测扫描 357 个 SKU、配置四平台换算正确、重新匹配回填 7,604 个订单项；
本地库迁移 110 执行后数据量与改造前一致。

Co-Authored-By: Claude Opus 4.5 (1M context) <noreply@anthropic.com>
 2026-10-24 13:12:46 +08:00
yml2213andClaude Opus 4.5 fb679d76f6 refactor(finance): 人工成本收敛为「人工录单 → 扣备用金 → 写快照」 
公司人工支出登记单与审批报销状态机整链下线，人工成本只留一条链路。

口径调整（2026-10-23 确认）：
- 历史人工支出找不回来，直接放弃：不补录、不做样本校准、不做均价估算，
  只保证上线后的新单不丢。
- 人工成本逐单按实际金额，从客服备用金扣款，客服只能用本人账户；
  没有登记单、没有审批、没有报销，录入即计入毛利。

后端：
- 新增 services/finance/manual-order-cost-service.ts：扣备用金 + 写 actual
  成本快照，同一事务，余额不足直接拒绝不允许负余额。
- 成本快照主体从「人工支出登记单 id」改为「客服备用金支出单 id」
  （subject_type='manual_case'，subject_id=manual_expenses.id）。
- 删除 services/finance/manual-expense-service.ts（1263 行）与
  routes/admin/finance.ts 下 /finance/manual-expenses* 全套接口。

前端：
- 删除 AdminManualExpensePage.tsx（778 行）与 /admin/manual-expenses 菜单页。
- ManualOrderCostModal 去掉「提交审核 / 立即计入成本」开关，录入即生效。
- 新增 services/admin/manual-order-cost.ts。

迁移：
- 106_manual_expense_records.sql → 106_fund_account_no_readable.sql，
  只保留备用金账户编号可读化。
- 108_drop_manual_expense_records.sql：删除 manual_expense_records 与
  manual_expense_events 两张表。
- 109_isolate_legacy_manual_snapshots.sql：把来源为旧登记链的历史孤儿快照
  subject_id 改为负数，与 manual_expenses.id 彻底隔离。

踩坑修复（E2E 实测发现）：主体 id 换空间后与历史孤儿快照撞唯一索引
uq_cost_snapshots_active_subject_item，INSERT ... ON CONFLICT DO NOTHING
静默跳过，导致「钱从备用金扣了、成本快照却没写成」。修法是迁移 109 隔离
legacy 主体 + 后端快照写失败必须抛错回滚（409），杜绝账实不符。

文档：现行 5 篇 + README 基线校准为 dev @ 43f402cf + 迁移 103–109，
修正已删除的旧迁移号，删除「人工支出登记 + 审批 + 报销」口径，
已作废 DDL 草案移入 docs/archive/2026-10-23/。

校验：后端 765 项 / 0 失败（含 check:sql 迁移护栏），前端 143 项全通过；
E2E 实测两笔同订单项各自独立主体、余额扣减与快照金额一一对应；
本地库迁移 108/109 执行后数据量与改造前完全一致。

Co-Authored-By: Claude Opus 4.5 (1M context) <noreply@anthropic.com>
 2026-10-24 11:31:29 +08:00
zhaoxing f9aeece7ab add:新增同一个工单同一人可以多次拼单：拼单明细ui优化 2026-10-23 17:45:05 +08:00
yml2213 63ae32d18c refactor(finance): 成本模型与履约方式正交，拆分成本中心巨型文件 
后端：
- 删除 services/admin/admin-cost-center-service.ts（4,248 行），拆为
  services/cost-center/ 下 5 个模块：
  cost-center-shared（类型/枚举/归一化/映射/costModelScopeSql）、
  cost-center-overview（总览与选项）、
  product-catalog（商品与渠道映射）、
  template-bootstrap（模板引导、自动发货同步、工单证据回填）、
  cost-definition（成本项/版本/异常/预览/快照）
- cost_items.carrier_type / cost_type 改为单一 cost_model；专属模型只对
  对应履约方式生效，通用模型对所有履约方式生效
- cost_snapshots / cost_exceptions 删除载体列；按履约方式筛异常改用
  IN 半连接（248k 异常下 EXISTS 逐行回表 2.7s -> 170ms）
- sales_daily_facts.carrier_type -> fulfillment_mode
- 人工支出按 cost_model 归类；履约方式只读 order_items.fulfillment_mode
- 移除 syncOpenCostExceptionCarrierTypes：异常表已无载体列可同步

前端：
- AdminCostCenterPage.tsx（2,887 行 -> 18 行转发），拆为
  pages/admin/cost-center/ 下 8 个 Panel + shared + CostCenterContext
- CostCarrierType 删除；新增 FulfillmentMode / ProductSource / CostModel
- 销售毛利页 carrierType -> fulfillmentMode

同步补两个索引：idx_order_items_fulfillment_id（异常半连接）、
idx_work_categories_name（商品目录分类 lateral join）。
 2026-10-23 16:06:25 +08:00
zhaoxing bfd2325ac5 add:新增同一个工单同一人可以多次拼单 2026-10-23 14:26:41 +08:00
yml2213 74b62f3494 feat(finance): 订单页人工录单按单实际金额计入成本 2026-10-22 19:48:56 +08:00
yml2213 7c8832078f feat(finance): 接单模板发单金额落规则级成本版本 
此前接单平台成本版本只有 sys_work_order_reward 的全局 0 元占位，662 个模板的发单金额从未进入 cost_versions。\n\n现在为 662 个模板各生成一条规则级版本：634 条固定发单金额 + 28 条按件单价；全局 0 元版本仅作“按工单实际结算”占位。成本版本页新增“用户实付均价”和“平均实发/项”，支持按模板名称/规则键搜索，按商品筛选也能命中规则版本。\n\n历史工单快照关联到对应模板版本；模板保存时自动同步单条成本版本；删除模板会先把历史版本脱钩停用，保留快照可追溯。\n\n新增迁移 112 覆盖索引，用户实付聚合从约 1.1s 降到约 150ms。
 2026-10-22 19:29:53 +08:00
yml2213 72e1141c8a feat(finance): 补齐自动发货与接单平台成本和对账 
自动发货：价格导入支持 --effective-from，把首次基线版本回填到历史起点；41,676 个订单项全部归一并生成采购成本快照，缺失 0。\n\n接单平台：新增按工单 product_rule_id 回填商品的接口与按钮，长尾项按 provider+shop_id+sku_code+normalized_sku_name 补建 wo: 商品和 sku_code_name 渠道映射；118,053 个订单项全部归一。\n\n成本：已验收工单按 reward_amount 写 actual；未验收但已确定报酬的工单写 estimated，验收后升级。全量 95,870 actual + 21,217 estimated，actual 与 reward 0 差异。\n\n剩余 966 条取消/零报酬工单保留在成本异常队列，不自动记 0；人工块未改动。\n\n实测自动发货与接单平台未归一收入均为 0；整体未归一 79.67% 降至 57.54%，全部来自人工块。
 2026-10-22 18:59:53 +08:00
yml2213 54d2eb2f59 feat(finance): 自动发货订单项按上游 SKU 直接归一 
自动发货只有 affiliate-dash 单一上游渠道，订单项直接按 fulfillment_tasks.context_json.skuCode 归一为 aff:<skuCode>，不写 channel_product_mappings。\n\n新增 /cost-center/affiliate-products/backfill：按 order_item_id 取最新任务 SKU 回填 canonical_product_id，只更新有变化的订单项，并自动重算受影响日期的销售事实；返回 updatedCount/skippedCount/remainingCount。\n\n自动发货 SKU 列表改为实时统计履约任务数与最近履约时间，不读会被价格导入覆盖的 attributes_json。\n\n本地实测 41,676 个订单项全部归一，自动发货未归一收入 5,089,712.26 元降至 0；整体未归一占比 79.67% 降至 60.47%。
 2026-10-22 18:41:31 +08:00
yml2213 0889235870 feat(finance): 完成成本快照运行层、销售事实与人工支出登记 
迁移 108-111：快照业务时间与预估转实际、销售事实表、系统成本项、公司人工支出登记。接单平台按工单实际 reward 入账；人工支出支持登记/审批/驳回/报销并写 actual 快照。新增销售毛利页、人工支出页与订单入口。
 2026-10-22 16:41:03 +08:00
yml2213 39cf14ed7a merge: 同步 main 最新到 dev（接单平台店铺筛选） 2026-10-22 15:30:38 +08:00
zhaoxing 067d54fdd8 接单平台：新增店铺筛选条件 2026-10-22 14:45:40 +08:00
yml2213 b520a078b0 feat(cost-center): 商品与成本按履约载体分区，补充分页与删除能力 
- 新增迁移 107_product_catalog_carrier：product_catalog 增加 carrier_type，
  自动发货只认 fulfillment_tasks.executor_key='affiliate_dash' 的履约证据
  （28 个上游 SKU），接单模板商品统一归为 work_order（662 个）
- 页面按「全部 / 自动发货 / 接单平台 / 人工客服 / 共用成本」分区；
  自动发货只展示自动发货 SKU 列表与采购成本，不展示商品目录/渠道映射
- 新增「同步自动发货商品」接口与按钮，按 aff:<skuCode> 幂等补建
- 列表统一接入公共分页 buildAdminTablePagination，支持 10/20/50/100 每页条数
- 标准商品、自动发货 SKU、渠道映射、成本项目、成本版本支持删除，
  带引用保护（映射/版本/快照/订单/接单规则）与生效版本先停用约束
 2026-10-22 14:05:34 +08:00
yml2213 3e73289e31 merge: 合并 main 到 feat/cost-center-wip（同步抖音券、设备认证与图标等最新改动） 2026-10-22 12:40:18 +08:00
yml2213 040100f290 feat(dcauth): 新增后台手机号与设备认证登录 
登录链路改为账号密码 + 短信验证码 + DCAuth 设备签名，并新增后台手机号绑定、
登录日志、设备绑定与重置接口。
 2026-10-21 20:46:24 +08:00
yml2213 111bc76357 feat(cost-center): 成本中心与商品映射开发草案 (含文档与订单页调整 WIP) 2026-10-20 10:01:52 +08:00
yml2213 7542d547bf feat: 新增客服备用金台账与后台用户中文显示名 
- 新增备用金账户、流水、支出、对账与权限
- 后台用户支持中文显示名并同步备用金姓名
- 审计、登录记录、任务及工单操作人优先展示中文名
- 补充备用金与人工支出方案文档
 2026-10-18 13:55:24 +08:00
yml2213 10464fea89 refactor(product-match): 抽离接单模板匹配引擎（来源适配器/引擎/价格收口 + 后台按订单项试匹配） 
新增 services/product-match：来源适配器（kuaishou-91 合成 91+快手 / pdd / douyin-mashida）+ 平台无关匹配上下文 + 条件打分引擎（并列最高=ambiguous 不猜、逐维诊断）+ 价格数量拼单唯一实现。

- 商店键命名空间化（kuaishou:/pdd:/douyin:），店铺为可选作用域：留空即可按订单信息匹配
- 抖音匹配文本只取内部 SKU，引流标题只进 promoTitle，itemTitle 恒空（修复 0.85 元误命中碎梦浮光珍宝礼盒、拼单未开）
- work-product-match-mappers 改为门面（签名不变），work-order-pricing 改为转发
- 新增后台「按订单项试匹配」接口与面板：走发单同一套链路，返回模板/数量/单价/总额/拼单
- 生产样本回放：91/PDD 6000 条决策 0 差异；抖音 5 条全为修正

设计见 docs/接单模板匹配引擎重构设计.md
 2026-10-14 15:58:21 +08:00
yml2213 5a73fb74a9 feat(douyin-mashida): 新增抖音券核销后台界面（列表/核销/冲正/同步/对账/作废） 
抖音订单并非纯自动发货：内部 SKU 命中 AFFILIATE_DASH_SKU_MAPPING 才走自动通道，
未命中显式回落人工，且核销依赖买家自己到 /redeem 输订单号。此前核销侧在后台完全
不可见：自动核销是 void .catch(warn) 只落日志，cancelVerify 出网方法已就绪但没有入口。

照快手电子凭证的骨架做一套抖音版（两张表两套状态机，不复用）：
- 券码状态、平台侧状态、同步错误全部可视化，支持只看同步失败
- 核销/冲正/重新同步/平台对账/重发券码/作废，每个写操作都带审计
- 券码列显示「核销实际会用的券码」（platform_cert_no 优先），平台改过名时额外标注
- 冲正先打平台 cancelVerify 再回退本地，避免本地与平台状态漂移
 2026-10-12 19:45:06 +08:00
yml2213 9ce29964c7 style(frontend): 格式化前端代码并修复 eslint 异步操作未标记告警 
- 统一 prettier 代码风格；
- 为 AdminTaskDetailPage 与 AdminTasksPage 中未捕获的 Promise 添加 void 标记；
- 验证方式：npm --prefix apps/frontend run check 全流程通过。
 2026-10-11 15:20:54 +08:00
yml2213 d8ce40e346 feat(douyin-mashida): 彻底重构优化配置面板，支持一键填域名/订阅推送/网关自检并剔除冗余字段 
- 剔除历史旧卡券时代废弃的 afterVerifyLink（去使用链接）与 afterVerifyMessage（通知正文）
- 面板新增一键填入当前域名、向开放平台一键订阅推送、停用推送以及网关连通与签名自检功能
- 业务配置重构为「基础接入与商户凭据」、「买家 H5 直充与发货私信」、「高级网关设置」三层清晰结构
- 后端与前端服务新增 /douyin-mashida/subscribe 与 /douyin-mashida/test-gateway 统一接口

验证方式：前端类型检查与打包构建通过，全量 132 项前端单测与 674 项后端单测全部通过
 2026-10-10 20:05:46 +08:00
yml2213 412d219cca feat(claim): 支持固定H5订单号领取与订单兑换有效性后台控制 
- 数据库新增 099_order_claim_status.sql 迁移，扩展 claim_status、claim_status_reason 等字段
- 后端新增 /claims/h5/:orderNo、UID提交、分销提交接口，保留原有 token 接口双轨兼容
- 增加兑换有效性强拦截：暂停/关闭/退款/取消订单精准阻断并返回友好提示
- 后台新增 POST /admin/orders/:orderId/claim-status 接口与审计日志记录
- 前端管理后台（订单列表、详情页）支持 H5 兑换状态展示、一键复制链接及暂停/关闭/启用弹窗
- 前端领取页面适配 /h5/:orderNo 路由及暂停/关闭等状态的异常展示
- 验证方式：运行前后端类型检查、全量单元测试（后端 674、前端 132）及全量构建编译均通过
 2026-10-10 18:05:46 +08:00
yml2213 85fc2eaa7c feat(worker-platform): 支持后台人工调级锁定等级与解除自动升级限制 
- 做了什么：
  1. 新增数据库迁移 098_worker_level_lock.sql，在 worker_users 表增加 is_level_locked、level_locked_at、level_locked_reason、level_locked_by 字段；
  2. 后端自动升级函数 maybeUpgradeWorkerLevelWithClient 和判定函数 shouldApplyAutomaticWorkerLevel 增加 is_level_locked 守卫，被锁定的打手跳过自动升级；
  3. 后台打手审核调级服务 reviewAdminWorkerUser 支持等级锁定参数与变更记录，人工调级时自动写入 worker_level_logs 流水，并提供 updateAdminWorkerLevelLock 专用接口；
  4. 前端打手列表等级列展示「已锁定」状态及 Tooltip 原因，调级弹窗支持「锁定自动升级」开关与原因输入，操作列提供「解除限制」快捷操作；
  5. 打手详情抽屉补充展示等级锁定说明。
- 为什么：
  解决打手被人工调整等级（如 VIP5 调至 VIP4）后，因历史累计完成单数满足门槛导致后续结算再次自动升级回高等级的问题，并支持后续随时解除限制恢复自动升级。
- 验证方式：
  1. 后端新增 shouldApplyAutomaticWorkerLevel 与 mapWorkerUser 单元测试，运行 npm run check（670 测试全过，类型与 SQL guard 验证通过）；
  2. 前端新增 worker-level-lock.test.ts 单元测试，运行 npm run check（130 测试全过，typecheck 与 build 验证通过）。
 2026-10-10 13:44:57 +08:00
yml2213 1339c6887e refactor(claim): 删除自建皮肤领取页，路径式 /claim/<token> 复用现成领取页 + 物品图片 
**删掉上一轮自建的领取页**
- `pages/claim-skin/*`、`services/claim-skin.ts`、`types/claim-skin.ts`、`tests/claim-skin.test.ts`
  及其样式（client.css 里 `.claim-skin-*` 整段 254 行）
- 后台我加的展示项：「皮肤自动发货」筛选项、执行器标签、「买家提交信息」卡片

**路径式链接复用现成领取页**
- `utils/claim-path.ts`（中性命名 `isClaimPath` / `resolveClaimToken`）+ 单测
- `App.tsx`：pathname 命中 `/claim/<token>` → 独立 BrowserRouter 渲染**现成的 `ClaimPage`**
  （页面零复制零改动：它只用 `useParams`，不读 hash）；`#/claim/:token` 仍走主站 HashRouter，
  两者互不影响，且有用例断言 hash 入口不命中路径判定

**物品图片**
- 后端领取详情的 `product.imageUrl` 接上（内部 SKU 在 `spec_json.code` / `sku_code` /
  `sku_name` 哪个字段都能回退找到图，映射不到返回空串）
- 领取页新增 `ClaimProductImage`：居中大图（宽度 min(220px,62%)、圆角 16px），
  空值或加载失败都降级虚线占位块，不出现破图

`npm run check`：前端 128 / 128 全绿（去掉旧用例 17 个、新增路径与图片用例）
 2026-10-09 16:13:46 +08:00
yml2213 eacca11768 feat(claim-skin): 买家皮肤领取页（路径式 /claim/<token>） 
买家从卡券/订单消息里的链接打开，看到物品图片与信息，填游戏账号即可领取。

- **路径式无 `#`**：新增独立 BrowserRouter 分支（照 `/redeem` 的做法），
  `isClaimSkinPath` 只认 `/claim/<token>` 两段精确匹配；
  打手领取页仍是主站 HashRouter 的 `#/claim/:token`（其 pathname 为 `/`），两者互不影响
- **物品卡片**：商品图（映射不到或加载失败都降级为占位块，不出现破图）、
  内部 SKU、数量 ×N、订单号、引流标题（灰色副信息）
- **领取表单**：按接口下发的 `claimFields` 动态渲染（游戏账号/角色ID），
  提交前二次确认让买家核对账号
- **状态**：待领取展示表单；已领取展示成功态（优先于 tokenStatus）；
  token 失效/过期/关闭/已用分别给中文提示与联系客服引导
- 纯函数抽到 `utils/claim-skin.ts` 并补 20 个单测（路由判定、状态映射、字段校验、格式化）
 2026-10-09 15:06:56 +08:00
yml2213 8c33ff62ec feat(redeem): 固定兑换链接 /redeem（输入订单号 → 状态分流 → 兑换） 
- 路径式入口 `https://<域名>/redeem`（不带 #）：主站是 HashRouter，
  故在 App.tsx 里早于 isWorkerSite() 插入独立 BrowserRouter 分支，
  主站与打手站路由均不受影响；Caddy 已有 try_files 兜底，无需改部署
- 页面按 7 种状态渲染：not_found / unpaid / cancelled / refunded /
  pending_certificate / redeemable / verified
  - not_found 保留用户输入的订单号，不清空
  - pending_certificate 只给显式「刷新」，不做自动轮询（公开限流接口，避免空转）
  - verified 只展示后端已掩码的券码，绝不渲染明文 certNo
  - confirm 不假设成功：一律按返回的 status 重渲染
- 纯函数抽到 utils/redeem.ts（无 React/antd、无 @ 别名），可直接跑单测
 2026-10-09 12:01:35 +08:00
yml2213 080480f03b feat(admin): 后台新增「抖音码速达」配置面板 
- 新增 Tab：/admin/platform-shops?tab=douyinMashida
- 面板字段：enabled / baseUrl / uid / secret / certLink / afterVerifyLink /
  afterVerifyMessage / messageType / timeoutMs / handledTopics(tags)
- 密钥脱敏：出参 secret 永远为空，输入框未编辑时对外 value 恒为 ''，
  掩码不会污染后端「空串=保留原值」语义
- 顶部展示 ready 状态，未就绪时用 Alert 列出缺哪几项；
  始终展示平台侧要配的推送地址（可复制）
- baseUrl 命中本地地址时提示「当前指向本地网关桩，不会请求真实码速达」
- 把 AdminPlatformShopsPage 内联的 SecretFieldControl 抽成共享组件
  （函数体与原实现逐字节一致，8 处既有调用点参数不变）
 2026-10-09 12:01:29 +08:00
yml2213 78c676d2b9 feat(worker-risk): 风控后台页面（可调阈值/实时状态/事件留痕/人工封禁解封），并修复解封后仍被 403 的 bug 
## 修复的 bug（生产已发生）

风控三级封号把 tracker.banned 置为 true 后，banned 检查发生在鉴权之前，
而它只存在于进程内存。后台把账号改回 active 时数据库变了、内存没变，
于是账号在库里已经正常、请求却永远 403，只能等容器重启才恢复。

修法两道：
- **数据库是唯一事实来源**：banned 改为带 30 秒 TTL 的缓存，到点回查
  worker_users.status；已解封（或账号已删）则清除标记并放行。
  对被判 banned 的 key 最多每 30 秒查一次，即便对方仍以 65 QPS 刷也只是
  每 30 秒一次查询。查询失败时**保守维持封禁**，不因数据库抖动放行刷子。
- **后台改状态时主动释放**：review 只允许设 active/rejected/disabled/pending_review
  （没有 frozen），所以走到那里就意味着不再由风控冻结，直接释放内存状态。

顺带修掉一个连带缺陷：解封时只清了 violationCount，没清滑动窗口计数，
账号刚恢复就会被上一轮残留的 windowCount 立刻限流、并在 60 秒内二次封禁。
现在整轮窗口状态一并清零。

## 新增后台页面

接单平台 → 风控（/admin/worker-platform?tab=risk-control），三块：
- 阈值配置：6 个阈值可视化编辑，落 app_config_entries，保存即热生效，无需重启
- 当前实时风控：进程内存状态（已封禁/惩罚中/仅记录），支持人工解封、封禁、仅释放内存状态
- 风控事件留痕：worker_risk_events 分页查询，可按类型/IP 筛选

## 关键取舍

只记**显著事件**（二级惩罚、三级封号、人工处置），不记每一次被拒请求。
被刷时实测 45~65 QPS，按请求写库正是最初要解决的问题。实时计数仍走进程内存。
事件写入为 fire-and-forget 并吞异常，留痕失败绝不影响大厅请求。

## 验证

- 新增 6 个用例覆盖解封立即生效、对账自愈、TTL 不重复查库、对账失败保守维持、阈值可配置
- 迁移 089 已在临时库实测：表结构/4 索引/CHECK 约束/外键均正确，非法 event_type 被拒
- 后端 557 测试 554 通过 0 失败；前后端 typecheck/lint/format/build 全绿
 2026-10-02 17:05:25 +08:00