업데이트 로그

2026-03-19 v0.1.0

초기 스캐폴딩: frontend/에 Vue3(Vite, JavaScript) 프로젝트 생성
라우팅/화면 골격: 게임 선택(/), 게임 허브(/games/:gameId), 에디터(/editor/:gameId/...), 로그인(/login), 내 티어표(/me), 관리자(/admin) 라우트 추가
레이아웃: 상단 네비게이션 + 기본 다크 UI 스타일 적용
백엔드 골격: backend/에 Express 서버 추가(세션 기반 인증, 게임/티어표 API, 업로드 경로)
저장소: 네이티브 DB 대신 파일 DB(lowdb)로 유저/게임/이미지/티어표 데이터 영속화
에디터 핵심 기능(1차): 그룹 이름/순서 편집, 아이템 드래그&드롭(풀↔그룹), 커스텀 이미지 추가, 보드 PNG 다운로드, 백엔드 저장/불러오기 연결
관리자 UI(1차): admin 전용 게임 추가 + 게임별 기본 이미지 업로드/목록 화면 추가
버그 수정: Vite 포트 변경(5174 등) 시 백엔드 CORS가 막히는 문제 해결(로컬 5170~5179 허용)
네비/권한 UX: 관리자 메뉴는 admin 로그인 시에만 노출, 로그인 대신 아바타 버튼/메뉴 노출
프로필: /profile 페이지 추가, 아바타 업로드 API(/api/auth/avatar) 및 표시 지원
에디터 버그 수정: 드래그 시 아이템들이 “묶음”으로 같이 움직이던 문제 해결(드롭 영역 DOM 구조/Sortable 옵션 수정), 드롭 영역 overflow/배치 레이아웃 개선

배포 설정 개선: 프런트엔드의 API/정적 파일 주소 하드코딩(http://localhost:5179)을 VITE_API_ORIGIN 기반으로 통합
백엔드 운영 설정 추가: CORS_ORIGINS, TRUST_PROXY, SESSION_COOKIE_SECURE, SESSION_COOKIE_SAME_SITE, SESSION_SECRET 환경변수 기반으로 NAS/리버스 프록시 배포 대응
업로드 파일명 안정화: 한글 원본 파일명 기반 저장을 제거하고 ASCII 안전 파일명으로 저장하도록 변경
티어표 데이터 정규화: 게임 이미지 경로가 절대 로컬 URL로 저장되지 않도록 저장/조회 시 /uploads/... 상대 경로로 정규화
프로젝트 점검 결과 문서화: DB 구조, 화면-파일 매핑, 코딩 규칙, 기술 명세, 남은 위험 요소를 docs/에 신규 정리

DB 마이그레이션 준비: 런타임 저장소를 MariaDB(MySQL 호환) 기준으로 재구성하고 backend/scripts/migrate-lowdb-to-mariadb.js 마이그레이션 스크립트 추가
데이터 구조 분리: 관리자 지정 아이템은 game_items, 유저 커스텀 이미지는 custom_items로 분리
프로필 개선: 작성자 닉네임 저장 지원, 아바타는 파일 선택 시 미리보기만 변경되고 저장 버튼 클릭 시 실제 반영되도록 수정
공개 티어표 목록 개선: 공개 티어표 목록에 작성자 닉네임(없으면 이메일) 표시
관리자 UI 개편: 게임 선택 전에는 우측 관리 패널을 숨기고, 선택 후에만 썸네일/아이템 관리가 보이도록 단계형 흐름으로 수정
관리자 레이아웃 수정: 새 게임 입력 필드와 카드 셀 overflow 문제를 줄이도록 box-sizing, 썸네일/아이템 카드 레이아웃 정리
커스텀 아이템 저장 흐름 수정: 에디터의 커스텀 이미지는 저장 시 서버 업로드 후 티어표에 반영되도록 변경

로컬 개발 환경 정렬: 기본 백엔드 실행 기준을 lowdb가 아닌 로컬 MariaDB로 전환
개발용 인프라 추가: 루트 docker-compose.yml에 MariaDB + phpMyAdmin 추가
실행 문서 정리: README.md, docs/local-mariadb.md, docs/spec.md에 로컬 MariaDB 실행 절차 반영
Fallback 분리: backend/package.json에 dev:lowdb, start:lowdb 예외 스크립트 추가