릴리스: v0.1.49 템플릿 요청 UI 분리와 모달 정리

backend/src/routes/tierlists.js

@@ -20,6 +20,7 @@ const { requireAuth } = require('../middleware/auth')
 
 const router = express.Router()
 const FREEFORM_GAME_ID = 'freeform'
+const FREEFORM_DEFAULT_TITLE = '직접 티어표 만들기'
 
 function normalizePoolItem(item) {
   if (!item || item.origin !== 'game' || typeof item.src !== 'string') return item
@@ -200,6 +201,9 @@ router.post('/:id/template-request', requireAuth, async (req, res) => {
   if (parsed.data.type === 'create') {
     if (tierList.gameId !== FREEFORM_GAME_ID) return res.status(400).json({ error: 'freeform_required' })
     if (!isTierListBoardEmpty(tierList)) return res.status(400).json({ error: 'board_must_be_empty' })
+    if (!(tierList.title || '').trim() || (tierList.title || '').trim() === FREEFORM_DEFAULT_TITLE) {
+      return res.status(400).json({ error: 'title_required' })
+    }
   } else {
     if (tierList.gameId === FREEFORM_GAME_ID) return res.status(400).json({ error: 'game_template_required' })
   }

docs/history.md

@@ -1,5 +1,14 @@
 # 의사결정 이력
 
+## 2026-03-27 v0.1.49
+- 템플릿 등록 요청 모달은 체크리스트 설명이 먼저 읽히고 상태가 우측에서 한눈에 보여야 하므로, 라벨 좌측·상태 우측 구조로 정리하기로 했다.
+- 관리자 입장에서는 `요청 목록`과 `저장된 전체 티어표 목록`이 서로 다른 성격이므로, 같은 화면 안에서도 서브 탭으로 분리해 맥락을 명확히 하는 편이 더 적합하다고 판단했다.
+
+## 2026-03-27 v0.1.48
+- 템플릿 등록 요청은 실패 원인이 불명확하면 혼란이 크므로, 요청 전에 체크리스트 모달로 조건을 먼저 확인시키고 조건이 맞을 때만 전송하게 하는 편이 낫다고 정리했다.
+- freeform 템플릿 등록 요청은 제목이 곧 게임 이름 후보가 되므로, 기본값이 아닌 사용자가 직접 입력한 제목을 요구하기로 했다.
+- 관리자 입장에서는 처리하지 않을 요청을 대기 목록에서 바로 치울 수 있어야 하므로, 반려는 단순 상태 변경이 아니라 “대기 목록에서 숨김”으로 인지되게 문구를 맞추기로 했다.
+
 ## 2026-03-27 v0.1.47
 - 새 게임 템플릿 등록과 기존 템플릿 업데이트는 운영자가 직접 일일이 훑기보다, 사용자가 명시적으로 요청을 보내고 관리자가 승인하는 흐름이 더 빠르고 명확하다고 정리했다.
 - 템플릿 요청에 포함되는 커스텀 아이템 이름은 관리자 판단의 핵심 정보이므로, 티어표 편집 화면 안에서도 직접 이름을 정리하고 저장 시 원본 커스텀 아이템 라벨까지 함께 동기화하기로 결정했다.

docs/spec.md

@@ -124,11 +124,12 @@
 - 사용자 업로드 커스텀 아이템은 관리자 화면의 아이템 관리 탭에서 검색, 페이지네이션, 다운로드할 수 있다.
 - 사용자 커스텀 아이템은 선택한 게임의 기본 템플릿으로 복제해 가져올 수 있다.
 - 커스텀 아이템은 사용 횟수(`usageCount`)를 표시하며, 미사용 항목만 필터링해 개별/일괄 삭제할 수 있다.
-- 관리자 화면에는 별도 `티어표 관리` 탭이 있으며, 최근 티어표 전체를 제목/게임/작성자 기준으로 검색하고 공개 여부를 함께 확인할 수 있다.
+- 관리자 화면에는 별도 `티어표 관리` 탭이 있으며, 내부에서 `템플릿 요청 관리 / 전체 티어표 관리`를 분리해 볼 수 있다.
 - `티어표 관리` 탭의 추가 아이템은 작은 그리드 카드로 표시하고, 클릭 시 `기존 템플릿에 추가 / 새 템플릿 만들기` 모달을 통해 목적지를 선택한다.
 - `티어표 관리` 탭에서는 티어표 안의 커스텀 아이템을 개별 또는 일괄로 기존 게임 템플릿에 복제할 수 있다.
 - `freeform` 티어표는 관리자 화면에서 새 게임 ID/이름을 입력해 새로운 게임 템플릿으로 복제 생성할 수 있다.
 - 관리자 티어표 관리 상단에는 사용자가 보낸 템플릿 등록/업데이트 요청 목록이 별도로 표시되며, 여기서 승인/반려를 바로 처리할 수 있다.
+- 관리자 템플릿 요청 목록에서 `반려 후 숨김`을 누르면 해당 요청은 pending 목록에서 즉시 제외된다.
 - 관리자 화면에서는 회원 이메일/닉네임/권한 수정, 비밀번호 초기화, 계정 삭제가 가능하다.
 - 회원 관리 카드에는 아바타, 작성 티어표 수, 최근 활동 시각을 함께 표시한다.
 
@@ -148,6 +149,7 @@
 - 제목이 비어 있는 상태로 저장하면 내부 제목은 현재 게임명을 기본값으로 사용한다.
 - 제목 입력이 비어 있는 동안에는 무분별한 도배 방지를 위한 관리자 임의 삭제 가능성 안내 문구를 표시한다.
 - `freeform` 티어표는 보드가 비어 있고 커스텀 아이템이 준비된 상태에서만 `템플릿 등록 요청`을 보낼 수 있다.
+- `템플릿 등록 요청` 전에는 체크리스트 모달로 `제목 직접 입력`, `보드 비움 상태`를 확인하고 두 조건이 충족될 때만 전송할 수 있다.
 - 기존 게임 티어표는 커스텀 아이템이 포함되어 있으면 `템플릿 업데이트 요청`을 보낼 수 있다.
 - 티어표는 편집 화면에서 16:9 썸네일 이미지를 별도로 선택해 저장할 수 있고, 목록 카드에서는 그 이미지를 상단 대표 썸네일로 사용한다.
 - 편집 화면 상단 헤더는 좌측 제목/설명, 우측 썸네일 카드 구조를 사용하며 모바일에서는 한 열로 접힌다.

docs/update.md

@@ -1,5 +1,15 @@
 # 업데이트 로그
 
+## 2026-03-27 v0.1.49
+- **템플릿 등록 요청 모달 레이아웃 보정**: 체크리스트 문구 줄바꿈과 버튼 겹침 문제를 수정하고, 설명은 좌측·상태 배지는 우측에 배치되도록 요청 모달 레이아웃을 다시 정리
+- **관리자 티어표 화면 분리**: `티어표 관리` 탭 안에서 `템플릿 요청 관리 / 전체 티어표 관리`를 서브 탭으로 분리해, 요청 목록과 저장된 전체 티어표 목록이 섞여 보이지 않도록 개선
+- **관리자 안내 문구 보강**: 전체 티어표 목록은 요청과 별개로 저장된 티어표 전체를 보는 영역이라는 설명을 추가해 혼선을 줄이도록 보강
+
+## 2026-03-27 v0.1.48
+- **템플릿 등록 요청 체크리스트 모달 추가**: freeform 템플릿 등록 요청 전 `제목 직접 입력 여부`, `보드 비움 상태`를 확인하는 모달과 안내 문구를 추가하고, 조건이 맞을 때만 요청 버튼이 활성화되도록 조정
+- **등록 요청 실패 원인 구체화**: 템플릿 등록 요청 실패 시 제목 미입력, 보드 비우지 않음, 커스텀 아이템 없음, 중복 대기 요청 같은 주요 원인을 토스트로 구체적으로 안내하도록 보강
+- **관리자 요청 목록 정리 문구 추가**: 관리자 템플릿 요청 탭에서 반려 시 대기 목록에서 바로 제외된다는 안내와 `반려 후 숨김` 버튼 문구를 추가해 운영 관점의 흐름을 더 명확히 정리
+
 ## 2026-03-27 v0.1.47
 - **템플릿 등록/업데이트 요청 추가**: 사용자가 저장된 티어표를 기준으로 관리자에게 `새 템플릿 등록` 또는 `기존 템플릿 업데이트` 요청을 보낼 수 있도록 요청 API와 관리자 승인 흐름을 추가
 - **커스텀 아이템 이름 편집 확장**: 티어표 편집 화면에서 사용자가 직접 추가한 커스텀 아이템 이름을 정리할 수 있는 전용 입력 목록을 추가하고, 저장 시 MariaDB의 커스텀 아이템 라벨도 함께 동기화

frontend/src/views/AdminView.vue

@@ -13,6 +13,7 @@ const toast = useToast()
 const isAdmin = computed(() => !!auth.user?.isAdmin)
 
 const activeTab = ref('games')
+const tierlistsMode = ref('requests')
 const gameMode = ref('existing')
 
 const games = ref([])
@@ -105,11 +106,19 @@ function resetMessages() {
 function setTab(tab) {
   resetMessages()
   activeTab.value = tab
+  if (tab === 'tierlists') {
+    tierlistsMode.value = 'requests'
+  }
   if (tab === 'items' && !customItemTargetGameId.value && games.value.length) {
     customItemTargetGameId.value = games.value[0].id
   }
 }
 
+function setTierlistsMode(mode) {
+  resetMessages()
+  tierlistsMode.value = mode
+}
+
 async function refreshGames() {
   try {
     const data = await api.listGames()
@@ -1084,11 +1093,20 @@ async function saveFeaturedOrder() {
         </template>
 
         <template v-else-if="activeTab === 'tierlists'">
-          <div class="panel">
+          <div class="modeTabs modeTabs--admin">
+            <button class="modeTab" :class="{ 'modeTab--active': tierlistsMode === 'requests' }" @click="setTierlistsMode('requests')">
+              템플릿 요청 관리
+            </button>
+            <button class="modeTab" :class="{ 'modeTab--active': tierlistsMode === 'lists' }" @click="setTierlistsMode('lists')">
+              전체 티어표 관리
+            </button>
+          </div>
+
+          <div v-if="tierlistsMode === 'requests'" class="panel">
             <div class="sectionHeader">
               <div>
                 <div class="panel__title">사용자 템플릿 요청</div>
-                <div class="hint hint--tight">freeform 템플릿 등록 요청과 기존 게임 템플릿 업데이트 요청을 여기서 승인하거나 반려할 수 있어요.</div>
+                <div class="hint hint--tight">freeform 템플릿 등록 요청과 기존 게임 템플릿 업데이트 요청을 여기서 승인하거나 반려할 수 있어요. 반려한 요청은 대기 목록에서 바로 제외됩니다.</div>
               </div>
               <button class="btn btn--ghost" @click="refreshTemplateRequests">새로고침</button>
             </div>
@@ -1125,17 +1143,17 @@ async function saveFeaturedOrder() {
                   <button class="btn btn--primary" :disabled="request.isHandling" @click="approveTemplateRequest(request)">
                     {{ request.isHandling ? '처리중...' : '승인' }}
                   </button>
-                  <button class="btn btn--danger" :disabled="request.isHandling" @click="rejectTemplateRequest(request)">반려</button>
+                  <button class="btn btn--danger" :disabled="request.isHandling" @click="rejectTemplateRequest(request)">반려 후 숨김</button>
                 </div>
               </article>
             </div>
           </div>
 
-          <div class="panel">
+          <div v-else class="panel">
             <div class="sectionHeader">
               <div>
                 <div class="panel__title">전체 티어표 관리</div>
-                <div class="hint hint--tight">공개/비공개를 포함한 최근 티어표를 모두 확인하고, 추가 아이템을 기존 게임 템플릿으로 승격하거나 커스텀 티어표를 새 게임 템플릿으로 만들 수 있어요.</div>
+                <div class="hint hint--tight">공개/비공개를 포함한 최근 티어표를 모두 확인하고, 추가 아이템을 기존 게임 템플릿으로 승격하거나 커스텀 티어표를 새 게임 템플릿으로 만들 수 있어요. 여기는 요청 목록과 별개로 전체 저장 티어표를 보는 영역입니다.</div>
               </div>
               <button class="btn btn--ghost" @click="refreshAdminTierLists">새로고침</button>
             </div>

frontend/src/views/TierEditorView.vue

@@ -37,6 +37,7 @@ const error = ref('')
 const isSaving = ref(false)
 const isExporting = ref(false)
 const isSaveModalOpen = ref(false)
+const isTemplateRequestModalOpen = ref(false)
 const ownerId = ref('')
 const authorName = ref('')
 const authorAccountName = ref('')
@@ -97,6 +98,19 @@ const canRequestTemplateCreate = computed(
 const canRequestTemplateUpdate = computed(
   () => canEdit.value && !isNewTierList.value && gameId.value !== 'freeform' && customItems.value.length > 0
 )
+const templateRequestChecks = computed(() => [
+  {
+    id: 'title',
+    label: '티어표 이름(게임 이름)을 직접 입력했는지',
+    passed: !!(title.value || '').trim() && (title.value || '').trim() !== (gameName.value || '').trim(),
+  },
+  {
+    id: 'empty-board',
+    label: '등록한 이미지를 티어에 배치하지 않은 원본 상태인지',
+    passed: !hasPlacedItems.value,
+  },
+])
+const canSubmitTemplateCreateRequest = computed(() => templateRequestChecks.value.every((item) => item.passed))
 
 watch(error, (message) => {
   if (!message) return
@@ -455,6 +469,14 @@ function closeSaveModal() {
   isSaveModalOpen.value = false
 }
 
+function openTemplateRequestModal() {
+  isTemplateRequestModalOpen.value = true
+}
+
+function closeTemplateRequestModal() {
+  isTemplateRequestModalOpen.value = false
+}
+
 async function removeTierList() {
   if (!canEdit.value || isNewTierList.value) return
   error.value = ''
@@ -494,8 +516,13 @@ async function requestTemplate(type) {
     isRequestingTemplate.value = true
     await persistTierList({ showModal: false })
     await api.requestTierListTemplate(tierListId.value, { type })
+    if (type === 'create') closeTemplateRequestModal()
     toast.success(type === 'create' ? '템플릿 등록 요청을 보냈어요.' : '템플릿 업데이트 요청을 보냈어요.')
   } catch (e) {
+    if (e?.status === 400 && e?.data?.error === 'title_required') {
+      toast.error('템플릿 등록 요청 전에는 티어표 이름을 직접 입력해주세요.')
+      return
+    }
     if (e?.status === 409) {
       toast.error('이미 처리 대기 중인 같은 요청이 있어요.')
       return
@@ -504,6 +531,10 @@ async function requestTemplate(type) {
       toast.error('템플릿 등록 요청은 보드를 비운 상태에서만 보낼 수 있어요.')
       return
     }
+    if (e?.status === 400 && e?.data?.error === 'custom_items_required') {
+      toast.error('먼저 커스텀 아이템을 추가한 뒤 요청해주세요.')
+      return
+    }
     toast.error(type === 'create' ? '템플릿 등록 요청에 실패했어요.' : '템플릿 업데이트 요청에 실패했어요.')
   } finally {
     isRequestingTemplate.value = false
@@ -629,9 +660,9 @@ onUnmounted(() => {
           v-if="canRequestTemplateCreate"
           class="btn btn--ghost"
           :disabled="isRequestingTemplate"
-          @click="requestTemplate('create')"
+          @click="openTemplateRequestModal"
         >
-          {{ isRequestingTemplate ? '요청중...' : '템플릿 등록 요청' }}
+          템플릿 등록 요청
         </button>
         <button
           v-if="canRequestTemplateUpdate"
@@ -660,6 +691,35 @@ onUnmounted(() => {
     </div>
   </div>
 
+  <div v-if="isTemplateRequestModalOpen" class="modalOverlay" @click.self="closeTemplateRequestModal">
+    <div class="modalCard" role="dialog" aria-modal="true" aria-labelledby="templateRequestTitle">
+      <div id="templateRequestTitle" class="modalCard__title">템플릿 등록 요청</div>
+      <div class="modalCard__desc">
+        여러 사용자가 비슷한 주제로 요청할 수 있으니, 관리자에게 전달되기 전에 아래 조건을 먼저 확인해주세요.
+      </div>
+      <div class="requestChecklist">
+        <div
+          v-for="check in templateRequestChecks"
+          :key="check.id"
+          class="requestChecklist__item"
+          :class="{ 'requestChecklist__item--passed': check.passed }"
+        >
+          <span class="requestChecklist__label">{{ check.label }}</span>
+          <span class="requestChecklist__icon">{{ check.passed ? '완료' : '확인 필요' }}</span>
+        </div>
+      </div>
+      <div class="requestChecklist__hint">
+        제목이 명확하고, 보드는 비워둔 채 원본 아이템만 정리되어 있을수록 관리자가 새 게임 템플릿으로 빠르게 등록하기 쉬워져요.
+      </div>
+      <div class="modalCard__actions">
+        <button class="btn btn--ghost" @click="closeTemplateRequestModal">취소</button>
+        <button class="btn btn--save" :disabled="!canSubmitTemplateCreateRequest || isRequestingTemplate" @click="requestTemplate('create')">
+          {{ isRequestingTemplate ? '요청중...' : '등록 요청 보내기' }}
+        </button>
+      </div>
+    </div>
+  </div>
+
   <section class="layout" :style="{ '--thumb-size': `${iconSize}px` }">
     <div ref="boardEl" class="board">
       <div v-if="canEdit && !isExporting" class="boardTools">
@@ -1017,6 +1077,48 @@ onUnmounted(() => {
   display: flex;
   justify-content: flex-end;
   margin-top: 8px;
+  flex-wrap: wrap;
+}
+.modalCard__actions .btn {
+  width: auto;
+  min-width: 120px;
+}
+.requestChecklist {
+  display: grid;
+  gap: 10px;
+}
+.requestChecklist__item {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) auto;
+  gap: 10px;
+  align-items: center;
+  padding: 10px 12px;
+  border-radius: 14px;
+  border: 1px solid rgba(251, 191, 36, 0.22);
+  background: rgba(251, 191, 36, 0.08);
+  line-height: 1.5;
+}
+.requestChecklist__item--passed {
+  border-color: rgba(52, 211, 153, 0.24);
+  background: rgba(52, 211, 153, 0.1);
+}
+.requestChecklist__label {
+  min-width: 0;
+  overflow-wrap: anywhere;
+}
+.requestChecklist__icon {
+  flex: 0 0 auto;
+  min-width: 68px;
+  font-size: 12px;
+  font-weight: 900;
+  opacity: 0.9;
+  text-align: right;
+  white-space: nowrap;
+}
+.requestChecklist__hint {
+  font-size: 13px;
+  line-height: 1.6;
+  opacity: 0.78;
 }
 .boardTools {
   display: flex;
@@ -1356,5 +1458,14 @@ onUnmounted(() => {
   .descInput {
     border-radius: 16px;
   }
+  .requestChecklist__item {
+    grid-template-columns: 1fr;
+  }
+  .requestChecklist__icon {
+    text-align: left;
+  }
+  .modalCard__actions .btn {
+    width: 100%;
+  }
 }
 </style>