feat(core-loop): /app 진입과 /space 복구 흐름 구현
This commit is contained in:
132
docs/09_app_entry_detailed_spec.md
Normal file
132
docs/09_app_entry_detailed_spec.md
Normal file
@@ -0,0 +1,132 @@
|
||||
# 09. `/app` Entry Detailed Spec
|
||||
|
||||
Last Updated: 2026-03-14
|
||||
|
||||
이 문서는 `/app`을 **single-goal commitment gate**로 구현할 때의 상세 기준 문서다.
|
||||
|
||||
관련 상위 기준:
|
||||
|
||||
- `../../product_principles.md`
|
||||
- `../../current_context.md`
|
||||
- `08_app_reframe_strategy.md`
|
||||
|
||||
---
|
||||
|
||||
## 1. 한 줄 정의
|
||||
|
||||
`/app`은 planner나 setup wizard가 아니라,
|
||||
**사용자가 지금 할 일 한 가지를 정하고 가장 낮은 마찰로 `/space`에 들어가게 만드는 입구**다.
|
||||
|
||||
---
|
||||
|
||||
## 2. 화면 역할
|
||||
|
||||
### `/app`이 해야 하는 일
|
||||
|
||||
- 현재 세션이 있으면 `이어가기`를 제안한다
|
||||
- 현재 세션이 없으면 `goal 1개 + optional microStep 1개`만 받는다
|
||||
- 주 행동은 항상 `지금 시작` 하나다
|
||||
- 시작 전에 많은 설정을 요구하지 않는다
|
||||
|
||||
### `/app`이 하면 안 되는 일
|
||||
|
||||
- 여러 목표를 관리하게 하기
|
||||
- planner / to-do / list app처럼 보이게 하기
|
||||
- scene / sound / timer 선택을 메인 결정으로 끌어올리기
|
||||
- 진입 전에 `정리`, `관리`, `저장`을 강요하기
|
||||
|
||||
---
|
||||
|
||||
## 3. 정보 구조
|
||||
|
||||
### 상태 A. Current Session Exists
|
||||
|
||||
- eyebrow: `Resume`
|
||||
- 현재 goal
|
||||
- optional microStep
|
||||
- primary CTA: `이어서 들어가기`
|
||||
- 보조 정보: 현재 ritual 요약
|
||||
- 설명:
|
||||
- 새 목표는 현재 세션을 마무리한 뒤 시작할 수 있다고만 안내
|
||||
|
||||
### 상태 B. No Current Session
|
||||
|
||||
- 제목
|
||||
- 설명
|
||||
- goal input 1개
|
||||
- optional microStep input 1개
|
||||
- suggestion chips 3~4개
|
||||
- primary CTA: `지금 시작`
|
||||
- 하단 보조 정보:
|
||||
- `기본 ritual · scene · timer · sound`
|
||||
- `공간과 사운드는 들어간 뒤에도 바꿀 수 있어요.`
|
||||
|
||||
---
|
||||
|
||||
## 4. 상호작용 원칙
|
||||
|
||||
### Goal
|
||||
|
||||
- 필수
|
||||
- 한 줄 입력
|
||||
- enter로 바로 시작 가능
|
||||
|
||||
### MicroStep
|
||||
|
||||
- 선택
|
||||
- checklist가 아니라 `지금 할 한 조각`
|
||||
- 1개만 허용
|
||||
|
||||
### Suggestions
|
||||
|
||||
- 계획 리스트가 아니라 start friction reducer 역할
|
||||
- 클릭 시 goal input을 빠르게 채움
|
||||
|
||||
### Start
|
||||
|
||||
- 현재 세션이 없을 때만 가능
|
||||
- `goal + microStep + default ritual`로 세션 시작
|
||||
- 성공 시 `/space` 이동
|
||||
|
||||
### Resume
|
||||
|
||||
- 현재 세션이 있으면 start UI 대신 resume UI를 우선 노출
|
||||
- 클릭 시 `/space`로 이동
|
||||
|
||||
---
|
||||
|
||||
## 5. UX 원칙
|
||||
|
||||
- `/app`은 start surface여야지 setup surface가 아니어야 한다
|
||||
- 한 화면 안에서 결정할 것은 최대 2개(goal, optional microStep)
|
||||
- visual hierarchy는 `goal > CTA > microStep > suggestions > ritual helper` 순서
|
||||
- paywall은 메인 CTA가 아니라 Plan Pill에서만 여는 수준으로 제한
|
||||
|
||||
---
|
||||
|
||||
## 6. 구현 범위
|
||||
|
||||
### 이번 slice에 포함
|
||||
|
||||
- 2-step ritual flow 제거
|
||||
- manage/list UI를 메인 경로에서 제거
|
||||
- current session resume path 추가
|
||||
- single-goal + optional microStep direct start
|
||||
- default ritual만 사용
|
||||
|
||||
### 이번 slice에 포함하지 않음
|
||||
|
||||
- multi-goal manage 복구
|
||||
- entry 단계 scene/sound/timer 직접 선택
|
||||
- planner/dashboard 요소 복구
|
||||
- goal 저장과 session start의 backend atomic endpoint 신규 도입
|
||||
|
||||
---
|
||||
|
||||
## 7. 검증 기준
|
||||
|
||||
- 사용자가 10초 안에 goal을 입력하고 `/space`로 들어갈 수 있다
|
||||
- `/app` 첫 인상이 planner나 setup wizard처럼 보이지 않는다
|
||||
- current session이 있으면 `resume`이 주 행동으로 읽힌다
|
||||
- 현재 세션이 없을 때는 `지금 시작`이 유일한 dominant CTA다
|
||||
- scene / sound / timer는 entry의 주 의사결정으로 느껴지지 않는다
|
||||
Reference in New Issue
Block a user