v0.1.7 - 저장 레이어 분리 시작

AGENTS.md

@@ -29,6 +29,7 @@
 ## 커밋 규칙
 
 - 사용자가 버전형 체크포인트를 원할 경우 `v0.0.1` 같은 형식으로 커밋을 남긴다.
+- 버전 커밋만 단독으로 쓰지 말고, `v0.1.7 - 저장 레이어 분리`처럼 버전 뒤에 작업 요약을 함께 남긴다.
 - 의미를 알기 어려운 큰 커밋보다, 이해 가능한 작은 단위의 커밋을 선호한다.
 
 ## 디자인 구현 규칙

HANDOFF.md

@@ -4,7 +4,8 @@
 
 - 프로젝트명: 10 Minute Planner 웹 UI
 - 기술 스택: Vue 3 + Vite + TailwindCSS + JavaScript
-- 현재 기준 버전: `v0.1.1`
+- 현재 기준 버전: `v0.1.7`
+- Git 원격 저장소: `https://git.sori.studio/zenn/planner.sori.studio.git`
 
 ## 기준 디자인
 
@@ -17,6 +18,7 @@
 - `2페이지 펼침 보기`는 비교용 보조 모드로 함께 유지한다.
 - 화면 인상은 종이 다이어리 같아야 하지만, 상호작용은 웹앱처럼 빠르고 자연스러워야 한다.
 - 현재는 개인용 단일 브라우저 흐름으로 개발 중이지만, 이후 회원 기반 개인 문서 관리 서비스로 확장해야 한다.
+- 최종적으로는 프론트엔드와 백엔드를 Docker로 묶어서 UGREEN NAS에서 구동할 예정이다.
 
 ## 현재 구현 상태
 
@@ -39,6 +41,7 @@
 - 입력 내용이 있는 날짜는 달력 하단에 빨간 점으로 표시된다.
 - 상단 날짜 표시에서는 토요일의 `(토)`만 파란색, 일요일의 `(일)`만 빨간색으로 표시한다.
 - 플래너 상태는 `localStorage`에 저장되며, 날짜별 기록과 선택 날짜, 달력 보고 있던 월까지 복원된다.
+- `localStorage` 접근 로직은 `src/lib/plannerStorage.js`로 분리하기 시작했고, 이후 API/DB adapter로 교체하기 쉬운 구조로 정리 중이다.
 - 상단 전환 버튼으로 `PLANNER / STATS` 화면을 오갈 수 있다.
 - 통계 화면에서는 전체 집중 시간, 평균 완료율, 기록 일수, 최근 7일 흐름, 최근 기록, 베스트 데이를 보여준다.
 - 통계 화면은 시작일/종료일을 직접 선택해 그 기간 기준으로 지표를 다시 계산할 수 있다.
@@ -47,6 +50,14 @@
 - 인쇄 시에는 현재 선택된 하루 플래너 본문만 남기고, 헤더/사이드패널/통계 화면은 숨긴다.
 - 출력 버튼은 `PRINT 1-UP` / `PRINT 2-UP`으로 분리되어 있다.
 - `PRINT 2-UP`은 현재 날짜와 다음 날짜를 A4 가로 기준으로 나란히 출력하는 용도다.
+- 인쇄는 일반 화면을 그대로 찍는 방식이 아니라, 별도의 `print-only` 전용 레이아웃을 사용한다.
+- A5 원본 비율을 유지한 채 A4 가로 안에 들어가도록 `1-UP` / `2-UP` 각각 별도 배율로 압축한다.
+- `PRINT 1-UP`은 A4 세로, `PRINT 2-UP`은 A4 가로 기준으로 분리해서 처리한다.
+- 브라우저 기본 인쇄 머리말/꼬리말이 켜져 있어도 2장으로 넘어가지 않도록 실제 인쇄 영역은 종이보다 조금 작게 잡는다.
+- 인쇄 시 `main`, `print-only`, `print-paper` 래퍼의 패딩/높이/페이지 분할 규칙까지 함께 제어해야 빈 2페이지를 줄일 수 있다.
+- `1-UP`은 여백이 과하지 않도록 다시 확대했고, `2-UP`은 한 페이지 고정 안정성을 위해 가로 폭과 세로 높이를 조금 더 보수적으로 조정했다.
+- `1-UP`은 세로 가운데 정렬을 없애고 상단 기준으로 붙여야 여백이 덜 커 보인다.
+- 현재 `1-UP`은 프레임 자체를 A4 세로에 가깝게 키우고 배율을 크게 올려 빈 여백을 줄이는 방향으로 맞추고 있다.
 
 ## 확정된 결정사항
 
@@ -55,6 +66,8 @@
 - TailwindCSS는 Vue를 사용하더라도 반드시 유지해야 하는 스타일링 방식이다.
 - 현재 데이터는 레이아웃과 상호작용 검증을 위한 목업 데이터다.
 - 현재 저장은 `localStorage`를 사용하지만, 적절한 시점에 DB를 붙여 사용자별 저장 구조로 전환해야 한다.
+- 백엔드는 빠른 MVP라면 PocketBase도 가능하지만, 현재 요구사항에서는 전용 Node.js API + DB 구성이 더 유연하다.
+- 이유는 회원가입, 사용자별 문서 관리, 통계 계산, 출력/이미지 저장, 이후 Docker Compose 배포까지 고려하면 서버 로직 제어권이 더 중요하기 때문이다.
 - 상단 날짜는 시스템 날짜 또는 현재 선택된 플래너 날짜 기준으로 자동 표시되어야 한다.
 - `D-DAY`는 지금은 보류이며, 이후 별도의 목표 관리 패널과 연결해서 계산한다.
 - `COMMENT`, `TASKS`, `MEMO`는 모두 입력 가능한 필드가 되어야 한다.
@@ -69,6 +82,10 @@
 - 장기적으로는 회원 가입 후 사용자별로 각자 문서를 작성/관리할 수 있어야 한다.
 - 공유 문서 서비스가 아니라, 사용자 개인 보관과 회고 중심의 서비스 구조를 목표로 한다.
 - 사용자는 스스로 통계를 확인할 수 있어야 하고, 특정 날짜에 작성한 문서는 출력 가능해야 한다.
+- 공유를 위해 나중에 이미지 저장 기능도 필요하지만, 실제 출력 품질과 텍스트 선명도는 HTML/CSS 인쇄 레이아웃을 우선 유지하는 편이 좋다.
+- 원격 저장소 `origin`은 `https://git.sori.studio/zenn/planner.sori.studio.git`로 연결되어 있다.
+- 앞으로 버전 체크포인트 커밋은 `v0.1.7 - 작업 요약`처럼 버전 뒤에 짧은 작업 설명을 함께 남기는 형식으로 통일한다.
+- 이후 배포 단계에서는 `docker-compose.yml`도 함께 작성해야 하며, 포트 번호와 서비스 구성은 추후 사용자와 확정한다.
 
 ## 다음 권장 작업
 
@@ -76,6 +93,9 @@
 - 목표나 통계 기능보다 먼저, 플래너 본문의 입력과 상호작용을 우선 구현한다.
 - 통계 화면 구현은 현재 `localStorage` 기반으로 먼저 진행해도 된다.
 - DB는 기능 탐색 속도를 해치지 않는 선에서, 저장 레이어를 분리할 수 있는 적절한 시점에 붙이는 것이 좋다.
+- 현재 기준 추천 백엔드 방향은 `Vue 프론트엔드 + Node.js API + SQLite 또는 PostgreSQL`이다.
+- 이미지 저장 기능은 추후 `print-only` 또는 별도 export 전용 레이아웃을 기준으로 구현하면 화면/인쇄/공유 결과를 맞추기 쉽다.
+- Docker Compose는 프론트엔드와 백엔드를 함께 올리는 기준으로 설계하되, NAS 환경에 맞는 볼륨과 재시작 정책도 함께 고려한다.
 
 ## 갱신 규칙
 

