릴리스: v1.3.60 관리자 공개 토글과 인증 새로고침 안정화

backend/src/db.js

@@ -73,6 +73,7 @@ function mapGameRow(row) {
     id: row.id,
     name: row.name,
     thumbnailSrc: row.thumbnail_src || '',
+    isPublic: row.is_public == null ? true : !!row.is_public,
     displayRank: row.display_rank == null ? null : Number(row.display_rank),
     createdAt: Number(row.created_at),
   }
@@ -256,11 +257,18 @@ async function ensureSchema() {
         id VARCHAR(120) PRIMARY KEY,
         name VARCHAR(120) NOT NULL,
         thumbnail_src VARCHAR(255) NOT NULL DEFAULT '',
+        is_public TINYINT(1) NOT NULL DEFAULT 1,
         display_rank INT NULL DEFAULT NULL,
         created_at BIGINT NOT NULL
       ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4
     `)
 
+    const gameIsPublicColumns = await query("SHOW COLUMNS FROM games LIKE 'is_public'")
+    if (!gameIsPublicColumns.length) {
+      await query('ALTER TABLE games ADD COLUMN is_public TINYINT(1) NOT NULL DEFAULT 1 AFTER thumbnail_src')
+      await query('UPDATE games SET is_public = 1 WHERE is_public IS NULL')
+    }
+
     const displayRankColumns = await query("SHOW COLUMNS FROM games LIKE 'display_rank'")
     if (!displayRankColumns.length) {
       await query('ALTER TABLE games ADD COLUMN display_rank INT NULL DEFAULT NULL AFTER thumbnail_src')
@@ -643,12 +651,14 @@ async function adminDeleteUser(id) {
   await query('DELETE FROM users WHERE id = ?', [id])
 }
 
-async function listGames(currentUserId = '') {
+async function listGames(currentUserId = '', options = {}) {
+  const includePrivate = !!options.includePrivate
   const rows = await query(
     `
-      SELECT id, name, thumbnail_src, display_rank, created_at
+      SELECT id, name, thumbnail_src, is_public, display_rank, created_at
       FROM games
       WHERE id <> ?
+      ${includePrivate ? '' : 'AND is_public = 1'}
       ORDER BY
         CASE WHEN display_rank IS NULL THEN 1 ELSE 0 END ASC,
         display_rank ASC,
@@ -669,7 +679,7 @@ async function listGames(currentUserId = '') {
 }
 
 async function findGameById(id) {
-  const rows = await query('SELECT id, name, thumbnail_src, display_rank, created_at FROM games WHERE id = ? LIMIT 1', [id])
+  const rows = await query('SELECT id, name, thumbnail_src, is_public, display_rank, created_at FROM games WHERE id = ? LIMIT 1', [id])
   return mapGameRow(rows[0])
 }
 
@@ -702,11 +712,12 @@ async function getGameDetail(gameId) {
   return { game, items }
 }
 
-async function createGame({ id, name }) {
-  await query('INSERT INTO games (id, name, thumbnail_src, display_rank, created_at) VALUES (?, ?, ?, ?, ?)', [
+async function createGame({ id, name, isPublic = true }) {
+  await query('INSERT INTO games (id, name, thumbnail_src, is_public, display_rank, created_at) VALUES (?, ?, ?, ?, ?, ?)', [
     id,
     name,
     '',
+    isPublic ? 1 : 0,
     null,
     now(),
   ])
@@ -718,6 +729,11 @@ async function updateGameThumbnail(gameId, thumbnailSrc) {
   return findGameById(gameId)
 }
 
+async function updateGameVisibility(gameId, isPublic) {
+  await query('UPDATE games SET is_public = ? WHERE id = ?', [isPublic ? 1 : 0, gameId])
+  return findGameById(gameId)
+}
+
 async function findImageAssetByHash(contentHash) {
   const rows = await query(
     'SELECT id, content_hash, src, label_override, mime_type, byte_size, original_byte_size, width, height, created_at FROM image_assets WHERE content_hash = ? LIMIT 1',
@@ -2004,6 +2020,11 @@ async function updateTemplateRequestStatus({ id, status }) {
   return findTemplateRequestById(id)
 }
 
+async function updateTemplateRequestTargetGame({ id, targetGameId }) {
+  await query('UPDATE template_requests SET target_game_id = ?, updated_at = ? WHERE id = ?', [targetGameId || '', now(), id])
+  return findTemplateRequestById(id)
+}
+
 async function deleteTierList(id) {
   await query('DELETE FROM tierlists WHERE id = ?', [id])
 }
@@ -2139,6 +2160,7 @@ module.exports = {
   getGameDetail,
   createGame,
   updateGameThumbnail,
+  updateGameVisibility,
   findImageAssetByHash,
   findImageAssetBySrc,
   findImageAssetById,
@@ -2184,4 +2206,5 @@ module.exports = {
   findTemplateRequestById,
   listAdminTemplateRequests,
   updateTemplateRequestStatus,
+  updateTemplateRequestTargetGame,
 }

backend/src/routes/admin.js

@@ -9,10 +9,12 @@ const {
   findUserById,
   findGameById,
   findGameItemById,
+  listGameItems,
   findImageAssetById,
   createGame,
   listGames,
   updateGameThumbnail,
+  updateGameVisibility,
   createGameItem,
   updateGameItemLabel,
   updateGameItemDisplayOrder,
@@ -33,6 +35,7 @@ const {
   listAdminTemplateRequests,
   findTemplateRequestById,
   updateTemplateRequestStatus,
+  updateTemplateRequestTargetGame,
   adminUpdateUser,
   adminUpdateUserPassword,
   adminDeleteUser,
@@ -65,6 +68,17 @@ function buildItemLabelFromFilename(file) {
   return normalized || 'item'
 }
 
+function buildItemLabelFromSrc(src) {
+  const raw = typeof src === 'string' ? src : ''
+  const base = path.basename(raw.split('?')[0] || '', path.extname(raw.split('?')[0] || ''))
+  const normalized = base
+    .replace(/[_-]+/g, ' ')
+    .replace(/\s+/g, ' ')
+    .trim()
+    .slice(0, 60)
+  return normalized || 'item'
+}
+
 const upload = createMemoryUpload(multer, { fileSize: 8 * 1024 * 1024, maxCount: 50 })
 const avatarUpload = createMemoryUpload(multer, { fileSize: 4 * 1024 * 1024 })
 
@@ -93,13 +107,36 @@ function canManageAdminRole(actingUser, primaryAdmin) {
 }
 
 router.post('/games', requireAdmin, async (req, res) => {
-  const schema = z.object({ id: z.string().min(1), name: z.string().min(1).max(60) })
+  const schema = z.object({
+    id: z.string().min(1),
+    name: z.string().min(1).max(60),
+    isPublic: z.boolean().optional().default(false),
+    thumbnailSrc: z.string().max(255).optional().default(''),
+  })
   const parsed = schema.safeParse(req.body)
   if (!parsed.success) return res.status(400).json({ error: 'bad_request' })
   const exists = await findGameById(parsed.data.id)
   if (exists) return res.status(409).json({ error: 'game_id_taken' })
-  const game = await createGame({ id: parsed.data.id, name: parsed.data.name })
-  res.json({ game })
+  const game = await createGame({ id: parsed.data.id, name: parsed.data.name, isPublic: parsed.data.isPublic })
+  if (parsed.data.thumbnailSrc) {
+    const copiedThumb = await copyUploadIntoGameAsset(parsed.data.thumbnailSrc)
+    await updateGameThumbnail(game.id, copiedThumb)
+  }
+  res.json({ game: await findGameById(game.id) })
+})
+
+router.patch('/games/:gameId', requireAdmin, async (req, res) => {
+  const schema = z.object({
+    isPublic: z.boolean(),
+  })
+  const parsed = schema.safeParse(req.body)
+  if (!parsed.success) return res.status(400).json({ error: 'bad_request' })
+
+  const game = await findGameById(req.params.gameId)
+  if (!game) return res.status(404).json({ error: 'not_found' })
+
+  const updated = await updateGameVisibility(game.id, parsed.data.isPublic)
+  res.json({ game: updated })
 })
 
 router.patch('/games/display-order', requireAdmin, async (req, res) => {
@@ -109,7 +146,7 @@ router.patch('/games/display-order', requireAdmin, async (req, res) => {
   const parsed = schema.safeParse(req.body)
   if (!parsed.success) return res.status(400).json({ error: 'bad_request' })
 
-  const games = await listGames()
+  const games = await listGames('', { includePrivate: true })
   const validGameIds = new Set(games.map((game) => game.id))
   const filteredIds = parsed.data.gameIds.filter((gameId) => validGameIds.has(gameId))
   const updatedGames = await updateGameDisplayOrder(filteredIds)
@@ -391,9 +428,25 @@ async function promoteLibraryItemToGameItem({ item, gameId }) {
 }
 
 async function copyUploadIntoGameAsset(src) {
-  if (typeof src !== 'string' || !src.startsWith('/uploads/')) return src || ''
-  if (src.startsWith('/uploads/assets/')) return src
-  return src
+  if (typeof src !== 'string') return ''
+  const raw = src.trim()
+  if (!raw) return ''
+
+  if (raw.startsWith('/uploads/')) {
+    if (raw.startsWith('/uploads/assets/')) return raw
+    return raw
+  }
+
+  try {
+    const url = new URL(raw)
+    if (url.pathname.startsWith('/uploads/')) {
+      return url.pathname
+    }
+  } catch (error) {
+    return raw
+  }
+
+  return raw
 }
 
 function uniqueTierListPoolItems(tierList) {
@@ -427,10 +480,17 @@ async function promoteTierListItemsToGame({ tierList, gameId, itemIds = [] }) {
 }
 
 async function promoteSnapshotItemsToGame({ items, gameId }) {
+  const existingItems = await listGameItems(gameId)
+  const existingSrcs = new Set(
+    existingItems
+      .map((item) => (typeof item?.src === 'string' ? item.src.trim() : ''))
+      .filter(Boolean)
+  )
   const createdItems = []
 
   for (const item of items || []) {
     const copiedSrc = await copyUploadIntoGameAsset(item.src)
+    if (!copiedSrc || existingSrcs.has(copiedSrc)) continue
     createdItems.push(
       await createGameItem({
         id: nanoid(),
@@ -439,23 +499,40 @@ async function promoteSnapshotItemsToGame({ items, gameId }) {
         label: item.label,
       })
     )
+    existingSrcs.add(copiedSrc)
   }
 
   return createdItems
 }
 
-function pickTemplateRequestItems(templateRequest, itemIds = [], itemLabels = {}) {
+function pickTemplateRequestItems(templateRequest, itemIds = [], itemLabels = {}, itemSrcs = []) {
   const requestedIds = new Set((itemIds || []).filter(Boolean))
+  const requestedSrcs = new Set((itemSrcs || []).filter((src) => typeof src === 'string' && src.trim()).map((src) => src.trim()))
   const items = Array.isArray(templateRequest?.items) ? templateRequest.items : []
-  const filtered = requestedIds.size ? items.filter((item) => item?.id && requestedIds.has(item.id)) : items
-  return filtered.map((item) => ({
-    ...item,
-    label: typeof itemLabels?.[item.id] === 'string' && itemLabels[item.id].trim() ? itemLabels[item.id].trim().slice(0, 60) : item.label,
-  }))
+  const filtered =
+    requestedIds.size || requestedSrcs.size
+      ? items.filter((item) => (item?.id && requestedIds.has(item.id)) || (typeof item?.src === 'string' && requestedSrcs.has(item.src.trim())))
+      : items
+  return filtered
+    .filter((item) => typeof item?.src === 'string' && item.src.trim())
+    .map((item) => {
+      const draftLabel =
+        typeof itemLabels?.[item.id] === 'string' && itemLabels[item.id].trim()
+          ? itemLabels[item.id].trim().slice(0, 60)
+          : typeof item?.label === 'string' && item.label.trim()
+            ? item.label.trim().slice(0, 60)
+            : buildItemLabelFromSrc(item.src)
+
+      return {
+        ...item,
+        src: item.src.trim(),
+        label: draftLabel,
+      }
+    })
 }
 
 async function createGameTemplateFromTierList({ tierList, gameId, gameName }) {
-  await createGame({ id: gameId, name: gameName })
+  await createGame({ id: gameId, name: gameName, isPublic: false })
   if (tierList.thumbnailSrc) {
     const copiedThumb = await copyUploadIntoGameAsset(tierList.thumbnailSrc)
     await updateGameThumbnail(gameId, copiedThumb)
@@ -478,7 +555,7 @@ async function createGameTemplateFromTierList({ tierList, gameId, gameName }) {
 }
 
 async function createGameTemplateFromRequest({ templateRequest, gameId, gameName }) {
-  await createGame({ id: gameId, name: gameName })
+  await createGame({ id: gameId, name: gameName, isPublic: false })
 
   if (templateRequest.thumbnailSrc) {
     const copiedThumb = await copyUploadIntoGameAsset(templateRequest.thumbnailSrc)
@@ -636,12 +713,19 @@ router.post('/template-requests/:requestId/approve', requireAdmin, async (req, r
 })
 
 router.post('/template-requests/:requestId/review', requireAdmin, async (req, res) => {
-  const templateRequest = await findTemplateRequestById(req.params.requestId)
+  let templateRequest = await findTemplateRequestById(req.params.requestId)
   if (!templateRequest) return res.status(404).json({ error: 'not_found' })
   if (templateRequest.status === 'completed' || templateRequest.status === 'rejected' || templateRequest.status === 'approved') {
     return res.status(409).json({ error: 'request_already_handled' })
   }
 
+  if (templateRequest.type === 'create' && templateRequest.targetGameId && !templateRequest.targetGameName) {
+    templateRequest = await updateTemplateRequestTargetGame({
+      id: templateRequest.id,
+      targetGameId: '',
+    })
+  }
+
   if (templateRequest.status === 'reviewing') {
     return res.json({ request: templateRequest })
   }
@@ -650,11 +734,36 @@ router.post('/template-requests/:requestId/review', requireAdmin, async (req, re
   res.json({ request })
 })
 
+router.post('/template-requests/:requestId/link-game', requireAdmin, async (req, res) => {
+  const schema = z.object({
+    gameId: z.string().trim().min(1).max(120),
+  })
+  const parsed = schema.safeParse(req.body)
+  if (!parsed.success) return res.status(400).json({ error: 'bad_request' })
+
+  const templateRequest = await findTemplateRequestById(req.params.requestId)
+  if (!templateRequest) return res.status(404).json({ error: 'not_found' })
+  if (templateRequest.type !== 'create') return res.status(409).json({ error: 'create_request_required' })
+  if (!['pending', 'reviewing'].includes(templateRequest.status)) {
+    return res.status(409).json({ error: 'request_already_handled' })
+  }
+
+  const game = await findGameById(parsed.data.gameId)
+  if (!game) return res.status(404).json({ error: 'game_not_found' })
+
+  const request = await updateTemplateRequestTargetGame({
+    id: templateRequest.id,
+    targetGameId: game.id,
+  })
+  res.json({ request })
+})
+
 router.post('/template-requests/:requestId/promote-items', requireAdmin, async (req, res) => {
   const schema = z.object({
     gameId: z.string().trim().min(1).max(120),
     itemIds: z.array(z.string().min(1)).optional().default([]),
-    itemLabels: z.record(z.string().min(1).max(60)).optional().default({}),
+    itemSrcs: z.array(z.string().min(1)).optional().default([]),
+    itemLabels: z.record(z.string(), z.string().min(1).max(60)).optional().default({}),
   })
   const parsed = schema.safeParse(req.body)
   if (!parsed.success) return res.status(400).json({ error: 'bad_request' })
@@ -668,10 +777,32 @@ router.post('/template-requests/:requestId/promote-items', requireAdmin, async (
   const game = await findGameById(parsed.data.gameId)
   if (!game) return res.status(404).json({ error: 'game_not_found' })
 
-  const items = await promoteSnapshotItemsToGame({
-    items: pickTemplateRequestItems(templateRequest, parsed.data.itemIds, parsed.data.itemLabels),
-    gameId: game.id,
-  })
+  const promotableItems = pickTemplateRequestItems(templateRequest, parsed.data.itemIds, parsed.data.itemLabels, parsed.data.itemSrcs)
+  if (!promotableItems.length) {
+    return res.status(400).json({ error: 'no_items_selected' })
+  }
+
+  let items = []
+  try {
+    items = await promoteSnapshotItemsToGame({
+      items: promotableItems,
+      gameId: game.id,
+    })
+  } catch (error) {
+    console.error('[admin] template request promote-items failed', {
+      requestId: templateRequest.id,
+      gameId: game.id,
+      itemCount: promotableItems.length,
+      message: error?.message || 'unknown_error',
+      code: error?.code || '',
+      stack: error?.stack || '',
+    })
+    return res.status(500).json({
+      error: 'promote_items_failed',
+      detail: error?.message || 'unknown_error',
+      code: error?.code || '',
+    })
+  }
 
   const request =
     templateRequest.status === 'reviewing'

backend/src/routes/games.js

@@ -5,7 +5,7 @@ const { requireAuth } = require('../middleware/auth')
 const router = express.Router()
 
 router.get('/', async (req, res) => {
-  const games = await listGames(req.session?.userId || '')
+  const games = await listGames(req.session?.userId || '', { includePrivate: !!req.session?.isAdmin })
   res.json({ games })
 })
 
@@ -30,6 +30,7 @@ router.delete('/:gameId/favorite', requireAuth, async (req, res) => {
 router.get('/:gameId', async (req, res) => {
   const detail = await getGameDetail(req.params.gameId)
   if (!detail) return res.status(404).json({ error: 'not_found' })
+  if (!detail.game.isPublic && !req.session?.isAdmin) return res.status(404).json({ error: 'not_found' })
   res.json({ game: detail.game, items: detail.items })
 })
 

docs/history.md

@@ -1,5 +1,31 @@
 # 의사결정 이력
 
+## 2026-04-02 v1.3.60
+- 관리자 접근 차단은 유지하되, 이미 로그인된 관리자가 새로고침할 때 홈으로 튕기는 체감은 권한 제어보다 더 큰 문제이므로 인증 결과가 나올 때까지 같은 세션 확인 요청을 기다리는 편이 맞다고 정리했다.
+- 관리자 썸네일 드롭존과 에디터 보드 드롭존은 기능은 같아도 현재 상태가 문구와 형태로 바로 드러나야 하므로, 빈 상태와 교체 상태를 텍스트로 구분하고 점선 박스 형태를 더 적극적으로 드러내는 쪽으로 판단했다.
+
+## 2026-04-02 v1.3.59
+- 템플릿 요청 아이템 반영은 관리자 주의에만 맡기기보다, 서버에서 같은 게임 안의 동일 `src` 중복 생성을 막고 프런트에서도 이미 반영된 요청 아이템을 다시 드래프트에 올리지 않는 편이 운영 안정성에 더 낫다고 정리했다.
+- 신규 템플릿 요청은 “완전한 임시 게임” 구조로 바로 바꾸기보다, 우선 한 번 만든 게임을 요청과 연결해 다시 `확인하기`를 눌러도 같은 게임을 재사용하게 만드는 편이 리스크 대비 효과가 크다고 판단했다.
+- 신규 템플릿 요청 카드는 생성 여부가 관리자의 머릿속 상태가 아니라 UI 메타로 드러나야 하므로, `연결된 게임 있음/없음`과 `이미 반영 n개`를 카드와 작업 패널 양쪽에서 함께 보여주는 편이 맞다고 정리했다.
+
+## 2026-04-02 v1.3.55
+- 관리자 요청/업로드 배지는 문구만 다르면 빠르게 구분하기 어려우므로, 같은 `pill` 구조를 유지하되 색으로도 역할을 나누는 편이 운영 판단에 더 적합하다고 정리했다.
+- 신규 템플릿 요청으로 새 게임을 만들 때는 아이템만 가져오고 썸네일이 비어 있으면 식별성이 떨어지므로, 요청 썸네일도 기본값으로 함께 승계하는 편이 맞다고 판단했다.
+
+## 2026-04-02 v1.3.54
+- 관리자 요청 카드는 운영자가 이미 흐름을 알고 있다는 전제에서, 설명형 힌트보다 즉시 판단에 필요한 메타와 액션만 남기는 편이 더 적합하다고 정리했다.
+- 요청 종류 표시는 중복 텍스트보다 오른쪽 상단의 짧은 상태 배지 하나로 고정하고, 하단 액션 줄은 `보조 링크는 왼쪽 / 실제 처리 버튼은 오른쪽` 구조가 더 읽기 쉽다고 판단했다.
+
+## 2026-04-02 v1.3.53
+- 관리자 후속 리팩터링은 남은 큰 액션 묶음인 `상단 고정 게임 정렬`과 `커스텀 아이템 검수`부터 composable로 분리하는 편이 `AdminView.vue` 체감 복잡도를 가장 빨리 낮춘다고 판단했다.
+- 이 단계에서도 레이아웃이나 문구보다 로직 책임 경계를 먼저 옮기고, 실제 스타일 파일 분리는 그 다음 단계로 이어가는 편이 안전하다고 정리했다.
+
+## 2026-04-02 v1.3.52
+- 관리자 화면은 본문을 컴포넌트로 나눈 뒤에도 같은 시각 문법을 유지해야 하므로, `scoped`를 유지한 채 각 섹션에 스타일을 복붙하기보다 관리자 범위 공통 스타일로 다시 묶는 편이 더 안전하다고 정리했다.
+- `템플릿 요청 관리 / 전체 티어표 관리` 내부 모드 값은 URL과 버튼 상태가 어긋나지 않도록 `all` 하나로 통일하는 편이 맞다고 판단했다.
+- 릴리스 기록은 문서 버전만 올라가고 태그가 빠지면 추적이 끊기므로, 뒤늦게라도 누락 태그를 다시 맞춰 버전 흐름을 복구하는 편이 낫다고 정리했다.
+
 ## 2026-04-02 v1.3.51
 - 관리자 리팩터링은 본문 분리 다음 단계에서 `회원 관리`처럼 모달과 부수 액션이 많은 영역을 composable로 떼어내는 편이 효과가 크다고 판단했다.
 - 이 단계에서는 UI 문구나 사용자가 이미 손본 CSS를 다시 건드리기보다, 현재 동작을 유지한 채 책임 경계만 옮기는 쪽이 더 안전하다고 정리했다.

docs/todo.md

@@ -1,9 +1,18 @@
 # 할 일 및 이슈
 
+## 단기 확인
+- 관리자 계정으로 `/admin/...`을 직접 새로고침했을 때 홈으로 튕기지 않고 그대로 유지되는지, 실제 세션이 살아 있는 브라우저와 만료된 브라우저 각각에서 한 번 더 QA한다.
+- 티어표 만들기 화면의 보드 드롭존은 점선/높이/중앙 정렬로 존재감이 커졌으므로, 데스크톱과 모바일에서 파일 선택 버튼과 안내 문구 밀도를 한 번 더 QA한다.
+
 ## 중기 개선
+- 신규 템플릿 요청은 현재 `첫 생성 1회 후 요청과 게임을 연결해 재사용` 단계까지 정리했으므로, 다음 단계에서는 정말로 게임을 DB에 만들기 전까지 임시 작업 상태로 유지할지 여부를 운영 흐름 기준으로 결정한다.
+- 관리자 템플릿 요청은 동일 `src` 중복 생성 방지와 `연결된 게임/이미 반영 n개` 표시까지 붙였으므로, 이후에는 요청별 반영 이력(예: 어떤 아이템을 언제 반영했는지)까지 별도로 남길지 검토한다.
 - 관리자 URL 분리는 시작했으므로, 다음 단계에서는 `AdminView.vue` 단일 대형 파일을 섹션별 뷰/컴포저블로 쪼개고 직접 진입 시 선택 게임/요청 작업 상태 복원 범위도 함께 정리한다.
-- 관리자 본문 컴포넌트 분리와 `게임/템플릿 요청/회원 관리` composable 분리는 시작했으므로, 다음 단계에서는 `아이템 관리`와 `목록 관리`도 같은 기준으로 옮기고 공통 모달 상태를 어느 계층에서 소유할지 정리한다.
+- 관리자 본문 컴포넌트 분리와 `게임/템플릿 요청/회원 관리/아이템 관리/목록 관리` composable 분리는 시작했으므로, 다음 단계에서는 공통 모달 상태를 어느 계층에서 소유할지 정리하고 남은 관리자 유틸 함수를 더 줄인다.
 - 관리자 화면은 섹션 경로 분리까지 끝났으므로, 다음 단계에서는 `AdminView.vue`를 실제 레이아웃 뷰와 섹션별 라우트 컴포넌트로 더 쪼갤지 결정한다.
+- 관리자 공통 스타일은 `adminUiScope` 기준으로 다시 묶었으므로, 다음 단계에서는 각 섹션을 별도 파일로 완전히 분리할 때 스타일도 `admin.css` 또는 섹션별 스타일로 옮길지 결정한다.
+- 관리자 요청 카드 밀도는 줄였으므로, 다음 단계에서는 전체 티어표 카드와 요청 카드의 상단/하단 액션 정렬을 한 번 더 통일할지 비교 QA한다.
+- 신규 템플릿 요청 썸네일 기본 승계는 붙였으므로, 다음 단계에서는 요청 아이템 반영 후 `처리 완료`까지의 관리자 흐름을 실제 데이터로 한 번 더 QA한다.
 - 관리자 게임 아이템 순서 저장은 추가됐으므로, 다음 단계에서는 새 아이템 추가 직후 `자동 맨 앞 배치`와 `관리자 수동 고정 순서`의 우선순위를 실제 운영 흐름 기준으로 한 번 더 QA한다.
 - 관리자 템플릿 요청 미리보기는 실제 완성본 iframe 방식과의 체감 차이를 마지막으로 한 번 더 QA한다.
 - 라이트모드/다크모드 2차 보정까지 반영했으므로, 남은 작업은 전체 화면을 실제 사용 흐름으로 돌려 보며 대비·명도·아이콘 가독성을 미세하게 QA하는 최종 테마 점검 단계로 가져간다.

docs/update.md

@@ -1,5 +1,37 @@
 # 업데이트 로그
 
+## 2026-04-02 v1.3.60
+- 관리자 게임 관리의 대표 썸네일 드롭존은 이제 썸네일이 없을 때는 `클릭 & 드래그`, 이미 등록된 썸네일이 있을 때는 `썸네일 변경`으로 문구가 바뀌어 현재 동작을 더 바로 읽을 수 있게 함.
+- 관리자 인증 상태는 라우터 가드와 앱 셸이 동시에 `/api/auth/me`를 호출할 때, 가드가 아직 끝나지 않은 요청을 기다리지 못해 새로고침 직후 홈으로 튕기던 흐름이 있었으므로 인증 스토어에서 진행 중인 `refresh` Promise를 재사용하도록 정리함.
+- 따라서 관리자 계정으로 로그인된 상태에서는 `/admin/...` 경로를 새로고침해도 세션 확인이 끝날 때까지 같은 요청을 기다린 뒤 관리자 화면에 남도록 안정성을 보강함.
+- 티어표 만들기 화면의 보드 드롭존은 점선 테두리, 더 높은 박스, 중앙 정렬된 안내 문구와 버튼을 적용해 커스텀 이미지 추가 영역임을 더 즉시 인식할 수 있게 조정함.
+
+## 2026-04-02 v1.3.59
+- 관리자 템플릿 요청의 `promote-items` 처리에서는 잘못된 `z.record` 스키마 때문에 500이 나던 서버 파싱 버그를 수정하고, 요청 아이템 `src`까지 함께 받아 실제 요청 데이터와 더 안정적으로 매칭하도록 보강함.
+- 요청 아이템을 게임에 반영할 때는 이제 같은 게임 안에 동일한 `src`가 이미 있으면 새 기본 아이템을 다시 만들지 않도록 막고, 관리자 화면에서도 이미 반영된 요청 아이템은 드래프트에 다시 올리지 않게 정리함.
+- 신규 템플릿 요청으로 새 게임을 한 번 만들면 해당 요청과 새 게임을 연결해 저장하고, 이후 같은 요청에서 다시 `확인하기`를 눌렀을 때는 새 게임을 또 만들지 않고 기존에 연결된 게임으로 바로 복귀하도록 흐름을 정리함.
+- 따라서 요청 카드와 게임 관리 작업 패널에서는 `연결된 게임`, `이미 반영 n개` 같은 상태를 함께 보여, 처리 완료 전에도 현재 진행 정도와 재작업 위험을 더 쉽게 구분할 수 있게 함.
+
+## 2026-04-02 v1.3.55
+- 관리자 요청 카드 오른쪽 상단의 `신규 템플릿 / 보유 템플릿` 배지는 서로 다른 색상으로 분리해, 카드 타입을 텍스트보다 더 빠르게 구분할 수 있게 조정함.
+- 게임 관리의 기본 아이템 추가 미리보기에서도 `요청 아이템 / 직접 추가 파일` 배지를 서로 다른 색상으로 구분해, 요청 반영분과 직접 업로드분이 한눈에 섞이지 않도록 정리함.
+- 신규 템플릿 요청에서 `새 게임 만들기`를 진행할 때는 요청 티어표 대표 썸네일도 함께 새 게임 썸네일로 복사되도록 보강해, 관리자가 이후 수정하더라도 초기 식별용 썸네일은 바로 이어받을 수 있게 함.
+
+## 2026-04-02 v1.3.54
+- 관리자 `티어표 관리` 요청 카드에서는 사용법 힌트 문구와 중복 타입 텍스트를 제거해, 카드 본문이 관리 정보만 더 빠르게 읽히도록 정리함.
+- `신규 템플릿 / 보유 템플릿` 구분은 카드 오른쪽 상단의 별도 배지로 옮기고, 기존 `추가 아이템 / 확인함 여부` 배지는 그대로 유지해 정보 계층을 더 단순하게 맞춤.
+- `요청 티어표 보기` 링크는 하단 액션 줄의 왼쪽으로 옮기고 `확인하기 / 처리 완료` 버튼은 오른쪽에 정렬해, 실제 작업 버튼과 보조 링크의 역할이 한 줄 안에서도 분명하게 보이도록 조정함.
+
+## 2026-04-02 v1.3.53
+- 관리자 리팩터링 4차로 `목록 관리` 정렬 로직과 `아이템 관리` 모달/삭제/승격 액션을 각각 `useAdminFeaturedGames`, `useAdminCustomItems` composable로 분리해 `AdminView.vue`의 직접 액션 코드를 더 줄임.
+- 따라서 관리자 메인 뷰는 섹션 연결과 공통 상태 중심으로 더 가까워졌고, 상단 고정 게임 정렬과 커스텀 아이템 처리 흐름은 각 영역 책임에 맞는 파일로 옮겨 유지보수 범위를 좁힘.
+
+## 2026-04-02 v1.3.52
+- 관리자 본문 섹션을 컴포넌트로 나눈 뒤 `AdminView.vue` 스타일이 `scoped`에 묶여 자식 컴포넌트까지 제대로 닿지 않던 문제를 정리하고, 관리자 전용 공통 스타일을 `adminUiScope` 범위로 다시 묶어 각 페이지 CSS가 함께 살아나도록 보강함.
+- 템플릿 요청 카드의 신규 게임 입력 영역에는 `게임 이름 / 게임 ID` 필드 스타일을 다시 붙여, 요청 카드만 따로 풀린 것처럼 보이던 레이아웃을 복구함.
+- 관리자 사이드바의 `전체 티어표 관리` 모드는 내부 값이 `lists`와 `all`로 엇갈리던 상태를 `all` 기준으로 통일해, 버튼 활성 상태와 실제 목록 전환이 어긋나지 않게 정리함.
+- 운영 이력 정합성을 위해 누락돼 있던 릴리스 태그도 다시 점검하고, `v1.3.50`, `v1.3.51`, `v1.3.52` 흐름으로 이어서 관리함.
+
 ## 2026-04-02 v1.3.51
 - 관리자 리팩터링 3차로 회원 관리 액션을 `useAdminUsers` composable로 분리해, 아바타 변경, 회원 정보 수정, 비밀번호 초기화, 권한 변경, 삭제 모달 흐름을 `AdminView.vue` 밖으로 옮김.
 - 따라서 관리자 메인 뷰는 섹션 연결과 공통 상태에 더 집중하고, 회원 관리 로직은 다른 관리자 영역과 같은 composable 분리 기준으로 맞추기 시작함.

frontend/src/components/admin/AdminGamesSection.vue

@@ -5,6 +5,7 @@ const props = defineProps({
   activeTemplateRequest: { type: Object, default: null },
   templateRequestSourceUrl: { type: Function, required: true },
   stagedRequestDraftCount: { type: Number, required: true },
+  appliedRequestItemCount: { type: Number, required: true },
   openGameCreateModal: { type: Function, required: true },
   isGameLoading: { type: Boolean, required: true },
   hasSelectedGame: { type: Boolean, required: true },
@@ -29,6 +30,10 @@ const props = defineProps({
   removeGameItem: { type: Function, required: true },
   selectedGameId: { type: String, default: '' },
 })
+
+function setGameItemListElement(el) {
+  props.gameItemListRef(el)
+}
 </script>
 
 <template>
@@ -38,12 +43,22 @@ const props = defineProps({
         <div class="panel__title">진행 중인 요청 작업</div>
         <div class="requestWorkspace__title">{{ props.activeTemplateRequest.sourceTierListTitle || '템플릿 요청' }}</div>
         <div class="hint hint--tight">
-          {{ props.activeTemplateRequest.type === 'create' ? '새 게임을 만든 뒤 필요한 아이템만 골라 저장하세요.' : '필요한 아이템만 남긴 뒤 기본 아이템 추가 버튼으로 반영하세요.' }}
+          {{
+            props.activeTemplateRequest.type === 'create'
+              ? (props.activeTemplateRequest.targetGameId
+                ? '이미 연결된 신규 템플릿이 있어요. 필요한 아이템만 골라 저장하세요.'
+                : '새 게임을 한 번 만든 뒤 필요한 아이템만 골라 저장하세요.')
+              : '필요한 아이템만 남긴 뒤 기본 아이템 추가 버튼으로 반영하세요.'
+          }}
         </div>
       </div>
       <div class="requestWorkspace__stats">
         <span class="pill pill--accent">{{ props.activeTemplateRequest.type === 'create' ? '신규 게임 요청' : '기존 게임 업데이트' }}</span>
         <span class="pill">요청 아이템 {{ props.stagedRequestDraftCount }}개</span>
+        <span v-if="props.appliedRequestItemCount" class="pill pill--soft">이미 반영 {{ props.appliedRequestItemCount }}개</span>
+        <span v-if="props.activeTemplateRequest.type === 'create' && (props.activeTemplateRequest.targetGameName || props.activeTemplateRequest.targetGameId)" class="pill pill--soft">
+          연결된 게임 · {{ props.activeTemplateRequest.targetGameName || props.activeTemplateRequest.targetGameId }}
+        </span>
       </div>
     </div>
     <div class="requestWorkspace__actions">
@@ -56,7 +71,12 @@ const props = defineProps({
       >
         요청 티어표 보기
       </a>
-      <button v-if="props.activeTemplateRequest.type === 'create'" class="btn btn--ghost btn--small" type="button" @click="props.openGameCreateModal">
+      <button
+        v-if="props.activeTemplateRequest.type === 'create' && !props.activeTemplateRequest.targetGameId"
+        class="btn btn--ghost btn--small"
+        type="button"
+        @click="props.openGameCreateModal"
+      >
         새 게임 만들기
       </button>
     </div>
@@ -86,6 +106,7 @@ const props = defineProps({
             <div
               class="dropZone"
               :class="{ 'dropZone--active': props.isItemDragOver }"
+              @click="props.openItemFilePicker"
               @dragenter="props.onItemDragEnter"
               @dragover="props.onItemDragOver"
               @dragleave="props.onItemDragLeave"
@@ -97,13 +118,9 @@ const props = defineProps({
                 <span v-if="props.stagedRequestDraftCount"> 현재 요청에서 가져온 아이템 {{ props.stagedRequestDraftCount }}개도 함께 검토 중이에요.</span>
               </div>
               <div class="dropZone__actions">
-                <button class="btn btn--ghost btn--small" type="button" @click="props.openItemFilePicker">파일 선택</button>
-                <button class="btn btn--danger btn--small" type="button" :disabled="!props.uploadItemDrafts.length" @click="props.clearItemFiles">선택 비우기</button>
+                <button class="btn btn--ghost btn--small" type="button" @click.stop="props.openItemFilePicker">파일 선택</button>
               </div>
             </div>
-            <button class="btn" :disabled="!props.canAddItem" @click="props.uploadItem">
-              아이템 {{ props.uploadItemDrafts.length || 0 }}개 추가
-            </button>
           </div>
           <div class="itemPreviewCard">
             <div v-if="props.uploadItemDrafts.length" class="itemDraftList">
@@ -119,16 +136,18 @@ const props = defineProps({
                   <input v-model="draft.label" class="input input--labelEdit input--dense" maxlength="60" placeholder="아이템 이름" />
                   <div class="hint hint--tight">{{ draft.sourceName }}</div>
                   <div class="itemDraftRow__meta">
-                    <span class="pill pill--soft">{{ draft.kind === 'request' ? '요청 아이템' : '직접 추가 파일' }}</span>
+                    <span class="pill" :class="draft.kind === 'request' ? 'pill--requestItem' : 'pill--directFile'">
+                      {{ draft.kind === 'request' ? '요청 아이템' : '직접 추가 파일' }}
+                    </span>
                     <button class="btn btn--danger btn--small" type="button" @click="props.removeUploadDraft(draft)">제외</button>
                   </div>
                 </div>
               </div>
             </div>
             <div v-else class="itemPreviewEmpty">등록한 기본 아이템 미리보기가 여기에 표시됩니다.</div>
-            <div class="thumbLabel thumbLabel--preview">
-              {{ props.uploadItemDrafts.length ? `추가 예정 아이템 ${props.uploadItemDrafts.length}개` : '아직 선택된 파일이 없어요.' }}
-            </div>
+            <button class="btn itemPreviewCard__submit" :disabled="!props.canAddItem" @click="props.uploadItem">
+              {{ props.uploadItemDrafts.length ? `아이템 ${props.uploadItemDrafts.length}개 추가` : '아이템 추가' }}
+            </button>
           </div>
         </div>
       </section>
@@ -143,19 +162,20 @@ const props = defineProps({
         <button class="btn btn--primary btn--small" :disabled="!props.hasGameItemOrderChanges" @click="props.saveGameItemOrder">순서 저장</button>
       </div>
       <div v-if="!props.selectedGame?.items?.length" class="hint">아직 등록된 기본 아이템이 없어요.</div>
-      <div v-else :ref="props.gameItemListRef" class="thumbGrid">
+      <div v-else :ref="setGameItemListElement" class="thumbGrid">
         <div v-for="item in props.selectedGame.items" :key="item.id" class="thumbCard" :data-game-item-id="item.id">
-          <img class="thumb thumb--game" :src="toApiUrl(item.src)" :alt="item.label" />
-          <input v-model="item.draftLabel" class="input input--labelEdit" placeholder="아이템 이름" />
+          <img class="thumb thumb--game" :src="toApiUrl(item.src)" :alt="item.label" draggable="false" />
+          <input v-model="item.draftLabel" class="input input--labelEdit" placeholder="아이템 이름" data-no-drag />
           <div class="thumbCard__actions">
             <button
               class="btn btn--ghost btn--small"
+              data-no-drag
               :disabled="item.isSavingLabel || !item.draftLabel?.trim() || item.draftLabel.trim() === item.label"
               @click="props.saveGameItemLabel(item)"
             >
               {{ item.isSavingLabel ? '저장중...' : '이름 저장' }}
             </button>
-            <button class="btn btn--danger btn--small" @click="props.removeGameItem(item.id)">아이템 삭제</button>
+            <button class="btn btn--danger btn--small" data-no-drag @click="props.removeGameItem(item.id)">아이템 삭제</button>
           </div>
         </div>
       </div>

frontend/src/components/admin/AdminTierlistsSection.vue

@@ -5,12 +5,10 @@ const props = defineProps({
   tierlistsMode: { type: String, required: true },
   templateRequests: { type: Array, required: true },
   openTemplateRequestPreview: { type: Function, required: true },
-  templateRequestTypeLabel: { type: Function, required: true },
   fmt: { type: Function, required: true },
   templateRequestTargetLabel: { type: Function, required: true },
   templateRequestStatusLabel: { type: Function, required: true },
   templateRequestSourceUrl: { type: Function, required: true },
-  templateRequestReviewHint: { type: Function, required: true },
   startTemplateRequestReview: { type: Function, required: true },
   completeTemplateRequest: { type: Function, required: true },
   adminTierLists: { type: Array, required: true },
@@ -32,7 +30,6 @@ const props = defineProps({
     <div class="sectionHeader">
       <div>
         <div class="panel__title">사용자 요청</div>
-        <div class="hint hint--tight">요청 카드는 미확인/확인함 상태로 관리하고, 실제 아이템 반영은 게임 관리 화면에서 직접 진행합니다. 처리 완료를 눌러야 카드가 목록에서 빠져요.</div>
       </div>
     </div>
 
@@ -67,10 +64,16 @@ const props = defineProps({
         <div class="tierAdminCard__body">
           <div class="tierAdminCard__head">
             <div>
+              <span
+                class="pill templateRequestCard__cornerBadge"
+                :class="request.type === 'create' ? 'pill--create' : 'pill--owned'"
+              >
+                {{ request.type === 'create' ? '신규 템플릿' : '보유 템플릿' }}
+              </span>
               <div class="tierAdminCard__title">{{ request.sourceTierListTitle }}</div>
               <div v-if="request.sourceDescription" class="tierAdminCard__desc">{{ request.sourceDescription }}</div>
               <div class="tierAdminCard__meta">
-                {{ props.templateRequestTypeLabel(request) }} · {{ request.requesterName }} · {{ props.fmt(request.createdAt) }}
+                {{ request.requesterName }} · {{ props.fmt(request.createdAt) }}
               </div>
               <div class="tierAdminCard__meta">{{ props.templateRequestTargetLabel(request) }}</div>
             </div>
@@ -78,7 +81,9 @@ const props = defineProps({
 
           <div class="tierAdminCard__stats">
             <span class="pill">추가 아이템 {{ request.items?.length || 0 }}개</span>
-            <span class="pill">{{ request.type === 'create' ? '새 템플릿' : '기존 템플릿 업데이트' }}</span>
+            <span v-if="request.type === 'create' && (request.targetGameName || request.targetGameId)" class="pill pill--soft">
+              연결됨 · {{ request.targetGameName || request.targetGameId }}
+            </span>
             <span class="pill" :class="{ 'pill--accent': request.status === 'reviewing' }">{{ props.templateRequestStatusLabel(request) }}</span>
           </div>
 
@@ -89,24 +94,30 @@ const props = defineProps({
             </button>
           </div>
 
-          <div class="templateRequestCard__links">
-            <a
-              v-if="props.templateRequestSourceUrl(request)"
-              class="btn btn--ghost btn--small"
-              :href="props.templateRequestSourceUrl(request)"
-              target="_blank"
-              rel="noreferrer"
-            >
-              요청 티어표 보기
-            </a>
-            <div class="hint hint--tight">{{ props.templateRequestReviewHint(request) }}</div>
-          </div>
-
-          <div class="templateRequestCard__actions">
-            <button class="btn btn--primary" :disabled="request.isHandling" @click="props.startTemplateRequestReview(request)">
-              {{ request.isHandling ? '이동중...' : '확인하기' }}
-            </button>
-            <button class="btn btn--ghost" :disabled="request.isHandling || request.status !== 'reviewing'" @click="props.completeTemplateRequest(request)">처리 완료</button>
+          <div class="templateRequestCard__footer">
+            <div class="templateRequestCard__footerLeft">
+              <a
+                v-if="props.templateRequestSourceUrl(request)"
+                class="btn btn--ghost btn--small"
+                :href="props.templateRequestSourceUrl(request)"
+                target="_blank"
+                rel="noreferrer"
+              >
+                요청 티어표 보기
+              </a>
+            </div>
+            <div class="templateRequestCard__actions">
+              <button class="btn btn--primary" :disabled="request.isHandling" @click="props.startTemplateRequestReview(request)">
+                {{
+                  request.isHandling
+                    ? '이동중...'
+                    : request.type === 'create' && (request.targetGameName || request.targetGameId)
+                      ? '연결된 게임 열기'
+                      : '확인하기'
+                }}
+              </button>
+              <button class="btn btn--ghost" :disabled="request.isHandling || request.status !== 'reviewing'" @click="props.completeTemplateRequest(request)">처리 완료</button>
+            </div>
           </div>
         </div>
       </article>
@@ -117,7 +128,6 @@ const props = defineProps({
     <div class="sectionHeader">
       <div>
         <div class="panel__title">전체 티어표 관리</div>
-        <div class="hint hint--tight">공개/비공개를 포함한 최근 티어표를 모두 확인하고, 추가 아이템을 기존 게임 템플릿으로 승격하거나 커스텀 티어표를 새 게임 템플릿으로 만들 수 있어요. 여기는 요청 목록과 별개로 전체 저장 티어표를 보는 영역입니다.</div>
       </div>
     </div>
 

frontend/src/composables/useAdminCustomItems.js

@@ -0,0 +1,203 @@
+import { nextTick } from 'vue'
+
+export function useAdminCustomItems({
+  api,
+  toast,
+  customItems,
+  customItemPage,
+  customItemLimit,
+  customItemPageCount,
+  customItemQuery,
+  customItemOrphanOnly,
+  customItemModalOpen,
+  customItemDeleteModalOpen,
+  customItemModalHistoryActive,
+  modalTargetCustomItem,
+  customItemModalDraftLabel,
+  customItemModalLabelSaving,
+  customItemModalTargetGameId,
+  customItemModalGameQuery,
+  customItemModalGameSort,
+  games,
+  selectedGameId,
+  refreshCustomItems,
+  loadGame,
+  setTab,
+  selectAdminGame,
+  resetMessages,
+  success,
+  error,
+}) {
+  function submitCustomItemSearch() {
+    customItemPage.value = 1
+    refreshCustomItems()
+  }
+
+  function toggleCustomItemOrphanOnly() {
+    customItemPage.value = 1
+    refreshCustomItems()
+  }
+
+  function changeCustomItemLimit(limit) {
+    customItemLimit.value = limit
+    customItemPage.value = 1
+    refreshCustomItems()
+  }
+
+  function moveCustomItemPage(direction) {
+    const nextPage = customItemPage.value + direction
+    if (nextPage < 1 || nextPage > customItemPageCount.value) return
+    customItemPage.value = nextPage
+    refreshCustomItems()
+  }
+
+  function pushCustomItemModalHistoryState() {
+    if (typeof window === 'undefined') return
+    window.history.pushState({ ...(window.history.state || {}), adminCustomItemModal: true }, '', window.location.href)
+    customItemModalHistoryActive.value = true
+  }
+
+  function openCustomItemModal(item) {
+    modalTargetCustomItem.value = item || null
+    customItemModalDraftLabel.value = item?.label || ''
+    customItemModalTargetGameId.value = ''
+    customItemModalGameQuery.value = ''
+    customItemModalGameSort.value = 'recent'
+    customItemModalOpen.value = true
+    pushCustomItemModalHistoryState()
+  }
+
+  function closeCustomItemModal({ fromPopState = false } = {}) {
+    customItemModalOpen.value = false
+    customItemDeleteModalOpen.value = false
+    modalTargetCustomItem.value = null
+    customItemModalDraftLabel.value = ''
+    customItemModalLabelSaving.value = false
+    customItemModalTargetGameId.value = ''
+    customItemModalGameQuery.value = ''
+    customItemModalGameSort.value = 'recent'
+
+    if (fromPopState) {
+      customItemModalHistoryActive.value = false
+      return
+    }
+
+    if (customItemModalHistoryActive.value && typeof window !== 'undefined') {
+      customItemModalHistoryActive.value = false
+      window.history.back()
+    }
+  }
+
+  function openCustomItemDeleteModal(item) {
+    if (!item) return
+    if (item.sourceType === 'user' && (item.usageCount > 0 || item.linkedGames.length > 0)) {
+      error.value = '사용 중이거나 템플릿에 연결된 사용자 업로드 이미지는 먼저 참조를 정리해야 삭제할 수 있어요.'
+      return
+    }
+    modalTargetCustomItem.value = item
+    customItemDeleteModalOpen.value = true
+  }
+
+  function closeCustomItemDeleteModal() {
+    customItemDeleteModalOpen.value = false
+  }
+
+  function jumpToGameAdmin(gameId) {
+    if (!gameId) return
+    closeCustomItemModal()
+    setTab('game-admin')
+    nextTick(() => {
+      selectAdminGame(gameId)
+    })
+  }
+
+  async function removeCustomItem(item = modalTargetCustomItem.value) {
+    resetMessages()
+    if (!item) return
+    if (item.sourceType === 'user' && (item.usageCount > 0 || item.linkedGames.length > 0)) {
+      error.value = '사용 중이거나 템플릿에 연결된 사용자 업로드 이미지는 먼저 참조를 정리해야 삭제할 수 있어요.'
+      return
+    }
+
+    try {
+      await api.deleteAdminCustomItem(item.id)
+      closeCustomItemDeleteModal()
+      closeCustomItemModal()
+      await refreshCustomItems()
+      success.value = item.sourceType === 'template' ? '선택한 템플릿 아이템을 제거했어요.' : '사용자 업로드 이미지를 삭제했어요.'
+    } catch (e) {
+      error.value = item.sourceType === 'template' ? '템플릿 아이템 제거에 실패했어요.' : '사용자 업로드 이미지 삭제에 실패했어요.'
+    }
+  }
+
+  async function removeUnusedCustomItems() {
+    resetMessages()
+    const ok = window.confirm('현재 검색 조건에 맞는 미사용 커스텀 이미지를 모두 삭제할까요?')
+    if (!ok) return
+
+    try {
+      const data = await api.deleteAdminUnusedCustomItems({ q: customItemQuery.value })
+      await refreshCustomItems()
+      success.value = `${data.deletedCount || 0}개의 미사용 사용자 업로드 이미지를 삭제했어요.`
+    } catch (e) {
+      error.value = '미사용 커스텀 이미지 일괄 삭제에 실패했어요.'
+    }
+  }
+
+  async function saveCustomItemModalLabel() {
+    const item = modalTargetCustomItem.value
+    const nextLabel = customItemModalDraftLabel.value.trim().slice(0, 60)
+    if (!item || !nextLabel || nextLabel === item.label || customItemModalLabelSaving.value) return
+
+    try {
+      customItemModalLabelSaving.value = true
+      const data = await api.updateAdminCustomItemLabel(item.id, { label: nextLabel, sourceType: item.sourceType })
+      item.label = data.item?.label || nextLabel
+      customItemModalDraftLabel.value = item.label
+      customItems.value = customItems.value.map((entry) => (entry.id === item.id ? { ...entry, label: item.label } : entry))
+      toast.success('아이템 이름을 변경했어요.')
+    } catch (e) {
+      error.value = '아이템 이름 변경에 실패했어요.'
+    } finally {
+      customItemModalLabelSaving.value = false
+    }
+  }
+
+  async function promoteCustomItem(item) {
+    resetMessages()
+    if (!customItemModalTargetGameId.value) {
+      error.value = '추가할 게임을 먼저 선택해주세요.'
+      return
+    }
+
+    try {
+      item.isPromoting = true
+      await api.promoteAdminCustomItem(item.id, { gameId: customItemModalTargetGameId.value })
+      const targetGameName = games.value.find((game) => game.id === customItemModalTargetGameId.value)?.name || customItemModalTargetGameId.value
+      if (selectedGameId.value === customItemModalTargetGameId.value) await loadGame()
+      closeCustomItemModal()
+      success.value = `"${item.label}" 이미지를 ${targetGameName} 템플릿으로 추가했어요.`
+    } catch (e) {
+      error.value = '선택한 이미지를 템플릿으로 추가하지 못했어요.'
+    } finally {
+      item.isPromoting = false
+    }
+  }
+
+  return {
+    submitCustomItemSearch,
+    toggleCustomItemOrphanOnly,
+    changeCustomItemLimit,
+    moveCustomItemPage,
+    pushCustomItemModalHistoryState,
+    openCustomItemModal,
+    closeCustomItemModal,
+    openCustomItemDeleteModal,
+    closeCustomItemDeleteModal,
+    jumpToGameAdmin,
+    removeCustomItem,
+    removeUnusedCustomItems,
+    saveCustomItemModalLabel,
+    promoteCustomItem,
+  }
+}

frontend/src/composables/useAdminFeaturedGames.js

@@ -0,0 +1,93 @@
+import { nextTick } from 'vue'
+import Sortable from 'sortablejs'
+
+export function useAdminFeaturedGames({
+  api,
+  featuredListEl,
+  featuredSortable,
+  featuredGameIds,
+  games,
+  resetMessages,
+  success,
+  error,
+}) {
+  function destroyFeaturedSortable() {
+    if (featuredSortable.value) {
+      featuredSortable.value.destroy()
+      featuredSortable.value = null
+    }
+  }
+
+  async function syncFeaturedSortable() {
+    await nextTick()
+    destroyFeaturedSortable()
+    if (!featuredListEl.value) return
+
+    featuredSortable.value = Sortable.create(featuredListEl.value, {
+      animation: 160,
+      draggable: '[data-featured-id]',
+      handle: '[data-featured-handle]',
+      ghostClass: 'ghost',
+      chosenClass: 'chosen',
+      onEnd: (evt) => {
+        if (evt.oldIndex == null || evt.newIndex == null || evt.oldIndex === evt.newIndex) return
+        const nextIds = [...featuredGameIds.value]
+        const [moved] = nextIds.splice(evt.oldIndex, 1)
+        nextIds.splice(evt.newIndex, 0, moved)
+        featuredGameIds.value = nextIds
+      },
+    })
+  }
+
+  function addFeaturedGame(gameId) {
+    resetMessages()
+    if (!gameId || featuredGameIds.value.includes(gameId)) return
+    if (featuredGameIds.value.length >= 50) {
+      error.value = '상단 고정 게임은 최대 50개까지만 설정할 수 있어요.'
+      return
+    }
+    featuredGameIds.value = [...featuredGameIds.value, gameId]
+    syncFeaturedSortable()
+  }
+
+  function removeFeaturedGame(gameId) {
+    resetMessages()
+    featuredGameIds.value = featuredGameIds.value.filter((id) => id !== gameId)
+    syncFeaturedSortable()
+  }
+
+  function moveFeaturedGame(gameId, direction) {
+    const currentIndex = featuredGameIds.value.indexOf(gameId)
+    const nextIndex = currentIndex + direction
+    if (currentIndex < 0 || nextIndex < 0 || nextIndex >= featuredGameIds.value.length) return
+    const nextIds = [...featuredGameIds.value]
+    const [moved] = nextIds.splice(currentIndex, 1)
+    nextIds.splice(nextIndex, 0, moved)
+    featuredGameIds.value = nextIds
+    syncFeaturedSortable()
+  }
+
+  async function saveFeaturedOrder() {
+    resetMessages()
+    try {
+      const data = await api.updateAdminGameDisplayOrder({ gameIds: featuredGameIds.value })
+      games.value = data.games || []
+      featuredGameIds.value = games.value
+        .filter((game) => game.displayRank != null)
+        .sort((a, b) => a.displayRank - b.displayRank)
+        .map((game) => game.id)
+      success.value = '홈 화면 게임 순서를 저장했어요.'
+    } catch (e) {
+      error.value = '게임 순서 저장에 실패했어요.'
+    }
+  }
+
+  return {
+    destroyFeaturedSortable,
+    syncFeaturedSortable,
+    addFeaturedGame,
+    removeFeaturedGame,
+    moveFeaturedGame,
+    saveFeaturedOrder,
+  }
+}

frontend/src/composables/useAdminGameManager.js

@@ -21,6 +21,7 @@ export function useAdminGameManager({
   customItemModalTargetGameId,
   newGameId,
   newGameName,
+  newGameIsPublic,
   clearPreviewUrl,
   resetFileInput,
   resetUploadState,
@@ -30,6 +31,19 @@ export function useAdminGameManager({
   success,
   error,
 }) {
+  function normalizeDraftSrc(src) {
+    if (typeof src !== 'string') return ''
+    const raw = src.trim()
+    if (!raw) return ''
+    if (raw.startsWith('/uploads/')) return raw
+    try {
+      const url = new URL(raw)
+      return url.pathname || raw
+    } catch (e) {
+      return raw
+    }
+  }
+
   function requestItemFilename(item = {}) {
     const src = typeof item.src === 'string' ? item.src : ''
     return src.split('/').pop() || item.file?.name || 'item'
@@ -50,6 +64,11 @@ export function useAdminGameManager({
     gameItemSortable.value = Sortable.create(gameItemListEl.value, {
       animation: 160,
       draggable: '[data-game-item-id]',
+      forceFallback: true,
+      fallbackOnBody: false,
+      filter: '[data-no-drag]',
+      preventOnFilter: false,
+      fallbackClass: 'thumbCard--dragging',
       ghostClass: 'ghost',
       chosenClass: 'chosen',
       onEnd: (evt) => {
@@ -68,6 +87,7 @@ export function useAdminGameManager({
   function mergeRequestItemsIntoDrafts(request) {
     const requestId = request?.id
     if (!requestId) return
+    const existingGameSrcs = new Set((selectedGame.value?.items || []).map((item) => normalizeDraftSrc(item?.src)).filter(Boolean))
     const existingKeys = new Set(uploadItemDrafts.value.map((draft) => `${draft.kind}:${draft.requestId || ''}:${draft.itemId || draft.file?.name || ''}`))
     const nextRequestDrafts = (request.items || [])
       .filter((item) => item?.src)
@@ -80,6 +100,7 @@ export function useAdminGameManager({
         sourceName: requestItemFilename(item),
         src: item.src,
       }))
+      .filter((draft) => !existingGameSrcs.has(normalizeDraftSrc(draft.src)))
       .filter((draft) => !existingKeys.has(`${draft.kind}:${draft.requestId}:${draft.itemId}`))
 
     if (nextRequestDrafts.length) {
@@ -96,9 +117,10 @@ export function useAdminGameManager({
     uploadFiles.value = uploadItemDrafts.value.filter((draft) => draft.kind === 'file').map((draft) => draft.file).filter(Boolean)
   }
 
-  async function loadGame() {
+  async function loadGame(options = {}) {
+    const preserveUploadState = !!options.preserveUploadState
     resetMessages()
-    resetUploadState()
+    if (!preserveUploadState) resetUploadState()
 
     if (!selectedGameId.value) {
       selectedGame.value = null
@@ -120,7 +142,6 @@ export function useAdminGameManager({
       savedGameItemOrderIds.value = (data.items || []).map((item) => item.id)
       await syncGameItemSortable()
     } catch (e) {
-      console.error('[AdminView] loadGame failed', selectedGameId.value, e)
       selectedGame.value = null
       error.value = '게임 정보를 불러오지 못했어요.'
     } finally {
@@ -128,24 +149,50 @@ export function useAdminGameManager({
     }
   }
 
-  async function createGame() {
+  async function createGame(options = {}) {
+    const nextGameId = typeof options.gameId === 'string' ? options.gameId.trim() : newGameId.value.trim()
+    const nextGameName = typeof options.gameName === 'string' ? options.gameName.trim() : newGameName.value.trim()
+    const preserveUploadState = !!options.preserveUploadState
     resetMessages()
     try {
       const res = await fetch(toApiUrl('/api/admin/games'), {
         method: 'POST',
         credentials: 'include',
         headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({ id: newGameId.value.trim(), name: newGameName.value.trim() }),
+        body: JSON.stringify({
+          id: nextGameId,
+          name: nextGameName,
+          isPublic: !!newGameIsPublic.value,
+          thumbnailSrc: activeTemplateRequest.value?.type === 'create' ? (activeTemplateRequest.value?.thumbnailSrc || '') : '',
+        }),
       })
       if (!res.ok) throw new Error('failed')
 
       const data = await res.json()
+      if (activeTemplateRequest.value?.type === 'create' && activeTemplateRequest.value?.id) {
+        const linkData = await api.linkAdminTemplateRequestGame(activeTemplateRequest.value.id, {
+          gameId: data.game.id,
+        })
+        activeTemplateRequest.value = {
+          ...activeTemplateRequest.value,
+          targetGameId: linkData.request?.targetGameId || data.game.id,
+          targetGameName: linkData.request?.targetGameName || data.game.name || nextGameName,
+        }
+        const requestIndex = templateRequests.value.findIndex((entry) => entry.id === activeTemplateRequest.value.id)
+        if (requestIndex >= 0) {
+          templateRequests.value.splice(requestIndex, 1, {
+            ...templateRequests.value[requestIndex],
+            targetGameId: linkData.request?.targetGameId || data.game.id,
+            targetGameName: linkData.request?.targetGameName || data.game.name || nextGameName,
+          })
+        }
+      }
       await refreshGames()
       selectedGameId.value = data.game.id
       if (customItemModalOpen.value) customItemModalTargetGameId.value = data.game.id
       closeGameCreateModal()
-      await loadGame()
-      if (activeTemplateRequest.value?.id) {
+      await loadGame({ preserveUploadState })
+      if (!preserveUploadState && activeTemplateRequest.value?.id) {
         const sourceRequest = templateRequests.value.find((entry) => entry.id === activeTemplateRequest.value.id) || activeTemplateRequest.value
         mergeRequestItemsIntoDrafts(sourceRequest)
       }
@@ -201,12 +248,31 @@ export function useAdminGameManager({
 
   async function uploadItem() {
     resetMessages()
-    if (!uploadItemDrafts.value.length || !selectedGameId.value) {
+    if (!uploadItemDrafts.value.length) {
       error.value = '아이템 파일을 선택해주세요.'
       return
     }
 
     try {
+      if (!selectedGameId.value && activeTemplateRequest.value?.type === 'create' && !activeTemplateRequest.value?.targetGameId) {
+        const draftGameId = (activeTemplateRequest.value?.draftGameId || '').trim()
+        const draftGameName = (activeTemplateRequest.value?.draftGameName || '').trim()
+        if (!draftGameId || !draftGameName) {
+          error.value = '먼저 신규 템플릿의 게임 이름과 게임 ID를 저장해주세요.'
+          return
+        }
+        await createGame({
+          gameId: draftGameId,
+          gameName: draftGameName,
+          preserveUploadState: true,
+        })
+      }
+
+      if (!selectedGameId.value) {
+        error.value = '게임을 먼저 선택해주세요.'
+        return
+      }
+
       const fileDrafts = uploadItemDrafts.value.filter((entry) => entry.kind === 'file')
       const requestDrafts = uploadItemDrafts.value.filter((entry) => entry.kind === 'request')
       let uploadCount = 0
@@ -230,15 +296,16 @@ export function useAdminGameManager({
         const requestIds = [...new Set(requestDrafts.map((entry) => entry.requestId).filter(Boolean))]
         for (const requestId of requestIds) {
           const draftsForRequest = requestDrafts.filter((entry) => entry.requestId === requestId)
-          await api.promoteAdminTemplateRequestItems(requestId, {
+          const result = await api.promoteAdminTemplateRequestItems(requestId, {
             gameId: selectedGameId.value,
             itemIds: draftsForRequest.map((entry) => entry.itemId).filter(Boolean),
+            itemSrcs: draftsForRequest.map((entry) => entry.src).filter(Boolean),
             itemLabels: draftsForRequest.reduce((acc, entry) => {
               if (entry.itemId) acc[entry.itemId] = entry.label.trim()
               return acc
             }, {}),
           })
-          uploadCount += draftsForRequest.length
+          uploadCount += Array.isArray(result?.items) ? result.items.length : 0
         }
       }
 
@@ -246,7 +313,21 @@ export function useAdminGameManager({
       await loadGame()
       success.value = `게임 기본 아이템 ${uploadCount}개 추가를 완료했어요.`
     } catch (e) {
-      error.value = '아이템 추가 실패(관리자 권한/파일 크기 확인)'
+      const apiError = e?.data?.error || ''
+      if (apiError === 'no_items_selected') {
+        error.value = '추가할 요청 아이템이 없어요.'
+        return
+      }
+      if (apiError === 'promote_items_failed') {
+        const detail = e?.data?.detail ? ` (${e.data.detail})` : ''
+        error.value = `요청 아이템을 게임 기본 아이템으로 옮기지 못했어요.${detail}`
+        return
+      }
+      if (apiError === 'game_not_found') {
+        error.value = '선택한 게임을 찾지 못했어요.'
+        return
+      }
+      error.value = '아이템 추가에 실패했어요.'
     }
   }
 

frontend/src/composables/useAdminTemplateRequests.js

@@ -18,12 +18,15 @@ export function useAdminTemplateRequests({
       id: request.id,
       type: request.type,
       status: request.status,
+      thumbnailSrc: request.thumbnailSrc || '',
       draftGameId: request.draftGameId || '',
       draftGameName: request.draftGameName || '',
+      draftGameIsPublic: !!request.draftGameIsPublic,
       sourceTierListId: request.sourceTierListId || '',
       sourceGameId: request.sourceGameId || '',
       sourceTierListTitle: request.sourceTierListTitle || '',
       targetGameId: request.targetGameId || '',
+      targetGameName: request.targetGameName || '',
       requesterName: request.requesterName || '',
     }
   }
@@ -47,19 +50,32 @@ export function useAdminTemplateRequests({
     try {
       request.isHandling = true
       const data = await api.startAdminTemplateRequestReview(request.id)
-      request.status = data.request?.status || 'reviewing'
-      updateActiveTemplateRequest(request)
+      const syncedRequest = {
+        ...request,
+        ...(data.request || {}),
+        draftGameId: request.draftGameId || '',
+        draftGameName: request.draftGameName || '',
+        draftGameIsPublic: !!request.draftGameIsPublic,
+      }
+      Object.assign(request, syncedRequest)
+      request.status = syncedRequest.status || 'reviewing'
+      updateActiveTemplateRequest(syncedRequest)
       setTab('game-admin')
 
       if (request.type === 'create') {
-        openGameCreateModal()
-        newGameId.value = (request.draftGameId || '').trim()
-        newGameName.value = (request.draftGameName || '').trim()
-        mergeRequestItemsIntoDrafts(request)
+        const linkedGameId = syncedRequest.targetGameId || ''
+        if (linkedGameId) {
+          await selectAdminGame(linkedGameId)
+        } else {
+          openGameCreateModal()
+          newGameId.value = (syncedRequest.draftGameId || '').trim()
+          newGameName.value = (syncedRequest.draftGameName || '').trim()
+        }
+        mergeRequestItemsIntoDrafts(syncedRequest)
       } else {
-        const nextGameId = request.targetGameId || request.sourceGameId || ''
+        const nextGameId = syncedRequest.targetGameId || syncedRequest.sourceGameId || ''
         if (nextGameId) await selectAdminGame(nextGameId)
-        mergeRequestItemsIntoDrafts(request)
+        mergeRequestItemsIntoDrafts(syncedRequest)
       }
       success.value = '요청 아이템을 게임 관리 화면으로 가져왔어요. 필요한 항목만 골라서 추가해 주세요.'
     } catch (e) {

frontend/src/lib/api.js

@@ -37,6 +37,8 @@ export const api = {
   updateAdminGameDisplayOrder: (payload) => request('/api/admin/games/display-order', { method: 'PATCH', body: payload }),
   updateAdminGameItemDisplayOrder: (gameId, payload) =>
     request(`/api/admin/games/${encodeURIComponent(gameId)}/items/display-order`, { method: 'PATCH', body: payload }),
+  updateAdminGame: (gameId, payload) =>
+    request(`/api/admin/games/${encodeURIComponent(gameId)}`, { method: 'PATCH', body: payload }),
   updateAdminGameItem: (gameId, itemId, payload) =>
     request(`/api/admin/games/${encodeURIComponent(gameId)}/items/${encodeURIComponent(itemId)}`, { method: 'PATCH', body: payload }),
   listAdminCustomItems: ({ q = '', page = 1, limit = 50, orphanOnly = false } = {}) =>
@@ -65,6 +67,8 @@ export const api = {
     request(`/api/admin/tierlists/${encodeURIComponent(tierListId)}/create-game-template`, { method: 'POST', body: payload }),
   startAdminTemplateRequestReview: (requestId) =>
     request(`/api/admin/template-requests/${encodeURIComponent(requestId)}/review`, { method: 'POST', body: {} }),
+  linkAdminTemplateRequestGame: (requestId, payload) =>
+    request(`/api/admin/template-requests/${encodeURIComponent(requestId)}/link-game`, { method: 'POST', body: payload }),
   promoteAdminTemplateRequestItems: (requestId, payload) =>
     request(`/api/admin/template-requests/${encodeURIComponent(requestId)}/promote-items`, { method: 'POST', body: payload }),
   completeAdminTemplateRequest: (requestId) =>

frontend/src/stores/auth.js

@@ -1,6 +1,8 @@
 import { defineStore } from 'pinia'
 import { api } from '../lib/api'
 
+let refreshPromise = null
+
 export const useAuthStore = defineStore('auth', {
   state: () => ({
     user: null,
@@ -9,19 +11,23 @@ export const useAuthStore = defineStore('auth', {
   }),
   actions: {
     async refresh() {
-      if (this.status === 'loading') return this.user
+      if (refreshPromise) return refreshPromise
       this.status = 'loading'
-      try {
-        const data = await api.me()
-        this.user = data.user
-        return this.user
-      } catch (error) {
-        this.user = null
-        return null
-      } finally {
-        this.status = 'idle'
-        this.hydrated = true
-      }
+      refreshPromise = (async () => {
+        try {
+          const data = await api.me()
+          this.user = data.user
+          return this.user
+        } catch (error) {
+          this.user = null
+          return null
+        } finally {
+          this.status = 'idle'
+          this.hydrated = true
+          refreshPromise = null
+        }
+      })()
+      return refreshPromise
     },
     async signup(email, password) {
       const user = await api.signup({ email, password })
@@ -42,4 +48,3 @@ export const useAuthStore = defineStore('auth', {
     },
   },
 })
-

frontend/src/views/TierEditorView.vue

@@ -2073,9 +2073,25 @@ onUnmounted(() => {
 .dropzone--board {
   margin-top: 18px;
   display: flex;
+  flex-direction: column;
   align-items: center;
-  justify-content: space-between;
+  justify-content: center;
   gap: 18px;
+  min-height: 176px;
+  padding: 28px 24px;
+  border: 2px dashed color-mix(in srgb, var(--theme-accent) 48%, var(--theme-border));
+  border-radius: 22px;
+  background:
+    linear-gradient(180deg, color-mix(in srgb, var(--theme-card-bg) 82%, transparent), color-mix(in srgb, var(--theme-card-bg-hover) 74%, transparent)),
+    radial-gradient(circle at top, color-mix(in srgb, var(--theme-accent) 12%, transparent), transparent 58%);
+  text-align: center;
+}
+
+.dropzone--board.dropzone--active {
+  border-color: color-mix(in srgb, var(--theme-accent) 78%, white);
+  background:
+    linear-gradient(180deg, color-mix(in srgb, var(--theme-card-bg-hover) 88%, transparent), color-mix(in srgb, var(--theme-card-bg) 82%, transparent)),
+    radial-gradient(circle at top, color-mix(in srgb, var(--theme-accent) 20%, transparent), transparent 58%);
 }
 
 .dropzone__actions {
@@ -2083,11 +2099,23 @@ onUnmounted(() => {
   align-items: center;
   gap: 12px;
   flex: 0 0 auto;
+  justify-content: center;
 }
 
 .dropzone__button {
   min-width: 148px;
 }
+
+.dropzone--board .dropzone__title {
+  font-size: 18px;
+  font-weight: 800;
+}
+
+.dropzone--board .dropzone__desc {
+  max-width: 520px;
+  color: var(--theme-text-soft);
+  line-height: 1.6;
+}
 .editorSidebar__section {
   display: grid;
   gap: 10px;