🧊 Cold Plunge Calculator — 기능 명세서

Product: coldplungecalculator.com
버전: 1.0

1. 기능 목록

기능	우선순위	설명
Protocol Calculator	MVP 필수	목적별 온도/시간 추천
Smart Timer	MVP 필수	카운트다운 + 알림
Weekly Goal Tracker	MVP 필수	주 11분 목표 추적
Session Logger	MVP 필수	세션 기록 + 통계
Breathing Guide	MVP 필수	Box Breathing 가이드
Safety Tips	MVP 필수	안전 가이드

2. 기능 상세

2.1 Protocol Calculator

목적: 사용자의 목표에 맞는 온도/시간 추천

입력

목표 선택: Mental Boost / Recovery / Wake Up / Beginner
경험 레벨: First time / Few times / Regular
가용 온도 (선택)

출력

권장 온도 범위
권장 시간
주간 빈도
과학적 근거 한 줄

프로토콜 데이터

목표	온도	시간	빈도
🧠 Mental Boost	35-45°F (1.6-7°C)	1-3분	2-3회/주
💪 Recovery	50-59°F (10-15°C)	10-15분	운동 직후
☀️ Wake Up	45-55°F (7-13°C)	2-5분	매일 OK
🌱 Beginner	55-65°F (13-18°C)	2-5분	2-3회/주

UX

