feat(core,board,ecommerce,page): 성능 계측 인프라 4축 확장 및 계측 대상 선언 지점 신설
계측 축이 "목록 SELECT" 하나였고 프로파일 12종이 커맨드 파일에 하드코딩돼 있어 확장이 자기 대상을 추가할 수 없었다. 확장이 설치·제거되는 설치본마다 "실제로 존재하는 대상"이 달라지므로, 대상을 소유자가 선언하고 코어가 수집하도록 뒤집었다. - 선언 지점 두 곳, 스키마 하나: 코어 config/benchmark.php, 확장 getBenchmarkProfiles (모듈/플러그인). 수집은 method_exists 기반이라 인터페이스를 직접 구현한 서드파티 확장이 깨지지 않는다. - 축 4종(목록/화면/쓰기/배치)을 실행기로 분리하고 컨테이너 태그로 주입 — 축이 늘 때 커맨드를 고치지 않는다. - 화면 축은 HTTP 커널로 내부 요청을 처리한다. 라우트만 dispatch 하면 전역 미들웨어를 건너뛰어 화면과 다른 것을 재게 된다. 인증은 프로파일이 선언한 권한만 가진 임시 계정이 기본이며 --as 로 기존 계정을 지목할 수 있다. - 화면/쓰기 축은 계측 계정 생성부터 처리까지 롤백되는 트랜잭션 안에서 실행해 운영 DB 에도 잔여 데이터를 남기지 않는다. 배치 축은 내부 커밋·락 보유 때문에 감싸지 않고 --allow-write 로만 통제한다. - 잘못된 선언은 조용히 버리지 않고 사유를 경고로 남긴다. 버려진 선언이 곧 계측 사각이 되기 때문이다. 전부 건너뛴 실행은 종료 코드 1 로 끝난다. - 리포트는 환경 정보를 함께 적어 저장소 밖(storage/app/benchmarks)에 남긴다. 측정값이 실행 머신에 종속되므로 저장소에 축적하면 비교 불가능한 수치가 섞인다. 작업 중 발견해 함께 고친 것: - 이관 프로파일 3종의 soft_delete 선언이 실제 스키마와 어긋나 있었다 (users/product_inquiries/pages 에 deleted_at 없음). - 주문 목록이 상태 미지정 시 임시 주문 상태를 NOT IN 으로 제외하는데 선언에 빠져 있었다. filters 가 등가 비교만 지원한 것이 근본 원인이라 연산자 형태를 받도록 넓히고, 미허용 연산자는 측정 전에 거부한다. - 댓글 프로파일은 지배적 술어가 상관 서브쿼리라 선언형으로 재현할 수 없어 제거했다. 맨 테이블 스캔은 어느 화면도 내지 않는 수치가 된다. g7:bench:pagination → g7:bench 로 개명(4축을 재므로). 이전 이름은 별칭으로 남겼다. 테스트 61건 통과, 라이브 18종 전건 측정.
This commit is contained in:
1 parent
be9befe023
commit
5f4a733b3b
40 files changed
+5266
-567
No files matched your search
@@ -848,6 +848,50 @@ class Module extends AbstractModule
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 성능 계측 프로파일 정의 (`g7:bench`).
|
||||
*
|
||||
* 게시글 목록의 `columns` 는 `PostRepository::paginate()` 가 select 하는 컬럼 집합입니다
|
||||
* (본문 미리보기용 `SUBSTRING` 표현식은 지연 조인의 outer 에서만 적용되고 계측 대상인
|
||||
* 건너뛰기 비용과 무관하므로 제외). 게시글 목록은 화면이 게시판 하나를 조회하므로 필터
|
||||
* 없이 재면 인덱스 선택이 달라져 화면에서 일어나는 일과 다른 것을 재게 됩니다.
|
||||
*
|
||||
* @return array<string, array<string, mixed>> 프로파일 키 → 정의
|
||||
*/
|
||||
public function getBenchmarkProfiles(): array
|
||||
{
|
||||
return [
|
||||
'board_posts' => [
|
||||
'type' => 'list',
|
||||
'label' => '게시글 목록',
|
||||
'table' => 'board_posts',
|
||||
'columns' => [
|
||||
'id', 'board_id', 'user_id', 'parent_id', 'category',
|
||||
'title', 'author_name', 'content_mode',
|
||||
'is_notice', 'is_secret', 'status', 'depth',
|
||||
'view_count', 'comments_count', 'replies_count', 'attachments_count',
|
||||
'trigger_type', 'ip_address', 'created_at', 'updated_at', 'deleted_at',
|
||||
],
|
||||
'order' => [['created_at', 'desc'], ['id', 'desc']],
|
||||
'filters' => ['board_id' => 1],
|
||||
'seed_overrides' => ['board_id' => 1, 'is_notice' => 0],
|
||||
'soft_delete' => true,
|
||||
],
|
||||
// 댓글은 계측 프로파일을 두지 않는다. 페이지네이션되는 댓글 목록은 회원 본인 댓글
|
||||
// 목록뿐이고(CommentRepository), 그 쿼리에는 회원 스코프 · 삭제 게시글 제외
|
||||
// (whereExists 서브쿼리) · 비활성 게시판 제외가 무조건 붙는다. 선언형 필터로
|
||||
// 재현할 수 없는 술어라, 맨 테이블 스캔을 재면 어느 화면도 내지 않는 수치가 된다.
|
||||
'reports' => [
|
||||
'type' => 'list',
|
||||
'label' => '신고 목록',
|
||||
'table' => 'boards_reports',
|
||||
'columns' => ['*'],
|
||||
'order' => [['created_at', 'desc'], ['id', 'desc']],
|
||||
'soft_delete' => true,
|
||||
],
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 새 댓글 알림 정의.
|
||||
*/
|
||||
|
||||
@@ -6,9 +6,11 @@ use App\Extension\AbstractModule;
|
||||
use App\Models\IdentityMessageDefinition;
|
||||
use App\Seo\Concerns\LocalizesSeoValues;
|
||||
use Illuminate\Database\Seeder;
|
||||
use Modules\Sirsoft\Ecommerce\Benchmark\OrderCreationBenchmark;
|
||||
use Modules\Sirsoft\Ecommerce\Database\Seeders\ClaimReasonSeeder;
|
||||
use Modules\Sirsoft\Ecommerce\Database\Seeders\SequenceSeeder;
|
||||
use Modules\Sirsoft\Ecommerce\Database\Seeders\ShippingCarrierSeeder;
|
||||
use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
|
||||
use Modules\Sirsoft\Ecommerce\Http\Middleware\DetectDevice;
|
||||
use Modules\Sirsoft\Ecommerce\Http\Middleware\ResolveShippingCountry;
|
||||
use Modules\Sirsoft\Ecommerce\Http\Middleware\VerifyGuestOrderToken;
|
||||
@@ -40,6 +42,7 @@ use Modules\Sirsoft\Ecommerce\Listeners\UserCurrencyInfoListener;
|
||||
use Modules\Sirsoft\Ecommerce\Listeners\UserMileageCleanupListener;
|
||||
use Modules\Sirsoft\Ecommerce\Listeners\UserMileageInfoListener;
|
||||
use Modules\Sirsoft\Ecommerce\Listeners\UserShippingCountryInfoListener;
|
||||
use Modules\Sirsoft\Ecommerce\Repositories\OrderRepository;
|
||||
|
||||
class Module extends AbstractModule
|
||||
{
|
||||
@@ -1242,6 +1245,89 @@ class Module extends AbstractModule
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 성능 계측 프로파일 정의 (`g7:bench`).
|
||||
*
|
||||
* 목록 프로파일의 `columns` 는 해당 목록이 실제로 select 하는 컬럼이어야 합니다. 주문
|
||||
* 목록은 Repository 가 상수로 들고 있으므로 그 상수를 그대로 참조합니다 — 여기에 컬럼을
|
||||
* 다시 적으면 Repository 변경 시 계측이 조용히 낡습니다. 나머지 목록의 `['*']` 는
|
||||
* "응답 계약상 전 컬럼을 노출해 프루닝 불가" 선언이며, 이때 비교축은 select * vs select id
|
||||
* 입니다.
|
||||
*
|
||||
* @return array<string, array<string, mixed>> 프로파일 키 → 정의
|
||||
*/
|
||||
public function getBenchmarkProfiles(): array
|
||||
{
|
||||
return [
|
||||
'orders' => [
|
||||
'type' => 'list',
|
||||
'label' => '주문 목록',
|
||||
'table' => 'ecommerce_orders',
|
||||
'columns' => OrderRepository::LIST_COLUMNS,
|
||||
'order' => [['ordered_at', 'desc'], ['id', 'desc']],
|
||||
// 관리자 주문 목록은 상태 미지정 시 임시 주문 상태를 제외한다
|
||||
// (OrderRepository::getListWithFilters). 이 술어를 빼고 재면 옵티마이저가 다른
|
||||
// 인덱스를 골라 화면에서 일어나는 일과 다른 것을 잰다. 값은 Enum SSoT 를 참조한다.
|
||||
'filters' => ['order_status' => ['not in', OrderStatusEnum::listHiddenValues()]],
|
||||
'soft_delete' => true,
|
||||
],
|
||||
'products' => [
|
||||
'type' => 'list',
|
||||
'label' => '상품 목록',
|
||||
'table' => 'ecommerce_products',
|
||||
'columns' => ['*'],
|
||||
'order' => [['created_at', 'desc'], ['id', 'desc']],
|
||||
'soft_delete' => true,
|
||||
],
|
||||
// 상품 문의는 소프트 삭제 컬럼이 없다 — 실제 스키마 기준 선언
|
||||
'product_inquiries' => [
|
||||
'type' => 'list',
|
||||
'label' => '상품 문의 목록',
|
||||
'table' => 'ecommerce_product_inquiries',
|
||||
'columns' => ['*'],
|
||||
'order' => [['created_at', 'desc'], ['id', 'desc']],
|
||||
'soft_delete' => false,
|
||||
],
|
||||
'product_reviews' => [
|
||||
'type' => 'list',
|
||||
'label' => '상품 후기 목록',
|
||||
'table' => 'ecommerce_product_reviews',
|
||||
'columns' => ['*'],
|
||||
'order' => [['created_at', 'desc'], ['id', 'desc']],
|
||||
'soft_delete' => true,
|
||||
],
|
||||
'coupon_issues' => [
|
||||
'type' => 'list',
|
||||
'label' => '쿠폰 발급 이력 목록',
|
||||
'table' => 'ecommerce_promotion_coupon_issues',
|
||||
'columns' => ['*'],
|
||||
'order' => [['issued_at', 'desc'], ['id', 'desc']],
|
||||
'soft_delete' => false,
|
||||
],
|
||||
'extra_fee_templates' => [
|
||||
'type' => 'list',
|
||||
'label' => '추가 배송비 템플릿 목록',
|
||||
'table' => 'ecommerce_shipping_policy_extra_fee_templates',
|
||||
'columns' => ['*'],
|
||||
'order' => [['zipcode', 'asc'], ['id', 'asc']],
|
||||
'soft_delete' => false,
|
||||
],
|
||||
'orders_screen' => [
|
||||
'type' => 'screen',
|
||||
'label' => '관리자 주문 목록 화면',
|
||||
'route' => 'api.modules.sirsoft-ecommerce.admin.orders.index',
|
||||
'query' => ['per_page' => 20],
|
||||
'permissions' => ['sirsoft-ecommerce.orders.read'],
|
||||
],
|
||||
'order_create' => [
|
||||
'type' => 'write',
|
||||
'label' => '주문 생성 (임시 주문 → 주문 전환)',
|
||||
'prepare' => [OrderCreationBenchmark::class, 'prepare'],
|
||||
'callback' => [OrderCreationBenchmark::class, 'create'],
|
||||
],
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 무통장입금 입금 안내 알림 정의.
|
||||
*
|
||||
|
||||
@@ -0,0 +1,116 @@
|
||||
<?php
|
||||
|
||||
namespace Modules\Sirsoft\Ecommerce\Benchmark;
|
||||
|
||||
use App\Models\User;
|
||||
use Illuminate\Support\Facades\Auth;
|
||||
use Modules\Sirsoft\Ecommerce\Models\Order;
|
||||
use Modules\Sirsoft\Ecommerce\Models\Product;
|
||||
use Modules\Sirsoft\Ecommerce\Models\ProductOption;
|
||||
use Modules\Sirsoft\Ecommerce\Models\TempOrder;
|
||||
use Modules\Sirsoft\Ecommerce\Services\OrderProcessingService;
|
||||
use Modules\Sirsoft\Ecommerce\Services\TempOrderService;
|
||||
|
||||
/**
|
||||
* 주문 생성 계측 대상 — `g7:bench` write 축이 실행하는 저장 경로
|
||||
*
|
||||
* 주문 생성은 재고 차감·쿠폰 소진·마일리지 적립·알림 발행이 한 트랜잭션에 얽힌 저장
|
||||
* 경로이므로, 계측 커맨드가 쿼리를 스스로 조립해 재는 방식으로는 실제 비용을 알 수 없습니다.
|
||||
* 그래서 이 클래스가 실제 서비스 경로(`OrderProcessingService::createFromTempOrder`)를
|
||||
* 호출하고, 커맨드는 시간·쿼리 건수만 잽니다.
|
||||
*
|
||||
* 임시 주문을 팩토리로 직접 조립하지 않고 실제 서비스(`TempOrderService`)로 만드는 이유는,
|
||||
* `createFromTempOrder` 가 저장된 계산 파라미터로 금액을 **재계산해 저장값과 대조**하기
|
||||
* 때문입니다. 손으로 만든 계산 결과는 재계산값과 어긋나 `OrderAmountChangedException` 으로
|
||||
* 막히며, 어긋나지 않게 맞추더라도 그때는 실제 결제 경로가 아닌 다른 것을 재게 됩니다.
|
||||
*
|
||||
* 준비(`prepare`)는 계측 구간 밖에서 회차마다 실행됩니다 — 임시 주문은 한 번만 주문으로
|
||||
* 전환되므로 회차마다 새로 필요하고, 그 준비 비용이 측정값에 섞이면 안 됩니다. 여기서 만든
|
||||
* 상품·회원·주문은 계측 커맨드가 감싼 트랜잭션 롤백으로 전부 되돌아갑니다.
|
||||
*/
|
||||
class OrderCreationBenchmark
|
||||
{
|
||||
public function __construct(
|
||||
private readonly TempOrderService $tempOrderService,
|
||||
private readonly OrderProcessingService $orderProcessingService,
|
||||
) {}
|
||||
|
||||
/**
|
||||
* 계측 회차 1건에 필요한 선행 상태를 준비합니다. (계측 구간 밖)
|
||||
*
|
||||
* 기존 상품을 골라 쓰지 않고 매 회차 새로 만드는 이유는, 설치본마다 상품 구성·재고·
|
||||
* 판매상태가 달라 같은 조건에서 재고 있는 단일 옵션 상품 1건을 스스로 세우는 편이
|
||||
* 회차 간·환경 간 비교 가능성을 보장하기 때문입니다.
|
||||
*
|
||||
* @param int $run 계측 회차 번호
|
||||
* @return array{temp_order: TempOrder, user: User, expected_total_amount: float} 계측 컨텍스트
|
||||
*/
|
||||
public function prepare(int $run): array
|
||||
{
|
||||
$user = User::factory()->create();
|
||||
|
||||
$product = Product::factory()->create([
|
||||
'stock_quantity' => 10000,
|
||||
'has_options' => false,
|
||||
'option_groups' => null,
|
||||
// 기본 배송정책 해석에 맡긴다 — 특정 정책을 지목하면 그 정책의 비용만 재게 된다
|
||||
'shipping_policy_id' => null,
|
||||
]);
|
||||
|
||||
$option = ProductOption::factory()->forProduct($product)->create([
|
||||
'stock_quantity' => 10000,
|
||||
'price_adjustment' => 0,
|
||||
'is_default' => true,
|
||||
'is_active' => true,
|
||||
]);
|
||||
|
||||
// 구매 대상 제한 검증이 Auth::user() 의 역할을 읽으므로 인증 주체를 세운다.
|
||||
// 콘솔에는 세션이 없어 login() 대신 setUser() 를 쓴다.
|
||||
Auth::setUser($user);
|
||||
|
||||
$tempOrder = $this->tempOrderService->createTempOrderFromDirectItems(
|
||||
items: [[
|
||||
'product_id' => $product->id,
|
||||
'product_option_id' => $option->id,
|
||||
'quantity' => 1,
|
||||
]],
|
||||
userId: $user->id,
|
||||
cartKey: null,
|
||||
);
|
||||
|
||||
return [
|
||||
'temp_order' => $tempOrder,
|
||||
'user' => $user,
|
||||
// 프론트엔드가 보내는 결제예정금액에 해당 — 임시 주문의 최종 금액을 그대로 쓴다
|
||||
'expected_total_amount' => (float) $tempOrder->getFinalAmount(),
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 계측 대상 — 임시 주문을 실제 주문으로 생성합니다.
|
||||
*
|
||||
* @param array{temp_order: TempOrder, user: User, expected_total_amount: float} $context prepare 산출물
|
||||
* @return Order 생성된 주문
|
||||
*/
|
||||
public function create(array $context): Order
|
||||
{
|
||||
return $this->orderProcessingService->createFromTempOrder(
|
||||
tempOrder: $context['temp_order'],
|
||||
ordererInfo: [
|
||||
'name' => '성능계측',
|
||||
'phone' => '01000000000',
|
||||
'email' => $context['user']->email,
|
||||
],
|
||||
shippingInfo: [
|
||||
'recipient_name' => '성능계측',
|
||||
'recipient_phone' => '01000000000',
|
||||
'country_code' => 'KR',
|
||||
'zipcode' => '06236',
|
||||
'address' => '서울특별시 강남구 테헤란로 1',
|
||||
'address_detail' => '1층',
|
||||
],
|
||||
paymentMethod: 'card',
|
||||
expectedTotalAmount: $context['expected_total_amount'],
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -38,7 +38,7 @@ class OrderRepository implements OrderRepositoryInterface
|
||||
*
|
||||
* @var array<int, string>
|
||||
*/
|
||||
private const LIST_COLUMNS = [
|
||||
public const LIST_COLUMNS = [
|
||||
'id',
|
||||
'user_id',
|
||||
'order_number',
|
||||
|
||||
+161
@@ -0,0 +1,161 @@
|
||||
<?php
|
||||
|
||||
namespace Modules\Sirsoft\Ecommerce\Tests\Unit\Benchmark;
|
||||
|
||||
use App\Benchmark\Axes\WriteAxisRunner;
|
||||
use App\Benchmark\BenchmarkProfileRegistry;
|
||||
use App\Benchmark\DTO\BenchmarkRunOptions;
|
||||
use App\Enums\BenchmarkAxis;
|
||||
use Modules\Sirsoft\Ecommerce\Benchmark\OrderCreationBenchmark;
|
||||
use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
|
||||
use Modules\Sirsoft\Ecommerce\Models\Order;
|
||||
use Modules\Sirsoft\Ecommerce\Models\TempOrder;
|
||||
use Modules\Sirsoft\Ecommerce\Module;
|
||||
use Modules\Sirsoft\Ecommerce\Tests\ModuleTestCase;
|
||||
use PHPUnit\Framework\Attributes\Test;
|
||||
|
||||
/**
|
||||
* 이커머스 계측 프로파일 선언 및 주문 생성 쓰기 축 대상 테스트.
|
||||
*
|
||||
* 계측 결과는 시간 값이라 **수치를 단언하지 않는다**. 단언 대상은 모듈이 자기 계측 대상을
|
||||
* 선언한다는 성질과, 쓰기 축 대상이 실제 서비스 경로로 주문을 만든다는 성질이다.
|
||||
*/
|
||||
class OrderCreationBenchmarkTest extends ModuleTestCase
|
||||
{
|
||||
/**
|
||||
* 모듈이 자기 계측 대상을 선언합니다.
|
||||
*
|
||||
* 계측 대상을 코어 커맨드에 하드코딩하지 않고 소유 확장이 선언한다는 설계의 실증입니다.
|
||||
*
|
||||
* @effects list_profile_filters_match_the_screen_default_predicate
|
||||
*/
|
||||
#[Test]
|
||||
public function 모듈이_계측_프로파일을_선언한다(): void
|
||||
{
|
||||
$declared = (new Module)->getBenchmarkProfiles();
|
||||
|
||||
// 목록 축 — 주문 목록은 Repository 상수를 참조해 컬럼 중복 선언을 없앤다
|
||||
$this->assertArrayHasKey('orders', $declared);
|
||||
$this->assertSame('list', $declared['orders']['type']);
|
||||
$this->assertSame('ecommerce_orders', $declared['orders']['table']);
|
||||
$this->assertContains('order_number', $declared['orders']['columns']);
|
||||
$this->assertNotContains('memo', $declared['orders']['columns'], '목록에 쓰지 않는 넓은 컬럼은 빠져야 한다.');
|
||||
|
||||
// 관리자 주문 목록은 상태 미지정 시 임시 주문 상태를 NOT IN 으로 제외한다
|
||||
// (OrderRepository::getListWithFilters). 이 술어가 빠지면 다른 인덱스를 재게 된다.
|
||||
$this->assertSame(
|
||||
['order_status' => ['not in', OrderStatusEnum::listHiddenValues()]],
|
||||
$declared['orders']['filters'],
|
||||
'주문 목록 프로파일은 화면 기본 필터를 Enum SSoT 기준으로 선언해야 한다.'
|
||||
);
|
||||
|
||||
// 화면 축 — 라우트명으로 선언 (URI 프리픽스 조립 금지)
|
||||
$this->assertSame('screen', $declared['orders_screen']['type']);
|
||||
$this->assertSame(
|
||||
'api.modules.sirsoft-ecommerce.admin.orders.index',
|
||||
$declared['orders_screen']['route']
|
||||
);
|
||||
$this->assertSame(['sirsoft-ecommerce.orders.read'], $declared['orders_screen']['permissions']);
|
||||
|
||||
// 쓰기 축 — prepare(계측 제외) / callback(계측) 분리, 클로저 아닌 형식
|
||||
$this->assertSame('write', $declared['order_create']['type']);
|
||||
$this->assertSame([OrderCreationBenchmark::class, 'prepare'], $declared['order_create']['prepare']);
|
||||
$this->assertSame([OrderCreationBenchmark::class, 'create'], $declared['order_create']['callback']);
|
||||
}
|
||||
|
||||
/**
|
||||
* 선언한 프로파일이 코어 레지스트리에 수집됩니다.
|
||||
*/
|
||||
#[Test]
|
||||
public function 선언한_프로파일이_코어_레지스트리에_수집된다(): void
|
||||
{
|
||||
$profile = app(BenchmarkProfileRegistry::class)->find('sirsoft-ecommerce/order_create');
|
||||
|
||||
$this->assertSame(BenchmarkAxis::Write, $profile->axis);
|
||||
$this->assertSame('module', $profile->sourceKind);
|
||||
$this->assertSame('sirsoft-ecommerce', $profile->sourceIdentifier);
|
||||
$this->assertTrue($profile->mutates(), '쓰기 축은 데이터를 변경하는 축이다.');
|
||||
}
|
||||
|
||||
/**
|
||||
* `prepare` 가 구매 가능한 상품·옵션과 임시 주문을 세웁니다.
|
||||
*
|
||||
* 임시 주문을 팩토리로 조립하지 않고 실제 서비스로 만드는 이유는, 주문 생성이 저장된
|
||||
* 계산 파라미터로 금액을 재계산해 저장값과 대조하기 때문입니다 (손으로 만든 계산 결과는
|
||||
* 어긋나 차단되고, 어긋나지 않게 맞추면 실제 결제 경로가 아닌 다른 것을 재게 됩니다).
|
||||
*/
|
||||
#[Test]
|
||||
public function prepare_가_임시_주문을_세운다(): void
|
||||
{
|
||||
$context = app(OrderCreationBenchmark::class)->prepare(1);
|
||||
|
||||
$this->assertInstanceOf(TempOrder::class, $context['temp_order']);
|
||||
$this->assertGreaterThan(0, $context['expected_total_amount'], '결제예정금액이 산출되어야 한다.');
|
||||
$this->assertSame(
|
||||
$context['user']->id,
|
||||
$context['temp_order']->user_id,
|
||||
'임시 주문이 준비한 회원에 귀속되어야 한다.'
|
||||
);
|
||||
$this->assertSame(
|
||||
(float) $context['temp_order']->getFinalAmount(),
|
||||
$context['expected_total_amount'],
|
||||
'결제예정금액은 임시 주문의 최종 금액과 같아야 한다 — 다르면 금액 검증에 막힌다.'
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* 계측 대상 콜백이 실제 주문을 생성합니다.
|
||||
*/
|
||||
#[Test]
|
||||
public function callback_이_실제_주문을_생성한다(): void
|
||||
{
|
||||
$benchmark = app(OrderCreationBenchmark::class);
|
||||
|
||||
$ordersBefore = Order::count();
|
||||
$order = $benchmark->create($benchmark->prepare(1));
|
||||
|
||||
$this->assertInstanceOf(Order::class, $order);
|
||||
$this->assertSame($ordersBefore + 1, Order::count());
|
||||
$this->assertNotEmpty($order->order_number);
|
||||
}
|
||||
|
||||
/**
|
||||
* 쓰기 축 실행기가 이 대상을 실행하고 결과를 산출합니다. (수치 단언 없음)
|
||||
*
|
||||
* 계측이 만든 행은 실행기가 감싼 트랜잭션 롤백으로 되돌아가므로 주문 건수가 늘지 않습니다.
|
||||
*/
|
||||
#[Test]
|
||||
public function 쓰기_축_실행이_결과를_산출하고_흔적을_남기지_않는다(): void
|
||||
{
|
||||
$ordersBefore = Order::count();
|
||||
|
||||
$result = app(WriteAxisRunner::class)->run(
|
||||
app(BenchmarkProfileRegistry::class)->find('sirsoft-ecommerce/order_create'),
|
||||
new BenchmarkRunOptions(runs: 1, allowWrite: true),
|
||||
);
|
||||
|
||||
$this->assertFalse($result->skipped, '건너뜀 사유: '.(string) $result->skipReason);
|
||||
$this->assertSame(['첫 회(ms)', '중앙값(ms)', '회차', '쿼리(건)', 'DB(ms)'], $result->headers);
|
||||
$this->assertGreaterThan(0, $result->metrics['query_count'], '주문 생성은 쿼리를 실행한다.');
|
||||
|
||||
$this->assertSame($ordersBefore, Order::count(), '계측으로 생긴 주문은 롤백되어야 한다.');
|
||||
}
|
||||
|
||||
/**
|
||||
* `--allow-write` 없이는 이 대상이 실행되지 않습니다.
|
||||
*/
|
||||
#[Test]
|
||||
public function allow_write_없이는_실행되지_않는다(): void
|
||||
{
|
||||
$ordersBefore = Order::count();
|
||||
|
||||
$result = app(WriteAxisRunner::class)->run(
|
||||
app(BenchmarkProfileRegistry::class)->find('sirsoft-ecommerce/order_create'),
|
||||
new BenchmarkRunOptions(runs: 1),
|
||||
);
|
||||
|
||||
$this->assertTrue($result->skipped);
|
||||
$this->assertStringContainsString('--allow-write', (string) $result->skipReason);
|
||||
$this->assertSame($ordersBefore, Order::count());
|
||||
}
|
||||
}
|
||||
@@ -168,4 +168,35 @@ class Module extends AbstractModule
|
||||
],
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 성능 계측 프로파일 정의 (`g7:bench`).
|
||||
*
|
||||
* 페이지 목록은 응답 계약상 본문까지 그대로 노출하므로 컬럼 프루닝이 불가합니다
|
||||
* (`['*']`). 이 경우 계측의 비교축은 select * vs select id 이며, 그 배수가 지연 조인
|
||||
* 적용의 기대 효과입니다.
|
||||
*
|
||||
* @return array<string, array<string, mixed>> 프로파일 키 → 정의
|
||||
*/
|
||||
public function getBenchmarkProfiles(): array
|
||||
{
|
||||
return [
|
||||
'pages' => [
|
||||
'type' => 'list',
|
||||
'label' => '페이지 목록',
|
||||
'table' => 'pages',
|
||||
'columns' => ['*'],
|
||||
'order' => [['created_at', 'desc'], ['id', 'desc']],
|
||||
// 페이지는 소프트 삭제 컬럼이 없다 — 실제 스키마 기준 선언
|
||||
'soft_delete' => false,
|
||||
],
|
||||
'pages_screen' => [
|
||||
'type' => 'screen',
|
||||
'label' => '관리자 페이지 목록 화면',
|
||||
'route' => 'api.modules.sirsoft-page.admin.pages.index',
|
||||
'query' => ['per_page' => 20],
|
||||
'permissions' => ['sirsoft-page.pages.read'],
|
||||
],
|
||||
];
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user