dachui/order_site
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
905 Commits 3 Branches 0 Tags
b666a9c951d331871f2209112292fd2f5fcbab76
Commit Graph
905 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
yml2213 b666a9c951 fix(consignment): 拼单份额验收收官补寄卖结算钩子 + 手动匹配弹窗三处复核遗留 
- acceptWorkOrderShareAndSettle 最后一个份额把母单转 accepted 的分支，
  此前不释放发布押金也不结算供货货款（两钩子只在统一验收里）：
  现在同口径补上；供货货款传 assignedWorkerId=0（拼单母单无单一接单人，
  份额打手已各自按 share_reward 结算，不会重复付款）
- 手动匹配弹窗：race_condition/unavailable/spec_mismatch/partial_requires_confirm
  四个错误码清空已选并自动重拉列表，数据过期不再死循环撞错
- 手动匹配弹窗库存侧：keyword+pageSize100 透传后端（原来 keyword 是死参数、
  只拉 50 条），300ms 防抖后端搜索；无供货打手时禁用指派选项并在提交前
  再拦一道（原来必 400 死路）；选中订单回显 workerId/workerName
- 凭证核销反馈抽共享 utils/voucher-consume，WorkOrdersPanel 与弹窗共用，
  口径不再漂移（弹窗顺带获得"已提前核销 N 张"提示）
- docs/寄卖系统优化方案.md 记录批次 V

后端 477（+4）/ 前端 50（+1）测试全绿，typecheck / lint / format / check:sql 通过
 2026-09-17 12:45:51 +08:00
yml2213 63837e473b fix(consignment): 复核修复——占库撞 080 CHECK 必 500、指派非卖家双付货款、手动匹配权限门控 
- 占库默认 allocation_status 从自由文本改为「已安排」，不再撞 080 的
  CHECK ('待安排','已安排')；加静态守卫测试（剥注释断言枚举内默认值）
- resolveConsignmentAssignRewardFen 加 assigneeIsSupplier：指派供货卖家本人
  → 报酬=结算价（货款走报酬渠道）；指派别的打手 → 报酬保持原值（货款走
  供货货款渠道），两条渠道互斥，封住平台双付；补行为级测试 + 调用点钉住
- 手动匹配两处入口（库存面板行内按钮、拦截弹窗 footer）统一按
  consignment.fulfill 门控，编辑/作废仍为 manage，与后端权限一一对应
- docs/寄卖系统优化方案.md 记录批次 U

后端 473（+3）/ 前端 49（+1）测试全绿，typecheck / lint / format / check:sql / build 通过
 2026-09-17 12:36:12 +08:00
yml2213 0476339ec4 fix(consignment): 手动匹配订单按钮点了不弹窗（弹窗挂错了位置） 
用户反馈：在库待匹配列表点「手动匹配订单」没有反应。

根因：上一批把手动匹配弹窗挂到了「编辑寄售物品」弹窗**内部**，外层弹窗未打开时
该组件根本没被挂载，点击只改状态、界面无变化。

- 弹窗移到面板顶层（与其它弹窗同级），点击即弹
- 新增静态守卫测试：断言手动匹配弹窗前面不能有未闭合的 Modal（即不能嵌在别的弹窗里）、
  按钮必须真的 setState、open 由该状态驱动；已验证该守卫能拦下错误写法
- 顺带补入口缺口：订单侧原先只在"检测到系统候选"的提醒弹窗里给入口，订单没有任何候选时
  反而进不去手动匹配 —— 工单行内新增常驻「手动匹配现货」（仅待指派/待补资料，
  与后端前置校验同口径）
- 已暂停匹配的现货点按钮会直接 409，改为按钮禁用并提示先打开「允许匹配」开关
- destroyOnClose → antd 6 的 destroyOnHidden（前者已废弃）

验证：前端 typecheck/lint/format/48 例测试/build 全过。
 2026-09-17 12:27:58 +08:00
yml2213 a7a55d6c16 feat(consignment): 客服手动指定现货匹配的界面入口 
后端批次已提供判定/差异/强制留痕与双向读取接口，这里补界面，让客服真的能用上。

- 新增共享弹窗 ConsignmentManualMatchModal：订单侧（匹配弹窗「手动指定现货匹配」）与
  库存侧（寄售仓库行内「手动匹配订单」）共用同一套交互与落地逻辑，避免两套 UI 漂移
- 交互：搜索 → 选中（精确/非精确/规格冲突三档标签 + 字段级差异说明）→ 选交付方式
  （内部现货履约 / 指派供货打手）→ 非精确需勾选确认、冲突需勾选「确认规格不一致」并必填原因
  → 落地；并在落地前提示"现货立刻被占用、点错需撤销寄售履约"
- 判定规则收敛成纯函数 consignment-manual-match.ts（需不需要确认/填原因、能否提交、
  关键词过滤、标签文案）并加 4 例单测
- 服务与类型补齐：fetchWorkOrderConsignmentMatchOptions / fetchInventoryMatchableOrders，
  fulfill/assign 入参增加 allowSpecMismatch 与 matchNote
- 凭证核销失败的提示沿用既有规则（核销失败不能报成功）

验证：前端 typecheck/lint/format/44 例测试/build 全过；两个新接口未登录访问均 401
（路由已挂载、权限位生效）。
 2026-09-17 12:23:30 +08:00
