13 KiB
design.md — Everything2Everything 디자인 결정 SSOT
2026-10-06 리디자인: Windows 11 정통 네이티브. 이전 방향("아크릴 & 네오 글래스 + 네온 시안")은 폐기했다. 폐기 이유는 §7, 바꿀 때 지켜야 할 계약은
src/Everything2Everything.Tests/Win11NativeDesignTests.cs.
1. 브리프 (0단계 · 사용자 인터뷰 2026-10-06)
무엇을: Everything2Everything(.NET 9 WPF + Wpf.Ui 4.3) 전 창을 Windows 11 정통 네이티브 언어로 리디자인
누구에게: 탐색기 우클릭·일괄 변환을 쓰는 사용자 — 옵션을 빨리 고르고 결과를 믿고 넘기길 원함
제약: 3분할 정보 구조 유지 · 광고 두 자리 유지 · 시스템 라이트/다크·강조색 추종 · TDD(실패 0)
기본 언어 ko-KR 한국어, 영어는 기술 용어(EXIF·CRF·kbps 등)만
| 인터뷰 질문 | 사용자 답 |
|---|---|
| 시각 방향 | Windows 11 정통 네이티브 (Mica, 시스템 강조색, Segoe UI Variable, 라이트/다크 자동) |
| 레이아웃 범위 | 3분할 유지 + 정돈 |
| 대상 창 | 메인 · 우클릭 빠른 창(옵션/진행) · 설정 · 도구 설치 · 진단 전부 |
| 광고 | 현 두 자리 유지 (목록 하단 배너 + 미리보기 하단 카드) |
리디자인 전 감사 (무너져 있던 것)
- 사이드바 체크박스 라벨이 잘림 — "무손실(Lossless) 보존 (WebI…"
- 거의 검은 바탕 + 네온 시안 하나: AI 생성 디자인의 가장 흔한 지문. "네오 글래스"라 했지만 실제 렌더는 평평한 상자
- 카드 안 카드 4중 중첩, 10~11px 글자 남발, 3차 텍스트 대비 부족
- Mica를 켜 놓고 85% 불투명 흑색(#D80A0C10)으로 덮어 Mica가 보이지 않음
- "큐"와 "대기열"이 같은 대상을 두 이름으로 부름
2. 레퍼런스 (1단계 · 정본 실측)
| 슬롯 | 출처 | 가져온 것 (실측값) |
|---|---|---|
| R1 구조 | learn.microsoft.com/windows/apps/design/signature-experiences/layering | 2계층: 베이스(Mica, 내비·명령) + 콘텐츠 레이어(앱의 중심 경험). 카드 elevation 8, 컨트롤 2, stroke 1 |
| R2 톤 | …/signature-experiences/typography | Segoe UI Variable 12/16 캡션 · 14/20 본문 · 20/28 부제 · 28/36 제목. 최소 14 Semibold / 12 Regular. 문장형 대소문자. Bold·Italic 대신 Semibold |
| R3 디테일 | …/signature-experiences/geometry | 컨트롤·리스트 4px, 창·플라이아웃·대화상자 8px, 맞닿는 직선 모서리 0px |
탐색기·설정 앱의 서명인 **"사이드 영역은 Mica 위, 본문은 왼쪽 위 모서리만 둥근 콘텐츠 레이어"**를 그대로 차용했다.
3. 방향 (2단계)
- 한 문장 컨셉: 탐색기에서 이어지는 작업창. 우클릭에서 태어난 도구라 메인 창도 탐색기·설정 앱과 같은 재질과 위계를 쓴다.
- 과감한 한 가지(표현 리스크): 85% 불투명 흑색 덮개를 걷고 Mica를 실제로 비치게 했다. 사이드바·제목 표시줄은 Mica 위(베이스), 대기열과 미리보기는
CornerRadius="8,0,0,0"인 하나의 콘텐츠 레이어(ContentLayer)에 올렸다.- 검증: 라이트/다크 실앱 캡처에서 두 층이 구분되는지, 텍스트가 4.5:1을 넘는지(자동 테스트)
- 반사실 점검: 이 선택은 "Windows 셸 확장 도구"라는 이 앱의 정체성에서만 나온다. 다른 업종의 랜딩 페이지라면 나오지 않는다.
- 표면 다이얼: 표현성 1 · 정보 밀도 2 · 모션 1(호버·눌림 상태만) · 텔레메트리 1(엔진 상태 점 하나)
4. 토큰 (3단계)
4.1 색 — Views/Themes/FsPalette.{Dark|Light}.xaml
값은 WinUI 공용 테마 리소스에서 가져왔다. 두 파일의 키 집합은 같아야 한다(테스트로 강제). 모든 Fs 색은 DynamicResource로 참조하며(테스트로 강제), FsThemeService가 시스템 테마에 맞춰 사전을 갈아 끼운다.
| 역할 | 다크 | 라이트 | WinUI 원천 |
|---|---|---|---|
| FsBgBase | 투명 | 투명 | Mica가 비친다 |
| FsBgLayer | #4C3A3A3A | #80FFFFFF | LayerFillColorDefault |
| FsBgCard | #0DFFFFFF | #B3FFFFFF | CardBackgroundFillColorDefault |
| FsBgControl | #0FFFFFFF | #B3FFFFFF | ControlFillColorDefault |
| FsBorderSubtle | #19000000 | #0F000000 | CardStrokeColorDefault |
| FsTextPrimary/Secondary | #FFFFFF / #C5FFFFFF | #E4000000 / #9E000000 | TextFillColor* |
| FsTextTertiary | #87FFFFFF | #8B000000 | WinUI 라이트 기본 #72는 3.3:1이라 4.5:1로 보정 |
| 상태(성공/경고/위험/정보) | #6CCB5F · #FCE100 · #FF99A4 · #60CDFF | #0F7B0F · #9D5D00 · #C42B1C · #005FB8 | SystemFillColor* |
강조색은 고정값이 없다. FsAccentPalette.From(시스템 강조색, 테마)가 색상·채도는 유지하고 명도만 밀어, 다음을 보장한다(9가지 극단 강조색으로 테스트).
- 다크: 밝은 채움 + 검정 글자 / 라이트: 어두운 채움 + 흰 글자 — 버튼 글자 ≥ 4.5:1(호버 포함)
- 강조 텍스트(FsAccentText)는 가장 불리한 면에서도 ≥ 4.5:1
형식 색(FsFmt*)은 두 테마가 같다. 채움으로 쓰지 않고 외곽선·점으로만 써서, 형식 색이 무엇이든 글자는 본문색으로 대비를 유지한다.
4.2 타이포 — FormatShiftTheme.xaml
- FsFontSans
Segoe UI Variable Text, Segoe UI, Malgun Gothic(한글은 Malgun Gothic 폴백) · FsFontDisplay(Variable Display) · FsFontMonoCascadia Mono, Consolas(경로·키 입력에만) - 스타일: FsCaptionStyle 12/16 Secondary · FsBodyStyle·FsLabelStyle 14/20 · FsSectionHeaderStyle 14 Semibold · FsSubtitleStyle 20/28 Semibold · FsNumStyle(캡션 + tabular 숫자)
- 최소 12px(테스트로 강제). 숫자는 모노 서체 대신 Segoe의 고정폭 숫자를 쓴다.
4.3 기하 · 간격
- CornerRadius ∈ {0, 2, 4, 8}(테스트로 강제). 컨트롤 4 · 카드·창·오버레이 8 · 탭 표시줄 2
- 간격 4의 배수. 카드 패딩 16, 카드 간격 8, 창 가장자리 16/24
- 컨트롤 높이 32, 사이드바 주 버튼 40, 제목 표시줄 48(메인, WinUI Tall) / 42(대화상자)
4.4 컴포넌트 문법
- 버튼 위계: FsAccentButtonStyle은 창마다 하나(메인=변환 시작 / 빈 대기열=파일 찾기 / 설정=저장 / 도구 설치=설치 시작) · 나머지는 FsSecondaryButtonStyle · 아이콘만 있으면 FsIconButtonStyle
- 카드: FsCardStyle 한 단계만. 카드 안에 카드 금지(테스트로 강제)
- 탭: 텍스트 + 강조색 밑줄 3×16px(WinUI SelectorBar)
- 입력: 채움 + 1px 외곽, 포커스 시 강조색 하단선 2px
- 슬라이더: 4px 트랙, 18px 썸(외곽 + 강조색 점, 호버 시 커지고 끌 때 작아짐)
4.5 성능 예산
WPF 데스크톱이라 웹 예산은 적용하지 않는다. 추가 이펙트(블러·그림자·애니메이션)는 0개. 렌더 비용은 Mica(OS 합성)뿐이다.
5. 화면별 결정 (4단계)
| 창 | 결정 |
|---|---|
| 메인 | 사이드바 = Mica 위 설정 카드 3장(변환 설정 · 저장 위치 · AI 작업). 통계 카드는 없애고 하단 한 줄 "오늘 변환 · 줄인 용량"으로. 콘텐츠 레이어 안에 검색 툴바 · 대기열/기록 · 미리보기. 빈 대기열은 목록 영역 전체를 점선 드롭 대상으로 보여 주고, 미선택 시 파일 정보 블록은 숨긴다 |
| 우클릭 빠른 옵션 | Mica 적용(이전 None). 제목 20px, 값은 tabular 숫자 |
| 빠른 진행 | 여백 24, 진행 막대 4px |
| 설정 | 카드 3장(AI · 외부 도구 · 광고), 긴 체크박스 라벨은 줄바꿈, 하단 바는 레이어 면 |
| 도구 설치 | 도구마다 카드 한 장, 카드 간격 4 |
| 진단 | Mica 적용. 코드로 만드는 카드도 FsCardStyle과 팔레트 토큰을 쓰고 SetResourceReference로 테마를 따른다 |
| 광고 | 자리 유지. 강조색을 쓰지 않는 중립 카드로 낮춰 작업 도구보다 먼저 시선을 끌지 않게 했다(배지 "광고", CTA는 표준 버튼) |
카피
- 같은 대상은 한 이름: "큐" → "대기열"(코드 문자열까지 테스트로 강제)
- 사이드바 체크 라벨은 카드 안쪽 폭에서 한 줄(16자 이내). 한글이 낱자로 끊기지 않게 한다
6. 검증 결과 (5단계)
- 자동: 전체 429개 통과 · 실패 0 · 빌드 경고 0. 새 계약 테스트는
Win11NativeDesignTests(강조색 대비 9종 × 테마, 팔레트 키 대칭·대비, 동적 참조, 하드코딩 색 금지, 최소 12px, 반경 단계, 카드 중첩 금지, Mica, 콘텐츠 레이어, 카피 어휘, 회귀 3종) - 시각: 실앱(E2E_THEME=dark/light) 캡처와
VisualCaptureHarness(창 6개 × 2테마, 채워진 대기열 포함)를 직접 열어 판정했다 - 렌더 감사에서 잡아 게이트에 추가한 실측 결함 4건:
- 제목 표시줄(DWM 확장 영역) 안에서 SymbolIcon이 Button의 직접 콘텐츠면 Foreground가 흰색이어도 검게 합성됨 → 패널로 감쌈 (
TitleBarButtons_MustNotHostSymbolIconDirectly) - Wpf.Ui CheckBox 기본 MinWidth 때문에 32px 열의 행 체크박스가 반쯤 잘림 →
MinWidth="0" - TextBoxBase가 Padding을 콘텐츠 호스트에 넘기는데 바깥 Border에도 Padding을 줘서 글자가 22px 들여 씌어짐 → Border Padding 제거
- 이미 표시된 FluentWindow에
ApplicationThemeManager.Apply(element)를 걸면 AllowsTransparency 예외로 크래시 → 창을 만들기 전에만 테마 적용
- 제목 표시줄(DWM 확장 영역) 안에서 SymbolIcon이 Button의 직접 콘텐츠면 Foreground가 흰색이어도 검게 합성됨 → 패널로 감쌈 (
- 미검증: 실제 OS 테마를 실행 중에 바꿨을 때의 전환(코드 경로는
SystemEvents.UserPreferenceChanged→ApplySystemTheme→ 팔레트 교체). 고대비 모드. 125%/150% 배율 실기기.
시각 검증 방법
# 실앱 테마 강제 (QA 전용)
$env:E2E_THEME="light"; .\Everything2Everything.exe
# 오프스크린 캡처 (창 6개 × 라이트/다크)
$env:E2E_CAPTURE_DIR="C:\temp\e2e"; dotnet test src/Everything2Everything.Tests --filter FullyQualifiedName~VisualCaptureHarness
7. 의도적으로 하지 않은 것과 그 이유
- 네온 시안 · 고정 강조색 폐기 — 사용자가 OS에서 고른 강조색이 곧 이 앱의 강조색이다. 고정색은 "Windows의 일부" 컨셉과 충돌한다.
- 더블 베젤(카드 안 카드) · 그라디언트 섬 버튼 · 림라이트 폐기 — Windows 11에 없는 문법이고, 중첩은 위계를 흐린다.
- Inter · JetBrains Mono 폐기 — 시스템에 없는 서체라 실제로는 Segoe/Consolas로 폴백되고 있었다. 시스템 서체를 명시했다.
- 10~11px 글자 폐기 — MS 최소 기준(12 Regular) 미만은 한글에서 특히 안 읽힌다.
- 광고에 강조색을 쓰지 않음 — 창마다 강조 버튼은 하나("변환 시작")라는 위계를 광고가 깨지 않게 했다.
- 진입 애니메이션 · 호버 글로우 없음 — 일괄 작업 도구는 즉시 반응이 미덕이다. 상태 변화(호버·눌림·포커스)만 표시한다.
- 레이아웃 3분할은 바꾸지 않음 — 사용자 결정. 비율과 위계, 빈 상태만 정돈했다.
- 배너 광고 HTML(
AdHtmlBuilder)은 손대지 않음 — 커밋되지 않은 AdMob 작업이고, 실제 광고의 모양은 앱이 통제할 수 없다. 라이트 테마에서는 테스트 배너만 어둡게 보인다(후속 과제). - 테스트 시간 10초 예산은 이번에 다루지 않음 — 리디자인 전부터 28초였다(현재 21초). 별도 과제.
2026-11-04 — 조사 기반 조작 경로 보완
기존 Windows 11 Fluent 방향·토큰·3분할·광고 2개 자리를 유지했다. 목록 상단에 파일 추가·폴더 추가·도움말을 기존 보조 버튼 스타일(높이32, 수평패딩12, 간격8)로 추가했다. 검색 0건 안내 및 조건 초기화, F1 도움말, 처리 중 파괴 명령 차단과 Esc 취소를 보완했다. 폴더 추가는 최상위 파일만 처리한다고 명시한다.
assertion RED 후 최소 수정했으며 최종 전체 테스트 450개 통과, 실패/건너뜀 0, 26초다. 10초 예산은 미달이다. docs/research/2026-11-04/visual-after/에 12개 캡처를 보존했고 대기열 라이트와 빈 상태 다크를 직접 확인했다. RenderTargetBitmap의 Mica는 근사값이다. OS 고대비·125/150%·스크린리더·실제 파일선택/도움말 모달은 별도 검증이 필요하다. 상세 근거와 남은 작업은 해당 폴더의 ui-audit.md, TASKS.md에 기록했다.
2026-11-04 — 1.1.0 완결 보완
같은 Fluent 시스템으로 사용자 프리셋 창과 이력 설정을 확장했다. 목록의 파일명은 네이티브 버튼으로 키보드 미리보기에 연결하고, 등록 해제·실패 복구·이력 필터·실제 예정 저장 폴더를 제공한다. 큐 변경은 사용자가 고른 품질과 프리셋을 덮어쓰지 않는다.
1080×640 최소 창에서 선택 도구 모음 잘림, 큐 파일명38px 및 이력 파일명24px, 통계와 버튼의 겹침을 렌더 assertion RED로 재현했다. 선택/통계와 동작을 두 줄로 분리하고 크기·상태를 파일명 아래에 배치했다. 이력의 고정 ‘완료’ 표시는 실제 성공·건너뜀·실패 상태로 바꿨다. 고대비는 시스템 색상쌍을 따르며 색상 변경을 감지한다. 최종 자동 검증과 캡처는 docs/research/2026-11-04/accessibility-qa.md를 따른다. 실제 OS 배율 전환과 Narrator 낭독을 자동 DPI 렌더로 대체했다고 주장하지 않는다.