Commit Graph
133 Commits
Author SHA1 Message Date
yml2213 0a595acfa9 feat(fulfillment): 增加未命中渠道兜底核销 2026-11-06 19:21:41 +08:00
yml2213 df7f651542 fix(cost-center): 修复启用人工作废商品配置 2026-11-06 17:14:55 +08:00
yml2213 a333c05df4 fix(fulfillment): 收口渠道商品与统一结算边界 2026-11-06 17:12:44 +08:00
yml2213 e6b3835c9f feat(cost-center): 收敛第三方卡券商品与成本链路 2026-11-06 16:47:45 +08:00
yml2213 974044a4c6 refactor(cost-center): 收敛人工 SKU 自动创建流程 2026-11-06 16:37:29 +08:00
yml2213 eef4cc1673 feat(fulfillment): 自动核销任务展示并搜索核销码 2026-11-06 10:47:45 +08:00
yml2213 bd7dd4efcc feat(fulfillment): 建立正式履约影子模型 2026-11-05 21:07:11 +08:00
yml2213 b424333a30 refactor(fulfillment): 收敛配置与商品关联写入 2026-11-05 21:01:11 +08:00
yml2213 fcd0c137d5 feat(fulfillment): 收敛履约状态写入口并追加状态事件 2026-11-05 20:52:22 +08:00
yml2213 ca214854bb feat(fulfillment): 固化当前尝试与历史自动化边界 2026-11-05 20:25:48 +08:00
yml2213 ed450fac79 feat(fulfillment): 建立履约统一状态视图与分类队列 2026-11-05 20:13:34 +08:00
yml2213 e8b76b3b73 fix(fulfillment): 修复载体重试并完善核销任务列表 2026-11-05 18:36:10 +08:00
yml2213 89a68b5734 fix(fulfillment): 统一渠道规则与标准商品绑定 2026-11-05 18:17:12 +08:00
yml2213 4e83dbb84c feat(fulfillment): 增加统一结算与多渠道人工履约 2026-11-05 16:14:56 +08:00
yml2213 92ceb9697b feat: 支持第三方卡券收到订单后自动核销 2026-11-05 15:19:39 +08:00
yml2213 1df88cc639 feat: 完善履约路由、订单服务与自动核销 2026-11-05 14:59:58 +08:00
yml2213 c31fa7db76 feat(fulfillment): 支持删除待分类和强制删除渠道规则 2026-11-04 13:52:11 +08:00
yml2213 6e4758a3c7 feat(fulfillment): 增加待分类订单重试接单匹配 2026-11-03 16:01:44 +08:00
yml2213 efe706e601 feat(cost-center): 人工 SKU 配置自动同步商品与订单 2026-11-03 15:37:14 +08:00
yml2213 eeb9fada63 feat(fulfillment): 增加统一渠道配置搜索与筛选 2026-11-03 14:32:44 +08:00
yml2213 bcf5eb09ec fix(fulfillment): 持久化订单项已配置快照 2026-11-03 14:10:58 +08:00
yml2213 b3fb330ad9 fix(fulfillment): 优先用平台字段映射中文SKU 2026-11-03 12:40:50 +08:00
yml2213 ac3bb1f686 fix(fulfillment): 冻结已分配订单的内部SKU事实 2026-11-03 12:38:40 +08:00
yml2213 e6763882f5 fix(fulfillment): 封堵重复载体并完善统一SKU映射 2026-11-03 12:28:05 +08:00
yml2213 3ba808b814 feat(fulfillment): 统一中文内部 SKU 履约路由 2026-11-03 11:49:38 +08:00
yml2213 4dc2f5ca90 fix(claim): 统一所有买家领取链接为 H5 订单号格式 2026-11-02 22:11:22 +08:00
yml2213 3989b0a649 fix(admin): 修复履约渠道分页并统一列表分页状态 2026-11-02 19:49:31 +08:00
yml2213 d871b93fde feat(admin): 增加履约渠道批量删除并统一分页配置 2026-11-02 17:31:55 +08:00
yml2213 55e3c4e21b test(fulfillment): 清理履约集成测试生成数据 2026-11-02 15:49:33 +08:00
yml2213 6bf28489e0 fix(finance): 重写履约路由迁移与统一渠道配置
重写 120/121 迁移,统一内部 SKU、渠道 id、config_json 和旧规则转换。

后台渠道配置改读统一渠道表,卡券与人工配置不再写旧规则。

增加安全渠道切换,并排除已关闭、失败或过期的历史任务载体。

按生产 119 基线重跑迁移、完整履约财务链路和严格预检。
2026-11-02 15:29:13 +08:00
yml2213 2f87445ed9 fix(finance): 收敛内部 SKU 履约路由与载体状态
统一内部 SKU 与渠道主/兜底解析,禁止并列主渠道。

运营指定渠道改为先创建真实载体,失败保持明确 pending。

历史缺载体、多载体冲突和自动发货兜底统一由管道修复。