yml2213 94328ac643 feat(consignment): 后端支持"手动指定现货"匹配（含规格冲突强制匹配留痕） 
需求：客服在后台能人工指定现货与订单匹配，而不是只能用系统算出的候选。

- 新增纯函数 listConsignmentMatchOptions()/classifyConsignmentMatch()：把某订单的**全部**
  在库现货列出来并逐件判定 exact/partial/conflict，conflict 时给出字段级差异
  （describeConsignmentSpecDifferences，例如「系统：订单「苹果」/ 现货「安卓」」）
- 新增 describeWorkOrderSpecConflicts()：强制匹配时把差异写进工单 material 与事件留痕
- fulfill/assign 两条落地链路支持 allowSpecMismatch（规格真冲突显式放行）+ matchNote
  （强制匹配必填原因，否则 400 consignment_match_note_required），
  material 与工单事件都记录 manualMatch/matchType/matchNote
- 新增两个只读接口：订单侧 GET /consignment/matches/:workOrderId/options（全部在库现货+判定），
  库存侧 GET /consignment/inventories/:id/match-orders（该现货可匹配的待指派/待补资料订单+判定）
- 抽取 classifyConsignmentMatch 让正反两个方向共用同一套匹配口径，避免"界面说能选、接口却拒绝"

真实库验证：订单要苹果微信暗潮2钻、现货为安卓QQ苍龙4钻时正确判定 conflict 并列出 4 项差异；
不填原因强制匹配被拒（consignment_match_note_required）；不强制则被规格复检拒绝
（consignment_spec_mismatch）；填原因强制匹配成功且工单事件与 material 都有留痕。
 2026-09-17 12:20:23 +08:00
yml2213 f62f9b6645 fix(consignment): 售后立案回落到供货卖家，修内部现货单立不了案 
补货款时排查"只认接单人"的地方，发现同类第三处：售后立案的责任人取
work_orders.assigned_worker_id，取不到就报 worker_missing（界面 409「请指定已验收的责任
打手或拼单份额」）。内部现货履约的寄卖单没有接单人，于是这类单子连售后都立不了案；
而货款修好后钱已结算给供货卖家，担责人本来就该是他。

- 抽出共享查询 getConsignmentSupplierByWorkOrderWithClient()
  （consignment-supplier-repo.ts）：工单 material_json.consignment.inventoryId 或库存
  bound_work_order_id → 库存 → 提报单，货款结算与售后立案共用同一份口径
- 售后在找不到接单人时回落到供货卖家，并在验收快照里标记 consignmentSupplier
  与提报单号留痕
- 加测试钉住：售后必须先认寄卖关系再判定 worker_missing；取卖家的 SQL 只有一处实现

真实库验证（内部现货履约，接单人为空）：反查供货卖家 workerId=3 正确；
售后立案成功且责任人 worker_id=3。临时数据残留 0。
 2026-09-17 12:08:39 +08:00
yml2213 896194aa2b fix(consignment): 验收结算补上寄卖货款，并修指派打手线报酬 100 倍单位错 
问题：工单 #100171 验收完成时卖家钱包只有押金 -20/+20，货卖掉了但货款收益没进卖家钱包。

查证：工单报酬 reward_amount=14500 分（发单方付 ¥145），货的结算价 cost_price_fen=12400 分
（卖家应得 ¥124），而 assigned_worker_id 为空（内部现货履约）。通用结算的规则是"把工单报酬
付给接单人"，内部现货单没有接单人 → 这笔钱谁也没拿到，卖家只拿回自己的押金。

- 新增 settleConsignmentSupplierPayoutByWorkOrderWithClient()：验收完成时把货的结算价
  （cost_price_fen，缺省退回 asking_price_fen）补给供货卖家，单位与通用报酬一致（分），
  同样做售后欠款抵扣、按售后策略决定是否延迟解冻、写 reward_settlement/reward_pending_unfreeze
  流水（说明「寄卖货款结算 #单号」）
- 不重复付款：接单人就是供货卖家本人时跳过（指派打手线里货物已随工单报酬付过）
- 修 100 倍单位错：指派打手线把工单报酬改写成货的结算价时写了 (cost_price_fen/100).toFixed(2)，
  ¥124 被写成 ¥1.24；reward_amount 的单位是分（已用真实数据核对）。抽成纯函数
  resolveConsignmentAssignRewardFen() 并加测试钉住单位

真实库端到端验证：卖家钱包 ¥205.50 → ¥329.50（+¥124.00 寄卖货款结算），累计结算同步 +¥124.00；
验证脚本改动的开发库数据已还原，临时数据残留 0。
 2026-09-17 12:04:39 +08:00
yml2213 40882aeebb fix(consignment): 确认加好友与上传赠送截图恢复为卖家操作，客服兜底 
问题：卖家「我的寄卖」里"已匹配-待加好友"的货点不了确认加好友，提示还写着"等待客服确认加好友"。

原因：批次 I 把能力位绑在"订单接单人 = 当前卖家"（selfFulfilling）上，而内部现货履约的订单
根本没有接单打手（assigned_worker_id 为空），于是状态机关掉按钮、后端归属校验还会 403。

业务定调：卖家可以确认加好友，冷却到期后也能自己上传赠送成功截图，客服只是兜底。

