tier-maker/docs/update.md

업데이트 로그

2026-03-30 v1.2.7

• 공통 셸 아이콘형 정리: 좌측 내비와 우측 보조 패널의 임시 문자 배지를 간단한 SVG 아이콘형으로 바꾸고, 버튼/카드 라운드와 밀도를 통일
• 좌측 레일 정보 밀도 개선: 사용자 카드, 빠른 검색, 내비 버튼, 하단 로그인/관리자 버튼을 더 두꺼운 카드 문법으로 맞춰 피그마 톤에 가까운 레일 형태로 재정리
• 에디터 패널 감도 보정: 티어표 편집 화면의 보드, 보드 툴바, 우측 편집 패널, 아이템 풀/드롭존 카드의 배경·경계·라운드를 함께 정리해 공통 셸과 시각 언어를 맞춤

2026-03-30 v1.2.6

• 목록형 화면 카드 문법 통일: 홈, 게임 허브, 내 티어표, 즐겨찾기 화면의 카드형 목록을 동일한 썸네일/제목/작성자/메타 구조로 정리해 대시보드 톤을 맞춤
• 홈 화면 대시보드 재정렬: 메인 게임 라이브러리 화면에 상단 상태 카드와 CTA를 추가하고, 게임 카드는 16:9 썸네일 + ID 메타를 갖는 라이브러리 카드 형태로 재배치
• 게임 허브 헤더/검색 정리: 게임 허브는 상단 통계와 생성 버튼, 보조 설명을 포함한 헤더로 재구성하고, 공개 티어표 카드도 같은 카드 밀도로 재정리

2026-03-30 v1.2.5

• 관리자 로컬 우측 패널 이관: 관리자 화면도 공통 우측 패널 대신 화면 내부의 320px 전용 운영 패널을 사용하도록 정리하고, 탭·검색·필터·빠른 액션을 우측으로 이동
• 관리 화면 본문 집중도 개선: 중앙 영역은 상단 고정 게임 순서, 선택된 게임 상세, 커스텀 아이템 카드, 템플릿 요청/전체 티어표, 회원 카드 같은 실제 관리 대상만 남기고 빈 상태 안내도 별도 패널로 정리
• 관리자 셸 예외 확장: 공통 앱 셸에서 /admin도 전용 로컬 우측 패널을 사용하는 포커스 화면으로 분류해 generic 우측 문맥 카드가 중복 표시되지 않게 조정

2026-03-30 v1.2.4

• 비로그인 중복 안내 제거: 좌측 사이드 상단의 별도 로그인 안내 카드를 제거하고, 비로그인 상태에서는 좌측 하단 버튼만 로그인 진입점으로 사용하도록 단순화
• 에디터 우측 편집 패널 이관: 티어표 편집 화면의 제목, 설명, 대표 썸네일, 공개 여부, 저장/삭제/요청 액션을 중앙 상단이 아니라 독립 우측 편집 패널로 이동
• 공통 우측 패널 예외 처리: 티어표 편집 화면은 공통 우측 패널 대신 화면 내부 전용 편집 패널을 사용하도록 조정해, generic 안내 카드가 중복 표시되지 않게 정리

2026-03-30 v1.2.2

• 사이드 패널 폭 고정: 공통 앱 셸의 좌측 패널 폭을 248px, 우측 패널 폭을 320px 기준으로 재정의해 피그마 시안과 더 가깝게 맞춤
• 우측 패널 토글 추가: 상단 우측 토글 버튼으로 우측 패널을 접고 펼칠 수 있게 하고, 접힐 때는 중앙 작업 영역이 자연스럽게 확장되도록 전환 애니메이션을 추가
• 우측 패널 독립성 강화: 우측 패널은 본문과 별도 컬럼으로 유지하고, 닫힐 때도 본문 레이아웃과 분리된 독립 패널처럼 동작하도록 셸 구조를 조정

2026-03-30 v1.2.1

