docs: Control 백로그 분리 및 Phase 1.5 게이트 정리

Author: SOIV

docs/v2_FINANCIAL-LEDGER/README.md

@@ -116,6 +116,7 @@ pnpm start
 - [🎨 Core Components](ui/01-core-components.md)
 - [🖼️ 디자인 시스템](ui/00-design-system.md)
 - [💅 테마 정책](ui/02-theme-policy.md)
+- [🧩 Control Backlog](ui/03-control-backlog.md)
 
 ### 마켓플레이스
 - [🏪 마켓플레이스 개요](marketplace/00-overview.md)

docs/v2_FINANCIAL-LEDGER/roadmap/01-development-plan.md

@@ -121,22 +121,36 @@ Fieldstack/
 
 ### 주요 작업
 
-#### 1.5.1 Control UI Components (공통 컴포넌트/레이아웃)
+#### 1.5.1 Control UI Components (버튼/선택/토글 등 기본 Control)
 **예상 기간: 1주**
 
-- [ ] Shell Layout 계약 정의 (Header, Sidebar, Workspace)
-- [ ] Navigation Item 계약 정의 (id, label, path, icon, visibility)
-- [ ] 공통 상태 컴포넌트 정의 (Loading, Empty, Error, Unauthorized)
-- [ ] 공통 액션 패턴 정의 (Primary/Secondary/Danger 버튼 규칙)
-- [ ] 접근성 기준 체크 (키보드 포커스, 명도 대비, aria 기본 규칙)
+> 원칙: "모든 Control 선제 구현"이 아니라, Core 흐름에 필요한 Control MVP를 먼저 고정하고,
+> 추가 Control은 Phase 2 모듈 개발/커뮤니티 요청 기반으로 점진 확장한다.
 
-#### 1.5.2 Main Home
-**예상 기간: 3일**
+Control 전체 목록과 상태 관리는 별도 문서에서 관리:
+- `docs/v2_FINANCIAL-LEDGER/ui/03-control-backlog.md` (P0 -> P0.5 -> P1)
 
-- [ ] Home 화면 정보 구조 확정 (요약 영역, 빠른 액션, 최근 활동)
-- [ ] 모듈 0개 상태 Empty UX 구현 (안내 + 다음 행동 CTA)
-- [ ] 관리자/일반 사용자 홈 표시 정책 분리
-- [ ] 글로벌 네비게이션 진입점 확정 (설정, 모듈 관리, 로그아웃)
+- [ ] Button 규격 확정 (Primary/Secondary/Danger/Ghost, size, loading, disabled)
+- [ ] Toggle/Switch 규격 확정 (on/off 상태, 라벨 결합, 키보드 조작)
+- [ ] ComboBox/Select 규격 확정 (단일/다중 선택, 검색, 빈 상태)
+- [ ] Checkbox/Radio 규격 확정 (단일/그룹 선택, indeterminate 포함)
+- [ ] Input 계열 공통 규칙 확정 (text/number/email/password, validation/error/help text)
+- [ ] Control 접근성 기준 체크 (focus ring, 명도 대비, aria role/label, tab 순서)
+- [ ] Control 우선순위 분류 (P0: Core 필수 / P1: 자주 사용 / P2: 요청 기반)
+- [ ] 신규 Control 추가 정책 확정 (요청 -> RFC/이슈 -> 디자인/접근성 검토 -> 릴리스)
+
+#### 1.5.2 설치 마법사 (초기 설정)
+**예상 기간: 4일**
+
+- [ ] Welcome 화면
+- [ ] Configuration 화면 (관리자 계정, DB, 선택 옵션)
+- [ ] Progress 화면 (단계/로그/오류 상태)
+- [ ] Complete 화면 (로그인 진입)
+- [ ] 첫 실행 감지 시 /install 강제 라우팅 정책 반영
+- [ ] Configuration 단계 유효성 검증 UX 정의 (필수값, 형식 오류, 연결 테스트 결과)
+- [ ] Progress 단계 실패 처리 UX 정의 (재시도/이전 단계 복귀/에러 요약)
+- [ ] 설치 중 브라우저 새로고침/재접속 복구 정책 정의 (진행 상태 재동기화)
+- [ ] Complete 이후 첫 진입 안내 UX 정의 (로그인 후 바로 할 일, 설정 이동)
 
 #### 1.5.3 로그인 (Auth & Access)
 **예상 기간: 3일**
