corpi/viberoom-web
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(stats): immersive weekly review stage 적용

Browse Source
This commit is contained in:
corpi
2026-03-16 13:41:58 +09:00
parent 8f4a69fc77
commit e16a182499
4 changed files with 227 additions and 135 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/90_current_state.md
View File

@@ -129,6 +129,10 @@ Last Updated: 2026-03-16
- `snapshot + start quality + recovery quality + completion quality + carry forward` 구조를 반영 - `snapshot + start quality + recovery quality + completion quality + carry forward` 구조를 반영
- 기존 `focus-summary` 응답을 주간 review view model로 변환해서 사용 - 기존 `focus-summary` 응답을 주간 review view model로 변환해서 사용
- recovery는 서버의 `pause 뒤 복귀` 집계를 사용하고, `자리 비움 뒤 복귀`만 limited note로 남긴다 - recovery는 서버의 `pause 뒤 복귀` 집계를 사용하고, `자리 비움 뒤 복귀`만 limited note로 남긴다
- `/stats` immersive review stage polish:
- `/stats`를 밝은 대시보드 카드 반복 화면에서 dark immersive review stage로 재구성했다
- 중앙 hero summary, snapshot metric rail, start/recovery/completion panel, carry-forward closure stage를 같은 glass family로 통일했다
- carry-forward ritual에 맞는 atmosphere 배경을 얇게 투영해 `/app`과 같은 제품군으로 보이게 정리했다
- `/app -> /stats` primary entry의 1차 연결: - `/app -> /stats` primary entry의 1차 연결:
- current session이 없고 최근 7일 데이터가 충분할 때 `/app`의 quiet secondary review dock에서 `Weekly Review` entry를 노출한다 - current session이 없고 최근 7일 데이터가 충분할 때 `/app`의 quiet secondary review dock에서 `Weekly Review` entry를 노출한다
- current session이 있으면 `/app` 자체가 `/space`로 이동하므로, `/app` review entry는 no-session entry shell 안에서만 다룬다 - current session이 있으면 `/app` 자체가 `/space`로 이동하므로, `/app` review entry는 no-session entry shell 안에서만 다룬다

8
docs/screens/stats/current/14_weekly_review_reframe_spec.md
View File

@@ -147,6 +147,14 @@ VibeRoom의 review는 아래처럼 포지셔닝해야 한다.
Weekly Review는 `/stats` 안에서 아래 5개 구역으로 재구성한다. Weekly Review는 `/stats` 안에서 아래 5개 구역으로 재구성한다.
### 현재 visual shell 원칙
- `/stats`는 밝은 factual dashboard가 아니라 dark immersive review stage로 간다
- 배경은 carry-forward ritual과 연결되는 atmosphere를 얇게 투영한다
- 상단은 quiet accessory만 두고, hero summary가 화면의 중심이 된다
- snapshot metrics는 작은 glass tile rail로, start/recovery/completion은 같은 family의 review panel로 통일한다
- 마지막 carry-forward CTA는 별도 버튼 묶음이 아니라 다음 세션 entry로 자연스럽게 이어지는 closure stage여야 한다
### Section A. Weekly Snapshot ### Section A. Weekly Snapshot
목적: 목적:

3
docs/session_brief.md
View File

@@ -107,6 +107,9 @@ Last Updated: 2026-03-16
- hero snapshot, start quality, recovery quality, completion quality, carry forward 구조를 사용한다. - hero snapshot, start quality, recovery quality, completion quality, carry forward 구조를 사용한다.
- 기존 `focus-summary` 응답은 review view model로 변환해서 쓴다. - 기존 `focus-summary` 응답은 review view model로 변환해서 쓴다.
- recovery는 서버의 `pause 뒤 복귀` 집계를 사용하고, `away recovery`만 limited state로 남긴다. - recovery는 서버의 `pause 뒤 복귀` 집계를 사용하고, `away recovery`만 limited state로 남긴다.
- `/stats` immersive review stage polish를 반영했다.
- dark atmosphere 배경 위에 중앙 hero summary, snapshot metric rail, review panel, carry-forward closure stage를 같은 glass family로 재구성했다.
- `/app`의 premium immersive tone과 같은 제품군으로 읽히도록 `/stats`의 위계와 재질을 다시 맞췄다.
- `/app`에서 `/stats`로 들어가는 primary path 1차가 생겼다. - `/app`에서 `/stats`로 들어가는 primary path 1차가 생겼다.
- current session이 없을 때는 quiet review dock에서 `/stats`로 진입할 수 있다. - current session이 없을 때는 quiet review dock에서 `/stats`로 진입할 수 있다.
- review entry는 main start CTA보다 항상 낮은 강조를 유지한다. - review entry는 main start CTA보다 항상 낮은 강조를 유지한다.