- 能力位改成按阶段给：material_submitted 可确认；内部现货履约在 material_required 也可确认
  （与客服侧一致）；冷却结束可提交赠送截图；提示改成卖家视角
- 后端归属只认"这张提报单就是当前卖家的"（别人的单仍 404），删除"订单接单人必须是卖家"的 403
- 卖家提交凭证走 asConsignmentSupplier 选项：跳过接单人校验（归属由寄卖单保证），
  冷却是否结束、必须带图等校验全部保留
- 客服侧按钮不变，谁先点谁生效，后点者拿到明确 409

真实库端到端验证：卖家列表按钮=true → 确认加好友 gift_phase=friend_countdown(+72h) →
冷却中被拒 work_order_gift_cooldown_active → 冷却到期后卖家上传赠送截图成功（工单转 pending_acceptance）。
 2026-09-17 11:57:33 +08:00
yml2213 0fd09976a5 fix(files): 去掉文件链接的签名与有效期，修客服端凭证裂图 
问题：寄卖凭证的图片地址是带签名的临时链接（15 分钟有效），而入库时会把当时的链接
原样存进 screenshots_json；工单验收那条线出参时会用 refreshStoredFileUrl() 重签，
寄卖这条线（提报凭证/赠送凭证/卖家列表）漏了这一步，于是入库 15 分钟后链接必然失效，
客服看到裂图。图片本身没丢，是取的时候没重签。

业务定调：签名这套意义不大，直接去掉。

- buildFileUrl() 只产出不带签名、不带有效期的普通链接（对象 key 带随机段，不可枚举），
  删除签名生成/校验与 15 分钟 TTL 常量，文件读取路由不再校验签名
- refreshStoredFileUrl() 语义改为"归一化"：把历史存的签名链接洗成普通链接，老数据不用改也能看
- 寄卖出参统一归一化：提报凭证、赠送凭证（imageUrls + files[]）、库存截图、卖家列表截图

真实库验证：库里早在 2026-09-15 就过期的老链接现在返回 HTTP 200（image/webp，52632 字节），
改造前是 403；客服接口下发地址已无签名；不存在的 key 仍 404。

取舍：文件路由原本靠签名把关，去掉后知道链接即可看图（key 含 24 位随机段，实际不可枚举）。
如需收紧可给该路由加后台登录校验。
 2026-09-17 11:52:40 +08:00
yml2213 e731348bb0 refactor(consignment): 删掉按库存号操作寄卖的卖家入口 
手动入库停用后，"没有提报单的现货"已不可能再产生，批次 I 为兜这类货加的两个
按库存号入口（/worker/consignment/inventories/:inventoryId/...）成了纯负担。

- 删除两个按库存号的路由/服务函数、前端两个请求函数与页面里的锚点分派逻辑，
  卖家动作只按提报单号（寄卖单号）定位
- 卖家列表里"没有提报单"的兜底行不再暴露内部仓库号（标题改「客服手工入库」），
  且一律不给操作能力位，不给用户一个点下去必然失败的按钮
- 加静态守卫测试钉住以上两点，防止以后又长出按库存号的入口

真实库验证：卖家列表三件货都带寄卖单号与 submissionId，没有提报单的现货 0 件。
 2026-09-17 11:45:50 +08:00
yml2213 0c10f0e135 feat(consignment): 停用客服手动入库，寄卖货源只走平台提报 
背景：手动入库是唯一会造出「没有提报单的现货」的入口，这类货没有寄卖单号，
统一状态机/凭证链/搜索/卖家端单号锚定都串不起来，只能在界面回退显示内部仓库号 INV，
正是"一件货两个号"的残留。业务定调：寄卖货源只走「打手平台提报 → 客服审核入库」。

- 前端寄售仓库的「手动入库」入口整块删除（按钮 + 入库弹窗 + 提交逻辑 + 服务函数）
- 后端同时挡住，防旧页面缓存或直接调接口绕过：
  POST /worker-platform/consignment/inventories 返回 409 consignment_manual_inbound_disabled；
  死代码一并清掉（服务层原实现、仓库层 createConsignmentInventory）
- 提报审核入库路径不受影响，照旧生成内部仓库号 INV 并写 source_submission_id，
  即每件货都必然挂着寄卖单号，INV 只作为内部编号存在、界面不展示

真实库验证：接口被拒（409），且「没有提报单的现货行数」前后均为 0。
 2026-09-17 11:41:46 +08:00
yml2213 47e09d72ce fix(consignment): 内部寄售匹配弹窗防点错 
问题：弹窗里「走接单平台指派打手（冻结押金交付）」与「内部现货履约」两个按钮上下紧挨、
样式相近，而且只有"部分匹配"才弹确认——精确匹配时两个按钮点下去都立刻执行，
点错就得走「撤销寄售履约」才能退回来。

- 两个动作一律二次确认（不再只有部分匹配才确认），确认框写明：寄卖单号（可复制）、
  动作（给谁接单/是否冻结押金）、结果（立刻占用现货、其它订单不能再匹配、
  内部履约还会跳过「待打手提交资料」直接进冷却）、以及退回要走撤销寄售履约；
  部分匹配额外红字提示"不是精确匹配、无法自动回退"并把确认按钮降为 danger
