HeuJung
6bde24bc75
관리자 환경설정에서 미입금 자동취소 기한을 저장하면 HTML number 입력의 문자열이 그대로 영속되고, Carbon 3.13 의 strict 타입 경계에서 TypeError 가 발생해 무통장입금·가상계좌 주문이 전면 실패했다(공개 제보). 한 곳만 막으면 다른 저장 경로가 남으므로 저장·조회·소비·모델 네 계층에 각각 방어를 두고, 저장소 전역에서 같은 형태가 더 없음을 audit 룰로 확정했다. 같은 계획서 수행 중 드러난 인접 결함도 함께 해소했다. - 쿠폰 수정 경로로 (발급일 기준, 일수 NULL) 조합이 저장되어 발급 즉시 만료된 쿠폰이 조용히 나가던 문제 — 저장·발급 양쪽에서 차단 - 리뷰 작성 기한을 화면과 저장 판정이 서로 다른 기준으로 계산하던 문제 - 결제 플러그인이 PaymentMethodEnum 과 다른 어휘로 지원 결제수단을 선언해 가상계좌·계좌이체·휴대폰결제에 PG사를 지정할 수 없던 문제 엔진에서는 `_localInit` 적용 여부를 전역 해시로만 판정해 인스턴스별 저장소가 리셋되지 않던 결함(engine-v1.54.5)과, 제거 대상이 없어도 상태 갱신·캐시 무효화가 상시 발생하던 판정 결함(engine-v1.54.6)을 고쳤다. Playwright MCP 정밀 점검(T1~T11)에서 설정이 빈 문자열로 남은 사이트의 주문서 입금기한 안내가 미치환 플레이스홀더를 노출하는 것을 실측해, 화면 폴백을 서버와 같은 규칙으로 맞췄다.
213 lines
10 KiB
PHP
213 lines
10 KiB
PHP
<?php
|
|
|
|
namespace App\Console\Commands;
|
|
|
|
use App\Enums\ExtensionOwnerType;
|
|
use App\Models\Permission;
|
|
use App\Models\Role;
|
|
use App\Models\User;
|
|
use Illuminate\Console\Command;
|
|
use Illuminate\Support\Facades\Config;
|
|
|
|
/**
|
|
* Playwright E2E 용 Sanctum 토큰 발급 커맨드.
|
|
*
|
|
* 임의 권한 식별자(코어/모듈/플러그인) 를 받아 권한 보유 관리자 유저를 즉시 생성하고
|
|
* Sanctum 개인 액세스 토큰을 발급한다. 발급된 토큰은 stdout 마지막 줄에 출력되어
|
|
* Playwright fixture 가 stdin 캡처로 사용한다.
|
|
*
|
|
* 보안 가드 (3중):
|
|
* ① CLI 한정 — `php_sapi_name() === 'cli'` 확인. production 웹 요청에서 절대 도달 불가
|
|
* ② 명시 옵트인 — `G7_PLAYWRIGHT_BYPASS=1` 환경변수 부여 필수.
|
|
* `.env` 영구 수정 없이 인라인 환경변수로만 활성화 가능 → 무심코 production 으로 새지 않음
|
|
* ③ APP_DEBUG 강제 — bypass flag 인지 후 `config('app.debug')` 를 true 로 inline override.
|
|
* SettingsServiceProvider 의 testing/bypass 분기가 이미 settings JSON 덮어쓰기를 건너뛰므로
|
|
* production + debug=false 환경에서도 토큰 발급이 가능하다
|
|
*
|
|
* 환경 매트릭스:
|
|
* - local + bypass=1 : 로컬 개발자 PC 에서 직접 spec 작성/실행
|
|
* - testing + bypass=1 : CI / PHPUnit 환경에서 .env.testing 로 동작하는 E2E 통합 (testing 환경은 이미 testing 가드로 통과)
|
|
* - production + bypass=1 : production DB 가 활성 호스트를 가리키는 환경(예: g7.dev) 에서 E2E
|
|
*
|
|
* 호출 예시 (PowerShell):
|
|
* $env:G7_PLAYWRIGHT_BYPASS='1'; php artisan playwright:issue-token --permissions=core.templates.layouts.edit
|
|
*
|
|
* 로직 출처: tests/Feature/Api/Admin/LayoutAccessCheckEndpointTest::makeAdminUser (44~87행)
|
|
*/
|
|
class PlaywrightIssueToken extends Command
|
|
{
|
|
protected $signature = 'playwright:issue-token
|
|
{--permissions=* : 부여할 권한 식별자 (예: core.templates.layouts.edit). 다중 지정 가능}
|
|
{--no-admin-role : admin 역할을 부여하지 않고 지정한 권한만 가진 계정을 만든다 (권한 분기 검증용)}
|
|
{--gc-hours=6 : 이 시간(시)보다 오래된 playwright 테스트 유저/역할을 발급 전 정리. 0 이면 정리 안 함}';
|
|
|
|
protected $description = 'Playwright E2E 용 Sanctum 토큰 발급 (CLI + G7_PLAYWRIGHT_BYPASS 3중 가드)';
|
|
|
|
/** 테스트 전용 역할 식별자 접두사 */
|
|
private const TEST_ROLE_PREFIX = 'playwright_test_';
|
|
|
|
public function handle(): int
|
|
{
|
|
// ① CLI 한정 — production 웹 요청에서 절대 도달 불가
|
|
if (php_sapi_name() !== 'cli') {
|
|
$this->error('CLI 전용 커맨드입니다. (현재 SAPI: '.php_sapi_name().')');
|
|
|
|
return self::FAILURE;
|
|
}
|
|
|
|
// ② 명시 옵트인 — 환경변수 없이는 production 호출 실수 차단
|
|
if (env('G7_PLAYWRIGHT_BYPASS') !== '1') {
|
|
$this->error('G7_PLAYWRIGHT_BYPASS=1 환경변수가 필요합니다. (예: PowerShell — $env:G7_PLAYWRIGHT_BYPASS=\'1\')');
|
|
|
|
return self::FAILURE;
|
|
}
|
|
|
|
// ③ APP_DEBUG 강제 — production + debug=false 환경에서도 sanctum 토큰 발급 + 디버그 정보 누락 방지.
|
|
// SettingsServiceProvider::applyDebugConfig 는 bypass flag 가 있으면 settings JSON 덮어쓰기를 이미 건너뛴 상태.
|
|
Config::set('app.debug', true);
|
|
|
|
// 발급 전 오래된 테스트 아티팩트 정리 — 이 커맨드는 호출마다 유저 1명 + 역할 1개를
|
|
// 새로 만들지만 회수 주체가 없어 그대로 누적된다. 정리하지 않으면 회원/역할 관리 화면이
|
|
// 테스트 잔재로 뒤덮인다(실측: 발급 2974회 → 유저 2974명·역할 2974개 잔존).
|
|
// 시간 임계값을 두어 동시 실행 중인 다른 워커의 계정은 건드리지 않는다.
|
|
$gcHours = (int) $this->option('gc-hours');
|
|
if ($gcHours > 0) {
|
|
$this->pruneStaleTestArtifacts($gcHours);
|
|
}
|
|
|
|
$permissions = $this->option('permissions') ?: [];
|
|
|
|
// --no-admin-role: 지정한 권한만 가진 계정을 만든다.
|
|
// 기본값(플래그 없음)은 종전대로 admin 역할을 함께 부여한다 — 기존 spec 무영향.
|
|
$user = $this->makeAdminUser($permissions, ! $this->option('no-admin-role'));
|
|
$token = $user->createToken('playwright-'.uniqid())->plainTextToken;
|
|
|
|
$this->line($token);
|
|
|
|
return self::SUCCESS;
|
|
}
|
|
|
|
/**
|
|
* 임계 시간보다 오래된 playwright 테스트 유저/역할을 정리한다.
|
|
*
|
|
* 대상: `playwright_test_*` 역할과, 그 역할이 유일한 확장 역할인 유저(= 이 커맨드가
|
|
* factory 로 만든 계정). 실제 회원과 구분되도록 반드시 역할 소유 관계로만 판별한다.
|
|
*
|
|
* chunkById(키셋 순회) 필수 — 콜백이 순회 대상 행을 삭제하므로 OFFSET 기반 chunk()/each()
|
|
* 는 다음 페이지가 줄어든 결과 집합을 지나쳐 일부를 건너뛴다.
|
|
*
|
|
* @param int $hours 이 시간보다 오래된 아티팩트만 정리
|
|
* @return void
|
|
*/
|
|
private function pruneStaleTestArtifacts(int $hours): void
|
|
{
|
|
$threshold = now()->subHours($hours);
|
|
$roles = 0;
|
|
$users = 0;
|
|
|
|
Role::where('identifier', 'like', self::TEST_ROLE_PREFIX.'%')
|
|
->where('created_at', '<', $threshold)
|
|
->chunkById(100, function ($chunk) use (&$roles, &$users) {
|
|
foreach ($chunk as $role) {
|
|
// 이 역할을 가진 유저 중, 다른 playwright 역할이 없는 계정만 제거 대상
|
|
foreach ($role->users()->get() as $user) {
|
|
$otherTestRoles = $user->roles()
|
|
->where('roles.id', '!=', $role->id)
|
|
->where('roles.identifier', 'like', self::TEST_ROLE_PREFIX.'%')
|
|
->count();
|
|
if ($otherTestRoles === 0) {
|
|
$user->tokens()->delete();
|
|
$user->roles()->detach();
|
|
$user->forceDelete();
|
|
$users++;
|
|
}
|
|
}
|
|
|
|
$role->permissions()->detach();
|
|
$role->users()->detach();
|
|
$role->delete();
|
|
$roles++;
|
|
}
|
|
});
|
|
|
|
if ($roles > 0) {
|
|
$this->info("[gc] playwright 테스트 잔재 정리: 역할 {$roles}건, 유저 {$users}건");
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 권한 식별자 배열로 관리자 유저를 생성하고 권한을 부여한다.
|
|
*
|
|
* 절차:
|
|
* 1. User factory 로 신규 유저 생성
|
|
* 2. 권한 식별자별로 Permission 행 보장 (firstOrCreate)
|
|
* 3. uniqid 접미사로 격리된 test role 생성 + 권한 sync
|
|
* 4. (withAdminRole 일 때만) admin role 보장 (firstOrCreate) + 유저-역할 부여
|
|
*
|
|
* `withAdminRole = false` 는 **권한 분기(읽기 전용 등) 검증 전용**이다. 기본값 true 는
|
|
* admin 역할을 함께 붙이므로, 요청한 권한만 가진 세션을 만들 수 없다 —
|
|
* admin 역할이 사이트의 전체 권한을 보유하기 때문에 `--permissions` 로 좁혀도
|
|
* 화면은 항상 최대 권한으로 렌더된다(실측: admin 역할 권한 263건).
|
|
*
|
|
* @param array<int, string> $permissions 부여할 권한 식별자 목록
|
|
* @param bool $withAdminRole admin 역할 동반 부여 여부
|
|
* @return User 생성된 유저
|
|
*/
|
|
private function makeAdminUser(array $permissions, bool $withAdminRole = true): User
|
|
{
|
|
$user = User::factory()->create();
|
|
|
|
$permissionIds = [];
|
|
foreach ($permissions as $identifier) {
|
|
// Role/Permission 의 name·description 은 모델에서 array 로 캐스팅된다.
|
|
// 여기서 json_encode 한 문자열을 넣으면 Eloquent 가 한 번 더 인코딩해
|
|
// 이중 인코딩된 값이 저장되고, 관리자 화면(역할 선택 등)에 JSON 원문이
|
|
// `{"ko":"\uXXXX…"}` 형태로 그대로 노출된다. 배열을 그대로 넘긴다.
|
|
$permission = Permission::firstOrCreate(
|
|
['identifier' => $identifier],
|
|
[
|
|
'name' => ['ko' => $identifier, 'en' => $identifier],
|
|
'description' => ['ko' => $identifier, 'en' => $identifier],
|
|
'extension_type' => ExtensionOwnerType::Core,
|
|
'extension_identifier' => 'core',
|
|
'type' => 'admin',
|
|
]
|
|
);
|
|
$permissionIds[] = $permission->id;
|
|
}
|
|
|
|
$testRole = Role::create([
|
|
'identifier' => 'playwright_test_'.uniqid(),
|
|
'name' => ['ko' => 'Playwright 테스트 관리자', 'en' => 'Playwright Test Admin'],
|
|
'description' => ['ko' => 'E2E 자동화 전용', 'en' => 'E2E automation only'],
|
|
'is_active' => true,
|
|
]);
|
|
|
|
if (! empty($permissionIds)) {
|
|
$testRole->permissions()->sync($permissionIds);
|
|
}
|
|
|
|
if ($withAdminRole) {
|
|
$adminRole = Role::firstOrCreate(
|
|
['identifier' => 'admin'],
|
|
[
|
|
'name' => ['ko' => '관리자', 'en' => 'Admin'],
|
|
'description' => ['ko' => '시스템 관리자', 'en' => 'System Admin'],
|
|
'extension_type' => ExtensionOwnerType::Core,
|
|
'extension_identifier' => 'core',
|
|
'type' => 'admin',
|
|
'is_active' => true,
|
|
]
|
|
);
|
|
|
|
$user->roles()->attach($adminRole->id, ['assigned_at' => now(), 'assigned_by' => null]);
|
|
}
|
|
|
|
// test role 은 항상 부여한다 — GC(pruneStaleTestArtifacts)가 이 역할로 테스트 계정을
|
|
// 식별하므로, 빠지면 --no-admin-role 로 만든 계정이 영구 잔존한다.
|
|
$user->roles()->attach($testRole->id, ['assigned_at' => now(), 'assigned_by' => null]);
|
|
|
|
return $user->fresh();
|
|
}
|
|
}
|