dachui/order_site
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,107 Commits 3 Branches 0 Tags
43f402cf72daa3ffb90f0340139343238efc0965
Commit Graph
1107 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
yml2213 43f402cf72 docs(finance): 现行财务文档收敛为 5 篇，履约口径只定义一次 
原 9 篇 3,647 行，履约分类口径在总纲、模型文档、交接总结里重复三遍，
且仍留着"三块履约""按小时人工成本"等已作废表述。本次收敛为 5 篇
1,778 行：

- 财务与履约口径总纲-2026-10-23.md（300 行）：唯一口径来源
  七条硬口径、三个正交维度、真实履约构成、成本模型规则、人工全覆盖、
  实施顺序、进度、验收 SQL、防回归清单
- 成本中心与履约模型.md（471 行）：数据模型、迁移 103–107、履约回填、
  销售事实、本地库原地改造、索引与性能
- 成本中心API契约.md（270 行）：字段替换总表、枚举、前后端模块边界
- 人工支出与备用金.md（218 行）：人工支出登记字段/状态机/权限 +
  客服备用金台账
- 财务系统集成方案.md：复式总账层（未实施）

旧的 4 篇（成本中心与三块履约模型、人工支出登记落地方案、
客服备用金台账实施方案、财务履约改造交接总结）移入
docs/archive/2026-10-23/ 并加归档提示。

履约分类判定 SQL 只在总纲保留一份，其它文档改为链接。
 2026-10-23 16:06:40 +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 5c549a2dc5 refactor(db): 12 个财务迁移合并重写为 5 个 
原 103–114 十二个迁移（1,087 行）分批落地，字段反复摇摆，且同一语义
（履约载体）在四张表各存一份，口径互相打架。本次整体重写为五个：

- 103_product_catalog：product_catalog 不再存载体，来源改由 canonical_sku
  前缀表达（aff: / tpl: / wo: / man:）；channel_product_mappings 直接
  包含 match_type 与 platform_sku_name_key
- 104_cost_center：cost_items 用 cost_model 取代 cost_type + carrier_type；
  cost_snapshots / cost_exceptions 删除载体列；pricing_mode 精简为
  per_item / per_order / percent_of_revenue（删除按小时与按天固定）
- 105_sales_daily_facts：carrier_type 改名 fulfillment_mode
- 106_manual_expense_records：合并原 111 与 113
- 107_order_item_fulfillment_mode：履约事实三列

核心口径：order_items.fulfillment_mode 是履约方式唯一真源；成本模型
与履约方式正交；核销码不参与履约判定。

本地库已按新 schema 原地改造（scripts/rewrite-local-db-2026-10-23.sql），
316,585 项四项计数与总纲一致，NULL = 0。
 2026-10-23 16:06:11 +08:00
yml2213 7557de6d60 docs: 校正分支提交数表述 2026-10-23 13:36:47 +08:00
yml2213 b629cd27d8 docs: 记录 P0 履约事实落地结果 2026-10-23 13:36:25 +08:00
yml2213 5d1ba11523 feat(finance): 统一履约事实并改造人工账单分类 2026-10-23 13:35:48 +08:00
yml2213 fb80cad695 docs: 统一财务与履约口径并新增总纲 2026-10-23 13:17:30 +08:00
yml2213 fac34c8420 feat(fund): 备用金账户编号改为带用户名的可读编号 2026-10-23 11:57:39 +08:00
yml2213 a7f60414a4 fix(finance): 客服只能使用自己的备用金账户 2026-10-23 11:44:04 +08:00
yml2213 2aeb789e20 feat(finance): 人工支出改为从客服备用金扣款 2026-10-23 11:31:47 +08:00
yml2213 cd9bb1419c fix(admin): 人工录单订单项只显示真实内部 SKU 2026-10-22 20:08:43 +08:00
yml2213 c38cd8ca2d feat(admin): 订单列表只展示平台判断 SKU 2026-10-22 19:55:13 +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 15989af87c merge: 同步 main 最新到 dev（游戏ID查询修复） 2026-10-22 15:33:30 +08:00
zhaoxing 72a758fd7c fix:修复问题接单平台使用游戏ID查询不到数据 2026-10-22 15:32:26 +08:00
yml2213 39cf14ed7a merge: 同步 main 最新到 dev（接单平台店铺筛选） 2026-10-22 15:30:38 +08:00
yml2213 f0c6960da7 merge: 合并 feat/cost-center-wip 到 dev（商品载体、成本中心、自动发货价格、分页与删除） 2026-10-22 15:19:59 +08:00
yml2213 aee0e4d1d2 docs: 同步财务进度、成本中心迁移号与 feat 分支状态 2026-10-22 15:19:53 +08:00
yml2213 78580c6165 feat(cost-center): 成本项编码改系统自动生成，补自动发货价格导入脚本 
- 新建成本项目不再手填编码：后端按成本类型生成基础编码（auto_purchase /
  work_order_reward / manual_service / platform_fee / payment_fee /
  after_sales_loss / shipping_other / other_cost），重复时追加 _2、_3；
  接口显式传 code 时仍优先使用，兼容脚本导入
