fix(core,board,ecommerce,plugins): API 문서 미채움 마커 전수 채움 + 미해석 lang 키 정정 + IDV 조회 시도횟수 비노출
이슈 본연: API 레퍼런스의 미채움 마커 5종(실측 제외/TODO/필드 없음/대표 에러 없음)
1,194건을 코드에서 읽어 전수 채우고(0건), api:docgen 재생성이 사람이 채운 내용을
손실·열화시키던 멱등성 결함 4종(CRLF, 표 파이프 이스케이프, 에러 서술 보존, 중복
라우트명 키)을 근본 수정. --check 를 실측 제외와 드리프트가 구분되도록 재정의.
ParameterDescriber/ResourceFieldDescriber 에 leaf 폴백·SEO 스코프·공통 사전 확장.
파생 결함(문서 실측 중 발견): ResponseHelper 기본 메시지 키 6종이 존재하지 않는
messages.* 를 가리켜 응답 message 가 번역문 대신 키 문자열로 노출되던 문제를 common.*
으로 정정하고, 코어 7 + gdpr/marketing/pay_kginicis/verification/ecommerce 확장의
호출부와 누락 lang 키(게시판 10키 + 이커머스 category_images 4키 포함)를 ko/en/ja
전수 정정. 중복 그룹 키 2건은 기존 키로 호출부 통합.
보안: GET /api/identity/challenges/{id} 는 권한 가드 없는 공개 폴링 엔드포인트인데
Service::getStatus 가 attempts/max_attempts 를 응답에 담아 남은 시도 횟수를 추론할 수
있었다. 두 필드를 제거하고, 챌린지 화면(admin_basic/basic)의 서버 attempts 참조를
제거(남은 횟수 UI 는 query fallback + verify 실패 시 로컬 증가로 유지).
부수 정리(변경셋에 들어온 board 컨트롤러의 audit 사전 결함): FormRequest 4개 신설로
base Request 주입 제거, CommentController 의 Board 직접 호출을 BoardService 위임으로
전환, PHPDoc @return 보강. board 스위트에서 발견한 stale test 3건(seed SSoT 불일치,
admin 계정 user 역할 누락)도 같은 세션에서 정정.
버전 정렬(공개 release 기준): 코어 7.0.3→7.0.4, sirsoft-board 1.0.1→1.0.2,
verification_kginicis 1.0.0→1.0.1, admin_basic 1.0.1→1.0.4.
This commit is contained in:
1 parent
b07d6c8953
commit
6c8381f164
155 files changed
+17192
-1829
No files matched your search
@@ -1763,7 +1763,7 @@ MD;
|
||||
// 사람이 도메인 특이 에러 표를 직접 채운다.
|
||||
$humanTable = "| 상태코드 | 의미 | 발생 조건 |\n"
|
||||
."| --- | --- | --- |\n"
|
||||
."| 429 | Too Many Requests | 동일 IP 에서 분당 10회를 초과해 요청한 경우 |";
|
||||
.'| 429 | Too Many Requests | 동일 IP 에서 분당 10회를 초과해 요청한 경우 |';
|
||||
$withTable = str_replace(
|
||||
'_대표 에러 없음 (공개 조회). <!-- TODO: 도메인 특이 에러가 있으면 보강 -->_',
|
||||
$humanTable,
|
||||
@@ -1806,4 +1806,243 @@ MD;
|
||||
$this->assertStringContainsString('/api/admin/brands/{brand}', $block);
|
||||
$this->assertStringNotContainsString('/api/admin/brands/1', $block);
|
||||
}
|
||||
|
||||
#[Test]
|
||||
public function 같은_라우트명의_ge_t_pos_t_는_서로_다른_생성블록_키를_갖는다(): void
|
||||
{
|
||||
// 회귀: Route::match(['get','post'], ...)->name('x') 는 하나의 라우트명으로 두 메서드를
|
||||
// 등록한다(KG이니시스 CBT/모바일 콜백). 생성 블록 키가 라우트명뿐이면 한 문서에 같은
|
||||
// `@generated:start:x` 가 두 번 나오고, strpos 기반 블록 조회가 언제나 첫 블록만 잡아
|
||||
// 두 번째(POST) 블록의 사람 서술이 재생성마다 유실된다.
|
||||
// (실측: pay_kginicis payment.md 의 body 파라미터 용도 12건)
|
||||
$scaffolder = new ApiDocScaffolder;
|
||||
|
||||
$base = [
|
||||
'uri' => '/plugins/sirsoft-pay_kginicis/payment/cbt/callback',
|
||||
'name' => 'web.plugins.sirsoft-pay_kginicis.payment.cbt.callback',
|
||||
'controller' => 'C', 'controller_method' => 'handle', 'permission' => null,
|
||||
'middleware' => ['web'], 'path_params' => [],
|
||||
];
|
||||
$request = ['request_class' => null, 'params' => [], 'hook_filters' => []];
|
||||
$schema = ['envelope' => ['data'], 'shape' => 'object', 'pagination' => false,
|
||||
'fields' => [['name' => 'status', 'type' => 'string', 'sample' => 'ok']]];
|
||||
$probe = ['status' => 200, 'skipped_reason' => null];
|
||||
|
||||
// 라우트명이 문서 안에서 중복이면 커맨드가 methodScopedKey=true 로 호출한다.
|
||||
$get = $scaffolder->endpointSection(['method' => 'GET'] + $base, $request, $schema, $probe, [], true);
|
||||
$post = $scaffolder->endpointSection(['method' => 'POST'] + $base, $request, $schema, $probe, [], true);
|
||||
|
||||
$extractKey = static fn (string $s): string => (string) preg_replace(
|
||||
'/^.*<!-- @generated:start:([^ ]+) -->.*$/s', '$1', explode("\n", $s)[1]
|
||||
);
|
||||
|
||||
$this->assertNotSame(
|
||||
$extractKey($get),
|
||||
$extractKey($post),
|
||||
'같은 라우트명이라도 메서드가 다르면 생성 블록 키가 달라야 한다'
|
||||
);
|
||||
|
||||
// 스캐폴더의 키 생성기는 커맨드가 쓰는 섹션 키와 동일해야 한다 (mergeDocument 대조 키).
|
||||
$this->assertSame($extractKey($get), $scaffolder->generatedKey(['method' => 'GET'] + $base, true));
|
||||
$this->assertSame($extractKey($post), $scaffolder->generatedKey(['method' => 'POST'] + $base, true));
|
||||
|
||||
// 중복이 아닌 라우트는 키를 그대로 둔다 (전 문서 키 변경 시 사람 서술 유실 방지).
|
||||
$this->assertSame($base['name'], $scaffolder->generatedKey(['method' => 'GET'] + $base));
|
||||
}
|
||||
|
||||
#[Test]
|
||||
public function 같은_라우트명_두_메서드의_사람_서술이_각각_보존된다(): void
|
||||
{
|
||||
// 위 키 고유화가 실제 보존으로 이어지는지 — GET/POST 두 블록의 파라미터 용도가
|
||||
// 서로 섞이거나 유실되지 않고 각자 자리에 되살아나야 한다.
|
||||
$scaffolder = new ApiDocScaffolder;
|
||||
|
||||
$base = [
|
||||
'uri' => '/plugins/sirsoft-pay_kginicis/payment/cbt/callback',
|
||||
'name' => 'web.plugins.sirsoft-pay_kginicis.payment.cbt.callback',
|
||||
'controller' => 'C', 'controller_method' => 'handle', 'permission' => null,
|
||||
'middleware' => ['web'], 'path_params' => [],
|
||||
];
|
||||
$schema = ['envelope' => ['data'], 'shape' => 'object', 'pagination' => false,
|
||||
'fields' => [['name' => 'status', 'type' => 'string', 'sample' => 'ok']]];
|
||||
$probe = ['status' => 200, 'skipped_reason' => null];
|
||||
|
||||
// GET 은 query, POST 는 body 로 같은 이름의 파라미터를 받는다 (실제 콜백 계약).
|
||||
$getRequest = ['request_class' => null, 'hook_filters' => [], 'params' => [
|
||||
['name' => 'sid', 'location' => 'query', 'type' => 'string', 'required' => false, 'allowed' => '—'],
|
||||
]];
|
||||
$postRequest = ['request_class' => null, 'hook_filters' => [], 'params' => [
|
||||
['name' => 'sid', 'location' => 'body', 'type' => 'string', 'required' => false, 'allowed' => '—'],
|
||||
]];
|
||||
|
||||
$getSection = $scaffolder->endpointSection(['method' => 'GET'] + $base, $getRequest, $schema, $probe, [], true);
|
||||
$postSection = $scaffolder->endpointSection(['method' => 'POST'] + $base, $postRequest, $schema, $probe, [], true);
|
||||
|
||||
// 사람이 두 블록의 용도를 각각 채운 기존 문서
|
||||
$existing = "# 결제\n\n"
|
||||
.str_replace('<!-- TODO: 용도 -->', 'GET 콜백의 세션 ID', $getSection)."\n"
|
||||
.str_replace('<!-- TODO: 용도 -->', 'POST 콜백의 세션 ID', $postSection)."\n";
|
||||
|
||||
$merged = $scaffolder->mergeDocument(
|
||||
$existing,
|
||||
'# 결제',
|
||||
[$getSection, $postSection],
|
||||
[
|
||||
$scaffolder->generatedKey(['method' => 'GET'] + $base, true),
|
||||
$scaffolder->generatedKey(['method' => 'POST'] + $base, true),
|
||||
],
|
||||
);
|
||||
|
||||
$this->assertStringContainsString('GET 콜백의 세션 ID', $merged);
|
||||
$this->assertStringContainsString('POST 콜백의 세션 ID', $merged, 'POST 블록의 사람 서술이 유실되면 안 된다');
|
||||
$this->assertStringNotContainsString('<!-- TODO: 용도 -->', $merged);
|
||||
}
|
||||
|
||||
#[Test]
|
||||
public function 사람이_응답_필드_라벨을_고쳐도_채운_본문을_보존한다(): void
|
||||
{
|
||||
// 회귀: 봉투(`success`/`message`/`data`)를 쓰지 않고 JSON 을 root 에 그대로 내리는
|
||||
// 엔드포인트(LayoutPreviewController@serve 등)에서는 `**응답 필드** (`data` 내부)` 라벨이
|
||||
// 사실과 다르다. 사람이 이를 `**응답 필드**` 로 정정하면, 라벨 정확 일치를 요구하던
|
||||
// 보존 로직이 기존 본문을 찾지 못해 사람이 채운 내용이 통째로 마커로 퇴행했다.
|
||||
// (실측: docs/backend/api/layouts.md 의 미리보기 서빙 응답 필드 표)
|
||||
$scaffolder = new ApiDocScaffolder;
|
||||
|
||||
$route = [
|
||||
'method' => 'GET', 'uri' => '/api/layouts/{name}', 'name' => 'api.layouts.preview',
|
||||
'controller' => 'C', 'controller_method' => 'serve', 'permission' => null,
|
||||
'middleware' => ['api', 'optional.sanctum'], 'path_params' => ['name'],
|
||||
];
|
||||
$request = ['request_class' => null, 'params' => [], 'hook_filters' => []];
|
||||
$schema = ['envelope' => [], 'shape' => 'object', 'fields' => [], 'pagination' => false];
|
||||
|
||||
// 실측 불가(unresolved-path-param) → 응답 필드 자리에 마커만 생성된다.
|
||||
$section = $scaffolder->endpointSection($route, $request, $schema, ['status' => null, 'skipped_reason' => 'unresolved-path-param']);
|
||||
$this->assertStringContainsString('실측 응답에 필드 없음', $section, '마커 생성 전제 확인');
|
||||
|
||||
// 사람이 라벨을 정정하고(`(data 내부)` 제거) 본문을 서술로 채운 기존 문서.
|
||||
// 표가 아니라 서술이므로 applyPreservedTableCells 의 행 키 대조로는 지켜지지 않는다 —
|
||||
// 오직 라벨로 본문 구간을 찾는 applyPreservedResponseBodies 만이 이를 되살릴 수 있고,
|
||||
// 라벨 정확 일치만 보면 사람이 고친 라벨 때문에 구간을 못 찾아 마커로 퇴행한다.
|
||||
$filled = str_replace('**응답 필드** (`data` 내부)', '**응답 필드**', $section);
|
||||
$filled = preg_replace(
|
||||
'/_단건 응답[^\n]*_\n\n<!-- 실측 응답에 필드 없음[^\n]*-->/',
|
||||
'_이 엔드포인트는 봉투를 사용하지 않고 레이아웃 JSON 을 root 에 그대로 반환합니다._',
|
||||
$filled
|
||||
);
|
||||
$this->assertStringNotContainsString('실측 응답에 필드 없음', $filled, '테스트 픽스처가 마커를 실제로 대체했는지 확인');
|
||||
|
||||
$existing = "# 레이아웃\n\n".$filled;
|
||||
|
||||
$merged = $scaffolder->mergeDocument($existing, '# 레이아웃', [$section], ['api.layouts.preview']);
|
||||
|
||||
$this->assertStringContainsString('봉투를 사용하지 않고', $merged, '라벨을 고친 문서의 사람 본문이 보존되어야 한다');
|
||||
$this->assertStringNotContainsString('실측 응답에 필드 없음', $merged, '사람 본문이 마커로 퇴행하면 안 된다');
|
||||
}
|
||||
|
||||
#[Test]
|
||||
public function 에러_응답_자리의_사람_서술은_대표_에러_없음_초안에_덮이지_않는다(): void
|
||||
{
|
||||
// 회귀: 자동 추론이 에러 행을 하나도 만들지 못하는 공개 조회 엔드포인트는
|
||||
// `_대표 에러 없음 (공개 조회). <!-- TODO ... -->_` 초안을 낸다. 사람이 그 자리를
|
||||
// "이 엔드포인트는 도메인 에러를 반환하지 않습니다 (근거...)" 같은 서술로 채우면,
|
||||
// 표 행이 없으므로 errorTableRows() 가 빈 배열을 반환해 보존이 건너뛰어지고
|
||||
// 재생성 때마다 TODO 초안으로 퇴행한다. (실측: locales.md / modules.md / plugins.md)
|
||||
$scaffolder = new ApiDocScaffolder;
|
||||
|
||||
$route = [
|
||||
'method' => 'GET', 'uri' => '/api/locales', 'name' => 'api.locales.index',
|
||||
'controller' => 'C', 'controller_method' => 'index', 'permission' => null,
|
||||
'middleware' => ['api'], 'path_params' => [],
|
||||
];
|
||||
$request = ['request_class' => null, 'params' => [], 'hook_filters' => []];
|
||||
$schema = ['envelope' => ['data'], 'shape' => 'collection', 'pagination' => false,
|
||||
'fields' => [['name' => 'code', 'type' => 'string', 'sample' => 'ko']]];
|
||||
|
||||
$section = $scaffolder->endpointSection($route, $request, $schema, ['status' => 200, 'skipped_reason' => null]);
|
||||
$this->assertStringContainsString('대표 에러 없음', $section, '자동 초안 전제 확인');
|
||||
|
||||
$prose = '_이 엔드포인트는 도메인 에러를 반환하지 않습니다. 공개 조회이므로 인증 실패(401)가 없습니다._';
|
||||
$filled = preg_replace('/_대표 에러 없음[^\n]*_/', $prose, $section);
|
||||
$existing = "# 로케일\n\n".$filled;
|
||||
|
||||
$merged = $scaffolder->mergeDocument($existing, '# 로케일', [$section], ['api.locales.index']);
|
||||
|
||||
$this->assertStringContainsString('도메인 에러를 반환하지 않습니다', $merged, '사람이 쓴 에러 서술이 보존되어야 한다');
|
||||
$this->assertStringNotContainsString('대표 에러 없음', $merged, '사람 서술이 자동 초안으로 퇴행하면 안 된다');
|
||||
}
|
||||
|
||||
#[Test]
|
||||
public function crl_f_문서에서도_사람이_채운_표_셀을_보존한다(): void
|
||||
{
|
||||
// 회귀: Windows 체크아웃(core.autocrlf=true)에서 문서가 CRLF 로 저장되면
|
||||
// parseTableRow 의 `str_ends_with($line, ' |')` 가드가 줄 끝 \r 때문에 전부 실패해
|
||||
// 표 셀 보존이 통째로 무력화된다 → 사람이 채운 설명이 재생성 때마다 TODO 로 퇴행.
|
||||
// (실측: docs/backend/api/notifications.md 의 응답 필드 설명 10건 유실)
|
||||
$scaffolder = new ApiDocScaffolder;
|
||||
|
||||
$route = [
|
||||
'method' => 'GET', 'uri' => '/api/admin/notifications', 'name' => 'api.admin.notifications.index',
|
||||
'controller' => 'C', 'controller_method' => 'index', 'permission' => null,
|
||||
'middleware' => ['api', 'auth:sanctum'], 'path_params' => [],
|
||||
];
|
||||
$request = ['request_class' => null, 'params' => [], 'hook_filters' => []];
|
||||
$schema = [
|
||||
'envelope' => ['data'], 'shape' => 'collection', 'pagination' => false,
|
||||
'fields' => [['name' => 'type', 'type' => 'string', 'sample' => 'new_order_admin']],
|
||||
];
|
||||
|
||||
$section = $scaffolder->endpointSection($route, $request, $schema, ['status' => 200, 'skipped_reason' => null]);
|
||||
|
||||
// 사람이 설명을 채운 기존 문서를 CRLF 로 구성한다.
|
||||
$filled = str_replace(
|
||||
'<!-- TODO: 설명 -->',
|
||||
'알림 유형 식별자 (알림 정의의 type)',
|
||||
$section
|
||||
);
|
||||
$existingCrlf = str_replace("\n", "\r\n", "# 알림\n\n".$filled);
|
||||
|
||||
$merged = $scaffolder->mergeDocument(
|
||||
$existingCrlf,
|
||||
'# 알림',
|
||||
[$section],
|
||||
['api.admin.notifications.index'],
|
||||
);
|
||||
|
||||
$this->assertStringContainsString('알림 유형 식별자', $merged, 'CRLF 문서의 사람 서술이 보존되어야 한다');
|
||||
$this->assertStringNotContainsString('<!-- TODO: 설명 -->', $merged, '보존된 셀이 TODO 로 퇴행하면 안 된다');
|
||||
}
|
||||
|
||||
#[Test]
|
||||
public function 에러표의_권한_셀은_파이프를_이스케이프한다(): void
|
||||
{
|
||||
// 회귀: permission 이 여러 권한의 OR 조합(`core.modules.read | core.menus.read`)일 때
|
||||
// 파이프를 이스케이프하지 않으면 셀이 갈라져 3열 표가 4열로 깨진다.
|
||||
// (docs/backend/api/modules.md 의 403 행 24건이 이 상태로 생성돼 있었다)
|
||||
$scaffolder = new ApiDocScaffolder;
|
||||
|
||||
$route = [
|
||||
'method' => 'GET',
|
||||
'uri' => '/api/admin/modules',
|
||||
'name' => 'api.admin.modules.index',
|
||||
'controller' => 'C',
|
||||
'controller_method' => 'index',
|
||||
'permission' => 'core.modules.read | core.menus.read',
|
||||
'middleware' => ['api', 'auth:sanctum', 'permission:admin,core.modules.read'],
|
||||
'path_params' => [],
|
||||
];
|
||||
$request = ['request_class' => null, 'params' => [], 'hook_filters' => []];
|
||||
$schema = ['envelope' => ['data'], 'shape' => 'collection', 'fields' => [['name' => 'id', 'type' => 'integer', 'sample' => '1']], 'pagination' => false];
|
||||
|
||||
$section = $scaffolder->endpointSection($route, $request, $schema, ['status' => 200, 'skipped_reason' => null]);
|
||||
|
||||
// 403 행을 찾아 열 수를 센다 (이스케이프된 \| 는 셀 구분자가 아니다)
|
||||
$line = collect(explode("\n", $section))->first(fn (string $l): bool => str_starts_with($l, '| 403 |'));
|
||||
|
||||
$this->assertNotNull($line, '403 에러 행이 생성되어야 한다');
|
||||
$this->assertStringContainsString('\\|', $line, '권한 셀의 파이프가 이스케이프되어야 한다');
|
||||
|
||||
$cells = preg_split('/(?<!\\\\)\|/', trim($line, '| '));
|
||||
$this->assertCount(3, $cells, "403 행은 3열(상태코드/의미/발생 조건)이어야 한다: {$line}");
|
||||
}
|
||||
}
|
||||
@@ -262,4 +262,72 @@ class ParameterDescriberTest extends TestCase
|
||||
$this->assertStringContainsString('SEO', $describer->describe('meta_description', 'body', 'string'));
|
||||
$this->assertStringContainsString('대체 텍스트', $describer->describe('alt_text', 'body', 'array'));
|
||||
}
|
||||
|
||||
#[Test]
|
||||
public function 중첩_파라미터를_leaf_세그먼트로_설명한다(): void
|
||||
{
|
||||
$describer = new ParameterDescriber;
|
||||
|
||||
// 중첩 환경설정 키(general.*, mail.*, upload.*)는 leaf 가 의미를 결정한다.
|
||||
// 부모 그룹명은 라벨일 뿐이므로 leaf 로 폴백해 공통 사전을 태운다.
|
||||
$this->assertStringContainsString('호스트', $describer->describe('mail.host', 'body', 'string'));
|
||||
$this->assertStringContainsString('포트', $describer->describe('mail.port', 'body', 'integer'));
|
||||
$this->assertStringContainsString('타임존', $describer->describe('general.timezone', 'body', 'string'));
|
||||
|
||||
// 회귀: 전체명 접미 매칭이 부모 세그먼트를 설명문에 흘리던 문제
|
||||
// (general.site_name => "general.site 이름 (식별자)")
|
||||
$siteName = $describer->describe('general.site_name', 'body', 'string');
|
||||
$this->assertStringNotContainsString('general.', $siteName);
|
||||
$this->assertStringContainsString('이름', $siteName);
|
||||
}
|
||||
|
||||
#[Test]
|
||||
public function 로케일_접미_파라미터를_부모_설명_기준으로_설명한다(): void
|
||||
{
|
||||
$describer = new ParameterDescriber;
|
||||
|
||||
// 다국어 필드(name.ko / alt_text.en)는 부모 필드의 로케일별 값이다.
|
||||
$ko = $describer->describe('alt_text.ko', 'body', 'string');
|
||||
$this->assertStringContainsString('대체 텍스트', $ko);
|
||||
$this->assertStringContainsString('ko', $ko);
|
||||
|
||||
// 부모가 도메인 특이(사전 미등재)면 로케일 접미도 TODO 로 남는다.
|
||||
$this->assertNull($describer->describe('refund_priority.ko', 'body', 'string'));
|
||||
}
|
||||
|
||||
#[Test]
|
||||
public function 배열_원소_인덱스_파라미터는_상위_경로로_설명한다(): void
|
||||
{
|
||||
$describer = new ParameterDescriber;
|
||||
|
||||
// items.*.name / ids.0 처럼 인덱스가 leaf 인 경우 상위 경로로 폴백한다.
|
||||
$this->assertStringContainsString('식별자 배열', $describer->describe('ids.*', 'body', 'array'));
|
||||
$this->assertStringContainsString('식별자 배열', $describer->describe('ids.0', 'body', 'integer'));
|
||||
}
|
||||
|
||||
#[Test]
|
||||
public function seo_그룹의_중첩_키는_se_o_메타로_한정해_설명한다(): void
|
||||
{
|
||||
$describer = new ParameterDescriber;
|
||||
|
||||
// 회귀: leaf 폴백만 태우면 seo_meta.title 이 "제목" 으로 축소돼 오설명이 된다.
|
||||
// 부모가 의미를 한정하는 그룹(seo/seo_meta)은 leaf 를 SEO 맥락으로 해석해야 한다.
|
||||
$this->assertStringContainsString('SEO', $describer->describe('seo_meta.title', 'body', 'string'));
|
||||
$this->assertStringContainsString('SEO', $describer->describe('seo_meta.description', 'body', 'string'));
|
||||
$this->assertStringContainsString('SEO', $describer->describe('seo_meta.keywords', 'body', 'string'));
|
||||
$this->assertStringContainsString('SEO', $describer->describe('content.meta.seo.title', 'body', 'string'));
|
||||
|
||||
// 다른 그룹의 title 은 일반 제목 그대로 (오적용 방지)
|
||||
$this->assertStringNotContainsString('SEO', $describer->describe('basic_info.title', 'body', 'string'));
|
||||
}
|
||||
|
||||
#[Test]
|
||||
public function 도메인_특이_중첩_파라미터는_null_로_남는다(): void
|
||||
{
|
||||
$describer = new ParameterDescriber;
|
||||
|
||||
// leaf 폴백으로도 공통 사전에 없는 도메인 특이 키는 사람 서술(TODO) 대상이다.
|
||||
$this->assertNull($describer->describe('mileage.earn_trigger', 'body', 'string'));
|
||||
$this->assertNull($describer->describe('report_policy.auto_hide_target', 'body', 'string'));
|
||||
}
|
||||
}
|
||||
@@ -267,4 +267,41 @@ class ResourceFieldDescriberTest extends TestCase
|
||||
// 정수가 아니면 미적용 (오설명 방지)
|
||||
$this->assertNull($describer->describe('depth', 'string'));
|
||||
}
|
||||
|
||||
#[Test]
|
||||
public function 중첩_응답_필드를_leaf_세그먼트로_설명한다(): void
|
||||
{
|
||||
$describer = new ResourceFieldDescriber;
|
||||
|
||||
// 중첩 응답 필드(settings.general.site_url 등)는 leaf 가 의미를 결정한다.
|
||||
$this->assertStringContainsString('생성 일시', $describer->describe('meta.created_at', 'string'));
|
||||
$this->assertStringContainsString('개수', $describer->describe('stats.total', 'integer'));
|
||||
|
||||
// 회귀: 전체명 접미 매칭이 부모 세그먼트를 설명문에 흘리던 문제
|
||||
$userId = $describer->describe('order.user_id', 'integer');
|
||||
$this->assertStringNotContainsString('order.', $userId);
|
||||
$this->assertStringContainsString('식별자', $userId);
|
||||
}
|
||||
|
||||
#[Test]
|
||||
public function 로케일_접미_응답_필드를_부모_설명_기준으로_설명한다(): void
|
||||
{
|
||||
$describer = new ResourceFieldDescriber;
|
||||
|
||||
// 다국어 필드(name.ko)는 부모 필드의 로케일별 값이다.
|
||||
$ko = $describer->describe('name.ko', 'string');
|
||||
$this->assertStringContainsString('이름', $ko);
|
||||
$this->assertStringContainsString('ko', $ko);
|
||||
|
||||
// 부모가 도메인 특이면 로케일 접미도 TODO 로 남는다.
|
||||
$this->assertNull($describer->describe('refund_priority.ko', 'string'));
|
||||
}
|
||||
|
||||
#[Test]
|
||||
public function 도메인_특이_중첩_응답_필드는_null_로_남는다(): void
|
||||
{
|
||||
$describer = new ResourceFieldDescriber;
|
||||
|
||||
$this->assertNull($describer->describe('order.refund_priority', 'string'));
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user