맥락:
- /app 헤더가 시작 카드 톤과 달라 시각 흐름이 끊기고, 멤버십 등급이 프로필 트리거 내부에 있어 위계가 어색했다.
변경사항:
- AppTopBar를 Start Ritual 카드와 같은 라이트 톤(bg-white/78, text-brand-dark)으로 맞췄다.
- 멤버십 등급을 독립 뷰로 분리하기 위해 entities/user에 MembershipTierBadge 컴포넌트를 추가했다.
- ProfileMenu 트리거에서 등급 배지를 제거하고, 아바타+이름만 남겨 정보 위계를 단순화했다.
- docs/session_brief.md, docs/90_current_state.md에 최신 상태를 반영했다.
검증:
- npx tsc --noEmit
세션-상태: /app 헤더와 프로필 영역의 톤/위계 정렬을 완료했다.
세션-다음: RoomSheet 인원수 기반 UI를 큐레이션형 정보로 치환할지 확정이 필요하다.
세션-리스크: 밝은 사진 배경과 라이트 헤더 조합에서 상단 경계 인지가 약해질 수 있다.
맥락:
- /app 상단 헤더 배경과 로고 보조 배지가 시각적으로 무거워 현재 라이트 카드 톤과 어긋났다.
- 카드 사진 크기와 배경 전환 시 resize처럼 보이는 체감이 있어 선택 전환 품질 보정이 필요했다.
변경사항:
- AppTopBar에서 헤더 배경을 제거하고 로고 왼쪽 원형 V 배지를 삭제했다.
- ViewerProfile에 membershipTier를 추가하고, 프로필 이름 왼쪽에 등급 배지(PRO/NORMAL/TEAM)를 노출했다.
- RoomPreviewCard 높이를 고정해 카드 사진 크기를 통일했다.
- AppHub 배경 레이어의 transition-all을 제거해 카드 선택 시 배경이 리사이징 애니메이션처럼 보이는 현상을 완화했다.
- 세션 문서(90_current_state, session_brief)에 이번 작업 내역과 리스크를 반영했다.
검증:
- npx tsc --noEmit
세션-상태: /app 헤더/프로필 배지/카드 전환 디테일 보정 완료
세션-다음: RoomSheet/도크 패널의 인원수 기반 표현을 분위기형 정보로 전환
세션-리스크: 헤더 배경 제거로 밝은 배경 구간에서 상단 텍스트 대비가 낮아질 수 있어 점검 필요
맥락:
- /app 배경이 카드와 동일한 맥락의 블러 이미지로 보여야 공간 톤 연결이 자연스럽다.
- 앱 첫 진입 시 선택 상태가 명시되지 않으면 배경/선택 테두리 기준이 모호해질 수 있다.
변경사항:
- AppHub 배경 레이어를 hubColor 단색에서 선택 카드 사진 기반 블러 배경으로 전환했다.
- 배경 워시/그레인 오버레이 강도를 블러 사진 배경에 맞춰 재조정했다.
- useRoomSelection 초기값을 ROOM_THEMES[0].id로 명시해 첫 진입 시 첫 카드 선택 상태를 고정했다.
- 세션 문서(90_current_state, session_brief)에 이번 작업 내역과 리스크를 반영했다.
검증:
- npx tsc --noEmit
세션-상태: /app 배경이 선택 카드 사진 블러와 동기화되고 첫 카드 초기 선택이 명시됨
세션-다음: RoomSheet/도크 패널의 인원수 기반 표현을 분위기형 정보로 전환
세션-리스크: 배경 블러 강도 증가로 저사양 환경에서 GPU 부담이 늘 수 있어 실기기 점검 필요
맥락:
- 오늘의 공간 카드를 단색에서 실제 사진 기반으로 전환하고, 사진 출처를 추적할 수 있는 링크가 필요했다.
- 추후 자가 호스팅 이미지로 교체할 수 있도록 데이터 구조에서 전환 경로를 미리 확보해야 했다.
변경사항:
- entities/room 모델에 cardPhotoUrl, googleImageSearchUrl, managedCardPhotoUrl 필드를 추가했다.
- 10개 공간 카드에 실제 사진 URL과 Google 이미지 검색 링크를 매핑했다.
- getRoomCardPhotoUrl, getRoomCardBackgroundStyle helper를 추가해 추후 managed 이미지로 교체 가능한 fallback 구조를 만들었다.
- RoomPreviewCard 배경을 실제 사진 렌더링으로 변경하고, 텍스트 가독성을 위한 오버레이를 적용했다.
- 세션 문서(90_current_state, session_brief)에 이번 작업 내역과 리스크를 반영했다.
검증:
- npx tsc --noEmit
세션-상태: 오늘의 공간 카드에 실제 사진 소스/구글 링크/교체 경로 반영 완료
세션-다음: RoomSheet/도크 패널의 인원수 기반 표현을 분위기형 정보로 전환
세션-리스크: 외부 이미지 URL 의존으로 소스 만료/속도 이슈 가능성이 있어 자가 호스팅 전환 필요
맥락:
- 오늘의 공간 카드가 이미지 기반 배경이라 색/질감이 복잡하게 보였고, 카드와 페이지 배경의 톤 연결이 약했다.
- 룸 이름별로 분리된 단색 팔레트를 사용해 카드 가독성과 허브의 색 일관성을 높일 필요가 있었다.
변경사항:
- entities/room 모델에 hubColor 필드를 추가하고 10개 룸에 겹치지 않는 단색 팔레트를 정의했다.
- RoomPreviewCard를 이미지 배경 대신 룸 고유 단색 배경으로 렌더링하도록 변경했다.
- RoomPreviewCard 내부 텍스트/칩 스타일을 단색 카드 대비에 맞춰 어두운 텍스트 중심으로 재정렬했다.
- AppHub 배경을 선택 룸의 hubColor로 동기화해 카드 선택과 페이지 배경이 같은 색 계열로 연결되게 조정했다.
- 세션 문서(90_current_state, session_brief)에 이번 작업 내역과 리스크를 반영했다.
검증:
- npx tsc --noEmit
세션-상태: /app 오늘의 공간 카드/허브 배경 단색 팔레트 전환 완료
세션-다음: RoomSheet/도크 패널의 인원수 기반 표현을 분위기형 정보로 전환
세션-리스크: 일부 디스플레이에서 단색 팔레트 간 체감 차이가 작아 보일 수 있어 기기별 색 분리도 점검 필요
맥락:
- /app에서 핵심 카드(지금 몰입/오늘의 공간)가 배경 이미지와 함께 어둡게 겹쳐 보이며 시인성이 떨어졌다.
- 배경은 가상 공간을 유지하되 카드 표면은 stats와 유사한 흰 톤으로 분리해 정보 가독성을 높일 필요가 있었다.
변경사항:
- StartRitualWidget과 RoomsGalleryWidget 컨테이너를 흰 표면 + 어두운 텍스트 라이트 카드 톤으로 조정했다.
- StartRitual 입력/칩/보조 버튼 색상을 라이트 카드 팔레트에 맞춰 재정렬했다.
- AppHub 배경 이미지의 blur/밝기 보정을 강화하고 다크 오버레이를 완화해 카드 외곽에서 가상 공간 배경이 부드럽게 보이도록 조정했다.
- 세션 문서(90_current_state, session_brief)에 이번 작업 내역과 리스크를 반영했다.
검증:
- npx tsc --noEmit
세션-상태: /app 핵심 카드 라이트 톤 전환 및 배경 블러 강화 반영 완료
세션-다음: RoomSheet/도크 패널의 인원수 기반 표현을 분위기형 정보로 전환
세션-리스크: 룸 프리뷰 카드는 이미지 기반 다크 톤이라 라이트 컨테이너와 미세한 톤 차이가 남을 수 있음
맥락:
- 커스텀 입장 모달이 허브 대비 과도하게 어두워 화면 톤 일관성이 떨어졌다.
- 탭(공간/사운드/타이머) 전환 시 본문 높이가 달라져 모달 외곽 크기가 흔들리는 UX 이슈가 있었다.
변경사항:
- Modal 오버레이/패널/헤더/푸터 스타일을 밝은 글래스 톤으로 조정해 허브 톤과 맞췄다.
- CustomEntryModal의 탭 콘텐츠 영역을 고정 높이 컨테이너로 변경해 탭 전환 시 모달 전체 크기가 변하지 않도록 했다.
- 공간/사운드/타이머 옵션 버튼과 커스텀 타이머 입력 필드를 밝은 팔레트로 재정의했다.
- Tabs 컴포넌트를 밝은 표면 톤에 맞게 보정했다.
- 세션 문서(90_current_state, session_brief)에 이번 작업 내용/리스크를 반영했다.
검증:
- npx tsc --noEmit
세션-상태: 커스텀 입장 모달의 밝은 톤 정렬 및 탭 전환 크기 고정 반영 완료
세션-다음: RoomSheet/도크 패널의 인원수 기반 표현을 분위기형 정보로 전환
세션-리스크: 모달 고정 높이 적용으로 작은 화면에서 탭 본문 내부 스크롤 의존도가 증가할 수 있음
맥락:
- /app 허브에서 배경 이미지가 전면에 강하게 드러나 전체 인상이 어둡고, 룸별 배경 복잡도에 따라 카드 가독성이 흔들릴 수 있었다.
- 밝은 톤 전환과 동시에 카드 정보 표면을 안정화해 저자극 톤을 유지할 필요가 있었다.
변경사항:
- AppHub 배경에 blur + 밝기/채도 필터를 적용하고, 밝은 워시 오버레이로 명도를 상향했다.
- 전역 그레인 강도를 낮춰 시각적 노이즈를 줄였다.
- RoomPreviewCard 배경 마스크를 재조정하고, 내부 콘텐츠 영역에 반투명 패널을 추가해 텍스트 대비를 고정했다.
- RoomPreviewCard 내 메타 텍스트/칩의 대비를 상향해 복잡한 배경에서도 읽기 쉬운 상태로 보정했다.
- GlassCard의 표면 불투명도와 그림자를 조정해 /app 전반의 무게감을 완화했다.
- 세션 문서(90_current_state, session_brief)에 이번 패치 내역과 잔여 리스크를 반영했다.
검증:
- npx tsc --noEmit
세션-상태: /app 배경 밝기와 카드 가시성 안정화 패치 반영 완료
세션-다음: RoomSheet/도크 패널의 인원수 기반 표현을 분위기형 정보로 전환
세션-리스크: 배경 blur/filter 적용으로 저사양 환경에서 렌더링 비용이 소폭 증가할 수 있음
맥락:
- /app 룸 카드에서 카드 전체를 버튼으로 사용하면서 내부 Chip도 버튼으로 렌더링되어 HTML 중첩 버튼 규칙을 위반했다.
- Next.js hydration 단계에서 콘솔 에러가 발생해 UI 신뢰도와 디버깅 효율을 저하시켰다.
변경사항:
- RoomPreviewCard 내부의 Chip 컴포넌트 사용을 제거했다.
- 카드 내부 태그/추천 정보 칩을 비인터랙티브 span 스타일로 교체해 버튼 중첩 구조를 해소했다.
- 세션 문서(90_current_state, session_brief)에 이번 에러 수정 내역을 반영했다.
검증:
- npx tsc --noEmit
세션-상태: /app 룸 카드의 중첩 버튼 hydration 에러 해소
세션-다음: RoomSheet/도크 패널의 인원수 기반 표현을 분위기형 정보로 전환
세션-리스크: 밝은 배경 구간에서 white 텍스트 대비가 약해질 수 있어 기기별 시인성 점검 필요
맥락:
- /landing 이후 진입하는 앱 화면들의 배경이 전반적으로 어두워 초기 인상과 톤 연속성이 떨어졌다.
- 기존 감성/저자극 분위기를 유지하면서 배경 명도를 올려 부담을 낮출 필요가 있었다.
변경사항:
- /app 허브 배경 오버레이를 밝은 그라디언트 중심으로 조정하고 grain 강도를 낮췄다.
- 룸 카드 마스크 강도를 완화해 미리보기 이미지의 밝은 톤 노출을 늘렸다.
- /space 배경 오버레이, 그레인, 비네팅 강도를 단계적으로 낮춰 전체 명도를 상향했다.
- /space suspense fallback 배경을 라이트 그라디언트로 변경했다.
- /stats, /settings 페이지를 라이트 팔레트 기반 배경/패널 스타일로 전환했다.
- 세션 복구 문서(90_current_state, session_brief)에 이번 변경과 리스크를 반영했다.
검증:
- npx tsc --noEmit
세션-상태: /landing 이후 앱 플로우 배경이 밝은 톤으로 정리됨
세션-다음: RoomSheet/도크 패널의 인원수 기반 표현을 분위기형 정보로 전환
세션-리스크: 밝은 배경 구간에서 일부 white 텍스트 대비가 약해질 수 있어 기기별 시인성 점검 필요
맥락:
- /space 하단 HUD의 30초 복귀 액션을 저자극 감성 톤으로 정리해 복귀 행동의 심리적 부담을 낮춘다.
변경사항:
- restart-30s feature에 카피 상수(model/copy)를 추가하고 버튼/모드/안내 문구를 중앙 관리로 전환했다.
- useRestart30s에 더미 상태 전환(isBreatheMode, hintMessage)을 추가해 클릭 후 2초 내 안내 노출과 자동 복귀를 구현했다.
- HUD에서 30초 진입 중 상태 라벨을 BREATHE로 표시하고, 안내 문구를 목표 라인에 저대비로 잠깐 노출하도록 조정했다.
- 30초 액션 버튼을 "숨 고르기 30초" + 🌬️ 형태의 보조 액션 톤으로 변경했다.
- 세션 복구 문서(90_current_state, session_brief)에 이번 작업 상태/리스크를 반영했다.
검증:
- npx tsc --noEmit
세션-상태: /space 30초 복귀 액션 카피 리브랜딩 및 HUD 더미 안내 반영 완료
세션-다음: RoomSheet/도크 인원수 기반 카피를 큐레이션형 표현으로 전환
세션-리스크: HUD 목표 문구와 안내 문구가 교체 노출되어 정보 우선순위 점검 필요
맥락:
- 몰입 OFF의 나가기 롱프레스 bar에서 진행 표시가 즉시 보이지 않고 완료 시 0으로 역방향 축소되는 문제를 해결하기 위해
변경사항:
- bar 진행 표시를 JS width 갱신에서 CSS keyframes 기반으로 교체
- 키프레임에 가속 규칙 반영(0.05초 20%, 1.0초 100%)
- 완료 후 100% 상태를 짧게 유지한 뒤 언마운트하도록 훅 상태(isCompleted) 보강
- progress fill의 rounded 캡을 제거해 끝단 직선화
- docs/90_current_state.md, docs/session_brief.md 최신 상태 반영
검증:
- npx tsc --noEmit
세션-상태: bar 롱프레스 진행은 눌렀을 때 즉시 보이고 완료 리셋 시 역방향 축소가 사라짐
세션-다음: 롱프레스 인지성 보조 카피 도입 여부 검토
세션-리스크: bar(CSS)와 ring(JS) 진행 로직이 분리되어 향후 규칙 변경 시 동시 점검 필요
맥락:
- /space에서 실수 이탈을 줄이면서도 명확한 탈출 동선을 유지하기 위해 나가기 액션을 1초 롱프레스 방식으로 변경
변경사항:
- features/exit-hold 추가(useHoldToConfirm, ExitHoldButton)
- 1초 롱프레스와 가속 진행 규칙(0.05초 -> 20%)을 feature 내부에 구현
- 몰입 OFF에서는 bar(좌->우 fill), 몰입 ON에서는 ring 진행 표시로 분기
- 1초 미만 해제/마우스 leave/touch cancel 시 진행률 즉시 리셋
- 완료 시 나가기(더미) 토스트 + 몰입 모드 OFF 동작 연결
- docs/90_current_state.md, docs/session_brief.md 상태 업데이트
검증:
- npx tsc --noEmit
세션-상태: 상단 나가기 액션은 롱프레스 완료 시에만 트리거됨
세션-다음: 롱프레스 인터랙션 인지성 보완용 힌트 카피 도입 여부 검토
세션-리스크: 터치 환경에서 롱프레스 UI 의도를 즉시 이해하지 못할 가능성 있음
맥락:
- 몰입 모드 ON에서 상단 우측 액션이 허브 이동으로 보이는 혼선을 줄이고 즉시 이탈 동선을 제공하기 위해
변경사항:
- 몰입 모드 훅에 exitImmersionMode 액션 추가
- 몰입 모드 ON 시 상단 우측 액션을 나가기 버튼으로 전환
- 나가기 클릭 시 토스트(나가기(더미)) 노출 후 몰입 모드 OFF 처리
- docs/90_current_state.md, docs/session_brief.md 최신 상태 반영
검증:
- npx tsc --noEmit
세션-상태: 몰입 모드 ON에서 상단 우측 액션은 나가기로 동작함
세션-다음: RoomSheet/도크의 인원수 중심 정보를 분위기형 정보로 교체
세션-리스크: 터치 환경에서 미니 레일 발견성이 낮을 수 있어 UX 보완이 필요
맥락:
- /space 배경 몰입을 방해하는 상단 프레임 느낌과 하단 HUD의 떠있는 간격을 줄이기 위해
변경사항:
- 상단 헤더의 border/프레임 느낌을 제거하고 오버레이 톤으로 축소
- 헤더 아이콘/패딩을 축소해 배경 노출 영역을 확대
- 타이머 HUD 하단 위치를 safe-area 기반 최소 여백으로 조정
검증:
- npx tsc --noEmit
세션-상태: /space 헤더가 박스형 프레임 없이 가벼운 오버레이로 표시됨
세션-다음: 몰입 모드에서 상단 액션을 나가기 버튼으로 전환
세션-리스크: 기기별 safe-area 계산 차이로 HUD 체감 위치가 다를 수 있음
맥락:
- /space 하단 사운드 바를 제거하고 도구를 우측 도크에 수납해 배경 몰입을 강화하며, 몰입 모드 ON 체감을 높이기 위해
변경사항:
- 하단 사운드 프리셋 바를 제거하고 도크에 🎧 Sound 패널을 추가
- features/sound-preset + widgets/sound-sheet를 추가해 프리셋 선택/믹서 UI(더미) 구성
- features/immersion-mode + shared/ui/Toggle을 추가하고 Quick 시트 토글과 연결
- 몰입 모드 ON 시 상단 Current Room 숨김, 허브 버튼 소형화, 레일 미니화, HUD 저대비, 비네팅/그레인 강화
- widgets/space-chrome를 신설해 /space 상단 크롬 렌더링을 분리
- docs/90_current_state.md, docs/session_brief.md 최신 상태로 갱신
검증:
- npx tsc --noEmit
세션-상태: /space는 사운드 시트 기반 도크 구조와 몰입 모드 UI를 제공함
세션-다음: RoomSheetWidget 인원수 기반 정보를 큐레이션 표현으로 전환
세션-리스크: 터치 환경에서 미니 레일 발견성이 낮을 수 있어 보조 힌트가 필요할 수 있음
맥락:
- workFlow 실행 시 기본 로드 문서 수를 줄여 토큰 사용량을 추가로 절감하기 위해
변경사항:
- docs/session_brief.md 신설(세션 시작용 초소형 스냅샷)
- docs/workFlow.md 기본 로드를 work + session_brief 2파일로 변경
- docs/README.md 우선 읽기 순서와 운영 원칙 갱신
- docs/90_current_state.md에 정책 변경 기록
검증:
- 문서 내용 수동 검토
- 기본 로드 입력 크기: work(497) + session_brief(718) = 1215 chars
세션-상태: workflow 기본 로드는 2파일 모드로 동작함
세션-다음: session_brief를 작업 종료 시 최신 상태로 유지
세션-리스크: session_brief 갱신이 누락되면 복구 정확도가 떨어질 수 있음
맥락:
- workFlow 실행 시 매번 여러 문서를 전부 읽어 토큰이 과도하게 소모되는 문제를 줄이기 위해
변경사항:
- docs/context_core.md 신설(핵심 규칙 요약본)
- docs/workFlow.md를 기본 3문서 + 조건부 로드 방식으로 변경
- docs/README.md에 context_core 및 토큰 절약 로드 원칙 반영
- docs/90_current_state.md에 이번 정책 변경 기록
검증:
- 문서 문자 수 기준 로드량 비교 계산
- old_always_chars=6226, new_always_chars=3015
세션-상태: workflow가 토큰 절약형 컨텍스트 로드를 사용함
세션-다음: 조건부 로드 문서 기준을 실제 작업 로그로 튜닝
세션-리스크: work.md 입력이 장문이면 절감 효과가 상대적으로 줄어들 수 있음
맥락:
- 작업 지시를 문서 기반으로 표준화하고, 실행 시 규칙 준수와 주제별 커밋을 강제하기 위해
변경사항:
- docs/work.md에 작업 입력 템플릿 추가
- docs/workFlow.md에 실행 순서, 규칙 준수, 커밋 절차 명시
- docs/README.md에 work/workFlow 문서 링크 추가
검증:
- 문서 내용 수동 검토
세션-상태: 문서 기반 작업 지시/실행 체계가 준비됨
세션-다음: 이후 작업부터 work.md 작성 후 workFlow.md 실행
세션-리스크: work.md가 비어 있으면 실행 전에 추가 확인이 필요
맥락:
- 기존 라우트/컴포넌트 구조를 FSD 기준으로 정리하고, /app 허브와 /space 집중 화면 중심의 목업 흐름을 구성하기 위해
변경사항:
- App Router 구조를 /landing, /app, /space, /stats, /settings 중심으로 재배치
- entities/session/room/user 더미 데이터와 타입 정의 추가
- features(커스텀 입장, 룸 선택, 체크인, 리액션, 30초 리스타트 등) 단위로 로직 분리
- widgets(허브, 룸 갤러리, 타이머 HUD, 툴 도크 등) 조합형 UI 추가
- shared 공용 UI(Button/Chip/Modal/Toast 등) 및 유틸(cn/useReducedMotion) 정비
- 로그인 후 이동 경로를 /dashboard 에서 /app 으로 변경
- README를 현재 프로젝트 구조/라우트/구현 범위 기준으로 갱신
검증:
- npx tsc --noEmit
세션-상태: 허브·스페이스 목업이 FSD 레이어로 동작 가능하도록 정리됨
세션-다음: /space 상단 및 도크의 인원 수 카피를 분위기형 카피로 후속 정리
세션-리스크: build는 네트워크 환경에서 Google Fonts fetch 실패 가능
맥락:
- 커밋 메시지는 한국어로 작성해야 한다는 팀 규칙을 문서와 템플릿에 반영하기 위해
변경사항:
- docs/06_commit_convention.md에 한국어 작성 필수 규칙 추가
- docs/07_session_recovery.md의 커밋 예시를 한국어로 교체
- .gitmessage-session.txt 템플릿 본문 항목을 한국어로 변경
검증:
- 변경 파일 수동 검토
세션-상태: 한국어 커밋 규칙과 템플릿이 반영됨
세션-다음: 기능 커밋에도 동일한 한국어 템플릿을 적용
세션-리스크: 기존 과거 커밋 메시지는 영어가 포함될 수 있음
Context:
- codex cli 중단 후에도 작업 품질과 맥락을 안정적으로 복구하기 위해
Changes:
- docs/00~07, 90 문서 세트 추가/정리
- commit convention 문서 및 .gitmessage-session.txt 템플릿 추가
- scripts/session/recover-context.sh 추가
- package.json에 session:recover 스크립트 추가
Validation:
- npm run session:recover
Session-State: session recovery docs, template, and script are in place
Session-Next: apply this commit format to feature and refactor commits
Session-Risks: legacy commits before this change do not include session trailers
