---
title: 핸드오프 — UI 재설계용 화면 설명서 (Cai 전달·후속)
category: handoff
document_type: 핸드오프
source_status: published
knowledge_group: 03_history
priority: Normal
purpose: Cai 목업 릴레이 인계 — 영역 순서·회귀방지·셸 제약
read_when: UI 재설계 후속 작업(목업 릴레이·명세화) 재개 시
updated: 2026-06-13
work_timestamp: 20260613_141242
source_of_truth: dallog-tools
---

# 핸드오프 — UI 재설계용 화면 설명서

> 본문 맥락은 같은 timestamp 작업보고 참조. 본 문서는 **다음 세션이 바로 이어받을 것**만.

## 완료
- 달록 전체 화면 설명서 작성·검수 완료: `dallog_git/docs/go_work/260613/dallog_ui_screen_spec_260613.md` (약 77KB, 10영역 + 부록).
- 실제 라우트(src/App.tsx) 전수 확인 기반. 실물 카피·상태·행동·제약 코드 인용. Codex 4라운드 검수 정상 종료(3·4차 신규 기능성 지적 0건).
- 코드·DB 무변경(문서 산출물만). 브랜치 `feat/brief-viewer-260612`.

## 다음 작업 (이어받을 흐름)
1. **Cai에 전달** — 화면 설명서 + `src/index.css`를 함께 Cai(Claude.ai)에 전달.
2. **영역 단위 목업 릴레이** — 한 스레드에 다 못 담으므로 영역별 스레드 분할. 권장 순서(설명서 부록2): 인증 → 공통 셸·상태 → 홈/브리프 → 기록입력 → 히스토리/엑셀 → 설정 → 요금제/코치챗 → 소셜 → 마스터/지원 → 리포트연결(진입점만).
3. **컨펌 → 명세화** — 각 영역 목업 사장님 컨펌 → 컨펌안을 UI 개선 명세서로 발행 → CC 적용.

## 회귀·설계 의도 (재설계 시 깨지면 안 되는 것)
- **셸 제약**: 반응형 분기 769px, 사이드바 272px(접힘 64px)·헤더 52px·탭바 60px = index.css 토큰. 프로필=계정행 진입점 통합(설정은 프로필 하위). 마스터 메뉴(스튜디오·애널리틱스)는 데스크탑 셸 전용.
- **근력 리포트 계열**(/strength-report·/onboarding/profile)은 **별도 명세 확정** — 화면 설명서는 진입점만 다룸. 재설계 시 내부 재정의 금지.
- **과금 노출 규칙**: 사용자에겐 정수 "회"만(토큰·원가·소수 비노출, 원가는 운영자 전용). 가격·차감은 DB RPC 단일 출처. 도구(실행) 턴 무차감.
- **소셜 데이터**: posts/comments/notifications는 profiles FK 임베드 금지(fetchProfilesByIds 별도 병합).
- **OAuth 3종 전용**(자체 가입/찾기 없음), 본인인증 미도입, RLS=본인 데이터만.

## 참고 (구조적 문제의식 — 설명서 0-7)
재설계로 해소 고려 가능(지시 아닌 관찰): 토스트/전용 빈·에러·권한거부 컴포넌트 부재, 빈상태=에러 오표시, 공개범위 카피 4종 비일관, 문의 상태라벨 사용자("접수")↔운영자("신규") 불일치, 기록입력 깊이 편차(근력 3중 중첩), 설정 8섹션 진입 깊이, 엑셀 진입점 발견성.