• 포커스 화면 폭 복구: 에디터·관리자·프로필·로그인 화면은 공통 우측 패널을 잠시 숨기고 중앙 작업 폭을 넓혀, 기존 기능 UI가 3단 셸과 충돌하며 깨지던 문제를 완화
• 목록 카드 밀도 재조정: 홈, 게임 허브, 내 티어표, 즐겨찾기 화면의 기본 컬럼 수를 줄여 현재 셸 폭 안에서도 카드가 과도하게 눌리지 않도록 정리
• 에디터/관리자 패널 안정화: 내부 작업 패널 색상과 폭을 새 셸 톤에 맞춰 다시 정리해, 중첩 패널 때문에 사용성이 무너지던 부분을 우선 복구

2026-03-30 v1.2.0

• 피그마 기반 공통 앱 셸 1차 적용: 상단 헤더 중심 구조를 좌측 내비게이션 / 중앙 워크스페이스 / 우측 컨텍스트 패널 3단 앱 셸로 재구성하고, 데스크톱 기준의 어두운 대시보드형 톤으로 전환
• 홈/목록 화면 카드 UI 리디자인: 홈, 게임 허브, 내 티어표, 즐겨찾기 화면의 카드 그리드와 툴바를 시안에 맞춰 더 조밀한 대시보드 형태로 재배치
• 전역 스타일 리셋 정리: 기존 Vite 기본 스타일 흔적을 제거하고, 서비스 전용 다크 테마와 입력/셀렉트/버튼 기본값을 새 레이아웃 기준으로 통일

2026-03-27 v0.1.52

• 관리자 완성본 프리뷰 전용화: 관리자 모달의 완성본 확인은 이제 전용 preview 모드로 열려 전역 헤더와 편집/탐색 UI 없이 보드만 깔끔하게 확인할 수 있도록 정리
• 티어표 기본 썸네일 자동 생성: 사용자가 별도 썸네일을 지정하지 않아도 저장 시 티어표에 포함된 아이템 중 대표 이미지를 골라 기본 썸네일을 자동으로 채우도록 보강
• 이력 문서 날짜순 재정리: docs/history.md를 날짜 역순 기준으로 다시 정렬해 오래된 2026-03-19 항목이 중간에 끼어 보이던 흐름을 바로잡음

2026-03-27 v0.1.51

• 관리자 티어표 미리보기 모달 추가: 템플릿 요청 관리와 전체 티어표 관리에서 원본 보기 / 완성본 보기를 눌러도 관리자 화면을 벗어나지 않도록, 확인용 미리보기를 모달 iframe으로 열도록 변경
• 템플릿 등록 요청 조건 단순화: freeform 템플릿 등록 요청은 더 이상 보드 비움을 요구하지 않고, 제목 직접 입력 + 커스텀 아이템 존재 조건 중심으로 단순화
• 등록 요청 안내 문구 조정: 요청 모달 안내를 “게임 이름을 구체적으로 적어 달라”는 방향으로 정리해, 관리자 식별성을 높이는 쪽으로 보강

2026-03-27 v0.1.50

• 신규 티어표 등록 요청 타이밍 수정: 막 저장한 티어표에서 곧바로 템플릿 등록 요청을 보낼 때도 new가 아닌 실제 저장된 티어표 ID로 이어서 요청하도록 수정해, 신규 작성 직후 요청 실패 문제를 해결

2026-03-27 v0.1.49

• 템플릿 등록 요청 모달 레이아웃 보정: 체크리스트 문구 줄바꿈과 버튼 겹침 문제를 수정하고, 설명은 좌측·상태 배지는 우측에 배치되도록 요청 모달 레이아웃을 다시 정리
• 관리자 티어표 화면 분리: 티어표 관리 탭 안에서 템플릿 요청 관리 / 전체 티어표 관리를 서브 탭으로 분리해, 요청 목록과 저장된 전체 티어표 목록이 섞여 보이지 않도록 개선
• 관리자 안내 문구 보강: 전체 티어표 목록은 요청과 별개로 저장된 티어표 전체를 보는 영역이라는 설명을 추가해 혼선을 줄이도록 보강

2026-03-27 v0.1.48

