릴리스: v1.3.39 요청 미리보기와 아이템 이름 편집 보강

backend/src/db.js

@@ -95,6 +95,7 @@ function mapImageAssetRow(row) {
     id: row.id,
     contentHash: row.content_hash,
     src: row.src || '',
+    labelOverride: row.label_override || '',
     mimeType: row.mime_type || 'image/webp',
     byteSize: Number(row.byte_size || 0),
     originalByteSize: Number(row.original_byte_size || 0),
@@ -342,6 +343,7 @@ async function ensureSchema() {
         id VARCHAR(64) PRIMARY KEY,
         content_hash CHAR(64) NOT NULL UNIQUE,
         src VARCHAR(255) NOT NULL UNIQUE,
+        label_override VARCHAR(120) NOT NULL DEFAULT '',
         mime_type VARCHAR(32) NOT NULL DEFAULT 'image/webp',
         byte_size INT UNSIGNED NOT NULL,
         original_byte_size INT UNSIGNED NOT NULL,
@@ -352,6 +354,11 @@ async function ensureSchema() {
       ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4
     `)
 
+    const imageAssetLabelColumns = await query("SHOW COLUMNS FROM image_assets LIKE 'label_override'")
+    if (!imageAssetLabelColumns.length) {
+      await query("ALTER TABLE image_assets ADD COLUMN label_override VARCHAR(120) NOT NULL DEFAULT '' AFTER src")
+    }
+
     await query(`
       CREATE TABLE IF NOT EXISTS image_optimization_jobs (
         id VARCHAR(64) PRIMARY KEY,
@@ -649,6 +656,11 @@ async function listGameItems(gameId) {
   return rows.map(mapGameItemRow)
 }
 
+async function findGameItemById(itemId) {
+  const rows = await query('SELECT id, game_id, src, label, created_at FROM game_items WHERE id = ? LIMIT 1', [itemId])
+  return mapGameItemRow(rows[0])
+}
+
 async function getGameDetail(gameId) {
   const game = await findGameById(gameId)
   if (!game) return null
@@ -674,7 +686,7 @@ async function updateGameThumbnail(gameId, thumbnailSrc) {
 
 async function findImageAssetByHash(contentHash) {
   const rows = await query(
-    'SELECT id, content_hash, src, mime_type, byte_size, original_byte_size, width, height, created_at FROM image_assets WHERE content_hash = ? LIMIT 1',
+    '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',
     [contentHash]
   )
   return mapImageAssetRow(rows[0])
@@ -682,7 +694,7 @@ async function findImageAssetByHash(contentHash) {
 
 async function findImageAssetBySrc(src) {
   const rows = await query(
-    'SELECT id, content_hash, src, mime_type, byte_size, original_byte_size, width, height, created_at FROM image_assets WHERE src = ? LIMIT 1',
+    'SELECT id, content_hash, src, label_override, mime_type, byte_size, original_byte_size, width, height, created_at FROM image_assets WHERE src = ? LIMIT 1',
     [src]
   )
   return mapImageAssetRow(rows[0])
@@ -760,7 +772,7 @@ async function listUnusedImageAssets({ limit = 100, minAgeHours = 24 } = {}) {
   const cutoff = now() - safeMinAgeHours * 60 * 60 * 1000
 
   const assets = (await query(
-    `SELECT id, content_hash, src, mime_type, byte_size, original_byte_size, width, height, created_at FROM image_assets WHERE created_at <= ? ORDER BY created_at ASC LIMIT ${safeLimit}`,
+    `SELECT id, content_hash, src, label_override, mime_type, byte_size, original_byte_size, width, height, created_at FROM image_assets WHERE created_at <= ? ORDER BY created_at ASC LIMIT ${safeLimit}`,
     [cutoff]
   )).map(mapImageAssetRow)
 
@@ -801,7 +813,7 @@ async function deleteImageAssets(ids) {
   if (!uniqueIds.length) return []
   const placeholders = uniqueIds.map(() => '?').join(', ')
   const rows = await query(
-    `SELECT id, content_hash, src, mime_type, byte_size, original_byte_size, width, height, created_at FROM image_assets WHERE id IN (${placeholders})`,
+    `SELECT id, content_hash, src, label_override, mime_type, byte_size, original_byte_size, width, height, created_at FROM image_assets WHERE id IN (${placeholders})`,
     uniqueIds
   )
   await query(`DELETE FROM image_assets WHERE id IN (${placeholders})`, uniqueIds)
@@ -926,11 +938,19 @@ async function replaceUploadSourceReferences({ fromSrc, toSrc }) {
 
 async function listImageAssets() {
   const rows = await query(
-    'SELECT id, content_hash, src, mime_type, byte_size, original_byte_size, width, height, created_at FROM image_assets ORDER BY created_at DESC'
+    'SELECT id, content_hash, src, label_override, mime_type, byte_size, original_byte_size, width, height, created_at FROM image_assets ORDER BY created_at DESC'
   )
   return rows.map(mapImageAssetRow)
 }
 
+async function findImageAssetById(id) {
+  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 id = ? LIMIT 1',
+    [id]
+  )
+  return mapImageAssetRow(rows[0])
+}
+
 async function getReferencedUploadFootprint() {
   const [referencedSrcs, assets] = await Promise.all([listReferencedUploadSources(), listImageAssets()])
   const assetMap = new Map(assets.map((asset) => [asset.src, asset]))
@@ -1056,6 +1076,34 @@ async function updateGameItemLabel(itemId, label) {
   return mapGameItemRow(rows[0])
 }
 
+async function updateCustomItemLabel(itemId, label) {
+  await query('UPDATE custom_items SET label = ? WHERE id = ?', [label, itemId])
+  const rows = await query(`
+    SELECT c.id, c.owner_id, c.src, c.label, c.created_at, u.nickname, u.email
+    FROM custom_items c
+    INNER JOIN users u ON u.id = c.owner_id
+    WHERE c.id = ?
+    LIMIT 1
+  `, [itemId])
+  const row = rows[0]
+  if (!row) return null
+  return {
+    id: row.id,
+    ownerId: row.owner_id,
+    src: row.src,
+    label: row.label,
+    createdAt: Number(row.created_at),
+    ownerName: row.nickname || row.email,
+    ownerEmail: row.email,
+  }
+}
+
+async function updateImageAssetLabel(assetId, label) {
+  await query('UPDATE image_assets SET label_override = ? WHERE id = ?', [label, assetId])
+  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 id = ? LIMIT 1', [assetId])
+  return mapImageAssetRow(rows[0])
+}
+
 async function deleteGameItem(itemId) {
   const gameItemRows = await query('SELECT game_id FROM game_items WHERE id = ? LIMIT 1', [itemId])
   const gameId = gameItemRows[0]?.game_id
@@ -1208,32 +1256,70 @@ async function getCustomItemUsageMeta() {
 async function listCustomItems({ queryText = '', page = 1, limit = 50, orphanOnly = false } = {}) {
   const normalizedLimit = Math.min(Math.max(Number(limit) || 50, 1), 200)
   const normalizedPage = Math.max(Number(page) || 1, 1)
-  const hasQuery = !!(queryText || '').trim()
-  const search = `%${(queryText || '').trim()}%`
-  const whereClause = hasQuery ? 'WHERE c.label LIKE ? OR c.src LIKE ? OR u.email LIKE ? OR u.nickname LIKE ?' : ''
-  const params = hasQuery ? [search, search, search, search] : []
+  const searchText = (queryText || '').trim()
+  const hasQuery = !!searchText
+  const search = `%${searchText}%`
 
-  const rows = await query(
-    `
-      SELECT
-        c.id,
-        c.owner_id,
-        c.src,
-        c.label,
-        c.created_at,
-        u.nickname,
-        u.email
-      FROM custom_items c
-      INNER JOIN users u ON u.id = c.owner_id
-      ${whereClause}
-      ORDER BY c.created_at DESC
-    `,
-    params
-  )
+  const [customRows, gameItemRows, assetRows, usageMeta] = await Promise.all([
+    query(
+      `
+        SELECT
+          c.id,
+          c.owner_id,
+          c.src,
+          c.label,
+          c.created_at,
+          u.nickname,
+          u.email
+        FROM custom_items c
+        INNER JOIN users u ON u.id = c.owner_id
+        ${hasQuery ? 'WHERE c.label LIKE ? OR c.src LIKE ? OR u.email LIKE ? OR u.nickname LIKE ?' : ''}
+        ORDER BY c.created_at DESC
+      `,
+      hasQuery ? [search, search, search, search] : []
+    ),
+    query(
+      `
+        SELECT
+          gi.id,
+          gi.game_id,
+          gi.src,
+          gi.label,
+          gi.created_at,
+          g.name AS game_name
+        FROM game_items gi
+        INNER JOIN games g ON g.id = gi.game_id
+        ${hasQuery ? 'WHERE gi.label LIKE ? OR gi.src LIKE ? OR gi.game_id LIKE ? OR g.name LIKE ?' : ''}
+        ORDER BY gi.created_at DESC
+      `,
+      hasQuery ? [search, search, search, search] : []
+    ),
+    query(
+      `
+        SELECT ia.id, ia.src, ia.label_override, ia.created_at
+        FROM image_assets ia
+        WHERE ia.src LIKE '/uploads/assets/%'
+        ${hasQuery ? 'AND ia.src LIKE ?' : ''}
+        ORDER BY ia.created_at DESC
+      `,
+      hasQuery ? [search] : []
+    ),
+    getCustomItemUsageMeta(),
+  ])
 
-  const { usageMap, linkedGamesMap } = await getCustomItemUsageMeta()
-  const allItems = rows
-    .map((row) => ({
+  const templateLinkedBySrc = new Map()
+  gameItemRows.forEach((row) => {
+    if (!row?.src) return
+    if (!templateLinkedBySrc.has(row.src)) templateLinkedBySrc.set(row.src, new Map())
+    templateLinkedBySrc.get(row.src).set(row.game_id, {
+      id: row.game_id,
+      name: row.game_name || row.game_id,
+    })
+  })
+
+  const customItems = customRows.map((row) => {
+    const linkedGames = Array.from((templateLinkedBySrc.get(row.src) || new Map()).values())
+    return {
       id: row.id,
       ownerId: row.owner_id,
       src: row.src,
@@ -1241,10 +1327,60 @@ async function listCustomItems({ queryText = '', page = 1, limit = 50, orphanOnl
       createdAt: Number(row.created_at),
       ownerName: row.nickname || row.email,
       ownerEmail: row.email,
-      usageCount: usageMap.get(row.id) || 0,
-      linkedGames: linkedGamesMap.get(row.id) || [],
+      usageCount: usageMeta.usageMap.get(row.id) || 0,
+      linkedGames,
+      sourceType: 'user',
+      sourceLabel: '사용자 업로드',
+      canDelete: true,
+    }
+  })
+
+  const templateSrcSet = new Set(gameItemRows.map((row) => row.src).filter(Boolean))
+  const customSrcSet = new Set(customRows.map((row) => row.src).filter(Boolean))
+  const assetLibraryItems = assetRows
+    .filter((row) => row?.src && !templateSrcSet.has(row.src) && !customSrcSet.has(row.src))
+    .map((row) => ({
+      id: `asset:${row.id}`,
+      assetId: row.id,
+      ownerId: '',
+      src: row.src,
+      label: row.label_override || (row.src.split('/').pop() || '').replace(/\.[^.]+$/, '') || '이름 없음',
+      createdAt: Number(row.created_at || 0),
+      ownerName: '관리자 보관 자산',
+      ownerEmail: '',
+      usageCount: 0,
+      linkedGames: [],
+      sourceType: 'template',
+      sourceLabel: '관리자 템플릿',
+      canDelete: true,
+      sourceGameId: '',
+      sourceGameName: '',
+      isAssetLibraryItem: true,
     }))
-    .filter((item) => (orphanOnly ? item.usageCount === 0 : true))
+
+  const templateItems = gameItemRows.map((row) => ({
+    id: row.id,
+    ownerId: '',
+    src: row.src,
+    label: row.label,
+    createdAt: Number(row.created_at),
+    ownerName: row.game_name || row.game_id,
+    ownerEmail: '',
+    usageCount: (templateLinkedBySrc.get(row.src) || new Map()).size,
+    linkedGames: Array.from((templateLinkedBySrc.get(row.src) || new Map()).values()),
+    sourceType: 'template',
+    sourceLabel: '관리자 템플릿',
+    canDelete: true,
+    sourceGameId: row.game_id,
+    sourceGameName: row.game_name || row.game_id,
+  }))
+
+  const allItems = [...customItems, ...templateItems, ...assetLibraryItems]
+    .filter((item) => {
+      if (!orphanOnly) return true
+      return item.sourceType === 'user' && item.usageCount === 0 && item.linkedGames.length === 0
+    })
+    .sort((a, b) => Number(b.createdAt || 0) - Number(a.createdAt || 0))
 
   const total = allItems.length
   const offset = (normalizedPage - 1) * normalizedLimit
@@ -1935,11 +2071,13 @@ module.exports = {
   listGames,
   findGameById,
   listGameItems,
+  findGameItemById,
   getGameDetail,
   createGame,
   updateGameThumbnail,
   findImageAssetByHash,
   findImageAssetBySrc,
+  findImageAssetById,
   createImageAsset,
   createImageOptimizationJob,
   findImageOptimizationJobById,
@@ -1954,6 +2092,8 @@ module.exports = {
   getImageAssetStats,
   createGameItem,
   updateGameItemLabel,
+  updateCustomItemLabel,
+  updateImageAssetLabel,
   deleteGameItem,
   deleteGame,
   updateGameDisplayOrder,

backend/src/lib/image-storage.js

@@ -75,7 +75,7 @@ async function optimizeAndPersist({ file, width, height, fit, quality }) {
     }
   }
 
-  const filename = String(Date.now()) + '-' + nanoid() + '.webp'
+  const filename = nanoid() + '.webp'
   const absoluteDir = path.join(UPLOAD_ROOT, OPTIMIZED_DIR)
   const absolutePath = path.join(absoluteDir, filename)
   const src = '/uploads/' + OPTIMIZED_DIR + '/' + filename

backend/src/routes/admin.js

@@ -8,11 +8,15 @@ const { nanoid } = require('nanoid')
 const {
   findUserById,
   findGameById,
+  findGameItemById,
+  findImageAssetById,
   createGame,
   listGames,
   updateGameThumbnail,
   createGameItem,
   updateGameItemLabel,
+  updateCustomItemLabel,
+  updateImageAssetLabel,
   deleteGameItem,
   deleteGame,
   updateGameDisplayOrder,
@@ -190,6 +194,32 @@ router.delete('/games/:gameId', requireAdmin, async (req, res) => {
   res.json({ ok: true })
 })
 
+router.patch('/custom-items/:itemId/label', requireAdmin, async (req, res) => {
+  const schema = z.object({
+    label: z.string().trim().min(1).max(60),
+    sourceType: z.enum(['template', 'user']).optional().default('user'),
+  })
+  const parsed = schema.safeParse(req.body)
+  if (!parsed.success) return res.status(400).json({ error: 'bad_request' })
+
+  const itemId = req.params.itemId
+  if (itemId.startsWith('asset:')) {
+    const updated = await updateImageAssetLabel(itemId.slice(6), parsed.data.label)
+    if (!updated) return res.status(404).json({ error: 'not_found' })
+    return res.json({ item: updated })
+  }
+
+  if (parsed.data.sourceType === 'template') {
+    const updated = await updateGameItemLabel(itemId, parsed.data.label)
+    if (!updated) return res.status(404).json({ error: 'not_found' })
+    return res.json({ item: updated })
+  }
+
+  const updated = await updateCustomItemLabel(itemId, parsed.data.label)
+  if (!updated) return res.status(404).json({ error: 'not_found' })
+  return res.json({ item: updated })
+})
+
 router.get('/custom-items', requireAdmin, async (req, res) => {
   const schema = z.object({
     q: z.string().trim().max(120).optional().default(''),
@@ -308,6 +338,20 @@ router.post('/image-assets/stats/reset', requireAdmin, async (req, res) => {
   res.json({ deletedCount })
 })
 
+async function removeUploadFiles(srcs) {
+  await Promise.all(
+    (srcs || []).map(async (src) => {
+      if (!src || !src.startsWith('/uploads/')) return
+      const absolutePath = path.join(__dirname, '..', '..', src.replace(/^\//, ''))
+      try {
+        await fs.unlink(absolutePath)
+      } catch (e) {
+        if (e?.code !== 'ENOENT') throw e
+      }
+    })
+  )
+}
+
 async function removeCustomItemFiles(items) {
   await Promise.all(
     items.map(async (item) => {
@@ -322,12 +366,12 @@ async function removeCustomItemFiles(items) {
   )
 }
 
-async function promoteCustomItemToGameItem({ customItem, gameId }) {
+async function promoteLibraryItemToGameItem({ item, gameId }) {
   return createGameItem({
     id: nanoid(),
     gameId,
-    src: customItem.src || '',
-    label: customItem.label,
+    src: item.src || '',
+    label: item.label,
   })
 }
 
@@ -425,15 +469,31 @@ async function createGameTemplateFromRequest({ templateRequest, gameId, gameName
 }
 
 router.delete('/custom-items/:itemId', requireAdmin, async (req, res) => {
-  const result = await listCustomItems({ page: 1, limit: 200, orphanOnly: false })
+  const result = await listCustomItems({ page: 1, limit: 10000, orphanOnly: false })
   const target = result.items.find((item) => item.id === req.params.itemId)
   if (!target) return res.status(404).json({ error: 'not_found' })
+  if (target.sourceType === 'template') {
+    if (String(target.id || '').startsWith('asset:')) {
+      const assetId = String(target.id).slice('asset:'.length)
+      const asset = await findImageAssetById(assetId)
+      if (!asset) return res.status(404).json({ error: 'not_found' })
+      await deleteImageAssets([assetId])
+      await removeUploadFiles([asset.src])
+      return res.json({ ok: true, sourceType: 'template-asset' })
+    }
+
+    await deleteGameItem(target.id)
+    return res.json({ ok: true, sourceType: 'template' })
+  }
+
+  if (!target.canDelete) return res.status(409).json({ error: 'item_locked' })
+  if (target.linkedGames.length > 0) return res.status(409).json({ error: 'item_linked' })
   if (target.usageCount > 0) return res.status(409).json({ error: 'item_in_use' })
 
   const items = await findCustomItemsByIds([target.id])
   await deleteCustomItems([target.id])
   await removeCustomItemFiles(items)
-  res.json({ ok: true })
+  res.json({ ok: true, sourceType: 'user' })
 })
 
 router.post('/custom-items/:itemId/promote', requireAdmin, async (req, res) => {
@@ -447,9 +507,11 @@ router.post('/custom-items/:itemId/promote', requireAdmin, async (req, res) => {
   if (!game) return res.status(404).json({ error: 'game_not_found' })
 
   const customItem = await findCustomItemById(req.params.itemId)
-  if (!customItem) return res.status(404).json({ error: 'not_found' })
+  const gameItem = customItem ? null : await findGameItemById(req.params.itemId)
+  const sourceItem = customItem || gameItem
+  if (!sourceItem) return res.status(404).json({ error: 'not_found' })
 
-  const item = await promoteCustomItemToGameItem({ customItem, gameId: game.id })
+  const item = await promoteLibraryItemToGameItem({ item: sourceItem, gameId: game.id })
   res.json({ item })
 })
 

docs/todo.md

@@ -1,4 +1,6 @@
 # 할 일 및 이슈
+- 아이템 관리, 티어표 관리, 전체 티어표 관리 등에서 아이템의 이름을 관리자가 직접 수정할 수 있어야 한다.
+(사용자가 이름없이 파일을 그대로 올렸을 경우 해당 아이템을 사용 할 수 없기 때문)
 
 ## 중기 개선
 - 라이트모드/다크모드 2차 보정까지 반영했으므로, 남은 작업은 전체 화면을 실제 사용 흐름으로 돌려 보며 대비·명도·아이콘 가독성을 미세하게 QA하는 최종 테마 점검 단계로 가져간다.
@@ -10,3 +12,13 @@
 - production에서 SESSION_SECRET 누락 시 서버가 부팅되지 않도록 강제한다.
 - helmet 기반 보안 헤더와 업로드 정적 응답 헤더를 정리한다.
 - 책 아이콘 기반 사용법 모달은 제작 흐름뿐 아니라 복사, 템플릿 업데이트 요청, 새 템플릿 요청까지 확장했으므로, 실제 16:9 스크린샷 자산과 단계별 문구를 운영 톤에 맞게 채운다.
+
+- 관리자 아이템 라이브러리에서 동일 이미지(src)를 여러 템플릿이 공유하는 경우, 필요하면 묶어서 보거나 대표 카드로 합쳐 보는 후속 정리 옵션을 검토한다.
+
+- 라이트모드 최종 QA 시 홈/설정/관리자/에디터를 실제 사용 흐름으로 돌리며, 남아 있는 하드코딩 텍스트 색과 플레이스홀더 배경을 한 번 더 점검한다.
+
+- 관리자 아이템 라이브러리는 보관 자산까지 노출되므로, 이후에는 `활성 템플릿 / 보관 자산` 분리 필터나 그룹 보기까지 검토한다.
+
+- 가이드 모달과 관리자 아이템 모달은 현재 같은 톤의 큰 셸을 쓰므로, 이후 공통 모달 레이아웃 컴포넌트로 분리할지 검토한다.
+
+- 관리자 아이템 라이브러리 이름 변경은 템플릿·사용자 업로드·보관 자산까지 모두 가능하므로, 이후에는 일괄 이름 정리나 중복 이름 감지 보조 기능까지 검토한다.

docs/update.md

@@ -1,5 +1,37 @@
 # 업데이트 로그
 
+## 2026-04-01 v1.3.39
+- 관리자 템플릿 요청 미리보기는 요청 시 저장된 보드 스냅샷이 비어 있을 경우 요청 아이템 배열을 fallback으로 사용해, 대표 썸네일만 보이는 상황을 줄이고 요청 내용을 더 안정적으로 확인할 수 있게 보정함.
+- 관리자 아이템 상세 모달에는 아이템 이름 입력과 저장 버튼을 추가해, 템플릿 아이템·사용자 업로드·보관 자산 모두 파일명과 무관하게 사람이 읽기 좋은 이름으로 다시 정리할 수 있게 함.
+- 보관 자산용 image asset에는 이름 override 컬럼을 추가해, 무작위 WebP 파일명을 그대로 노출하지 않고 라이브러리 표시명만 따로 관리할 수 있게 확장함.
+
+## 2026-04-01 v1.3.38
+- Settings 화면 오른쪽 사이드의 테마 설정 패널은 다시 쓰기 전까지 숨김 처리하고, 현재 기본 다크모드를 유지한 채 다른 화면과 동일하게 스폰서 광고만 노출되도록 정리함.
+- 관리자 아이템 모달에서 템플릿에 사용 중인 게임 배지는 다크모드에서도 읽히는 텍스트 색으로 맞추고, hover/focus 전환 효과를 추가해 상호작용이 더 분명하게 보이도록 보강함.
+- 관리자 아이템 모달은 데스크톱에서 최소 폭을 800px로 늘리고 최대 높이를 뷰포트 안으로 제한했으며, 16:9 이미지는 높이 상한을 둬서 모달이 넓어질 때도 이미지와 하단 버튼이 과하게 뭉개지지 않도록 정리함.
+
+## 2026-04-01 v1.3.37
+- 가이드 모달은 모바일에서 왼쪽 단계 목록 대신 현재 단계만 선택하는 셀렉트형 피커를 중심으로 쓰도록 높이와 내부 스크롤 구조를 다시 잡아, 작은 화면에서도 내용이 잘리지 않고 조작할 수 있게 정리함.
+- 관리자 아이템 상세 모달은 가이드 모달과 같은 큰 2단 셸 문법으로 다시 묶어, 왼쪽 게임 선택 패널과 오른쪽 이미지·메타·액션 영역이 더 넓고 여유 있게 보이도록 재구성함.
+- 아이템 상세 모달 내부 정보 카드와 액션 영역도 같은 톤의 패널형 블록으로 정리해, 가이드와 관리자 모달 사이의 시각적 통일감을 높임.
+
+## 2026-04-01 v1.3.36
+- `내 티어표` 화면 헤더를 공통 `pageHead` 문법으로 통일하고, 라이트모드에서는 공통 `railHeader` 배경을 사이드 레일과 같은 톤으로 맞춰 화면 간 상단 밀도 차를 줄임.
+- 관리자 아이템 상세 모달은 더 넓은 비율로 키우고, 템플릿에 연결된 게임 이름은 hover 가능한 버튼으로 바꿔 클릭 시 해당 게임이 선택된 `게임 관리` 탭으로 바로 이동할 수 있게 함.
+- 관리자 아이템 라이브러리는 이제 게임에 연결된 템플릿 이미지뿐 아니라 연결이 해제된 `/uploads/assets/` 보관 자산도 함께 보여줘, 게임 목록에서 아이템을 제거해도 아이템 관리에서는 계속 검수·재연결할 수 있게 정리함.
+- 아이템 관리 탭은 다른 탭으로 이동했다가 돌아오면 검색어와 필터를 초기화해, 결과가 남아 있어 목록이 비어 보이는 오해를 줄이도록 조정함.
+
+## 2026-04-01 v1.3.35
+- 라이트모드에서 홈 게임 카드의 메타 텍스트와 대표 썸네일 플레이스홀더, 브랜드 타이틀 색을 다시 정리하고, 전체 밝기도 약간 눌러 눈부심이 덜한 회백색 톤으로 보정함.
+- 관리자 아이템 상세 모달은 더 넓은 2단 레이아웃으로 키우고, 브라우저 뒤로가기 시 페이지 이탈 대신 모달이 먼저 닫히도록 히스토리 동작을 보강함.
+- 아이템 라이브러리의 삭제 기준을 다시 정리해, 사용자 업로드는 어디에도 연결되지 않았을 때만 삭제하고 관리자 템플릿 이미지는 라이브러리에서도 해당 템플릿 항목을 제거할 수 있게 확장함.
+
+## 2026-04-01 v1.3.34
+- 관리자 아이템 관리 오른쪽 사이드에서는 `가져올 게임` 셀렉트를 제거하고, 사용자 업로드와 관리자 템플릿 이미지를 함께 검수하는 라이브러리 흐름으로 단순화함.
+- 아이템 상세 모달은 좌측에 검색/정렬 가능한 게임 리스트를 두고 우측에 이미지·메타·액션을 배치하는 2단 레이아웃으로 재구성해, 많은 게임 속에서도 직접 검수 후 템플릿에 연결하기 쉽게 정리함.
+- 아이템 라이브러리에는 이제 관리자 템플릿 이미지도 함께 표시하고, 배지로 `사용자 업로드 / 관리자 템플릿`을 구분하며 새 업로드 WebP 파일명에서는 시간 정보처럼 보이는 접두 숫자를 제거함.
+- 템플릿 아이템까지 함께 보이는 구조에 맞춰 삭제 API도 사용자 업로드이면서 템플릿에 연결되지 않은 항목만 지울 수 있도록 안전 장치를 보강함.
+
 ## 2026-04-01 v1.3.33
 - 라이트모드/다크모드 2차 보정으로 관리자 화면과 티어 에디터의 카드, 패널, 입력창, 모달, 썸네일 프레임을 전역 테마 변수 기준으로 다시 맞춰, 후속 화면에서도 명도 차가 더 자연스럽게 이어지도록 정리함.
 - 공통 셸도 함께 손봐서 좌측 사이드 아이콘 필터와 텍스트 대비를 테마 변수 기반으로 전환하고, 가이드 모달·축소 검색 모달·내비 활성 상태까지 라이트모드에서 읽기 쉬운 톤으로 보정함.

frontend/src/App.vue

@@ -128,7 +128,7 @@ const isGuidePrevDisabled = computed(() => guideStepIndex.value <= 0)
 const isGuideNextDisabled = computed(() => guideStepIndex.value >= guideSteps.length - 1)
 const isLightTheme = computed(() => themeMode.value === 'light')
 const themeToggleLabel = computed(() => (isLightTheme.value ? '다크 모드' : '라이트 모드'))
-const showSettingsThemePanel = computed(() => route.name === 'profile')
+const showSettingsThemePanel = computed(() => false && route.name === 'profile')
 const showGameHubViewToggle = computed(() => route.name === 'gameHub')
 const gameHubViewMode = computed(() => (route.query.view === 'list' ? 'list' : 'grid'))
 const leftBottomPrimaryAction = computed(() => {
@@ -526,6 +526,12 @@ function submitGlobalSearch() {
           <div class="guideModal__sidebar">
             <div class="guideModal__eyebrow">Guide</div>
             <div class="guideModal__title">티어 메이커 기능 안내</div>
+            <div class="guideModal__mobilePicker">
+              <label class="guideModal__mobileLabel" for="guide-step-select">단계 선택</label>
+              <select id="guide-step-select" class="guideModal__mobileSelect" :value="guideStepIndex" @change="selectGuideStep(Number($event.target.value))">
+                <option v-for="(step, index) in guideSteps" :key="step.id + '-select'" :value="index">{{ index + 1 }}. {{ step.title }}</option>
+              </select>
+            </div>
             <div class="guideModal__list">
               <button
                 v-for="(step, index) in guideSteps"
@@ -684,6 +690,7 @@ function submitGlobalSearch() {
   align-items: center;
   padding: 0 12px;
   border-bottom: 1px solid var(--theme-border);
+  background: var(--theme-rail-bg);
   box-sizing: border-box;
 }
 
@@ -1065,10 +1072,7 @@ function submitGlobalSearch() {
   font-size: 28px;
   font-weight: 900;
   letter-spacing: -0.05em;
-  background-image: linear-gradient(90deg, #ff75c3 0%, #ffa647 20%, #ffe83f 40%, #9fff5b 60%, #70e2ff 80%, #cd93ff 100%);
-  -webkit-background-clip: text;
-  background-clip: text;
-  color: transparent;
+  color: var(--theme-text-strong);
 }
 
 .workspaceHead__brandSub {
@@ -1268,7 +1272,7 @@ function submitGlobalSearch() {
 
 .guideModal__dialog {
   width: min(1180px, calc(100vw - 40px));
-  min-height: min(760px, calc(100dvh - 64px));
+  height: min(760px, calc(100dvh - 64px));
   display: grid;
   grid-template-columns: 260px minmax(0, 1fr);
   border-radius: 28px;
@@ -1301,6 +1305,28 @@ function submitGlobalSearch() {
   letter-spacing: -0.04em;
 }
 
+.guideModal__mobilePicker {
+  display: none;
+}
+
+.guideModal__mobileLabel {
+  font-size: 11px;
+  letter-spacing: 0.12em;
+  text-transform: uppercase;
+  color: var(--theme-text-faint);
+}
+
+.guideModal__mobileSelect {
+  width: 100%;
+  min-height: 56px;
+  padding: 0 18px;
+  border-radius: 18px;
+  border: 1px solid rgba(77, 127, 233, 0.46);
+  background: rgba(77, 127, 233, 0.14);
+  color: var(--theme-text-strong);
+  font-weight: 800;
+}
+
 .guideModal__list {
   display: grid;
   gap: 8px;
@@ -1343,8 +1369,10 @@ function submitGlobalSearch() {
   display: grid;
   grid-template-rows: auto minmax(0, 1fr);
   padding: 24px 28px 28px;
+  min-height: 0;
 }
 
+
 .guideModal__close {
   justify-self: end;
   border: 0;
@@ -1356,6 +1384,7 @@ function submitGlobalSearch() {
 
 .guideModal__content {
   min-width: 0;
+  min-height: 0;
   display: grid;
   grid-template-columns: 52px minmax(0, 1fr) 52px;
   gap: 16px;
@@ -1364,6 +1393,7 @@ function submitGlobalSearch() {
 
 .guideModal__body {
   min-width: 0;
+  min-height: 0;
   display: grid;
   gap: 18px;
 }
@@ -1619,7 +1649,7 @@ function submitGlobalSearch() {
 @media (max-width: 1200px) {
   .guideModal__dialog {
     grid-template-columns: 1fr;
-    min-height: auto;
+    height: min(860px, calc(100dvh - 40px));
   }
 
   .guideModal__sidebar {
@@ -1671,20 +1701,55 @@ function submitGlobalSearch() {
 
   .guideModal__dialog {
     width: min(100%, calc(100vw - 24px));
+    height: min(100%, calc(100dvh - 24px));
+  }
+
+  .guideModal__sidebar {
+    gap: 14px;
+    padding: 20px 18px;
+  }
+
+  .guideModal__mobilePicker {
+    display: grid;
+    gap: 8px;
+  }
+
+  .guideModal__list {
+    display: none;
   }
 
   .guideModal__main {
     padding: 20px 18px 18px;
+    min-height: 0;
   }
 
   .guideModal__content {
     grid-template-columns: 1fr;
+    min-height: 0;
   }
 
   .guideModal__arrow {
     display: none;
   }
 
+  .guideModal__body {
+    align-content: start;
+    overflow: auto;
+    padding-right: 2px;
+  }
+
+  .guideModal__mediaPlaceholder {
+    border-radius: 22px;
+  }
+
+  .guideModal__stepTitle {
+    font-size: 24px;
+  }
+
+  .guideModal__stepSummary {
+    font-size: 15px;
+  }
+
   .guideModal__footer {
     flex-direction: column;
     align-items: stretch;
@@ -1697,10 +1762,6 @@ function submitGlobalSearch() {
   .guideDockButton {
     display: none;
   }
-
-  .guideModal__list {
-    grid-template-columns: 1fr 1fr;
-  }
 }
 
 @media (max-width: 860px) {

frontend/src/lib/api.js

@@ -55,6 +55,8 @@ export const api = {
   cleanupAdminUnusedImageAssets: (payload) => request('/api/admin/image-assets/cleanup', { method: 'POST', body: payload || {} }),
   promoteAdminCustomItem: (itemId, payload) =>
     request(`/api/admin/custom-items/${encodeURIComponent(itemId)}/promote`, { method: 'POST', body: payload }),
+  updateAdminCustomItemLabel: (itemId, payload) =>
+    request(`/api/admin/custom-items/${encodeURIComponent(itemId)}/label`, { method: 'PATCH', body: payload }),
   promoteAdminTierListItems: (tierListId, payload) =>
     request(`/api/admin/tierlists/${encodeURIComponent(tierListId)}/promote-items`, { method: 'POST', body: payload }),
   createAdminGameTemplateFromTierList: (tierListId, payload) =>

frontend/src/style.css

@@ -38,28 +38,28 @@
 }
 
 :root[data-theme='light'] {
-  --theme-body-bg: #edf1f7;
-  --theme-shell-bg: rgba(244, 247, 252, 0.98);
-  --theme-rail-bg: rgba(248, 250, 253, 0.96);
-  --theme-main-bg: rgba(241, 244, 249, 0.98);
-  --theme-workspace-bg: rgba(250, 252, 255, 0.95);
-  --theme-card-bg: rgba(255, 255, 255, 0.98);
-  --theme-card-bg-hover: rgba(245, 248, 255, 0.98);
-  --theme-card-border: rgba(26, 32, 44, 0.1);
-  --theme-card-shadow: 0 18px 34px rgba(31, 41, 55, 0.08);
-  --theme-surface-soft: rgba(15, 23, 42, 0.05);
-  --theme-surface-soft-2: rgba(15, 23, 42, 0.07);
-  --theme-surface-soft-3: rgba(15, 23, 42, 0.1);
-  --theme-pill-bg: rgba(15, 23, 42, 0.04);
-  --theme-border: rgba(15, 23, 42, 0.1);
-  --theme-border-strong: rgba(15, 23, 42, 0.14);
-  --theme-text: rgba(20, 27, 40, 0.9);
+  --theme-body-bg: #e7ebf2;
+  --theme-shell-bg: rgba(237, 241, 247, 0.98);
+  --theme-rail-bg: rgba(243, 246, 251, 0.97);
+  --theme-main-bg: rgba(232, 236, 243, 0.98);
+  --theme-workspace-bg: rgba(247, 249, 252, 0.96);
+  --theme-card-bg: rgba(252, 253, 255, 0.98);
+  --theme-card-bg-hover: rgba(244, 247, 251, 0.98);
+  --theme-card-border: rgba(31, 41, 55, 0.11);
+  --theme-card-shadow: 0 18px 34px rgba(31, 41, 55, 0.07);
+  --theme-surface-soft: rgba(30, 41, 59, 0.055);
+  --theme-surface-soft-2: rgba(30, 41, 59, 0.075);
+  --theme-surface-soft-3: rgba(30, 41, 59, 0.105);
+  --theme-pill-bg: rgba(30, 41, 59, 0.045);
+  --theme-border: rgba(30, 41, 59, 0.11);
+  --theme-border-strong: rgba(30, 41, 59, 0.16);
+  --theme-text: rgba(20, 27, 40, 0.92);
   --theme-text-strong: rgba(10, 15, 28, 0.98);
-  --theme-text-muted: rgba(55, 65, 81, 0.74);
-  --theme-text-soft: rgba(75, 85, 99, 0.64);
-  --theme-text-faint: rgba(100, 116, 139, 0.82);
-  --theme-thumb-fallback-bg: #d8dde8;
-  --theme-select-arrow: rgba(55, 65, 81, 0.72);
+  --theme-text-muted: rgba(55, 65, 81, 0.76);
+  --theme-text-soft: rgba(75, 85, 99, 0.72);
+  --theme-text-faint: rgba(100, 116, 139, 0.88);
+  --theme-thumb-fallback-bg: #f6f8fb;
+  --theme-select-arrow: rgba(55, 65, 81, 0.74);
   --theme-danger-bg: rgba(239, 68, 68, 0.1);
   --theme-danger-border: rgba(239, 68, 68, 0.22);
   --theme-accent-bg: rgba(64, 110, 226, 0.94);

frontend/src/views/AdminView.vue

@@ -31,8 +31,9 @@ const customItemPage = ref(1)
 const customItemLimit = ref(50)
 const customItemTotal = ref(0)
 const customItemOrphanOnly = ref(false)
-const customItemTargetGameId = ref('')
 const customItemModalTargetGameId = ref('')
+const customItemModalGameQuery = ref('')
+const customItemModalGameSort = ref('recent')
 
 const adminTierLists = ref([])
 const adminTierListQuery = ref('')
@@ -55,6 +56,7 @@ const userDeleteModalOpen = ref(false)
 const userRoleModalOpen = ref(false)
 const customItemModalOpen = ref(false)
 const customItemDeleteModalOpen = ref(false)
+const customItemModalHistoryActive = ref(false)
 const modalTargetUser = ref(null)
 const modalPasswordDraft = ref('')
 const modalRoleNextAdmin = ref(false)
@@ -62,6 +64,8 @@ const modalUserDraftEmail = ref('')
 const modalUserDraftNickname = ref('')
 const modalUserDraftIsAdmin = ref(false)
 const modalTargetCustomItem = ref(null)
+const customItemModalDraftLabel = ref('')
+const customItemModalLabelSaving = ref(false)
 
 const users = ref([])
 const userQuery = ref('')
@@ -137,7 +141,7 @@ const activeTabDescription = computed(() => {
     return '게임 생성, 선택, 썸네일, 기본 아이템 관리를 전용 작업 화면으로 분리했습니다.'
   }
   if (activeTab.value === 'items') {
-    return '사용자 커스텀 이미지를 검색하고, 미사용 이미지를 정리하거나 템플릿으로 승격할 수 있어요.'
+    return '사용자 업로드와 관리자 템플릿 이미지를 함께 검수하고, 필요한 게임에 직접 연결할 수 있어요.'
   }
   if (activeTab.value === 'tierlists') {
     return tierlistsMode.value === 'requests'
@@ -170,7 +174,7 @@ const adminOverviewStats = computed(() => {
     return [
       { label: '검색 결과', value: `${customItemTotal.value}` },
       { label: '미사용', value: `${orphanItems}` },
-      { label: '대상 게임', value: customItemTargetGameId.value ? '선택됨' : '미선택' },
+      { label: '템플릿 아이템', value: `${customItems.value.filter((item) => item.sourceType === 'template').length}` },
     ]
   }
   if (activeTab.value === 'tierlists') {
@@ -193,13 +197,26 @@ const adminOverviewStats = computed(() => {
   ]
 })
 
+function handleAdminPopState() {
+  if (customItemDeleteModalOpen.value) {
+    customItemDeleteModalOpen.value = false
+    if (customItemModalOpen.value) pushCustomItemModalHistoryState()
+    return
+  }
+  if (customItemModalOpen.value) {
+    closeCustomItemModal({ fromPopState: true })
+  }
+}
+
 onMounted(async () => {
+  if (typeof window !== 'undefined') window.addEventListener('popstate', handleAdminPopState)
   await auth.refresh()
   await Promise.all([refreshGames(), refreshCustomItems(), refreshAdminTierLists(), refreshUsers(), refreshTemplateRequests(), refreshImageDiagnostics()])
   await syncFeaturedSortable()
 })
 
 onUnmounted(() => {
+  if (typeof window !== 'undefined') window.removeEventListener('popstate', handleAdminPopState)
   clearPreviewUrl('item')
   clearPreviewUrl('thumb')
   destroyFeaturedSortable()
@@ -283,6 +300,21 @@ const imageDiagnosticsCards = computed(() => {
 const visibleLinkedGames = computed(() =>
   (modalTargetCustomItem.value?.linkedGames || []).filter((game) => game?.id && game.id !== 'freeform')
 )
+const filteredCustomItemModalGames = computed(() => {
+  const query = customItemModalGameQuery.value.trim().toLowerCase()
+  const linkedIds = new Set(visibleLinkedGames.value.map((game) => game.id))
+  const list = games.value.filter((game) => {
+    if (!query) return true
+    return `${game.name || ''} ${game.id || ''}`.toLowerCase().includes(query)
+  })
+
+  return list.slice().sort((a, b) => {
+    const linkedDelta = Number(linkedIds.has(a.id)) - Number(linkedIds.has(b.id))
+    if (linkedDelta !== 0) return linkedDelta
+    if (customItemModalGameSort.value === 'oldest') return Number(a.createdAt || 0) - Number(b.createdAt || 0)
+    return Number(b.createdAt || 0) - Number(a.createdAt || 0)
+  })
+})
 
 const imageStatsPeriodLabel = computed(() => (imageStatsMonth.value ? `${imageStatsMonth.value} 기준` : '전체 기간'))
 const imageStatsYearOptions = computed(() => {
@@ -370,6 +402,12 @@ function setTab(tab) {
   if (tab === 'tierlists') {
     tierlistsMode.value = 'requests'
   }
+  if (tab === 'items') {
+    customItemQuery.value = ''
+    customItemOrphanOnly.value = false
+    customItemPage.value = 1
+    refreshCustomItems()
+  }
 }
 
 function setTierlistsMode(mode) {
@@ -532,7 +570,7 @@ async function refreshCustomItems() {
     customItemPage.value = data.page || 1
     customItemLimit.value = data.limit || customItemLimit.value
   } catch (e) {
-    error.value = '사용자 커스텀 아이템을 불러오지 못했어요.'
+    error.value = '아이템 라이브러리를 불러오지 못했어요.'
   }
 }
 
@@ -1032,22 +1070,47 @@ function moveCustomItemPage(direction) {
   refreshCustomItems()
 }
 
-function openCustomItemModal(item) {
-  modalTargetCustomItem.value = item || null
-  customItemModalTargetGameId.value = ''
-  customItemModalOpen.value = true
+function pushCustomItemModalHistoryState() {
+  if (typeof window === 'undefined') return
+  window.history.pushState({ ...(window.history.state || {}), adminCustomItemModal: true }, '', window.location.href)
+  customItemModalHistoryActive.value = true
 }
 
-function closeCustomItemModal() {
-  customItemModalOpen.value = false
-  modalTargetCustomItem.value = null
+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.usageCount > 0) {
-    error.value = '사용 중인 커스텀 이미지는 먼저 참조를 정리해야 삭제할 수 있어요.'
+  if (item.sourceType === 'user' && (item.usageCount > 0 || item.linkedGames.length > 0)) {
+    error.value = '사용 중이거나 템플릿에 연결된 사용자 업로드 이미지는 먼저 참조를 정리해야 삭제할 수 있어요.'
     return
   }
   modalTargetCustomItem.value = item
@@ -1058,11 +1121,20 @@ 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.usageCount > 0) {
-    error.value = '사용 중인 커스텀 이미지는 먼저 참조를 정리해야 삭제할 수 있어요.'
+  if (item.sourceType === 'user' && (item.usageCount > 0 || item.linkedGames.length > 0)) {
+    error.value = '사용 중이거나 템플릿에 연결된 사용자 업로드 이미지는 먼저 참조를 정리해야 삭제할 수 있어요.'
     return
   }
 
@@ -1071,9 +1143,9 @@ async function removeCustomItem(item = modalTargetCustomItem.value) {
     closeCustomItemDeleteModal()
     closeCustomItemModal()
     await refreshCustomItems()
-    success.value = '미사용 커스텀 이미지를 삭제했어요.'
+    success.value = item.sourceType === 'template' ? '선택한 템플릿 아이템을 제거했어요.' : '사용자 업로드 이미지를 삭제했어요.'
   } catch (e) {
-    error.value = '커스텀 이미지 삭제에 실패했어요.'
+    error.value = item.sourceType === 'template' ? '템플릿 아이템 제거에 실패했어요.' : '사용자 업로드 이미지 삭제에 실패했어요.'
   }
 }
 
@@ -1085,16 +1157,35 @@ async function removeUnusedCustomItems() {
   try {
     const data = await api.deleteAdminUnusedCustomItems({ q: customItemQuery.value })
     await refreshCustomItems()
-    success.value = `${data.deletedCount || 0}개의 미사용 커스텀 이미지를 삭제했어요.`
+    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 = '가져올 게임을 먼저 선택해주세요.'
+    error.value = '추가할 게임을 먼저 선택해주세요.'
     return
   }
 
@@ -1104,9 +1195,9 @@ async function promoteCustomItem(item) {
     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} 기본 템플릿으로 추가했어요.`
+    success.value = `"${item.label}" 이미지를 ${targetGameName} 템플릿으로 추가했어요.`
   } catch (e) {
-    error.value = '커스텀 아이템을 기본 템플릿으로 가져오지 못했어요.'
+    error.value = '선택한 이미지를 템플릿으로 추가하지 못했어요.'
   } finally {
     item.isPromoting = false
   }
@@ -1148,6 +1239,7 @@ function previewRequestPoolItems(preview) {
 }
 
 function openTemplateRequestPreview(request) {
+  const snapshotItems = Array.isArray(request.snapshotItems) && request.snapshotItems.length ? request.snapshotItems : Array.isArray(request.items) ? request.items : []
   previewTierList.value = {
     id: request.id,
     title: request.sourceTierListTitle || '템플릿 요청 미리보기',
@@ -1155,7 +1247,7 @@ function openTemplateRequestPreview(request) {
     thumbnailSrc: request.thumbnailSrc || '',
     requestPreview: true,
     snapshotGroups: request.snapshotGroups || [],
-    snapshotItems: request.snapshotItems || [],
+    snapshotItems,
     snapshotShowCharacterNames: !!request.snapshotShowCharacterNames,
   }
   previewModalOpen.value = true
@@ -1535,9 +1627,10 @@ async function saveFeaturedOrder() {
 
             <template v-else-if="activeTab === 'items'">
           <div class="panel">
-            <div v-if="!customItems.length" class="hint">조건에 맞는 커스텀 아이템이 없어요.</div>
+            <div v-if="!customItems.length" class="hint">조건에 맞는 관리 대상 아이템이 없어요.</div>
             <div v-else class="customItemGrid">
               <button v-for="item in customItems" :key="item.id" type="button" class="customItemCard" @click="openCustomItemModal(item)">
+                <span class="customItemCard__badge" :class="{ 'customItemCard__badge--template': item.sourceType === 'template' }">{{ item.sourceLabel }}</span>
                 <img class="customItemCard__image" :src="toApiUrl(item.src)" :alt="item.label" />
                 <div class="customItemCard__title" :title="item.label">{{ item.label }}</div>
               </button>
@@ -1911,42 +2004,76 @@ async function saveFeaturedOrder() {
 
             <div v-if="customItemModalOpen" class="modalOverlay" @click.self="closeCustomItemModal">
               <div class="modalCard modalCard--customItem" role="dialog" aria-modal="true">
-                <div class="modalCard__titleRow">
-                  <div class="modalCard__title">커스텀 아이템 상세</div>
-                  <button class="btn btn--ghost btn--small" @click="closeCustomItemModal">닫기</button>
-                </div>
                 <div v-if="modalTargetCustomItem" class="customItemModal">
-                  <div class="customItemModal__side">
-                    <img class="customItemModal__image" :src="toApiUrl(modalTargetCustomItem.src)" :alt="modalTargetCustomItem.label" />
-                    <div class="customItemModal__selector">
-                      <span class="customItemModal__label">기본 템플릿에 추가</span>
-                      <select v-model="customItemModalTargetGameId" class="select">
-                        <option value="">게임 선택</option>
-                        <option v-for="game in games" :key="game.id" :value="game.id">{{ game.name }}</option>
+                  <aside class="customItemModal__pickerPanel">
+                    <div class="customItemModal__pickerHead">
+                      <div class="customItemModal__pickerEyebrow">GAME PICKER</div>
+                      <div class="customItemModal__pickerTitle">템플릿으로 추가할 게임</div>
+                    </div>
+                    <div class="customItemModal__pickerControls">
+                      <input v-model="customItemModalGameQuery" class="input input--dense" placeholder="게임 이름, ID 검색" />
+                      <select v-model="customItemModalGameSort" class="select">
+                        <option value="recent">최신순</option>
+                        <option value="oldest">오래된순</option>
                       </select>
                     </div>
+                    <div class="customItemModal__gameList">
+                      <button
+                        v-for="game in filteredCustomItemModalGames"
+                        :key="game.id"
+                        type="button"
+                        class="customItemModal__gameItem"
+                        :class="{
+                          'customItemModal__gameItem--active': customItemModalTargetGameId === game.id,
+                          'customItemModal__gameItem--linked': visibleLinkedGames.some((entry) => entry.id === game.id),
+                        }"
+                        @click="customItemModalTargetGameId = game.id"
+                      >
+                        <span class="customItemModal__gameName">{{ game.name }}</span>
+                        <span class="customItemModal__gameMeta">{{ game.id }}</span>
+                        <span v-if="visibleLinkedGames.some((entry) => entry.id === game.id)" class="customItemModal__gameState">이미 포함됨</span>
+                      </button>
+                    </div>
+                  </aside>
+                  <div class="customItemModal__body">
+                    <button class="customItemModal__close" type="button" @click="closeCustomItemModal">닫기</button>
+                    <div class="customItemModal__content">
+                      <div class="customItemModal__titleRow">
+                        <div>
+                          <div class="customItemModal__title">{{ modalTargetCustomItem.label }}</div>
+                          <div class="customItemModal__source">{{ modalTargetCustomItem.sourceLabel }}</div>
+                        </div>
+                      </div>
+                      <div class="customItemModal__labelEditor">
+                        <label class="field">
+                          <span class="field__label">아이템 이름</span>
+                          <input v-model="customItemModalDraftLabel" class="field__input" type="text" maxlength="60" placeholder="아이템 이름" />
+                        </label>
+                        <button class="btn btn--ghost customItemModal__renameButton" type="button" :disabled="customItemModalLabelSaving || !customItemModalDraftLabel.trim() || customItemModalDraftLabel.trim() === modalTargetCustomItem.label" @click="saveCustomItemModalLabel">
+                          {{ customItemModalLabelSaving ? '저장중...' : '이름 저장' }}
+                        </button>
+                      </div>
+                      <img class="customItemModal__image" :src="toApiUrl(modalTargetCustomItem.src)" :alt="modalTargetCustomItem.label" />
+                    <div class="customItemModal__metaList">
+                      <div class="customItemModal__metaRow"><span>파일</span><strong :title="modalTargetCustomItem.src.split('/').pop()">{{ modalTargetCustomItem.src.split('/').pop() }}</strong></div>
+                      <div class="customItemModal__metaRow"><span>업로더/출처</span><strong :title="modalTargetCustomItem.ownerName">{{ modalTargetCustomItem.ownerName }}</strong></div>
+                      <div class="customItemModal__metaRow"><span>템플릿 연결</span><strong>{{ visibleLinkedGames.length }}개 게임</strong></div>
+                      <div class="customItemModal__metaRow"><span>등록일</span><strong>{{ fmt(modalTargetCustomItem.createdAt) }}</strong></div>
+                    </div>
                     <div class="customItemModal__linked">
                       <span class="customItemModal__label">템플릿에 사용 중인 게임</span>
                       <div v-if="visibleLinkedGames.length" class="customItemModal__chips">
-                        <span v-for="game in visibleLinkedGames" :key="game.id" class="pill">{{ game.name }}</span>
+                        <button v-for="game in visibleLinkedGames" :key="game.id" type="button" class="pill pill--link" @click="jumpToGameAdmin(game.id)">{{ game.name }}</button>
                       </div>
                       <div v-else class="hint hint--tight">아직 템플릿에 연결된 게임이 없어요.</div>
                     </div>
-                  </div>
-                  <div class="customItemModal__body">
-                    <div class="customItemModal__title">{{ modalTargetCustomItem.label }}</div>
-                    <div class="customItemModal__metaList">
-                      <div class="customItemModal__metaRow"><span>파일</span><strong :title="modalTargetCustomItem.src.split('/').pop()">{{ modalTargetCustomItem.src.split('/').pop() }}</strong></div>
-                      <div class="customItemModal__metaRow"><span>업로더</span><strong :title="modalTargetCustomItem.ownerName">{{ modalTargetCustomItem.ownerName }}</strong></div>
-                      <div class="customItemModal__metaRow"><span>사용 중</span><strong>{{ modalTargetCustomItem.usageCount }}개 티어표</strong></div>
-                      <div class="customItemModal__metaRow"><span>등록일</span><strong>{{ fmt(modalTargetCustomItem.createdAt) }}</strong></div>
-                    </div>
-                    <div class="customItemModal__actions">
-                      <a class="btn btn--ghost" :href="toApiUrl(modalTargetCustomItem.src)" :download="modalTargetCustomItem.label">이미지 다운로드</a>
-                      <button class="btn btn--ghost" :disabled="!customItemModalTargetGameId || modalTargetCustomItem.isPromoting" @click="promoteCustomItem(modalTargetCustomItem)">
-                        {{ modalTargetCustomItem.isPromoting ? '추가중...' : '기본 템플릿에 추가' }}
-                      </button>
-                      <button class="btn btn--danger" :disabled="modalTargetCustomItem.usageCount > 0" @click="openCustomItemDeleteModal(modalTargetCustomItem)">삭제</button>
+                      <div class="customItemModal__actions">
+                        <a class="btn btn--ghost customItemModal__action" :href="toApiUrl(modalTargetCustomItem.src)" :download="modalTargetCustomItem.label">이미지 다운로드</a>
+                        <button class="btn btn--ghost customItemModal__action" :disabled="!customItemModalTargetGameId || modalTargetCustomItem.isPromoting" @click="promoteCustomItem(modalTargetCustomItem)">
+                          {{ modalTargetCustomItem.isPromoting ? '추가중...' : '기본 템플릿에 추가' }}
+                        </button>
+                        <button v-if="modalTargetCustomItem.canDelete" class="btn btn--danger customItemModal__action" :disabled="modalTargetCustomItem.sourceType === 'user' && (modalTargetCustomItem.usageCount > 0 || visibleLinkedGames.length > 0)" @click="openCustomItemDeleteModal(modalTargetCustomItem)">삭제</button>
+                      </div>
                     </div>
                   </div>
                 </div>
@@ -1955,8 +2082,8 @@ async function saveFeaturedOrder() {
 
             <div v-if="customItemDeleteModalOpen" class="modalOverlay" @click.self="closeCustomItemDeleteModal">
               <div class="modalCard" role="dialog" aria-modal="true">
-                <div class="modalCard__title">커스텀 아이템 삭제</div>
-                <div class="modalCard__desc">{{ modalTargetCustomItem ? '"' + modalTargetCustomItem.label + '" 이미지를 삭제할까요? 미사용 상태의 이미지에만 삭제를 허용합니다.' : '' }}</div>
+                <div class="modalCard__title">아이템 삭제</div>
+                <div class="modalCard__desc">{{ !modalTargetCustomItem ? '' : modalTargetCustomItem.sourceType === 'template' ? '"' + modalTargetCustomItem.label + '" 항목을 정리할까요? 게임에 연결된 항목이면 해당 템플릿과 저장된 같은 게임의 티어표에서도 함께 빠질 수 있고, 보관 자산이면 라이브러리에서만 제거됩니다.' : '"' + modalTargetCustomItem.label + '" 이미지를 삭제할까요? 사용자 업로드이면서 어디에도 연결되지 않은 이미지에만 삭제를 허용합니다.' }}</div>
                 <div class="modalCard__actions">
                   <button class="btn btn--ghost" @click="closeCustomItemDeleteModal">취소</button>
                   <button class="btn btn--danger" @click="removeCustomItem()">삭제</button>
@@ -2110,13 +2237,9 @@ async function saveFeaturedOrder() {
             <option :value="50">50개씩 보기</option>
             <option :value="200">200개씩 보기</option>
           </select>
-          <select v-model="customItemTargetGameId" class="select">
-            <option value="">가져올 게임 선택</option>
-            <option v-for="game in games" :key="game.id" :value="game.id">{{ game.name }}</option>
-          </select>
           <label class="checkRow checkRow--compact">
             <input v-model="customItemOrphanOnly" type="checkbox" @change="toggleCustomItemOrphanOnly" />
-            <span>미사용 커스텀 이미지만 보기</span>
+            <span>미사용 사용자 업로드만 보기</span>
           </label>
         </div>
         <div class="adminSidebar__actions">
@@ -2851,6 +2974,7 @@ async function saveFeaturedOrder() {
   display: grid;
   place-items: center;
   color: var(--theme-text-soft);
+  background: var(--theme-card-bg);
 }
 .selectedThumb--sidebar {
   width: 100%;
@@ -3039,6 +3163,7 @@ async function saveFeaturedOrder() {
 }
 .customItemCard {
   appearance: none;
+  position: relative;
   border: 1px solid rgba(255, 255, 255, 0.12);
   border-radius: 18px;
   background: var(--theme-surface-soft);
@@ -3051,6 +3176,24 @@ async function saveFeaturedOrder() {
   cursor: pointer;
   transition: border-color 0.18s ease, transform 0.18s ease, background 0.18s ease;
 }
+.customItemCard__badge {
+  position: absolute;
+  top: 10px;
+  left: 10px;
+  z-index: 1;
+  display: inline-flex;
+  align-items: center;
+  padding: 5px 8px;
+  border-radius: 999px;
+  background: color-mix(in srgb, var(--theme-main-bg) 82%, transparent);
+  color: var(--theme-text);
+  font-size: 10px;
+  font-weight: 800;
+  letter-spacing: 0.02em;
+}
+.customItemCard__badge--template {
+  background: rgba(96, 165, 250, 0.18);
+}
 .customItemCard:hover {
   border-color: rgba(126, 162, 255, 0.42);
   background: rgba(255, 255, 255, 0.06);
@@ -3072,37 +3215,128 @@ async function saveFeaturedOrder() {
   font-weight: 800;
   font-size: 13px;
   line-height: 1.3;
-  color: #ffffff;
+  color: var(--theme-text);
 }
 .customItemModal {
   display: grid;
-  grid-template-columns: minmax(200px, 240px) minmax(0, 1fr);
-  gap: 18px;
-  align-items: start;
+  grid-template-columns: 300px minmax(0, 1fr);
+  min-height: min(820px, calc(100dvh - 48px));
+  align-items: stretch;
 }
-.customItemModal__side {
+.customItemModal__pickerPanel {
   display: grid;
-  gap: 12px;
+  align-content: start;
+  gap: 18px;
   min-width: 0;
+  padding: 28px 22px;
+  border-right: 1px solid var(--theme-border);
+  background: var(--theme-pill-bg);
 }
-.customItemModal__image {
-  width: 100%;
-  aspect-ratio: 1 / 1;
-  object-fit: cover;
-  border-radius: 18px;
+.customItemModal__pickerHead {
+  display: grid;
+  gap: 4px;
+}
+.customItemModal__pickerEyebrow {
+  font-size: 11px;
+  letter-spacing: 0.12em;
+  text-transform: uppercase;
+  color: var(--theme-text-faint);
+}
+.customItemModal__pickerTitle {
+  font-size: 18px;
+  font-weight: 900;
+}
+.customItemModal__pickerControls {
+  display: grid;
+  gap: 10px;
+}
+.customItemModal__gameList {
+  display: grid;
+  gap: 8px;
+  max-height: 440px;
+  overflow: auto;
+}
+.customItemModal__gameItem {
+  display: grid;
+  gap: 4px;
+  padding: 12px 13px;
+  border-radius: 16px;
+  border: 1px solid var(--theme-border);
   background: var(--theme-surface-soft);
-  border: 1px solid rgba(255, 255, 255, 0.1);
+  color: var(--theme-text);
+  text-align: left;
+  cursor: pointer;
+}
+.customItemModal__gameItem--active {
+  border-color: rgba(96, 165, 250, 0.42);
+  background: rgba(96, 165, 250, 0.12);
+}
+.customItemModal__gameItem--linked {
+  border-style: dashed;
+}
+.customItemModal__gameName {
+  font-size: 13px;
+  font-weight: 800;
+}
+.customItemModal__gameMeta,
+.customItemModal__gameState {
+  font-size: 11px;
+  color: var(--theme-text-soft);
 }
 .customItemModal__body {
-  display: grid;
-  gap: 14px;
   min-width: 0;
+  min-height: 0;
+  display: grid;
+  grid-template-rows: auto minmax(0, 1fr);
+  gap: 16px;
+  padding: 24px 28px 28px;
 }
-.customItemModal__selector,
+.customItemModal__content {
+  min-width: 0;
+  min-height: 0;
+  display: grid;
+  align-content: start;
+  gap: 18px;
+  overflow: auto;
+  padding-right: 2px;
+}
+.customItemModal__labelEditor {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) auto;
+  gap: 12px;
+  align-items: end;
+}
+.customItemModal__renameButton {
+  white-space: nowrap;
+}
+.customItemModal__titleRow,
 .customItemModal__linked {
   display: grid;
   gap: 8px;
 }
+.customItemModal__linked {
+  padding: 14px 16px;
+  border-radius: 18px;
+  border: 1px solid var(--theme-border);
+  background: var(--theme-surface-soft);
+}
+.customItemModal__close {
+  justify-self: end;
+  border: 0;
+  background: transparent;
+  color: var(--theme-text-muted);
+  cursor: pointer;
+  font-size: 13px;
+}
+.customItemModal__image {
+  width: 100%;
+  aspect-ratio: 16 / 9;
+  max-height: min(360px, 34dvh);
+  object-fit: cover;
+  border-radius: 24px;
+  background: radial-gradient(circle at top, rgba(77, 127, 233, 0.18), rgba(255, 255, 255, 0.02) 52%), rgba(255, 255, 255, 0.03);
+  border: 1px solid var(--theme-border);
+}
 .customItemModal__label {
   font-size: 11px;
   color: var(--theme-text-faint);
@@ -3118,9 +3352,18 @@ async function saveFeaturedOrder() {
   line-height: 1.35;
   word-break: break-word;
 }
+.customItemModal__source {
+  margin-top: 4px;
+  font-size: 12px;
+  color: var(--theme-text-soft);
+}
 .customItemModal__metaList {
   display: grid;
   gap: 10px;
+  padding: 14px 16px;
+  border-radius: 18px;
+  border: 1px solid var(--theme-border);
+  background: var(--theme-surface-soft);
 }
 .customItemModal__metaRow {
   display: grid;
@@ -3140,12 +3383,30 @@ async function saveFeaturedOrder() {
   color: var(--theme-text);
 }
 .customItemModal__actions {
-  display: flex;
-  gap: 10px;
-  flex-wrap: wrap;
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 12px;
+  align-self: end;
+}
+.customItemModal__action {
+  width: 100%;
+  min-width: 0;
+  padding-inline: 12px;
+  white-space: normal;
+  line-height: 1.35;
+  text-align: center;
 }
 .modalCard--customItem {
-  width: min(760px, 100%);
+  width: min(1360px, calc(100vw - 40px));
+  min-width: min(800px, calc(100vw - 40px));
+  height: min(820px, calc(100dvh - 40px));
+  max-height: calc(100dvh - 40px);
+  padding: 0;
+  overflow: hidden;
+  border-radius: 28px;
+  border: 1px solid var(--theme-border-strong);
+  background: linear-gradient(180deg, rgba(34, 34, 34, 0.98), rgba(18, 18, 18, 0.98));
+  box-shadow: 0 28px 90px rgba(0, 0, 0, 0.42);
 }
 .pager {
   margin-top: 16px;
@@ -3628,6 +3889,7 @@ async function saveFeaturedOrder() {
   border-radius: 999px;
   border: 1px solid rgba(255, 255, 255, 0.12);
   background: var(--theme-surface-soft);
+  color: var(--theme-text);
   font-size: 12px;
   font-weight: 800;
 }
@@ -3636,6 +3898,22 @@ async function saveFeaturedOrder() {
   background: rgba(251, 191, 36, 0.12);
   color: rgba(253, 230, 138, 0.96);
 }
+.pill--link {
+  color: var(--theme-text);
+  cursor: pointer;
+  transition: background 160ms ease, border-color 160ms ease, transform 160ms ease, color 160ms ease, box-shadow 160ms ease;
+}
+.pill--link:hover {
+  color: var(--theme-text-strong);
+  border-color: rgba(96, 165, 250, 0.4);
+  background: color-mix(in srgb, var(--theme-surface-soft) 76%, rgba(96, 165, 250, 0.2));
+  box-shadow: 0 10px 22px rgba(0, 0, 0, 0.18);
+  transform: translateY(-1px);
+}
+.pill--link:focus-visible {
+  outline: 2px solid rgba(96, 165, 250, 0.42);
+  outline-offset: 2px;
+}
 .tierAdminSection {
   display: grid;
   gap: 10px;
@@ -3763,6 +4041,29 @@ async function saveFeaturedOrder() {
   }
   .customItemModal {
     grid-template-columns: 1fr;
+    min-height: auto;
+  }
+  .modalCard--customItem {
+    width: min(100%, calc(100vw - 24px));
+    height: min(100%, calc(100dvh - 24px));
+  }
+  .customItemModal__pickerPanel {
+    border-right: 0;
+    border-bottom: 1px solid var(--theme-border);
+    padding: 20px 18px;
+  }
+  .customItemModal__body {
+    min-height: 0;
+    padding: 20px 18px 18px;
+  }
+  .customItemModal__content {
+    min-height: 0;
+  }
+  .customItemModal__labelEditor {
+    grid-template-columns: 1fr;
+  }
+  .customItemModal__actions {
+    grid-template-columns: 1fr;
   }
   .adminSidebar {
     display: none;

frontend/src/views/HomeView.vue

@@ -215,7 +215,7 @@ function thumbUrl(g) {
   font-size: 18px;
 }
 .libraryCard__meta {
-  color: rgba(255, 255, 255, 0.6);
+  color: var(--theme-text-soft);
   font-size: 13px;
   white-space: nowrap;
   overflow: hidden;

frontend/src/views/MyTierListsView.vue

@@ -66,11 +66,11 @@ function openList(t) {
 </script>
 
 <template>
-  <section class="dashboardHero">
-    <div class="dashboardHero__left">
-      <div class="dashboardHero__eyebrow">Library</div>
-      <h2 class="dashboardHero__title">내 티어표</h2>
-      <p class="dashboardHero__desc">직접 저장한 티어표를 같은 카드 레이아웃으로 다시 열고 정리할 수 있어요.</p>
+  <section class="pageHead">
+    <div class="pageHead__main">
+      <div class="pageHead__eyebrow">Library</div>
+      <h2 class="pageHead__title">내 티어표</h2>
+      <div class="pageHead__desc">직접 저장한 티어표를 같은 카드 레이아웃으로 다시 열고 정리할 수 있어요.</div>
     </div>
   </section>
 
@@ -110,35 +110,6 @@ function openList(t) {
 </template>
 
 <style scoped>
-.dashboardHero {
-  display: flex;
-  gap: 18px;
-  align-items: flex-start;
-  justify-content: space-between;
-  flex-wrap: wrap;
-  padding: 6px 2px 18px;
-}
-.dashboardHero__left {
-  display: grid;
-  gap: 8px;
-}
-.dashboardHero__eyebrow {
-  font-size: 12px;
-  color: var(--theme-text-soft);
-  text-transform: uppercase;
-  letter-spacing: 0.08em;
-}
-.dashboardHero__title {
-  margin: 4px 0 6px;
-  font-size: 32px;
-  letter-spacing: -0.04em;
-  color: var(--theme-text-strong);
-}
-.dashboardHero__desc {
-  margin: 0;
-  color: var(--theme-text-muted);
-  max-width: 720px;
-}
 .panel {
   background: transparent;
   border-radius: 0;