@@ -145,23 +159,32 @@ Fieldstack/
 - [ ] 2FA OTP 입력 화면 구현 (활성 계정 대상)
 - [ ] 로그인 실패/잠금/세션 만료 UX 정의
 - [ ] 로그인 성공 후 Home 리다이렉트 규칙 확정
+- [ ] 비밀번호 복구 UI 구현 (SMTP self-service / 관리자 토큰 복구 안내)
+- [ ] OAuth/Passkey 로그인 진입 UI 정책 정의 (활성화된 경우에만 노출)
+- [ ] 인증 실패 메시지 규칙 통일 (계정 존재 여부 비노출, 재시도 안내)
+
+#### 1.5.4 Main Home
+**예상 기간: 3일**
 
-#### 1.5.4 관리자 대시보드 / 일반 설정
+- [ ] Home 화면 정보 구조 확정 (요약 영역, 빠른 액션, 최근 활동)
+- [ ] 모듈 0개 상태 Empty UX 구현 (안내 + 다음 행동 CTA)
+- [ ] 관리자/일반 사용자 홈 표시 정책 분리
+- [ ] 글로벌 네비게이션 진입점 확정 (설정, 모듈 관리, 로그아웃)
+- [ ] 글로벌 네비게이션 상세 규격 확정 (메뉴 순서, 아이콘, 모바일 Drawer, 키보드 탐색)
+- [ ] Home 공통 상태 정의 (Loading, Empty, Error, Unauthorized)
+- [ ] 첫 로그인 사용자용 온보딩 진입 UX 정의 (튜토리얼/다음 행동 안내)
+
+#### 1.5.5 관리자 대시보드 / 일반 설정
 **예상 기간: 4일**
 
 - [ ] 일반 설정 화면 뼈대 구현 (프로필/언어/테마)
 - [ ] 관리자 전용 영역 라우트 분리
 - [ ] 관리자 PIN Step-up 모달 흐름 구현
 - [ ] Protected Route 정책 구현 (권한 부족 시 리다이렉트)
-
-#### 1.5.5 설치 마법사 (초기 설정)
-**예상 기간: 4일**
-
-- [ ] Welcome 화면
-- [ ] Configuration 화면 (관리자 계정, DB, 선택 옵션)
-- [ ] Progress 화면 (단계/로그/오류 상태)
-- [ ] Complete 화면 (로그인 진입)
-- [ ] 첫 실행 감지 시 /install 강제 라우팅 정책 반영
+- [ ] 관리자 PIN 관리 UI 구현 (최초 설정/변경/오류 처리)
+- [ ] 관리자 세션 만료 UX 구현 (30분 만료 시 재인증 모달)
+- [ ] 일반 설정 저장 UX 보강 (저장 성공/실패, 미저장 변경 경고)
+- [ ] 관리자 활동/감사 로그 화면 진입점 정의 (PIN 실패/주요 설정 변경 확인)
 
 #### 1.5.6 UX 품질 기준
 **예상 기간: 2일**
@@ -170,6 +193,9 @@ Fieldstack/
 - [ ] 에러/빈 상태/권한 거부 상태 일관성 점검
 - [ ] 핵심 플로우 QA 체크리스트 작성
 - [ ] "설치 -> 로그인 -> 홈 -> 설정" E2E 시나리오 정의
