接入拼多多店铺收款货款账单 #164

yueyang · 2026-09-11T17:57:18+08:00

yueyang commented

2026-09-11 17:57:18 +08:00

实际改动

将“店铺收款账户账单 / 拼多多账户”接到聚水潭“平台原始账单（新）/ 拼多多 / 货款账单”。
正式来源为 jiansun.dbo.jst_originalBillInfo，固定参数过滤 channel = PinduoduoImport，不使用慢一天的 operations_replica 副本，也不使用营销账户 pdd_spread_bills。
新增独立镜像数据集 jiansun.dbo.jst_originalBillInfo.pinduoduo_receiving，目标表 js_jst_pdd_receiving_bill_rows；按 Id 断点全量，按 updateTime 重叠增量。
通用镜像同步器新增经过校验的固定等值过滤契约，过滤值始终使用参数绑定。
拼多多页面支持分页、店铺/账单项目/日期/关键词筛选、汇总、排序及按显示列顺序导出；刷新、列设置、冻结表头和横纵滚动复用现有共享组件。
淘系支付宝和抖音账户继续读取原数据集；保留主线新增的抖音日期选择器逻辑。

修改文件

镜像配置与存储策略：config/upstream_mirrors.php、config/business_data.php
镜像契约与同步：BusinessMirrorDataset、BusinessMirrorDatasetRegistry、BusinessMirrorSchemaManager、BusinessMirrorSynchronizer
页面读取：AccountBills、StoreReceivingAlipayBillMirrorRepository、StoreReceivingPinduoduoBillMirrorRepository、AccountBills.vue
测试：拼多多 Repository/API/表格交互测试及通用镜像回归
文档：docs/上游业务镜像清单.md

验证证据

Laravel 相关测试：69 passed，565 assertions；4 个原生 TLS 外部数据库用例因本机环境条件跳过。
PHP 语法检查：本次 PHP 文件全部通过。
前端 npm run production：Laravel Mix 编译成功。
上游只读核对：jiansun.dbo.jst_originalBillInfo 的 PinduoduoImport 首页面内收入/支出与用户聚水潭截图一致；operations_replica 最大日期慢一天，因此未采用。
business-data:plan 已识别新数据集为 MariaDB serving_fact，用途为“店铺收款账单/拼多多账户”。
浏览器自动控制组件当前报本机内核资源缺失；生产首次同步完成后的视觉与真实数据验收仍需在发布阶段完成。

风险与发布

涉及金额汇总和共享镜像新表，不写回上游，不新增页面导入入口，不提交凭据或真实财务数据。
首次发布需备份受影响的镜像状态，在生产同步节点创建独立镜像表并执行可断点全量同步；完成前页面返回明确的镜像未就绪状态。
回滚可切回上一应用镜像；独立镜像表可从只读上游重建，不修改原始业务数据。

## 实际改动 - 将“店铺收款账户账单 / 拼多多账户”接到聚水潭“平台原始账单（新）/ 拼多多 / 货款账单”。 - 正式来源为 `jiansun.dbo.jst_originalBillInfo`，固定参数过滤 `channel = PinduoduoImport`，不使用慢一天的 `operations_replica` 副本，也不使用营销账户 `pdd_spread_bills`。 - 新增独立镜像数据集 `jiansun.dbo.jst_originalBillInfo.pinduoduo_receiving`，目标表 `js_jst_pdd_receiving_bill_rows`；按 `Id` 断点全量，按 `updateTime` 重叠增量。 - 通用镜像同步器新增经过校验的固定等值过滤契约，过滤值始终使用参数绑定。 - 拼多多页面支持分页、店铺/账单项目/日期/关键词筛选、汇总、排序及按显示列顺序导出；刷新、列设置、冻结表头和横纵滚动复用现有共享组件。 - 淘系支付宝和抖音账户继续读取原数据集；保留主线新增的抖音日期选择器逻辑。 ## 修改文件 - 镜像配置与存储策略：`config/upstream_mirrors.php`、`config/business_data.php` - 镜像契约与同步：`BusinessMirrorDataset`、`BusinessMirrorDatasetRegistry`、`BusinessMirrorSchemaManager`、`BusinessMirrorSynchronizer` - 页面读取：`AccountBills`、`StoreReceivingAlipayBillMirrorRepository`、`StoreReceivingPinduoduoBillMirrorRepository`、`AccountBills.vue` - 测试：拼多多 Repository/API/表格交互测试及通用镜像回归 - 文档：`docs/上游业务镜像清单.md` ## 验证证据 - Laravel 相关测试：69 passed，565 assertions；4 个原生 TLS 外部数据库用例因本机环境条件跳过。 - PHP 语法检查：本次 PHP 文件全部通过。 - 前端 `npm run production`：Laravel Mix 编译成功。 - 上游只读核对：`jiansun.dbo.jst_originalBillInfo` 的 `PinduoduoImport` 首页面内收入/支出与用户聚水潭截图一致；`operations_replica` 最大日期慢一天，因此未采用。 - `business-data:plan` 已识别新数据集为 MariaDB `serving_fact`，用途为“店铺收款账单/拼多多账户”。 - 浏览器自动控制组件当前报本机内核资源缺失；生产首次同步完成后的视觉与真实数据验收仍需在发布阶段完成。 ## 风险与发布 - 涉及金额汇总和共享镜像新表，不写回上游，不新增页面导入入口，不提交凭据或真实财务数据。 - 首次发布需备份受影响的镜像状态，在生产同步节点创建独立镜像表并执行可断点全量同步；完成前页面返回明确的镜像未就绪状态。 - 回滚可切回上一应用镜像；独立镜像表可从只读上游重建，不修改原始业务数据。

yueyang added 1 commit 2026-09-11 17:57:18 +08:00

chore: publish pinduoduo receiving bill task scope 89031dfeb4

yueyang added 3 commits 2026-09-12 11:12:52 +08:00

Merge remote-tracking branch 'origin/main' into feature/yueyang-pinduoduo-receiving-bills 58624fdb83

Merge remote-tracking branch 'origin/main' into feature/yueyang-pinduoduo-receiving-bills 1999db50e1

feat: 接入拼多多货款账户账单镜像 813e215e1f

yueyang changed title from ~~WIP: 接入拼多多店铺收款货款账单~~ to 接入拼多多店铺收款货款账单

2026-09-12 11:15:15 +08:00

yueyang merged commit 2d3e9cd865 into main

2026-09-12 11:16:34 +08:00

yueyang referenced this issue from a commit

2026-09-12 11:16:34 +08:00