Skip to content

Commit 6caaa94

Browse files
SOIVclaude
andcommitted
docs: UI 문서 정비 및 Phase 3.5 로드맵 추가
- ui/01-core-components → 02-core-components, ui/02-theme-policy → 01-theme-policy 로 번호 재정렬 (컴포넌트 관련 문서 02-03으로 묶음) - 관련 문서 내 cross-reference 전체 업데이트 - 01-core-components 실제 구현 상태 기준으로 전면 재작성 (P0/P0.5 컴포넌트 props 반영, 미구현 항목 분리) - 01-theme-policy 테마 모드 시스템 섹션 추가 (data-theme + data-mode 이중 축, standalone 모드, System 자동 모드) - roadmap: Phase 3.5 텔레메트리 & 통계 수집 시스템 추가 - roadmap: OTP 인라인 단계 전환 UX 방향 메모 추가 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 287e3d3 commit 6caaa94

8 files changed

Lines changed: 682 additions & 189 deletions

File tree

docs/v2_FINANCIAL-LEDGER/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -114,9 +114,9 @@ pnpm start
114114
- [📋 기본 모듈](modules/00-default-modules.md)
115115

116116
### UI/UX
117-
- [🎨 Core Components](ui/01-core-components.md)
117+
- [🎨 Core Components](ui/02-core-components.md)
118118
- [🖼️ 디자인 시스템](ui/00-design-system.md)
119-
- [💅 테마 정책](ui/02-theme-policy.md)
119+
- [💅 테마 정책](ui/01-theme-policy.md)
120120
- [🧩 Control Backlog](ui/03-control-backlog.md)
121121

122122
### 마켓플레이스

docs/v2_FINANCIAL-LEDGER/architecture/00-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -337,7 +337,7 @@ cors 미들웨어를 사용하여 CORS_ORIGIN 환경 변수의 값만 허용된
337337
- **통일된 인터페이스**
338338

339339
#### Common UI Components
340-
> 📖 → `ui/01-core-components.md`
340+
> 📖 → `ui/02-core-components.md`
341341
342342
- Button, Input, Table, Modal 등
343343
- Layout 컴포넌트

docs/v2_FINANCIAL-LEDGER/architecture/05-plugin-system.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -69,5 +69,5 @@ Core 엔진에 기본적으로 포함되어 항상 작동하는 핵심 인프라
6969

7070
## 📚 관련 문서
7171
- 📖 `architecture/02-core-principles.md` - Core / Module / Plugin 분리 철학
72-
- 📖 `ui/02-theme-policy.md` - 공식 테마 운영 정책
72+
- 📖 `ui/01-theme-policy.md` - 공식 테마 운영 정책
7373
- 📖 `roadmap/01-development-plan.md` - 기술 로드맵

docs/v2_FINANCIAL-LEDGER/modules/01-development-guide.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -166,7 +166,7 @@ navigation 객체를 별도로 export합니다. 이 정보는 앱의 네비게
166166
### pages/List.tsx
167167

168168
> 📖 **Core UI 컴포넌트:**
169-
> `ui/01-core-components.md`
169+
> `ui/02-core-components.md`
170170
171171
목록 페이지입니다. useNavigate 훅으로 페이지 이동을 준비하고, useMyModule 훅에서 항목 목록, 로딩 상태, 삭제 함수를 가져옵니다.
172172

@@ -250,7 +250,7 @@ module-registry 저장소에 PR 제출
250250
### ✅ 해야 할 것
251251

252252
> 📖 **Core UI 컴포넌트 사용:**
253-
> `ui/01-core-components.md`
253+
> `ui/02-core-components.md`
254254
255255
- Core UI 컴포넌트 사용
256256
- 타입 정의 명확하게
@@ -288,7 +288,7 @@ module-registry 저장소에 PR 제출
288288
- 모듈 로더 계약 검증은 `apps/api/src/loader/index.test.ts`를 기준으로 확장합니다.
289289

290290
### UI
291-
- 📖 `ui/01-core-components.md` - Core UI 컴포넌트
291+
- 📖 `ui/02-core-components.md` - Core UI 컴포넌트
292292
- 📖 `ui/00-design-system.md` - 디자인 시스템
293293

294294
### 마켓플레이스

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

Lines changed: 61 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -173,7 +173,19 @@ Control 전체 목록과 상태 관리는 별도 문서에서 관리:
173173
**예상 기간: 3일**
174174