• 템플릿 등록 요청 체크리스트 모달 추가: freeform 템플릿 등록 요청 전 제목 직접 입력 여부, 보드 비움 상태를 확인하는 모달과 안내 문구를 추가하고, 조건이 맞을 때만 요청 버튼이 활성화되도록 조정
• 등록 요청 실패 원인 구체화: 템플릿 등록 요청 실패 시 제목 미입력, 보드 비우지 않음, 커스텀 아이템 없음, 중복 대기 요청 같은 주요 원인을 토스트로 구체적으로 안내하도록 보강
• 관리자 요청 목록 정리 문구 추가: 관리자 템플릿 요청 탭에서 반려 시 대기 목록에서 바로 제외된다는 안내와 반려 후 숨김 버튼 문구를 추가해 운영 관점의 흐름을 더 명확히 정리

2026-03-27 v0.1.47

• 템플릿 등록/업데이트 요청 추가: 사용자가 저장된 티어표를 기준으로 관리자에게 새 템플릿 등록 또는 기존 템플릿 업데이트 요청을 보낼 수 있도록 요청 API와 관리자 승인 흐름을 추가
• 커스텀 아이템 이름 편집 확장: 티어표 편집 화면에서 사용자가 직접 추가한 커스텀 아이템 이름을 정리할 수 있는 전용 입력 목록을 추가하고, 저장 시 MariaDB의 커스텀 아이템 라벨도 함께 동기화
• 관리자 요청 목록 추가: 관리자 티어표 관리 탭 상단에 처리 대기 중인 템플릿 요청 목록을 추가하고, 새 게임 템플릿 생성 승인과 기존 게임 템플릿 업데이트 승인을 바로 처리할 수 있게 개선

2026-03-27 v0.1.46

• 티어 행 아이템 제거 추가: 티어표 편집 화면에서 이미 등급 행에 넣은 아이템도 작은 제거 버튼으로 다시 아이템 풀로 빼낼 수 있도록 보강
• 회원 관리 보조 정보 확장: 관리자 회원 관리 카드에 아바타, 작성 티어표 수, 최근 활동 시각을 함께 표시해 운영 판단에 필요한 정보를 바로 확인할 수 있도록 개선

2026-03-27 v0.1.45

• 즐겨찾기 카드 액션 보정: 카드형 목록에서는 별표를 클릭 액션이 아닌 상태/개수 표시로만 보여주고, 실제 즐겨찾기 토글은 상세 화면에서 처리하도록 조정
• 토스트 중복/페이드아웃 개선: 같은 메시지 토스트는 하나로 합치고 카운트를 올리도록 변경했으며, 사라질 때는 짧은 페이드아웃 애니메이션을 적용

2026-03-27 v0.1.44

• 토스트 렌더링 버그 수정: 전역 토스트가 빈 카드 여러 개로 보이던 ref 참조 문제를 수정해 실제 메시지만 표시되도록 정리
• 공개 티어표 검색 추가: 게임별 공개 티어표 목록에서 제목/작성자 기준 검색이 가능하도록 검색창과 API 쿼리 지원 추가
• 내 즐겨찾기 페이지 추가: 사용자별 즐겨찾기 목록 화면과 즐겨찾기한 순 / 최신 업데이트순 / 인기순 정렬 옵션을 추가

2026-03-27 v0.1.43

• 전역 토스트 알림 추가: 저장/삭제/가져오기 같은 사용자 행동 피드백을 상단 인라인 경고 대신 우측 상단 토스트로 통일해 잠시 표시 후 자동으로 사라지도록 변경
• 관리자 티어표 아이템 가져오기 모달화: 티어표 관리의 추가 아이템 영역을 소형 그리드로 다듬고, 가져오기 시점에 기존 템플릿에 추가 / 새 템플릿 만들기를 선택하는 모달 흐름으로 재정리
• 티어표 즐겨찾기 추가: 공개 티어표 목록과 상세 화면에서 즐겨찾기 토글과 개수를 표시하고, MariaDB에 사용자별 즐겨찾기 이력을 저장하도록 확장

2026-03-26 v0.1.42

