v0.1.31 - 집중 시간 한글 표기와 통계 문구 정리

v0.1.30 - 태블릿과 모바일용 내비게이션 드로어 정리
v0.1.29 - 반응형 우측 패널 오버레이와 2페이지 보기 배율 조정
2026-04-22 16:42:25 +09:00 · 2026-04-22 16:30:21 +09:00 · 2026-04-22 15:43:41 +09:00 · 2026-04-22 12:10:21 +09:00 · 2026-04-22 11:33:17 +09:00 · 2026-04-22 11:25:09 +09:00
13 changed files with 593 additions and 189 deletions
--- a/HANDOFF.md
+++ b/HANDOFF.md
@@ -4,7 +4,7 @@

 - 프로젝트명: 10 Minute Planner 웹 UI
 - 기술 스택: Vue 3 + Vite + TailwindCSS + JavaScript
- 현재 기준 버전: `v0.1.21` 준비 중
+- 현재 기준 버전: `v0.1.31` 준비 중
 - Git 원격 저장소: `https://git.sori.studio/zenn/planner.sori.studio.git`

 ## 기준 디자인
@@ -37,6 +37,7 @@
 - 프론트 Dockerfile: `Dockerfile`
 - 백엔드 Dockerfile: `backend/Dockerfile`
 - nginx 프록시 설정: `deploy/nginx/default.conf`
+- 실행 가이드 문서: `README.md`
 - Tailwind 설정은 완료되어 있으며, 이 프로젝트의 스타일링 기준으로 유지한다.
 - 현재 선택 날짜는 시스템 날짜 기준으로 시작한다.
 - `COMMENT`, `TASKS`, `MEMO`는 화면에서 바로 편집할 수 있다.
@@ -155,6 +156,27 @@
 - `planner_entries.payload`는 문자열이 아니라 PostgreSQL `JSONB`로 저장되도록 바뀌었다.
 - `docker-compose.yml` 기준으로 `postgres`, `backend`, `frontend(nginx)` 3개 서비스 초안이 추가되었다.
 - 프론트는 nginx에서 `/api`를 백엔드로 프록시하는 구조라서, 배포 시 브라우저가 별도 API 포트를 직접 알 필요가 없다.
+- 프론트 API 클라이언트는 `VITE_API_BASE_URL` 끝에 `/api`가 포함되어 있어도 `/api/api/...` 중복 주소가 생기지 않도록 정규화한다.
+- 로그인 실패 시에는 내부 라우트 문자열이나 서버 경로를 그대로 노출하지 않고, 사용자용 안내 문구만 보여준다.
+- 비로그인 상태에서는 왼쪽 사이드 내비게이션을 숨기고, 중앙 로그인 안내 화면만 보여주도록 정리했다.
+- 배포용 `docker-compose.yml`과 별도로 개발용 `docker-compose.dev.yml`을 추가했다.
+- 개발용 compose는 프론트 `5173`, 백엔드 `3001`, PostgreSQL `5432`를 열고, 소스 마운트 + Vite HMR + Node watch 기반으로 자동 반영된다.
+- 개발/배포 실행 방법은 루트 `README.md`에 먼저 적고, `HANDOFF.md`에는 변경 이유와 주의사항 위주로 남긴다.
+- API 클라이언트는 body가 없는 `GET`, `DELETE` 요청에 `Content-Type: application/json`을 붙이지 않도록 수정했다. 날짜 선택 시 발생하던 `Body cannot be empty...` 오류는 이 문제였다.
+- 날짜 이동 중 목표 자동 보정으로 `goalEnabled`만 꺼지는 경우에는, 실제 내용이 없는 기록이라면 클라우드 동기화 토스트를 띄우지 않도록 정리했다.
+- 집중 보기에서 오른쪽 패널 폭을 넓혀 `1920x1080` 기준 활용도를 높였고, `TASK LABELS / D-DAY / CALENDAR`는 상단 고정 영역으로 올렸다.
+- `STATS`와 `NEXT DAY`는 반반 카드가 아니라 각각 한 줄씩 쓰도록 바꿔서 날짜 길이에 따라 높이가 흔들리는 문제를 줄였다.
+- 미니 달력은 42칸 기준으로 렌더링하고, 요일 헤더를 `SUN ~ SAT` 순서로 고정해서 일요일 시작 달력 기준을 더 명확하게 맞췄다.
+- 집중 보기 오른쪽 패널은 다시 정리해서 `왼쪽 컬럼: CALENDAR / TASK LABELS / D-DAY`, `오른쪽 컬럼: STATS / NEXT DAY`, `하단 전체 폭: READ NEXT / PREV SNAPSHOT` 구조로 맞췄다.
+- 달력은 과하게 키우지 않고 컴팩트한 크기를 유지한 채, 우측 정보 패널 내부 배치만 다시 조정하는 쪽으로 방향을 잡았다.
+- `PRINT 2-UP`은 브라우저/프린터 기본 여백 차이로 오른쪽 페이지가 잘릴 수 있어서, 프레임 폭과 스케일을 조금 더 보수적으로 줄여 안정성을 높였다.
+- 플래너 집중 보기 반응형 기준은 `1620px 이상: 우측 패널 2열`, `1280px 이상 ~ 1619px 이하: 우측 패널 1열 + 최대 360px`, `1280px 미만: 우측 패널 오버레이` 구조로 다시 정리했다.
+- 오버레이 구간에서는 본문 오른쪽 위의 `OPEN SIDE PANEL` 버튼으로 패널을 열고, 배경 클릭이나 `CLOSE` 버튼으로 닫는다.
+- `2 PAGE SPREAD`는 화면 폭을 기준으로 배율을 자동 계산해서 오른쪽 페이지가 잘리는 현상을 줄이는 방향으로 조정했다.
+- `1280px` 미만에서는 왼쪽 내비게이션도 본문 위에 쌓이지 않고 `MENU` 버튼으로 여는 드로어형 패널로 전환된다.
+- 태블릿/모바일 구간에서는 `왼쪽 내비게이션 드로어 + 오른쪽 정보 패널 오버레이 + 본문 단일 컬럼` 조합으로 보는 흐름을 기본값으로 삼는다.
+- 통계 화면과 우측 `FOCUSED TIME` 요약처럼 사용자에게 보여주는 집중 시간 표기는 `00H 00M` 대신 `00시간 00분` 한글 형식으로 바꿨다.
+- 비로그인 랜딩 카드는 상단 고정이 아니라 화면 중앙에 오도록 정렬을 수정했다.
 - 현재 환경에서는 Docker 데몬이 꺼져 있어서 `docker compose build` 실검증은 하지 못했고, 데몬 시작 후 다시 확인이 필요하다.
 - 이미지 저장 기능은 추후 `print-only` 또는 별도 export 전용 레이아웃을 기준으로 구현하면 화면/인쇄/공유 결과를 맞추기 쉽다.
 - Docker Compose는 프론트엔드와 백엔드를 함께 올리는 기준으로 설계하되, NAS 환경에 맞는 볼륨과 재시작 정책도 함께 고려한다.