- 按钮区改成独立的「选择履约方式」分区小卡片：两个按钮各占一行 block 铺满
  （点击目标更大、不再小按钮挨着）、间距 14px、各加图标（打手 TeamOutlined /
  库存 PushpinOutlined），每个按钮下方一句后果说明
 2026-09-17 11:33:23 +08:00
yml2213 54f8a27e97 fix(consignment): 匹配弹窗改用寄卖单号，客服界面不再展示内部仓库号 
问题：内部寄售库存匹配弹窗显示的是「寄卖单号 INV26091711253394」——候选现货走的
是另一个查询 listActiveConsignmentInventoriesForMatching，它没 join 提报单，
sourceSubmissionNo 取不到，前端就回退显示内部仓库号；客服拿这个号去寄卖仓库又搜不到。

- 匹配候选查询补 LEFT JOIN consignment_submissions 带出 source_submission_no；
  该查询原本是 SELECT * 且列名无前缀，而 consignment_submissions 同样有
  status/game_name/category_id，加 join 会让条件变成 ambiguous column 直接 500，
  故列名统一加 ci. 前缀并显式列字段（加静态守卫测试钉住）
- 客服界面只展示寄卖单号：匹配弹窗候选卡片、工单寄售标识、工单详情、寄卖仓库列表与详情
  全部去掉内部仓库号；手工入库现货写「客服手工入库（无提报单号）」，
  历史老单写「老单无提报单号」，不再抛内部编号
- 内部仓库号保留：数据/接口/按它搜索都还在，撤销解绑等链路未动

真实库验证：仓库层候选查询与 checkWorkOrderInventoryMatches 都带出了寄卖单号。临时数据已清理。
 2026-09-17 11:31:01 +08:00
yml2213 ca04e09deb feat(consignment): 客服端凭证链可视化（提报凭证 + 赠送凭证） 
问题：一件寄卖有两类凭证，客服界面只看得见第一类，还是 48x48 一张缩略图，
看不出是主页还是物品；第二类（证明"这件货真送出去了"的赠送完成截图）只在工单验收界面，
客服要证明赠送是否完成得自己跨模块翻，没有任何地方把两类凭证并排呈现。

- 两类凭证分别在哪里：
  提报凭证 = 提报表 screenshots_json（卖家提报时的游戏主页截图，含物品/仓库详情）
  赠送凭证 = 绑定工单的验收资料 work_orders.acceptance_json（冷却结束后上传、客服凭此验收）
- 后端把凭证链从客服两个列表/详情接口一起下发：提报表/库存 → 结果库存 → 绑定工单，
  新增 submissionScreenshots / giftEvidenceImages / giftEvidenceNote / giftEvidenceSubmittedAt /
  giftWorkOrderNo / giftWorkOrderStatus / giftEvidenceReviewStatus（none|pending|accepted|submitted）；
  赠送凭证图从 imageUrls 与 files[].url|mediumUrl|thumbnailUrl 两处取并去重
- 提报凭证口径统一：有来源提报单用提报单主页截图，客服手工入库现货回退库存自身截图，
  前端只看 submissionScreenshots 一个字段，不会拿错
- 前端新增共享组件 ConsignmentEvidenceGallery（缩略图 + 大图预览 + 共 N 张，
  预览用 Image.PreviewGroup items，被折叠的图在大图里仍能翻看）；审核面板把「凭据截图」
  拆成「提报凭证（游戏主页截图）」与「赠送凭证」（带待验收/已验收 Tag + 关联工单 Tooltip），
  仓库面板新增「凭证」列并分组展示，两个详情弹窗同口径（含备注/提交时间/工单号/一句话说明）

真实库验证：赠送凭证解析在构造的工单验收资料上取到 3 张图（imageUrls 1 + files 2）并识别
pending_acceptance → 待客服验收；提报凭证在真实数据上取到 1 张。临时数据已清理。
 2026-09-17 11:22:59 +08:00
yml2213 44de11a3a7 feat(consignment): 一个寄卖单号锚定全流程 + 统一状态机 + 卖家侧确认加好友/提交赠送截图 
问题：一件货身上挂着三套互不相通的状态（提报单审核态、仓库库存态、工单赠送态），
my-items 同时返回两个数组、卖家端分两个列表渲染，同一件货显示两行两个号；
且卖家端只映射了前两套状态，"已出库"之后流程就断了，卖家不知道该干什么。

- 提报单号 SUB… 作为唯一「寄卖单号」从发布锚定到结算（零迁移）；
  listWorkerConsignments 改成一件货一条记录，库存/工单信息挂上去，
  客服手工入库的现货（无提报单）才回退用库存号当锚点
- 新增 domain/consignment-item-stage.ts：把三套底层状态推导成卖家看得懂的一个阶段
  （待审核/已通过待匹配/已匹配-待加好友/冷却中/待赠送/已赠送待审核/已完成/驳回/作废/取消）
  + 一句"下一步做什么" + 能力位（谁能确认加好友、谁该传截图），列表筛选与 KPI 也改由它驱动
- 卖家侧新增动作（以前只有 publish + my-items，卖家只能干看）：
  POST /worker/consignment/items/:submissionId/{confirm-friend,gift-evidence}
  POST /worker/consignment/inventories/:inventoryId/{confirm-friend,gift-evidence}（手工入库现货）
  复用既有工单链路 confirmWorkOrderFriendAdded / submitWorkerOrderAcceptance，
  只加归属校验（不是本人履约的订单 403），顺带白拿"冷却没结束不许提交凭证""必须带图"
