# Fricle 단계별 진화 + Alpha 기준선

> 이 문서는 **Phase 1~4 진화 모델**과 **알파 런칭 시점의 제품 모습**을 정의한다.
> Phase 1은 단순히 "1단계"가 아니라 **실제 알파 런칭 기준선**.
>
> ⚠️ **주의**: 본 문서의 Phase 1~4 = **제품 출시 / 진화 단계**.
> [`../uxui/ROADMAP.md`](../uxui/ROADMAP.md) 의 P1~P3 = **UX 시나리오 우선순위** = 본 문서 Phase 와 1:1 대응 X.
> 예 = Stage / Pinboard = UX 우선순위 P2 / Alpha 제품 기준선 (= Phase 1) 에는 포함될 수 있음.
>
> ⚠️ **플랜명/구독 구조 관련은 V2 제안 기반**. 4플랜·Seat·애드온 구조는 [05-STORAGE_BILLING.md](./05-STORAGE_BILLING.md) 논의 중. 비즈니스 논의 후 Phase 1의 05 항목은 재조정될 수 있음.

---

## 전체 Phase 진화

```
Phase 1 — Alpha: 제품 전체 기본 동작        (알파 런칭 시점)
    ↓
Phase 2 — 협업/운영 고도화                  (presence, 설정 재설계 등)
    ↓
Phase 3 — App Platform 성숙                 (써드파티 개발자, 고급 entitlement)
    ↓
Phase 4 — Marketplace + Advanced Billing    (수익 구조 고도화)
```

**Phase 1 스코프**: "핵심 기능만 있는 MVP"가 아니라 **제품 전체 기본 동작이 돌아가는 상태**로 알파 런칭. Pinboard / Stage / 태그·멘션 / 반응 / 커스텀 앱 제작 / 마켓 기본까지 포함.

---

## Phase 1 — Alpha 기준선

**목표**: "제품 전체 모습을 보여주는" 돈 받는 알파 런칭

### MVP 기준 5개

| # | 기준 | 이유 |
|---|------|------|
| 1 | **코어 가치 전달** — 첫 사용에서 "아 이게 Fricle이구나" 체감 | 재방문 이유 |
| 2 | **크리티컬 크래시/블로커 없음** | 돈 받는 순간 용서 범위 좁아짐 |
| 3 | **BM 사이클 작동** — 결제 → 사용 → 만료 → 갱신 | BM 붙인 알파의 최소 요건 |
| 4 | **첫 1시간 온보딩 성공** — 가입 → 첫 앱 → 가치 체감 | 첫 인상이 전부 |
| 5 | **협업 작동** — 2명 이상 동시 편집 + 태그/멘션 + 반응 | Fricle 핵심 가치 |

### Phase 1 필수 플로우

```
가입
→ 개인 워크스페이스 자동 생성
→ 온보딩 (첫 앱 유도)
→ 캔버스 배치 / 상태 저장·복원
→ 재방문 / 작업 재개
→ 파일 업로드 + Export (Personal Drive)
→ 공유 / 초대 → 협업 (동시 편집 + 태그/멘션 + 반응)
→ Pinboard / Stage 활용
→ 커스텀 앱 제작 (AppStudio/Sandbox + AI 프롬프트)
→ 마켓 (게시/설치 기본)
→ BM 결제 / 만료 / 재구독
```

### Phase 1 포함 범위 (파이프라인별)

#### 01-USER_FLOW
- 가입 / 개인 워크스페이스 자동 생성
- 온보딩 가이드 (첫 앱 유도)
- 첫 작업 → 저장/복원 체감
- 재방문 시 상태 복원
- 초대받은 멤버 첫 진입 UX
- BM 루프 노출 지점 (한도 도달 / 업그레이드 / 결제 후 / 만료)

#### 02-APP_RUNTIME
- 독 OS 방식 (클릭 = 기존 포커스, 없으면 생성)
- 오버레이 + 방향 애니메이션
- 닫기/삭제 정식 동작 (캔버스 제거 + 리스트 유지)
- 독 드래그 앤 드롭 (1단계 인스턴스 생성)
- 런타임 중 권한/라이선스 재판정

#### 03-LIVEDOC_SYNC
- LiveDoc + Yjs CRDT
- 영속성 (DB 저장/복원)
- 2인 동시 편집 안정
- 재연결 동기화 UI 피드백
- 태그/멘션 데이터 모델
- 반응(이모지) 데이터 모델

#### 04-PERMISSION_LICENSE
- 팀 초대 수락/거절 플로우
- 권한 4단계 동작 (Owner/Admin/Editor/Viewer)
- 빌트인 무료 앱 Operate 자동 통과
- 판정 3층 (역할 / Operate 자격 / Operator 지정)
- 유료 앱 = 개인 라이선스 (= 본인 구매 / 다른 사람으로부터 할당 받음) 판정 = LICENSE-MODEL 정합
- 감사 로그 기록 (최소 필드)
- 고위험 Operate Allowlist 기본 UI