TODO.md

@@ -72,11 +72,19 @@
 - [ ] 공유가 아닌 개인 보관용 서비스 흐름으로 요구사항을 정리한다.
 - [x] 향후 출력 기능을 위한 인쇄 레이아웃 요구사항을 정리한다.
 - [x] A4 가로 기준 2장 출력 모드를 지원한다.
+- [x] `1-UP` 세로 인쇄 / `2-UP` 가로 인쇄 기준을 분리한다.
+- [ ] 공유를 위한 이미지 저장 기능을 추가한다.
+- [ ] Docker 배포 구조를 정리한다.
+- [ ] UGREEN NAS 기준 `docker-compose.yml` 초안을 작성한다.
 
 ## 메모
 
 - D-DAY는 현재 보류 상태다. 목표 패널 설계 후 연결한다.
 - `TIME TABLE` 드래그는 단순 사각형 선택이 아니라 시간 셀 단위의 연속 선택으로 해석한다.
 - 현재는 `localStorage`로 개발을 진행하지만, 적절한 시점에 DB를 붙여 사용자별 저장 구조로 확장해야 한다.
+- 현재 `localStorage` 저장 로직은 분리 가능한 형태로 정리 중이며, 이후 API/DB adapter로 교체하기 쉽게 유지한다.
 - 최종적으로는 회원 가입 후 각자 자신의 문서를 작성/관리하고, 개인 통계를 확인하며, 특정 날짜 문서를 출력할 수 있어야 한다.
+- 실제 인쇄는 HTML/CSS 기반 프린트 레이아웃으로 유지하고, 공유용으로는 별도의 이미지 저장 기능을 추가하는 방향이 적합하다.
+- 최종 배포는 UGREEN NAS에서 Docker 기반으로 동작할 예정이며, 포트와 실제 서비스 구성은 추후 확정한다.
+- 백엔드는 빠른 목업이면 PocketBase도 가능하지만, 현재 방향상 커스텀 로직과 확장성을 생각하면 전용 Node.js API + DB 조합을 우선 검토한다.
 - 구현할 때마다 완료된 항목은 체크하고, 큰 결정사항은 `HANDOFF.md`에도 함께 반영한다.

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "ten-minute-planner",
-  "version": "0.1.1",
+  "version": "0.1.7",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "ten-minute-planner",
-      "version": "0.1.1",
+      "version": "0.1.7",
       "dependencies": {
         "vue": "^3.5.13"
       },

package.json

