릴리스: v1.3.36 관리자 아이템 라이브러리 보강

backend/src/db.js

@@ -649,6 +649,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
@@ -931,6 +936,14 @@ async function listImageAssets() {
   return rows.map(mapImageAssetRow)
 }
 
+async function findImageAssetById(id) {
+  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 = ? 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]))
@@ -1208,32 +1221,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.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 +1292,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.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 +2036,13 @@ module.exports = {
   listGames,
   findGameById,
   listGameItems,
+  findGameItemById,
   getGameDetail,
   createGame,
   updateGameThumbnail,
   findImageAssetByHash,
   findImageAssetBySrc,
+  findImageAssetById,
   createImageAsset,
   createImageOptimizationJob,
   findImageOptimizationJobById,

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,6 +8,8 @@ const { nanoid } = require('nanoid')
 const {
   findUserById,
   findGameById,
+  findGameItemById,
+  findImageAssetById,
   createGame,
   listGames,
   updateGameThumbnail,
@@ -308,6 +310,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 +338,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 +441,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 +479,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

@@ -10,3 +10,9 @@
 - production에서 SESSION_SECRET 누락 시 서버가 부팅되지 않도록 강제한다.
 - helmet 기반 보안 헤더와 업로드 정적 응답 헤더를 정리한다.
 - 책 아이콘 기반 사용법 모달은 제작 흐름뿐 아니라 복사, 템플릿 업데이트 요청, 새 템플릿 요청까지 확장했으므로, 실제 16:9 스크린샷 자산과 단계별 문구를 운영 톤에 맞게 채운다.
+
+- 관리자 아이템 라이브러리에서 동일 이미지(src)를 여러 템플릿이 공유하는 경우, 필요하면 묶어서 보거나 대표 카드로 합쳐 보는 후속 정리 옵션을 검토한다.
+
+- 라이트모드 최종 QA 시 홈/설정/관리자/에디터를 실제 사용 흐름으로 돌리며, 남아 있는 하드코딩 텍스트 색과 플레이스홀더 배경을 한 번 더 점검한다.
+
+- 관리자 아이템 라이브러리는 보관 자산까지 노출되므로, 이후에는 `활성 템플릿 / 보관 자산` 분리 필터나 그룹 보기까지 검토한다.

docs/update.md

@@ -1,5 +1,22 @@
 # 업데이트 로그
 
+## 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

@@ -684,6 +684,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 +1066,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 {

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)
@@ -137,7 +139,7 @@ const activeTabDescription = computed(() => {
     return '게임 생성, 선택, 썸네일, 기본 아이템 관리를 전용 작업 화면으로 분리했습니다.'
   }
   if (activeTab.value === 'items') {
-    return '사용자 커스텀 이미지를 검색하고, 미사용 이미지를 정리하거나 템플릿으로 승격할 수 있어요.'
+    return '사용자 업로드와 관리자 템플릿 이미지를 함께 검수하고, 필요한 게임에 직접 연결할 수 있어요.'
   }
   if (activeTab.value === 'tierlists') {
     return tierlistsMode.value === 'requests'
@@ -170,7 +172,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 +195,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 +298,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 +400,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 +568,7 @@ async function refreshCustomItems() {
     customItemPage.value = data.page || 1
     customItemLimit.value = data.limit || customItemLimit.value
   } catch (e) {
-    error.value = '사용자 커스텀 아이템을 불러오지 못했어요.'
+    error.value = '아이템 라이브러리를 불러오지 못했어요.'
   }
 }
 
@@ -1032,22 +1068,44 @@ function moveCustomItemPage(direction) {
   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
   customItemModalTargetGameId.value = ''
+  customItemModalGameQuery.value = ''
+  customItemModalGameSort.value = 'recent'
   customItemModalOpen.value = true
+  pushCustomItemModalHistoryState()
 }
 
-function closeCustomItemModal() {
+function closeCustomItemModal({ fromPopState = false } = {}) {
   customItemModalOpen.value = false
+  customItemDeleteModalOpen.value = false
   modalTargetCustomItem.value = null
   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 +1116,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 +1138,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,7 +1152,7 @@ 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 = '미사용 커스텀 이미지 일괄 삭제에 실패했어요.'
   }
@@ -1094,7 +1161,7 @@ async function removeUnusedCustomItems() {
 async function promoteCustomItem(item) {
   resetMessages()
   if (!customItemModalTargetGameId.value) {
-    error.value = '가져올 게임을 먼저 선택해주세요.'
+    error.value = '추가할 게임을 먼저 선택해주세요.'
     return
   }
 
@@ -1104,9 +1171,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
   }
@@ -1535,9 +1602,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>
@@ -1912,41 +1980,67 @@ 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>
+                  <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">
+                    <div class="customItemModal__titleRow">
+                      <div>
+                        <div class="customItemModal__title">{{ modalTargetCustomItem.label }}</div>
+                        <div class="customItemModal__source">{{ modalTargetCustomItem.sourceLabel }}</div>
+                      </div>
+                    </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)">
+                      <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 class="btn btn--danger" :disabled="modalTargetCustomItem.usageCount > 0" @click="openCustomItemDeleteModal(modalTargetCustomItem)">삭제</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>
@@ -1955,8 +2049,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 +2204,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 +2941,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 +3130,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 +3143,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 +3182,92 @@ 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;
+  grid-template-columns: minmax(320px, 360px) minmax(0, 1fr);
+  gap: 28px;
   align-items: start;
 }
-.customItemModal__side {
+.customItemModal__pickerPanel {
   display: grid;
   gap: 12px;
   min-width: 0;
+  padding: 16px;
+  border-radius: 20px;
+  border: 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;
 }
-.customItemModal__selector,
+.customItemModal__titleRow,
 .customItemModal__linked {
   display: grid;
   gap: 8px;
 }
+.customItemModal__image {
+  width: 100%;
+  aspect-ratio: 16 / 9;
+  object-fit: cover;
+  border-radius: 20px;
+  background: var(--theme-surface-soft);
+  border: 1px solid rgba(255, 255, 255, 0.1);
+}
 .customItemModal__label {
   font-size: 11px;
   color: var(--theme-text-faint);
@@ -3118,6 +3283,11 @@ 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;
@@ -3140,12 +3310,20 @@ async function saveFeaturedOrder() {
   color: var(--theme-text);
 }
 .customItemModal__actions {
-  display: flex;
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
   gap: 10px;
-  flex-wrap: wrap;
+}
+.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(1280px, calc(100vw - 40px));
 }
 .pager {
   margin-top: 16px;
@@ -3764,6 +3942,9 @@ async function saveFeaturedOrder() {
   .customItemModal {
     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;