CaiWuXiTong

History

WuYongJie 6b2b486ce1 建立全项目上游业务镜像框架 (#53 )

## 任务占用与边界

- 任务名称：全项目上游业务镜像目录与通用同步框架
- 实际开发者：WuYongJie
- 目标结果：登记当前代码实际使用的上游原表，提供低压、可断点的首次全量、增量重叠和全量校准框架。
- 实际修改：13 个文件；新增通用数据集目录、动态镜像建表、同步状态、同步命令、生产低压轮询、测试和团队清单。
- 将写入的公共契约：`business_mirror_table_states`、`business-mirror:sync-tables`、`BusinessMirrorDatasetRegistry`、`BusinessMirrorSchemaManager`。
- 仅复用、明确不修改：`UpstreamReadOnlyQueryFactory`、`upstream_schema_columns`、既有 `product_price_mirror_rows`。
- 明确不包含：本 PR 不切换其余业务页面 Repository，不执行生产迁移或首次全量，不提交真实业务数据或凭据。

## 合并前自审

- [x] 已重新拉取最新 `origin/main`，分支仅领先 1 个提交
- [x] `git merge-tree --write-tree origin/main HEAD` 无冲突
- [x] 完整 diff 共 13 个文件，未发现越界文件或敏感内容
- [x] 生产共享数据字典核对 38 个数据集，缺失对象/字段为 0
- [x] 临时 MariaDB 空库迁移实测成功，验证库已删除
- [x] 上游异常空结果不会清空已有镜像
- [x] 定时任务只轮转已完成首次全量的数据集，不会自动扫描未初始化大表

## 测试

- `BusinessMirrorSynchronizerTest` 等相关测试：14 tests / 65 assertions 全通过
- 新同步器专项：5 tests / 25 assertions 全通过
- 新增 PHP 文件语法检查全部通过
- 两份生产激活脚本 `bash -n` 通过
- `git diff --check` 通过

## 风险与回滚

- 包含新增迁移，但发布脚本遇到迁移仍会要求独立高风险授权；合并本身不会执行生产迁移。
- 首次全量必须逐数据集显式执行并做数量/翻页/筛选验收，特别是约 280 万行的大表不得随发布自动全扫。
- 回滚代码可回退本合并提交；生产迁移执行前必须备份 `caiwu_system_config` 与 `caiwu_business_mirror`。

Reviewed-on: http://git.1080p.hk/WuYongJie/CaiWuXiTong/pulls/53

2026-08-14 16:38:33 +08:00

Abstracts

fix: 分离程序资源与七牛业务文件存储

2026-07-27 13:39:15 +08:00

Builders

feat: 财务系统二次开发 - 营销账户账单功能

2026-07-21 18:43:52 +08:00

BulkActions

feat: 财务系统二次开发 - 营销账户账单功能

2026-07-21 18:43:52 +08:00

Business

店铺收款账户账单淘系支付宝附件数据 (#36 )