@@ -1,7 +1,7 @@
 {
   "name": "ten-minute-planner",
   "private": true,
-  "version": "0.1.1",
+  "version": "0.1.7",
   "type": "module",
   "scripts": {
     "dev": "vite",

src/App.vue

@@ -3,8 +3,12 @@ import { computed, reactive, ref, watch, nextTick } from 'vue'
 import MiniCalendar from './components/MiniCalendar.vue'
 import PlannerPage from './components/PlannerPage.vue'
 import StatsDashboard from './components/StatsDashboard.vue'
+import {
+  createInitialPlannerRecords,
+  persistPlannerState,
+  restorePlannerUiState,
+} from './lib/plannerStorage'
 
-const STORAGE_KEY = 'ten-minute-planner-state'
 const screenMode = ref('planner')
 const viewMode = ref('focus')
 const printLayout = ref('single')
@@ -21,6 +25,7 @@ const hours = [
 ]
 
 const timetableCellCount = hours.length * 6
+let printPageStyleElement = null
 
 function createEmptyTimetable() {
   return Array.from({ length: timetableCellCount }, () => false)
@@ -189,62 +194,15 @@ function normalizeRecord(record) {
   }
 }
 
-function createInitialPlannerRecords() {
-  const baseRecords = Object.fromEntries(
-    Object.entries(plannerSeed).map(([key, record]) => [key, normalizeRecord(record)]),
-  )
+const plannerRecords = reactive(createInitialPlannerRecords(plannerSeed, normalizeRecord))
 
-  if (typeof window === 'undefined') {
-    return baseRecords
-  }
-
-  try {
-    const savedState = JSON.parse(window.localStorage.getItem(STORAGE_KEY) ?? '{}')
-    const savedRecords = savedState.records ?? {}
-
-    Object.entries(savedRecords).forEach(([key, record]) => {
-      baseRecords[key] = normalizeRecord(record)
-    })
-  } catch (error) {
-    console.warn('저장된 플래너 상태를 불러오지 못했습니다.', error)
-  }
-
-  return baseRecords
-}
-
-const plannerRecords = reactive(createInitialPlannerRecords())
-
-function restoreDateState() {
-  if (typeof window === 'undefined') {
-    return
-  }
-
-  try {
-    const savedState = JSON.parse(window.localStorage.getItem(STORAGE_KEY) ?? '{}')
-
-    if (savedState.selectedDate) {
-      selectedDate.value = toDateValue(savedState.selectedDate, selectedDate.value)
-    }
-
-    if (savedState.calendarViewDate) {
-      calendarViewDate.value = toDateValue(savedState.calendarViewDate, selectedDate.value)
-    } else {
-      calendarViewDate.value = new Date(selectedDate.value)
-    }
-
-    if (savedState.statsRangeStart) {
-      statsRangeStart.value = savedState.statsRangeStart
-    }
-
-    if (savedState.statsRangeEnd) {
-      statsRangeEnd.value = savedState.statsRangeEnd
-    }
-  } catch (error) {
-    console.warn('저장된 날짜 상태를 불러오지 못했습니다.', error)
-  }
-}
-
-restoreDateState()
+restorePlannerUiState({
+  selectedDate,
+  calendarViewDate,
+  statsRangeStart,
+  statsRangeEnd,
+  toDateValue,
+})
 
 function getPlannerRecord(date) {
   const key = toKey(date)
@@ -559,32 +517,13 @@ const bestDay = computed(() => {
 watch(
   [plannerRecords, selectedDate, calendarViewDate, statsRangeStart, statsRangeEnd],
   () => {
-    if (typeof window === 'undefined') {
-      return
-    }
-
-    const serializableRecords = Object.fromEntries(
-      Object.entries(plannerRecords).map(([key, record]) => [
-        key,
-        {
-          ...record,
-          tasks: record.tasks.map((task) => ({ ...task })),
-          memo: record.memo.map((item) => ({ ...item })),
-          timetable: [...record.timetable],
-        },
-      ]),
-    )
-
-    window.localStorage.setItem(
-      STORAGE_KEY,
-      JSON.stringify({
-        selectedDate: selectedDate.value.toISOString(),
-        calendarViewDate: calendarViewDate.value.toISOString(),
-        statsRangeStart: normalizedStatsRange.value.startKey,
-        statsRangeEnd: normalizedStatsRange.value.endKey,
-        records: serializableRecords,
-      }),
-    )
+    persistPlannerState({
+      plannerRecords,
+      selectedDate: selectedDate.value,
+      calendarViewDate: calendarViewDate.value,
+      statsRangeStart: normalizedStatsRange.value.startKey,
+      statsRangeEnd: normalizedStatsRange.value.endKey,
+    })
   },
   { deep: true },
 )
@@ -601,8 +540,29 @@ function clearTaskLabels(record) {
   })
 }
 
+function applyPrintPageStyle(layout) {
+  if (typeof document === 'undefined') {
+    return
+  }
+
+  const pageRule =
+    layout === 'double'
+      ? '@page { size: A4 landscape; margin: 0; }'
+      : '@page { size: A4 portrait; margin: 0; }'
+
+  if (!printPageStyleElement) {
+    printPageStyleElement = document.createElement('style')
+    printPageStyleElement.setAttribute('data-print-page-style', 'true')
+    document.head.appendChild(printPageStyleElement)
+  }
+
+  printPageStyleElement.textContent = pageRule
+  document.body.dataset.printLayout = layout
+}
+
 async function printSelectedPlanner(layout = 'single') {
   printLayout.value = layout
+  applyPrintPageStyle(layout)
   await nextTick()
   window.print()
 }
@@ -700,7 +660,7 @@ async function printSelectedPlanner(layout = 'single') {
 
       <section
         v-if="screenMode === 'planner' && viewMode === 'focus'"
-        class="grid gap-6 xl:grid-cols-[minmax(0,1fr)_320px]"
+        class="print-hidden grid gap-6 xl:grid-cols-[minmax(0,1fr)_320px]"
       >
         <div class="print-target">
           <PlannerPage
@@ -819,7 +779,7 @@ async function printSelectedPlanner(layout = 'single') {
 
       <section
         v-else-if="screenMode === 'planner'"
-        class="overflow-x-auto rounded-[32px] border border-white/60 bg-white/40 p-4 sm:p-6"
+        class="print-hidden overflow-x-auto rounded-[32px] border border-white/60 bg-white/40 p-4 sm:p-6"
       >
         <div class="flex min-w-[1260px] gap-6">
           <div class="print-target">
@@ -882,7 +842,7 @@ async function printSelectedPlanner(layout = 'single') {
       />
 
       <section class="print-only">
-        <div v-if="printLayout === 'single'" class="print-paper">
+        <div v-if="printLayout === 'single'" class="print-paper print-paper--single">
           <div class="print-sheet-frame">
             <PlannerPage
               :date-main="selectedDateDisplay.main"

src/lib/plannerStorage.js

@@ -0,0 +1,92 @@
+const STORAGE_KEY = 'ten-minute-planner-state'
+
+function readStorageState() {
+  if (typeof window === 'undefined') {
+    return {}
+  }
+
+  try {
+    return JSON.parse(window.localStorage.getItem(STORAGE_KEY) ?? '{}')
+  } catch (error) {
+    console.warn('저장된 플래너 상태를 불러오지 못했습니다.', error)
+    return {}
+  }
+}
+
+export function createInitialPlannerRecords(seedRecords, normalizeRecord) {
+  const baseRecords = Object.fromEntries(
+    Object.entries(seedRecords).map(([key, record]) => [key, normalizeRecord(record)]),
+  )
+
+  const savedState = readStorageState()
+  const savedRecords = savedState.records ?? {}
+
+  Object.entries(savedRecords).forEach(([key, record]) => {
+    baseRecords[key] = normalizeRecord(record)
+  })
+
+  return baseRecords
+}
+
+export function restorePlannerUiState({
+  selectedDate,
+  calendarViewDate,
+  statsRangeStart,
+  statsRangeEnd,
+  toDateValue,
+}) {
+  const savedState = readStorageState()
+
+  if (savedState.selectedDate) {
+    selectedDate.value = toDateValue(savedState.selectedDate, selectedDate.value)
+  }
+
+  if (savedState.calendarViewDate) {
+    calendarViewDate.value = toDateValue(savedState.calendarViewDate, selectedDate.value)
+  } else {
+    calendarViewDate.value = new Date(selectedDate.value)
+  }
+
+  if (savedState.statsRangeStart) {
+    statsRangeStart.value = savedState.statsRangeStart
+  }
+
+  if (savedState.statsRangeEnd) {
+    statsRangeEnd.value = savedState.statsRangeEnd
+  }
+}
+
+export function persistPlannerState({
+  plannerRecords,
+  selectedDate,
+  calendarViewDate,
+  statsRangeStart,
+  statsRangeEnd,
+}) {
+  if (typeof window === 'undefined') {
+    return
+  }
+
+  const serializableRecords = Object.fromEntries(
+    Object.entries(plannerRecords).map(([key, record]) => [
+      key,
+      {
+        ...record,
+        tasks: record.tasks.map((task) => ({ ...task })),
+        memo: record.memo.map((item) => ({ ...item })),
+        timetable: [...record.timetable],
+      },
+    ]),
+  )
+
+  window.localStorage.setItem(
+    STORAGE_KEY,
+    JSON.stringify({
+      selectedDate: selectedDate.toISOString(),
+      calendarViewDate: calendarViewDate.toISOString(),
+      statsRangeStart,
+      statsRangeEnd,
+      records: serializableRecords,
+    }),
+  )
+}

src/style.css

@@ -22,14 +22,12 @@
 }
 
 @media print {
-  @page {
-    size: A4 landscape;
-    margin: 0;
-  }
-
   html,
   body {
     background: #ffffff !important;
+    width: auto !important;
+    height: auto !important;
+    overflow: hidden !important;
   }
 
   body {
@@ -37,41 +35,76 @@
     margin: 0;
   }
 
+  main {
+    min-height: auto !important;
+    margin: 0 !important;
+    padding: 0 !important;
+  }
+
   .print-hidden {
     display: none !important;
   }
 
   .print-only {
-    display: block !important;
+    display: flex !important;
+    width: 100% !important;
+    height: 100% !important;
+    margin: 0 !important;
+    padding: 0 !important;
+    align-items: center;
+    justify-content: center;
+    break-inside: avoid-page;
+    page-break-inside: avoid;
+    break-after: avoid-page;
+    page-break-after: avoid;
   }
 
   .print-root {
     display: block !important;
+    width: 100% !important;
+    height: 100% !important;
+    margin: 0 !important;
     max-width: none !important;
     padding: 0 !important;
     gap: 0 !important;
   }
 
   .print-paper {
-    min-height: 100vh;
     display: flex !important;
     align-items: center;
     justify-content: center;
     background: #ffffff !important;
     padding: 0;
+    overflow: hidden;
+  }
+
+  body[data-print-layout='single'] .print-paper {
+    width: 204mm;
+    height: 291mm;
+    align-items: flex-start;
+    justify-content: center;
+    padding-top: 3mm;
   }
 
   .print-paper--double {
     display: grid !important;
-    grid-template-columns: repeat(2, 148mm);
+    grid-template-columns: repeat(2, 141mm);
     justify-content: center;
     align-content: center;
-    gap: 0;
+    column-gap: 3mm;
+  }
+
+  body[data-print-layout='double'] .print-paper {
+    width: 287mm;
+    height: 198mm;
+  }
+
+  body[data-print-layout='single'] .print-paper--single .print-sheet-frame {
+    width: 198mm;
+    height: 281mm;
   }
 
   .print-sheet-frame {
-    width: 148mm;
-    height: 210mm;
     overflow: hidden;
     display: flex;
     align-items: flex-start;
@@ -79,20 +112,29 @@
     background: #ffffff !important;
   }
 
-  .print-paper--double .print-sheet-frame {
-    width: 148.5mm;
-    height: 210mm;
+  body[data-print-layout='double'] .print-paper--double .print-sheet-frame {
+    width: 141mm;
+    height: 198mm;
   }
 
   .planner-sheet {
     box-shadow: none !important;
   }
 
-  .print-sheet-frame .planner-sheet {
+  body[data-print-layout='single'] .print-paper--single .print-sheet-frame .planner-sheet {
     width: 762px !important;
     max-width: none !important;
     transform-origin: top left;
-    transform: scale(0.733);
+    transform: scale(0.978);
+    box-shadow: none !important;
+    background: #ffffff !important;
+  }
+
+  body[data-print-layout='double'] .print-paper--double .print-sheet-frame .planner-sheet {
+    width: 762px !important;
+    max-width: none !important;
+    transform-origin: top left;
+    transform: scale(0.694);
     box-shadow: none !important;
     background: #ffffff !important;
   }