104 lines
3.9 KiB
Markdown
104 lines
3.9 KiB
Markdown
---
|
|
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: 작업 중 `설정으로 빼`라고 지정한 내용을 설정 후보로 누적하고, `대기`와 `완료`만으로 구현 대상을 구분하도록 정했다.
|