- 前端移除编码输入框，改为说明提示，创建成功提示展示生成的编码
- 新增 scripts/sync-affiliate-dash-prices.ts + scripts/data/affiliate-dash-prices.json：
  按上游 38 条自动发货价格补建 aff:<sku> 商品，并按 cost_amount（分）生成
  scope=product 的按件成本版本；价格变化时停用旧版本再插新版本
- 自动发货商品同步与价格导入的 attributes_json 改为合并，避免互相覆盖
 2026-10-22 15:07:29 +08:00
zhaoxing 35259bd643 接单平台：新增店铺筛选条件,过滤快手店铺 2026-10-22 15:01:03 +08:00
zhaoxing 067d54fdd8 接单平台：新增店铺筛选条件 2026-10-22 14:45:40 +08:00
yml2213 0f7d9d4fad feat(cost-center): 记住载体/Tab 选择，补配置引导并优化表格列宽 
- 新增 usePersistedState：载体工作区与 Tab 存 localStorage（admin-cost-center:carrier / :tab），
  刷新后保持；存储值非法或 Tab 不适用于该载体时自动回退
- 成本项目增加配置说明与常用成本项模板（采购成本/打手报酬/人工成本/平台费/通道费/售后损失），
  成本项行新增「加版本」并按成本类型预选范围；成本项/版本弹窗补字段说明
- 商品与成本中心 8 张表统一 tableLayout=fixed，名称类列定宽 + 省略 + tooltip，
  表格最小宽度按列宽之和设置，避免名称列独占剩余宽度
 2026-10-22 14:36:56 +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 8f3babdabe chore(db): 成本中心迁移重编号到 main 之后（103–106），check:sql 允许纯重编号 2026-10-22 12:42:59 +08:00
yml2213 3e73289e31 merge: 合并 main 到 feat/cost-center-wip（同步抖音券、设备认证与图标等最新改动） 2026-10-22 12:40:18 +08:00
yml2213 33b220ae10 fix(dcauth): order_site 白名单补充生产域名 ks.khhao.com 2026-10-22 10:04:05 +08:00
yml2213 d94a648c80 style(admin): 格式化后台用户管理页 2026-10-22 09:21:06 +08:00
yml2213 7a03abf8a1 feat(ui): 新增运营后台站点图标并统一登录页品牌标记 
- 新增橙色渐变仪表盘图标（SVG / ICO / apple-touch-icon / 192 / 512）
- 登录页侧栏与移动端品牌标记改用同一 BrandMark
- index.html 补齐图标、theme-color 与页面描述，标题改为「运营后台管理中心」
 2026-10-21 22:10:33 +08:00
yml2213 ef36453694 feat(dcauth): 移除机器码，改用纯设备码认证 
- DCAuth 协议升级到 v2，签名原文只含设备码；客户端 2.0.0，旧版本返回 426
- 删除客户端机器码采集、后端 machine_code_* 字段与日志、后台机器码展示
- 102 迁移在生产执行前直接改为无机器码结构；SQL 守卫仅放行该文件
- Mock 短信不启用每日限额；修复慢电脑首次启动的协议转发竞态
- 新增 macOS DCAuth.app 打包脚本，注册 dcauth:// 协议，浏览器可直接唤起
 2026-10-21 20:46:25 +08:00
