dachui/order_site
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,395 Commits 9 Branches 0 Tags
1773fe78372f368a48282b5ae45d6ce76204c5d2
Commit Graph
49 Commits
Author SHA1 Message Date
yml2213 313e619744 chore(test): 清理旧迁移测试并统一前端格式 2026-11-07 17:52:15 +08:00
zhaoxing 7b68d9b60a fix(db): 113 迁移先删旧约束再归一销售事实渠道 2026-11-07 16:41:01 +08:00
zhaoxing 2dd55f6a6f fix(db): 113 迁移先归一销售事实旧渠道再收紧约束 2026-11-07 16:33:42 +08:00
yml2213 a333c05df4 fix(fulfillment): 收口渠道商品与统一结算边界 2026-11-06 17:12:44 +08:00
yml2213 974044a4c6 refactor(cost-center): 收敛人工 SKU 自动创建流程 2026-11-06 16:37:29 +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 8b9b4fc4ad refactor(cost-center): 统一人工标准商品与成本配置 2026-11-05 17:58:57 +08:00
yml2213 f67f00a7a5 fix(cost-center): 允许移除纯数字等异常人工 SKU 2026-11-05 17:29:14 +08:00
yml2213 a024a71df3 fix(cost-center): 修复人工履约配置保存后处理报错 2026-11-05 17:25:57 +08:00
yml2213 fc928c6b18 feat(worker-platform): 支持客户退款冲正并关闭订单 2026-11-05 17:15:41 +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 3ba808b814 feat(fulfillment): 统一中文内部 SKU 履约路由 2026-11-03 11:49:38 +08:00
yml2213 290890e848 feat(cost-center): 统一接单模板成本并自动同步商品 2026-11-02 16:14:51 +08:00
yml2213 3c4c81003f feat(finance): 商品渠道能力、自动发货转人工与成本异常收口 
- 商品可同时支持自动发货/人工，新增渠道能力与成本冲销字段
- 卡券缺商品时按内部中文 SKU 自动建 tpv: 商品并补渠道规则
- 自动发货失败转人工并冲销原渠道成本
- 配置成本后按最早缺失订单生效并立即补算、关闭异常
- tpv: 商品来源计入第三方卡券
 2026-11-02 13:17:15 +08:00
yml2213 64e04cc667 fix(finance): 历史归档订单退款跳过期间校验 
归档订单退款不进入财务口径，不应被历史月份/退款月份的关账状态阻断；
非归档订单退款仍严格校验期间。
 2026-11-01 16:24:18 +08:00
yml2213 5d7904f6ee fix(finance): 历史订单退款不再进入新财务口径 
- 断代前 archived 订单的退款只保留业务记录，不再生成冲减事实/总账
- 退款后的事实与费用重算只针对非归档订单
- 移除 refund_adjustment 渠道值的前端筛选与标签
- 迁移 116 的列约束保留，不再写入该值
 2026-11-01 16:22:49 +08:00
yml2213 a692723c73 docs+test: 补充成本缺失、退款期间与追溯限制说明 2026-11-01 15:21:55 +08:00
yml2213 20287916b1 fix(finance): 退款所属期间关账时阻断退款 
- 手工退款按实际退款日期校验期间
- 平台退款按当前退款月份校验期间
- 避免退款成功但冲减行被关账跳过的静默丢失
 2026-11-01 15:21:53 +08:00
yml2213 fd6d2d561b feat(pipeline): 渠道判定后立即归一商品并算成本 
- 新增按订单项定向归一，避免新判定订单等冷通道
- 判定/指定渠道后立即归一 → 算成本 → 按业务日回填事实与总账
- 提取 refreshFactsForDates 供管道与渠道服务复用
 2026-11-01 15:21:53 +08:00
yml2213 045ac98479 fix(finance): 成本缺失按渠道期望成本项判定 
- 采购/打手报酬/卡券采购各自校验对应成本项快照
- 人工渠道校验 manual_case 快照
- 未分类订单仍按「任意快照」兜底
- 平台费等通用费用不再把缺失成本掩盖成完整
 2026-11-01 15:21:50 +08:00
yml2213 624c0ef4af feat(finance): 历史订单退款按退款日入账 
- 迁移 116 新增 refund_adjustment 渠道值，并允许该类行净收入为负
- 销售事实按退款日聚合 archived 订单的已确认退款，写冲减行
- 退款后同时回填原销售日与退款日的事实与总账
- 退款同时重算相关订单项的费用快照（比例费按净收入）
- 前端渠道筛选与标签支持「历史退款冲减」
 2026-11-01 14:46:11 +08:00
yml2213 34832139b0 fix(db): 渠道迁移顺延为 113–115，避让远程 112 补资料链接 
远程 main 新增 112_work_order_material_link，本地原 112–114 顺延为 113–115：
- 113_fulfillment_channel_split
- 114_drop_legacy_fulfillment_mode
- 115_rename_facts_channel
同步更新文档与代码里的迁移编号引用。
 2026-11-01 14:02:52 +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 9ca1d52419 fix(finance): 人工确认后按业务日重算事实与总账 
确认履约写入 manual_case 快照后，立即按该订单业务日期重算销售事实并同步总账，
避免较早订单的成本只等 3 天窗口而永远入不了报表。
 2026-10-31 20:17:28 +08:00
yml2213 8e3b8e0a32 fix(finance): 销售事实只统计已支付订单并扣减退款 
- 事实范围增加 pay_status IN ('paid','refunded')
- 关联 order_refunds 已确认退款，净收入/毛利按扣除退款计算
- 补回归断言，防止再次出现退款不减收入
 2026-10-31 20:17:23 +08:00
yml2213 0a77524331 refactor(finance): 总账人工渠道判定改用渠道/状态列 2026-10-31 19:52:40 +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 3b0cfbb8fa feat(finance): 商品归一、成本快照与渠道销售事实三条管道 
- 商品归一统一为一个匹配器，禁止自动建商品，未命中进未归一队列
- 成本快照收敛为唯一入口：商品/规则/全局版本解析，工单验收自动升级 actual
- 异常改为 SKU 级聚合，补齐后自动关闭
- 销售事实按渠道汇总，pending 收入进 unclassified 桶，归档不进报表
 2026-10-31 18:12:13 +08:00
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 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
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
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
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 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 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
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 a7f60414a4 fix(finance): 客服只能使用自己的备用金账户 2026-10-23 11:44:04 +08:00
yml2213 2aeb789e20 feat(finance): 人工支出改为从客服备用金扣款 2026-10-23 11:31:47 +08:00
yml2213 74b62f3494 feat(finance): 订单页人工录单按单实际金额计入成本 2026-10-22 19:48:56 +08:00
yml2213 0889235870 feat(finance): 完成成本快照运行层、销售事实与人工支出登记 
迁移 108-111：快照业务时间与预估转实际、销售事实表、系统成本项、公司人工支出登记。接单平台按工单实际 reward 入账；人工支出支持登记/审批/驳回/报销并写 actual 快照。新增销售毛利页、人工支出页与订单入口。
 2026-10-22 16:41:03 +08:00