- 客服端用同一个号：库存列表/详情补 sourceSubmissionNo（LEFT JOIN 提报单），
  履约/指派写进工单的寄售信息也带上；关键字搜索支持按寄卖单号搜（计数 SQL 同步补 join）

真实库端到端验证：确认加好友 → gift_phase=friend_countdown / friend_added_at 落库 /
gift_available_at 正好 +72h；冷却期内提交截图被拒（work_order_gift_cooldown_active）；
越权操作被拒（consignment_item_not_found）；按寄卖单号搜索命中正确。临时数据已清理。
 2026-09-17 10:57:57 +08:00
yml2213 99752dce9e fix(consignment): 修掉发布时乱弹内部库存提醒，并把弹窗赏金换算成元 
乱弹窗根因：matchPeacekeeperOrderWithInventory 精确匹配判定失败后无条件 fall through 到
部分匹配；而系统/区服/系列/钻级缺失时 compareSpec 返回 unknown（不是 mismatch）会被放行，
于是任何只写了游戏名的订单都命中仓库里全部在库货，表现为"随便发布点什么都会弹一下"。

严格模式（自动提醒）现在要求：① 系统/区服/系列都能确认一致；② 存在正信号（库存配置更高，
或订单压根没提钻级）。"订单没写规格"不再算命中。

同时给 matchPeacekeeperOrderWithInventory / findMatchingPeacekeeperInventories 增加
allowUnspecifiedSpecs 选项：人工履约的服务端复检（运营已人工选定现货）走宽松模式，
标题没写全规格不硬拦、真冲突仍拦，避免收紧自动提醒时把人工履约一起挡掉。

赏金显示：弹窗用 rewardAmount（单位分）直接 toFixed，把 ¥40 显示成 ¥4000；
同文件其他 30 余处均为 /100，仅此处漏了。弹窗内收购成本/履约押金本来就已 /100，核对无误。

验证：用截图里的现货（苹果QQ区怒嚎3钻2璀璨）对照 6 种订单——
"怒嚎"、"苏尔南" 从命中变为不命中；"苹果QQ区怒嚎1钻" 仍按高配充低配提醒；
"5钻"（低配充高配）、"安卓微信区怒嚎1钻"（系统/区服不符）不命中。
后端 435 例（新增 3 例、改写 3 例）全绿。
 2026-09-17 10:30:17 +08:00
yml2213 d158cc91bc feat(consignment): 确认加好友后现货作废不回池，撤销履约押金可选并结算打手押金 
现货口径（严）：已确认加好友 = 买家好友已加上、货随时可能送出去，回池会被下一个工单
再次占用（等于二次出货）。收口在 releaseConsignmentInventoryBindingForWorkOrderWithClient：
解绑前读工单 acceptance_mode/friend_added_at，命中则 archived + allow_matching=FALSE + 留痕，
否则仍回池。所有解绑路径自动继承，发单系统接口未动。

撤销寄售履约（寄卖专属入口）支持两笔押金各自可选，默认按规则自动：
- 打手履约押金：auto / refund / forfeit
- 卖家发布押金：auto / keep_frozen / forfeit
策略抽成 domain/consignment-deposit-policy.ts 纯函数；覆盖时原因照旧必填，选项与金额写进
工单事件便于对账。

顺带修掉两个 bug：
1. 撤销寄售履约从不结算打手履约押金——只清 assigned_worker_id、只处理卖家押金，
   worker_deposit 单撤销后打手押金永久冻结。现按选项结算（退还/没收）。
2. detachConsignmentMaterialFromWorkOrderWithClient 里 $1 既作 $1::text（detachedAt）
   又赋值给 updated_at，Postgres 整体推断成 text → 42804。凡解绑现货摘寄售标记的路径
   （取消指派/撤单/退单/售后/撤销履约/人工回库）在真实库上必然 500，假 client 单测抓不到。
   已显式 ::timestamptz，并补类级静态护栏扫同类写法。

验证：真实库（全回滚）——已确认加好友解绑 → archived/allow_matching=false；
未确认 → 仍 in_stock；打手押金冻结 3000 → 退还 3000（重复结算 0）→ 再冻 2500 → 没收 2500
（可用余额不变、冻结归零、流水 deposit_deduction）。后端 432 例（新增 5 例）全绿。
 2026-09-17 10:21:38 +08:00
yml2213 a47c243421 feat(consignment): 确认加好友后卖家发布押金不退，并封住二次冻结的 500 
需求：确认加好友之后押金不退回，卖家的押金也不退回。

- 新增 forfeitConsignmentPublishDepositBySubmissionWithClient /
  ...ByWorkOrderWithClient：release 的镜像——可用余额不动、只扣冻结额，写一条负数
  deposit_deduction 流水并带上工单号与 giftDepositForfeited 标记。
  台账 outstanding 会把 deposit_deduction 计入已核销，因此之后同一提报单的
  release 与重新冻结都拿不到钱，天然幂等、退不回去。
- 挂载点：取消指派/撤单/退单/售后回退等 6 处「押金不退」判定点，以及「撤销寄售履约」的
  作废与回库分支（后者原来会把押金留着或直接退还卖家）。
