iop/agent-ui/definition/views/settings/index.md

3.9 KiB

ui_doc_type view_id status frame source_evidence regions
view settings 계획 null
type path notes
user null User requested one registry for work items that should later become user-adjustable settings.
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: 작업 중 설정으로 빼라고 지정한 내용을 설정 후보로 누적하고, 대기완료만으로 구현 대상을 구분하도록 정했다.