#### 05-STORAGE_BILLING
> ⚠️ V2 제안 기반. 비즈니스 논의 후 플랜 구조/한도 값 확정 필요.

- Stripe 계열 결제 / 법인 인프라 검토 (= Atlas / Billing / Checkout / Payments 조합 미확정. 구독 / 마켓플레이스 앱 라이선스 / AI 크레딧 / 환불·갱신 구조는 [05-STORAGE_BILLING.md](./05-STORAGE_BILLING.md) 확정 후 반영)
- 기본 플랜 한도 (멤버/동시 편집/AppData — 수치 논의 후)
- 상위 플랜 구조 (업셀 경로 — 플랜명/가격 논의 후)
- Personal Drive 유저별 자동 제공 (기본 용량 논의 후)
- 파일 업로드 → AppData 차감 + 한도 경고
- Export 경로 Official/Unofficial 기본 처리
- 저장소 3종 분리 (Personal / AppData / External)

#### 기능 영역 (uxui와 공동)

- Pinboard — 앱 내부 사이드 패널 + 크기 적응형 (LiveDoc 모드 기억)
- Stage 모드 — Mac 스타일 독립 모드. Alt+S / ObjectToolbar 진입. Mac 카드 그룹(Deck) + 9종 프리셋 + 자유 배치. 자세한 룰: [04-mode/045-stage-mode-redesign/](../uxui/04-mode/045-stage-mode-redesign/)
- 태그/멘션 — 텍스트 내 @유저/@오브젝트 (Google Docs 방식)
- 반응 — 이모지
- 채팅 — 워크스페이스 실시간 채팅 (트레이 앱)
- 앱 관리자 — 트레이 기본 앱
- 알림 — 트레이 기본 앱 + 뱃지
- AppStudio / Sandbox — 커스텀 앱 제작 환경
- AI 프롬프트 앱 생성
- 마켓플레이스 게시와 설치 기본 (Marketplace 기반)

### Phase 1에 빠지는 것

운영 고도화 / 써드파티 에코 시스템 확장:

- 써드파티 개발자 퍼블리싱 프로세스 전체 (검수/결제 정산 자동화) — Phase 3~4
- Enterprise 플랜 정식 운영 — Phase 4
- 앱 버전 고정(pinning) — Phase 3
- External Drive 세부 연동 (Google Drive 직접 업로드 등) — Phase 3
- 고급 감사 로그 UI / 조직 정책 패널 — Phase 3
- Usage 기반 상세 과금 (AI credits) — Phase 4

---

## Phase 2 — 협업/운영 고도화

**목표**: 알파 피드백 기반으로 협업/운영 층 깊이 확보

### 범위

- 실시간 presence 정밀화 (커서 공유 고도화, 접속자 표시 세부)
- 협업 히스토리/리플레이 세부
- Pinboard/Stage 고급 기능 (커스텀 레이아웃 등)
- 앱 관리자 고급 UI (필터/검색/복원 세밀화)
- Basic → Pro 업셀 플로우 완성
- 설정 재설계 (사이드바 카테고리 + 옵션 최적화 — [uxui/09-SETTINGS](../uxui/09-settings/00-SETTINGS.md))

---

## Phase 3 — App Platform 성숙

**목표**: 써드파티 개발자 에코 시스템 본격화

### 범위

- 써드파티 앱 등록/검수 정식 플로우
- Entitlement 판정 세분화 (AI 호출 한도 등)
- Runtime sandbox 고도화
- External Drive 연동 (Google Drive 직접 연동 등)
- 고위험 Operate 정책 패널
- 감사 로그 UI (오너/Admin 뷰어)
- 앱 버전 고정

---

## Phase 4 — Marketplace + Advanced Billing

**목표**: 수익 구조 고도화

### 범위

- 마켓 수익 분배 정산 자동화 (Adobe 모델)
- 써드파티 개발자 대시보드
- Usage 기반 과금 (AI credits 등)
- Enterprise 플랜 정식 운영 + 조직 승계/회수
- Export Official/Unofficial 전면 운영 + 승인형 기능

---

## BM 연결 지점 (Phase별)

| Phase | BM 동작 |
|-------|---------|
| 1 (알파) | Free / 상위 플랜 결제 작동. 빌트인 앱 = 무료. 마켓 기본 설치/게시. 태그/멘션 포함 협업 전체 |
| 2 | 고도화 — 상위 플랜 업셀 플로우 완성, 설정 재설계 |
| 3 | 써드파티 앱 개인 구독 + AI 호출 계측 과금 |
| 4 | Adobe 모델 수익 분배 자동 정산 + Enterprise 정책 과금 |

---

## 관련 문서

- 전체 인덱스: [README.md](./README.md)
- 결정 현황: [DECISIONS.md](./DECISIONS.md)
- 각 파이프라인 내 Phase 1 항목은 해당 파이프라인 문서 본문에 명시됨