| ui_doc_type |
view_id |
status |
frame |
source_evidence |
regions |
| view |
settings |
계획 |
null |
| type |
path |
notes |
| user |
null |
User requested one canonical registry for settings that should be hidden, excluded, masked, read-only, or removed before future UI design. |
|
|
| settings.configuration-exposure-policy |
|
Settings
View ID: settings
Frame:
Status: 계획
Source Evidence
| Type |
Path |
Notes |
| user |
없음 |
향후 UI 설계에서 참조할 설정 노출·제외 결정을 한 곳에 모으도록 요청했다. |
Purpose
향후 설정 UI 설계에 앞서 설정별 노출, 편집, 마스킹, 제외 결정을 한 곳에서 관리한다.
실제 config schema를 복제하지 않고 설정 경로와 근거 계약을 참조하며, UI 정책과 런타임 설정 제거를 구분한다.
Primary Users
- IOP operator
- 설정 UI를 설계하거나 구현하는 engineer와 agent
Primary Tasks
- 설정별 UI 노출 및 편집 가능 여부 확인
- 비노출, 마스킹, 읽기 전용, 스키마 제거 후보 결정 기록
- 향후 view와 component 설계 시 설정 정책 참조
Information Priority
- 설정 경로와 UI 처리 결정
- 결정 사유와 대체 표현 또는 설정
- 적용 화면, 계약 근거, 결정 상태
Regions
| Region ID |
Purpose |
Component |
Priority |
Notes |
settings.configuration-exposure-policy |
설정별 UI 노출·제외 정책 관리 |
없음 |
high |
실제 화면 배치와 component는 향후 UI 설계에서 확정한다. |
Configuration Exposure Policy
UI 처리 값
편집 가능: UI에서 값을 조회하고 변경할 수 있다.읽기 전용: UI에서 값을 표시하지만 변경할 수 없다.마스킹: secret 원문을 노출하지 않고 존재 여부나 축약값만 표시한다.UI 비노출: 설정은 유지하지만 UI에서 표시하거나 변경하지 않는다.스키마 제거 후보: UI 결정만으로 제거하지 않고 matching config contract와 구현 변경이 별도로 필요하다.
설정 정책 목록
설정 경로를 고유 키로 사용한다. 같은 설정은 새 행을 만들지 않고 기존 행을 갱신한다.
| 설정 경로 |
소유 범위 |
UI 처리 |
사유 |
대체 표현/설정 |
적용 화면 |
근거 |
결정 상태 |
기록 규칙
- secret, token, credential 원문은 기록하지 않는다.
UI 비노출을 config schema 제거로 해석하지 않는다.스키마 제거 후보는 matching agent-contract와 구현이 갱신되기 전까지 실제 제거로 표시하지 않는다.- 실제 config key, type, default는 이 문서에 복제하지 않고 matching contract 경로를
근거에 기록한다.
- 사용자 결정이 명확하면
결정 상태를 확정으로 기록한다.
- 설정 경로, 처리 의미, 소유 범위가 불명확하면 추정으로 행을 추가하지 않고
Open Questions 또는 agent-ui/USER_REVIEW.md로 분리한다.
- 이 문서 기록만으로 UI 코드 동기화를 시작하지 않는다.
Actions
| Action ID |
Trigger |
Result |
Guard |
| 없음 |
없음 |
구체적인 UI action은 향후 화면 설계에서 확정한다. |
없음 |
States
- loading: 향후 UI 설계에서 확정한다.
- empty: 등록된 설정 정책이 없음을 표시하는 방향으로 설계한다.
- error: 향후 UI 설계에서 확정한다.
- permission-denied: 설정 조회·변경 권한 모델과 함께 확정한다.
Open Questions
- navigation과 화면 배치
- 설정 그룹과 반복 component 구조
- 설정 조회·변경 권한 모델
Decision History
- 2026-08-03: 설정 UI 노출·제외 결정을 누적하는 중앙 정책 문서를 계획 상태로 만들고, 문서 기록만으로 코드 동기화를 시작하지 않도록 정했다.