- 修掉一个会 500 的边角：押金已退还/已没收时 ensureConsignmentPublishDepositFrozenBySubmissionWithClient
  会去插第二条 deposit_freeze 流水，撞上"每个提报单只允许一条冻结流水"的唯一索引
  （没收后现货回库、再被匹配后撤销/退回复库即可触发）。现显式抛
  consignment_deposit_already_settled，两个服务层都映射成 409 文案。

验证：真实库（回滚）验证没收全链路——冻结 2000 → 工单侧没收 2000 → 可用余额不变、
冻结额归零、流水为 deposit_deduction(-2000, 关联工单)；没收后 release 恒为 0。
后端 420 例（417 通过，新增 5 例）全绿。
 2026-09-16 21:27:47 +08:00
yml2213 d6f6219fe9 feat(consignment): 内部现货履约改为停在「待加好友」，由客服确认后进赠送冷却 
需求：发布匹配成功后订单要停在待加好友，客服线下通知加好友、手动确认后才进赠送冷却。

- 新增 parkWorkOrderWaitingFriendAddWithClient：占库落地时把工单停在
  acceptance_mode=friend_gift + gift_phase=material_required 的「待加好友」阶段，
  friend_added_at / gift_available_at / deadline_at 都留空（没有打手在跑，不该背时限），
  并把商品规则里的冷却时长落到工单上（两者都为 0 时补默认 72 小时，
  否则客服确认后会得到 0 秒冷却而立刻可赠送）。
- 履约服务不再传 forceFriendGift（该开关会直接把 friend_added_at 写成当前时间、
  跳过客服确认）；同步删除这个已无调用方的开关，冷却起始事件里的
  skippedWorkerMaterial 改为按是否内部现货履约判断。
- 前端：内部现货单在该阶段显示「待加好友」（原为「待打手提交资料」），
  确认按钮统一为「确认加好友」，确认弹窗补上"先用库存账号加好友、通知进展记备注"的引导。
- 后台备注增加快捷项「已通知加好友」，一键追加「[已通知加好友] 操作人 时间」。
- 阶段文案抽到 utils/gift-phase.ts 以便单测覆盖这条口径。

验证：真实库跑通全链路（停阶段 → 确认加好友进冷却 → 重复确认被拒 → 事件流正确，临时单已清理）；
后端 415 例（412 通过，新增 3 例）、前端 25 例（新增 4 例）全绿。
 2026-09-16 21:02:50 +08:00
yml2213 563e548b2e feat(consignment): 补齐寄卖前端权限门控，收口调拨状态与运营体验 
权限门控（P1-8 剩余）：
- 新增 resolveAdminPermission(sessionPermissions, code)：会话接口的最新权限列表优先，
  接口异常才回退登录时的本地快照；空数组也判无权限，避免"刚被收回权限仍能点"。
- 寄售仓库面板：consignment.manage 控制手动入库/编辑/作废/退单回库/匹配开关（无权限时开关禁用）。
- 寄卖提报面板：consignment.review 控制审核入库/驳回。
- 接单平台页：无 consignment.view 不渲染两个寄卖 tab，并把 URL/localStorage 的旧选择拉回工单页。

数据约束（P2-19 剩余）：
- 迁移 080：allocation_status 历史非法值归位「待安排」（备注留痕）后加 CHECK（待安排/已安排），
  并顺手修正 077 遗留的"收集链接/玩家提交"权限描述文案。
- 编辑接口拒绝直接改 allocationStatus（400 consignment_allocation_status_update_forbidden）。

运营体验：
- 两个面板补 isError 错误态与重试；审核通过/驳回加 confirmLoading 与提交中守卫（防双提交）。
- 待审徽标改用后端真实总数（原来只统计当前页）；编辑弹窗押金不再兜底 ¥100（会误写押金）。
- 履约拦截弹窗冷静期文案不再硬编码"3 天"，改为按商品规则设定。
- 核实并撤回"倒计时时区偏移"误报：deadlineAt 为带 Z 的 ISO，前端无偏移问题。

验证：后端 412 例（409 通过）、前端 21 例（新增 5 例权限解析）全绿，
typecheck / lint / format / check:sql / build 通过；迁移 001→080 在全新空库跑通并在 dev 库应用。
 2026-09-16 20:39:52 +08:00
yml2213 5d11bf2012 fix(consignment): 补齐指派补偿与规格复检，封闭寄卖资金/货物不一致窗口 
- 指派失败改为完整补偿：取消指派（解冻打手押金 + 工单退回大厅 + 解绑现货）→ 兜底释放占用 →
  摘除工单寄售标记。此前只把现货放回在库池，一旦"指派已提交、写 material 失败"，工单会停在
  in_progress + 押金冻结却不带寄售记录，现货还回到可匹配池，同一件货会被第二张单占用。
- 电子凭证核销失败写 consignment_fulfill_voucher_consume_failed 事件，前端按 voucherConsume.ok
  弹警告并提示人工核销，不再无条件报成功（核销走快手外部接口，无法与数据库事务合并回滚）。
- 匹配规格改为 match/mismatch/unknown 三态，钻级兜底由 || 1 改 || 0：订单规格信息不全一律不进
  "精确匹配"，降级 partial 并在原因里列出缺失字段，消除"任意现货都 100 分精确匹配"的错发根因。
