refs #732: stabilize carrier report result schema

This commit is contained in:
devmrko
2026-08-10 17:37:32 +09:00
parent 6394bbf078
commit 84029ed633
6 changed files with 84 additions and 0 deletions

View File

@@ -20,6 +20,21 @@
선사 조회의 자연어 처리와 `CARRIER_CODE` 조인은 기존 Select AI 프로필을 유지한다. 권한 조건을
질문이나 고정 SQL에 넣지 않고 Oracle VPD가 세션 사용자 ID로 자동 적용한다.
## 출력 스키마 계약
Select AI는 같은 의미의 컬럼도 호출마다 `CARRIER_CODE`, `carrier Code`, `선사코드`처럼 다른
alias로 생성할 수 있다. `vpd-backoffice/config/hmm_carrier_query_contract.json`은 SQL을 고정하지
않고 다음 결과 alias만 고정한다.
```text
EMPLOYEE_CODE, EMPLOYEE_NAME, MANAGER_EMPLOYEE_CODE,
CARRIER_CODE, CARRIER_NAME, LATEST_REVENUE_USD,
LATEST_GROSS_MARGIN_USD, LATEST_SCHEDULE_RELIABILITY_PCT,
LATEST_RISK_LEVEL
```
따라서 권한에 따라 행 수는 달라져도 renderer에 전달되는 행 구조는 매 호출 동일하다.
## 신뢰 경계
- 화면에 표시된 사용자 코드는 권한 근거가 아니다. 선택 preset의 전용 Bearer token이 근거다.