 yml2213
|
08318ef8d9
|
feat(deploy): 财务上线数据阶段编排与运维加固
- 新增 deploy/post-deploy.sh：回填 → 业务配置 → 同步 → 验收四阶段编排，支持 --only/--dry-run/窗口参数
- 新增 tools 镜像与 scripts/verify-finance-launch.sql（15 项上线验收）
- 验收口径：成本闸门二选一、要求已过账凭证、备用金支出关联、成本覆盖 WARN
- 加固：参数校验、工具镜像每次刷新、docker run 兜底超时、迁移前缀探测、验收失败退出码 2
- 工具镜像预建 /app/data，消除日志 EACCES
- 回填后与 restore-db 恢复后自动 VACUUM (ANALYZE)，修复订单列表分页 COUNT 全表扫描（41 万单实测 27s → 0.17s）
- 文档：41 万单同步用 7 天窗 + 180s 超时；回填/恢复后刷新统计
|
2026-10-28 11:52:42 +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
|
2b967ddd4c
|
feat(cost-center): 商品初始化/回填增加时间范围，默认最近 30 天
- 接单模板初始化预览/执行支持 dateFrom/dateTo，只使用范围内工单证据；
范围外模板不再先建商品
- 按工单回填商品支持时间范围；人工商品归一 UI 传时间范围
- 模板初始化重置只清理范围内导入映射/订单项，避免误伤范围外数据
- 初始化/回填默认最近 30 天，自动发货仍固定 30 天
- 文档更新初始化口径与页面操作
|
2026-10-26 16:26:48 +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
|
861524a91a
|
docs(finance): 校准代录与本地迁移基线到 112
|
2026-10-26 13:33:25 +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
|
f0eb8a5e05
|
docs(finance): 补充责任主管前置与客服账户初始化步骤
|
2026-10-26 13:05:46 +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 |
|