Skip to content

feat: 확정된 Oracle 뷰로 팀 업무 지표 조회 (#266) - #271

Open
seyoung4503 wants to merge 1 commit into
fix/require-business-definitionsfrom
feat/oracle-term-binding
Open

seyoung4503 wants to merge 1 commit into
fix/require-business-definitionsfrom
feat/oracle-term-binding

Conversation

@seyoung4503

Copy link
Copy Markdown
Collaborator

#️⃣ Issue Number

관련 #266. 정의 확인 영수증을 제공하는 #264 위에 쌓은 첫 번째 PR입니다. #264 병합 후 기본 브랜치를 대상으로 통합해야 합니다.

📝 요약

  • 운영자가 기존 확정 정의와 DB 뷰, NUMBER 금액·DATE 기간 컬럼, SUM, 행 단위, 필수 문자 필터를 확인해 연결합니다. 기존 org/team/user 조회 순서와 메타데이터 저장소를 사용합니다.
  • 연결된 지표는 모델이 지정한 두 날짜로 정해진 집계 SQL을 생성합니다. 값은 바인딩하고 기존 안전 검사를 거치며, 조회 계정으로 실행 전후 DB·뷰 계약을 검사합니다. 연결이 유효하지 않으면 재확인을 요청합니다.
  • 도구 응답과 감사 기록에서 정의·범위·뷰·조건·SQL을 확인할 수 있습니다. 재현 가이드 및 4문항 전체 결과를 포함했습니다.

💬 To Reviewers

  • 실제 Oracle Free 23.9에서 동료의 새 세션으로 월 경계, 할인·반품·NULL을 포함한 4개월을 조회해 25, 118, 10, NULL을 확인했습니다.
  • 다른 팀의 정의 조회가 차단됐습니다. 동명 뷰가 있는 두 번째 Oracle DB, SELECT 권한 회수, 금액 컬럼 변경, 뷰 삭제도 각각 차단됐습니다. 성공 SQL 4건·계약 검증 실패 4건이 기록됐고 이 검증에서 원본 테이블 대체 실행은 0건입니다.
  • 자연어 비교는 같은 GPT-4.1 mini 스냅샷·질문·DB·호출 예산을 사용했습니다. 텍스트 조건은 1/4 실행·정답(모델 호출 12회), 연결 조건은 2/4 실행·정답(10회)이었습니다. 10월은 명시적 계약 호출에서 118이었으나 자유 질의 실험에서는 두 조건 모두 답하지 못했습니다. 날짜나 정의를 다시 질문하는 문제가 남아 있습니다.
  • 이 단계는 신뢰하는 일반 뷰에 대한 단일 지표 집계입니다. 함수 허용 목록·부작용 검토는 후속 단계입니다. 명시한 지표 및 이름을 감지한 요청에 적용하며, 임의 SQL의 업무 의도를 추론하는 DB 접근통제 기능은 아닙니다.

PR Checklist

  • Python 3.10·3.13 각각 181 tests passed
  • 변경 Python Black, Ruff(기존 파일의 기존 경고 제외), 핵심 모듈 mypy, lock, diff 검사 통과
  • 실제 Oracle 두 인스턴스와 stdio MCP, 모델 실행 및 문항별 결과 기록

구현 원칙 verify

항목 판정 근거
1 재사용 O Semantic Federation, SQLite KV, SQLAlchemy explorer, 기존 정의 확인·안전 검사·감사를 연결. #257의 Oracle 행 제한 코드를 재사용. 데모·결과·테스트 포함 순증 1,030줄
2 범위 O 뷰 계약 등록·실행·검증 및 재현 자료
3 로깅 O 확인자·시점, 저장·차단·실행과 실제 SQL·인자를 기록
4 오류 O 객체/계정/계약 변경이 확인되면 오류 반환. 대체 SQL 실행 없음
5 환경 주입 O 기존 DB 설정과 동일한 조회 계정 사용
6 주석 O 신규 코드 주석에 이슈 번호 없음
7 검증 O 테스트·정적 검사·Oracle 실험. CODE MAP 스크립트 없음
8 승인 O 기능 브랜치 및 PR까지 수행
9 흐름 O 운영자 확인 → 동료 조회 → 결과·감사 예제 제공
10 sync/async O 동기 SQLAlchemy 메타데이터 확인·집계를 한 worker에서 수행
11 설정 O 서비스 환경변수 추가 없이 Oracle 드라이버 extra 및 데모 설정 제공

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant