feat(core-loop): /app 진입과 /space 복구 흐름 구현

This commit is contained in:
2026-03-14 18:02:50 +09:00
parent bc08a049b6
commit b4ed94cf1b
19 changed files with 2638 additions and 619 deletions

View 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의 주 의사결정으로 느껴지지 않는다