Files
2026-03-13 11:37:37 +08:00

447 lines
14 KiB
PHP

<?php
declare(strict_types=1);
namespace HyperfTest\Cases\Integration\Refund;
use App\Model\Refund;
use HyperfTest\TestCase;
use HyperfTest\Traits\AuthenticatedTestTrait;
/**
* RefundController 集成测试
*
* 覆盖 Normal/Raw 列表详情、字段校验、退款状态/类型筛选、401/404
*
* @internal
* @coversNothing
*/
class RefundControllerTest extends TestCase
{
use AuthenticatedTestTrait;
protected function hasRefundData(): bool
{
return $this->runInCoroutine(static function (): bool {
return Refund::query()->exists();
});
}
protected function getFirstRefundId(): ?int
{
return $this->runInCoroutine(static function (): ?int {
return Refund::query()->value('id');
});
}
// ========== Normal 列表接口 ==========
public function test_normal_list_returns_paginated_data(): void
{
$response = $this->get('/api/v1/refunds', [], $this->authHeaders());
$response->assertStatus(200);
$response->assertJsonPath('code', 0);
$response->assertJsonStructure([
'code',
'message',
'data' => [
'items',
'total',
'page',
'per_page',
],
]);
}
public function test_normal_list_respects_per_page(): void
{
$response = $this->get('/api/v1/refunds', ['per_page' => 5], $this->authHeaders());
$response->assertStatus(200);
$response->assertJsonPath('data.per_page', 5);
}
public function test_normal_list_per_page_max_100(): void
{
$response = $this->get('/api/v1/refunds', ['per_page' => 999], $this->authHeaders());
$response->assertStatus(200);
$response->assertJsonPath('data.per_page', 100);
}
public function test_normal_list_excludes_raw_and_hash(): void
{
if (!$this->hasRefundData()) {
$this->markTestSkipped('没有退款数据');
}
$response = $this->get('/api/v1/refunds', [], $this->authHeaders());
$response->assertStatus(200);
$body = json_decode($response->getContent(), true);
$first_item = $body['data']['items'][0] ?? [];
$this->assertArrayNotHasKey('raw', $first_item);
$this->assertArrayNotHasKey('hash', $first_item);
}
public function test_normal_list_contains_expected_fields(): void
{
if (!$this->hasRefundData()) {
$this->markTestSkipped('没有退款数据');
}
$response = $this->get('/api/v1/refunds', [], $this->authHeaders());
$response->assertStatus(200);
$body = json_decode($response->getContent(), true);
$first_item = $body['data']['items'][0];
$expected_keys = [
'id', 'company_id', 'platform_id', 'store_id',
'platform_refund_id', 'platform_order_id',
'refund_status_id', 'refund_type_id',
'refund_amount', 'freight_refund', 'refund_total', 'currency',
'created_date', 'completed_date',
];
foreach ($expected_keys as $key) {
$this->assertArrayHasKey($key, $first_item, "列表缺少字段: {$key}");
}
}
// ========== Normal 列表筛选 ==========
public function test_normal_list_filter_by_company_id(): void
{
if (!$this->hasRefundData()) {
$this->markTestSkipped('没有退款数据');
}
$company_id = $this->runInCoroutine(static function (): mixed {
return Refund::query()->value('company_id');
});
$response = $this->get('/api/v1/refunds', ['company_id' => $company_id], $this->authHeaders());
$response->assertStatus(200);
$body = json_decode($response->getContent(), true);
foreach ($body['data']['items'] as $item) {
$this->assertSame($company_id, $item['company_id']);
}
}
public function test_normal_list_filter_by_refund_status_id(): void
{
if (!$this->hasRefundData()) {
$this->markTestSkipped('没有退款数据');
}
$status_id = $this->runInCoroutine(static function (): mixed {
return Refund::query()->value('refund_status_id');
});
$response = $this->get('/api/v1/refunds', ['refund_status_id' => $status_id], $this->authHeaders());
$response->assertStatus(200);
$body = json_decode($response->getContent(), true);
foreach ($body['data']['items'] as $item) {
$this->assertSame($status_id, $item['refund_status_id']);
}
}
public function test_normal_list_filter_by_refund_type_id(): void
{
if (!$this->hasRefundData()) {
$this->markTestSkipped('没有退款数据');
}
$type_id = $this->runInCoroutine(static function (): mixed {
return Refund::query()->value('refund_type_id');
});
$response = $this->get('/api/v1/refunds', ['refund_type_id' => $type_id], $this->authHeaders());
$response->assertStatus(200);
$body = json_decode($response->getContent(), true);
foreach ($body['data']['items'] as $item) {
$this->assertSame($type_id, $item['refund_type_id']);
}
}
public function test_normal_list_filter_by_platform_refund_id(): void
{
if (!$this->hasRefundData()) {
$this->markTestSkipped('没有退款数据');
}
$platform_refund_id = $this->runInCoroutine(static function (): mixed {
return Refund::query()->value('platform_refund_id');
});
$response = $this->get('/api/v1/refunds', ['platform_refund_id' => $platform_refund_id], $this->authHeaders());
$response->assertStatus(200);
$body = json_decode($response->getContent(), true);
foreach ($body['data']['items'] as $item) {
$this->assertSame($platform_refund_id, $item['platform_refund_id']);
}
}
public function test_normal_list_filter_by_platform_order_id(): void
{
if (!$this->hasRefundData()) {
$this->markTestSkipped('没有退款数据');
}
$platform_order_id = $this->runInCoroutine(static function (): mixed {
return Refund::query()->value('platform_order_id');
});
$response = $this->get('/api/v1/refunds', ['platform_order_id' => $platform_order_id], $this->authHeaders());
$response->assertStatus(200);
$body = json_decode($response->getContent(), true);
foreach ($body['data']['items'] as $item) {
$this->assertSame($platform_order_id, $item['platform_order_id']);
}
}
public function test_normal_list_filter_by_created_date_range(): void
{
if (!$this->hasRefundData()) {
$this->markTestSkipped('没有退款数据');
}
$response = $this->get('/api/v1/refunds', [
'created_date_from' => '2020-01-01',
'created_date_to' => '2099-12-31',
], $this->authHeaders());
$response->assertStatus(200);
$body = json_decode($response->getContent(), true);
$this->assertGreaterThanOrEqual(0, $body['data']['total']);
}
// ========== Normal 详情接口 ==========
public function test_normal_detail_returns_refund(): void
{
$id = $this->getFirstRefundId();
if (!$id) {
$this->markTestSkipped('没有退款数据');
}
$response = $this->get('/api/v1/refunds/' . $id, [], $this->authHeaders());
$response->assertStatus(200);
$response->assertJsonPath('code', 0);
$response->assertJsonPath('data.id', $id);
}
public function test_normal_detail_contains_ext(): void
{
$id = $this->getFirstRefundId();
if (!$id) {
$this->markTestSkipped('没有退款数据');
}
$response = $this->get('/api/v1/refunds/' . $id, [], $this->authHeaders());
$response->assertStatus(200);
$body = json_decode($response->getContent(), true);
$this->assertArrayHasKey('ext', $body['data']);
}
public function test_normal_detail_excludes_raw_and_hash(): void
{
$id = $this->getFirstRefundId();
if (!$id) {
$this->markTestSkipped('没有退款数据');
}
$response = $this->get('/api/v1/refunds/' . $id, [], $this->authHeaders());
$response->assertStatus(200);
$body = json_decode($response->getContent(), true);
$this->assertArrayNotHasKey('raw', $body['data']);
$this->assertArrayNotHasKey('hash', $body['data']);
}
public function test_normal_detail_contains_expected_fields(): void
{
$id = $this->getFirstRefundId();
if (!$id) {
$this->markTestSkipped('没有退款数据');
}
$response = $this->get('/api/v1/refunds/' . $id, [], $this->authHeaders());
$response->assertStatus(200);
$body = json_decode($response->getContent(), true);
$expected_keys = [
'id', 'company_id', 'platform_id', 'store_id',
'order_id', 'platform_order_id', 'platform_refund_id',
'buyer_user_id', 'refund_status_id', 'refund_type_id',
'reason', 'refund_amount', 'freight_refund', 'refund_total', 'currency',
'order_created_date', 'order_paid_date',
'created_date', 'updated_date', 'completed_date',
'ext', 'created_at', 'updated_at',
];
foreach ($expected_keys as $key) {
$this->assertArrayHasKey($key, $body['data'], "详情缺少字段: {$key}");
}
}
public function test_normal_detail_not_found_returns_404(): void
{
$response = $this->get('/api/v1/refunds/999999999', [], $this->authHeaders());
$response->assertStatus(404);
$response->assertJsonPath('code', 404);
}
// ========== Raw 列表接口 ==========
public function test_raw_list_returns_paginated_data(): void
{
$response = $this->get('/api/v1/raw/refunds', [], $this->authHeaders());
$response->assertStatus(200);
$response->assertJsonPath('code', 0);
$response->assertJsonStructure([
'code',
'message',
'data' => [
'items',
'total',
'page',
'per_page',
],
]);
}
public function test_raw_list_contains_hash_but_not_raw(): void
{
if (!$this->hasRefundData()) {
$this->markTestSkipped('没有退款数据');
}
$response = $this->get('/api/v1/raw/refunds', [], $this->authHeaders());
$response->assertStatus(200);
$body = json_decode($response->getContent(), true);
$first_item = $body['data']['items'][0] ?? [];
$this->assertArrayHasKey('hash', $first_item, 'Raw 列表应包含 hash 字段');
$this->assertArrayNotHasKey('raw', $first_item, 'Raw 列表不应包含 raw 字段(太大)');
}
public function test_raw_list_excludes_business_fields(): void
{
if (!$this->hasRefundData()) {
$this->markTestSkipped('没有退款数据');
}
$response = $this->get('/api/v1/raw/refunds', [], $this->authHeaders());
$response->assertStatus(200);
$body = json_decode($response->getContent(), true);
$first_item = $body['data']['items'][0] ?? [];
// Raw 列表不应包含业务字段
$this->assertArrayNotHasKey('refund_amount', $first_item);
$this->assertArrayNotHasKey('freight_refund', $first_item);
$this->assertArrayNotHasKey('refund_total', $first_item);
$this->assertArrayNotHasKey('buyer_user_id', $first_item);
$this->assertArrayNotHasKey('reason', $first_item);
}
// ========== Raw 详情接口 ==========
public function test_raw_detail_contains_raw_and_hash(): void
{
$id = $this->getFirstRefundId();
if (!$id) {
$this->markTestSkipped('没有退款数据');
}
$response = $this->get('/api/v1/raw/refunds/' . $id, [], $this->authHeaders());
$response->assertStatus(200);
$body = json_decode($response->getContent(), true);
$this->assertArrayHasKey('raw', $body['data'], 'Raw 详情应包含 raw 字段');
$this->assertArrayHasKey('hash', $body['data'], 'Raw 详情应包含 hash 字段');
$this->assertArrayHasKey('ext', $body['data'], 'Raw 详情应包含 ext 字段');
}
public function test_raw_detail_excludes_business_fields(): void
{
$id = $this->getFirstRefundId();
if (!$id) {
$this->markTestSkipped('没有退款数据');
}
$response = $this->get('/api/v1/raw/refunds/' . $id, [], $this->authHeaders());
$response->assertStatus(200);
$body = json_decode($response->getContent(), true);
// Raw 详情不应包含业务字段
$this->assertArrayNotHasKey('refund_amount', $body['data']);
$this->assertArrayNotHasKey('freight_refund', $body['data']);
$this->assertArrayNotHasKey('buyer_user_id', $body['data']);
$this->assertArrayNotHasKey('reason', $body['data']);
}
public function test_raw_detail_not_found_returns_404(): void
{
$response = $this->get('/api/v1/raw/refunds/999999999', [], $this->authHeaders());
$response->assertStatus(404);
$response->assertJsonPath('code', 404);
}
// ========== 认证拦截 ==========
public function test_normal_list_without_token_returns_401(): void
{
$response = $this->get('/api/v1/refunds');
$response->assertStatus(401);
}
public function test_normal_detail_without_token_returns_401(): void
{
$response = $this->get('/api/v1/refunds/1');
$response->assertStatus(401);
}
public function test_raw_list_without_token_returns_401(): void
{
$response = $this->get('/api/v1/raw/refunds');
$response->assertStatus(401);
}
public function test_raw_detail_without_token_returns_401(): void
{
$response = $this->get('/api/v1/raw/refunds/1');
$response->assertStatus(401);
}
}