--- a/README.md
+++ b/README.md
@@ -0,0 +1,57 @@
+# 10 Minute Planner
+
+Vue 3 + TailwindCSS + Fastify + PostgreSQL 기반의 `10분 플래너 다이어리` 프로젝트다.
+
+## 실행 방법
+
+### 개발용
+
+코드를 수정하면서 자동 새로고침까지 보려면 개발용 compose를 사용한다.
+
+```bash
+docker compose -f docker-compose.dev.yml up
+```
+
+개발용 포트:
+
+- 프론트엔드: `http://localhost:5173`
+- 백엔드 API: `http://localhost:3001`
+- PostgreSQL: `localhost:5432`
+
+개발용 특징:
+
+- 프론트는 Vite HMR로 저장 즉시 화면이 반영된다.
+- 백엔드는 `node --watch`로 파일 변경 시 자동 재시작된다.
+- 즉, 개발 중에는 매번 새로 빌드할 필요 없이 `docker compose -f docker-compose.dev.yml up`만 켜두면 된다.
+
+### 배포용
+
+실서비스나 최종 확인용으로는 배포용 compose를 사용한다.
+
+```bash
+docker compose up -d --build
+```
+
+배포용 포트:
+
+- 프론트엔드: `http://localhost:8080`
+- PostgreSQL: `localhost:5432`
+
+배포용 특징:
+
+- 프론트는 빌드 결과물을 nginx로 서빙한다.
+- 브라우저에서는 `/api` 경로로 백엔드에 접근한다.
+- 수정 사항 반영 시에는 다시 빌드가 필요하다.
+
+## 문서
+
+- 작업 규칙: [`AGENTS.md`](./AGENTS.md)
+- 진행 상태 / 체크리스트: [`TODO.md`](./TODO.md)
+- 인수인계 메모: [`HANDOFF.md`](./HANDOFF.md)
+
+## 현재 방향
+
+- 기본 UX는 `1페이지 + 우측 정보 패널`
+- 보조 모드는 `2페이지 펼침 보기`
+- 스타일링은 Vue + TailwindCSS
+- 장기적으로는 Docker 기반으로 UGREEN NAS 배포 예정
--- a/docker-compose.dev.yml
+++ b/docker-compose.dev.yml
@@ -0,0 +1,61 @@
+services:
+  postgres:
+    image: postgres:16-alpine
+    container_name: ten-minute-postgres-dev
+    environment:
+      POSTGRES_DB: ten_minute_planner
+      POSTGRES_USER: planner
+      POSTGRES_PASSWORD: planner1234
+    volumes:
+      - postgres_dev_data:/var/lib/postgresql/data
+    ports:
+      - "5432:5432"
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U planner -d ten_minute_planner"]
+      interval: 10s
+      timeout: 5s
+      retries: 10
+    restart: unless-stopped
+
+  backend:
+    image: node:22-alpine
+    container_name: ten-minute-backend-dev
+    working_dir: /app
+    command: sh -c "npm install && npm run dev"
+    environment:
+      PORT: 3001
+      DATABASE_URL: postgresql://planner:planner1234@postgres:5432/ten_minute_planner
+      CORS_ORIGIN: http://localhost:5173
+      SESSION_TTL_DAYS: 30
+    volumes:
+      - ./backend:/app
+      - backend_node_modules:/app/node_modules
+    depends_on:
+      postgres:
+        condition: service_healthy
+    ports:
+      - "3001:3001"
+    restart: unless-stopped
+
+  frontend:
+    image: node:22-alpine
+    container_name: ten-minute-frontend-dev
+    working_dir: /app
+    command: sh -c "npm install && npm run dev"
+    environment:
+      VITE_API_BASE_URL: http://localhost:3001
+      CHOKIDAR_USEPOLLING: "true"
+    volumes:
+      - .:/app
+      - /app/backend
+      - frontend_node_modules:/app/node_modules
+    depends_on:
+      - backend
+    ports:
+      - "5173:5173"
+    restart: unless-stopped
+
+volumes:
+  postgres_dev_data:
+  backend_node_modules:
+  frontend_node_modules:
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
  "name": "ten-minute-planner",
-  "version": "0.1.21",
+  "version": "0.1.31",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "ten-minute-planner",
-      "version": "0.1.21",
+      "version": "0.1.31",
      "dependencies": {
        "vue": "^3.5.13"
      },
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
  "name": "ten-minute-planner",
  "private": true,