• 관리자 티어표 관리 탭 추가: 공개/비공개를 포함한 최근 티어표 전체를 관리자 화면에서 검색/페이지네이션으로 확인하고, 제목·작성자·게임·공개 여부를 함께 볼 수 있도록 보강
• 추가 아이템 승격 흐름 확장: 티어표 안에서 사용자가 추가한 커스텀 아이템을 관리자 화면에서 바로 특정 게임의 기본 템플릿으로 개별 또는 일괄 복제할 수 있도록 추가
• 커스텀 티어표 템플릿화 추가: freeform 티어표는 관리자 화면에서 새 게임 ID/이름을 입력해 별도 게임 템플릿으로 복제 생성할 수 있도록 지원
• 관리자 열람 권한 확장: 비공개 티어표도 관리자는 편집 화면에서 완성본을 열람할 수 있도록 상세 조회 권한을 확장

2026-03-26 v0.1.41

• 커스텀 아이템 승격 연결 수정: 관리자 아이템 관리의 기본 템플릿에 추가 버튼이 실제 API와 백엔드 승격 라우트로 연결되도록 누락된 프런트/백엔드 구현을 보완

2026-03-26 v0.1.40

• 기본 아이템 저장 UX 보강: 관리자 게임 관리에서 아이템 이름이 실제로 바뀐 경우에만 이름 저장 버튼이 활성화되도록 조정하고, 저장 중 상태를 버튼에 표시
• 커스텀 아이템 승격 추가: 관리자 아이템 관리에서 사용자 커스텀 이미지를 선택한 게임의 기본 템플릿으로 복제해 가져올 수 있도록 API와 UI를 추가

2026-03-26 v0.1.39

• 에디터 헤더 재구성: 티어표 편집 상단에서 게임명 kicker를 제거하고, 좌측 제목/설명 입력과 우측 썸네일 카드가 나란히 보이는 구조로 재정리
• 썸네일 영역 UX 개선: 썸네일 미리보기와 선택/제거 버튼을 하나의 카드 안에 묶고, 모바일에서도 버튼이 카드 아래로 무너지지 않도록 밀도 있게 조정

2026-03-26 v0.1.38

• 관리자 기본 아이템 이름 수정 추가: 게임 관리 화면의 현재 기본 아이템 목록에서 이름을 직접 수정하고 저장할 수 있도록 API와 UI를 보강
• 티어표 썸네일 추가: 티어표 편집 화면에서 별도 썸네일 이미지를 선택해 저장할 수 있도록 업로드 흐름을 추가하고, 게임별 공개 티어표/내 티어표 목록은 게임 카드처럼 상단 썸네일 + 하단 제목/작성자 정보 카드 구조로 변경

2026-03-26 v0.1.37

• 운영 포트 설정 반영: 프로덕션 컴포즈의 frontend/phpMyAdmin 외부 포트를 18080/18081 기준으로 유지하고, NAS 배포 문서와 기술 명세의 리버스 프록시 포트 안내도 동일하게 정리
• 인증 라우트 정리: NAS 로그인 문제를 확인하기 위해 넣었던 auth 디버그 로그를 제거하고, 실제 운영에 필요한 세션 저장 보강만 유지
• 이력 문서 정렬: docs/history.md를 날짜/버전 흐름에 맞게 다시 정리해 추적성을 높임

2026-03-26 v0.1.36

• 브라우저 탭 이름 변경: 프런트 문서 제목을 frontend에서 Tier Maker로 변경
• 무제목 티어표 기본값 조정: 사용자가 제목을 입력하지 않으면 이름 없음 + 날짜 대신 현재 게임명을 기본 제목으로 사용하도록 변경하고, 관리자 임의 삭제 안내 문구는 유지

2026-03-26 v0.1.35

• NAS Git 배포 절차 추가: UGREEN NAS에서 수동 복사 대신 git clone과 git pull 기반으로 운영 배포를 관리하는 절차를 배포 가이드에 정리
• v0.1.34 반영 명령 정리: 이미 수동 복사본이 있는 경우 새 clone으로 전환한 뒤 최신 이미지를 다시 빌드하는 순서를 문서화

2026-03-26 v0.1.34

• 파비콘 정적 요청 제거: 운영 환경에서 /favicon.svg가 403으로 막히는 경우를 피하기 위해, 별도 파일 대신 index.html 인라인 데이터 URL 파비콘으로 전환
• 관리자 기본 아이템 다중 업로드 추가: 게임 관리 화면에서 기본 아이템을 여러 장 드래그 앤 드롭 또는 다중 파일 선택으로 한 번에 추가할 수 있도록 변경하고, 기본 라벨은 파일명 기준으로 자동 생성

