Skip to content

Commit a1cfe56

Browse files
committed
docs: detail Phase 1.5 core control plane UI roadmap
Clarify a module-excluded UI/UX scope before Phase 2 so install, auth, home, and settings flows can be planned and validated independently.
1 parent 5b7ff08 commit a1cfe56

1 file changed

Lines changed: 74 additions & 0 deletions

File tree

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

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -106,6 +106,80 @@ Fieldstack/
106106

107107
---
108108

109+
## Phase 1.5: UI/UX (Core Control Plane)
110+
111+
### 목표
112+
모듈 화면 개발(Phase 2) 전에, Core 기반 컨트롤 UI/UX를 먼저 완성하여
113+
"설치 -> 로그인 -> 홈 -> 설정" 기본 흐름을 단독으로 동작 가능하게 만든다.
114+
115+
이 Phase는 작업 순서에 영향을 주지 않지만 Phase 2 작업 이전에 작업을 해두는 것을 권장
116+
117+
### 범위 명시
118+
- [ ] Phase 1.5는 Core Control Plane에 한정
119+
- [ ] Ledger/Subscription 등 모듈 화면 구현은 제외 (Phase 2에서 진행)
120+
- [ ] 모듈이 0개여도 앱이 제품처럼 동작하는 기본 UX 확보
121+
122+
### 주요 작업
123+
124+
#### 1.5.1 Control UI Components (공통 컴포넌트/레이아웃)
125+
**예상 기간: 1주**
126+
127+
- [ ] Shell Layout 계약 정의 (Header, Sidebar, Workspace)
128+
- [ ] Navigation Item 계약 정의 (id, label, path, icon, visibility)
129+
- [ ] 공통 상태 컴포넌트 정의 (Loading, Empty, Error, Unauthorized)
130+
- [ ] 공통 액션 패턴 정의 (Primary/Secondary/Danger 버튼 규칙)
131+
- [ ] 접근성 기준 체크 (키보드 포커스, 명도 대비, aria 기본 규칙)
132+
133+
#### 1.5.2 Main Home
134+
**예상 기간: 3일**
135+
136+
- [ ] Home 화면 정보 구조 확정 (요약 영역, 빠른 액션, 최근 활동)
137+
- [ ] 모듈 0개 상태 Empty UX 구현 (안내 + 다음 행동 CTA)
138+
- [ ] 관리자/일반 사용자 홈 표시 정책 분리
139+
- [ ] 글로벌 네비게이션 진입점 확정 (설정, 모듈 관리, 로그아웃)
140+
141+
#### 1.5.3 로그인 (Auth & Access)
142+
**예상 기간: 3일**
143+
144+
- [ ] 이메일/비밀번호 로그인 화면 구현
145+
- [ ] 2FA OTP 입력 화면 구현 (활성 계정 대상)
146+
- [ ] 로그인 실패/잠금/세션 만료 UX 정의
147+
- [ ] 로그인 성공 후 Home 리다이렉트 규칙 확정
148+
149+
#### 1.5.4 관리자 대시보드 / 일반 설정
150+
**예상 기간: 4일**
151+
152+
- [ ] 일반 설정 화면 뼈대 구현 (프로필/언어/테마)
153+
- [ ] 관리자 전용 영역 라우트 분리
154+
- [ ] 관리자 PIN Step-up 모달 흐름 구현
155+
- [ ] Protected Route 정책 구현 (권한 부족 시 리다이렉트)
156+
157+
#### 1.5.5 설치 마법사 (초기 설정)
158+
**예상 기간: 4일**
159+
160+
- [ ] Welcome 화면
161+
- [ ] Configuration 화면 (관리자 계정, DB, 선택 옵션)
162+
- [ ] Progress 화면 (단계/로그/오류 상태)
163+
- [ ] Complete 화면 (로그인 진입)
164+
- [ ] 첫 실행 감지 시 /install 강제 라우팅 정책 반영
165+
166+
#### 1.5.6 UX 품질 기준
167+
**예상 기간: 2일**
168+
169+
- [ ] 데스크톱/모바일 반응형 기준 확인
170+
- [ ] 에러/빈 상태/권한 거부 상태 일관성 점검
171+
- [ ] 핵심 플로우 QA 체크리스트 작성
172+
- [ ] "설치 -> 로그인 -> 홈 -> 설정" E2E 시나리오 정의
173+
174+
### 마일스톤 1.5 완료 기준
175+
- ✅ 모듈 없이도 Core UI Shell이 정상 동작
176+
- ✅ 로그인/권한/관리자 PIN 흐름이 일관되게 작동
177+
- ✅ 설치 마법사 4단계(Welcome/Config/Progress/Complete) 동작
178+
- ✅ 일반 설정 진입 및 저장 플로우 검증 완료
179+
- ✅ Phase 2 모듈 UI를 붙일 수 있는 라우팅/레이아웃 기반 확보
180+
181+
---
182+
109183
## Phase 2: 기본 모듈 개발 (2개월)
110184

111185
### 목표

0 commit comments

Comments
 (0)