迁移人工配置与旧 sku_code 规则,补充严格预检和集成测试。
2026-11-02 15:02:49 +08:00
yml2213 5fe33b0b46 feat(finance): 统一内部 SKU 驱动的履约与财务分流
- 新增 internal_sku_mappings / internal_sku_channels,平台字段统一映射到内部中文 SKU
- 下单入口按内部 SKU 渠道决策修正默认人工路由,自动发货补全 dash sku
- 财务 channel_assign 读取统一渠道表;卡券/人工能力兜底,自动发货/接单要求真实载体
- carrier reconciliation 自动补自动发货任务和接单工单
- pending 落明确原因:无内部 SKU / 无渠道能力 / 无履约载体
- 合并、重判、旧 sku_code 规则清理、部署后 preflight 核对脚本
- 待分类队列按内部 SKU 聚合并展示原因
2026-11-02 14:17:08 +08:00
yml2213 531a23d78b feat(finance): 下单入口补内部 SKU,卡券/人工按商品能力兜底
- 纯数字/空内部 SKU 入口查 internal_sku_mappings,补 spec.skuNick
- 快照记录 internalSku/source,便于审计
- 财务 channel_assign 对卡券/人工使用商品渠道能力兜底(source=auto_mapping)
- 自动发货/接单仍要求真实任务/工单载体,避免只改口径
2026-11-02 13:52:40 +08:00
yml2213 a501f9f2e0 feat(finance): 内部 SKU 平台字段映射基础
- 新增 internal_sku_mappings,支持 provider/shop 级和全局映射
- 新增解析与 upsert 服务,priority/精确范围优先
- 新增纯数字内部 SKU 的中文映射回填脚本(默认 dry-run)
2026-11-02 13:49:31 +08:00
yml2213 03566aee2b fix(finance): 待分类队列按内部中文 SKU 去重与分流
- 同一内部 SKU 的不同平台 SKU 合并为一行(显示平台 SKU 列表)
- 指定渠道按 internal_sku 批量更新,并生成 internal_sku 规则
- 渠道候选的 internal_sku 优先取中文 manual_sku_key/sku_name
2026-11-02 13:32:05 +08:00
yml2213 3c4c81003f feat(finance): 商品渠道能力、自动发货转人工与成本异常收口
- 商品可同时支持自动发货/人工,新增渠道能力与成本冲销字段
- 卡券缺商品时按内部中文 SKU 自动建 tpv: 商品并补渠道规则
- 自动发货失败转人工并冲销原渠道成本
- 配置成本后按最早缺失订单生效并立即补算、关闭异常
- tpv: 商品来源计入第三方卡券
2026-11-02 13:17:15 +08:00
yml2213 fd6d2d561b feat(pipeline): 渠道判定后立即归一商品并算成本
- 新增按订单项定向归一,避免新判定订单等冷通道
- 判定/指定渠道后立即归一 → 算成本 → 按业务日回填事实与总账
- 提取 refreshFactsForDates 供管道与渠道服务复用
2026-11-01 15:21:53 +08:00
yml2213 fca836eb4b feat(cost-center): 卡券商品创建即生成渠道规则,补齐成本项预设
- 新建 tpv: 商品时自动写 third_party_voucher 规则,避免新卡券 SKU 停在待分类
- 成本项预设新增「第三方卡券采购成本」
2026-11-01 14:46:14 +08:00
yml2213 a62f6e1ec8 fix(pipeline): 变更按业务日回填,异常自动收口,载体管道加游标
- 渠道判定/成本快照返回受影响业务日,任务按日重算事实与总账
- 人工配置或载体补齐后,manual_config_missing / carrier_missing 自动关闭
- carrier_dispatch 使用水位游标,避免每轮从 id=0 重扫
2026-10-31 20:41:43 +08:00
yml2213 6cd6401eca refactor(finance)!: 事实维度与接口字段统一改名 channel
- migration 114 将 sales_daily_facts.fulfillment_mode 重命名为 channel
- DTO/查询参数/前端类型从 fulfillmentMode 统一为 channel
- 成本中心类型 FulfillmentMode 更名为 FulfillmentChannel,并补齐卡券/待分类/归档取值
- 销售事实响应分组改为 byChannel
2026-10-31 20:26:15 +08:00
yml2213 d979ef50d6 perf(pipeline): 订单项管道改用水位游标并只扫缺失
- 新增 watermark-store:统一读写游标/日水位/失败原因
- 渠道判定、商品归一、成本快照从上次游标继续,到表尾后回绕重试
- 成本快照只处理没有有效快照的订单项,避免每 5 分钟全量重扫
2026-10-31 20:17:33 +08:00
yml2213 0ce3c8fa97 feat(fulfillment): 渠道联动与管道兜底
- 人工配置保存/删除同步渠道规则,人工确认写 channel/status
- 按 SKU 指定渠道默认同时落规则
- 管道补充:载体缺失、人工成本未记录、事实与总账按水位追赶
2026-10-31 19:52:22 +08:00
yml2213 65b7f4f9dc refactor(finance)!: 强制渠道模型,移除旧履约方式与同步链路
- 删除 fulfillment_mode 相关的旧同步/回填链路与定时任务
- 删除 cost_finance_sync、成本快照同步、人工商品归一等遗留服务
- 迁移 113 直接删除 order_items.fulfillment_mode 及其索引约束
- 断代脚本自带归档步骤,不再依赖独立回填脚本
- 退款/事实/总账统一走渠道版销售事实
2026-10-31 19:52:03 +08:00
yml2213 8cdc2423d5 feat(fulfillment): 新增渠道判定管道,规则优先、载体证据兜底
- 只写 channel/status/source,不再由「有没有任务」反推渠道
- 同优先级多渠道判为冲突并保持 pending,进配置冲突队列
- 运营指定渠道即锁定,自动判定不再覆盖
- 待分类队列按 SKU 聚合,支持按 SKU 批量指定
2026-10-31 18:12:06 +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 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
yml2213 5d1ba11523 feat(finance): 统一履约事实并改造人工账单分类 2026-10-23 13:35:48 +08:00
yml2213 4b081d88c5 feat(douyin-mashida): 抖音按 SKU 三层分类接入(对齐 91/快手)
- sku_code 恒为内部 SKU(不再被英文 sku 覆写);英文 sku / 引流标题分别落 snapshot
- 命中映射 → affiliate_dash;未命中不再兜底 manual_dispatch(无执行载体 = 待人工,不建任务)
- 抖音映射支持「常量表 + 后台 skuMapping 增量」,新增商品不必发版
- 载体唯一守卫:命中自动发货的订单项不再建工单
- 券 cert_link 与命中解耦(/h5 一律按订单号拼);券写入工单 material_json.douyinMashidaVoucher
- 新增/修正 16 例单测;后端全量 717 例 / 0 失败
2026-10-14 13:00:49 +08:00
yml2213 4fce07a621 refactor(douyin-mashida)!: 纠偏——删掉自建的皮肤通道,改回复用 affiliate_dash
上一轮我把皮肤交付做成了「另建一套执行器 + 独立领取接口 + 只提交账号就结束」,
跟买家实际要走的过程不一致(真正的完成信号是「扫码绑定后的 UID == 买家填的 UID」),
而且核销还触发了老通知逻辑,给买家**又发了一条 /redeem** —— 买家收到两条链接。
本次按用户要求改回**完全复用仓库现成的 affiliate_dash 通道**(= 旧的快手皮肤自动发货)。