+- [ ] 접근성 QA 체크리스트 작성 (focus order, aria label/role, 대비, 키보드 전용 조작)
+- [ ] 텍스트/피드백 톤 가이드 통일 (성공/실패/경고 문구 일관성)
+- [ ] E2E 확장 시나리오 정의 (설치 실패 복구, 비밀번호 복구, 관리자 PIN 만료 재인증)
 
 ### 마일스톤 1.5 완료 기준
 - ✅ 모듈 없이도 Core UI Shell이 정상 동작
@@ -178,13 +204,23 @@ Fieldstack/
 - ✅ 일반 설정 진입 및 저장 플로우 검증 완료
 - ✅ Phase 2 모듈 UI를 붙일 수 있는 라우팅/레이아웃 기반 확보
 
+### Phase 2 진입 게이트 (권장)
+- [ ] Control 패키지 MVP 완료 (Button/Input/Select/Toggle/Checkbox/Radio/Modal/Form)
+- [ ] Auth/Install/Home/Settings/Admin 흐름에서 공통 Control 재사용 검증
+- [ ] 접근성/반응형/상태 처리(Loading/Empty/Error/Unauthorized) 기준 통과
+- [ ] 핵심 E2E 통과 (설치 -> 로그인 -> 홈 -> 설정/관리자)
+- [ ] UI 계약 동결 (Phase 2에서는 신규 Control 추가보다 모듈 기능 구현 우선)
+- [ ] 신규 Control은 예외적으로 수요 기반 추가 (모듈 요구사항/커뮤니티 제안 시 배치 처리)
+
 ---
 
 ## Phase 2: 기본 모듈 개발 (2개월)
 
 ### 목표
 핵심 기능 모듈 2개 완성 (가계부, 구독 관리)
 
+> 선행 조건(권장): Phase 1.5의 Control/UI/UX 진입 게이트를 통과한 뒤 착수
+
 ### 주요 작업
 
 #### 2.1 Ledger Module (가계부)

docs/v2_FINANCIAL-LEDGER/ui/03-control-backlog.md

