diff --git a/backend/src/db.js b/backend/src/db.js index 2fd1198..730b054 100644 --- a/backend/src/db.js +++ b/backend/src/db.js @@ -470,7 +470,7 @@ async function ensureSchema() { id VARCHAR(64) PRIMARY KEY, request_type VARCHAR(20) NOT NULL, requester_id VARCHAR(64) NOT NULL, - source_tierlist_id VARCHAR(64) NOT NULL, + source_tierlist_id VARCHAR(64) NULL DEFAULT NULL, source_topic_id VARCHAR(120) NOT NULL, target_topic_id VARCHAR(120) NOT NULL DEFAULT '', status VARCHAR(20) NOT NULL DEFAULT 'pending', @@ -478,6 +478,9 @@ async function ensureSchema() { description_snapshot TEXT NOT NULL, thumbnail_src_snapshot VARCHAR(255) NOT NULL DEFAULT '', items_json LONGTEXT NOT NULL, + groups_json LONGTEXT NOT NULL, + board_items_json LONGTEXT NOT NULL, + show_character_names_snapshot TINYINT(1) NOT NULL DEFAULT 0, created_at BIGINT NOT NULL, updated_at BIGINT NOT NULL, INDEX idx_template_requests_status_created (status, created_at), diff --git a/docs/history.md b/docs/history.md index 6afba71..9561fa0 100644 --- a/docs/history.md +++ b/docs/history.md @@ -645,6 +645,10 @@ - 작성자가 자기 티어표를 직접 삭제할 수 있어야 관리 흐름이 완결되므로, `내 티어표` 화면에 삭제 기능을 추가하기로 결정했다. - 사용자 커스텀 이미지는 서버 용량을 계속 차지하므로, 참조가 하나도 남지 않은 이미지(미사용 항목)를 식별하고 관리자 화면에서 개별/일괄 정리할 수 있도록 하기로 결정했다. +## 2026-04-03 v1.4.64 +- 운영/로컬 DB를 새로 미는 흐름을 공식화한 만큼, 더 이상 “기존 DB에서만 우연히 남아 있던 컬럼”에 기대지 않고 `ensureSchema()`의 신규 생성 정의만으로 관리자 화면 전체가 떠야 한다고 다시 정리했다. +- `template_requests`는 요청 목록 카드뿐 아니라 요청 미리보기와 이미지 참조 추적에도 쓰이므로, 저장 스냅샷 컬럼(`groups_json`, `board_items_json`, `show_character_names_snapshot`)을 초기 스키마에 반드시 포함하기로 결정했다. + ## 2026-04-03 v1.4.63 - 관리자/에디터 화면의 우측 패널은 Teleport로 공통 셸의 레일 DOM에 끼워 넣는 구조이므로, 라우트 변경 시 Teleport 대상 노드 자체를 조건부로 없애면 Vue 언마운트/패치 순서에 따라 DOM 기준점이 깨질 수 있다고 판단했다. - 따라서 `#local-right-rail-root`는 항상 렌더링해두고, 일반 화면에서는 숨김 클래스만 적용하는 방식으로 유지해 라우트 전환 안정성을 우선 확보하기로 결정했다. diff --git a/docs/spec.md b/docs/spec.md index 4f180f1..d82ea3b 100644 --- a/docs/spec.md +++ b/docs/spec.md @@ -139,6 +139,23 @@ - `userId`: string - `topicId`: string - `createdAt`: number +- `templateRequests` + - `id`: string + - `type`: string + - `requesterId`: string + - `sourceTierListId`: string | null + - `sourceTopicId`: string + - `targetTopicId`: string + - `status`: string + - `sourceTierListTitle`: string + - `sourceDescription`: string + - `thumbnailSrc`: string + - `items`: `{ id, src, label, origin }[]` + - `snapshotGroups`: `{ id, name, itemIds[] }[]` + - `snapshotItems`: `{ id, src, label, origin }[]` + - `snapshotShowCharacterNames`: boolean + - `createdAt`: number + - `updatedAt`: number ## 주요 API - 인증 diff --git a/docs/todo.md b/docs/todo.md index 01b2a98..f76879d 100644 --- a/docs/todo.md +++ b/docs/todo.md @@ -116,6 +116,7 @@ - 검색 결과 화면도 `pageHead` 구조로 맞췄으므로, 주요 목록 화면들 간 상단 여백과 타이포 리듬이 자연스러운지 한 번 더 비교 QA한다. - 주제 상세 컬렉션 화면은 `pageHead` 공통 레이아웃과 `/topics` 기본 경로로 옮겼으므로, 직접 진입·뒤로가기·검색 후 재진입 시 주소와 헤더 흐름이 자연스러운지 한 번 더 QA한다. - `/topics/:gameId`를 기본 경로로 세우고 `/games/:gameId`는 alias로 남겼으므로, 다음 단계에서는 에디터/검색/공유 흐름에서 어떤 링크를 새 경로로 더 전환할지 범위를 정한다. +- 신규 DB 기준 `template_requests` 스키마 누락은 보정했으므로, 운영 NAS에서 `down -v` 후 재배포했을 때 관리자 `/admin/featured`, `/admin/tierlists`, `/admin/users` 진입과 템플릿 요청/이미지 통계 API가 모두 500 없이 동작하는지 한 번 더 QA한다. - 운영 환경에서 `/favicon.svg`, `/favicon-32x32.png`가 `403 Forbidden`으로 떨어지는 현상이 남아 있으므로, 배포 컨테이너 안의 `/usr/share/nginx/html` 실제 파일/권한, 프런트 빌드 산출물 복사 상태, NAS 또는 Cloudflare 앞단 보안 규칙을 순서대로 확인한다. - 우측 레일 Teleport 대상 DOM을 상시 유지하는 방식으로 바꿨으므로, 관리자 `/admin/...` → 설정 `/profile` → 홈 `/`처럼 전용 우측 레일과 일반 우측 레일을 오가는 라우트 전환에서 콘솔 오류가 더 이상 재현되지 않는지 운영 브라우저로 한 번 더 QA한다. - 내부 리네이밍 2단계로 관리자 `selectedTemplate / templates / loadTemplate / refreshTemplates` 묶음까지 정리했으므로, 다음 단계에서는 `/games/:gameId` 라우트와 프런트 API 호출부를 어디까지 `topic/template` 의미로 감쌀지 범위를 먼저 정리한다. diff --git a/docs/update.md b/docs/update.md index 4c5a7fd..7fc5d36 100644 --- a/docs/update.md +++ b/docs/update.md @@ -1199,6 +1199,11 @@ - **아이템 카드 레이아웃 개선**: 아이템 목록과 추가 미리보기를 1:1 비율 기준으로 재구성하고 더 촘촘한 카드 그리드로 조정 - **레거시 파일 역할 정리**: `db.json`과 lowdb 관련 코드는 현재 MariaDB 기본 런타임에는 필수가 아니며, 마이그레이션/예외 fallback 용도임을 문서에 명시 +## 2026-04-03 v1.4.64 +- **신규 DB 관리자 페이지 500 수정**: 빈 DB를 새로 만든 직후 `/admin/...` 진입 시 `GET /api/admin/template-requests`와 `GET /api/admin/image-assets/stats`가 500으로 터지던 문제를 수정 +- **`template_requests` 초기 스키마 보정**: 새 테이블 생성 정의에 누락돼 있던 `groups_json`, `board_items_json`, `show_character_names_snapshot` 컬럼을 추가하고, `source_tierlist_id`는 요청 종류에 따라 비어 있을 수 있도록 `NULL` 허용으로 정리 +- **빈 DB 재현 검증**: 로컬 MariaDB를 `DROP DATABASE → CREATE DATABASE → ensureData()`로 다시 초기화한 뒤 `listAdminTemplateRequests()`가 `[]`, `getImageAssetStats()`가 0값 통계를 반환하는 것까지 직접 확인 + ## 2026-04-03 v1.4.63 - **우측 레일 Teleport 전환 안정화**: 관리자/에디터 전용 우측 패널이 사용하는 `#local-right-rail-root` DOM을 라우트에 따라 생성/삭제하지 않고 항상 유지하도록 바꿔, `/admin/...`에서 설정/다른 페이지로 이동하거나 새로고침 후 화면을 바꿀 때 Vue가 `nextSibling`/`emitsOptions` 기준점을 잃고 크래시하는 문제를 방지 - **정적 favicon 403 분리 확인**: 프런트 빌드 기준 `favicon.svg`, `favicon-32x32.png`, `apple-touch-icon.png` 파일은 레포와 Vite `public/` 출력에 존재함을 확인했고, 운영 환경의 favicon `403 Forbidden`은 코드 누락보다 컨테이너/정적 서빙/프록시 권한 쪽 후속 점검 항목으로 분리