Files
AX-Copilot-Codex/docs/UI_UX_CHECKLIST.md
lacvet 6e65cf6026
Some checks failed
Release Gate / gate (push) Has been cancelled
연속 개선: 권한 상태 간소화·설정창 외부 진입 안정화·컴포저 반응형 보강
- 권한 상태 텍스트(/permissions,/allowed-tools)를 운영 모드 포함 축약형으로 재정리
- 하단 권한 버튼 툴팁에 운영 모드/기본값/예외 개수 정보를 일관 반영
- 탭 전환 시 좌측 메뉴 Visibility 재할당을 최소화해 UI 흔들림 완화
- 상단 모델 라벨에 MaxWidth+말줄임 적용으로 긴 모델명 레이아웃 깨짐 방지
- AX Agent 설정창 오픈 시 리소스 병합 예외를 방어하고 외부 진입 경로를 Dispatcher 기반으로 안정화
- UI 체크리스트/개발문서/README에 2026-04-04 12:41 기준 점검 이력 업데이트
- 검증: build 경고0/오류0, 운영모드 필터 18건 통과, 전체 테스트 436건 통과
2026-04-04 12:42:49 +09:00

3.4 KiB

AX Agent UI/UX 점검 체크리스트

업데이트: 2026-04-04 12:22 (KST)

1. 공통 화면 품질

  • 창 진입 시 레이아웃 깨짐/문자열 깨짐 없이 렌더링된다.
  • 상단 탭(Chat, Cowork, Code) 전환 시 불필요한 새 대화 이력이 자동 생성되지 않는다.
  • 좌측 패널은 탭별 목적에 맞는 최소 메뉴만 표시된다.
  • 입력창 상단의 모델/프리셋 바가 단일 라인으로 정돈되어 표시된다.
  • 메시지 버블(사용자/어시스턴트)의 여백/폰트/액션 배치가 일관된다.

2. 슬래시(/) 팔레트

  • / 입력 시 팝업이 즉시 열리고 첫 가시 항목이 선택된다.
  • 마우스 휠 스크롤이 정상 동작한다.
  • 방향키(Up/Down), PageUp/PageDown, Home/End, Enter, Esc가 모두 동작한다.
  • 정리, 전체 접기/펼치기 버튼이 정상 동작한다.
  • 모든 그룹을 접었을 때 안내 문구가 노출된다.
  • 핀/최근 정렬 우선순위가 핀 > 최근 > 이름으로 유지된다.

3. 권한 팝업

  • 권한 버튼 클릭 시 팝업이 즉시 열리고 키보드 포커스가 진입한다.
  • Tab으로 항목 이동, Enter/Space로 모드 적용, Esc로 닫기가 동작한다.
  • 섹션 접힘 상태(요약/예외/거부/고급)가 재오픈 시 복원된다.
  • 하단 권한 표시와 상단 권한 배너의 표현이 현재 모드와 일치한다.

4. AX Agent 설정

  • AX Agent 설정 창이 예외 없이 열린다(트레이/앱 내부 모두).
  • 슬래시 핀 최대 개수, 최근 최대 개수 변경 후 즉시 반영된다.
  • 모델 서비스/모델 변경이 입력창 모델 라벨과 일치한다.

5. 운영 모드 시나리오

External 모드

  • AX Agent 설정에서 operationMode=external 전환 후 저장한다.
  • ? 검색어를 실행하면 웹 검색이 정상 수행된다.
  • 외부 LLM 호출(허용된 서비스)이 정상 수행된다.

Internal 모드

  • AX Agent 설정에서 operationMode=internal 전환 후 저장한다.
  • ? 검색어를 실행하면 외부 검색이 차단되고 안내 메시지가 표시된다.
  • 외부 URL 열기/외부 HTTP 도구가 차단된다.
  • 사내 허용 경로(온프레미스 LLM/MCP)는 정상 동작한다.

6. 회귀 확인

  • dotnet build src/AxCopilot/AxCopilot.csproj 경고 0 / 오류 0
  • dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj 전체 통과

7. 최근 점검 결과

점검 시각: 2026-04-04 12:22 (KST)

  • 권한 모드 표면 명칭/순서 통일 적용 확인
  • / 팔레트 휠/방향키/PageUp/PageDown/Home/End 동작 경로 반영 확인
  • AX Agent 설정 권한 순환 순서와 /sandbox-toggle 순환 순서 일치 확인
  • 운영 모드 회귀 필터 테스트 18건 통과 (OperationModePolicy/Readiness/LlmOperationMode)
  • 전체 테스트 436건 통과

점검 시각: 2026-04-04 12:41 (KST)

  • 권한 버튼 툴팁에 운영 모드 + 기본 권한 + 예외 개수 표시 확인
  • 권한 상태 텍스트(/permissions, /allowed-tools)를 축약형으로 정리 확인
  • 모델 라벨 말줄임 처리(MaxWidth, CharacterEllipsis) 적용 확인
  • 설정창 외부 진입(OpenAgentSettingsFromExternal) Dispatcher 경유 오픈 경로 확인
  • 운영 모드 필터 테스트 18건 재통과
  • 전체 테스트 436건 재통과