175175
- [x] 이메일/비밀번호 로그인 화면 구현 (React shell/mock)
176-
- [ ] 2FA OTP 입력 화면 구현 (활성 계정 대상) / OTP 화면을 별도 페이지로 안띄우고 로그인 화면에서 입력하는 창으로 변화도록 수정(ex. docs\local\otp-ex.png)
176+
- [ ] 2FA OTP 입력 화면 구현 (활성 계정 대상)
177+
178+
> **UX 방향 — 인라인 단계 전환 방식으로 구현할 것**
179+
>
180+
> 현재는 OTP 입력 시 `#otp` 해시 라우트로 별도 페이지 이동하는 방식이나,
181+
> 로그인 카드 내부에서 step 상태로 전환하는 방식으로 수정한다.
182+
>
183+
> - `#otp` 라우트 제거, `LoginView` 내부 step 상태로 대체
184+
> - `step: 'credentials'` → 이메일/비밀번호 입력
185+
> - `step: 'otp'` → OTP 입력 (같은 카드, 내용만 전환)
186+
> - 상단에 "Sign In → 2단계 인증" 진행 단계 표시 포함
187+
>
188+
> 레퍼런스 이미지: `docs/local/otp-ex.png`
177189
- [ ] 로그인 실패/잠금/세션 만료 UX 정의
178190
- [x] 로그인 성공 후 Home 리다이렉트 규칙 확정 (mock)
179191
- [x] 임시 비밀번호 첫 로그인 시 강제 변경 화면 구현 (정책 체크리스트 포함)
@@ -406,6 +418,54 @@ Control 전체 목록과 상태 관리는 별도 문서에서 관리:
406418

407419
---
408420

421+
## Phase 3.5: 텔레메트리 & 통계 수집 시스템
422+
423+
### 목표
424+
앱 사용 데이터와 오류 정보를 수집·분석하여 개발 의사결정과 마켓플레이스 운영에 활용
425+
426+
> Phase 3 마켓플레이스 개발 시점에 함께 설계·구현. 마켓플레이스 서버 인프라(Cloudflare Workers 등)와 공유.
427+
428+
### 수집 범위 원칙
429+
- 사용자 동의 기반 (설치 마법사 단계에 동의 항목 포함)
430+
- 개인정보 미포함 — 익명 설치 UUID 기반
431+
- 개발 개선 및 마켓플레이스 운영 목적에 한정
432+
433+
### 주요 작업
434+
435+
#### 3.5.1 앱 텔레메트리 (Fieldstack 앱 → 수집 서버)
436+
**예상 기간: 1주**
437+
438+
- [ ] 설치 마법사에 텔레메트리 동의 항목 추가 (opt-out 선택 가능)
439+
- [ ] 익명 설치 UUID 생성 및 관리
440+
- [ ] 오류/크래시 로그 수집 (에러 메시지, 스택 트레이스, 발생 컨텍스트)
441+
- [ ] 기능 사용 빈도 수집 (어떤 모듈·기능이 많이 쓰이는지)
442+
- [ ] 앱 버전·환경 정보 수집 (Node.js 버전, OS, DB 타입)
443+
- [ ] 수집 엔드포인트 구현 (`/telemetry/...`)
444+
- [ ] 개인정보 필터링 레이어 (입력값 원문 제거, 경로 마스킹)
445+
446+
#### 3.5.2 마켓플레이스 통계 연계 (Phase 3.4 확장)
447+
**예상 기간: 3일**
448+
449+
- [ ] 모듈 설치·제거·업데이트 이벤트 수집
450+
- [ ] 모듈별 오류 발생률 집계
451+
- [ ] 인기 모듈 랭킹 데이터 연계 (Phase 3.4 다운로드 카운트와 통합)
452+
453+
#### 3.5.3 수집 인프라
454+
**예상 기간: 3일**
455+
456+
- [ ] 마켓플레이스 서버와 동일 인프라 공유 (별도 서버 불필요)
457+
- [ ] 수집 데이터 DB 스키마 설계 (텔레메트리 전용 테이블/스키마 분리)
458+
- [ ] 수집 데이터 보존 정책 정의 (보관 기간, 자동 삭제)
459+
- [ ] 관리자용 텔레메트리 대시보드 (오류 빈도, 버전 분포 등)
460+
461+
### 마일스톤 3.5 완료 기준
462+
- ✅ 동의 기반 텔레메트리 수집 작동
463+
- ✅ 오류 로그 자동 수집 및 서버 전송
464+
- ✅ 마켓플레이스 통계와 단일 인프라에서 운영
465+
- ✅ 개인정보 필터링 검증 완료
466+
467+
---
468+
409469
## Phase 4: 배포 최적화 (1개월)
410470

411471
### 목표

docs/v2_FINANCIAL-LEDGER/ui/01-core-components.md

Lines changed: 0 additions & 177 deletions
This file was deleted.

0 commit comments

Comments
 (0)