From 7ff8bd06b1f3550471699d5c5a33d25a93d082f0 Mon Sep 17 00:00:00 2001 From: zenn Date: Tue, 21 Apr 2026 17:41:20 +0900 Subject: [PATCH] =?UTF-8?q?v0.1.7=20-=20=EC=A0=80=EC=9E=A5=20=EB=A0=88?= =?UTF-8?q?=EC=9D=B4=EC=96=B4=20=EB=B6=84=EB=A6=AC=20=EC=8B=9C=EC=9E=91?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 1 + HANDOFF.md | 7 ++- TODO.md | 2 + package-lock.json | 4 +- package.json | 2 +- src/App.vue | 102 ++++++++------------------------------ src/lib/plannerStorage.js | 92 ++++++++++++++++++++++++++++++++++ 7 files changed, 124 insertions(+), 86 deletions(-) create mode 100644 src/lib/plannerStorage.js diff --git a/AGENTS.md b/AGENTS.md index 6a8c2c0..ffb4920 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -29,6 +29,7 @@ ## 커밋 규칙 - 사용자가 버전형 체크포인트를 원할 경우 `v0.0.1` 같은 형식으로 커밋을 남긴다. +- 버전 커밋만 단독으로 쓰지 말고, `v0.1.7 - 저장 레이어 분리`처럼 버전 뒤에 작업 요약을 함께 남긴다. - 의미를 알기 어려운 큰 커밋보다, 이해 가능한 작은 단위의 커밋을 선호한다. ## 디자인 구현 규칙 diff --git a/HANDOFF.md b/HANDOFF.md index a6a5a19..aad4cdb 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -4,7 +4,7 @@ - 프로젝트명: 10 Minute Planner 웹 UI - 기술 스택: Vue 3 + Vite + TailwindCSS + JavaScript -- 현재 기준 버전: `v0.1.6` +- 현재 기준 버전: `v0.1.7` - Git 원격 저장소: `https://git.sori.studio/zenn/planner.sori.studio.git` ## 기준 디자인 @@ -41,6 +41,7 @@ - 입력 내용이 있는 날짜는 달력 하단에 빨간 점으로 표시된다. - 상단 날짜 표시에서는 토요일의 `(토)`만 파란색, 일요일의 `(일)`만 빨간색으로 표시한다. - 플래너 상태는 `localStorage`에 저장되며, 날짜별 기록과 선택 날짜, 달력 보고 있던 월까지 복원된다. +- `localStorage` 접근 로직은 `src/lib/plannerStorage.js`로 분리하기 시작했고, 이후 API/DB adapter로 교체하기 쉬운 구조로 정리 중이다. - 상단 전환 버튼으로 `PLANNER / STATS` 화면을 오갈 수 있다. - 통계 화면에서는 전체 집중 시간, 평균 완료율, 기록 일수, 최근 7일 흐름, 최근 기록, 베스트 데이를 보여준다. - 통계 화면은 시작일/종료일을 직접 선택해 그 기간 기준으로 지표를 다시 계산할 수 있다. @@ -65,6 +66,8 @@ - TailwindCSS는 Vue를 사용하더라도 반드시 유지해야 하는 스타일링 방식이다. - 현재 데이터는 레이아웃과 상호작용 검증을 위한 목업 데이터다. - 현재 저장은 `localStorage`를 사용하지만, 적절한 시점에 DB를 붙여 사용자별 저장 구조로 전환해야 한다. +- 백엔드는 빠른 MVP라면 PocketBase도 가능하지만, 현재 요구사항에서는 전용 Node.js API + DB 구성이 더 유연하다. +- 이유는 회원가입, 사용자별 문서 관리, 통계 계산, 출력/이미지 저장, 이후 Docker Compose 배포까지 고려하면 서버 로직 제어권이 더 중요하기 때문이다. - 상단 날짜는 시스템 날짜 또는 현재 선택된 플래너 날짜 기준으로 자동 표시되어야 한다. - `D-DAY`는 지금은 보류이며, 이후 별도의 목표 관리 패널과 연결해서 계산한다. - `COMMENT`, `TASKS`, `MEMO`는 모두 입력 가능한 필드가 되어야 한다. @@ -81,6 +84,7 @@ - 사용자는 스스로 통계를 확인할 수 있어야 하고, 특정 날짜에 작성한 문서는 출력 가능해야 한다. - 공유를 위해 나중에 이미지 저장 기능도 필요하지만, 실제 출력 품질과 텍스트 선명도는 HTML/CSS 인쇄 레이아웃을 우선 유지하는 편이 좋다. - 원격 저장소 `origin`은 `https://git.sori.studio/zenn/planner.sori.studio.git`로 연결되어 있다. +- 앞으로 버전 체크포인트 커밋은 `v0.1.7 - 작업 요약`처럼 버전 뒤에 짧은 작업 설명을 함께 남기는 형식으로 통일한다. - 이후 배포 단계에서는 `docker-compose.yml`도 함께 작성해야 하며, 포트 번호와 서비스 구성은 추후 사용자와 확정한다. ## 다음 권장 작업 @@ -89,6 +93,7 @@ - 목표나 통계 기능보다 먼저, 플래너 본문의 입력과 상호작용을 우선 구현한다. - 통계 화면 구현은 현재 `localStorage` 기반으로 먼저 진행해도 된다. - DB는 기능 탐색 속도를 해치지 않는 선에서, 저장 레이어를 분리할 수 있는 적절한 시점에 붙이는 것이 좋다. +- 현재 기준 추천 백엔드 방향은 `Vue 프론트엔드 + Node.js API + SQLite 또는 PostgreSQL`이다. - 이미지 저장 기능은 추후 `print-only` 또는 별도 export 전용 레이아웃을 기준으로 구현하면 화면/인쇄/공유 결과를 맞추기 쉽다. - Docker Compose는 프론트엔드와 백엔드를 함께 올리는 기준으로 설계하되, NAS 환경에 맞는 볼륨과 재시작 정책도 함께 고려한다. diff --git a/TODO.md b/TODO.md index b1af0de..28b8ed7 100644 --- a/TODO.md +++ b/TODO.md @@ -82,7 +82,9 @@ - D-DAY는 현재 보류 상태다. 목표 패널 설계 후 연결한다. - `TIME TABLE` 드래그는 단순 사각형 선택이 아니라 시간 셀 단위의 연속 선택으로 해석한다. - 현재는 `localStorage`로 개발을 진행하지만, 적절한 시점에 DB를 붙여 사용자별 저장 구조로 확장해야 한다. +- 현재 `localStorage` 저장 로직은 분리 가능한 형태로 정리 중이며, 이후 API/DB adapter로 교체하기 쉽게 유지한다. - 최종적으로는 회원 가입 후 각자 자신의 문서를 작성/관리하고, 개인 통계를 확인하며, 특정 날짜 문서를 출력할 수 있어야 한다. - 실제 인쇄는 HTML/CSS 기반 프린트 레이아웃으로 유지하고, 공유용으로는 별도의 이미지 저장 기능을 추가하는 방향이 적합하다. - 최종 배포는 UGREEN NAS에서 Docker 기반으로 동작할 예정이며, 포트와 실제 서비스 구성은 추후 확정한다. +- 백엔드는 빠른 목업이면 PocketBase도 가능하지만, 현재 방향상 커스텀 로직과 확장성을 생각하면 전용 Node.js API + DB 조합을 우선 검토한다. - 구현할 때마다 완료된 항목은 체크하고, 큰 결정사항은 `HANDOFF.md`에도 함께 반영한다. diff --git a/package-lock.json b/package-lock.json index 6054c62..7266802 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "ten-minute-planner", - "version": "0.1.6", + "version": "0.1.7", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "ten-minute-planner", - "version": "0.1.6", + "version": "0.1.7", "dependencies": { "vue": "^3.5.13" }, diff --git a/package.json b/package.json index 1e5cee8..7c1b886 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "ten-minute-planner", "private": true, - "version": "0.1.6", + "version": "0.1.7", "type": "module", "scripts": { "dev": "vite", diff --git a/src/App.vue b/src/App.vue index 531ede5..551f0d6 100644 --- a/src/App.vue +++ b/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') @@ -190,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) @@ -560,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 }, ) diff --git a/src/lib/plannerStorage.js b/src/lib/plannerStorage.js new file mode 100644 index 0000000..24cdb36 --- /dev/null +++ b/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, + }), + ) +}