店铺维度报表(店铺管理 → 店铺维度报表)的销量原来按平台账单收入汇总,改为按 业绩明细(店铺收款匹配订单明细)的「订单实付/实收金额」汇总: - 新增镜像表 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 个断言通过。
51 lines
1.9 KiB
PHP
51 lines
1.9 KiB
PHP
<?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;
|
||
}
|
||
}
|