확장이 훅으로 등록한 카탈로그에서 고른 값은 그 확장이 사라져도 저장값으로 남는다. 그 상태에서 값만 보고 판정하면 이미 제공 불가한 항목이 사용자 화면에 그대로 노출된다. 예외도 경고도 로그도 남지 않아 관리자 화면과 나란히 보지 않으면 드러나지 않는다. - 결제수단에 지정한 PG, 현금영수증 발급사, 검색엔진 드라이버 세 축에 같은 판정을 적용. 공개 응답에서는 제거하고 관리자 응답에는 표시를 남긴다 — 운영자가 고쳐야 할 대상이라 감추면 복구 경로가 사라진다. 서버 검증도 같은 판정을 공유해 화면 우회 제출을 막는다. - 설정 단건 저장이 벌크 저장과 다른 경로를 타던 문제를 코어·이커머스·게시판에서 정리. 저장은 성공하고 파생 값만 갱신되지 않아 어느 화면에서 저장했느냐로 결과가 갈렸다. - 단건 저장의 값 형태 계약 신설. 빈 값으로 되돌릴 수 있게 하고, 타입은 defaults.json 의 기본값을 SSoT 로 삼는다. 해석 불가한 입력은 조용히 캐스팅하지 않고 거절한다. - 드라이버 셀렉트를 서버 카탈로그에 바인딩하고, 저장값이 카탈로그에 없으면 그 값을 드러내는 안내를 8곳 전수에 붙인다. 종전에는 빈 칸으로만 보여 무엇이 저장됐는지 알 수 없었다. 시나리오 매니페스트 8종을 면제 없이 신설했다. `audit:allow` 는 cross product 와 effects 검사를 함께 끄므로, 면제가 걸린 매니페스트에 선언을 추가하면 검증이 회복되지 않는다. 그 아래에서 대응 테스트가 없는 effect 이름 2건이 살아남아 있었고, 함께 정리했다.
37 lines
2.5 KiB
YAML
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
|