订单数据接入聚水潭上游只读数据 #27

renshen · 2026-08-11T12:39:59+08:00

renshen commented

2026-08-11 12:39:59 +08:00

任务背景

订单数据页面已完成附件表头，本任务由 renshen 接入聚水潭上游真实只读数据。

任务目标

订单售后费用明细：按附件字段展示订单、商品、SKU 成本及售后关联数据。
商品推广费用明细：按商品/款式汇总推广费用。
不硬编码附件演示值；缺失字段保持空值或零。

预计修改路径

modules/EcommerceFinance/Repositories/OrderDataRepository.php
modules/EcommerceFinance/View/Composers/OrderDataPageComposer.php
modules/EcommerceFinance/Providers/Main.php
resources/views/business/pages/order-data/*.blade.php
tests/Unit/EcommerceFinance/OrderDataRepositoryTest.php
tests/Feature/Business/OrderDataPagesUpstreamTest.php

页面和路由

复用 order-data/after-sales-expenses、order-data/promotion-expenses 和 business.pages.show；不新增或修改 routes。

Controller / Repository

新增 OrderDataRepository 和专用 View Composer；不修改 app/Http/Controllers/Business/Pages.php。

数据源、表和字段

source_key=operations_replica，数据库 JSReportReplica，schema=rpt。固定参数化只读查询使用 jst_Orders、jst_OrderItem、jst_sku、jst_skumap、jst_returnAndRefundInfo、jst_returnAndRefundItem、jst_warehouseInfo、ads_itemid_sales_cost_ratio_v2_di。字段限于订单/商品标识、时间、店铺、SKU 元数据、金额、售后数量金额及 push_fee。

scope

order-data.after-sales.list
order-data.promotion.list

权限、菜单和公共组件

复用现有页面权限、菜单、UpstreamReadOnlyQueryFactory 和 UpstreamQueryCacheFactory；不修改权限和导航。

明确不修改

不修改 routes、Pages Controller、数据库迁移、上游连接配置、权限、菜单、京东钱包功能、共享数据库结构或任何上游数据。

范围补充：后台快照刷新

modules/EcommerceFinance/Services/OperationsReplicaSnapshotRefresher.php
tests/Unit/EcommerceFinance/OperationsReplicaSnapshotRefresherTest.php

刷新器仅为 order-data.after-sales.list 和 order-data.promotion.list 分派同一 OrderDataRepository 固定查询；其他 scope 继续复用现有 UpstreamBusinessInformation。

## 任务背景订单数据页面已完成附件表头，本任务由 renshen 接入聚水潭上游真实只读数据。 ## 任务目标 - 订单售后费用明细：按附件字段展示订单、商品、SKU 成本及售后关联数据。 - 商品推广费用明细：按商品/款式汇总推广费用。 - 不硬编码附件演示值；缺失字段保持空值或零。 ## 预计修改路径 - modules/EcommerceFinance/Repositories/OrderDataRepository.php - modules/EcommerceFinance/View/Composers/OrderDataPageComposer.php - modules/EcommerceFinance/Providers/Main.php - resources/views/business/pages/order-data/*.blade.php - tests/Unit/EcommerceFinance/OrderDataRepositoryTest.php - tests/Feature/Business/OrderDataPagesUpstreamTest.php ## 页面和路由复用 order-data/after-sales-expenses、order-data/promotion-expenses 和 business.pages.show；不新增或修改 routes。 ## Controller / Repository 新增 OrderDataRepository 和专用 View Composer；不修改 app/Http/Controllers/Business/Pages.php。 ## 数据源、表和字段 source_key=operations_replica，数据库 JSReportReplica，schema=rpt。固定参数化只读查询使用 jst_Orders、jst_OrderItem、jst_sku、jst_skumap、jst_returnAndRefundInfo、jst_returnAndRefundItem、jst_warehouseInfo、ads_itemid_sales_cost_ratio_v2_di。字段限于订单/商品标识、时间、店铺、SKU 元数据、金额、售后数量金额及 push_fee。 ## scope - order-data.after-sales.list - order-data.promotion.list ## 权限、菜单和公共组件复用现有页面权限、菜单、UpstreamReadOnlyQueryFactory 和 UpstreamQueryCacheFactory；不修改权限和导航。 ## 明确不修改不修改 routes、Pages Controller、数据库迁移、上游连接配置、权限、菜单、京东钱包功能、共享数据库结构或任何上游数据。 ## 范围补充：后台快照刷新 - modules/EcommerceFinance/Services/OperationsReplicaSnapshotRefresher.php - tests/Unit/EcommerceFinance/OperationsReplicaSnapshotRefresherTest.php 刷新器仅为 order-data.after-sales.list 和 order-data.promotion.list 分派同一 OrderDataRepository 固定查询；其他 scope 继续复用现有 UpstreamBusinessInformation。

renshen added 1 commit 2026-08-11 12:40:00 +08:00

chore: start order data upstream task 68f1faac46

renshen added 2 commits 2026-08-11 14:40:10 +08:00

实现订单费用上游数据读取 f04e935eca

Merge remote-tracking branch 'origin/main' into feature/renshen-order-data-upstream 3d98e493f0

renshen commented

2026-08-11 14:49:28 +08:00

合并前自审

实际改动

新增 OrderDataRepository，通过 UpstreamReadOnlyQueryFactory 读取 operations_replica / JSReportReplica / rpt。
订单售后费用明细使用固定参数化只读查询关联订单、商品、SKU、仓库及售后表；商品推广费用明细读取推广费用并关联 SKU 映射。
新增 OrderDataPageData，复用 UpstreamQueryCacheFactory；两个页面复用现有 business.pages.show、权限、菜单和共享样式。
OperationsReplicaSnapshotRefresher 仅新增 order-data.after-sales.list、order-data.promotion.list 两个精确 scope。

验证

订单相关与页面导航回归：20 tests passed，238 assertions。
EcommerceFinance 全量单元测试：64 tests passed，430 assertions。
PHP 语法检查通过，git diff --check 通过。
本机实际页面：售后费用 103 列、当前页 25 条、DIRECT；推广费用 7 列、当前页 25 条、DIRECT；默认日期、筛选、分页和横向滚动正常。
operations_replica 数据字典已同步 202 个对象、5223 个字段；仅开放并登记上述两个 scope。

冲突与风险

已合并最新 origin/main 9f06dc4；主线新增内容仅涉及发布脚本，与本任务 8 个文件无重叠。
预检未发现其他远程任务分支重叠；未修改 routes、Pages Controller、权限、菜单、迁移、上游凭据或公共查询工厂。
共享刷新节点在部署本次 main 前仍运行旧代码，因此首份共享快照保持待刷新；本机直读验收已通过。本任务不部署生产。
未执行共享数据库迁移，未写入任何上游业务数据，未提交敏感配置或真实业务数据。

## 合并前自审 ### 实际改动 - 新增 OrderDataRepository，通过 UpstreamReadOnlyQueryFactory 读取 operations_replica / JSReportReplica / rpt。 - 订单售后费用明细使用固定参数化只读查询关联订单、商品、SKU、仓库及售后表；商品推广费用明细读取推广费用并关联 SKU 映射。 - 新增 OrderDataPageData，复用 UpstreamQueryCacheFactory；两个页面复用现有 business.pages.show、权限、菜单和共享样式。 - OperationsReplicaSnapshotRefresher 仅新增 order-data.after-sales.list、order-data.promotion.list 两个精确 scope。 ### 验证 - 订单相关与页面导航回归：20 tests passed，238 assertions。 - EcommerceFinance 全量单元测试：64 tests passed，430 assertions。 - PHP 语法检查通过，git diff --check 通过。 - 本机实际页面：售后费用 103 列、当前页 25 条、DIRECT；推广费用 7 列、当前页 25 条、DIRECT；默认日期、筛选、分页和横向滚动正常。 - operations_replica 数据字典已同步 202 个对象、5223 个字段；仅开放并登记上述两个 scope。 ### 冲突与风险 - 已合并最新 origin/main 9f06dc4；主线新增内容仅涉及发布脚本，与本任务 8 个文件无重叠。 - 预检未发现其他远程任务分支重叠；未修改 routes、Pages Controller、权限、菜单、迁移、上游凭据或公共查询工厂。 - 共享刷新节点在部署本次 main 前仍运行旧代码，因此首份共享快照保持待刷新；本机直读验收已通过。本任务不部署生产。 - 未执行共享数据库迁移，未写入任何上游业务数据，未提交敏感配置或真实业务数据。

renshen changed title from ~~WIP: 订单数据接入聚水潭上游只读数据~~ to 订单数据接入聚水潭上游只读数据

2026-08-11 14:49:48 +08:00

renshen merged commit 09d593dd2d into main

2026-08-11 14:50:56 +08:00

renshen deleted branch feature/renshen-order-data-upstream

2026-08-11 14:50:57 +08:00

renshen referenced this issue from a commit

2026-08-11 14:50:58 +08:00

订单数据接入聚水潭上游只读数据 (#27)

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: WuYongJie/CaiWuXiTong#27