347
src/widgets/stats-overview/ui/StatsOverviewWidget.tsx
View File

@@ -1,12 +1,52 @@
'use client'; 'use client';
import Link from 'next/link'; import Link from 'next/link';
import { useMemo } from 'react';
import { useMediaCatalog, getSceneStageBackgroundStyle } from '@/entities/media';
import { usePlanTier } from '@/entities/plan'; import { usePlanTier } from '@/entities/plan';
import { getSceneById, SCENE_THEMES } from '@/entities/scene';
import { useFocusStats } from '@/features/stats'; import { useFocusStats } from '@/features/stats';
import { copy } from '@/shared/i18n'; import { copy } from '@/shared/i18n';
import { cn } from '@/shared/lib/cn'; import { cn } from '@/shared/lib/cn';
const ReviewMetric = ({ const glassPanelClass =
'rounded-[2rem] border border-white/10 bg-[linear-gradient(160deg,rgba(8,12,18,0.46)_0%,rgba(8,12,18,0.2)_58%,rgba(8,12,18,0.52)_100%)] shadow-[0_24px_80px_rgba(3,7,18,0.28)] backdrop-blur-[24px]';
const metricTileClass =
'rounded-[1.45rem] border border-white/10 bg-[linear-gradient(145deg,rgba(255,255,255,0.08)_0%,rgba(255,255,255,0.04)_100%)] px-4 py-4 backdrop-blur-xl';
const DEFAULT_STATS_SCENE_ID = getSceneById('forest')?.id ?? SCENE_THEMES[0].id;
const reviewStageSceneByPreset = (presetId: string) => {
if (presetId.startsWith('forest')) {
return getSceneById('forest') ?? SCENE_THEMES[0];
}
return getSceneById(DEFAULT_STATS_SCENE_ID) ?? SCENE_THEMES[0];
};
const StatusAccessory = ({
label,
subtle = false,
}: {
label: string;
subtle?: boolean;
}) => {
return (
<span
className={cn(
'inline-flex items-center gap-2 rounded-full border px-3 py-1.5 text-[10px] font-semibold uppercase tracking-[0.2em] backdrop-blur-md',
subtle
? 'border-white/8 bg-white/[0.05] text-white/44'
: 'border-white/12 bg-white/[0.07] text-white/64',
)}
>
<span className="h-1.5 w-1.5 rounded-full bg-white/50" />
{label}
</span>
);
};
const SnapshotMetric = ({
label, label,
value, value,
hint, hint,
@@ -16,10 +56,10 @@ const ReviewMetric = ({
hint: string; hint: string;
}) => { }) => {
return ( return (
<div className="rounded-2xl border border-brand-dark/8 bg-white/70 px-4 py-3"> <div className={metricTileClass}>
<p className="text-[11px] font-medium tracking-[0.08em] text-brand-dark/44">{label}</p> <p className="text-[10px] font-medium uppercase tracking-[0.18em] text-white/42">{label}</p>
<p className="mt-2 text-[1.05rem] font-semibold text-brand-dark">{value}</p> <p className="mt-3 text-[1.05rem] font-medium tracking-[-0.03em] text-white/92">{value}</p>
<p className="mt-1 text-[12px] leading-[1.45] text-brand-dark/52">{hint}</p> <p className="mt-2 text-[12px] leading-[1.58] text-white/54">{hint}</p>
</div> </div>
); );
}; };
@@ -30,35 +70,36 @@ const ReviewSection = ({
metrics, metrics,
availability, availability,
note, note,
toneClass, accentClass,
}: { }: {
title: string; title: string;
summary: string; summary: string;
metrics: Array<{ id: string; label: string; value: string; hint: string }>; metrics: Array<{ id: string; label: string; value: string; hint: string }>;
availability: 'ready' | 'limited'; availability: 'ready' | 'limited';
note?: string; note?: string;
toneClass: string; accentClass: string;
}) => { }) => {
return ( return (
<section className="overflow-hidden rounded-[28px] border border-brand-dark/10 bg-white/76 backdrop-blur-md"> <section className={cn(glassPanelClass, 'relative overflow-hidden p-5 sm:p-6')}>
<div className={cn('h-1.5 w-full', toneClass)} /> <div className={cn('pointer-events-none absolute inset-x-0 top-0 h-20 opacity-90', accentClass)} />
<div className="px-5 py-5 sm:px-6"> <div className="relative">
<div className="flex items-start justify-between gap-4"> <div className="flex items-start justify-between gap-4">
<div className="max-w-2xl"> <div className="max-w-[34rem]">
<h2 className="text-[1.05rem] font-semibold tracking-tight text-brand-dark">{title}</h2> <p className="text-[10px] font-medium uppercase tracking-[0.2em] text-white/40">
<p className="mt-2 text-[14px] leading-[1.65] text-brand-dark/68">{summary}</p> Weekly Review
</p>
<h2 className="mt-3 text-[1.2rem] font-medium tracking-[-0.04em] text-white">
{title}
</h2>
<p className="mt-3 text-[13px] leading-[1.68] text-white/64">{summary}</p>
</div> </div>
{availability === 'limited' ? ( {availability === 'limited' ? <StatusAccessory label="Limited" subtle /> : null}
<span className="shrink-0 rounded-full border border-brand-dark/10 bg-white/70 px-3 py-1 text-[11px] font-medium tracking-[0.08em] text-brand-dark/46">
Limited
</span>
) : null}
</div> </div>
{metrics.length > 0 ? ( {metrics.length > 0 ? (
<div className="mt-5 grid gap-3 sm:grid-cols-3"> <div className="mt-5 grid gap-3 sm:grid-cols-3">
{metrics.map((metric) => ( {metrics.map((metric) => (
<ReviewMetric <SnapshotMetric
key={metric.id} key={metric.id}
label={metric.label} label={metric.label}
value={metric.value} value={metric.value}
@@ -69,7 +110,7 @@ const ReviewSection = ({
) : null} ) : null}
{note ? ( {note ? (
<p className="mt-5 rounded-2xl border border-brand-dark/8 bg-white/56 px-4 py-3 text-[13px] leading-[1.6] text-brand-dark/54"> <p className="mt-5 rounded-[1.35rem] border border-white/8 bg-white/[0.05] px-4 py-3 text-[12px] leading-[1.62] text-white/52">
{note} {note}
</p> </p>
) : null} ) : null}
@@ -81,143 +122,179 @@ const ReviewSection = ({
export const StatsOverviewWidget = () => { export const StatsOverviewWidget = () => {
const { stats } = copy; const { stats } = copy;
const { isPro } = usePlanTier(); const { isPro } = usePlanTier();
const { sceneAssetMap } = useMediaCatalog();
const { review, isLoading, error, source, refetch } = useFocusStats(); const { review, isLoading, error, source, refetch } = useFocusStats();
const activeScene = useMemo(
() => reviewStageSceneByPreset(review.carryForward.presetId),
[review.carryForward.presetId],
);
const sourceLabel = source === 'api' ? stats.sourceApi : stats.sourceMock;
const syncLabel = error ? error : isLoading ? stats.loading : stats.synced;
const carryForwardCtaLabel = isPro ? stats.reviewCarryCtaPro : review.carryForward.ctaLabel; const carryForwardCtaLabel = isPro ? stats.reviewCarryCtaPro : review.carryForward.ctaLabel;
return ( return (
<div className="min-h-screen bg-[radial-gradient(circle_at_14%_0%,rgba(198,219,244,0.52),transparent_42%),radial-gradient(circle_at_88%_12%,rgba(232,240,249,0.8),transparent_34%),linear-gradient(180deg,#f8fbff_0%,#f2f7fc_46%,#edf3f9_100%)] text-brand-dark"> <div className="relative min-h-dvh overflow-hidden bg-black text-white selection:bg-white/20">
<div className="mx-auto w-full max-w-6xl px-4 pb-12 pt-6 sm:px-6 lg:px-8"> <div
<header className="mb-6 flex flex-wrap items-center justify-between gap-3 rounded-[24px] border border-brand-dark/10 bg-white/74 px-4 py-3 backdrop-blur-md sm:px-5"> className="absolute inset-0 bg-cover bg-center"
<div> style={getSceneStageBackgroundStyle(activeScene, sceneAssetMap?.[activeScene.id])}
<p className="text-[11px] font-medium tracking-[0.14em] text-brand-dark/42"> />
{review.periodLabel} <div className="absolute inset-0 bg-[radial-gradient(circle_at_center,transparent_0%,rgba(0,0,0,0.62)_100%)] mix-blend-multiply pointer-events-none" />
</p> <div className="absolute inset-0 bg-black/18 pointer-events-none" />
<h1 className="mt-1 text-[1.2rem] font-semibold tracking-tight text-brand-dark"> <div className="absolute inset-0 bg-[linear-gradient(180deg,rgba(2,6,23,0.12)_0%,rgba(2,6,23,0.32)_44%,rgba(2,6,23,0.62)_100%)] pointer-events-none" />
<header className="absolute inset-x-0 top-0 z-40 flex items-center justify-between px-5 py-5 md:px-8 md:py-8">
<div className="flex items-center gap-3">
<p className="text-[11px] font-bold uppercase tracking-[0.4em] text-white/54">
Weekly Review
</p>
{isPro ? (
<span className="rounded-full bg-white/10 px-2 py-0.5 text-[9px] font-bold uppercase tracking-[0.18em] text-white/60 backdrop-blur-md">
PRO
</span>
) : null}
</div>
<div className="flex items-center gap-2">
<button
type="button"
onClick={() => {
void refetch();
}}
className="rounded-full border border-white/10 bg-white/[0.05] px-4 py-2 text-[10px] font-semibold uppercase tracking-[0.18em] text-white/62 backdrop-blur-md transition hover:bg-white/[0.1] hover:text-white"
>
{stats.refresh}
</button>
<Link
href="/app"
className="rounded-full border border-white/10 bg-white/[0.05] px-4 py-2 text-[10px] font-semibold uppercase tracking-[0.18em] text-white/62 backdrop-blur-md transition hover:bg-white/[0.1] hover:text-white"
>
{copy.common.hub}
</Link>
</div>
</header>
<main className="relative z-10 mx-auto flex min-h-dvh w-full max-w-[90rem] flex-col px-4 pb-10 pt-28 md:px-8 md:pb-12 md:pt-32">
<div className="flex flex-col items-center text-center">
<div className="flex flex-wrap items-center justify-center gap-2">
<StatusAccessory label={review.periodLabel} />
<StatusAccessory label={sourceLabel} subtle />
</div>
<div className="mt-8 max-w-[58rem] space-y-4">
<p className="text-[12px] font-medium uppercase tracking-[0.22em] text-white/42">
{review.snapshotTitle} {review.snapshotTitle}
</p>
<h1 className="text-[2.5rem] font-light leading-[0.98] tracking-[-0.06em] text-white md:text-[4rem]">
{review.snapshotSummary}
</h1> </h1>
<p className="mx-auto max-w-[38rem] text-[13px] leading-[1.7] text-white/54 md:text-[14px]">
{syncLabel}
</p>
</div> </div>
</div>
<div className="flex items-center gap-2"> <section className="mt-10 grid gap-3 md:grid-cols-2 xl:grid-cols-4">
<button {review.snapshotMetrics.map((metric) => (
type="button" <SnapshotMetric
onClick={() => { key={metric.id}
void refetch(); label={metric.label}
}} value={metric.value}
className="rounded-full border border-brand-dark/12 bg-white/74 px-3.5 py-2 text-[12px] font-medium text-brand-dark/78 transition hover:bg-white/94" hint={metric.hint}
> />
{stats.refresh} ))}
</button> </section>
<Link
href="/app"
className="rounded-full border border-brand-dark/12 bg-white/74 px-3.5 py-2 text-[12px] font-medium text-brand-dark/78 transition hover:bg-white/94"
>
{copy.common.hub}
</Link>
</div>
</header>
<div className="space-y-6"> <section className="mt-12 grid gap-5 xl:grid-cols-[1.08fr_0.92fr]">
<section className="overflow-hidden rounded-[32px] border border-brand-dark/10 bg-[linear-gradient(180deg,rgba(255,255,255,0.84),rgba(255,255,255,0.7))] px-5 py-5 shadow-[0_20px_56px_rgba(148,163,184,0.12)] backdrop-blur-md sm:px-6 sm:py-6"> <ReviewSection
<div className="flex flex-wrap items-start justify-between gap-4"> title={review.startQuality.title}
<div className="max-w-3xl"> summary={review.startQuality.summary}
<p className="text-[11px] font-medium tracking-[0.14em] text-brand-dark/42"> metrics={review.startQuality.metrics}
{source === 'api' ? stats.sourceApi : stats.sourceMock} availability={review.startQuality.availability}
</p> note={review.startQuality.note}
<p className="mt-3 text-[1.55rem] font-semibold leading-[1.3] tracking-tight text-brand-dark sm:text-[1.9rem]"> accentClass="bg-[radial-gradient(circle_at_top_left,rgba(96,165,250,0.34),rgba(96,165,250,0)_62%)]"
{review.snapshotSummary} />
</p>
<p className="mt-3 text-[13px] leading-[1.6] text-brand-dark/54"> <ReviewSection
{error ? error : isLoading ? stats.loading : stats.synced} title={review.recoveryQuality.title}
</p> summary={review.recoveryQuality.summary}
metrics={review.recoveryQuality.metrics}
availability={review.recoveryQuality.availability}
note={review.recoveryQuality.note}
accentClass="bg-[radial-gradient(circle_at_top_left,rgba(20,184,166,0.32),rgba(20,184,166,0)_62%)]"
/>
</section>
<section className="mt-5 grid gap-5 xl:grid-cols-[0.94fr_1.06fr]">
<ReviewSection
title={review.completionQuality.title}
summary={review.completionQuality.summary}
metrics={review.completionQuality.metrics}
availability={review.completionQuality.availability}
note={review.completionQuality.note}
accentClass="bg-[radial-gradient(circle_at_top_left,rgba(245,158,11,0.34),rgba(245,158,11,0)_62%)]"
/>
<section className={cn(glassPanelClass, 'relative overflow-hidden p-6 sm:p-7')}>
<div className="pointer-events-none absolute inset-x-0 top-0 h-24 bg-[radial-gradient(circle_at_top_left,rgba(168,85,247,0.32),rgba(168,85,247,0)_62%)]" />
<div className="relative">
<div className="flex flex-wrap items-start justify-between gap-4">
<div className="max-w-[34rem]">
<p className="text-[10px] font-medium uppercase tracking-[0.2em] text-white/40">
Carry Forward
</p>
<h2 className="mt-3 text-[1.45rem] font-medium tracking-[-0.04em] text-white md:text-[1.8rem]">
다음 세션에 그대로 가져갈 흐름
</h2>
<p className="mt-3 text-[14px] leading-[1.7] text-white/64">
{review.carryForward.keepDoing}
</p>
</div>
{isPro ? <StatusAccessory label="Recommended Ritual" subtle /> : null}
</div> </div>
<div className="grid w-full gap-3 sm:grid-cols-2 xl:w-[26rem]"> <div className="mt-6 grid gap-4 lg:grid-cols-[minmax(0,1fr)_minmax(15rem,0.78fr)]">
{review.snapshotMetrics.map((metric) => ( <div className={metricTileClass}>
<ReviewMetric <p className="text-[10px] font-medium uppercase tracking-[0.18em] text-white/42">
key={metric.id} 다음 주에 바꿔볼 것
label={metric.label} </p>
value={metric.value} <p className="mt-3 text-[14px] leading-[1.7] text-white/72">
hint={metric.hint}
/>
))}
</div>
</div>
</section>
<div className="grid gap-5 xl:grid-cols-[1.08fr_0.92fr]">
<ReviewSection
title={review.startQuality.title}
summary={review.startQuality.summary}
metrics={review.startQuality.metrics}
availability={review.startQuality.availability}
note={review.startQuality.note}
toneClass="bg-[linear-gradient(90deg,rgba(96,165,250,0.68),rgba(191,219,254,0.22))]"
/>
<ReviewSection
title={review.recoveryQuality.title}
summary={review.recoveryQuality.summary}
metrics={review.recoveryQuality.metrics}
availability={review.recoveryQuality.availability}
note={review.recoveryQuality.note}
toneClass="bg-[linear-gradient(90deg,rgba(20,184,166,0.68),rgba(153,246,228,0.22))]"
/>
</div>
<div className="grid gap-5 xl:grid-cols-[1fr_0.88fr]">
<ReviewSection
title={review.completionQuality.title}
summary={review.completionQuality.summary}
metrics={review.completionQuality.metrics}
availability={review.completionQuality.availability}
note={review.completionQuality.note}
toneClass="bg-[linear-gradient(90deg,rgba(251,191,36,0.72),rgba(253,230,138,0.22))]"
/>
<section className="overflow-hidden rounded-[28px] border border-brand-dark/10 bg-white/78 backdrop-blur-md">
<div className="h-1.5 w-full bg-[linear-gradient(90deg,rgba(139,92,246,0.72),rgba(221,214,254,0.2))]" />
<div className="px-5 py-5 sm:px-6">
<p className="text-[11px] font-medium tracking-[0.14em] text-brand-dark/42">
{review.periodLabel}
</p>
<h2 className="mt-2 text-[1.05rem] font-semibold tracking-tight text-brand-dark">
{stats.reviewCarryKeepTitle}
</h2>
<p className="mt-2 text-[14px] leading-[1.65] text-brand-dark/68">
{review.carryForward.keepDoing}
</p>
<div className="mt-5 border-t border-brand-dark/8 pt-5">
<h3 className="text-[1.02rem] font-semibold tracking-tight text-brand-dark">
{stats.reviewCarryTryTitle}
</h3>
<p className="mt-2 text-[14px] leading-[1.65] text-brand-dark/68">
{review.carryForward.tryNext} {review.carryForward.tryNext}
</p> </p>
</div> </div>
{isPro ? ( <div className={metricTileClass}>
<div className="mt-5 rounded-2xl border border-brand-dark/8 bg-white/56 px-4 py-3"> <p className="text-[10px] font-medium uppercase tracking-[0.18em] text-white/42">
<p className="text-[11px] font-medium tracking-[0.08em] text-brand-dark/42"> Atmosphere
{stats.reviewCarryPresetLabel} </p>
</p> <p className="mt-3 text-[14px] font-medium tracking-[-0.03em] text-white/88">
<p className="mt-2 text-[13px] font-medium text-brand-dark/82"> {review.carryForward.presetLabel}
{review.carryForward.presetLabel} </p>
</p> <p className="mt-2 text-[12px] leading-[1.58] text-white/52">
</div> 지금 가장 무리 없이 다시 들어갈 수 있는 기본 흐름입니다.
) : null} </p>
</div>
</div>
<div className="mt-6 flex flex-wrap items-center justify-between gap-4 border-t border-white/10 pt-5">
<p className="max-w-[30rem] text-[12px] leading-[1.65] text-white/44">
review는 지난 시간을 요약하는 화면이 아니라, 다음 세션을 더 가볍게 열기 위한
출발점입니다.
</p>
<Link <Link
href={review.carryForward.ctaHref} href={review.carryForward.ctaHref}
className="mt-6 inline-flex rounded-full border border-brand-dark/14 bg-brand-dark px-4 py-2.5 text-[12px] font-medium tracking-[0.04em] text-white transition hover:bg-brand-dark/92" className="inline-flex min-h-[3.4rem] items-center justify-center rounded-full border border-white/14 bg-white/[0.14] px-6 text-[13px] font-medium tracking-[0.02em] text-white shadow-[0_12px_28px_rgba(3,7,18,0.22)] backdrop-blur-md transition hover:bg-white/[0.18] active:scale-[0.99]"
> >
{carryForwardCtaLabel} {carryForwardCtaLabel}
</Link> </Link>
</div> </div>
</section> </div>
</div> </section>
</div> </section>
</div> </main>
</div> </div>
); );
}; };