Files
Gnuboard7/tests/scenarios/search-driver-fallback.yaml
T
HeuJung d970117149 fix(core,ecommerce,board,admin_basic): 고아 카탈로그 차단 + 설정 저장 파이프라인 정합
확장이 훅으로 등록한 카탈로그에서 고른 값은 그 확장이 사라져도 저장값으로 남는다.
그 상태에서 값만 보고 판정하면 이미 제공 불가한 항목이 사용자 화면에 그대로 노출된다.
예외도 경고도 로그도 남지 않아 관리자 화면과 나란히 보지 않으면 드러나지 않는다.

- 결제수단에 지정한 PG, 현금영수증 발급사, 검색엔진 드라이버 세 축에 같은 판정을 적용.
 공개 응답에서는 제거하고 관리자 응답에는 표시를 남긴다 — 운영자가 고쳐야 할 대상이라
 감추면 복구 경로가 사라진다. 서버 검증도 같은 판정을 공유해 화면 우회 제출을 막는다.
- 설정 단건 저장이 벌크 저장과 다른 경로를 타던 문제를 코어·이커머스·게시판에서 정리.
 저장은 성공하고 파생 값만 갱신되지 않아 어느 화면에서 저장했느냐로 결과가 갈렸다.
- 단건 저장의 값 형태 계약 신설. 빈 값으로 되돌릴 수 있게 하고, 타입은 defaults.json 의
 기본값을 SSoT 로 삼는다. 해석 불가한 입력은 조용히 캐스팅하지 않고 거절한다.
- 드라이버 셀렉트를 서버 카탈로그에 바인딩하고, 저장값이 카탈로그에 없으면 그 값을
 드러내는 안내를 8곳 전수에 붙인다. 종전에는 빈 칸으로만 보여 무엇이 저장됐는지
 알 수 없었다.

시나리오 매니페스트 8종을 면제 없이 신설했다. `audit:allow` 는 cross product 와 effects
검사를 함께 끄므로, 면제가 걸린 매니페스트에 선언을 추가하면 검증이 회복되지 않는다.
그 아래에서 대응 테스트가 없는 effect 이름 2건이 살아남아 있었고, 함께 정리했다.
2026-08-14 17:28:49 +09:00

37 lines
2.5 KiB
YAML

feature: 검색엔진 드라이버 폴백 가드 (A5b)
description: |
드라이버 폴백 가드는 `DriverRegistryService` 의 카테고리 레지스트리를 순회하며, 저장된
드라이버가 현재 사용 불가면 기본 드라이버로 되돌린다. 검색엔진(`drivers.search_engine_driver`)
만 그 레지스트리에 없어 가드 대상 밖이었다.
결과: 검색엔진 플러그인을 선택해 저장한 뒤 그 플러그인을 제거하면 `scout.driver` 가 죽은
값으로 남고, 공개 검색이 500 으로 떨어진다. 다른 카테고리는 같은 상황에서 기본 드라이버로
폴백해 사이트가 살아남는다 — 같은 부류의 결함인데 이 축만 방어가 없었다.
검색엔진은 등록 훅이 다르다(`core.search.engine_drivers` — Scout 엔진 맵). 플러그인에
제2의 등록 훅을 요구하지 않도록, 카탈로그 조회가 그 훅을 함께 읽는다. 일반 드라이버 훅
(`core.settings.available_search_drivers`)도 그대로 인식해 양쪽 등록 방식을 모두 받는다.
axes:
# 엔진이 어디서 왔는가. 레지스트리 표면(카테고리 등재·기본 드라이버·설정/Config 키)은
# 엔진 출처와 직교하는 단일 사실이라 축이 아니라 effects 로 판정한다 — 축으로 두면
# 전개만 4배가 되고 조합마다 검증할 내용이 같아진다.
engine_source: [core, plugin_scout_hook, plugin_generic_hook, removed]
effects:
- search_category_registered_in_driver_registry # 폴백 가드 순회 대상에 편입
- core_search_engine_declared_as_core_driver # mysql-fulltext 가 코어 드라이버로 인식
- search_default_fallback_is_core_engine # 폴백 대상이 mysql-fulltext
- search_settings_key_matches_saved_field # drivers.search_engine_driver 와 일치
- search_config_key_matches_apply_site # scout.driver — 실제 적용 지점과 동일
- scout_hook_registered_engine_is_available # 살아있는 플러그인 엔진을 사용 가능으로 판정
- generic_hook_registered_engine_is_available # 일반 드라이버 훅 등록분도 인식 (하위호환)
- removed_plugin_engine_is_unavailable # 제거된 엔진은 사용 불가 → 기본 엔진 폴백
- admin_driver_options_include_search_category # 관리자 응답의 available_drivers 에 포함
test_files:
- tests/Feature/Settings/SearchDriverFallbackTest.php
- tests/Unit/Services/DriverRegistryServiceTest.php
- tests/Feature/Api/Admin/SettingsControllerDriverOptionsTest.php