---
ui_doc_type: view
view_id: settings
status: 계획
frame: null
source_evidence:
  - type: user
    path: null
    notes: User requested one registry for work items that should later become user-adjustable settings.
regions:
  - settings.configuration-candidates
---

# Settings

View ID: `settings`

Frame:
- 없음

Status: `계획`

## Source Evidence

| Type | Path | Notes |
|------|------|-------|
| user | 없음 | 작업 중 설정으로 조절할 필요가 있다고 지정한 내용을 향후 UI 설계에서 참조할 수 있게 한 곳에 모으도록 요청했다. |

## Purpose

작업 중 사용자가 설정으로 조절할 필요가 있다고 지정한 내용을 한 곳에서 관리한다.
정확한 config key나 UI 구조가 정해지기 전에도 작업 맥락으로 후보를 남기고, 향후 설정 UI 설계와 구현에서 사용한다.

## Primary Users

- IOP operator
- 설정 UI를 설계하거나 구현하는 engineer와 agent

## Primary Tasks

- 작업 중 설정으로 조절해야 할 후보 등록
- 설정 후보의 작업 맥락과 적용 대상 확인
- 향후 view와 component 설계 시 `대기` 후보 반영

## Information Priority

1. 설정으로 조절할 내용과 작업 맥락
2. 적용 대상과 구현 상태
3. 완료된 항목의 구현·검증 근거

## Regions

| Region ID | Purpose | Component | Priority | Notes |
|-----------|---------|-----------|----------|-------|
| `settings.configuration-candidates` | 설정으로 조절할 후보와 구현 상태 관리 | 없음 | high | 실제 화면 배치와 component는 향후 UI 설계에서 확정한다. |

## Settings Candidates

### 상태 값

- `대기`: 향후 설정 UI 설계 또는 구현에서 반영해야 한다.
- `완료`: 설정 UI와 관련 구현·검증 근거가 확인되어 다음 구현 대상에서 제외한다.

### 설정 후보 목록

각 후보는 `SET-NNN` id를 사용한다. 같은 내용을 다시 언급하면 새 행을 만들지 않고 기존 id의 작업 맥락을 갱신한다.

| ID | 설정으로 조절할 내용 | 작업 맥락 | 적용 대상 | 상태 | 구현 근거 |
|----|----------------------|-----------|-----------|------|-----------|

### 기록 규칙

- 새 id는 현재 목록의 가장 큰 번호 다음 `SET-NNN`으로 발급하고 완료된 id를 재사용하지 않는다.
- 사용자가 작업 설명 중 `설정으로 빼`라고 지정하면 현재 작업 맥락을 짧게 요약해 `대기`로 등록한다.
- 정확한 config key나 component id는 등록 필수 조건이 아니다. 이후 확정되면 같은 id를 갱신한다.
- `적용 대상`에는 확정된 view/component id가 있으면 기록하고, 없으면 기능 또는 도메인 이름을 기록한다.
- secret, token, credential 원문은 기록하지 않는다.
- 새 항목과 내용이 변경된 완료 항목은 `대기`로 둔다.
- 코드와 검증 근거가 확인된 항목만 `완료`로 바꾸고 `구현 근거`를 기록한다.
- 설정 UI 설계와 구현에서는 `대기` 항목만 대상으로 삼는다.
- 이 문서 기록만으로 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: 작업 중 `설정으로 빼`라고 지정한 내용을 설정 후보로 누적하고, `대기`와 `완료`만으로 구현 대상을 구분하도록 정했다.