CaiWuXiTong/app/Console/Commands/SyncStoreReportPaidSales.php
WuYongJie f7daee9305 feat: 店铺维度报表销量改取业绩明细的订单实付/实收金额
店铺维度报表(店铺管理 → 店铺维度报表)的销量原来按平台账单收入汇总,改为按
业绩明细(店铺收款匹配订单明细)的「订单实付/实收金额」汇总:

- 新增镜像表 store_report_paid_sales_rows:业绩明细按「店铺名称 + 发生时间」
  预汇总,页面按发生日期与主体生效/失效时间关联,拆分到对应主体期间;
- StoreReportRepository 的销量(period_sales / sales_NN)改读该汇总表,
  收入(rolling_12m_income / income_NN,主体维度经营报表用)仍读平台账单日汇总,
  两个口径分开统计、互不覆盖;
- StoreReportMirrorSynchronizer 增加 syncPaidSales():用「行数 + 最近写入时间 +
  订单实付合计」指纹判断业绩明细是否变化,变化才全量重建,未变化沿用当前版本;
- 新增命令 business-mirror:sync-store-report-paid-sales(含 --force),并在
  store-receipt:order-match:sync 成功后自动刷新一次。

验证:StoreReportRepositoryTest / StoreReportRepositoryFilterTest /
StoreReportMirrorSyncTest 共 23 个用例、110 个断言通过。
2026-10-16 23:50:25 +08:00

51 lines
1.9 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?php
namespace App\Console\Commands;
use Illuminate\Console\Command;
use Modules\EcommerceFinance\Services\StoreReportMirrorSynchronizer;
use Throwable;
/**
* 店铺维度报表的「销量」汇总:业绩明细「订单实付/实收金额」按「店铺名称 + 发生日期」预汇总。
*
* 业绩明细同步(store-receipt:order-match:sync)结束后会自动刷新一次;
* 这个命令用于单独重跑(例如补数据或按最新代码强制重建)。
*/
class SyncStoreReportPaidSales extends Command
{
protected $signature = 'business-mirror:sync-store-report-paid-sales
{--force : 忽略来源指纹,强制重建销量汇总}';
protected $description = '把业绩明细的订单实付/实收金额按店铺和发生日期汇总,供店铺维度报表销量列读取';
public function handle(StoreReportMirrorSynchronizer $synchronizer): int
{
try {
$result = $synchronizer->syncPaidSales((bool) $this->option('force'));
} catch (Throwable $exception) {
$this->error('店铺维度报表销量汇总失败:' . $exception->getMessage());
return self::FAILURE;
}
if ($result['status'] === 'skipped') {
$this->warn('镜像里还没有业绩明细表,销量汇总未执行。');
return self::SUCCESS;
}
if ($result['status'] !== 'succeeded') {
$this->error('店铺维度报表销量汇总失败,页面继续读取上一版数据。');
return self::FAILURE;
}
$this->info($result['changed']
? sprintf('销量汇总已重建:业绩明细 %d 行 → 汇总 %d 行。', $result['source_rows'], $result['stored_rows'])
: sprintf('业绩明细没有变化,沿用当前销量汇总(%d 行)。', $result['stored_rows']));
return self::SUCCESS;
}
}