CaiWuXiTong/tests/Unit/EcommerceFinance/StoreReceivingBalanceOverviewServiceTest.php
qiuxiang 4de11d6d95 perf(账户余额): 按平台分页加载店铺每日余额 (#1275)
拆分平台与店铺每日余额接口,店铺数据按平台、搜索和页码懒加载,降低首屏响应体积。
2026-11-19 16:08:14 +08:00

516 lines
20 KiB
PHP

<?php
namespace Tests\Unit\EcommerceFinance;
use Modules\EcommerceFinance\Services\StoreReceivingBalanceOverviewService;
use PHPUnit\Framework\TestCase;
class StoreReceivingBalanceOverviewServiceTest extends TestCase
{
public function test_overview_sums_all_eight_platforms_for_the_selected_month(): void
{
$seenPeriods = [];
$service = $this->service(function (string $platform, string $start, string $end) use (&$seenPeriods): array {
$seenPeriods[] = [$platform, $start, $end];
$index = array_search($platform, array_column(StoreReceivingBalanceOverviewService::PLATFORMS, 'slug'), true) + 1;
return [
'opening_balance' => 100.10 * $index,
'income' => 10.20 * $index,
'expense' => 1.25 * $index,
];
});
$result = $service->overview('2026-10');
$this->assertSame('2026-10', $result['month']);
$this->assertSame(['start' => '2026-10-01', 'end' => '2026-10-31'], $result['period']);
$this->assertCount(8, $result['platforms']);
$this->assertCount(8, $seenPeriods);
$this->assertSame('taobao-alipay', $seenPeriods[0][0]);
$this->assertSame('xiaohongshu', $seenPeriods[7][0]);
$this->assertSame(3603.60, $result['summary']['opening_balance']);
$this->assertSame(367.20, $result['summary']['income']);
$this->assertSame(45.00, $result['summary']['expense']);
$this->assertSame(3925.80, $result['summary']['balance']);
$this->assertTrue($result['summary']['complete']);
$this->assertSame(8, $result['summary']['available_platform_count']);
}
public function test_overview_does_not_report_a_total_when_an_opening_balance_is_missing(): void
{
$service = $this->service(function (string $platform): array {
return [
'opening_balance' => $platform === 'vipshop-jx' ? null : 25.0,
'income' => 5.0,
'expense' => 2.0,
];
});
$result = $service->overview('2026-09');
$this->assertFalse($result['summary']['complete']);
$this->assertNull($result['summary']['opening_balance']);
$this->assertNull($result['summary']['income']);
$this->assertNull($result['summary']['expense']);
$this->assertNull($result['summary']['balance']);
$this->assertSame(7, $result['summary']['available_platform_count']);
$vipshopJx = array_values(array_filter(
$result['platforms'],
static fn (array $platform): bool => $platform['slug'] === 'vipshop-jx',
))[0];
$this->assertFalse($vipshopJx['available']);
}
public function test_overview_uses_an_explicit_date_range_for_all_platforms(): void
{
$seenPeriods = [];
$service = $this->service(function (string $platform, string $start, string $end) use (&$seenPeriods): array {
$seenPeriods[] = [$platform, $start, $end];
return [
'opening_balance' => 10.0,
'income' => 2.0,
'expense' => 1.0,
];
});
$result = $service->overview('2026-10-05', '2026-10-20');
$this->assertSame(['start' => '2026-10-05', 'end' => '2026-10-20'], $result['period']);
$this->assertCount(8, $seenPeriods);
$this->assertSame(['taobao-alipay', '2026-10-05', '2026-10-20'], $seenPeriods[0]);
$this->assertSame(['xiaohongshu', '2026-10-05', '2026-10-20'], $seenPeriods[7]);
$this->assertTrue($result['summary']['complete']);
}
public function test_income_detail_groups_platform_store_and_bill_item_rows(): void
{
$service = new class extends StoreReceivingBalanceOverviewService {
public function __construct()
{
}
protected function fetchPlatformIncomeRows(string $platform, string $start, string $end): iterable
{
$index = array_search($platform, array_column(StoreReceivingBalanceOverviewService::PLATFORMS, 'slug'), true) + 1;
yield [
'store_name' => '店铺-' . $index,
'bill_item' => '货款收入',
'income' => 100.10 * $index,
];
yield [
'store_name' => '店铺-' . $index,
'bill_item' => '货款收入',
'income' => 0.20 * $index,
];
yield [
'store_name' => '店铺-' . $index,
'bill_item' => '退款',
'income' => 0,
];
}
};
$result = $service->incomeDetail('2026-10');
$this->assertSame('2026-10', $result['month']);
$this->assertSame(['start' => '2026-10-01', 'end' => '2026-10-31'], $result['period']);
$this->assertCount(8, $result['details']);
$this->assertSame([
'platform_slug' => 'taobao-alipay',
'platform' => '淘系支付宝账户',
'store_name' => '店铺-1',
'bill_item' => '货款收入',
'amount' => 100.30,
], $result['details'][0]);
$this->assertSame('xiaohongshu', $result['details'][7]['platform_slug']);
$this->assertSame(3610.80, $result['summary']['income']);
$this->assertTrue($result['summary']['complete']);
$this->assertSame(8, $result['summary']['available_platform_count']);
}
public function test_expense_detail_groups_platform_store_and_bill_item_rows(): void
{
$service = new class extends StoreReceivingBalanceOverviewService {
public function __construct()
{
}
protected function fetchPlatformExpenseRows(string $platform, string $start, string $end): iterable
{
$index = array_search($platform, array_column(StoreReceivingBalanceOverviewService::PLATFORMS, 'slug'), true) + 1;
yield [
'store_name' => '店铺-' . $index,
'bill_item' => '平台扣费',
'expense' => 20.10 * $index,
];
yield [
'store_name' => '店铺-' . $index,
'bill_item' => '平台扣费',
'expense' => 0.20 * $index,
];
yield [
'store_name' => '店铺-' . $index,
'bill_item' => '退款',
'expense' => 0,
];
}
};
$result = $service->expenseDetail('2026-10');
$this->assertSame('2026-10', $result['month']);
$this->assertSame(['start' => '2026-10-01', 'end' => '2026-10-31'], $result['period']);
$this->assertCount(8, $result['details']);
$this->assertSame([
'platform_slug' => 'taobao-alipay',
'platform' => '淘系支付宝账户',
'store_name' => '店铺-1',
'bill_item' => '平台扣费',
'amount' => 20.30,
], $result['details'][0]);
$this->assertSame('xiaohongshu', $result['details'][7]['platform_slug']);
$this->assertSame(730.80, $result['summary']['expense']);
$this->assertArrayNotHasKey('income', $result['summary']);
$this->assertTrue($result['summary']['complete']);
$this->assertSame(8, $result['summary']['available_platform_count']);
}
public function test_balance_detail_uses_each_platform_closing_balance(): void
{
$service = $this->service(function (string $platform): array {
$index = array_search($platform, array_column(StoreReceivingBalanceOverviewService::PLATFORMS, 'slug'), true) + 1;
return [
'opening_balance' => 100.10 * $index,
'income' => 10.20 * $index,
'expense' => 1.25 * $index,
];
});
$result = $service->balanceDetail('2026-10');
$this->assertSame('2026-10', $result['month']);
$this->assertSame(['start' => '2026-10-01', 'end' => '2026-10-31'], $result['period']);
$this->assertCount(8, $result['details']);
$this->assertSame([
'platform_slug' => 'taobao-alipay',
'platform' => '淘系支付宝账户',
'store_name' => '',
'bill_item' => '',
'amount' => 109.05,
], $result['details'][0]);
$this->assertSame('xiaohongshu', $result['details'][7]['platform_slug']);
$this->assertSame(872.40, $result['details'][7]['amount']);
$this->assertSame(3925.80, $result['summary']['balance']);
$this->assertTrue($result['summary']['complete']);
$this->assertSame(8, $result['summary']['available_platform_count']);
}
public function test_balance_store_detail_calculates_each_store_closing_balance(): void
{
$service = new class extends StoreReceivingBalanceOverviewService {
public function __construct()
{
}
protected function fetchPlatformStoreBalances(string $platform, string $start, string $end): array
{
$index = array_search($platform, array_column(StoreReceivingBalanceOverviewService::PLATFORMS, 'slug'), true) + 1;
return [[
'store_name' => '店铺-' . $index,
'opening_balance' => 100.10 * $index,
'income' => 10.20 * $index,
'expense' => 1.25 * $index,
]];
}
};
$result = $service->balanceStoreDetail('2026-10');
$this->assertSame('2026-10', $result['month']);
$this->assertSame(['start' => '2026-10-01', 'end' => '2026-10-31'], $result['period']);
$this->assertCount(8, $result['details']);
$this->assertSame([
'platform_slug' => 'taobao-alipay',
'platform' => '淘系支付宝账户',
'store_name' => '店铺-1',
'bill_item' => '',
'opening_balance' => 100.10,
'income' => 10.20,
'expense' => 1.25,
'amount' => 109.05,
'available' => true,
], $result['details'][0]);
$this->assertSame(3925.80, $result['summary']['balance']);
$this->assertSame(8, $result['summary']['store_count']);
$this->assertSame(8, $result['summary']['ready_store_count']);
$this->assertTrue($result['summary']['complete']);
}
public function test_balance_store_detail_marks_missing_opening_instead_of_using_zero(): void
{
$service = new class extends StoreReceivingBalanceOverviewService {
public function __construct()
{
}
protected function fetchPlatformStoreBalances(string $platform, string $start, string $end): array
{
return [[
'store_name' => '待补期初店铺',
'opening_balance' => $platform === 'vipshop-jx' ? null : 25.0,
'income' => 5.0,
'expense' => 2.0,
]];
}
};
$result = $service->balanceStoreDetail('2026-10');
$this->assertFalse($result['summary']['complete']);
$this->assertNull($result['summary']['balance']);
$this->assertSame(7, $result['summary']['ready_store_count']);
$unavailable = array_values(array_filter(
$result['details'],
static fn (array $row): bool => $row['platform_slug'] === 'vipshop-jx',
))[0];
$this->assertNull($unavailable['opening_balance']);
$this->assertNull($unavailable['amount']);
$this->assertFalse($unavailable['available']);
}
public function test_balance_store_detail_merges_duplicate_store_rows_without_creating_zero_opening(): void
{
$service = new class extends StoreReceivingBalanceOverviewService {
public function __construct()
{
}
protected function fetchPlatformStoreBalances(string $platform, string $start, string $end): array
{
return [[
'store_name' => '重复店铺',
'opening_balance' => null,
'income' => 5.0,
'expense' => 0.0,
], [
'store_name' => '重复店铺',
'opening_balance' => null,
'income' => 0.0,
'expense' => 2.0,
]];
}
};
$result = $service->balanceStoreDetail('2026-10');
$rows = array_values(array_filter(
$result['details'],
static fn (array $row): bool => $row['store_name'] === '重复店铺',
));
$this->assertCount(1, $rows);
$this->assertNull($rows[0]['opening_balance']);
$this->assertSame(5.0, $rows[0]['income']);
$this->assertSame(2.0, $rows[0]['expense']);
$this->assertNull($rows[0]['amount']);
}
public function test_store_balances_for_platforms_filters_and_aggregates_reconciliation_sources(): void
{
$service = new class extends StoreReceivingBalanceOverviewService {
public function __construct()
{
}
protected function fetchPlatformStoreBalances(string $platform, string $start, string $end): array
{
if ($platform === 'taobao-alipay') {
return [[
'store_name' => '淘系店铺',
'opening_balance' => 100.0,
'income' => 20.0,
'expense' => 5.0,
], [
'store_name' => '淘系店铺',
'opening_balance' => 50.0,
'income' => 10.0,
'expense' => 2.0,
], [
'store_name' => '待补期初店铺',
'opening_balance' => null,
'income' => 8.0,
'expense' => 0.0,
]];
}
return [[
'store_name' => '拼多多店铺',
'opening_balance' => 300.0,
'income' => 40.0,
'expense' => 10.0,
]];
}
};
$result = $service->storeBalancesForPlatforms(
['taobao-alipay', 'pinduoduo'],
'2026-10-01',
'2026-10-31',
);
$this->assertSame(['start' => '2026-10-01', 'end' => '2026-10-31'], $result['period']);
$this->assertSame([], $result['errors']);
$this->assertCount(3, $result['rows']);
$this->assertSame('taobao-alipay', $result['rows'][0]['platform_slug']);
$this->assertSame('淘系店铺', $result['rows'][0]['store_name']);
$this->assertSame(150.0, $result['rows'][0]['opening_balance']);
$this->assertSame(30.0, $result['rows'][0]['income']);
$this->assertSame(7.0, $result['rows'][0]['expense']);
$this->assertSame(173.0, $result['rows'][0]['amount']);
$this->assertNull($result['rows'][1]['amount']);
$this->assertSame('pinduoduo', $result['rows'][2]['platform_slug']);
$this->assertSame(330.0, $result['rows'][2]['amount']);
}
public function test_daily_balances_roll_platform_and_store_opening_balances(): void
{
$service = new class extends StoreReceivingBalanceOverviewService {
public function __construct()
{
}
protected function fetchPlatformSummary(string $platform, string $start, string $end): array
{
return [
'opening_balance' => 100.0,
'income' => 15.0,
'expense' => 6.0,
];
}
protected function fetchPlatformStoreBalances(string $platform, string $start, string $end): array
{
$index = array_search($platform, array_column(StoreReceivingBalanceOverviewService::PLATFORMS, 'slug'), true) + 1;
return [[
'store_name' => '店铺-' . $index,
'opening_balance' => 100.0,
'income' => 15.0,
'expense' => 6.0,
]];
}
protected function fetchPlatformDailyRows(string $platform, string $start, string $end): iterable
{
$index = array_search($platform, array_column(StoreReceivingBalanceOverviewService::PLATFORMS, 'slug'), true) + 1;
yield [
'store_name' => '店铺-' . $index,
'occurred_at' => '2026-10-01 12:00:00',
'income' => 10.0,
'expense' => 2.0,
];
yield [
'store_name' => '店铺-' . $index,
'occurred_at' => '2026-10-02 12:00:00',
'income' => 5.0,
'expense' => 4.0,
];
}
};
$result = $service->dailyBalances('2026-10-01', '2026-10-03');
$this->assertSame(['2026-10-01', '2026-10-02', '2026-10-03'], $result['dates']);
$this->assertSame(108.0, $result['daily_summary']['2026-10-01']['closing'] / 8);
$this->assertSame(109.0, $result['daily_summary']['2026-10-02']['closing'] / 8);
$this->assertSame(109.0, $result['daily_summary']['2026-10-03']['closing'] / 8);
$this->assertTrue($result['platforms'][0]['daily_reconciled']);
$storeResult = $service->dailyBalanceStores(
'2026-10-01',
'2026-10-03',
'taobao-alipay',
'',
1,
30,
);
$this->assertSame(1, $storeResult['pagination']['total']);
$this->assertSame('店铺-1', $storeResult['rows'][0]['store_name']);
$this->assertSame(100.0, $storeResult['rows'][0]['opening_balance']);
$this->assertSame(109.0, $storeResult['rows'][0]['amount']);
$this->assertTrue($storeResult['rows'][0]['daily']['2026-10-03']['available']);
}
public function test_daily_store_balance_stays_unavailable_when_opening_is_missing(): void
{
$service = new class extends StoreReceivingBalanceOverviewService {
public function __construct()
{
}
protected function fetchPlatformSummary(string $platform, string $start, string $end): array
{
return ['opening_balance' => 100.0, 'income' => 10.0, 'expense' => 2.0];
}
protected function fetchPlatformStoreBalances(string $platform, string $start, string $end): array
{
return [[
'store_name' => '待补期初店铺-' . $platform,
'opening_balance' => null,
'income' => 10.0,
'expense' => 2.0,
]];
}
protected function fetchPlatformDailyRows(string $platform, string $start, string $end): iterable
{
yield [
'store_name' => '待补期初店铺-' . $platform,
'occurred_at' => '2026-10-01 12:00:00',
'income' => 10.0,
'expense' => 2.0,
];
}
};
$result = $service->dailyBalanceStores(
'2026-10-01',
'2026-10-01',
'taobao-alipay',
'',
1,
30,
);
$this->assertFalse($result['rows'][0]['daily']['2026-10-01']['available']);
$this->assertNull($result['rows'][0]['daily']['2026-10-01']['closing']);
$this->assertSame(0, $result['summary']['available_store_count']);
}
private function service(callable $summary): StoreReceivingBalanceOverviewService
{
return new class($summary) extends StoreReceivingBalanceOverviewService {
public function __construct(private $summaryCallback)
{
}
protected function fetchPlatformSummary(string $platform, string $start, string $end): array
{
return ($this->summaryCallback)($platform, $start, $end);
}
protected function fetchPlatformStoreBalances(string $platform, string $start, string $end): array
{
return [];
}
};
}
}