docs(product): stale app flow 문서 정리

This commit is contained in:
2026-03-16 11:18:39 +09:00
parent 56385ec2eb
commit 3471c96972
13 changed files with 71 additions and 206 deletions

View File

@@ -9,14 +9,9 @@ Last Updated: 2026-03-15
- takeover confirm sheet에서만 current paused session을 정리하고 single-goal start 상태로 넘어간다
- silent abandon을 막기 위해 server `startSession()`도 current session 존재 시 direct start를 거절하도록 정리했다
- explicit confirm 이후에만 `abandon -> 새 목표 입력` 흐름이 가능하다
- `/app` single-goal commitment gate 재구성:
- 2-step `goal -> ritual` flow 제거
- current session이 있으면 `Resume` UI를 우선 노출하고, `/space`로 바로 이어가기만 제안하되 review entry는 조용한 secondary link로 유지
- current session이 없으면 `goal 1개 + optional microStep 1개 + primary CTA`만 남긴 direct start 구조로 단순화
- `환경 세팅`, `블록 정리`, scene/sound/timer 선택을 메인 진입 경로에서 제거
- suggestion chip은 planner가 아니라 입력 마찰을 줄이는 용도로만 유지
- 시작 시에는 기본 ritual(`forest · 50/10 · forest-birds`)로 세션을 열고, 세부 조정은 `/space`에서 하도록 역할을 분리
- `/app`이 planner home이 아니라 commitment gate라는 역할을 문서와 구현 모두에서 다시 고정
- `/app` 기존 single-goal commitment gate는 legacy로 내려갔다:
- 2-step `goal -> ritual` flow 제거하고, current session이 있으면 `Resume` UI를 우선 노출하도록 정리했다
- 현재 source-of-truth는 `goal + duration + atmosphere` 중심의 새 entry shell spec이다
- `/space` Refocus System slice 1 구현:
- HUD recovery layer를 `paused / refocus / next-beat / complete` 단일 overlay 상태로 정리
- pause 직후 바로 편집 시트를 열지 않고, 작은 recovery prompt를 먼저 노출
@@ -100,11 +95,10 @@ Last Updated: 2026-03-15
- Calm Session OS 유료화 축 구현:
- Free는 기본 시작, Pro는 더 잘 이어가기를 파는 구조로 재정의
- old `Scene Packs / Sound Packs / Profiles` 중심 copy를 `Daily Focus Plan / Rituals / Weekly Review` 중심으로 교체
- `/app` route를 Session OS focus entry surface로 복구:
- `/app` route를 focus entry surface로 복구:
- `/app` route가 `/space` redirect 대신 `FocusDashboardWidget`을 렌더링
- current/next summary card와 list-first 구조를 제거하고, entry hero가 above-the-fold를 차지한
- 현재는 current session이 있으면 resume, 없으면 `goal + microStep + start`만 제안하는 single-goal entry로 정리됐
- scene/sound/timer는 기본 ritual로 시작하고, 세부 조정은 `/space`에서 담당한다
- current/next summary card와 list-first 구조를 제거
- 현재는 `Resume` gate가 구현되어 있고, no-session entry shell은 다음 slice에서 `goal + duration + atmosphere` 구조로 교체될 예정이
- 플랜 tier 공유 store 추가:
- `entities/plan/model/usePlanTier.ts` 추가
- localStorage 기반 Free/Pro 상태를 `/app`, `/space`, `/stats`, dock paywall에서 공통 사용
@@ -124,12 +118,12 @@ Last Updated: 2026-03-15
- 기존 `focus-summary` 응답을 주간 review view model로 변환해서 사용
- recovery는 서버의 `pause 뒤 복귀` 집계를 사용하고, `자리 비움 뒤 복귀`만 limited note로 남긴다
- `/app -> /stats` primary entry의 1차 연결:
- current session이 없고 최근 7일 데이터가 충분할 때 `/app` hero 아래에 low-emphasis `Weekly Review` teaser를 노출한다
- teaser는 `/stats`로 연결되며, hero CTA보다 한 단계 아래 시각 우선순위를 유지한
- current session이 없고 최근 7일 데이터가 충분할 때 `/app`의 quiet secondary review dock에서 `Weekly Review` entry를 노출한다
- resume 상태에서는 paused gate 안의 조용한 secondary entry로 review를 연
- `/stats -> /app` handoff의 2차 연결:
- `/stats` 마지막 CTA는 `/app?review=weekly&carryHint=...&entryPreset=forest-50-10`으로 연결된다
- `/app`은 이 query를 받아 hero review-aware return hint를 노출한다
- goal과 microStep은 자동 입력하지 않고, 방향만 가볍게 제안한다
- `/app`은 이 query를 받아 entry stage review-aware return hint를 노출한다
- goal과 duration은 자동 입력하지 않고, 방향만 가볍게 제안한다
- Pro personalized handoff 3차 연결:
- Pro에서는 `/stats` carry-forward 섹션에 추천 ritual을 함께 보여준다
- `/stats` 마지막 CTA 카피가 generic start가 아니라 `가장 잘 맞은 ritual로 /app 돌아가기`로 바뀐다
@@ -314,9 +308,9 @@ Last Updated: 2026-03-15
## NEXT
1. `/app` single-goal commitment gate 브라우저 스모크
2. `/space` intent HUD / refocus / goal-complete hierarchy QA
3. `/stats` factual summary / trend / refresh 브라우저 QA
1. `/app` atmosphere entry shell 구현
2. custom duration contract 정리
3. weekly review dock 위치 재설계
## RISKS