@@ -0,0 +1,90 @@
+# Control Backlog (P0 -> P0.5 -> P1)
+
+## 목적
+
+Phase 1.5에서 Core Control을 우선순위 기반으로 구현하고,
+Phase 2 이후 모듈/커뮤니티 요청에 따라 점진 확장하기 위한 관리 문서입니다.
+
+## 운영 원칙
+
+- P0는 Phase 1.5에서 우선 완료한다.
+- P0.5는 핵심 흐름에서 반복 사용되는 항목을 우선 반영한다.
+- P1은 전부 선행 구현하지 않고, 실제 요구가 발생한 항목부터 배치 처리한다.
+- 커뮤니티 제안 Control도 동일 백로그에 추가하고 상태를 갱신한다.
+
+## 상태 기준
+
+- `미착수` - 구현 시작 전
+- `진행중` - 작업 중
+- `완료` - Control 패키지 반영 완료
+
+## P0 (Core 필수)
+
+| Control | 우선순위 | 1.5 구현상태 | 비고 |
+| --- | --- | --- | --- |
+| Button | P0 | 미착수 | Primary/Secondary/Danger/Ghost |
+| Input | P0 | 미착수 | text/email/number/password |
+| Select / ComboBox | P0 | 미착수 | single/multi + search |
+| Checkbox | P0 | 미착수 | 단일/그룹 + indeterminate |
+| Radio | P0 | 미착수 | 단일 선택 그룹 |
+| Switch / Toggle | P0 | 미착수 | on/off + keyboard |
+| Modal / Dialog | P0 | 미착수 | confirm/alert/prompt 패턴 |
+| Form Field Wrapper | P0 | 미착수 | label/help/error/required |
+| Alert / Inline Message | P0 | 미착수 | success/warning/error/info |
+| Progress | P0 | 미착수 | linear + step progress |
+
+## P0.5 (핵심 흐름 반복 사용)
+
+| Control | 우선순위 | 1.5 구현상태 | 비고 |
+| --- | --- | --- | --- |
+| Textarea | P0.5 | 미착수 | multi-line input |
+| Password Input | P0.5 | 미착수 | show/hide + strength hint |
+| OTP / PIN Input | P0.5 | 미착수 | 4~6자리 step-up 인증 |
+| Search Input | P0.5 | 미착수 | debounce/clear |
+| Spinner / Loader | P0.5 | 미착수 | blocking/non-blocking 로딩 |
+| Toast / Notification | P0.5 | 미착수 | 전역 피드백 메시지 |
+| Empty State Block | P0.5 | 미착수 | CTA 포함 빈 상태 |
+| Skeleton Loader | P0.5 | 미착수 | list/card/form skeleton |
+
+## P1 (자주 쓰이지만 일부 우선 구현)
+
+| Control | 우선순위 | 1.5 구현상태 | 비고 |
+| --- | --- | --- | --- |
+| Tabs | P1 | 미착수 | settings/module 화면 분리 |
+| Dropdown Menu | P1 | 미착수 | header/user/action menu |
+| Tooltip | P1 | 미착수 | helper/explain UX |
+| Badge / Tag | P1 | 미착수 | 상태 표기 (active/error 등) |
+| Pagination | P1 | 미착수 | table/list 페이지 분할 |
+| Date Picker | P1 | 미착수 | 단일/범위 선택 |
+| File Uploader | P1 | 미착수 | drag&drop + progress |
+| Drawer / Sheet | P1 | 미착수 | 모바일/보조 패널 |
+
+## P2 (요청 기반 확장)
+
+| Control | 우선순위 | 1.5 구현상태 | 비고 |
+| --- | --- | --- | --- |
+| Multi Select (Advanced) | P2 | 미착수 | group/search/chip + keyboard |
+| Command Palette | P2 | 미착수 | 빠른 액션/검색 단축키 |
+| Rich Text Editor | P2 | 미착수 | markdown/toolbar/attachment |
+| Data Grid (Advanced Table) | P2 | 미착수 | column resize/pin/virtual scroll |
+| Tree View | P2 | 미착수 | 계층형 데이터 탐색 |
+| Accordion | P2 | 미착수 | 섹션 접기/펼치기 |
+| Stepper | P2 | 미착수 | 다단계 프로세스 탐색 |
+| Timeline | P2 | 미착수 | 활동 이력 시각화 |
+| Calendar View | P2 | 미착수 | month/week/day 캘린더 |
+| Date Range Picker (Advanced) | P2 | 미착수 | preset/quick range/timezone |
+| Time Picker | P2 | 미착수 | 12h/24h + seconds |
+| Color Picker | P2 | 미착수 | HEX/RGB + palette |
+| Slider / Range Slider | P2 | 미착수 | 단일/범위 값 조절 |
+| Segmented Control | P2 | 미착수 | 소형 탭 대체 선택 UI |
+| Combobox Creatable | P2 | 미착수 | 옵션 생성 허용 |
+| Mentions / Autocomplete | P2 | 미착수 | @mention/#tag 입력 보조 |
+| Kanban Board | P2 | 미착수 | drag&drop 상태 보드 |
+| Split Pane / Resizable Panel | P2 | 미착수 | 가변 레이아웃 편집 |
+| Code Editor | P2 | 미착수 | JSON/YAML 설정 편집 |
+| JSON Viewer / Diff Viewer | P2 | 미착수 | 설정 비교/검토 |
+| Tour / Coachmark | P2 | 미착수 | 온보딩 단계 안내 |
+| Hotkey Helper | P2 | 미착수 | 단축키 목록/가이드 |
+| Activity Feed | P2 | 미착수 | 이벤트 스트림 컴포넌트 |
+| Permission Matrix | P2 | 미착수 | 역할/권한 테이블 편집 |
+| Bulk Action Bar | P2 | 미착수 | 다중 선택 일괄 처리 |