yml2213 cb916d7750 feat(dcauth): 新增常驻托盘客户端与版本显示 
Windows 改为单实例托盘常驻，协议唤起只弹一个确认窗口；补充 macOS 后台守护进程
与客户端版本显示。
 2026-10-21 20:46:25 +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 7bacb7d5eb docs: 重构项目文档并补充三块载体、成本中心与人工支出方案 
合并本轮全部文档改动（原 5 个 docs 提交压成 1 个）。

口径与索引：
- 新增 docs/README.md 文档总索引：三来源口径（91 + 快手 send-code = kuaishou-91）、
  「一个订单 = 骨架 + 买家凭证 + 一个执行载体」、成本只改一处、文档状态机
- 过期阶段文档移入 docs/archive/2026-10-08/（保留内容，不删除）

分析报告：
- docs/项目全量分析报告-2026-10-17.md：架构、五条业务链路、P0/P1/P2 风险与改进路线
- docs/载体判定与成本中心落地-复核与草案-2026-10-17.md：生产只读克隆量化、上一轮结论复核与 4 处修正

方案文档：
- docs/成本中心与三块履约模型.md：三块执行载体、标准商品、成本版本与快照、人工支出登记
- docs/财务系统集成方案.md：复式记账模型、分录表、分期落地
- docs/影子总账说明.md：影子期与转正期的边界、对账与转正标准

SQL 草案（docs/drafts/，未接入迁移）：
- 载体判定与人工块量化.sql：量化查询、carrier_type 判定与回填、守恒校验
- 成本中心与销售事实-DDL草案.sql：product_catalog / channel_product_mappings /
  cost_items / cost_versions / cost_snapshots / cost_exceptions / sales_daily_facts
- 人工支出登记-DDL草案.sql：manual_fulfillment_cases / manual_expense_records / manual_expense_events

业务口径确认（2026-10-17）：
- 收入 = 用户实付（orders.total_amount），与快手 paymentFen 数据核验 100% 一致
- 打手报酬 = 支出/成本（最终提现打款），按总额法
- 人工块以「支出可追溯」为先，SLA 监管延后
- 退款/仲裁暂未接入，先预留字段与反向冲正关系

三份草案已在一次性沙箱库按依赖顺序零错误应用（10 张新表、27 个 CHECK 约束）。
 2026-10-17 22:03:03 +08:00
yml2213 6850bc64ff feat(work-order): 发布并核销支持抖音券（按来源分流，抖音走 DYC 券核销） 2026-10-15 13:22:18 +08:00
yml2213 584b6f52aa fix(work-order): 问题单处置存在活跃拼单份额时禁止取消/退回大厅/重开 
生产实锤 WK26101503335487：客服对份额已提交的拼单母单走问题单处置-取消，
母单整单 cancelled 后份额验收/单人撤单全部被母单状态挡死，后台无补救入口。

- 抽出 getActiveWorkOrderShareCountWithClient 统一活跃份额统计口径
- resolveProblemWorkOrder 的 cancel/cancel_deduct/reopen 先过活跃份额防线
  （return_to_worker 不拦），返回结构改为 {order, failureReason}
- settleOverdueWorkOrder 复用同一统计函数，消除两份 COUNT 口径
- 服务层映射 409 work_order_problem_resolution_has_active_shares，
  文案引导客服先单独验收/单人撤单
 2026-10-15 10:34:43 +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 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 e8fbb28cf4 feat(claim): 人工履约单领取页只显示「人工处理中，请等待客服」 
未命中 AFFILIATE_DASH_SKU_MAPPING 的抖音单显式回落 manual_dispatch（人工），这类单没有
自动发货通道（无 claim token、无绑定二维码），但卡券 cert_link 仍指向 /h5/<订单号> 领取页；
原页面会让买家「输 UID」，提交后没有任何自动发货动作，属于误导买家。

- 后端 kuaishou-cloud-claim-context.ts：新增 MANUAL_FULFILLMENT_MESSAGE 与
  resolveManualFulfillmentMessage(executorKey)（manual_dispatch → 等待话术，其它执行器空串）；
  三个 payload builder 统一输出 manualFulfillment / manualFulfillmentMessage
- 前端 claim-snapshot.ts：输出 isManualFulfillment / manualFulfillmentMessage，
  progressText 同步显示等待话术
- 前端 ClaimPage.tsx：在「渠道已下线」之后、「输 UID」之前插入人工单卡片（只读 + 刷新状态），
  人工单不会自动轮询（无 expectedUid → 不安排下一次轮询）