-  "version": "0.1.21",
+  "version": "0.1.31",
  "type": "module",
  "scripts": {
    "dev": "vite",
--- a/src/App.vue
+++ b/src/App.vue
@@ -1,5 +1,5 @@
 <script setup>
-import { computed, onMounted, reactive, ref, watch, nextTick } from 'vue'
+import { computed, nextTick, onBeforeUnmount, onMounted, reactive, ref, watch } from 'vue'
 import AuthDialog from './components/AuthDialog.vue'
 import GoalsDashboard from './components/GoalsDashboard.vue'
 import MiniCalendar from './components/MiniCalendar.vue'
@@ -16,6 +16,7 @@ import {
  updatePassword,
  updateProfile,
 } from './lib/authClient'
+import { toUserFacingApiError } from './lib/apiBase'
 import { createGoal, deleteGoal, fetchGoals, updateGoal } from './lib/goalsApi'
 import { deletePlannerEntry, fetchPlannerEntries, savePlannerEntry } from './lib/plannerApi'
 import {
@@ -44,6 +45,9 @@ const syncMessage = ref('')
 const syncToastVisible = ref(false)
 const selectedDate = ref(new Date())
 const calendarViewDate = ref(new Date(selectedDate.value))
+const windowWidth = ref(typeof window === 'undefined' ? 1920 : window.innerWidth)
+const leftPanelOpen = ref(false)
+const rightPanelOpen = ref(false)
 const statsRangeStart = ref(toKey(new Date(new Date().setDate(new Date().getDate() - 6))))
 const statsRangeEnd = ref(toKey(new Date()))
 const authForm = reactive({
@@ -313,7 +317,7 @@ const calendarDays = computed(() => {
  const start = new Date(first)
  start.setDate(first.getDate() - first.getDay())

-  return Array.from({ length: 35 }, (_, index) => {
+  return Array.from({ length: 42 }, (_, index) => {
    const date = new Date(start)
    date.setDate(start.getDate() + index)
    return {
@@ -400,6 +404,16 @@ function formatTotalTime(record) {
  return `${hoursPart}H ${minutesPart}M`
 }

+function formatMinutesKorean(totalMinutes) {
+  const hoursPart = `${Math.floor(totalMinutes / 60)}`.padStart(2, '0')
+  const minutesPart = `${totalMinutes % 60}`.padStart(2, '0')
+  return `${hoursPart}시간 ${minutesPart}분`
+}
+
+function formatTotalTimeKorean(record) {
+  return formatMinutesKorean(record.timetable.filter(Boolean).length * 10)
+}
+
 function getFocusedMinutes(record) {
  return record.timetable.filter(Boolean).length * 10
 }
@@ -545,7 +559,7 @@ const aggregateCompletionRate = computed(() => {
 const overviewCards = computed(() => [
  {
    label: 'TOTAL FOCUSED',
-    value: formatMinutes(totalFocusedMinutes.value),
+    value: formatMinutesKorean(totalFocusedMinutes.value),
    caption: '지금까지 기록된 전체 집중 시간',
  },
  {
@@ -587,7 +601,7 @@ const weeklyRecords = computed(() => {
      key,
      weekday: weekdayShort,
      focusedMinutes,
-      focusedTime: formatMinutes(focusedMinutes),
+      focusedTime: formatMinutesKorean(focusedMinutes),
    }
  })

@@ -611,7 +625,7 @@ const recentRecords = computed(() =>
      key,
      dateLabel: createDateLabel(key),
      comment: record.comment.trim(),
-      focusedTime: formatTotalTime(record),
+      focusedTime: formatTotalTimeKorean(record),
      completionRate: getCompletionRate(record),
    })),
 )
@@ -630,7 +644,7 @@ const bestDay = computed(() => {

  return {
    dateLabel: createDateLabel(bestKey),
-    summary: `${formatTotalTime(bestRecord)} 집중, 완료율 ${getCompletionRate(bestRecord)}%, 코멘트 "${
+    summary: `${formatTotalTimeKorean(bestRecord)} 집중, 완료율 ${getCompletionRate(bestRecord)}%, 코멘트 "${
      bestRecord.comment.trim() || '없음'
    }"`,
  }
@@ -660,7 +674,7 @@ const prevSnapshotItems = computed(() => {

  return [
    `${createDateLabel(entryKey)} 기록`,
-    `${formatTotalTime(entryRecord)} 집중 / 완료 ${completedCount}개`,
+    `${formatTotalTimeKorean(entryRecord)} 집중 / 완료 ${completedCount}개`,
    previousComment || (previousTopTask ? `주요 작업: ${previousTopTask.title}` : '남겨진 코멘트 없음'),
  ]
 })
@@ -686,6 +700,52 @@ const readNextItems = computed(() => {
  ]
 })

+const isWideFocusSidebar = computed(() => windowWidth.value >= 1620)
+const isOverlayFocusSidebar = computed(() => windowWidth.value < 1280)
+const showInlineLeftSidebar = computed(() => windowWidth.value >= 1280)
+const isCompactMobile = computed(() => windowWidth.value < 800)
+const showInlineFocusSidebar = computed(() => !isOverlayFocusSidebar.value)
+const focusSidebarOuterClass = computed(() =>
+  showInlineFocusSidebar.value
+    ? isWideFocusSidebar.value
+      ? 'xl:w-[640px]'
+      : 'xl:w-full xl:max-w-[360px]'
+    : '',
+)
+const focusSidebarGridClass = computed(() =>
+  isWideFocusSidebar.value
+    ? '2xl:grid-cols-[280px_minmax(0,1fr)] 2xl:items-start'
+    : 'grid-cols-1',
+)
+const spreadScale = computed(() => {
+  const reservedWidth = windowWidth.value >= 1280 ? 410 : 96
+  const availableWidth = Math.max(windowWidth.value - reservedWidth, 980)
+  const baseWidth = 1548
+  const nextScale = Math.min(1, availableWidth / baseWidth)
+
+  return Number(Math.max(nextScale, 0.86).toFixed(3))
+})
+const spreadCanvasStyle = computed(() => {
+  const scale = spreadScale.value
+  return {
+    width: `${1548 * scale}px`,
+    minWidth: `${1548 * scale}px`,
+  }
+})
+const spreadPageFrameStyle = computed(() => {
+  const scale = spreadScale.value
+  return {
+    width: `${762 * scale}px`,
+    height: `${1118 * scale}px`,
+  }
+})
+const spreadPageStyle = computed(() => ({
+  width: '762px',
+  maxWidth: 'none',
+  transform: `scale(${spreadScale.value})`,
+  transformOrigin: 'top left',
+}))
+
 watch(
  [plannerRecords, selectedDate, calendarViewDate, statsRangeStart, statsRangeEnd],
  () => {
@@ -706,7 +766,10 @@ watch(
  () => {
    if (!plannerGoal.value && planner.value.goalEnabled) {
      planner.value.goalEnabled = false
-      schedulePlannerSyncForRecord(planner.value)
+
+      if (hasPlannerContent(planner.value)) {
+        schedulePlannerSyncForRecord(planner.value)
+      }
    }
  },
 )
@@ -729,6 +792,41 @@ function areTaskLabelsNumbered(record) {
  return record.tasks.every((task, index) => task.label === createTaskLabel(index))
 }

+function updateWindowWidth() {
+  windowWidth.value = window.innerWidth
+
+  if (windowWidth.value >= 1280) {
+    leftPanelOpen.value = false
+    rightPanelOpen.value = false
+  }
+}
+
+function openLeftPanel() {
+  leftPanelOpen.value = true
+}
+
+function closeLeftPanel() {
+  leftPanelOpen.value = false
+}
+
+function openRightPanel() {
+  rightPanelOpen.value = true
+}
+
+function closeRightPanel() {
+  rightPanelOpen.value = false
+}
+
+function setScreenMode(mode) {
+  screenMode.value = mode
+  closeLeftPanel()
+}
+
+function setViewMode(mode) {
+  viewMode.value = mode
+  closeLeftPanel()
+}
+
 function setSyncFeedback(status, message, options = {}) {
  const {
    visible = true,
@@ -849,7 +947,7 @@ async function submitAuthForm() {

    await applyAuthSuccess(result)
  } catch (error) {
-    authMessage.value = error.message || '인증 처리 중 문제가 발생했습니다.'
+    authMessage.value = toUserFacingApiError(error, '인증 처리 중 문제가 발생했습니다.')
  } finally {
    authBusy.value = false
  }
@@ -1290,15 +1388,73 @@ onMounted(() => {
  setSyncFeedback('local', '로그인 후 클라우드 저장을 사용할 수 있습니다.', {
    visible: false,
  })
+  updateWindowWidth()
+  window.addEventListener('resize', updateWindowWidth)
  restoreAuthSession()
 })
+
+onBeforeUnmount(() => {
+  window.removeEventListener('resize', updateWindowWidth)
+})
 </script>

 <template>
  <main class="min-h-screen px-4 py-6 text-ink sm:px-6 lg:px-10 xl:h-screen xl:overflow-hidden">
-    <div class="print-root mx-auto flex max-w-[1760px] flex-col gap-6 xl:h-[calc(100vh-3rem)] xl:grid xl:grid-cols-[300px_minmax(0,1fr)] xl:items-start">
-      <aside class="scrollbar-hide print-hidden rounded-[28px] border border-white/60 bg-white/70 p-5 backdrop-blur sm:p-6 xl:h-full xl:overflow-y-auto">
+    <div
+      class="print-root mx-auto flex max-w-[1760px] flex-col gap-6"
+      :class="isAuthenticated ? 'xl:h-[calc(100vh-3rem)] xl:grid xl:grid-cols-[300px_minmax(0,1fr)] xl:items-start' : 'min-h-[calc(100vh-3rem)] items-center justify-center'"
+    >
+      <section
+        v-if="isAuthenticated && !showInlineLeftSidebar"
+        class="print-hidden rounded-[28px] border border-white/60 bg-white/78 p-4 shadow-[0_18px_60px_rgba(28,25,23,0.08)] backdrop-blur"
+      >
+        <div class="flex items-start justify-between gap-4">
+          <div>
+            <p class="text-[10px] font-bold uppercase tracking-[0.22em] text-stone-500">10 Minute Planner</p>
+            <p class="mt-2 text-lg font-semibold tracking-[-0.04em] text-stone-900">
+              {{ screenMode.toUpperCase() }}
+            </p>
+            <p class="mt-1 text-[11px] font-semibold text-stone-500">
+              {{ currentUser?.nickname }} 님의 플래너
+            </p>
+          </div>
+          <button
+            type="button"
+            class="rounded-full border border-stone-200 bg-white px-4 py-2 text-[11px] font-bold tracking-[0.16em] text-stone-700 transition hover:border-stone-400 hover:text-ink"
+            @click="openLeftPanel"
+          >
+            MENU
+          </button>
+        </div>
+      </section>
+
+      <div
+        v-if="isAuthenticated && !showInlineLeftSidebar && leftPanelOpen"
+        class="fixed inset-0 z-40 bg-stone-900/22 backdrop-blur-[2px]"
+        @click="closeLeftPanel"
+      />
+
+      <aside
+        v-if="isAuthenticated"
+        class="scrollbar-hide print-hidden rounded-[28px] border border-white/60 bg-white/70 p-5 backdrop-blur sm:p-6"
+        :class="showInlineLeftSidebar ? 'xl:h-full xl:overflow-y-auto' : 'fixed inset-y-4 left-4 z-50 w-[min(360px,calc(100vw-2rem))] overflow-y-auto shadow-[0_18px_60px_rgba(28,25,23,0.14)]'"
+        v-show="showInlineLeftSidebar || leftPanelOpen"
+      >
        <div class="space-y-6">
+          <div v-if="!showInlineLeftSidebar" class="flex items-center justify-between rounded-[20px] border border-stone-200 bg-white/85 px-4 py-3">
+            <div>
+              <p class="text-[10px] font-bold uppercase tracking-[0.2em] text-stone-500">Navigation</p>
+              <p class="mt-1 text-sm font-semibold text-stone-900">{{ currentUser?.nickname }}</p>
+            </div>
+            <button
+              type="button"
+              class="rounded-full border border-stone-200 px-3 py-1 text-[10px] font-bold tracking-[0.14em] text-stone-600 transition hover:border-stone-400 hover:text-ink"
+              @click="closeLeftPanel"
+            >
+              CLOSE
+            </button>
+          </div>
+
          <div class="space-y-2">
            <p class="text-[11px] font-bold uppercase tracking-[0.28em] text-stone-500">10 Minute Planner</p>
            <h1 class="text-2xl font-semibold tracking-[-0.04em] text-stone-900">
@@ -1353,7 +1509,7 @@ onMounted(() => {
                type="button"
                class="rounded-[20px] border px-4 py-4 text-left transition"
                :class="screenMode === 'planner' ? 'border-stone-900 bg-stone-900 text-white shadow-[0_12px_24px_rgba(28,25,23,0.18)]' : 'border-stone-200 bg-white text-stone-700 hover:border-stone-400'"
-                @click="screenMode = 'planner'"
+                @click="setScreenMode('planner')"
              >
                <p class="text-xs font-bold tracking-[0.18em]">PLANNER</p>
                <p class="mt-1 text-[11px] font-semibold tracking-[0.04em]" :class="screenMode === 'planner' ? 'text-stone-200' : 'text-stone-500'">오늘 문서 작성과 캘린더 이동</p>
@@ -1362,7 +1518,7 @@ onMounted(() => {
                type="button"
                class="rounded-[20px] border px-4 py-4 text-left transition"
                :class="screenMode === 'stats' ? 'border-stone-900 bg-stone-900 text-white shadow-[0_12px_24px_rgba(28,25,23,0.18)]' : 'border-stone-200 bg-white text-stone-700 hover:border-stone-400'"
-                @click="screenMode = 'stats'"
+                @click="setScreenMode('stats')"
              >
                <p class="text-xs font-bold tracking-[0.18em]">STATS</p>
                <p class="mt-1 text-[11px] font-semibold tracking-[0.04em]" :class="screenMode === 'stats' ? 'text-stone-200' : 'text-stone-500'">기간별 집중 시간과 완료율</p>
@@ -1371,7 +1527,7 @@ onMounted(() => {
                type="button"
                class="rounded-[20px] border px-4 py-4 text-left transition"
                :class="screenMode === 'goals' ? 'border-stone-900 bg-stone-900 text-white shadow-[0_12px_24px_rgba(28,25,23,0.18)]' : 'border-stone-200 bg-white text-stone-700 hover:border-stone-400'"
-                @click="screenMode = 'goals'"
+                @click="setScreenMode('goals')"
              >
                <p class="text-xs font-bold tracking-[0.18em]">GOALS</p>
                <p class="mt-1 text-[11px] font-semibold tracking-[0.04em]" :class="screenMode === 'goals' ? 'text-stone-200' : 'text-stone-500'">D-DAY 목표와 표시 기간 관리</p>
@@ -1380,7 +1536,7 @@ onMounted(() => {
                type="button"
                class="rounded-[20px] border px-4 py-4 text-left transition"
                :class="screenMode === 'settings' ? 'border-stone-900 bg-stone-900 text-white shadow-[0_12px_24px_rgba(28,25,23,0.18)]' : 'border-stone-200 bg-white text-stone-700 hover:border-stone-400'"
-                @click="screenMode = 'settings'"
+                @click="setScreenMode('settings')"
              >
                <p class="text-xs font-bold tracking-[0.18em]">SETTINGS</p>
                <p class="mt-1 text-[11px] font-semibold tracking-[0.04em]" :class="screenMode === 'settings' ? 'text-stone-200' : 'text-stone-500'">계정 정보와 비밀번호 수정</p>
@@ -1395,7 +1551,7 @@ onMounted(() => {
                type="button"
                class="rounded-2xl px-4 py-3 text-xs font-bold tracking-[0.14em] transition"
                :class="viewMode === 'focus' ? 'bg-stone-900 text-white' : 'bg-stone-100 text-stone-500'"
-                @click="viewMode = 'focus'"
+                @click="setViewMode('focus')"
              >
                1 PAGE + INFO
              </button>
@@ -1403,7 +1559,7 @@ onMounted(() => {
                type="button"
                class="rounded-2xl px-4 py-3 text-xs font-bold tracking-[0.14em] transition"
                :class="viewMode === 'spread' ? 'bg-stone-900 text-white' : 'bg-stone-100 text-stone-500'"
-                @click="viewMode = 'spread'"
+                @click="setViewMode('spread')"
              >
                2 PAGE SPREAD
              </button>
@@ -1452,10 +1608,10 @@ onMounted(() => {
        </div>
      </aside>

-      <div class="min-w-0 space-y-6 xl:h-full xl:overflow-hidden">
+      <div class="min-w-0 space-y-6" :class="isAuthenticated ? 'xl:h-full xl:overflow-hidden' : 'w-full'">
      <section
        v-if="!isAuthenticated"
-        class="scrollbar-hide print-hidden rounded-[28px] border border-white/60 bg-white/65 p-6 shadow-[0_24px_80px_rgba(28,25,23,0.08)] sm:p-8 xl:h-full xl:overflow-y-auto"
+        class="scrollbar-hide print-hidden mx-auto w-full max-w-4xl rounded-[28px] border border-white/60 bg-white/65 p-6 shadow-[0_24px_80px_rgba(28,25,23,0.08)] sm:p-8"
      >
        <div class="mx-auto flex max-w-3xl flex-col gap-6 text-center">
          <div class="space-y-3">
@@ -1512,9 +1668,25 @@ onMounted(() => {

      <section
        v-else-if="screenMode === 'planner' && viewMode === 'focus'"
-        class="print-hidden grid gap-6 xl:h-full xl:min-h-0 xl:grid-cols-[minmax(0,1fr)_340px]"
+        class="print-hidden relative grid gap-6 xl:h-full xl:min-h-0"
+        :class="showInlineFocusSidebar ? 'xl:grid-cols-[minmax(0,1fr)_minmax(0,360px)] 2xl:grid-cols-[minmax(0,1fr)_640px]' : ''"
      >
+        <div
+          v-if="isOverlayFocusSidebar && rightPanelOpen"
+          class="fixed inset-0 z-30 bg-stone-900/18 backdrop-blur-[2px]"
+          @click="closeRightPanel"
+        />
+
        <div class="scrollbar-hide print-target rounded-[28px] border border-white/60 bg-white/45 p-4 shadow-[0_18px_60px_rgba(28,25,23,0.06)] xl:h-full xl:min-h-0 xl:overflow-y-auto xl:pr-3">
+          <div v-if="isOverlayFocusSidebar" class="mb-4 flex justify-end">
+            <button
+              type="button"
+              class="rounded-full border border-stone-200 bg-white px-4 py-2 text-[11px] font-bold tracking-[0.16em] text-stone-700 transition hover:border-stone-400 hover:text-ink"
+              @click="openRightPanel"
+            >
+              OPEN SIDE PANEL
+            </button>
+          </div>
          <PlannerPage
            :date-main="selectedDateDisplay.main"
            :date-weekday="selectedDateDisplay.weekday"
@@ -1537,141 +1709,169 @@ onMounted(() => {
          />
        </div>

-        <aside class="scrollbar-hide print-hidden rounded-[28px] border border-white/60 bg-white/50 p-3 shadow-[0_18px_60px_rgba(28,25,23,0.06)] xl:h-full xl:min-h-0 xl:overflow-y-auto">
-          <div class="flex flex-col gap-4 rounded-[22px] p-2">
-          <section class="rounded-[24px] border border-stone-200 bg-white/82 p-5 shadow-[0_12px_36px_rgba(28,25,23,0.05)]">
-            <p class="mb-4 text-[11px] font-bold tracking-[0.22em] text-ink">PREV SNAPSHOT</p>
-            <div class="space-y-3">
-              <p
-                v-for="item in prevSnapshotItems"
-                :key="item"
-                class="border-b border-stone-200 pb-3 text-[11px] font-semibold tracking-[0.08em] text-stone-700 last:border-b-0 last:pb-0"
-              >
-                {{ item || ' ' }}
-              </p>
-            </div>
-          </section>
+        <aside
+          v-if="showInlineFocusSidebar || rightPanelOpen"
+          class="scrollbar-hide print-hidden rounded-[28px] border border-white/60 bg-[#f7f2ea]/95 p-3 shadow-[0_18px_60px_rgba(28,25,23,0.12)]"
+          :class="[
+            focusSidebarOuterClass,
+            showInlineFocusSidebar
+              ? 'xl:h-full xl:min-h-0 xl:overflow-y-auto'
+              : 'fixed inset-y-4 right-4 z-40 w-[min(360px,calc(100vw-2rem))] overflow-y-auto',
+          ]"
+        >
+          <div v-if="!showInlineFocusSidebar" class="mb-3 flex items-center justify-between rounded-[18px] border border-stone-200 bg-white/90 px-4 py-3">
+            <p class="text-[11px] font-bold tracking-[0.18em] text-ink">SIDE PANEL</p>
+            <button
+              type="button"
+              class="rounded-full border border-stone-200 px-3 py-1 text-[10px] font-bold tracking-[0.14em] text-stone-600 transition hover:border-stone-400 hover:text-ink"
+              @click="closeRightPanel"
+            >
+              CLOSE
+            </button>
+          </div>

-          <section class="rounded-[24px] border border-stone-200 bg-white/82 p-5 shadow-[0_12px_36px_rgba(28,25,23,0.05)]">
-            <div class="flex items-start justify-between gap-3">
-              <div>
-                <p class="text-[11px] font-bold tracking-[0.22em] text-ink">TASK LABELS</p>
-                <p class="mt-2 text-[11px] font-semibold leading-5 tracking-[0.06em] text-stone-600">
-                  ON이면 왼쪽 라벨을 01, 02 형태로 채우고 OFF이면 비워 둡니다.
-                </p>
-              </div>
-              <button
-                type="button"
-                class="relative h-8 w-16 shrink-0 rounded-full transition-colors duration-300 ease-out"
-                :class="areTaskLabelsNumbered(planner) ? 'bg-stone-900' : 'bg-stone-300'"
-                @click="areTaskLabelsNumbered(planner) ? clearTaskLabels(planner) : fillTaskLabelsWithNumbers(planner)"
-              >
-                <span
-                  class="absolute left-1 top-1 h-6 w-6 transform-gpu rounded-full bg-white shadow-sm transition-transform duration-300 ease-out will-change-transform"
-                  :class="areTaskLabelsNumbered(planner) ? 'translate-x-8' : 'translate-x-0'"
+          <div class="grid gap-4 rounded-[22px] p-2" :class="focusSidebarGridClass">
+            <div class="grid gap-4" :class="isWideFocusSidebar ? '' : 'max-w-[360px]'">
+              <section class="2xl:w-[280px]">
+                <MiniCalendar
+                  :month-label="monthLabel"
+                  :year-label="yearLabel"
+                  :days="calendarDays"
+                  :selected-key="toKey(selectedDate)"
+                  :marked-keys="markedDateKeys"
+                  @shift-month="shiftCalendarMonth"
+                  @shift-year="shiftCalendarYear"
+                  @go-today="selectDate(new Date())"
+                  @select="selectDate"
                />
-              </button>
-            </div>
-          </section>
+              </section>

-          <section class="rounded-[24px] border border-stone-200 bg-white/82 p-5 shadow-[0_12px_36px_rgba(28,25,23,0.05)]">
-            <p class="mb-4 text-[11px] font-bold tracking-[0.22em] text-ink">READ NEXT</p>
-            <div class="space-y-3">
-              <p
-                v-for="item in readNextItems"
-                :key="item"
-                class="border-b border-stone-200 pb-3 text-[11px] font-semibold tracking-[0.08em] text-stone-700 last:border-b-0 last:pb-0"
-              >
-                {{ item || ' ' }}
-              </p>
-            </div>
-          </section>
-
-          <section class="rounded-[24px] border border-stone-200 bg-white/82 p-5 shadow-[0_12px_36px_rgba(28,25,23,0.05)]">
-            <div class="flex items-start justify-between gap-3">
-              <div>
-                <p class="text-[11px] font-bold tracking-[0.22em] text-ink">D-DAY 사용</p>
-                <p class="mt-2 text-[11px] font-semibold leading-5 tracking-[0.06em] text-stone-600">
-                  목표 검색과 기간 설정은 GOALS 화면에서 관리하고, 여기서는 현재 날짜에 D-DAY를 보여줄지 여부만 제어합니다.
-                </p>
-              </div>
-              <button
-                type="button"
-                class="relative h-8 w-16 shrink-0 rounded-full transition-colors duration-300 ease-out disabled:cursor-not-allowed disabled:opacity-50"
-                :class="planner.goalEnabled ? 'bg-stone-900' : 'bg-stone-300'"
-                :disabled="!hasActiveGoalForSelectedDate"
-                @click="updateGoalEnabled(planner, !planner.goalEnabled)"
-              >
-                <span
-                  class="absolute left-1 top-1 h-6 w-6 transform-gpu rounded-full bg-white shadow-sm transition-transform duration-300 ease-out will-change-transform"
-                  :class="planner.goalEnabled ? 'translate-x-8' : 'translate-x-0'"
-                />
-              </button>
-            </div>
-
-            <div class="mt-4 space-y-3">
-              <div v-if="plannerGoal" class="rounded-2xl border border-stone-200 bg-white px-4 py-3">
-                <p class="text-[10px] font-bold tracking-[0.16em] text-stone-500">현재 목표</p>
-                <p class="mt-2 text-sm font-semibold tracking-[0.02em] text-stone-900">{{ plannerGoal.title }}</p>
-                <p class="mt-1 text-[11px] font-semibold tracking-[0.06em] text-stone-500">
-                  목표일 {{ plannerGoal.targetDate }} / 적용 {{ plannerGoal.activeFrom }} ~ {{ plannerGoal.activeUntil }}
-                </p>
-              </div>
-
-              <div v-if="plannerGoal" class="rounded-2xl border border-stone-200 bg-[#fbf7f0] px-4 py-4">
-                <p class="text-[11px] font-semibold leading-5 tracking-[0.06em] text-stone-600">
-                  이 날짜에는 이미 적용된 목표가 있으므로 토글만으로 표시 여부를 빠르게 조절할 수 있습니다.
-                </p>
-              </div>
-
-              <div v-else class="rounded-2xl border border-dashed border-stone-300 bg-white/70 px-4 py-4">
-                <p class="text-[11px] font-semibold leading-5 tracking-[0.06em] text-stone-500">
-                  현재 날짜에 적용된 목표가 없습니다. GOALS 화면에서 표시 기간을 지정하면 여기 토글이 자동으로 활성화됩니다.
-                </p>
-              </div>
-            </div>
-          </section>
-
-          <MiniCalendar
-            :month-label="monthLabel"
-            :year-label="yearLabel"
-            :days="calendarDays"
-            :selected-key="toKey(selectedDate)"
-            :marked-keys="markedDateKeys"
-            @shift-month="shiftCalendarMonth"
-            @shift-year="shiftCalendarYear"
-            @go-today="selectDate(new Date())"
-            @select="selectDate"
-          />
-
-          <section class="grid grid-cols-2 gap-4">
-            <article class="rounded-[24px] border border-stone-200 bg-white/82 p-5 shadow-[0_12px_36px_rgba(28,25,23,0.05)]">
-              <p class="text-[11px] font-bold tracking-[0.22em] text-ink">STATS</p>
-              <div class="mt-5 space-y-4">
-                <div>
-                  <p class="text-[28px] font-semibold tracking-[-0.05em] text-stone-900">{{ completionRate }}%</p>
-                  <p class="text-[11px] font-semibold tracking-[0.08em] text-stone-500">TASK COMPLETION</p>
+              <section class="rounded-[24px] border border-stone-200 bg-white/88 p-5 shadow-[0_12px_36px_rgba(28,25,23,0.05)]">
+                <div class="flex items-start justify-between gap-3">
+                  <div>
+                    <p class="text-[11px] font-bold tracking-[0.22em] text-ink">TASK LABELS</p>
+                    <p class="mt-2 text-[11px] font-semibold leading-5 tracking-[0.06em] text-stone-600">
+                      번호가 필요한 날만 빠르게 채우고, 필요 없으면 바로 비울 수 있습니다.
+                    </p>
+                  </div>
+                  <button
+                    type="button"
+                    class="relative h-8 w-16 shrink-0 rounded-full transition-colors duration-300 ease-out"
+                    :class="areTaskLabelsNumbered(planner) ? 'bg-stone-900' : 'bg-stone-300'"
+                    @click="areTaskLabelsNumbered(planner) ? clearTaskLabels(planner) : fillTaskLabelsWithNumbers(planner)"
+                  >
+                    <span
+                      class="absolute left-1 top-1 h-6 w-6 transform-gpu rounded-full bg-white shadow-sm transition-transform duration-300 ease-out will-change-transform"
+                      :class="areTaskLabelsNumbered(planner) ? 'translate-x-8' : 'translate-x-0'"
+                    />
+                  </button>
                </div>
-                <div>
-                  <p class="text-[22px] font-semibold tracking-[-0.04em] text-stone-900">{{ formatTotalTime(planner) }}</p>
-                  <p class="text-[11px] font-semibold tracking-[0.08em] text-stone-500">FOCUSED TIME</p>
-                </div>
-              </div>
-            </article>
+              </section>

-            <article class="rounded-[24px] border border-stone-200 bg-white/82 p-5 shadow-[0_12px_36px_rgba(28,25,23,0.05)]">
-              <p class="text-[11px] font-bold tracking-[0.22em] text-ink">NEXT DAY</p>
-              <div class="mt-5 space-y-3">
-                <p class="text-lg font-semibold tracking-[-0.04em] text-stone-900">
-                  <span>{{ secondaryDateDisplay.main }}</span>
-                  <span class="ml-1" :class="secondaryDateDisplay.weekdayTone">{{ secondaryDateDisplay.weekday }}</span>
-                </p>
-                <p class="text-[11px] font-semibold tracking-[0.08em] text-stone-600">
-                  내일의 첫 작업은 "{{ secondaryPlanner.tasks[0]?.title || '새 작업 추가' }}" 로 시작합니다.
+              <section class="rounded-[24px] border border-stone-200 bg-white/88 p-5 shadow-[0_12px_36px_rgba(28,25,23,0.05)]">
+                <div class="flex items-start justify-between gap-3">
+                  <div>
+                    <p class="text-[11px] font-bold tracking-[0.22em] text-ink">D-DAY 사용</p>
+                    <p class="mt-2 text-[11px] font-semibold leading-5 tracking-[0.06em] text-stone-600">
+                      현재 날짜에 적용된 목표가 있을 때만 본문 D-DAY 표시를 켜고 끌 수 있습니다.
+                    </p>
+                  </div>
+                  <button
+                    type="button"
+                    class="relative h-8 w-16 shrink-0 rounded-full transition-colors duration-300 ease-out disabled:cursor-not-allowed disabled:opacity-50"
+                    :class="planner.goalEnabled ? 'bg-stone-900' : 'bg-stone-300'"
+                    :disabled="!hasActiveGoalForSelectedDate"
+                    @click="updateGoalEnabled(planner, !planner.goalEnabled)"
+                  >
+                    <span
+                      class="absolute left-1 top-1 h-6 w-6 transform-gpu rounded-full bg-white shadow-sm transition-transform duration-300 ease-out will-change-transform"
+                      :class="planner.goalEnabled ? 'translate-x-8' : 'translate-x-0'"
+                    />
+                  </button>
+                </div>
+
+                <div class="mt-4 space-y-3">
+                  <div v-if="plannerGoal" class="rounded-2xl border border-stone-200 bg-white px-4 py-3">
+                    <p class="text-[10px] font-bold tracking-[0.16em] text-stone-500">현재 목표</p>
+                    <p class="mt-2 text-sm font-semibold tracking-[0.02em] text-stone-900">{{ plannerGoal.title }}</p>
+                    <p class="mt-1 text-[11px] font-semibold tracking-[0.06em] text-stone-500">
+                      목표일 {{ plannerGoal.targetDate }} / 적용 {{ plannerGoal.activeFrom }} ~ {{ plannerGoal.activeUntil }}
+                    </p>
+                  </div>
+
+                  <div v-if="plannerGoal" class="rounded-2xl border border-stone-200 bg-[#fbf7f0] px-4 py-4">
+                    <p class="text-[11px] font-semibold leading-5 tracking-[0.06em] text-stone-600">
+                      이 날짜에는 이미 적용된 목표가 있으므로 토글만으로 표시 여부를 빠르게 조절할 수 있습니다.
+                    </p>
+                  </div>
+
+                  <div v-else class="rounded-2xl border border-dashed border-stone-300 bg-white/70 px-4 py-4">
+                    <p class="text-[11px] font-semibold leading-5 tracking-[0.06em] text-stone-500">
+                      현재 날짜에 적용된 목표가 없습니다. GOALS 화면에서 표시 기간을 지정하면 여기 토글이 자동으로 활성화됩니다.
+                    </p>
+                  </div>
+                </div>
+              </section>
+            </div>
+
+            <div class="grid gap-4" :class="isWideFocusSidebar ? '' : 'max-w-[360px]'">
+              <section class="rounded-[24px] border border-stone-200 bg-white/82 p-5 shadow-[0_12px_36px_rgba(28,25,23,0.05)]">
+                <article>
+                  <p class="text-[11px] font-bold tracking-[0.22em] text-ink">STATS</p>
+                  <div class="mt-5 space-y-4">
+                    <div>
+                      <p class="text-[28px] font-semibold tracking-[-0.05em] text-stone-900">{{ completionRate }}%</p>
+                      <p class="text-[11px] font-semibold tracking-[0.08em] text-stone-500">TASK COMPLETION</p>
+                    </div>
+                    <div>
+                      <p class="text-[22px] font-semibold tracking-[-0.04em] text-stone-900">{{ formatTotalTimeKorean(planner) }}</p>
+                      <p class="text-[11px] font-semibold tracking-[0.08em] text-stone-500">FOCUSED TIME</p>
+                    </div>
+                  </div>
+                </article>
+              </section>
+
+              <section class="rounded-[24px] border border-stone-200 bg-white/82 p-5 shadow-[0_12px_36px_rgba(28,25,23,0.05)]">
+                <article>
+                  <p class="text-[11px] font-bold tracking-[0.22em] text-ink">NEXT DAY</p>
+                  <div class="mt-5 space-y-3">
+                    <p class="text-lg font-semibold tracking-[-0.04em] text-stone-900">
+                      <span>{{ secondaryDateDisplay.main }}</span>
+                      <span class="ml-1" :class="secondaryDateDisplay.weekdayTone">{{ secondaryDateDisplay.weekday }}</span>
+                    </p>
+                    <p class="text-[11px] font-semibold tracking-[0.08em] text-stone-600">
+                      내일의 첫 작업은 "{{ secondaryPlanner.tasks.find((task) => task.title.trim())?.title || '새 작업 추가' }}" 로 시작합니다.
+                    </p>
+                  </div>
+                </article>
+              </section>
+            </div>
+
+            <section class="rounded-[24px] border border-stone-200 bg-white/82 p-5 shadow-[0_12px_36px_rgba(28,25,23,0.05)]" :class="isWideFocusSidebar ? '2xl:col-span-2' : ''">
+              <p class="mb-4 text-[11px] font-bold tracking-[0.22em] text-ink">READ NEXT</p>
+              <div class="grid gap-3" :class="isWideFocusSidebar ? 'sm:grid-cols-3 2xl:grid-cols-3' : 'grid-cols-1'">
+                <p
+                  v-for="item in readNextItems"
+                  :key="item"
+                  class="rounded-2xl border border-stone-200 bg-[#fbf7f0] px-4 py-4 text-[11px] font-semibold leading-5 tracking-[0.06em] text-stone-700"
+                >
+                  {{ item || ' ' }}
                </p>
              </div>
-            </article>
-          </section>
+            </section>
+
+            <section class="rounded-[24px] border border-stone-200 bg-white/82 p-5 shadow-[0_12px_36px_rgba(28,25,23,0.05)]" :class="isWideFocusSidebar ? '2xl:col-span-2' : ''">
+              <p class="mb-4 text-[11px] font-bold tracking-[0.22em] text-ink">PREV SNAPSHOT</p>
+              <div class="grid gap-3" :class="isWideFocusSidebar ? 'sm:grid-cols-3 2xl:grid-cols-3' : 'grid-cols-1'">
+                <p
+                  v-for="item in prevSnapshotItems"
+                  :key="item"
+                  class="rounded-2xl border border-stone-200 bg-white px-4 py-4 text-[11px] font-semibold leading-5 tracking-[0.06em] text-stone-700"
+                >
+                  {{ item || ' ' }}
+                </p>
+              </div>
+            </section>
          </div>
        </aside>
      </section>
@@ -1680,9 +1880,10 @@ onMounted(() => {
        v-else-if="screenMode === 'planner'"
        class="scrollbar-hide print-hidden overflow-x-auto rounded-[28px] border border-white/60 bg-white/45 p-4 shadow-[0_18px_60px_rgba(28,25,23,0.06)] sm:p-6 xl:h-full xl:overflow-y-auto"
      >
-        <div class="flex min-w-[1260px] gap-6">
-          <div class="print-target">
+        <div class="mx-auto flex gap-6" :style="spreadCanvasStyle">
+          <div class="print-target overflow-hidden" :style="spreadPageFrameStyle">
            <PlannerPage
+              :style="spreadPageStyle"
              :date-main="selectedDateDisplay.main"
              :date-weekday="selectedDateDisplay.weekday"
              :date-weekday-tone="selectedDateDisplay.weekdayTone"
@@ -1703,8 +1904,9 @@ onMounted(() => {
              @update:timetable="updateTimetable(planner, $event)"
            />
          </div>
-          <div class="print-hidden">
+          <div class="print-hidden overflow-hidden" :style="spreadPageFrameStyle">
            <PlannerPage
+              :style="spreadPageStyle"
              :date-main="secondaryDateDisplay.main"
              :date-weekday="secondaryDateDisplay.weekday"
              :date-weekday-tone="secondaryDateDisplay.weekdayTone"
--- a/src/components/MiniCalendar.vue
+++ b/src/components/MiniCalendar.vue
@@ -42,7 +42,7 @@ function selectYear(year) {
 <template>
  <section class="rounded-[24px] border border-stone-200 bg-white/82 p-5 shadow-[0_12px_36px_rgba(28,25,23,0.05)]">
    <div class="relative mb-4 flex items-start justify-between gap-4">
-      <div>
+      <div class="min-w-0">
        <h2 class="text-[11px] font-bold tracking-[0.22em] text-ink">CALENDAR</h2>
        <div class="mt-2 flex items-center gap-3">
          <button
@@ -52,7 +52,7 @@ function selectYear(year) {
          >
            ←
          </button>
-          <div class="flex items-center gap-2">
+          <div class="flex min-w-0 items-center gap-2">
            <p class="text-base font-semibold tracking-[-0.04em] text-stone-900">{{ monthLabel }}</p>
            <button
              type="button"
@@ -73,7 +73,7 @@ function selectYear(year) {
      </div>
      <button
        type="button"
-        class="rounded-full border border-stone-200 px-3 py-2 text-[10px] font-bold tracking-[0.14em] text-stone-600 transition hover:border-stone-400 hover:text-ink"
+        class="shrink-0 rounded-full border border-stone-200 px-3 py-2 text-[10px] font-bold tracking-[0.14em] text-stone-600 transition hover:border-stone-400 hover:text-ink"
        @click="emit('go-today')"
      >
        TODAY
@@ -117,7 +117,12 @@ function selectYear(year) {
      </div>
    </div>
    <div class="mb-3 grid grid-cols-7 gap-2 text-center text-[10px] font-bold tracking-[0.12em] text-stone-400">
-      <span v-for="weekday in ['S', 'M', 'T', 'W', 'T', 'F', 'S']" :key="weekday">{{ weekday }}</span>
+      <span
+        v-for="weekday in ['일', '월', '화', '수', '목', '금', '토']"
+        :key="weekday"
+      >
+        {{ weekday }}
+      </span>
    </div>
    <div class="grid grid-cols-7 gap-2">
      <button
--- a/src/lib/apiBase.js
+++ b/src/lib/apiBase.js
@@ -0,0 +1,46 @@
+const DEFAULT_API_BASE_URL = 'http://localhost:3001'
+
+function normalizeBaseUrl(baseUrl) {
+  return (baseUrl || DEFAULT_API_BASE_URL).replace(/\/+$/, '')
+}
+
+function normalizePath(path) {
+  return path.startsWith('/') ? path : `/${path}`
+}
+
+export function buildApiUrl(path) {
+  const baseUrl = normalizeBaseUrl(import.meta.env.VITE_API_BASE_URL)
+  const normalizedPath = normalizePath(path)
+
+  if (baseUrl.endsWith('/api') && normalizedPath.startsWith('/api/')) {
+    return `${baseUrl}${normalizedPath.slice(4)}`
+  }
+
+  return `${baseUrl}${normalizedPath}`
+}
+
+export function toUserFacingApiError(error, fallbackMessage) {
+  const rawMessage = `${error?.message ?? ''}`.trim()
+
+  if (!rawMessage) {
+    return fallbackMessage
+  }
+
+  if (
+    rawMessage.includes('Failed to fetch') ||
+    rawMessage.includes('NetworkError') ||
+    rawMessage.includes('Load failed')
+  ) {
+    return '서버에 연결하지 못했습니다. 잠시 후 다시 시도해 주세요.'
+  }
+
+  if (
+    rawMessage.includes('Route ') ||
+    rawMessage.includes('not found') ||
+    rawMessage.includes('/api/')
+  ) {
+    return '로그인 요청을 처리하지 못했습니다. 잠시 후 다시 시도해 주세요.'
+  }
+
+  return rawMessage
+}
--- a/src/lib/authClient.js
+++ b/src/lib/authClient.js
@@ -1,25 +1,26 @@
 const AUTH_STORAGE_KEY = 'ten-minute-planner-auth'
-const API_BASE_URL = import.meta.env.VITE_API_BASE_URL ?? 'http://localhost:3001'
+import { buildApiUrl, toUserFacingApiError } from './apiBase'

-function buildHeaders(token, extraHeaders = {}) {
+function buildHeaders(token, hasBody, extraHeaders = {}) {
  return {
-    'Content-Type': 'application/json',
+    ...(hasBody ? { 'Content-Type': 'application/json' } : {}),
    ...(token ? { Authorization: `Bearer ${token}` } : {}),
    ...extraHeaders,
  }
 }

 async function request(path, { method = 'GET', token, body } = {}) {
-  const response = await fetch(`${API_BASE_URL}${path}`, {
+  const hasBody = body !== undefined
+  const response = await fetch(buildApiUrl(path), {
    method,
-    headers: buildHeaders(token),
-    body: body ? JSON.stringify(body) : undefined,
+    headers: buildHeaders(token, hasBody),
+    body: hasBody ? JSON.stringify(body) : undefined,
  })

  const data = await response.json().catch(() => ({}))

  if (!response.ok) {
-    throw new Error(data.message || '요청 처리 중 문제가 발생했습니다.')
+    throw new Error(toUserFacingApiError(data, '요청 처리 중 문제가 발생했습니다.'))
  }

  return data
--- a/src/lib/goalsApi.js
+++ b/src/lib/goalsApi.js
@@ -1,23 +1,24 @@
-const API_BASE_URL = import.meta.env.VITE_API_BASE_URL ?? 'http://localhost:3001'
+import { buildApiUrl, toUserFacingApiError } from './apiBase'

-function buildHeaders(token) {
+function buildHeaders(token, hasBody) {
  return {
-    'Content-Type': 'application/json',
-    Authorization: `Bearer ${token}`,
+    ...(hasBody ? { 'Content-Type': 'application/json' } : {}),
+    ...(token ? { Authorization: `Bearer ${token}` } : {}),
  }
 }

 async function request(path, { method = 'GET', token, body } = {}) {
-  const response = await fetch(`${API_BASE_URL}${path}`, {
+  const hasBody = body !== undefined
+  const response = await fetch(buildApiUrl(path), {
    method,
-    headers: buildHeaders(token),
-    body: body ? JSON.stringify(body) : undefined,
+    headers: buildHeaders(token, hasBody),
+    body: hasBody ? JSON.stringify(body) : undefined,
  })

  const data = await response.json().catch(() => ({}))

  if (!response.ok) {
-    throw new Error(data.message || '목표 데이터를 처리하지 못했습니다.')
+    throw new Error(toUserFacingApiError(data, '목표 데이터를 처리하지 못했습니다.'))
  }

  return data
--- a/src/lib/plannerApi.js
+++ b/src/lib/plannerApi.js
@@ -1,23 +1,24 @@
-const API_BASE_URL = import.meta.env.VITE_API_BASE_URL ?? 'http://localhost:3001'
+import { buildApiUrl, toUserFacingApiError } from './apiBase'

-function buildHeaders(token) {
+function buildHeaders(token, hasBody) {
  return {
-    'Content-Type': 'application/json',
-    Authorization: `Bearer ${token}`,
+    ...(hasBody ? { 'Content-Type': 'application/json' } : {}),
+    ...(token ? { Authorization: `Bearer ${token}` } : {}),
  }
 }

 async function request(path, { method = 'GET', token, body } = {}) {
-  const response = await fetch(`${API_BASE_URL}${path}`, {
+  const hasBody = body !== undefined
+  const response = await fetch(buildApiUrl(path), {
    method,
-    headers: buildHeaders(token),
-    body: body ? JSON.stringify(body) : undefined,
+    headers: buildHeaders(token, hasBody),
+    body: hasBody ? JSON.stringify(body) : undefined,
  })

  const data = await response.json().catch(() => ({}))

  if (!response.ok) {
-    throw new Error(data.message || '플래너 데이터를 처리하지 못했습니다.')
+    throw new Error(toUserFacingApiError(data, '플래너 데이터를 처리하지 못했습니다.'))
  }

  return data
--- a/src/style.css
+++ b/src/style.css
@@ -88,15 +88,15 @@

  .print-paper--double {
    display: grid !important;
-    grid-template-columns: repeat(2, 141mm);
+    grid-template-columns: repeat(2, 139mm);
    justify-content: center;
    align-content: center;
-    column-gap: 3mm;
+    column-gap: 4mm;
  }

  body[data-print-layout='double'] .print-paper {
-    width: 287mm;
-    height: 198mm;
+    width: 285mm;
+    height: 196mm;
  }

  body[data-print-layout='single'] .print-paper--single .print-sheet-frame {
@@ -113,8 +113,8 @@
  }

  body[data-print-layout='double'] .print-paper--double .print-sheet-frame {
-    width: 141mm;
-    height: 198mm;
+    width: 139mm;
+    height: 196mm;
  }

  .planner-sheet {
@@ -134,7 +134,7 @@
    width: 762px !important;
    max-width: none !important;
    transform-origin: top left;
-    transform: scale(0.694);
+    transform: scale(0.684);
    box-shadow: none !important;
    background: #ffffff !important;
  }
--- a/vite.config.js
+++ b/vite.config.js
@@ -3,4 +3,12 @@ import vue from '@vitejs/plugin-vue'

 export default defineConfig({
  plugins: [vue()],
+  server: {
+    host: '0.0.0.0',
+    port: 5173,
+    strictPort: true,
+    watch: {
+      usePolling: true,
+    },
+  },
 })
Author	SHA1	Message	Date
zenn	f11c0d3cef	v0.1.31 - 집중 시간 한글 표기와 통계 문구 정리	2026-04-22 16:42:25 +09:00
zenn	98d4209958	v0.1.30 - 태블릿과 모바일용 내비게이션 드로어 정리	2026-04-22 16:30:21 +09:00
zenn	bf06cd28c1	v0.1.29 - 반응형 우측 패널 오버레이와 2페이지 보기 배율 조정	2026-04-22 15:43:41 +09:00
zenn	962a338b3d	v0.1.28 - 사이드 레이아웃 재정리와 2페이지 인쇄 보정	2026-04-22 12:10:21 +09:00
zenn	9e96a57504	v0.1.27 - 달력 기준과 우측 패널 레이아웃 정리	2026-04-22 11:33:17 +09:00
zenn	905a0caf75	v0.1.26 - 빈 날짜 이동 시 불필요한 삭제 알림 제거	2026-04-22 11:25:09 +09:00
zenn	e221254c60	v0.1.25 - 빈 JSON 본문 요청 오류 수정	2026-04-22 11:20:22 +09:00
zenn	1738a7d3b6	v0.1.24 - 개발용과 배포용 실행 문서 추가	2026-04-22 11:14:29 +09:00
zenn	9760c9dc0e	v0.1.23 - 개발용 자동 새로고침과 로그인 화면 정렬	2026-04-22 11:08:58 +09:00
zenn	b972209c2f	v0.1.22 - 로그인 오류 문구와 비로그인 화면 정리	2026-04-22 11:05:46 +09:00