- 履约与指派在占库前做服务端规格复检：冲突 409 consignment_spec_mismatch；非 exact 必须显式
  传 allowPartial（前端在部分匹配候选上先危险确认），高配充低配保留但不可误触。
- 人工解绑守卫由"状态黑名单"收窄为只拦交付中三态（与撤销白名单对齐），修复
  "工单未开始 + 现货仍绑定"没有任何人工出口的问题。
- 新增 detachConsignmentMaterialFromWorkOrderWithClient，解绑回库/人工退回复库/作废同步摘掉
  工单寄售标记，消除"已回库却仍显示寄卖履约"的陈旧痕迹。
- 回归测试新增 8 例（后端 410 例 / 407 通过），附迁移 079 上库前检查脚本。
 2026-09-16 20:12:14 +08:00
yml2213 632dddc4c3 fix(consignment): 下线 H5 收集链接渠道并封闭寄卖履约状态机 
下线定向收集链接（H5 填报）整条线，提报统一走接单平台打手端：
- 删除前端 ConsignmentCollectPage、consignment-public 服务与 /consignment-collect/:token 路由
- 删除后端公开路由 routes/consignment.ts、consignment-public-service 与管理端 /consignment/links 三接口
- 迁移 079 删表 consignment_collect_links、删列 consignment_submissions.link_id，
  source_type 的 collection_link 归并为 worker_portal 并替换 CHECK

修复手工入库/编辑的凭据与截图静默丢失：后端统一按 credentialsJson ?? credentials、
screenshotsJson ?? screenshots 读取（入库/编辑/审核入库三个入口）。

按"已验收一律禁止撤销"封闭状态机：
- 撤销寄售履约加状态白名单（in_progress|pending_acceptance|problem）+ 事务内 FOR UPDATE
  锁单 + UPDATE 带 status 条件（0 行 409）+ 原因必填 + 清空指派/时限/验收草稿痕迹
- 库存改状态一律带条件：撤销要求 bound_work_order_id 命中本工单；作废/回库要求未被
  进行中工单占用（被挡时提示具体工单号）；079 加部分唯一索引并清理历史重复绑定
- 工单终止统一解绑回库：打手撤单/取消指派/退回大厅/撤单/打手退单申请/超时处置接入
  releaseConsignmentInventoryBindingForWorkOrderWithClient（售后不改工单状态，无需接入）
- 回库路径保留运营的 allow_matching 开关设置（不再强制开启），前端文案同步更正

顺带修掉资金与归属的同源缺陷：
- 押金归属与重冻金额改取不可变的冻结核销行，审核改派不再"退给错人/向错人扣款"
- 新增 assigned_worker_id 拆开"卖家"与"被指派履约人"，占库不再覆盖卖家
- PUT /inventories/:id 禁止直接改 status；发布接口补 requireActiveWorker
- 押金冻结/释放后补推钱包实时事件；迁移 079 给发布冻结加台账幂等唯一索引

验证：后端 401 测试/398 通过/3 skip（新增 5 例回归），前端 16 通过；
两侧 typecheck、lint:check、format:check 与 check:sql、build 全绿。
迁移 079 未经真实数据库执行（本环境无 Postgres），上库前请先 dry-run。
 2026-09-16 20:05:49 +08:00
yml2213 e828e677a5 fix(consignment): 打通寄卖权限鉴权、指派占库竞态与撤销守卫 
- 后台权限白名单补齐 consignment.view/manage/review/fulfill，
  避免在「角色权限」页保存任意角色时静默清除寄卖权限
- 寄卖后台 19 个接口由 requireAdminRoles 改为 requireAdminPermission，
  使 view/manage/review/fulfill 四个权限真正生效
- 指派打手履约改为先原子占库（WHERE status = 'in_stock'），
  失败自动回滚库存，消除并发下同一件现货被两张工单同时认领
- 撤销寄售履约拒绝押金履约模式（worker_deposit），
  避免打手押金不释放造成资金挂账；前端同步隐藏该入口
- 撤销回库不再强制覆盖 allow_matching，保留运营手动关闭的匹配开关
- 新增 4 个回归测试：权限白名单与迁移一致性、占库/回滚条件、撤销守卫
 2026-09-16 11:38:08 +08:00