- types/claim.ts：补齐两个可选字段；话术只在后端维护一份，前端只做兜底

验证：后端 npm run check（701 单测）与前端 npm run check（格式/lint/类型/143 单测/构建）全绿
 2026-10-13 13:53:00 +08:00
yml2213 319e082254 fix(douyin-mashida): 领取消息只发给有自动发货领取单元的单，人工单不再假发货 
根因：notifyBuyerClaimLink 对 `/h5` 形态的 claimLinkBase 走了一条捷径——只拼订单号
（`${base}/${orderNo}`）就发消息，跳过了「该订单项是否有自动发货领取单元」的校验。
领取 token 只由 affiliate_dash 执行器在建单时创建，未命中 AFFILIATE_DASH_SKU_MAPPING
回落 manual_dispatch 的人工单、以及自动准备失败的订单都没有 token，却照样收到
「您的订单已发货，请点击链接领取」（线上实测：非映射商品「套装-牛仔情诗」）。

- claim-link.ts：新增 buildDouyinMashidaBuyerClaimUrl（无自动领取单元一律返回空串 = 不发消息）
  与 isDouyinMashidaH5ClaimBase（/h5 形态判定收敛到一处）
- notify-service.ts：两种基址形态统一先 resolveOrderItemClaimLink 拿 taskId 作为「会自动发货」
  的证据，缺失则跳过并留痕「该订单项没有自动发货领取单元，跳过领取链接消息」
- claim-link.test.ts：补齐人工单不发消息、/h5 与 token 形态拼接、基址/订单号缺失等用例

验证：npm run check 全绿（prettier + SQL guard + eslint + tsc + 703 单测 + build）
 2026-10-13 13:48:58 +08:00
yml2213 7e197c9413 fix(frontend): H5 领取前缀整段接管，/h5 裸链接不再跳后台登录 
根因：公开路径判定原先只认「带参数」形态（isH5ClaimPath 只认 /h5/<orderNo>），
裸前缀 https://<域名>/h5（后台 claimLinkBase / certLink 的基址）判定不命中，
于是落回主站 HashRouter 被后台路由接管成
https://<域名>/h5/#/admin/dashboard 后台登录页。

- utils/claim-path.ts：isClaimPath / isH5ClaimPath 改为命名空间级判定（含裸前缀与多段路径），
  参数解析仍严格；新增 resolveH5ClaimOrderNoFromInput（纯订单号 / 整条链接 / 缺协议 /
  带后台残留 hash 都能取出订单号，只有前缀时返回空串）
- pages/claim/H5ClaimEntryPage.tsx：新增 /h5 领取入口页，买家输订单号或粘贴完整链接后
  跳 /h5/<订单号>，走与分享链接同一套领取流程
- App.tsx：H5ClaimApplication 接管 /h5 整段前缀（/h5 入口页、/h5/:orderNo 领取页、
  其它子路径回入口页）；useClearStrayHash 抹掉历史残留的 #/admin/dashboard
- tests/claim-path.test.ts：补齐裸前缀、相邻前缀 /h5x、粘贴链接解析等回归用例

验证：npm run check 全绿（prettier + eslint + tsc + 143 单测 + vite build）
 2026-10-13 13:42:06 +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 0dd26da4ee merge: 合并 dev 到 main (工单号前缀 WK + 检索侧 O/0 容错) 2026-10-12 16:51:21 +08:00
yml2213 cb064d7cd5 fix(worker-platform): 工单号前缀改 WK 并在检索侧容错 O/0，彻底解决「按工单号搜不到」 
## 线上定位到的真正根因

客服搜 `WO26101213031939` 搜不到，但用同单的平台号 `2628501763808879` 搜得到。
到生产库核对后确认：

- 库里真实值 `work_order_no = WO26101213031939`（hex 574f… = 字母 O），状态 pending_acceptance；
- 用字母 O 的 SQL 分支 → 1 行；用数字 0（`W026101213031939`）→ 0 行；
- 全库 127,906 单**全部**以 `WO` 开头、`W0` 开头 0 单、字母 `o` 只出现在第 2 位。