2026-03-26 v0.1.33

• [NAS] 요청 프로토콜 디버그: auth/login/auth/me에서 req.secure, req.protocol, x-forwarded-proto 값을 로그로 출력해 프록시/HTTPS 판단 문제를 확인

2026-03-26 v0.1.32

• [NAS] 인증 디버그 로그 추가: auth/login에서 req.session.save 성공/실패와 auth/me에서 세션 존재 여부를 콘솔 로그로 남겨 세션 쿠키 발급 문제를 빠르게 진단

2026-03-26 v0.1.31

• [NAS] 세션 쿠키 발급 강제: 백엔드 인증 라우트에서 req.session.save()를 명시 호출해 응답 전에 세션을 저장하고 Set-Cookie가 확실히 내려오도록 보강

2026-03-26 v0.1.30

• [NAS] /api 상대경로 호출: 운영(import.meta.env.PROD)에서는 http://localhost:... 같은 다른 origin으로 API를 호출하지 않도록, frontend/src/lib/runtime.js에서 /api 호출을 상대경로로 고정해 세션 쿠키가 정상 저장되도록 수정

2026-03-26 v0.1.29

• NAS 로그인 유지 수정: 프런트 Nginx가 백엔드에 전달하는 X-Forwarded-Proto를 https로 고정하고 Express 세션의 프록시 인지를 명시해, NAS HTTPS 리버스 프록시 뒤에서도 secure 세션 쿠키가 정상 발급되도록 조정
• 운영 템플릿 복구: 실수로 빠질 수 있는 .env.production.example를 다시 포함하고, NAS 재배포 시 최신 프런트 이미지를 다시 빌드하도록 문서 보강

2026-03-26 v0.1.28

• MariaDB healthcheck 완화: UGREEN NAS 첫 초기화 시간이 길어도 unhealthy로 오판하지 않도록 프로덕션 컴포즈의 DB healthcheck를 root 기준과 더 긴 start_period/retries로 조정
• NAS 장애 대응 문서화: ready for connections 이후에도 unhealthy가 뜨는 경우의 재기동 절차를 배포 가이드에 추가

2026-03-26 v0.1.27

• UGREEN NAS 배포 파일 추가: backend, frontend용 Dockerfile과 프런트 Nginx 프록시 설정, 프로덕션 전용 docker-compose.prod.yml 추가
• 운영 환경 예시 추가: .env.production.example로 MariaDB/세션 시크릿 환경변수 템플릿 제공
• 배포 문서화: tmaker.sori.studio 기준 NAS 리버스 프록시, 컨테이너 실행, 볼륨 구성 가이드를 문서에 정리

2026-03-26 v0.1.26

• 아이콘 크기 조절 추가: 티어표 편집기에서 48 / 60 / 80 / 100 / 120 단계로 아이콘 크기를 직접 바꿀 수 있도록 추가
• 기본 아이콘 크기 상향: 기본 .thumb 크기를 80px 기준으로 조정하고, 보드와 우측 아이템 목록에 함께 반영되도록 정리

2026-03-26 v0.1.25

• export 폭 추가 축소: 티어표 PNG export 보드 폭을 960px로 더 줄여 최종 저장 이미지가 지나치게 길어지지 않도록 조정

2026-03-26 v0.1.24

• 관리자 게임 순서 드래그 정렬 추가: 상단 고정 게임 목록을 위/아래 버튼뿐 아니라 드래그로도 순서를 바꿀 수 있도록 보강
• export 크기 재조정: 티어표 PNG export를 약 1360px 폭과 pixelRatio 1.5 기준으로 낮춰 아이콘이 과도하게 한 줄에 몰리지 않도록 수정
• 업로드 정책 문서화: 현재 아바타 3MB, 게임/커스텀 이미지 6MB 제한이 있으며 서버 저장 전 리사이즈/압축은 아직 하지 않는다는 점을 문서에 명시

2026-03-26 v0.1.23