**删掉**
- 执行器 `douyin_mashida_skin`(含 registry/types/planner/bootstrap/路由白名单注册)
- `services/claim/claim-skin-service.ts`、`routes/claim-skin.ts`、`/api/v1/claim-skin` 挂载
- 迁移 096 的 `claim_submission_json` 全链路(task-repo / rows / inputs / task-detail /
  admin-read-service 的 claimSubmission),并新增 **097 兜底迁移**把该列 DROP 掉
- 顺带清掉上一轮专为已删接口加的死代码(utils/http.ts 的 buildMessageSuccessPayload 等)

**改回复用**
- `resolveOrderItemClaimLink`:通用解析(只看订单项、不看执行器)→
  `buildConfiguredClaimUrl(claimLinkBase, token)`;多履约单元取 task id 最小并告警;
  **绝不回退** hash 形态的 `buildClaimUrl`
- `cert_link` 与付款后那条**唯一**消息共用同一个解析结果
- **核销后不再给抖音买家发第二条消息**(`shouldNotifyBuyerAfterVerify` 只放行非抖音 provider)
- 买家侧走既有流程:输 UID → 二维码 → 扫码绑定 → 比对 UID → delivered/REDEEMED;
  在 delivered 分支 best-effort 核销平台券(幂等、失败只 warn,不拖慢买家响应)
- 后台回显链接改按 **order.provider** 判断(抖音用 `claimLinkBase`)

**SQL 守卫**:允许「删除历史迁移」,但强制要求「同时新增兜底迁移」配对
(修改历史迁移仍禁止),并把改动来源换成 `git status --porcelain`(否则未跟踪的新迁移看不见)

`npm run check`:tests 671 / pass 668 / fail 0 / skipped 3(含新增的物品图回退用例)
2026-10-09 16:13:39 +08:00
yml2213 56ad06239b fix(fulfillment): 抖音未命中皮肤映射时显式回落人工,避免静默漏单
原本未命中的抖音订单项只靠全局 `unmatchedExecutorKey` 兜底,而线上/联调环境该值
可能是空串(dev 库实测就是 `unmatchedExecutorKey=''`)——那种配置下未命中的抖音订单
既不建履约任务、也不进人工,等于**静默漏单**(需求要求的是「接单平台走人工」)。

改为在抖音分支里显式指定回落:命中权威映射 → `douyin_mashida_skin`;
未命中 → 直接以 `preferredExecutorKey=manual_dispatch` 选中人工通道,不依赖全局配置。

实测(dev 真实配置,`unmatchedExecutorKey` 为空串):
  幸运币2个 / 套装-浪漫天命   → douyin_mashida_skin(isConfigured=true)
  代练上分-星耀到王者(未命中)→ manual_dispatch(isConfigured=true)
  空 SKU                      → manual_dispatch
  对照 91卡券/快手             → 行为不变(未配映射仍 isConfigured=false)
2026-10-09 15:09:58 +08:00