即：前缀里的字母 O 被输成数字 0（`WO` / `W0` 在界面字体里几乎无法区分），
落进通配符分支后必然为空 —— 与前面几轮的「筛选把单藏起来」是两个独立成因，
这也解释了为什么改筛选逻辑一直没解决。

## 修法

1. 生成端换前缀：generateWorkOrderNo 产出 `WK…`（K 与 0 不会看混），从源头消掉歧义；
2. 检索端同时兼容三种写法（历史 WO 号无需迁移）：
   - isWorkOrderNoLookupKeyword 放宽为 `^W[oOkK0]…`；
   - 新增 buildWorkOrderNoKeywordVariants：W0→[W0, WO, WK]、WO→[WO, W0]、WK→[WK]，
     SQL 分支对每个候选下发「等值 + 前缀」条件（仍是索引条件，不会退化成全表扫）；
   - 前端 isExplicitOrderNoSearch 同步（否则面板不清理筛选、实时补丁护栏也不生效）；
3. 顺手加一层归一化：NFKC（全角→半角）+ 去零宽字符，前后端同一口径
   （normalizeLookupKeyword / normalizeSearchText），覆盖「粘贴带不可见字符」这类同族问题；
4. 寄卖匹配弹窗的占位提示更新为 WK... / WO...。

## 验证

- 后端 npm run check 全绿：692 tests（689 pass / 3 skip），新增
  work-order-keyword-lookup.test.ts 直接断言 SQL 参数与「不得出现前置通配符」；
- 前端 npm run check 全绿：139 tests；
- 既有用例 worker-platform-repo.test.ts 的期望值同步为新形态（两条候选条件）。
 2026-10-12 16:51:08 +08:00
yml2213 26780c9a4b merge: 合并 dev 到 main (基础镜像源可配置 BASE_REGISTRY) 2026-10-12 16:33:54 +08:00
yml2213 56ca479c6b chore(deploy): 基础镜像源改为可配置 BASE_REGISTRY，并提前补齐 FROM 基础镜像 
## 修的是什么

线上部署卡死过一次：daocloud 加速源返回 502 Bad Gateway，整轮构建在 load metadata
阶段就失败，而服务器 daemon.json 里另外两个 registry-mirrors 完全帮不上忙。

原因是**显式写死的 registry 会绕过 daemon.json 的 registry-mirrors**：
Dockerfile 里 `FROM docker.m.daocloud.io/library/node:...` 属于显式指定 registry，
镜像列表对它就失效了，于是这个源成了构建的单点故障。

## 修法

1. 四个 Dockerfile（backend / frontend / backend-dev / dev-caddy）的 `FROM` 改用
   `${BASE_REGISTRY}`（registry 前缀语义），默认值 docker.m.daocloud.io 保持不变；
2. docker-compose.yml / docker-compose.dev.yml 的 `build.args` 接上
   `${BASE_REGISTRY:-docker.m.daocloud.io}`，并把 postgres / minio / node / caddy
   这几处 `image:` 也改成同一变量，整套编排只有一个换源开关；
3. 部署脚本：新增 resolve_base_registry()（读 .env 的 BASE_REGISTRY，缺省同 compose），
   --dry-run 的基础镜像 digest 预检沿用同一变量；
   新增 ensure_dockerfile_base_images()，在 pull_base_images 阶段把 Dockerfile 里
   `FROM` 用到的基础镜像提前补齐 —— 这类镜像不归 `docker compose pull` 管，
   本地缺失要拖到构建阶段才报错，且报错信息晦涩，看不出来是"源挂了"还是"代码写错了"；
   现在缺失时明确提示并给出换源/离线搬运两条排障路径；
4. .env.server.example 增加 BASE_REGISTRY 说明（推荐多源容灾时设 docker.io，
   走 daemon 的 registry-mirrors 列表自动故障转移）。

## 验证

- docker compose config：默认值下所有镜像引用与改动前逐字一致（不会触发重新下载）；
  BASE_REGISTRY=docker.1panel.live / docker.io 时全部引用正确替换；
- docker buildx build --call=check -f deploy/docker/backend.Dockerfile：Check complete, no warnings；
- deploy/ubuntu-deploy.sh bash -n 通过；
- 生产实测：预拉三个基础镜像后，buildkit 解析基础镜像 1s 命中本地镜像、不再访问远端。
 2026-10-12 16:33:45 +08:00