• 홈 게임 정렬 규칙 변경: 일반 게임 목록은 상단 고정 순서 → 나머지 최신 생성순으로 정렬되도록 변경
• 관리자 게임 순서 편집 추가: 관리자 게임 관리 탭에서 최대 50개의 게임을 상단 고정 목록으로 선택하고 위/아래 순서를 저장할 수 있도록 추가
• 커스텀 티어표 진입점 변경: 홈 화면의 직접 티어표 만들기 카드를 제거하고 우측 상단 버튼형 진입점으로 변경

2026-03-26 v0.1.22

• 무제목 저장 규칙 변경: 제목을 비워두고 저장하면 내부 저장 제목을 이름 없음 + 날짜 형식으로 생성하도록 변경
• 무제목 안내 문구 추가: 제목 입력이 비어 있는 동안 관리자 임의 삭제 가능성을 알리는 경고 문구를 제목 입력 아래에 표시
• export 보드 확장: 다운로드용 티어표 이미지는 빈 칸 안내 문구를 숨기고, 약 1600px 폭과 더 넉넉한 여백, 하단 작성자/날짜 메타 정보를 포함하도록 조정

2026-03-26 v0.1.21

• 아바타 fallback 기준 통일: 티어표 목록에서 작성자 아바타 이미지가 없을 때 닉네임이 아니라 계정명 기준 첫 글자를 표시하도록 정리
• 저장 완료 모달 추가: 에디터에서 저장 성공 시 반투명 오버레이와 확인 버튼이 있는 피드백 모달을 표시하도록 추가
• 다운로드 이미지 여백 보강: PNG export 전용 보드에 외곽 패딩과 배경 여백을 넣어 콘텐츠가 가장자리에 붙어 보이지 않도록 조정

2026-03-19 v0.1.20

• 게임 선택 카드 순서 조정: 홈 화면에서 일반 게임 카드를 먼저 보여주고 직접 티어표 만들기 카드는 마지막에 배치
• 게임 카드 3열 레이아웃: PC 기준 게임 선택 화면 카드를 3열로 재구성하고, 썸네일을 16:9 비율로 통일
• 공개 티어표 카드 3열 레이아웃: 게임 허브의 공개 티어표 목록도 PC 기준 3열 카드형으로 재배치하고 태블릿/모바일에서는 자동 줄바꿈되도록 조정

2026-03-19 v0.1.19

• 에디터 저장 영역 재정렬: 공개 기본값을 ON으로 바꾸고, 액션 영역을 이미지 다운로드 / 삭제 / 공개 ON·OFF / 저장 흐름으로 재배치
• 에디터 삭제 진입점 추가: 기존 티어표는 편집 화면에서 바로 삭제할 수 있도록 버튼을 추가
• 목록 작성자 표시 개선: 공개 티어표와 내 티어표 목록의 제목 옆에 원형 아바타와 by 닉네임(없으면 계정명)을 표시
• 목록 메타 단순화: 티어표 카드 하단 정보는 게임 ID, 저장 시각, 라벨 문구를 제거하고 최종 업데이트 시각만 간략하게 노출

2026-03-19 v0.1.18

• 미사용 아이콘 필터 수정: 관리자 아이템 관리의 미사용 아이콘 보기 체크 상태가 실제 API 요청의 orphanOnly 파라미터로 전달되도록 수정
• 삭제 활성화 흐름 정상화: 미사용 아이콘만 조회했을 때 usageCount = 0 항목의 개별 삭제 버튼이 의도대로 활성화되도록 정리

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/배치 레이아웃 개선

2026-03-19 v0.1.1

• 티어표 메타데이터 개선: 제목 미입력 시 저장 시점에 게임 이름 기반 자동 제목 적용, 설명(선택) 필드 추가
• 시간 정보 표시: 내 티어표/공개 목록에서 저장 시간(createdAt)과 업데이트 시간(updatedAt)을 시:분:초까지 표시
• 에디터 UX 수정: 빈 티어 칸 안내 문구가 첫 드래그 배치를 가리던 문제 수정(오버레이 처리), 제목 상단에 게임 이름 표시

2026-03-19 v0.1.2