yml2213andCursor 6b9407967b style: 修复赠送冷静期 cooldownMinutes prefer-const 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 20:04:03 +08:00
yml2213andCursor fd1eb5815b feat(consignment): 内部现货占库进入赠送冷静期并闭环发布押金 
打手发布冻结履约押金，驳回/作废退还，验收释放；内部匹配履约立刻占用库存并跳过打手资料进入冷静期，撤销回库时补冻押金。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 20:03:11 +08:00
yml2213andCursor 4a6215e816 feat(consignment): 苏尔南寄卖接入打手端押金履约 
打手可直接提报寄卖，关联 worker 与履约押金后指派交枪；后台去掉旧收集链接管理，提报审核与库存/工单流程对齐接单平台。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 16:00:33 +08:00
yml2213 7672360875 Merge branch 'main' into dev 2026-09-15 14:17:36 +08:00
yml2213andCursor ca291a71a9 style: 修复 AdminLayout Prettier 格式 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 13:49:24 +08:00
yml2213andCursor acfe7fd07e style: 修复订单与调度相关 Prettier 格式 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 13:48:43 +08:00
yml2213andCursor 40278a68fc chore(logging): 降噪 PDD 同步与发单消费者常态日志 
将无新单/全跳过的处理完成日志降到 debug，并压缩 decisions 详情，避免 app 日志被按日切碎。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 13:48:30 +08:00
yml2213andCursor 40c51e1d8e fix(admin): 订单列表默认近7天并按支付时间筛选 
避免无日期过滤时展示全库，关键词搜索不受日期限制；SSE 插入裁剪并尊重筛选，新单入库优先使用平台支付时间。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 13:41:29 +08:00
yml2213andCursor b7d246e5b9 fix(admin): 任务列表商品名与执行器标签改为中文展示 
建单时不再把英文 sku 写入商品名，列表按映射反查中文名，并将 Affiliate Dash 等标签本地化。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 13:03:47 +08:00
yml2213andCursor 68f43bf323 style: 修复领取页 Prettier 格式 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 12:40:50 +08:00
yml2213andCursor b2d92d1559 style: 修复 claim/affiliate-dash Prettier 格式 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 12:40:01 +08:00
yml2213andCursor 8e0cb7e295 fix(claim): 领取页展示游戏角色名，并说明乐玩免扫码场景 
持久化 affiliate_dash roleName/gameChannel；免扫码授权时明确提示，有绑定链接时提交前仍可显示二维码。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 12:39:47 +08:00
yml2213andCursor 8eef95fe97 style: 修复 affiliate-dash http-client Prettier 格式 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 12:05:18 +08:00
yml2213andCursor 8e996e01fb fix(pdd): 停止旧单刷匹配日志，并修复订单列表商品显示为 0 
同步时已有工单/匹配结果未变不再写日志；列表按 Number(order_id) 挂 items，并补齐 PDD goods_name 回退与嵌套商品解析。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 12:05:02 +08:00
yml2213andCursor 2e197f93e0 fix(claim): 透出 affiliate_dash 上游错误，便于排查提交 UID 失败 
上游 4xx 不再一律打成 502 兜底文案；affiliate_dash 依赖错误优先展示真实 message。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 11:51:32 +08:00
yml2213andCursor 868e8a740e fix(pdd): 长 SKU 精确名优先于短模板 contains，消除父子模板冲突 
out_sku_sn「安卓血宴5钻带2璀璨」会被短名「安卓血宴5钻」contains 同分命中；精确相等提分，contains 按名称长度区分优先级。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 11:35:24 +08:00
yml2213andCursor 03dffcfbb8 fix(pdd): 彻底修复拼多多模板匹配被来源/平台/sku_code 误拦截 
PDD 复用快手模板时，残留的 91kaquan/kuaishou 与误填 sku_code 会让 out_sku_sn 对上模板名仍未命中；改为 OR 匹配并放行常见残留，同时在匹配测试返回拒绝原因诊断。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 11:28:40 +08:00
yml2213andCursor d09cce5050 fix(pdd): 无店铺上下文时跳过快手结构化匹配，按模板名/out_sku_sn 命中 
模板残留的 match_json.sellerId 等字段会让拼多多订单误入结构化分支并直接未命中；仅快手有 sellerId 时才走该路径。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 11:18:27 +08:00
yml2213andCursor 30b547cbbe style: 修复 frontend Prettier 格式检查失败 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 10:48:02 +08:00
yml2213andCursor e20505bc8e style: 修复 pre-push Prettier 格式检查失败 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 10:47:38 +08:00
yml2213andCursor 5cbb977b96 fix(pdd): 匹配诊断对齐 out_sku_sn，并加速拼多多订单号搜索 
匹配测试/结构化规则补读商家编码，诊断日志标出缺失字段；订单/任务/工单关键词支持带连字符的 PDD order_sn 走索引快路径。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 10:45:53 +08:00
yml2213andCursor 4a3b4ec14d refactor(fulfillment): 固化 91 中文名→英文 SKU 权威映射表 
91 继续用中文编码；解析优先查内置常量表，配置仅作临时覆盖，Admin 改为展示权威表。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-14 20:33:42 +08:00
yml2213andCursor 745eeaee35 fix(admin): 恢复任务重试/转人工/人工完结等后台写接口 
删除咸鱼链路时误删了 retry、mark-manual-review、complete-manual-dispatch、regenerate-claim-link；现按 affiliate_dash + manual_dispatch 语义恢复，历史下线通道可人工完结但不可自动重试。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-14 17:32:26 +08:00
yml2213andCursor b3aad0044c refactor(fulfillment): 移除飞飞/乐玩通道，仅保留 affiliate_dash 
新单只路由 affiliate_dash（未命中走 manual_dispatch）；历史飞飞/乐玩任务保留只读 stub，避免订单重同步失败。同步清理 cloudtentacles 调度、Admin 写路径与相关 env。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-14 17:29:47 +08:00
yml2213 0cbcb89dd8 feat(pdd): add realistic Bézier mouse trajectory simulation to generate 700+ char anti-content tokens 2026-09-14 14:03:07 +08:00
yml2213 f35e47e419 fix(pdd): integrate official sandboxed anti-content engine to resolve 40002 WAF error 2026-09-14 13:44:55 +08:00
yml2213 4f97275c80 fix(pdd-extension): 拼多多官方接口频控(40002)容错与轻量探测，避免有效 Cookie 被拒 2026-09-14 13:09:16 +08:00