vpd-permission-poc/docs/design/495-schema-preflight-ddl-results/README.md

Redmine #495 - 설정/초기화 preflight와 DDL 실행 결과 상세화 설계

프로젝트 개요

VPD Backoffice는 Oracle Database VPD/ORDS 기능을 백오피스 권한 테이블로 제어하는 Spring Boot 관리 도구다. 사용자는 Oracle DB schema user가 아니라 Bearer Token으로 식별되는 application user이며, 사용자/그룹/역할/권한/행 규칙/컬럼 NULL 처리 설정이 VPD policy function과 ORDS 조회 결과에 반영된다.

목표

DB 연결을 다른 ADB나 schema로 바꿨을 때 운영자가 현재 준비 상태를 한 화면에서 판단하고, 앱에서 실행 가능한 초기화 DDL과 sqlcl로 실행해야 하는 작업을 구분해 처리할 수 있게 한다.

현재 문제

• /settings 화면은 지원 테이블 생성 버튼과 단순 결과 표만 제공한다.
• 현재 연결 사용자와 ORDS parsing schema 권장 구성을 분리해서 보여주지 않는다.
• 필수 테이블, 시퀀스, 컬럼, constraint, VPD context/function/policy, CB_ORDS grants, ORDS enablement 상태를 한 번에 확인하기 어렵다.
• 실행 전에 어떤 SQL이 수행되는지 확인하기 어렵다.
• DDL 실패 시 전역 오류나 짧은 메시지로 끝나 운영자가 어떤 단계에서 실패했는지 파악하기 어렵다.

설계

• 설정 화면에 DB 준비 상태 섹션을 추가한다.
  • 현재 연결 사용자
  • 권장 ORDS parsing schema: CB_ORDS
  • 앱에서 실행 가능 여부와 sqlcl 필요 여부
• preflight 항목을 레이어별로 표시한다.
  • Backoffice Metadata: 지원 테이블, 시퀀스, 컬럼
  • Constraint/Index: 주요 PK/UK constraint
  • VPD Runtime: CB_AGENT_CTX, CB_AGENT_CTX_PKG, CB_AGENT_DOC_VPD_FILTER, CB_AGENT_CAN_READ_COLUMN, 적용 policy 존재 여부
  • ORDS Runtime: CB_ORDS user, ORDS schema enablement, CB_ORDS_HANDLER_PKG
  • Grants: CB_ORDS에 필요한 EXECUTE/SELECT 권한
• DDL preview를 추가한다.
  • /settings/schema/initialize 버튼이 현재 연결 사용자로 실행할 SQL을 보여준다.
  • sqlcl로 실행할 스크립트 순서와 대표 grant SQL을 별도로 보여준다.
• DDL 실행 결과를 상세화한다.
  • 각 작업의 object, action, status, message, SQL을 표시한다.
  • 실패해도 가능한 범위의 결과를 화면에 남겨 운영자가 실패 지점을 확인할 수 있게 한다.

완료 기준

• 설정 화면에서 현재 연결 사용자와 권장 ORDS parsing schema가 보인다.
• 필수 테이블, 시퀀스, 컬럼, constraint, package/context/policy/grants/ORDS enablement 상태가 구분되어 보인다.
• 앱 실행 DDL preview와 sqlcl 실행 순서가 복사 가능한 형태로 보인다.
• 지원 테이블 생성/확인 실행 후 각 DDL의 성공/존재/실패와 SQL을 확인할 수 있다.
• DB 연결이 불안정하거나 지원 테이블이 없어도 가능한 preflight 정보는 표시되고, 오류는 화면 alert로 감싼다.
• mvn test와 설정 화면 desktop/mobile 렌더링을 통과한다.