• 로그인 UI 개선: 로그인 카드 중앙 배치, 중복 타이틀 제거, 입력 overflow 수정, 엔터로 로그인/회원가입 제출
• 안내문 조건화: “첫 회원가입 계정은 admin” 문구는 유저가 0명일 때만 표시(/api/auth/meta)
• 게임 목록 UI 개선: 게임 카드에 썸네일 표시, 중복 텍스트 제거, “새로운 게임 제안” 모달 추가
• 관리자 기능 추가: 게임 썸네일 업로드 API(/api/admin/games/:gameId/thumbnail) 및 UI 추가
• 에디터 레이아웃 개선: 등급(그룹) 라벨 칼럼 확장으로 텍스트 잘림 방지, 설명 입력 1줄, 정렬을 좌측 기준으로 조정

2026-03-19 v0.1.3

• 배포 설정 개선: 프런트엔드의 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/에 신규 정리

2026-03-19 v0.1.4

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

2026-03-19 v0.1.5

• 로컬 개발 환경 정렬: 기본 백엔드 실행 기준을 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 예외 스크립트 추가

2026-03-19 v0.1.6

• 저장소 메타데이터 정리: Git 작성자 정보를 프로젝트 계정 기준으로 통일하고, 초기 릴리스 커밋 메시지를 한국어 기준으로 재작성
• 버전 관리 규칙 보강: 커밋 메시지 한국어 작성 및 문서 버전과 Git 태그를 함께 맞추는 규칙을 문서에 반영

2026-03-19 v0.1.7

• AI 작업 규칙 보강: ai-rules.md에 Git 작성자 정보, 한국어 커밋 메시지, 버전/태그 동기화, 민감 정보 확인 규칙 추가
• 관리자 화면 재구성: /admin을 좌우 병렬 구조에서 모드 선택 → 게임 선택/생성 → 선택된 게임 상세 관리 흐름으로 재구성
• 관리자 삭제 기능 추가: 등록된 게임 자체 삭제 및 등록된 아이템 개별 삭제 기능 추가
• 데이터 정합성 보강: 관리자 아이템 삭제 시 관련 티어표의 groups/pool 참조를 함께 정리하도록 백엔드 로직 보강

2026-03-19 v0.1.8

• 관리자 업로드 UX 개선: 썸네일과 아이템 추가 시 파일 선택 직후 미리보기 표시
• 썸네일 비율 정리: 관리자 썸네일 미리보기와 대표 썸네일 표시를 16:9, 약 256px 폭 기준으로 조정
• 아이템 카드 레이아웃 개선: 아이템 목록과 추가 미리보기를 1:1 비율 기준으로 재구성하고 더 촘촘한 카드 그리드로 조정
• 레거시 파일 역할 정리: db.json과 lowdb 관련 코드는 현재 MariaDB 기본 런타임에는 필수가 아니며, 마이그레이션/예외 fallback 용도임을 문서에 명시

2026-03-19 v0.1.9

• MariaDB 전용 전환 완료: backend/src/db.js에서 lowdb 분기와 DB_CLIENT 기반 fallback을 제거하고 MariaDB 전용 저장 계층으로 정리
• 레거시 파일 제거: backend/data/db.json, backend/scripts/migrate-lowdb-to-mariadb.js, dev:lowdb/start:lowdb/migrate:lowdb 스크립트 및 lowdb 의존성 제거
• 실행 문서 정리: README.md, docs/local-mariadb.md, docs/spec.md, docs/todo.md, docs/history.md를 현재 MariaDB 전용 개발/배포 흐름 기준으로 갱신

2026-03-19 v0.1.10

• 관리자 썸네일 액션 정리: 썸네일 버튼 문구를 썸네일 적용으로 바꾸고, 파일 선택 전에는 비활성화되도록 조정
• 아이템 추가 폼 정리: 아이템 이름 입력 너비를 줄이고, 과한 미리보기 안내 문구를 제거해 작업 집중도를 높임
• 반응형 미리보기 보정: 태블릿 이하 화면에서도 아이템 1:1 미리보기가 최대 192px 범위 안에서 보이도록 조정
• 파일 재선택 버그 수정: 아이템 추가나 게임 전환 뒤 파일 입력 값을 초기화해 같은 이미지를 다시 선택해도 정상 인식되도록 수정

2026-03-19 v0.1.11

