# DeskAide — Design Context

> 사내 AI 챗봇 '지오' 위젯의 디자인 정본. 출처: `persona_kimjunhyub`, `docs/voice_identity_2026_07.md`,
> `feedback_ui_design_rules`, `feedback_wcag_22_checklist`, `feedback_pretendard_standard`, ADR-007(테마).
> 신규 디자인 작업은 이 문서를 먼저 읽는다.

## Design Context

### Users

지오뷰(해양물리탐사) 임직원 약 42명. **대부분 비개발자** — 측량·조사·처리·영업·관리 실무자다.
사내 웹앱(ControlTower 운영보드 · EquipMan 장비관리 · ReportLLM 문서검색)을 업무 중 수시로 여는
사람들이고, 위젯은 그 화면 **우하단에 상주하는 보조 도구**다. 사무실 조명 아래 데스크톱 브라우저가
주 환경(모바일은 부차).

하려는 일: 장비 수량·상태 확인, 사내 문서 위치·내용 확인, 여러 문서 종합, 웹 조사.
답이 수 초~수 분 걸리므로 **"던져놓고 딴 일 하다 돌아오는" 비동기 사용이 기본값**이다.

### Brand Personality

**시니컬 · 간결 · 정확 (무미건조).** 뿌리는 김준협 페르소나이고, 제품 언어 정본은 voice_identity 다.

- 과장·감탄·장식 이모지 **금지**(Iron Rule). "최고의·혁신적" 류 형용사 금지.
- **정직이 최우선** — 근거 없으면 "확인되지 않았습니다". 모르는 걸 아는 척하지 않는 게 브랜드의 핵심.
- 숫자는 천단위 콤마, 과학적 표기 금지(Iron Rule).
- 감정 목표: **신뢰와 차분함**. 들뜨게 하지 않고 "얘 말은 믿어도 되겠다"는 느낌.

### Aesthetic Direction

**Utilitarian precision** — 사무용 계기판에 가까운 절제. 도구지 장난감이 아니다.

- **테마**: Light/Dark 양쪽 동등 지원(ADR-007·전 앱 정합). 호스트가 라이트 기본·주간 사무실 사용이라
  라이트가 1차, 다크는 `prefers-color-scheme`로 대응.
- **색**: oklch 토큰 체계 확립됨(`--da-accent` hue 230 청록 · `--da-accent-soft` · text primary/secondary/
  tertiary). **신규 hue 도입 금지** — 기존 토큰 안에서 해결.
- **서체**: Pretendard 계열 우선. static weight만(650 같은 중간값 금지) — 본문 400 · 라벨 600 · 헤딩 700.
- **한글 가독성**: 줄바꿈은 의미/호흡 단위, `word-break: keep-all` · `text-wrap: pretty`.
- **안티레퍼런스**: 보라-파랑 그라디언트, 글래스모피즘, 네온 다크, 그라디언트 텍스트, 카드 남발,
  좌측 컬러 스트라이프. "AI가 찍어낸 챗봇 위젯"으로 보이면 실패.

### Design Principles

1. **정직이 UI다** — 진행 상태·근거·한계를 숨기지 않는다(경과시간 표시, "인덱스 기준" 표기,
   읽기전용 고지). 예쁘게 뭉개는 것보다 정확히 알리는 게 우선.
2. **호스트를 침범하지 않는다** — 위젯은 남의 화면에 얹히는 손님. 닫혀 있으면 84px 런처 하나뿐이고
   호스트 레이아웃·색·스크롤에 영향 0.
3. **비동기가 기본** — 오래 걸린다는 전제로 설계한다. 기다림을 숨기지 말고 가시화하고,
   이탈·새로고침·재접속을 예외가 아니라 정상 경로로 취급한다.
4. **기존 토큰 안에서** — 새 hue·새 그림자·새 radius를 만들지 않는다. 있는 체계를 정확히 쓰는 것이
   개성보다 우선.
5. **WCAG AA 는 하한선** — 대비 4.5:1, 보이는 포커스 링, 24px 타깃(WCAG 2.2). 접근성은 옵션이 아니다.