┌─────────────────────────────────────────┐
│  🎯 What's your goal?                   │
│                                         │
│  [🧠 Mental Boost]  [💪 Recovery]       │
│  [☀️ Wake Up]       [🌱 Beginner]       │
│                                         │
│  📊 Experience level?                   │
│  [First time] [Few times] [Regular]     │
│                                         │
│  🌡️ Temperature? (optional)            │
│  [___°F] or [Don't know]                │
└─────────────────────────────────────────┘

           ↓ 결과 ↓

┌─────────────────────────────────────────┐
│  📊 Your Protocol                       │
│                                         │
│  🌡️ Temperature: 50-59°F (10-15°C)     │
│  ⏱️ Duration: 2-5 minutes               │
│  📅 Frequency: 2-3x per week            │
│  🎯 Weekly Goal: 11 min total           │
│                                         │
│  💡 "2-5분이면 충분, 더 오래 = 더 좋은  │
│      게 아님"                           │
│                                         │
│  [ 🚀 Start Timer ]                     │
└─────────────────────────────────────────┘

2.2 Smart Timer

목적: 프로토콜 연동 카운트다운 타이머

기능

카운트다운 (프로토콜에서 자동 설정 또는 수동)
30초마다 차임 알림
마지막 10초 카운트다운
온도 입력 (세션 기록용)
호흡 가이드 오버레이 (토글)
+30초 연장 버튼
완료 시 세션 저장 화면으로 이동

사운드

이벤트	동작
시작	소리 + 진동
30초마다	부드러운 차임
마지막 10초	카운트다운 비프
완료	축하 사운드 + 진동

UX

┌─────────────────────────────────────────┐
│                                         │
│           ┌─────────────┐               │
│           │             │               │
│           │    2:34     │  ← 큰 숫자    │
│           │   ───────   │  ← 프로그레스 │
│           │  🌡️ 52°F   │  ← 온도 표시  │
│           │             │               │
│           └─────────────┘               │
│                                         │
│  🔔 Next chime in 26s                   │
│                                         │
│  ┌─────────────────────────────────┐   │
│  │ 🌬️ Breathe: IN... (4s)          │   │
│  └─────────────────────────────────┘   │
│                                         │
│  [ +30s ]              [ End & Save ]   │
│                                         │
│  터치 영역: 최소 48px (젖은 손 고려)     │
└─────────────────────────────────────────┘

2.3 Weekly Goal Tracker

목적: Søberg 프로토콜 주 11분 목표 추적

기능

이번 주 총 시간 / 11분 프로그레스 바
일별 세션 표시 (완료 ● / 미완료 ○)
스트릭 카운터 (연속 일수)
목표 커스터마이징 (기본 11분)
매주 월요일 자동 리셋

UX

┌─────────────────────────────────────────┐
│  🎯 This Week                           │
│                                         │
│  ████████████░░░░░░░░░░  7:30 / 11:00  │
│                                         │
│  Mon  Tue  Wed  Thu  Fri  Sat  Sun     │
│   ●    ●    ○    ○    ○    ○    ○      │
│  3:00 4:30                              │
│                                         │
│  🔥 2 day streak                        │
└─────────────────────────────────────────┘

2.4 Session Logger

목적: 세션 기록 및 통계

세션 완료 후 기록 항목

날짜/시간 (자동)
체류 시간 (자동)
수온 (입력)
기분 (1-5 이모지)
메모 (선택)

통계

총 세션 수
총 시간
평균 온도
최장 세션
현재 스트릭
주간 차트

저장

localStorage (로그인 없이)

UX — 세션 완료 후

┌─────────────────────────────────────────┐
│  🎉 Session Complete!                   │
│                                         │
│  ⏱️ 3:24  @  🌡️ 52°F                   │
│                                         │
│  How do you feel?                       │
│  [😫] [😐] [🙂] [😊] [🤩]               │
│                                         │
│  📝 Quick note (optional)               │
│  ┌─────────────────────────────────┐   │
│  │                                  │   │
│  └─────────────────────────────────┘   │
│                                         │
│  [ Save ]  [ Discard ]                  │
└─────────────────────────────────────────┘

UX — 히스토리

┌─────────────────────────────────────────┐
│  📊 Your History                        │
│                                         │
│  Total: 47 sessions | Best: 5:12        │
│  Avg temp: 52°F | 🔥 12 day streak      │
│                                         │
│  [주간 바 차트]                          │
│                                         │
│  Today, 7:32 AM                         │
│  ├─ 3:24 @ 48°F  🙂                     │
│  └─ "Felt energized!"                   │
│                                         │
│  Yesterday, 6:45 AM                     │
│  └─ 4:10 @ 52°F  😊                     │
└─────────────────────────────────────────┘

2.5 Breathing Guide

목적: 물 안에서 안전한 호흡 가이드

호흡 패턴

패턴	설명	물 안에서
Box (4-4-4-4)	들숨4s-참기4s-날숨4s-참기4s	✅ 안전
4-7-8	들숨4s-참기7s-날숨8s	✅ 안전
Wim Hof	과호흡 + 숨참기	⚠️ 물 밖에서만

기능

타이머와 통합 (오버레이)
시각적 호흡 가이드 (애니메이션)
단계별 텍스트 안내
패턴 변경 가능
끄기/켜기 토글

UX

┌─────────────────────────────────────────┐
│  🌬️ Box Breathing                       │
│                                         │
│         ┌───────────────┐               │
│         │               │               │
│         │   BREATHE IN  │               │
│         │      4s       │               │
│         │    ████░░░░   │               │
│         │               │               │
│         └───────────────┘               │
│                                         │
│  In 4s → Hold 4s → Out 4s → Hold 4s    │
│                                         │
│  [ Pause ]  [ Change Pattern ]          │
└─────────────────────────────────────────┘

2.6 Safety Tips

목적: 안전 가이드 제공

필수 내용

주제	팁
손발 통증	손은 물 밖에, 발은 풀 슈즈 착용
호흡	Wim Hof는 물 밖에서만!
초보자	2-3분 max, 불편하면 바로 나와
시간	2-5분이면 충분, 더 오래 ≠ 더 좋음
체온 회복	자연스럽게 회복, 뜨거운 샤워 ❌

Warning Signs (즉시 중단)

🚨 통증 (Pain)
🚨 저림 (Numbness)
🚨 떨림 멈추지 않음
🚨 혼란 (Confusion)

위치

/guide 페이지
타이머 시작 전 경고 (첫 사용자)
면책조항 푸터

3. 페이지 구조

/                  → Protocol Calculator (홈)
/timer             → Smart Timer
/history           → Session Logger + 통계
/guide             → Temperature Guide + Safety Tips

4. 디자인 가이드

4.1 원칙

모바일 퍼스트 — 욕조 옆에서 사용
한 손 조작 — 터치 영역 48px 이상
고대비 — 밝은 환경에서도 가독성
빠른 로딩 — LCP < 2.5초

4.2 컬러

Primary:    #00D4FF (Ice Blue)
Secondary:  #0A1628 (Deep Blue)
Accent:     #10B981 (Mint)
Warning:    #F59E0B (Orange)
Background: #111827 (Dark)

4.3 타이포그래피

타이머 숫자: 큰 사이즈, 볼드
본문: 16px 이상 (모바일 가독성)

5. 기술 스택

Framework: Vite + React 18
Language: TypeScript
Styling: Tailwind CSS + shadcn/ui
Animation: Framer Motion
Audio: Howler.js (Web Audio API)
Storage: localStorage (브라우저 저장, 로그인 불필요)
Hosting: Cloudflare Pages

5.1 왜 이 스택?

선택	이유
Vite + React	빌드 빠름, 번들 작음, 정적 사이트에 최적
Cloudflare Pages	무료, 글로벌 CDN, 서버 비용 $0
localStorage	백엔드 없이 세션 기록 저장
Tailwind + shadcn	빠른 UI 개발, 일관된 디자인

5.2 배포

# 빌드
npm run build

# Cloudflare Pages 연결
# - GitHub repo 연결
# - Build command: npm run build
# - Output directory: dist

5.3 폴더 구조

src/
├── components/
│   ├── Calculator/      # Protocol Calculator
│   ├── Timer/           # Smart Timer
│   ├── Tracker/         # Weekly Goal Tracker
│   ├── Logger/          # Session Logger
│   ├── Breathing/       # Breathing Guide
│   └── ui/              # shadcn 컴포넌트
├── hooks/
│   ├── useTimer.ts
│   ├── useStorage.ts
│   └── useAudio.ts
├── lib/
│   ├── protocols.ts     # 프로토콜 데이터
│   └── storage.ts       # localStorage 유틸
├── pages/
│   ├── index.tsx        # / (Calculator)
│   ├── timer.tsx        # /timer
│   ├── history.tsx      # /history
│   └── guide.tsx        # /guide
└── styles/
    └── globals.css

6. 면책조항

모든 페이지 푸터에 표시:

⚠️ This tool provides general wellness guidance only. It is not medical advice. Cold water immersion carries risks. Consult a healthcare professional before starting. Listen to your body and prioritize safety.

stevekim0417/MVP_PRD.md