• 관리자 레이아웃 재구성: 인라인 스타일을 제거하고, 썸네일 적용과 아이템 추가를 상단 2열 카드로 재배치한 뒤 아이템 목록은 하단 리스트로 분리
• 직접 티어표 만들기 추가: 홈 화면에 게임 카드와 동일한 형태의 직접 티어표 만들기 진입점을 추가하고, 내부 전용 freeform 게임 레코드로 1회성 빈 티어표 저장 흐름을 지원
• 게임 제안 흐름 제거: 홈 화면의 새로운 게임 제안 버튼/모달과 관련 프런트 API를 제거해 현재 운영 흐름에 맞게 단순화
• 커스텀 아이템 검토 영역 추가: 관리자 페이지에서 사용자 업로드 커스텀 아이템을 목록으로 보고 다운로드할 수 있는 검토 영역과 조회 API를 추가

2026-03-19 v0.1.12

• 전역 레이아웃 폭 정리: 앱 메인 영역의 고정 최대 너비를 제거해 배경과 페이지 폭이 잘린 듯 보이지 않도록 조정
• 작성 권한 제한: 비로그인 사용자는 새 티어표 작성 화면으로 직접 진입할 수 없도록 하고, 공개된 티어표는 읽기 전용으로만 보이게 조정
• 커스텀 이미지 업로드 개선: 에디터의 커스텀 이미지 추가 영역에 다중 파일 선택과 드래그 앤 드롭 업로드를 추가
• 회원 관리 추가: 관리자 페이지에서 가입 회원 목록 조회, 이메일/닉네임/권한 수정, 계정 삭제가 가능한 관리 영역과 API를 추가

2026-03-19 v0.1.13

• 관리자 탭 구조 정리: 관리자 페이지를 게임 관리 / 아이템 관리 / 회원 관리 탭으로 분리하고 기능별 작업 영역을 명확히 분리
• 커스텀 아이템 조회 강화: 사용자 커스텀 아이템 목록에 파일명 검색, 50/200 단위 페이지네이션, 다운로드 흐름 추가
• 회원 비밀번호 초기화 추가: 관리자 페이지와 API에서 회원 비밀번호를 직접 재설정할 수 있도록 기능 추가
• 가변 티어 행 지원: 티어표 에디터에서 S~D 고정 5단이 아니라 티어 행을 직접 추가/삭제할 수 있도록 보강

2026-03-19 v0.1.14

• 커스텀 아이템 카드 반응형 수정: 관리자 아이템 관리 탭의 커스텀 아이템 카드에서 이미지 폭을 유동값으로 조정하고, 텍스트 영역에 min-width: 0과 강제 줄바꿈 기준을 추가해 카드 바깥 overflow를 방지

2026-03-19 v0.1.15

• 셀렉트 화살표 여백 정리: 전역 select 스타일에 커스텀 화살표 위치와 오른쪽 여백을 추가해 텍스트와 화살표가 지나치게 붙지 않도록 조정
• 티어표 다운로드 결과 개선: TierEditorView의 이미지 저장을 Blob 다운로드 방식으로 바꾸고, 캡처 대상을 보드 영역만 포함하는 전용 export 뷰로 분리해 우측 아이템 영역과 편집용 버튼/입력 UI가 저장 이미지에 섞이지 않도록 수정

2026-03-19 v0.1.16

• 티어표 헤더 마감 정리: 제목/설명 입력을 각각 한 줄 폭으로 정리하고, 액션 영역과 분리해 헤더 가독성을 개선
• export 정보 보강: 이미지 저장 시 제목 아래에 설명이 함께 표시되도록 보강
• 보드 여백/정렬 정리: 보드 내부 패딩을 늘리고, 티어 그룹 제목을 중앙 정렬로 조정해 완성본 느낌을 개선

2026-03-19 v0.1.17

• 내 티어표 삭제 추가: 내 티어표 목록에서 작성자가 자신의 티어표를 직접 삭제할 수 있도록 삭제 버튼과 API를 추가
• 미사용 커스텀 이미지 관리 추가: 관리자 아이템 탭에서 커스텀 이미지의 사용 횟수를 표시하고, 미사용 항목만 따로 필터링해 개별/일괄 삭제할 수 있도록 보강