vpd-permission-poc/docs/design/459-permission-edge-test-scenarios/README.md

설계서: 권한 조합/경계값/오류 메시지 시나리오 확장 (#459)

상태: Approved 작성: [AI] Architect · 최종수정: 2026-06-25 추적성 — Redmine: #459 · 관련 ADR: 없음 · 구현 파일: docs/testing/459-permission-edge-scenarios.md, scripts/vpd-ords-regression-test.sh · 테스트: ./run.sh backoffice-vpd-ords-test, mvn test

1. 목적 (Why)

정상 권한 매트릭스뿐 아니라 잘못된 token, 권한 조합, 컬럼/값 누락, ORDS path 불일치 같은 운영 중 자주 발생할 경계 시나리오를 테스트 항목으로 고정한다.

2. 범위 (Scope)

• 포함: 수동/E2E 테스트 체크리스트 문서, invalid bearer token 자동 smoke, 기대 오류 관점 정리.
• 제외: Playwright 브라우저 자동화, 모든 UI 입력 케이스 자동화.

3. 인수조건 (Acceptance Criteria)

• 권한 조합/경계값/오류 메시지 체크리스트가 문서화된다.
• 자동 ORDS smoke에 invalid token 실패 검증이 포함된다.
• 실패 시 request/response evidence 경로가 출력된다.
• mvn test가 통과한다.

4. 컨텍스트 & 제약

• ORDS 정상 매트릭스는 #458 스크립트를 재사용한다.
• UI 입력 검증은 #457에서 일부 보강됐고, 여기서는 테스트 관점에서 확인 항목을 정리한다.

5. 아키텍처 개요

docs/testing/459-permission-edge-scenarios.md
  -> 수동/운영 테스트 체크리스트

scripts/vpd-ords-regression-test.sh
  -> 정상 HR/SELF/ALL 검증
  -> invalid token smoke 검증

6. 데이터 모델

• invalid token: DB에 등록하지 않은 UUID token.
• 기대 결과: HTTP 200이 아니어야 하며, 성공 rows로 해석되면 실패.

7. 함수 명세 (Function Specs)

함수	책임(1줄)	시그니처(잠정)	입력	출력	에러/실패	복잡?
call_and_assert_rejected	잘못된 token이 성공 조회로 처리되지 않는지 검증	bash function	label, token	PASS/FAIL	HTTP 200이면 실패	단순

8. 흐름 / 알고리즘

1. 정상 매트릭스 HR/SELF/ALL을 검증한다.
2. 등록되지 않은 token으로 같은 ORDS endpoint를 호출한다.
3. HTTP 200이면 실패, 아니면 거부 smoke PASS로 처리한다.
4. request/response evidence를 남긴다.

9. 엣지케이스 & 에러 처리

• invalid token이 ORDS 403을 반환하는지 확인한다.
• ORDS 404/500도 성공 조회가 아니므로 이 smoke에서는 거부로 본다. 상세 오류 분류는 백오피스 probe classifier에서 검증한다.

10. 테스트 계획

• SQLCL_BIN=/tmp/sqlcl/sqlcl/bin/sql SQLCL_JAVA_HOME=... ./run.sh backoffice-vpd-ords-test
• mvn test

11. 리스크 & 대안 검토

• 선택: invalid token smoke를 기존 회귀 스크립트에 포함한다. 테스트 실행 시간이 거의 늘지 않고 보안 기본 동작을 고정할 수 있다.
• 대안: 별도 스크립트. 중복 token/ORDS 설정 로직이 생긴다.

12. 미해결 질문 (Open Questions)

• 브라우저 기반 권한 등록/삭제 자동화는 별도 E2E 도입 시 다룬다.