릴리스: v0.1.47 템플릿 요청과 관리자 승인 흐름 추가

backend/index.js

@@ -24,7 +24,7 @@ const allowedOrigins = (process.env.CORS_ORIGINS || '')
 
 const FileStore = FileStoreFactory(session)
 
-;['uploads/avatars', 'uploads/games', 'uploads/custom', '.sessions'].forEach((relativePath) => {
+;['uploads/avatars', 'uploads/games', 'uploads/custom', 'uploads/tierlists', '.sessions'].forEach((relativePath) => {
   fs.mkdirSync(path.join(__dirname, relativePath), { recursive: true })
 })
 
@@ -53,6 +53,7 @@ app.use(
       retries: 0,
     }),
     secret: SESSION_SECRET,
+    proxy: TRUST_PROXY > 0,
     resave: false,
     saveUninitialized: false,
     cookie: {

backend/src/db.js

@@ -37,6 +37,8 @@ function mapUserRow(row) {
     isAdmin: !!row.is_admin,
     avatarSrc: row.avatar_src || '',
     createdAt: Number(row.created_at),
+    tierListCount: Number(row.tierlist_count || 0),
+    recentActivityAt: Number(row.recent_activity_at || row.created_at || 0),
   }
 }
 
@@ -71,7 +73,9 @@ function mapTierListRow(row) {
     authorAccountName: getUserAccountName(row),
     authorAvatarSrc: row.avatar_src || '',
     gameId: row.game_id,
+    gameName: row.game_name || '',
     title: row.title,
+    thumbnailSrc: row.thumbnail_src || '',
     description: row.description || '',
     isPublic: !!row.is_public,
     groups: parseJson(row.groups_json, []),
@@ -81,6 +85,30 @@ function mapTierListRow(row) {
   }
 }
 
+function mapTemplateRequestRow(row) {
+  if (!row) return null
+  return {
+    id: row.id,
+    type: row.request_type,
+    requesterId: row.requester_id,
+    requesterName: getUserDisplayName(row),
+    requesterAccountName: getUserAccountName(row),
+    requesterAvatarSrc: row.requester_avatar_src || '',
+    sourceTierListId: row.source_tierlist_id,
+    sourceGameId: row.source_game_id,
+    sourceGameName: row.source_game_name || '',
+    sourceTierListTitle: row.title_snapshot || '',
+    sourceDescription: row.description_snapshot || '',
+    thumbnailSrc: row.thumbnail_src_snapshot || '',
+    targetGameId: row.target_game_id || '',
+    targetGameName: row.target_game_name || '',
+    status: row.status,
+    items: parseJson(row.items_json, []),
+    createdAt: Number(row.created_at),
+    updatedAt: Number(row.updated_at),
+  }
+}
+
 function getUserDisplayName(row) {
   if (!row) return ''
   const nickname = (row.nickname || '').trim()
@@ -195,6 +223,7 @@ async function ensureSchema() {
         author_id VARCHAR(64) NOT NULL,
         game_id VARCHAR(120) NOT NULL,
         title VARCHAR(120) NOT NULL,
+        thumbnail_src VARCHAR(255) NOT NULL DEFAULT '',
         description TEXT NOT NULL,
         is_public TINYINT(1) NOT NULL DEFAULT 0,
         groups_json LONGTEXT NOT NULL,
@@ -209,6 +238,46 @@ async function ensureSchema() {
       ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4
     `)
 
+    await query(`
+      CREATE TABLE IF NOT EXISTS favorite_tierlists (
+        user_id VARCHAR(64) NOT NULL,
+        tierlist_id VARCHAR(64) NOT NULL,
+        created_at BIGINT NOT NULL,
+        PRIMARY KEY (user_id, tierlist_id),
+        INDEX idx_favorite_tierlists_tierlist_id (tierlist_id),
+        CONSTRAINT fk_favorite_tierlists_user FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE,
+        CONSTRAINT fk_favorite_tierlists_tierlist FOREIGN KEY (tierlist_id) REFERENCES tierlists(id) ON DELETE CASCADE
+      ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4
+    `)
+
+    await query(`
+      CREATE TABLE IF NOT EXISTS template_requests (
+        id VARCHAR(64) PRIMARY KEY,
+        request_type VARCHAR(20) NOT NULL,
+        requester_id VARCHAR(64) NOT NULL,
+        source_tierlist_id VARCHAR(64) NOT NULL,
+        source_game_id VARCHAR(120) NOT NULL,
+        target_game_id VARCHAR(120) NOT NULL DEFAULT '',
+        status VARCHAR(20) NOT NULL DEFAULT 'pending',
+        title_snapshot VARCHAR(120) NOT NULL,
+        description_snapshot TEXT NOT NULL,
+        thumbnail_src_snapshot VARCHAR(255) NOT NULL DEFAULT '',
+        items_json LONGTEXT NOT NULL,
+        created_at BIGINT NOT NULL,
+        updated_at BIGINT NOT NULL,
+        INDEX idx_template_requests_status_created (status, created_at),
+        INDEX idx_template_requests_source_tierlist (source_tierlist_id),
+        INDEX idx_template_requests_requester (requester_id),
+        CONSTRAINT fk_template_requests_requester FOREIGN KEY (requester_id) REFERENCES users(id) ON DELETE CASCADE,
+        CONSTRAINT fk_template_requests_source_tierlist FOREIGN KEY (source_tierlist_id) REFERENCES tierlists(id) ON DELETE CASCADE
+      ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4
+    `)
+
+    const tierListThumbnailColumns = await query("SHOW COLUMNS FROM tierlists LIKE 'thumbnail_src'")
+    if (!tierListThumbnailColumns.length) {
+      await query("ALTER TABLE tierlists ADD COLUMN thumbnail_src VARCHAR(255) NOT NULL DEFAULT '' AFTER title")
+    }
+
     await query(
       `
         INSERT INTO games (id, name, thumbnail_src, created_at)
@@ -306,9 +375,24 @@ async function updateUserProfile({ id, nickname, avatarSrc }) {
 }
 
 async function listUsers() {
-  const rows = await query(
-    'SELECT id, email, nickname, is_admin, avatar_src, created_at FROM users ORDER BY created_at ASC, email ASC'
-  )
+  const rows = await query(`
+    SELECT
+      u.id,
+      u.email,
+      u.nickname,
+      u.is_admin,
+      u.avatar_src,
+      u.created_at,
+      COUNT(t.id) AS tierlist_count,
+      GREATEST(
+        u.created_at,
+        COALESCE(MAX(t.updated_at), 0)
+      ) AS recent_activity_at
+    FROM users u
+    LEFT JOIN tierlists t ON t.author_id = u.id
+    GROUP BY u.id, u.email, u.nickname, u.is_admin, u.avatar_src, u.created_at
+    ORDER BY recent_activity_at DESC, u.created_at ASC, u.email ASC
+  `)
   return rows.map(mapUserRow)
 }
 
@@ -397,6 +481,12 @@ async function createGameItem({ id, gameId, src, label }) {
   return mapGameItemRow(rows[0])
 }
 
+async function updateGameItemLabel(itemId, label) {
+  await query('UPDATE game_items SET label = ? WHERE id = ?', [label, 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 deleteGameItem(itemId) {
   const gameItemRows = await query('SELECT game_id FROM game_items WHERE id = ? LIMIT 1', [itemId])
   const gameId = gameItemRows[0]?.game_id
@@ -459,6 +549,46 @@ async function createCustomItem({ id, ownerId, src, label }) {
   return { id, ownerId, src, label, origin: 'custom', createdAt }
 }
 
+async function syncOwnedCustomItemLabels({ ownerId, items }) {
+  const customItems = Array.from(
+    new Map(
+      (items || [])
+        .filter((item) => item?.origin === 'custom' && item?.id && typeof item.label === 'string')
+        .map((item) => [item.id, item])
+    ).values()
+  )
+
+  if (!customItems.length) return
+
+  await Promise.all(
+    customItems.map((item) =>
+      query('UPDATE custom_items SET label = ? WHERE id = ? AND owner_id = ?', [item.label.trim().slice(0, 60), item.id, ownerId])
+    )
+  )
+}
+
+async function findCustomItemById(id) {
+  const rows = await query(
+    `
+      SELECT id, owner_id, src, label, created_at
+      FROM custom_items
+      WHERE id = ?
+      LIMIT 1
+    `,
+    [id]
+  )
+
+  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),
+  }
+}
+
 async function getCustomItemUsageMap() {
   const rows = await query('SELECT groups_json, pool_json FROM tierlists')
   const usageMap = new Map()
@@ -574,13 +704,62 @@ async function findUnusedCustomItems({ queryText = '' } = {}) {
     .filter((item) => item.usageCount === 0)
 }
 
-async function listPublicTierLists(gameId) {
+async function getFavoriteStatsForTierListIds(tierListIds, userId = '') {
+  const ids = Array.from(new Set((tierListIds || []).filter(Boolean)))
+  const countMap = new Map()
+  const favoritedSet = new Set()
+  if (!ids.length) return { countMap, favoritedSet }
+
+  const placeholders = ids.map(() => '?').join(', ')
+  const countRows = await query(
+    `
+      SELECT tierlist_id, COUNT(*) AS favorite_count
+      FROM favorite_tierlists
+      WHERE tierlist_id IN (${placeholders})
+      GROUP BY tierlist_id
+    `,
+    ids
+  )
+
+  countRows.forEach((row) => {
+    countMap.set(row.tierlist_id, Number(row.favorite_count || 0))
+  })
+
+  if (userId) {
+    const favoriteRows = await query(
+      `
+        SELECT tierlist_id
+        FROM favorite_tierlists
+        WHERE user_id = ? AND tierlist_id IN (${placeholders})
+      `,
+      [userId, ...ids]
+    )
+    favoriteRows.forEach((row) => favoritedSet.add(row.tierlist_id))
+  }
+
+  return { countMap, favoritedSet }
+}
+
+function applyFavoriteMetaToTierLists(tierLists, favoriteStats) {
+  return tierLists.map((tierList) => ({
+    ...tierList,
+    favoriteCount: favoriteStats.countMap.get(tierList.id) || 0,
+    isFavorited: favoriteStats.favoritedSet.has(tierList.id),
+  }))
+}
+
+async function listPublicTierLists(gameId, currentUserId = '', queryText = '') {
   const params = []
   let whereClause = 'WHERE t.is_public = 1'
   if (gameId) {
     whereClause += ' AND t.game_id = ?'
     params.push(gameId)
   }
+  if ((queryText || '').trim()) {
+    const search = `%${queryText.trim()}%`
+    whereClause += ' AND (t.title LIKE ? OR u.nickname LIKE ? OR u.email LIKE ?)'
+    params.push(search, search, search)
+  }
 
   const rows = await query(
     `
@@ -588,6 +767,7 @@ async function listPublicTierLists(gameId) {
         t.id,
         t.game_id,
         t.title,
+        t.thumbnail_src,
         t.created_at,
         t.updated_at,
         t.author_id,
@@ -603,10 +783,11 @@ async function listPublicTierLists(gameId) {
     params
   )
 
-  return rows.map((row) => ({
+  const tierLists = rows.map((row) => ({
     id: row.id,
     gameId: row.game_id,
     title: row.title,
+    thumbnailSrc: row.thumbnail_src || '',
     createdAt: Number(row.created_at),
     updatedAt: Number(row.updated_at),
     authorId: row.author_id,
@@ -614,6 +795,73 @@ async function listPublicTierLists(gameId) {
     authorAccountName: getUserAccountName(row),
     authorAvatarSrc: row.avatar_src || '',
   }))
+
+  const favoriteStats = await getFavoriteStatsForTierListIds(
+    tierLists.map((tierList) => tierList.id),
+    currentUserId
+  )
+  return applyFavoriteMetaToTierLists(tierLists, favoriteStats)
+}
+
+async function listFavoriteTierLists(userId, { queryText = '', sort = 'favorited' } = {}) {
+  const allowedSort = new Set(['favorited', 'updated', 'favorites'])
+  const normalizedSort = allowedSort.has(sort) ? sort : 'favorited'
+  const params = [userId]
+  let whereClause = 'WHERE f.user_id = ?'
+
+  if ((queryText || '').trim()) {
+    const search = `%${queryText.trim()}%`
+    whereClause += ' AND (t.title LIKE ? OR g.name LIKE ? OR u.nickname LIKE ? OR u.email LIKE ?)'
+    params.push(search, search, search, search)
+  }
+
+  const orderClause =
+    normalizedSort === 'updated'
+      ? 'ORDER BY t.updated_at DESC, f.created_at DESC'
+      : normalizedSort === 'favorites'
+        ? 'ORDER BY favorite_count DESC, t.updated_at DESC'
+        : 'ORDER BY f.created_at DESC, t.updated_at DESC'
+
+  const rows = await query(
+    `
+      SELECT
+        t.id,
+        t.author_id,
+        t.game_id,
+        g.name AS game_name,
+        t.title,
+        t.thumbnail_src,
+        t.description,
+        t.is_public,
+        t.groups_json,
+        t.pool_json,
+        t.created_at,
+        t.updated_at,
+        f.created_at AS favorited_at,
+        u.nickname,
+        u.email,
+        u.avatar_src,
+        (
+          SELECT COUNT(*)
+          FROM favorite_tierlists ff
+          WHERE ff.tierlist_id = t.id
+        ) AS favorite_count
+      FROM favorite_tierlists f
+      INNER JOIN tierlists t ON t.id = f.tierlist_id
+      INNER JOIN users u ON u.id = t.author_id
+      INNER JOIN games g ON g.id = t.game_id
+      ${whereClause}
+      ${orderClause}
+    `,
+    params
+  )
+
+  return rows.map((row) => ({
+    ...mapTierListRow(row),
+    favoritedAt: Number(row.favorited_at || 0),
+    favoriteCount: Number(row.favorite_count || 0),
+    isFavorited: true,
+  }))
 }
 
 async function listUserTierLists(userId) {
@@ -623,6 +871,7 @@ async function listUserTierLists(userId) {
         t.id,
         t.game_id,
         t.title,
+        t.thumbnail_src,
         t.created_at,
         t.updated_at,
         t.is_public,
@@ -637,10 +886,11 @@ async function listUserTierLists(userId) {
     [userId]
   )
 
-  return rows.map((row) => ({
+  const tierLists = rows.map((row) => ({
     id: row.id,
     gameId: row.game_id,
     title: row.title,
+    thumbnailSrc: row.thumbnail_src || '',
     createdAt: Number(row.created_at),
     updatedAt: Number(row.updated_at),
     isPublic: !!row.is_public,
@@ -648,16 +898,54 @@ async function listUserTierLists(userId) {
     authorAccountName: getUserAccountName(row),
     authorAvatarSrc: row.avatar_src || '',
   }))
+
+  const favoriteStats = await getFavoriteStatsForTierListIds(
+    tierLists.map((tierList) => tierList.id),
+    userId
+  )
+  return applyFavoriteMetaToTierLists(tierLists, favoriteStats)
 }
 
-async function findTierListById(id) {
+function uniqueTierListItems(poolItems) {
+  const map = new Map()
+  ;(poolItems || []).forEach((item) => {
+    if (!item?.id || map.has(item.id)) return
+    map.set(item.id, {
+      id: item.id,
+      src: item.src || '',
+      label: item.label || 'item',
+      origin: item.origin || 'game',
+    })
+  })
+  return Array.from(map.values())
+}
+
+async function listAdminTierLists({ queryText = '', page = 1, limit = 50, currentUserId = '' } = {}) {
+  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
+        t.title LIKE ?
+        OR g.name LIKE ?
+        OR g.id LIKE ?
+        OR u.email LIKE ?
+        OR u.nickname LIKE ?
+    `
+    : ''
+  const params = hasQuery ? [search, search, search, search, search] : []
+
   const rows = await query(
     `
       SELECT
         t.id,
         t.author_id,
         t.game_id,
+        g.name AS game_name,
         t.title,
+        t.thumbnail_src,
         t.description,
         t.is_public,
         t.groups_json,
@@ -669,12 +957,216 @@ async function findTierListById(id) {
         u.avatar_src
       FROM tierlists t
       INNER JOIN users u ON u.id = t.author_id
+      INNER JOIN games g ON g.id = t.game_id
+      ${whereClause}
+      ORDER BY t.updated_at DESC, t.created_at DESC
+    `,
+    params
+  )
+
+  const allItems = rows.map((row) => {
+    const tierList = mapTierListRow(row)
+    const poolItems = uniqueTierListItems(tierList.pool)
+    const extraItems = poolItems.filter((item) => item.origin === 'custom')
+    return {
+      ...tierList,
+      itemCount: poolItems.length,
+      extraItemCount: extraItems.length,
+      extraItems,
+    }
+  })
+
+  const total = allItems.length
+  const offset = (normalizedPage - 1) * normalizedLimit
+  const pagedTierLists = allItems.slice(offset, offset + normalizedLimit)
+  const favoriteStats = await getFavoriteStatsForTierListIds(
+    pagedTierLists.map((tierList) => tierList.id),
+    currentUserId
+  )
+  return {
+    tierLists: applyFavoriteMetaToTierLists(pagedTierLists, favoriteStats),
+    total,
+    page: normalizedPage,
+    limit: normalizedLimit,
+  }
+}
+
+async function findTierListById(id, currentUserId = '') {
+  const rows = await query(
+    `
+      SELECT
+        t.id,
+        t.author_id,
+        t.game_id,
+        g.name AS game_name,
+        t.title,
+        t.thumbnail_src,
+        t.description,
+        t.is_public,
+        t.groups_json,
+        t.pool_json,
+        t.created_at,
+        t.updated_at,
+        u.nickname,
+        u.email,
+        u.avatar_src
+      FROM tierlists t
+      INNER JOIN users u ON u.id = t.author_id
+      INNER JOIN games g ON g.id = t.game_id
       WHERE t.id = ?
       LIMIT 1
     `,
     [id]
   )
-  return mapTierListRow(rows[0])
+  const tierList = mapTierListRow(rows[0])
+  if (!tierList) return null
+  const favoriteStats = await getFavoriteStatsForTierListIds([tierList.id], currentUserId)
+  return applyFavoriteMetaToTierLists([tierList], favoriteStats)[0]
+}
+
+async function findPendingTemplateRequestByTierList({ sourceTierListId, type }) {
+  const rows = await query(
+    `
+      SELECT id, request_type, status
+      FROM template_requests
+      WHERE source_tierlist_id = ? AND request_type = ? AND status = 'pending'
+      LIMIT 1
+    `,
+    [sourceTierListId, type]
+  )
+  return rows[0] || null
+}
+
+async function createTemplateRequest({
+  id,
+  type,
+  requesterId,
+  sourceTierListId,
+  sourceGameId,
+  targetGameId = '',
+  title,
+  description = '',
+  thumbnailSrc = '',
+  items = [],
+}) {
+  const existing = await findPendingTemplateRequestByTierList({ sourceTierListId, type })
+  if (existing) {
+    const err = new Error('template_request_exists')
+    err.code = 'TEMPLATE_REQUEST_EXISTS'
+    throw err
+  }
+
+  const createdAt = now()
+  await query(
+    `
+      INSERT INTO template_requests (
+        id,
+        request_type,
+        requester_id,
+        source_tierlist_id,
+        source_game_id,
+        target_game_id,
+        status,
+        title_snapshot,
+        description_snapshot,
+        thumbnail_src_snapshot,
+        items_json,
+        created_at,
+        updated_at
+      )
+      VALUES (?, ?, ?, ?, ?, ?, 'pending', ?, ?, ?, ?, ?, ?)
+    `,
+    [
+      id,
+      type,
+      requesterId,
+      sourceTierListId,
+      sourceGameId,
+      targetGameId,
+      title,
+      description,
+      thumbnailSrc,
+      serializeJson(items),
+      createdAt,
+      createdAt,
+    ]
+  )
+  return findTemplateRequestById(id)
+}
+
+async function findTemplateRequestById(id) {
+  const rows = await query(
+    `
+      SELECT
+        tr.id,
+        tr.request_type,
+        tr.requester_id,
+        tr.source_tierlist_id,
+        tr.source_game_id,
+        tr.target_game_id,
+        tr.status,
+        tr.title_snapshot,
+        tr.description_snapshot,
+        tr.thumbnail_src_snapshot,
+        tr.items_json,
+        tr.created_at,
+        tr.updated_at,
+        u.nickname,
+        u.email,
+        u.avatar_src AS requester_avatar_src,
+        sg.name AS source_game_name,
+        tg.name AS target_game_name
+      FROM template_requests tr
+      INNER JOIN users u ON u.id = tr.requester_id
+      LEFT JOIN games sg ON sg.id = tr.source_game_id
+      LEFT JOIN games tg ON tg.id = tr.target_game_id
+      WHERE tr.id = ?
+      LIMIT 1
+    `,
+    [id]
+  )
+
+  return mapTemplateRequestRow(rows[0])
+}
+
+async function listAdminTemplateRequests({ status = 'pending' } = {}) {
+  const rows = await query(
+    `
+      SELECT
+        tr.id,
+        tr.request_type,
+        tr.requester_id,
+        tr.source_tierlist_id,
+        tr.source_game_id,
+        tr.target_game_id,
+        tr.status,
+        tr.title_snapshot,
+        tr.description_snapshot,
+        tr.thumbnail_src_snapshot,
+        tr.items_json,
+        tr.created_at,
+        tr.updated_at,
+        u.nickname,
+        u.email,
+        u.avatar_src AS requester_avatar_src,
+        sg.name AS source_game_name,
+        tg.name AS target_game_name
+      FROM template_requests tr
+      INNER JOIN users u ON u.id = tr.requester_id
+      LEFT JOIN games sg ON sg.id = tr.source_game_id
+      LEFT JOIN games tg ON tg.id = tr.target_game_id
+      WHERE tr.status = ?
+      ORDER BY tr.created_at DESC
+    `,
+    [status]
+  )
+
+  return rows.map(mapTemplateRequestRow)
+}
+
+async function updateTemplateRequestStatus({ id, status }) {
+  await query('UPDATE template_requests SET status = ?, updated_at = ? WHERE id = ?', [status, now(), id])
+  return findTemplateRequestById(id)
 }
 
 async function deleteTierList(id) {
@@ -708,32 +1200,41 @@ async function deleteCustomItems(ids) {
   await query(`DELETE FROM custom_items WHERE id IN (${placeholders})`, ids)
 }
 
-async function saveTierList({ id, authorId, gameId, title, description, isPublic, groups, pool }) {
-  const existing = id ? await findTierListById(id) : null
+async function saveTierList({ id, authorId, gameId, title, thumbnailSrc = '', description, isPublic, groups, pool }) {
+  const existing = id ? await findTierListById(id, authorId) : null
+  await syncOwnedCustomItemLabels({ ownerId: authorId, items: pool })
 
   if (existing) {
     await query(
       `
         UPDATE tierlists
-        SET title = ?, description = ?, is_public = ?, groups_json = ?, pool_json = ?, updated_at = ?
+        SET title = ?, thumbnail_src = ?, description = ?, is_public = ?, groups_json = ?, pool_json = ?, updated_at = ?
         WHERE id = ?
       `,
-      [title, description || '', isPublic ? 1 : 0, serializeJson(groups), serializeJson(pool), now(), existing.id]
+      [title, thumbnailSrc, description || '', isPublic ? 1 : 0, serializeJson(groups), serializeJson(pool), now(), existing.id]
     )
-    return findTierListById(existing.id)
+    return findTierListById(existing.id, authorId)
   }
 
   const createdAt = now()
   await query(
     `
       INSERT INTO tierlists (
-        id, author_id, game_id, title, description, is_public, groups_json, pool_json, created_at, updated_at
+        id, author_id, game_id, title, thumbnail_src, description, is_public, groups_json, pool_json, created_at, updated_at
       )
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     `,
-    [id, authorId, gameId, title, description || '', isPublic ? 1 : 0, serializeJson(groups), serializeJson(pool), createdAt, createdAt]
+    [id, authorId, gameId, title, thumbnailSrc, description || '', isPublic ? 1 : 0, serializeJson(groups), serializeJson(pool), createdAt, createdAt]
   )
-  return findTierListById(id)
+  return findTierListById(id, authorId)
+}
+
+async function favoriteTierList({ userId, tierListId }) {
+  await query('INSERT IGNORE INTO favorite_tierlists (user_id, tierlist_id, created_at) VALUES (?, ?, ?)', [userId, tierListId, now()])
+}
+
+async function unfavoriteTierList({ userId, tierListId }) {
+  await query('DELETE FROM favorite_tierlists WHERE user_id = ? AND tierlist_id = ?', [userId, tierListId])
 }
 
 module.exports = {
@@ -755,17 +1256,27 @@ module.exports = {
   createGame,
   updateGameThumbnail,
   createGameItem,
+  updateGameItemLabel,
   deleteGameItem,
   deleteGame,
   updateGameDisplayOrder,
   createCustomItem,
+  findCustomItemById,
   listCustomItems,
   findUnusedCustomItems,
   listPublicTierLists,
+  listFavoriteTierLists,
   listUserTierLists,
+  listAdminTierLists,
   findTierListById,
+  favoriteTierList,
+  unfavoriteTierList,
   deleteTierList,
   findCustomItemsByIds,
   deleteCustomItems,
   saveTierList,
+  createTemplateRequest,
+  findTemplateRequestById,
+  listAdminTemplateRequests,
+  updateTemplateRequestStatus,
 }

backend/src/routes/admin.js

@@ -12,14 +12,21 @@ const {
   listGames,
   updateGameThumbnail,
   createGameItem,
+  updateGameItemLabel,
   deleteGameItem,
   deleteGame,
   updateGameDisplayOrder,
   listCustomItems,
+  findCustomItemById,
   findUnusedCustomItems,
   findCustomItemsByIds,
   deleteCustomItems,
   listUsers,
+  listAdminTierLists,
+  findTierListById,
+  listAdminTemplateRequests,
+  findTemplateRequestById,
+  updateTemplateRequestStatus,
   adminUpdateUser,
   adminUpdateUserPassword,
   adminDeleteUser,
@@ -116,6 +123,19 @@ router.delete('/games/:gameId/items/:itemId', requireAdmin, async (req, res) =>
   res.json({ ok: true })
 })
 
+router.patch('/games/:gameId/items/:itemId', requireAdmin, async (req, res) => {
+  const schema = z.object({ label: z.string().trim().min(1).max(60) })
+  const parsed = schema.safeParse(req.body)
+  if (!parsed.success) return res.status(400).json({ error: 'bad_request' })
+
+  const game = await findGameById(req.params.gameId)
+  if (!game) return res.status(404).json({ error: 'not_found' })
+
+  const updated = await updateGameItemLabel(req.params.itemId, parsed.data.label)
+  if (!updated || updated.gameId !== game.id) return res.status(404).json({ error: 'not_found' })
+  res.json({ item: updated })
+})
+
 router.delete('/games/:gameId', requireAdmin, async (req, res) => {
   const game = await findGameById(req.params.gameId)
   if (!game) return res.status(404).json({ error: 'not_found' })
@@ -146,6 +166,29 @@ router.get('/custom-items', requireAdmin, async (req, res) => {
   res.json(result)
 })
 
+router.get('/tierlists', requireAdmin, async (req, res) => {
+  const schema = z.object({
+    q: z.string().trim().max(120).optional().default(''),
+    page: z.coerce.number().int().min(1).optional().default(1),
+    limit: z.coerce.number().int().min(1).max(200).optional().default(50),
+  })
+  const parsed = schema.safeParse(req.query)
+  if (!parsed.success) return res.status(400).json({ error: 'bad_request' })
+
+  const result = await listAdminTierLists({
+    queryText: parsed.data.q,
+    page: parsed.data.page,
+    limit: parsed.data.limit,
+    currentUserId: req.session?.userId || '',
+  })
+  res.json(result)
+})
+
+router.get('/template-requests', requireAdmin, async (req, res) => {
+  const requests = await listAdminTemplateRequests({ status: 'pending' })
+  res.json({ requests })
+})
+
 async function removeCustomItemFiles(items) {
   await Promise.all(
     items.map(async (item) => {
@@ -160,6 +203,123 @@ async function removeCustomItemFiles(items) {
   )
 }
 
+async function promoteCustomItemToGameItem({ customItem, gameId }) {
+  const originalName = path.basename(customItem.src || '')
+  const nextFilename = buildUploadFilename({ originalname: originalName })
+  const sourcePath = path.join(__dirname, '..', '..', customItem.src.replace(/^\//, ''))
+  const targetRelativePath = path.join('uploads', 'games', nextFilename)
+  const targetPath = path.join(__dirname, '..', '..', targetRelativePath)
+
+  await fs.copyFile(sourcePath, targetPath)
+
+  return createGameItem({
+    id: nanoid(),
+    gameId,
+    src: `/${targetRelativePath.replace(/\\/g, '/')}`,
+    label: customItem.label,
+  })
+}
+
+async function copyUploadIntoGameAsset(src) {
+  if (typeof src !== 'string' || !src.startsWith('/uploads/')) return src || ''
+
+  const originalName = path.basename(src)
+  const nextFilename = buildUploadFilename({ originalname: originalName })
+  const sourcePath = path.join(__dirname, '..', '..', src.replace(/^\//, ''))
+  const targetRelativePath = path.join('uploads', 'games', nextFilename)
+  const targetPath = path.join(__dirname, '..', '..', targetRelativePath)
+
+  await fs.copyFile(sourcePath, targetPath)
+  return `/${targetRelativePath.replace(/\\/g, '/')}`
+}
+
+function uniqueTierListPoolItems(tierList) {
+  const seen = new Set()
+  return (tierList?.pool || []).filter((item) => {
+    if (!item?.id || seen.has(item.id)) return false
+    seen.add(item.id)
+    return true
+  })
+}
+
+async function promoteTierListItemsToGame({ tierList, gameId, itemIds = [] }) {
+  const allowedIds = new Set((itemIds || []).filter(Boolean))
+  const sourceItems = uniqueTierListPoolItems(tierList).filter((item) => item.origin === 'custom')
+  const itemsToCopy = allowedIds.size ? sourceItems.filter((item) => allowedIds.has(item.id)) : sourceItems
+  const createdItems = []
+
+  for (const item of itemsToCopy) {
+    const copiedSrc = await copyUploadIntoGameAsset(item.src)
+    createdItems.push(
+      await createGameItem({
+        id: nanoid(),
+        gameId,
+        src: copiedSrc,
+        label: item.label,
+      })
+    )
+  }
+
+  return createdItems
+}
+
+async function promoteSnapshotItemsToGame({ items, gameId }) {
+  const createdItems = []
+
+  for (const item of items || []) {
+    const copiedSrc = await copyUploadIntoGameAsset(item.src)
+    createdItems.push(
+      await createGameItem({
+        id: nanoid(),
+        gameId,
+        src: copiedSrc,
+        label: item.label,
+      })
+    )
+  }
+
+  return createdItems
+}
+
+async function createGameTemplateFromTierList({ tierList, gameId, gameName }) {
+  await createGame({ id: gameId, name: gameName })
+  if (tierList.thumbnailSrc) {
+    const copiedThumb = await copyUploadIntoGameAsset(tierList.thumbnailSrc)
+    await updateGameThumbnail(gameId, copiedThumb)
+  }
+
+  const createdItems = []
+  for (const item of uniqueTierListPoolItems(tierList)) {
+    const copiedSrc = await copyUploadIntoGameAsset(item.src)
+    createdItems.push(
+      await createGameItem({
+        id: nanoid(),
+        gameId,
+        src: copiedSrc,
+        label: item.label,
+      })
+    )
+  }
+
+  return { game: await findGameById(gameId), items: createdItems }
+}
+
+async function createGameTemplateFromRequest({ templateRequest, gameId, gameName }) {
+  await createGame({ id: gameId, name: gameName })
+
+  if (templateRequest.thumbnailSrc) {
+    const copiedThumb = await copyUploadIntoGameAsset(templateRequest.thumbnailSrc)
+    await updateGameThumbnail(gameId, copiedThumb)
+  }
+
+  const items = await promoteSnapshotItemsToGame({
+    items: templateRequest.items || [],
+    gameId,
+  })
+
+  return { game: await findGameById(gameId), items }
+}
+
 router.delete('/custom-items/:itemId', requireAdmin, async (req, res) => {
   const result = await listCustomItems({ page: 1, limit: 200, orphanOnly: false })
   const target = result.items.find((item) => item.id === req.params.itemId)
@@ -172,6 +332,117 @@ router.delete('/custom-items/:itemId', requireAdmin, async (req, res) => {
   res.json({ ok: true })
 })
 
+router.post('/custom-items/:itemId/promote', requireAdmin, async (req, res) => {
+  const schema = z.object({
+    gameId: z.string().min(1),
+  })
+  const parsed = schema.safeParse(req.body)
+  if (!parsed.success) return res.status(400).json({ error: 'bad_request' })
+
+  const game = await findGameById(parsed.data.gameId)
+  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 item = await promoteCustomItemToGameItem({ customItem, gameId: game.id })
+  res.json({ item })
+})
+
+router.post('/tierlists/:tierListId/promote-items', requireAdmin, async (req, res) => {
+  const schema = z.object({
+    gameId: z.string().min(1),
+    itemIds: z.array(z.string().min(1)).optional().default([]),
+  })
+  const parsed = schema.safeParse(req.body)
+  if (!parsed.success) return res.status(400).json({ error: 'bad_request' })
+
+  const game = await findGameById(parsed.data.gameId)
+  if (!game) return res.status(404).json({ error: 'game_not_found' })
+
+  const tierList = await findTierListById(req.params.tierListId)
+  if (!tierList) return res.status(404).json({ error: 'not_found' })
+
+  const items = await promoteTierListItemsToGame({
+    tierList,
+    gameId: game.id,
+    itemIds: parsed.data.itemIds,
+  })
+  res.json({ items })
+})
+
+router.post('/tierlists/:tierListId/create-game-template', requireAdmin, async (req, res) => {
+  const schema = z.object({
+    gameId: z.string().trim().min(1).max(120),
+    name: z.string().trim().min(1).max(120),
+    itemIds: z.array(z.string().min(1)).optional().default([]),
+  })
+  const parsed = schema.safeParse(req.body)
+  if (!parsed.success) return res.status(400).json({ error: 'bad_request' })
+
+  const exists = await findGameById(parsed.data.gameId)
+  if (exists) return res.status(409).json({ error: 'game_id_taken' })
+
+  const tierList = await findTierListById(req.params.tierListId)
+  if (!tierList) return res.status(404).json({ error: 'not_found' })
+
+  const result = await createGameTemplateFromTierList({
+    tierList: {
+      ...tierList,
+      pool: parsed.data.itemIds.length ? (tierList.pool || []).filter((item) => parsed.data.itemIds.includes(item.id)) : tierList.pool,
+    },
+    gameId: parsed.data.gameId,
+    gameName: parsed.data.name,
+  })
+  res.json(result)
+})
+
+router.post('/template-requests/:requestId/approve', requireAdmin, async (req, res) => {
+  const templateRequest = await findTemplateRequestById(req.params.requestId)
+  if (!templateRequest) return res.status(404).json({ error: 'not_found' })
+  if (templateRequest.status !== 'pending') return res.status(409).json({ error: 'request_already_handled' })
+
+  if (templateRequest.type === 'update') {
+    const targetGameId = templateRequest.targetGameId || templateRequest.sourceGameId
+    const game = await findGameById(targetGameId)
+    if (!game) return res.status(404).json({ error: 'game_not_found' })
+
+    const items = await promoteSnapshotItemsToGame({
+      items: templateRequest.items || [],
+      gameId: game.id,
+    })
+    const request = await updateTemplateRequestStatus({ id: templateRequest.id, status: 'approved' })
+    return res.json({ request, items })
+  }
+
+  const schema = z.object({
+    gameId: z.string().trim().min(1).max(120),
+    name: z.string().trim().min(1).max(120),
+  })
+  const parsed = schema.safeParse(req.body)
+  if (!parsed.success) return res.status(400).json({ error: 'bad_request' })
+
+  const exists = await findGameById(parsed.data.gameId)
+  if (exists) return res.status(409).json({ error: 'game_id_taken' })
+
+  const result = await createGameTemplateFromRequest({
+    templateRequest,
+    gameId: parsed.data.gameId,
+    gameName: parsed.data.name,
+  })
+  const request = await updateTemplateRequestStatus({ id: templateRequest.id, status: 'approved' })
+  res.json({ request, ...result })
+})
+
+router.post('/template-requests/:requestId/reject', requireAdmin, async (req, res) => {
+  const templateRequest = await findTemplateRequestById(req.params.requestId)
+  if (!templateRequest) return res.status(404).json({ error: 'not_found' })
+  if (templateRequest.status !== 'pending') return res.status(409).json({ error: 'request_already_handled' })
+
+  const request = await updateTemplateRequestStatus({ id: templateRequest.id, status: 'rejected' })
+  res.json({ request })
+})
+
 router.delete('/custom-items', requireAdmin, async (req, res) => {
   const schema = z.object({
     q: z.string().trim().max(120).optional().default(''),

backend/src/routes/auth.js

@@ -44,7 +44,11 @@ router.post('/signup', async (req, res) => {
 
   req.session.userId = user.id
   req.session.isAdmin = !!user.isAdmin
-  res.json(user)
+  // 세션을 응답 전에 명시적으로 저장해 Set-Cookie가 확실히 내려오도록 보강
+  req.session.save((err) => {
+    if (err) return res.status(500).json({ error: 'session_save_failed' })
+    res.json(user)
+  })
 })
 
 router.post('/login', async (req, res) => {
@@ -60,13 +64,16 @@ router.post('/login', async (req, res) => {
 
   req.session.userId = user.id
   req.session.isAdmin = !!user.isAdmin
-  res.json({
-    id: user.id,
-    email: user.email,
-    nickname: user.nickname || '',
-    isAdmin: !!user.isAdmin,
-    avatarSrc: user.avatarSrc || '',
-    createdAt: user.createdAt,
+  req.session.save((err) => {
+    if (err) return res.status(500).json({ error: 'session_save_failed' })
+    res.json({
+      id: user.id,
+      email: user.email,
+      nickname: user.nickname || '',
+      isAdmin: !!user.isAdmin,
+      avatarSrc: user.avatarSrc || '',
+      createdAt: user.createdAt,
+    })
   })
 })
 

backend/src/routes/tierlists.js

@@ -6,14 +6,20 @@ const { nanoid } = require('nanoid')
 const {
   findTierListById,
   listPublicTierLists,
+  listFavoriteTierLists,
   listUserTierLists,
   deleteTierList,
   saveTierList,
   createCustomItem,
+  createTemplateRequest,
+  findUserById,
+  favoriteTierList,
+  unfavoriteTierList,
 } = require('../db')
 const { requireAuth } = require('../middleware/auth')
 
 const router = express.Router()
+const FREEFORM_GAME_ID = 'freeform'
 
 function normalizePoolItem(item) {
   if (!item || item.origin !== 'game' || typeof item.src !== 'string') return item
@@ -38,6 +44,19 @@ function normalizeTierList(tierList) {
   }
 }
 
+function isTierListBoardEmpty(tierList) {
+  return !(tierList?.groups || []).some((group) => Array.isArray(group?.itemIds) && group.itemIds.length > 0)
+}
+
+function getCustomTemplateItems(tierList) {
+  const seen = new Set()
+  return (tierList?.pool || []).filter((item) => {
+    if (!item?.id || item.origin !== 'custom' || seen.has(item.id)) return false
+    seen.add(item.id)
+    return true
+  })
+}
+
 function buildUploadFilename(file) {
   const ext = path.extname(file.originalname || '').toLowerCase()
   const safeExt = ext && /^[.a-z0-9]+$/.test(ext) ? ext : ''
@@ -52,10 +71,19 @@ const upload = multer({
   limits: { fileSize: 6 * 1024 * 1024 },
 })
 
+const thumbnailUpload = multer({
+  storage: multer.diskStorage({
+    destination: (req, file, cb) => cb(null, path.join(__dirname, '..', '..', 'uploads', 'tierlists')),
+    filename: (req, file, cb) => cb(null, buildUploadFilename(file)),
+  }),
+  limits: { fileSize: 6 * 1024 * 1024 },
+})
+
 const tierListUpsertSchema = z.object({
   id: z.string().optional(),
   gameId: z.string().min(1),
   title: z.string().min(1).max(120),
+  thumbnailSrc: z.string().max(255).optional().default(''),
   description: z.string().max(1000).optional().default(''),
   isPublic: z.boolean().default(false),
   groups: z.array(
@@ -77,7 +105,8 @@ const tierListUpsertSchema = z.object({
 
 router.get('/public', async (req, res) => {
   const gameId = req.query.gameId
-  const lists = await listPublicTierLists(gameId)
+  const queryText = typeof req.query.q === 'string' ? req.query.q : ''
+  const lists = await listPublicTierLists(gameId, req.session?.userId || '', queryText)
   res.json({ tierLists: lists })
 })
 
@@ -86,17 +115,26 @@ router.get('/me', requireAuth, async (req, res) => {
   res.json({ tierLists: lists })
 })
 
+router.get('/favorites/me', requireAuth, async (req, res) => {
+  const queryText = typeof req.query.q === 'string' ? req.query.q : ''
+  const sort = typeof req.query.sort === 'string' ? req.query.sort : 'favorited'
+  const lists = await listFavoriteTierLists(req.session.userId, { queryText, sort })
+  res.json({ tierLists: lists })
+})
+
 router.get('/:id', async (req, res) => {
-  const t = await findTierListById(req.params.id)
+  const t = await findTierListById(req.params.id, req.session?.userId || '')
   if (!t) return res.status(404).json({ error: 'not_found' })
   if (!t.isPublic) {
-    if (!req.session || req.session.userId !== t.authorId) return res.status(403).json({ error: 'forbidden' })
+    if (!req.session?.userId) return res.status(403).json({ error: 'forbidden' })
+    const currentUser = req.session.userId === t.authorId ? { isAdmin: false } : await findUserById(req.session.userId)
+    if (req.session.userId !== t.authorId && !currentUser?.isAdmin) return res.status(403).json({ error: 'forbidden' })
   }
   res.json({ tierList: normalizeTierList(t) })
 })
 
 router.delete('/:id', requireAuth, async (req, res) => {
-  const tierList = await findTierListById(req.params.id)
+  const tierList = await findTierListById(req.params.id, req.session.userId)
   if (!tierList) return res.status(404).json({ error: 'not_found' })
   if (tierList.authorId !== req.session.userId) return res.status(403).json({ error: 'forbidden' })
 
@@ -104,6 +142,25 @@ router.delete('/:id', requireAuth, async (req, res) => {
   res.json({ ok: true })
 })
 
+router.post('/:id/favorite', requireAuth, async (req, res) => {
+  const tierList = await findTierListById(req.params.id, req.session.userId)
+  if (!tierList) return res.status(404).json({ error: 'not_found' })
+  if (!tierList.isPublic && tierList.authorId !== req.session.userId) return res.status(403).json({ error: 'forbidden' })
+
+  await favoriteTierList({ userId: req.session.userId, tierListId: tierList.id })
+  const updated = await findTierListById(tierList.id, req.session.userId)
+  res.json({ tierList: normalizeTierList(updated) })
+})
+
+router.delete('/:id/favorite', requireAuth, async (req, res) => {
+  const tierList = await findTierListById(req.params.id, req.session.userId)
+  if (!tierList) return res.status(404).json({ error: 'not_found' })
+
+  await unfavoriteTierList({ userId: req.session.userId, tierListId: tierList.id })
+  const updated = await findTierListById(tierList.id, req.session.userId)
+  res.json({ tierList: normalizeTierList(updated) })
+})
+
 router.post('/custom-items', requireAuth, upload.single('image'), async (req, res) => {
   if (!req.file) return res.status(400).json({ error: 'file_required' })
 
@@ -121,6 +178,54 @@ router.post('/custom-items', requireAuth, upload.single('image'), async (req, re
   res.json({ item })
 })
 
+router.post('/thumbnail', requireAuth, thumbnailUpload.single('thumbnail'), async (req, res) => {
+  if (!req.file) return res.status(400).json({ error: 'file_required' })
+  res.json({ thumbnailSrc: `/uploads/tierlists/${req.file.filename}` })
+})
+
+router.post('/:id/template-request', requireAuth, async (req, res) => {
+  const schema = z.object({
+    type: z.enum(['create', 'update']),
+  })
+  const parsed = schema.safeParse(req.body)
+  if (!parsed.success) return res.status(400).json({ error: 'bad_request' })
+
+  const tierList = await findTierListById(req.params.id, req.session.userId)
+  if (!tierList) return res.status(404).json({ error: 'not_found' })
+  if (tierList.authorId !== req.session.userId) return res.status(403).json({ error: 'forbidden' })
+
+  const customItems = getCustomTemplateItems(tierList)
+  if (!customItems.length) return res.status(400).json({ error: 'custom_items_required' })
+
+  if (parsed.data.type === 'create') {
+    if (tierList.gameId !== FREEFORM_GAME_ID) return res.status(400).json({ error: 'freeform_required' })
+    if (!isTierListBoardEmpty(tierList)) return res.status(400).json({ error: 'board_must_be_empty' })
+  } else {
+    if (tierList.gameId === FREEFORM_GAME_ID) return res.status(400).json({ error: 'game_template_required' })
+  }
+
+  try {
+    const request = await createTemplateRequest({
+      id: nanoid(),
+      type: parsed.data.type,
+      requesterId: req.session.userId,
+      sourceTierListId: tierList.id,
+      sourceGameId: tierList.gameId,
+      targetGameId: parsed.data.type === 'update' ? tierList.gameId : '',
+      title: tierList.title,
+      description: tierList.description || '',
+      thumbnailSrc: tierList.thumbnailSrc || '',
+      items: customItems,
+    })
+    return res.json({ request })
+  } catch (e) {
+    if (e?.code === 'TEMPLATE_REQUEST_EXISTS') {
+      return res.status(409).json({ error: 'template_request_exists' })
+    }
+    throw e
+  }
+})
+
 router.post('/', requireAuth, async (req, res) => {
   const parsed = tierListUpsertSchema.safeParse(req.body)
   if (!parsed.success) return res.status(400).json({ error: 'bad_request' })
@@ -137,6 +242,7 @@ router.post('/', requireAuth, async (req, res) => {
       authorId: existing.authorId,
       gameId: existing.gameId,
       title: payload.title,
+      thumbnailSrc: payload.thumbnailSrc || '',
       description: payload.description || '',
       isPublic: !!payload.isPublic,
       groups: payload.groups,
@@ -150,6 +256,7 @@ router.post('/', requireAuth, async (req, res) => {
     authorId: req.session.userId,
     gameId: payload.gameId,
     title: payload.title,
+    thumbnailSrc: payload.thumbnailSrc || '',
     description: payload.description || '',
     isPublic: !!payload.isPublic,
     groups: payload.groups,

docker-compose.prod.yml

@@ -14,10 +14,11 @@ services:
     volumes:
       - tmaker_mariadb_data:/var/lib/mysql
     healthcheck:
-      test: ["CMD-SHELL", "mariadb-admin ping -h 127.0.0.1 -u$$MARIADB_USER -p$$MARIADB_PASSWORD --silent"]
+      test: ["CMD-SHELL", "mariadb-admin ping -h 127.0.0.1 -uroot -p$$MARIADB_ROOT_PASSWORD --silent"]
+      start_period: 150s
       interval: 10s
       timeout: 5s
-      retries: 10
+      retries: 20
 
   backend:
     build:
@@ -55,7 +56,7 @@ services:
     depends_on:
       - backend
     ports:
-      - "8080:80"
+      - "18080:80"
 
   phpmyadmin:
     image: phpmyadmin:5.2-apache
@@ -71,7 +72,7 @@ services:
       PMA_USER: ${MARIADB_USER}
       PMA_PASSWORD: ${MARIADB_PASSWORD}
     ports:
-      - "8081:80"
+      - "18081:80"
 
 volumes:
   tmaker_mariadb_data:

docs/history.md

@@ -1,16 +1,47 @@
 # 의사결정 이력
 
-## 2026-03-26 v0.1.35
-- NAS 운영 경로는 수동 파일 복사보다 Git clone 기반이 로컬 개발 흐름과 더 잘 맞고, 실수로 누락되는 파일을 줄일 수 있으므로 기본 배포 방식으로 권장하기로 결정했다.
-- 운영 환경 변수와 Docker 볼륨은 Git 저장소 바깥의 NAS 자산으로 유지하고, 코드는 `git pull`로만 반영하는 역할 분리를 명확히 하기로 했다.
+## 2026-03-27 v0.1.47
+- 새 게임 템플릿 등록과 기존 템플릿 업데이트는 운영자가 직접 일일이 훑기보다, 사용자가 명시적으로 요청을 보내고 관리자가 승인하는 흐름이 더 빠르고 명확하다고 정리했다.
+- 템플릿 요청에 포함되는 커스텀 아이템 이름은 관리자 판단의 핵심 정보이므로, 티어표 편집 화면 안에서도 직접 이름을 정리하고 저장 시 원본 커스텀 아이템 라벨까지 함께 동기화하기로 결정했다.
+- 새 템플릿 등록 요청은 실제 템플릿처럼 비어 있는 상태가 더 활용도가 높으므로, `freeform + 빈 보드 + 커스텀 아이템 존재` 조건에서만 보낼 수 있게 제한하기로 했다.
 
-## 2026-03-26 v0.1.34
-- 일부 NAS 환경에서 `favicon.svg` 정적 응답이 `403`으로 차단될 수 있으므로, 운영 안정성을 위해 별도 파일 요청이 필요 없는 인라인 데이터 URL 파비콘으로 전환하기로 결정했다.
-- 관리자 기본 아이템 등록은 단일 파일 업로드만으로는 운영 부담이 크므로, 다중 선택과 드래그 앤 드롭을 지원하고 라벨은 파일명으로 자동 생성하는 방향을 채택했다.
+## 2026-03-27 v0.1.46
+- 티어표 편집 중 등급 행에 넣은 아이템도 다시 제외할 수 있어야 배치 실험이 쉬우므로, 별도 제거 버튼으로 아이템 풀로 되돌리는 흐름을 제공하기로 결정했다.
+- 관리자 회원 관리는 수정 기능만으로는 부족하므로, 운영 판단에 바로 필요한 아바타, 작성 티어표 수, 최근 활동 시각을 함께 보여주기로 했다.
 
-## 2026-03-26 v0.1.29
-- NAS에서 HTTPS를 종료한 뒤 내부 컨테이너끼리는 HTTP로 통신하는 구조에서는, 프런트 프록시가 백엔드에 원래 프로토콜을 정확히 전달하지 않으면 `secure` 세션 쿠키가 발급되지 않는다고 판단했다.
-- 따라서 운영 프런트 Nginx는 백엔드 프록시 요청에 `X-Forwarded-Proto: https`를 명시하고, Express 세션도 프록시 환경을 명시적으로 신뢰하도록 설정하기로 결정했다.
+## 2026-03-27 v0.1.45
+- 카드형 목록의 별표는 개수 표시로 읽히기 쉬우므로, 목록에서는 상태/개수만 보여주고 실제 즐겨찾기 토글은 상세 화면에서 처리하는 편이 오해가 적다고 정리했다.
+- 토스트는 같은 메시지가 짧게 반복될 때 누적 표시가 더 낫고, 종료도 급격히 끊기지 않도록 페이드아웃을 넣는 편이 사용자 경험상 자연스럽다고 판단했다.
+
+## 2026-03-27 v0.1.44
+- 전역 토스트는 공통 composable을 템플릿에 넘길 때 top-level ref로 풀어줘야 하므로, 렌더링 구조를 단순하게 유지하는 편이 안전하다고 정리했다.
+- 공개 티어표가 많아질수록 게임별 목록 안에서 바로 제목/작성자 검색이 가능해야 하므로, 검색은 별도 페이지보다 각 게임 허브 안에서 먼저 제공하기로 결정했다.
+- 즐겨찾기는 저장만으로 끝나면 활용도가 낮으므로, 별도 `내 즐겨찾기` 화면과 정렬 옵션을 함께 제공해야 실사용성이 높다고 판단했다.
+
+## 2026-03-27 v0.1.43
+- 화면 상단 인라인 경고는 스크롤이 생기면 놓치기 쉬우므로, 저장/삭제/가져오기 같은 사용자 행동 피드백은 전역 우측 상단 토스트로 통일하는 편이 더 적합하다고 정리했다.
+- 관리자 티어표 관리의 목적지 선택은 상단 고정 셀렉트보다 액션 직전 모달이 더 명확하므로, `기존 템플릿에 추가 / 새 템플릿 만들기`를 그 순간에 고르게 하기로 결정했다.
+- 공개 티어표는 수량이 많아질수록 개인 보관 수단이 필요하므로, 사용자별 즐겨찾기를 별도 테이블로 저장하고 목록/상세에서 즉시 토글할 수 있게 하기로 했다.
+
+## 2026-03-26 v0.1.42
+- 관리자 운영 관점에서는 공개 목록만으로는 부족하므로, 전체 티어표를 검색하고 추가 아이템까지 확인하는 별도 `티어표 관리` 탭을 두는 편이 더 적합하다고 정리했다.
+- 게임 기반 티어표의 “사용자 추가 아이템”과 `freeform` 티어표의 “전체 아이템”은 활용 목적이 다르므로, 전자는 기존 게임 템플릿 승격 중심으로, 후자는 새 게임 템플릿 생성 중심으로 다루기로 결정했다.
+- 관리자는 moderation 목적의 완성본 검토가 필요하므로, 작성자가 아니어도 비공개 티어표 상세를 열람할 수 있게 하기로 했다.
+
+## 2026-03-26 v0.1.41
+- 관리자 커스텀 아이템 승격은 버튼만 보이는 상태로 끝나면 안 되므로, 프런트 API와 백엔드 라우트가 실제로 함께 연결되어야 기능이 완결된다고 정리했다.
+
+## 2026-03-26 v0.1.40
+- 관리자 기본 아이템 이름 저장은 눌러도 변화가 없으면 혼란스러우므로, 실제 변경이 있을 때만 버튼이 활성화되는 편이 더 명확하다고 판단했다.
+- 사용자 커스텀 이미지는 관리자 검토 후 특정 게임의 기본 템플릿으로 복제해 가져올 수 있어야 운영 효율이 높아지므로, 게임 선택 기반 승격 흐름을 추가하기로 결정했다.
+
+## 2026-03-26 v0.1.39
+- 티어표 편집 헤더는 게임명 kicker보다 제목과 설명이 더 중요하므로, 좌측 입력 중심 구조로 재배치하고 썸네일은 우측 보조 카드로 분리하는 편이 더 자연스럽다고 판단했다.
+- 썸네일 조작 버튼은 모바일에서도 카드와 함께 유지되는 편이 흐름이 덜 끊기므로, 미리보기 아래 별도 줄로 떨어뜨리기보다 카드 내부의 짧은 액션 행으로 묶기로 결정했다.
+
+## 2026-03-26 v0.1.38
+- 관리자 기본 아이템은 업로드 시점에만 이름을 정할 수 있으면 운영 중 수정이 어려우므로, 목록에서 직접 이름을 바꾸고 저장할 수 있게 하기로 결정했다.
+- 게임별 티어표 목록도 식별성이 중요하므로, 사용자가 편집 시 별도 썸네일을 지정할 수 있게 하고 목록 카드에서는 게임 카드와 비슷한 상단 썸네일 구조를 사용하기로 결정했다.
 
 ## 2026-03-19
 - 초기 저장소는 빠른 구현을 위해 `lowdb(JSON 파일)`를 채택했다.
@@ -117,3 +148,35 @@
 
 ## 2026-03-26 v0.1.28
 - UGREEN NAS에서 MariaDB 초기화가 길게 걸릴 수 있으므로, healthcheck는 앱 계정보다 `root` 기준 ping과 더 긴 유예 시간으로 두는 편이 안전하다고 판단했다.
+
+## 2026-03-26 v0.1.29
+- NAS에서 HTTPS를 종료한 뒤 내부 컨테이너끼리는 HTTP로 통신하는 구조에서는, 프런트 프록시가 백엔드에 원래 프로토콜을 정확히 전달하지 않으면 `secure` 세션 쿠키가 발급되지 않는다고 판단했다.
+- 따라서 운영 프런트 Nginx는 백엔드 프록시 요청에 `X-Forwarded-Proto: https`를 명시하고, Express 세션도 프록시 환경을 명시적으로 신뢰하도록 설정하기로 결정했다.
+
+## 2026-03-26 v0.1.30
+- 운영 프런트는 다른 origin 절대 URL보다 같은 origin 상대 `/api` 요청을 우선해야 세션 쿠키 저장이 안정적이라고 판단했다.
+
+## 2026-03-26 v0.1.31
+- 세션 기반 로그인 응답은 저장소 반영 타이밍 차이를 줄이기 위해 `req.session.save()`를 명시 호출하는 쪽이 운영 안정성에 유리하다고 판단했다.
+
+## 2026-03-26 v0.1.32
+- 인증 문제를 빠르게 확인하기 위해 일시적으로 세션 저장 성공/실패 로그를 남기고 원인을 좁혀가는 접근을 선택했다.
+
+## 2026-03-26 v0.1.33
+- 프록시 환경의 실제 판단 값을 보기 위해 `req.secure`, `req.protocol`, `x-forwarded-proto`를 직접 로그로 비교해 원인을 확인하기로 했다.
+
+## 2026-03-26 v0.1.34
+- 일부 NAS 환경에서 `favicon.svg` 정적 응답이 `403`으로 차단될 수 있으므로, 운영 안정성을 위해 별도 파일 요청이 필요 없는 인라인 데이터 URL 파비콘으로 전환하기로 결정했다.
+- 관리자 기본 아이템 등록은 단일 파일 업로드만으로는 운영 부담이 크므로, 다중 선택과 드래그 앤 드롭을 지원하고 라벨은 파일명으로 자동 생성하는 방향을 채택했다.
+
+## 2026-03-26 v0.1.35
+- NAS 운영 경로는 수동 파일 복사보다 Git clone 기반이 로컬 개발 흐름과 더 잘 맞고, 실수로 누락되는 파일을 줄일 수 있으므로 기본 배포 방식으로 권장하기로 결정했다.
+- 운영 환경 변수와 Docker 볼륨은 Git 저장소 바깥의 NAS 자산으로 유지하고, 코드는 `git pull`로만 반영하는 역할 분리를 명확히 하기로 했다.
+
+## 2026-03-26 v0.1.36
+- 브라우저 탭 제목은 개발용 기본 문자열보다 서비스 이름을 직접 보여주는 편이 맞다고 판단해 `Tier Maker`로 고정했다.
+- 무제목 티어표 기본값은 날짜형 임시 제목보다 사용자가 어떤 게임으로 작성했는지 즉시 알 수 있는 게임명 기준이 더 자연스럽다고 판단했다.
+
+## 2026-03-26 v0.1.37
+- 운영 포트 충돌을 피하기 위해 프로덕션 외부 포트는 `frontend=18080`, `phpMyAdmin=18081`로 고정하고, 리버스 프록시 문서도 그 기준으로 맞추기로 했다.
+- 인증 장애 원인을 찾기 위한 디버그 로그는 문제 해결 후 제거하고, 실제 운영에는 세션 저장 보강과 프록시 헤더 설정만 유지하는 편이 낫다고 판단했다.

docs/map.md

@@ -7,13 +7,13 @@
 
 ## `/games/:gameId`
 - 화면 파일: `frontend/src/views/GameHubView.vue`
-- 역할: 선택한 게임 정보 표시, 공개 티어표 목록 표시, 작성자 닉네임 노출, 새 티어표 작성 진입
-- 연동 API: `GET /api/games/:gameId`, `GET /api/tierlists/public`
+- 역할: 선택한 게임 정보 표시, 공개 티어표 목록 표시, 제목/작성자 검색, 티어표별 상단 썸네일/작성자 표시, 즐겨찾기 토글, 새 티어표 작성 진입
+- 연동 API: `GET /api/games/:gameId`, `GET /api/tierlists/public`, `POST /api/tierlists/:id/favorite`, `DELETE /api/tierlists/:id/favorite`
 
 ## `/editor/:gameId/new`, `/editor/:gameId/:tierListId`
 - 화면 파일: `frontend/src/views/TierEditorView.vue`
-- 역할: 티어 그룹 편집, 티어 행 추가/삭제, 관리자 아이템/커스텀 아이템 다중 드래그 앤 드롭 업로드, 작성 권한 제어, 저장, 공개 여부 설정, PNG 다운로드
-- 연동 API: `GET /api/games/:gameId`, `GET /api/tierlists/:id`, `POST /api/tierlists/custom-items`, `POST /api/tierlists`
+- 역할: 티어 그룹 편집, 티어 행 추가/삭제, 관리자 아이템/커스텀 아이템 다중 드래그 앤 드롭 업로드, 티어표 썸네일 선택, 작성 권한 제어, 저장, 공개 여부 설정, 즐겨찾기 토글, PNG 다운로드
+- 연동 API: `GET /api/games/:gameId`, `GET /api/tierlists/:id`, `POST /api/tierlists/:id/favorite`, `DELETE /api/tierlists/:id/favorite`, `POST /api/tierlists/thumbnail`, `POST /api/tierlists/custom-items`, `POST /api/tierlists`
 
 ## `/login`
 - 화면 파일: `frontend/src/views/LoginView.vue`
@@ -22,13 +22,18 @@
 
 ## `/me`
 - 화면 파일: `frontend/src/views/MyTierListsView.vue`
-- 역할: 내 티어표 목록 조회, 편집 화면으로 이동, 작성자 본인 티어표 삭제
+- 역할: 내 티어표 목록 조회, 상단 썸네일 카드 표시, 편집 화면으로 이동, 작성자 본인 티어표 삭제
 - 연동 API: `GET /api/tierlists/me`, `DELETE /api/tierlists/:id`
 
+## `/favorites`
+- 화면 파일: `frontend/src/views/FavoriteTierListsView.vue`
+- 역할: 즐겨찾기한 티어표 목록 조회, 검색/정렬, 편집 화면 이동, 즐겨찾기 해제
+- 연동 API: `GET /api/tierlists/favorites/me`, `DELETE /api/tierlists/:id/favorite`
+
 ## `/admin`
 - 화면 파일: `frontend/src/views/AdminView.vue`
-- 역할: `게임 관리 / 아이템 관리 / 회원 관리` 탭 분리, 선택된 게임의 썸네일 관리, 기본 아이템 다중 드래그 앤 드롭 업로드, 사용자 커스텀 아이템 검색/페이지네이션/사용 횟수 확인/미사용 이미지 개별·일괄 삭제, 회원 비밀번호 초기화 포함 회원 관리, 파일 입력 초기화, 아이템 삭제, 게임 삭제
-- 연동 API: `POST /api/admin/games`, `POST /api/admin/games/:gameId/thumbnail`, `POST /api/admin/games/:gameId/images`, `GET /api/admin/custom-items`, `DELETE /api/admin/custom-items/:itemId`, `DELETE /api/admin/custom-items`, `GET /api/admin/users`, `PATCH /api/admin/users/:userId`, `PATCH /api/admin/users/:userId/password`, `DELETE /api/admin/users/:userId`, `DELETE /api/admin/games/:gameId/items/:itemId`, `DELETE /api/admin/games/:gameId`
+- 역할: `게임 관리 / 아이템 관리 / 티어표 관리 / 회원 관리` 탭 분리, 선택된 게임의 썸네일 관리, 기본 아이템 다중 드래그 앤 드롭 업로드, 기본 아이템 이름 수정, 사용자 커스텀 아이템 검색/페이지네이션/사용 횟수 확인/미사용 이미지 개별·일괄 삭제, 사용자 커스텀 아이템의 기본 템플릿 승격, 전체 티어표 검색/페이지네이션/공개 여부 확인/완성본 이동, 티어표의 추가 커스텀 아이템을 모달 기반으로 기존 템플릿 또는 새 템플릿에 가져오기, freeform 티어표의 게임 템플릿화, 사용자 템플릿 등록/업데이트 요청 승인·반려, 회원 비밀번호 초기화 포함 회원 관리, 파일 입력 초기화, 아이템 삭제, 게임 삭제
+- 연동 API: `POST /api/admin/games`, `POST /api/admin/games/:gameId/thumbnail`, `POST /api/admin/games/:gameId/images`, `PATCH /api/admin/games/:gameId/items/:itemId`, `GET /api/admin/custom-items`, `POST /api/admin/custom-items/:itemId/promote`, `DELETE /api/admin/custom-items/:itemId`, `DELETE /api/admin/custom-items`, `GET /api/admin/tierlists`, `GET /api/admin/template-requests`, `POST /api/admin/template-requests/:requestId/approve`, `POST /api/admin/template-requests/:requestId/reject`, `POST /api/admin/tierlists/:tierListId/promote-items`, `POST /api/admin/tierlists/:tierListId/create-game-template`, `GET /api/admin/users`, `PATCH /api/admin/users/:userId`, `PATCH /api/admin/users/:userId/password`, `DELETE /api/admin/users/:userId`, `DELETE /api/admin/games/:gameId/items/:itemId`, `DELETE /api/admin/games/:gameId`
 
 ## `/profile`
 - 화면 파일: `frontend/src/views/ProfileView.vue`
@@ -37,7 +42,7 @@
 
 ## 공통 레이아웃
 - 앱 셸 파일: `frontend/src/App.vue`
-- 역할: 상단 내비게이션, 로그인 상태 반영, 아바타 메뉴, 관리자 메뉴 노출 제어
+- 역할: 상단 내비게이션, 로그인 상태 반영, 아바타 메뉴, 관리자 메뉴 노출 제어, 전역 우측 상단 토스트 렌더링
 
 ## 백엔드 진입점
 - 서버 엔트리: `backend/index.js`

docs/spec.md

@@ -51,12 +51,17 @@
   - `authorId`: string
   - `gameId`: string
   - `title`: string
+  - `thumbnailSrc`: string
   - `description`: string
   - `isPublic`: boolean
   - `groups`: `{ id, name, itemIds[] }[]`
   - `pool`: `{ id, src, label, origin }[]`
   - `createdAt`: number
   - `updatedAt`: number
+- `favoriteTierLists`
+  - `userId`: string
+  - `tierListId`: string
+  - `createdAt`: number
 - `gameSuggestions`
   - `id`: string
   - `name`: string
@@ -76,8 +81,13 @@
 - 티어표
   - `GET /api/tierlists/public`
   - `GET /api/tierlists/me`
+  - `GET /api/tierlists/favorites/me`
   - `GET /api/tierlists/:id`
+  - `POST /api/tierlists/:id/template-request`
+  - `POST /api/tierlists/:id/favorite`
+  - `DELETE /api/tierlists/:id/favorite`
   - `DELETE /api/tierlists/:id`
+  - `POST /api/tierlists/thumbnail`
   - `POST /api/tierlists/custom-items`
   - `POST /api/tierlists`
 - 관리자
@@ -85,7 +95,15 @@
   - `POST /api/admin/games/:gameId/thumbnail`
   - `POST /api/admin/games/:gameId/images`
     - 여러 이미지를 한 번에 업로드할 수 있고, 별도 라벨이 없으면 파일명 기준으로 기본 아이템 이름을 만든다.
+  - `PATCH /api/admin/games/:gameId/items/:itemId`
+  - `GET /api/admin/tierlists`
+  - `GET /api/admin/template-requests`
+  - `POST /api/admin/template-requests/:requestId/approve`
+  - `POST /api/admin/template-requests/:requestId/reject`
+  - `POST /api/admin/tierlists/:tierListId/promote-items`
+  - `POST /api/admin/tierlists/:tierListId/create-game-template`
   - `GET /api/admin/custom-items`
+  - `POST /api/admin/custom-items/:itemId/promote`
   - `DELETE /api/admin/custom-items/:itemId`
   - `DELETE /api/admin/custom-items`
   - `GET /api/admin/users`
@@ -98,26 +116,48 @@
 ## 관리자 화면 메모
 - 썸네일은 16:9 비율 미리보기 후 `썸네일 적용` 버튼으로 실제 반영한다.
 - 게임 기본 아이템 추가는 드래그 앤 드롭 또는 다중 파일 선택으로 처리하고, 미리보기 카드에서 여러 장을 함께 확인할 수 있다.
+- 현재 기본 아이템 목록에서는 등록된 아이템 이름을 직접 수정하고 저장할 수 있다.
+- 기본 아이템 이름 저장 버튼은 값이 실제로 바뀐 경우에만 활성화된다.
 - 아이템 미리보기는 반응형 환경에서도 최대 `192px` 크기 안에서 표시한다.
 - 게임 전환 또는 업로드 성공 뒤에는 파일 입력값을 초기화해 같은 파일도 다시 선택할 수 있다.
 - 게임 관리 탭에서는 홈 화면 상단에 먼저 노출할 게임을 최대 50개까지 지정하고, 드래그 또는 위/아래 버튼으로 순서를 저장할 수 있다.
 - 사용자 업로드 커스텀 아이템은 관리자 화면의 아이템 관리 탭에서 검색, 페이지네이션, 다운로드할 수 있다.
+- 사용자 커스텀 아이템은 선택한 게임의 기본 템플릿으로 복제해 가져올 수 있다.
 - 커스텀 아이템은 사용 횟수(`usageCount`)를 표시하며, 미사용 항목만 필터링해 개별/일괄 삭제할 수 있다.
+- 관리자 화면에는 별도 `티어표 관리` 탭이 있으며, 최근 티어표 전체를 제목/게임/작성자 기준으로 검색하고 공개 여부를 함께 확인할 수 있다.
+- `티어표 관리` 탭의 추가 아이템은 작은 그리드 카드로 표시하고, 클릭 시 `기존 템플릿에 추가 / 새 템플릿 만들기` 모달을 통해 목적지를 선택한다.
+- `티어표 관리` 탭에서는 티어표 안의 커스텀 아이템을 개별 또는 일괄로 기존 게임 템플릿에 복제할 수 있다.
+- `freeform` 티어표는 관리자 화면에서 새 게임 ID/이름을 입력해 새로운 게임 템플릿으로 복제 생성할 수 있다.
+- 관리자 티어표 관리 상단에는 사용자가 보낸 템플릿 등록/업데이트 요청 목록이 별도로 표시되며, 여기서 승인/반려를 바로 처리할 수 있다.
 - 관리자 화면에서는 회원 이메일/닉네임/권한 수정, 비밀번호 초기화, 계정 삭제가 가능하다.
+- 회원 관리 카드에는 아바타, 작성 티어표 수, 최근 활동 시각을 함께 표시한다.
 
 ## 티어표 접근 메모
 - `new` 작성 경로는 로그인한 사용자만 진입할 수 있다.
 - 비로그인 사용자는 공개된 티어표를 열람만 할 수 있고, 편집 UI와 저장 동작은 비활성화된다.
+- 비공개 티어표라도 관리자는 편집 화면에서 완성본을 열람할 수 있다.
+- 공개 티어표는 목록과 상세 화면에서 즐겨찾기 토글 및 개수를 함께 표시한다.
+- 카드형 목록에서는 즐겨찾기 수/상태만 표시하고, 실제 토글은 상세 화면에서 처리한다.
+- 공개 티어표 목록은 현재 게임 기준으로 제목/작성자 검색을 지원한다.
+- `내 즐겨찾기` 화면에서는 즐겨찾기한 순, 최신 업데이트순, 인기순 정렬을 제공한다.
 - 커스텀 이미지 추가는 다중 파일 선택과 드래그 앤 드롭을 모두 지원한다.
+- 사용자가 직접 추가한 커스텀 아이템 이름은 편집 화면 우측 목록에서 정리할 수 있고, 저장 시 원본 커스텀 아이템 라벨과 함께 동기화된다.
 - 티어 행은 기본 5단으로 시작하지만, 사용자가 직접 추가하거나 제거할 수 있다.
+- 티어 행에 넣은 아이템은 작은 제거 버튼으로 다시 우측 아이템 풀로 되돌릴 수 있다.
 - 신규 티어표의 공개 여부 기본값은 `ON`이며, 기존 티어표는 편집 화면과 `내 티어표` 목록에서 직접 삭제할 수 있다.
-- 제목이 비어 있는 상태로 저장하면 내부 제목은 `이름 없음 + 날짜` 형식으로 자동 생성한다.
+- 제목이 비어 있는 상태로 저장하면 내부 제목은 현재 게임명을 기본값으로 사용한다.
 - 제목 입력이 비어 있는 동안에는 무분별한 도배 방지를 위한 관리자 임의 삭제 가능성 안내 문구를 표시한다.
+- `freeform` 티어표는 보드가 비어 있고 커스텀 아이템이 준비된 상태에서만 `템플릿 등록 요청`을 보낼 수 있다.
+- 기존 게임 티어표는 커스텀 아이템이 포함되어 있으면 `템플릿 업데이트 요청`을 보낼 수 있다.
+- 티어표는 편집 화면에서 16:9 썸네일 이미지를 별도로 선택해 저장할 수 있고, 목록 카드에서는 그 이미지를 상단 대표 썸네일로 사용한다.
+- 편집 화면 상단 헤더는 좌측 제목/설명, 우측 썸네일 카드 구조를 사용하며 모바일에서는 한 열로 접힌다.
 - 티어표 편집기의 아이콘 기본 크기는 `80px`이며, 사용자가 `48 / 60 / 80 / 100 / 120` 단계로 즉시 조절할 수 있다.
 - 공개 티어표 목록과 `내 티어표` 목록은 제목 옆에 작성자 아바타와 표시명을 함께 보여준다.
 - 작성자 아바타 이미지가 없을 경우 목록 썸네일 fallback은 닉네임이 아니라 계정명 기준 첫 글자를 사용한다.
 - 티어표 목록 메타 정보는 최종 업데이트 시각만 간략하게 표시한다.
 - 저장 성공 시에는 에디터 안에서 반투명 오버레이 기반 확인 모달을 띄우고, PNG export 이미지는 약 `960px` 보드 폭과 `pixelRatio 1.5`, 외곽 여백, 작성자/날짜 하단 메타를 포함해 생성한다.
+- 저장/삭제/가져오기 같은 사용자 행동 피드백은 전역 우측 상단 토스트로 표시한다.
+- 전역 토스트는 동일 메시지/타입이 연속 발생하면 하나로 합쳐 카운트를 올리고, 종료 시 짧은 페이드아웃 애니메이션을 사용한다.
 - 홈 게임 목록은 관리자 상단 고정 순서가 있으면 그 순서를 먼저 적용하고, 그 외 게임은 최근 생성순으로 뒤에 이어진다.
 - `커스텀 티어표 만들기`는 카드가 아니라 홈 우측 상단 버튼으로 진입한다.
 
@@ -144,7 +184,7 @@
 
 ## 운영 배포 메모
 - 프로덕션 컴포즈 파일은 [docker-compose.prod.yml](/Users/bicute/Desktop/zenn.dev/tier-cursor/docker-compose.prod.yml)이다.
-- 외부 도메인 `tmaker.sori.studio`는 `frontend` 컨테이너의 `8080` 포트로 리버스 프록시하고, `/api`, `/uploads`, `/health`는 프런트 Nginx가 내부 `backend:5179`로 전달한다.
+- 외부 도메인 `tmaker.sori.studio`는 `frontend` 컨테이너의 `18080` 포트로 리버스 프록시하고, `/api`, `/uploads`, `/health`는 프런트 Nginx가 내부 `backend:5179`로 전달한다.
 - 운영 볼륨은 MariaDB 데이터, 업로드 파일, 세션 파일을 각각 분리해 유지한다.
 - MariaDB healthcheck는 NAS 첫 기동 지연을 고려해 `root` 기준 ping과 긴 `start_period/retries`를 사용한다.
 

docs/todo.md

@@ -1,11 +1,18 @@
 # 할 일 및 이슈
 
 ## 즉시 확인 필요
-- 사용자 커스텀 아이템을 관리자 기본 템플릿으로 승격하는 승인/복제 흐름은 아직 없다.
-- 회원 관리에서 아바타/작성 티어표 수/최근 활동 같은 보조 정보는 아직 표시하지 않는다.
 - 미사용 커스텀 이미지 일괄 삭제는 현재 "참조가 없는 항목" 기준이며, 보관 기간 정책 같은 운영 규칙은 아직 없다.
 - 업로드 이미지는 현재 원본 파일을 그대로 저장하므로, 운영 부담이 커지면 서버 저장 전 리사이즈/압축(예: 긴 변 제한, WebP 변환) 도입이 필요하다.
 - 관리자 기본 아이템 다중 업로드는 현재 파일명 기반 자동 라벨만 지원하므로, 필요하면 업로드 후 일괄 라벨 수정/정렬 UX를 추가 검토한다.
+- 티어표 썸네일은 현재 업로드/교체만 지원하므로, 필요하면 자동 썸네일 추출이나 업로드 이미지 크롭 UX를 추가 검토한다.
+- 사용자 커스텀 아이템 승격은 현재 수동 복제 방식이므로, 필요하면 중복 감지나 “비슷한 항목 추천” 같은 보조 UX를 검토한다.
+- 템플릿 등록/업데이트 요청은 현재 승인/반려만 지원하므로, 필요하면 관리자 코멘트나 사용자용 요청 상태 이력 화면을 추가 검토한다.
+- 관리자 티어표 관리의 템플릿 생성은 현재 `freeform`만 직접 지원하므로, 필요하면 일반 게임 티어표의 전체 아이템을 복제한 파생 템플릿 생성 UX도 검토한다.
+- 관리자 티어표 관리의 추가 아이템 승격은 현재 커스텀(origin=`custom`) 아이템 기준이므로, 필요하면 “기존 게임 아이템과 비교한 차집합” 기준으로 더 정교하게 확장할 수 있다.
+- 즐겨찾기는 현재 `내 즐겨찾기` 목록과 정렬까지 지원하므로, 필요하면 폴더 분류나 메모 같은 개인 정리 기능을 추가 검토한다.
+- 전역 토스트는 중복 합치기와 페이드아웃까지 지원하므로, 필요하면 액션 링크나 수동 고정(pin) 같은 상호작용 확장을 검토한다.
+- 공개 티어표 검색은 현재 게임별 허브 안에서만 제공하므로, 필요하면 홈 전역 통합 검색도 검토한다.
+- 즐겨찾기 토글은 현재 상세 화면 중심이므로, 필요하면 카드 목록에서도 안전한 보조 인터랙션(예: 길게 누르기, 별도 메뉴)을 검토한다.
 
 ## 배포 전 작업
 - NAS 실제 도메인 기준으로 `VITE_API_ORIGIN`, `CORS_ORIGINS`, `SESSION_SECRET`, `SESSION_COOKIE_SECURE`, `TRUST_PROXY` 값을 설정한다.
@@ -17,6 +24,6 @@
 ## 중기 개선
 - 게임/이미지/티어표 삭제 후 복구 또는 수정 이력 관리 기능을 추가한다.
 - 자동 테스트와 최소한의 배포 체크리스트를 만든다.
-- 관리자용 커스텀 아이템 승인/복제, 아이템 정렬 UI를 추가한다.
+- 관리자용 티어표 승인/숨김 처리, 아이템 정렬 UI를 추가한다.
 - 회원 검색/필터, 일괄 권한 변경 같은 관리 보조 기능을 추가한다.
 - 티어 행 프리셋 저장, 색상 관리, 행 복제 같은 고급 편집 기능을 추가한다.

docs/ugreen-nas-deploy.md

@@ -99,7 +99,7 @@ docker compose --env-file .env.production -f docker-compose.prod.yml up -d --bui
 ```bash
 cd /volume1/docker/projects/apps/tier-maker
 git pull origin main
-docker compose --env-file .env.production -f docker-compose.prod.yml up -d --build
+sudo docker compose --env-file .env.production -f docker-compose.prod.yml up -d --build
 ```
 
 - 아직 수동 복사 폴더만 있다면:
@@ -118,14 +118,14 @@ docker compose --env-file .env.production -f docker-compose.prod.yml up -d --bui
 - 외부 도메인: `tmaker.sori.studio`
 - 내부 대상 프로토콜: `http`
 - 내부 대상 호스트: NAS IP 또는 `localhost`
-- 내부 대상 포트: `8080`
+- 내부 대상 포트: `18080`
 
-즉 NAS 리버스 프록시는 `frontend` 컨테이너의 `8080`만 바라보면 된다.
+즉 NAS 리버스 프록시는 `frontend` 컨테이너의 `18080`만 바라보면 된다.
 
 ## 5. HTTPS / 쿠키
 - 현재 프로덕션 컴포즈는 `SESSION_COOKIE_SECURE=true`를 사용한다.
 - 따라서 `tmaker.sori.studio`에는 HTTPS 인증서가 연결되어 있어야 한다.
-- NAS 리버스 프록시가 HTTPS 종료를 하고 내부는 `http://frontend:80` 또는 `localhost:8080`으로 전달하면 된다.
+- NAS 리버스 프록시가 HTTPS 종료를 하고 내부는 `http://frontend:80` 또는 `localhost:18080`으로 전달하면 된다.
 - 최신 프런트 Nginx 설정은 백엔드로 `X-Forwarded-Proto: https`를 넘기므로, 로그인 직후 세션이 바로 풀리는 경우에는 프런트 이미지를 다시 빌드해 최신 설정이 반영됐는지 먼저 확인한다.
 
 ## 6. 데이터 위치

docs/update.md

@@ -1,5 +1,58 @@
 # 업데이트 로그
 
+## 2026-03-27 v0.1.47
+- **템플릿 등록/업데이트 요청 추가**: 사용자가 저장된 티어표를 기준으로 관리자에게 `새 템플릿 등록` 또는 `기존 템플릿 업데이트` 요청을 보낼 수 있도록 요청 API와 관리자 승인 흐름을 추가
+- **커스텀 아이템 이름 편집 확장**: 티어표 편집 화면에서 사용자가 직접 추가한 커스텀 아이템 이름을 정리할 수 있는 전용 입력 목록을 추가하고, 저장 시 MariaDB의 커스텀 아이템 라벨도 함께 동기화
+- **관리자 요청 목록 추가**: 관리자 티어표 관리 탭 상단에 처리 대기 중인 템플릿 요청 목록을 추가하고, 새 게임 템플릿 생성 승인과 기존 게임 템플릿 업데이트 승인을 바로 처리할 수 있게 개선
+
+## 2026-03-27 v0.1.46
+- **티어 행 아이템 제거 추가**: 티어표 편집 화면에서 이미 등급 행에 넣은 아이템도 작은 제거 버튼으로 다시 아이템 풀로 빼낼 수 있도록 보강
+- **회원 관리 보조 정보 확장**: 관리자 회원 관리 카드에 아바타, 작성 티어표 수, 최근 활동 시각을 함께 표시해 운영 판단에 필요한 정보를 바로 확인할 수 있도록 개선
+
+## 2026-03-27 v0.1.45
+- **즐겨찾기 카드 액션 보정**: 카드형 목록에서는 별표를 클릭 액션이 아닌 상태/개수 표시로만 보여주고, 실제 즐겨찾기 토글은 상세 화면에서 처리하도록 조정
+- **토스트 중복/페이드아웃 개선**: 같은 메시지 토스트는 하나로 합치고 카운트를 올리도록 변경했으며, 사라질 때는 짧은 페이드아웃 애니메이션을 적용
+
+## 2026-03-27 v0.1.44
+- **토스트 렌더링 버그 수정**: 전역 토스트가 빈 카드 여러 개로 보이던 ref 참조 문제를 수정해 실제 메시지만 표시되도록 정리
+- **공개 티어표 검색 추가**: 게임별 공개 티어표 목록에서 제목/작성자 기준 검색이 가능하도록 검색창과 API 쿼리 지원 추가
+- **내 즐겨찾기 페이지 추가**: 사용자별 즐겨찾기 목록 화면과 `즐겨찾기한 순 / 최신 업데이트순 / 인기순` 정렬 옵션을 추가
+
+## 2026-03-27 v0.1.43
+- **전역 토스트 알림 추가**: 저장/삭제/가져오기 같은 사용자 행동 피드백을 상단 인라인 경고 대신 우측 상단 토스트로 통일해 잠시 표시 후 자동으로 사라지도록 변경
+- **관리자 티어표 아이템 가져오기 모달화**: 티어표 관리의 추가 아이템 영역을 소형 그리드로 다듬고, 가져오기 시점에 `기존 템플릿에 추가 / 새 템플릿 만들기`를 선택하는 모달 흐름으로 재정리
+- **티어표 즐겨찾기 추가**: 공개 티어표 목록과 상세 화면에서 즐겨찾기 토글과 개수를 표시하고, MariaDB에 사용자별 즐겨찾기 이력을 저장하도록 확장
+
+## 2026-03-26 v0.1.42
+- **관리자 티어표 관리 탭 추가**: 공개/비공개를 포함한 최근 티어표 전체를 관리자 화면에서 검색/페이지네이션으로 확인하고, 제목·작성자·게임·공개 여부를 함께 볼 수 있도록 보강
+- **추가 아이템 승격 흐름 확장**: 티어표 안에서 사용자가 추가한 커스텀 아이템을 관리자 화면에서 바로 특정 게임의 기본 템플릿으로 개별 또는 일괄 복제할 수 있도록 추가
+- **커스텀 티어표 템플릿화 추가**: `freeform` 티어표는 관리자 화면에서 새 게임 ID/이름을 입력해 별도 게임 템플릿으로 복제 생성할 수 있도록 지원
+- **관리자 열람 권한 확장**: 비공개 티어표도 관리자는 편집 화면에서 완성본을 열람할 수 있도록 상세 조회 권한을 확장
+
+## 2026-03-26 v0.1.41
+- **커스텀 아이템 승격 연결 수정**: 관리자 아이템 관리의 `기본 템플릿에 추가` 버튼이 실제 API와 백엔드 승격 라우트로 연결되도록 누락된 프런트/백엔드 구현을 보완
+
+## 2026-03-26 v0.1.40
+- **기본 아이템 저장 UX 보강**: 관리자 게임 관리에서 아이템 이름이 실제로 바뀐 경우에만 `이름 저장` 버튼이 활성화되도록 조정하고, 저장 중 상태를 버튼에 표시
+- **커스텀 아이템 승격 추가**: 관리자 아이템 관리에서 사용자 커스텀 이미지를 선택한 게임의 기본 템플릿으로 복제해 가져올 수 있도록 API와 UI를 추가
+
+## 2026-03-26 v0.1.39
+- **에디터 헤더 재구성**: 티어표 편집 상단에서 게임명 kicker를 제거하고, 좌측 제목/설명 입력과 우측 썸네일 카드가 나란히 보이는 구조로 재정리
+- **썸네일 영역 UX 개선**: 썸네일 미리보기와 선택/제거 버튼을 하나의 카드 안에 묶고, 모바일에서도 버튼이 카드 아래로 무너지지 않도록 밀도 있게 조정
+
+## 2026-03-26 v0.1.38
+- **관리자 기본 아이템 이름 수정 추가**: 게임 관리 화면의 현재 기본 아이템 목록에서 이름을 직접 수정하고 저장할 수 있도록 API와 UI를 보강
+- **티어표 썸네일 추가**: 티어표 편집 화면에서 별도 썸네일 이미지를 선택해 저장할 수 있도록 업로드 흐름을 추가하고, 게임별 공개 티어표/내 티어표 목록은 게임 카드처럼 상단 썸네일 + 하단 제목/작성자 정보 카드 구조로 변경
+
+## 2026-03-26 v0.1.37
+- **운영 포트 설정 반영**: 프로덕션 컴포즈의 `frontend/phpMyAdmin` 외부 포트를 `18080/18081` 기준으로 유지하고, NAS 배포 문서와 기술 명세의 리버스 프록시 포트 안내도 동일하게 정리
+- **인증 라우트 정리**: NAS 로그인 문제를 확인하기 위해 넣었던 `auth` 디버그 로그를 제거하고, 실제 운영에 필요한 세션 저장 보강만 유지
+- **이력 문서 정렬**: `docs/history.md`를 날짜/버전 흐름에 맞게 다시 정리해 추적성을 높임
+
+## 2026-03-26 v0.1.36
+- **브라우저 탭 이름 변경**: 프런트 문서 제목을 `frontend`에서 `Tier Maker`로 변경
+- **무제목 티어표 기본값 조정**: 사용자가 제목을 입력하지 않으면 `이름 없음 + 날짜` 대신 현재 게임명을 기본 제목으로 사용하도록 변경하고, 관리자 임의 삭제 안내 문구는 유지
+
 ## 2026-03-26 v0.1.35
 - **NAS Git 배포 절차 추가**: UGREEN NAS에서 수동 복사 대신 `git clone`과 `git pull` 기반으로 운영 배포를 관리하는 절차를 배포 가이드에 정리
 - **v0.1.34 반영 명령 정리**: 이미 수동 복사본이 있는 경우 새 clone으로 전환한 뒤 최신 이미지를 다시 빌드하는 순서를 문서화
@@ -8,21 +61,21 @@
 - **파비콘 정적 요청 제거**: 운영 환경에서 `/favicon.svg`가 `403`으로 막히는 경우를 피하기 위해, 별도 파일 대신 `index.html` 인라인 데이터 URL 파비콘으로 전환
 - **관리자 기본 아이템 다중 업로드 추가**: 게임 관리 화면에서 기본 아이템을 여러 장 드래그 앤 드롭 또는 다중 파일 선택으로 한 번에 추가할 수 있도록 변경하고, 기본 라벨은 파일명 기준으로 자동 생성
 
-## 2026-03-26 v0.1.29
-- **NAS 로그인 유지 수정**: 프런트 Nginx가 백엔드에 전달하는 `X-Forwarded-Proto`를 `https`로 고정하고 Express 세션의 프록시 인지를 명시해, NAS HTTPS 리버스 프록시 뒤에서도 `secure` 세션 쿠키가 정상 발급되도록 조정
-- **운영 템플릿 복구**: 실수로 빠질 수 있는 `.env.production.example`를 다시 포함하고, NAS 재배포 시 최신 프런트 이미지를 다시 빌드하도록 문서 보강
-
-## 2026-03-26 v0.1.30
-- **[NAS] /api 상대경로 호출**: 운영(`import.meta.env.PROD`)에서는 `http://localhost:...` 같은 다른 origin으로 API를 호출하지 않도록, `frontend/src/lib/runtime.js`에서 `/api` 호출을 상대경로로 고정해 세션 쿠키가 정상 저장되도록 수정
-
-## 2026-03-26 v0.1.31
-- **[NAS] 세션 쿠키 발급 강제**: 백엔드 인증 라우트에서 `req.session.save()`를 명시 호출해 응답 전에 세션을 저장하고 `Set-Cookie`가 확실히 내려오도록 보강
+## 2026-03-26 v0.1.33
+- **[NAS] 요청 프로토콜 디버그**: `auth/login`/`auth/me`에서 `req.secure`, `req.protocol`, `x-forwarded-proto` 값을 로그로 출력해 프록시/HTTPS 판단 문제를 확인
 
 ## 2026-03-26 v0.1.32
 - **[NAS] 인증 디버그 로그 추가**: `auth/login`에서 `req.session.save` 성공/실패와 `auth/me`에서 세션 존재 여부를 콘솔 로그로 남겨 세션 쿠키 발급 문제를 빠르게 진단
 
-## 2026-03-26 v0.1.33
-- **[NAS] 요청 프로토콜 디버그**: `auth/login`/`auth/me`에서 `req.secure`, `req.protocol`, `x-forwarded-proto` 값을 로그로 출력해 프록시/HTTPS 판단 문제를 확인
+## 2026-03-26 v0.1.31
+- **[NAS] 세션 쿠키 발급 강제**: 백엔드 인증 라우트에서 `req.session.save()`를 명시 호출해 응답 전에 세션을 저장하고 `Set-Cookie`가 확실히 내려오도록 보강
+
+## 2026-03-26 v0.1.30
+- **[NAS] /api 상대경로 호출**: 운영(`import.meta.env.PROD`)에서는 `http://localhost:...` 같은 다른 origin으로 API를 호출하지 않도록, `frontend/src/lib/runtime.js`에서 `/api` 호출을 상대경로로 고정해 세션 쿠키가 정상 저장되도록 수정
+
+## 2026-03-26 v0.1.29
+- **NAS 로그인 유지 수정**: 프런트 Nginx가 백엔드에 전달하는 `X-Forwarded-Proto`를 `https`로 고정하고 Express 세션의 프록시 인지를 명시해, NAS HTTPS 리버스 프록시 뒤에서도 `secure` 세션 쿠키가 정상 발급되도록 조정
+- **운영 템플릿 복구**: 실수로 빠질 수 있는 `.env.production.example`를 다시 포함하고, NAS 재배포 시 최신 프런트 이미지를 다시 빌드하도록 문서 보강
 
 ## 2026-03-26 v0.1.28
 - **MariaDB healthcheck 완화**: UGREEN NAS 첫 초기화 시간이 길어도 `unhealthy`로 오판하지 않도록 프로덕션 컴포즈의 DB healthcheck를 `root` 기준과 더 긴 `start_period/retries`로 조정

frontend/index.html

@@ -7,7 +7,7 @@
       href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 64 64'%3E%3Crect width='64' height='64' rx='16' fill='%230b1220'/%3E%3Cpath d='M18 18h28v8H36v20h-8V26H18z' fill='%23f8fafc'/%3E%3C/svg%3E"
     />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>frontend</title>
+    <title>Tier Maker</title>
   </head>
   <body>
     <div id="app"></div>

frontend/nginx.conf

@@ -15,7 +15,7 @@ server {
     proxy_set_header Host $host;
     proxy_set_header X-Real-IP $remote_addr;
     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-    proxy_set_header X-Forwarded-Proto $scheme;
+    proxy_set_header X-Forwarded-Proto https;
   }
 
   location /uploads/ {
@@ -24,7 +24,7 @@ server {
     proxy_set_header Host $host;
     proxy_set_header X-Real-IP $remote_addr;
     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-    proxy_set_header X-Forwarded-Proto $scheme;
+    proxy_set_header X-Forwarded-Proto https;
   }
 
   location /health {
@@ -33,6 +33,6 @@ server {
     proxy_set_header Host $host;
     proxy_set_header X-Real-IP $remote_addr;
     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-    proxy_set_header X-Forwarded-Proto $scheme;
+    proxy_set_header X-Forwarded-Proto https;
   }
 }

frontend/src/App.vue

@@ -3,10 +3,12 @@ import { computed, onMounted, onUnmounted, ref, watch } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
 import { useAuthStore } from './stores/auth'
 import { toApiUrl } from './lib/runtime'
+import { useToast } from './composables/useToast'
 
 const route = useRoute()
 const router = useRouter()
 const auth = useAuthStore()
+const { toasts, dismissToast } = useToast()
 const isAdmin = computed(() => !!auth.user?.isAdmin)
 const avatarUrl = computed(() => {
   if (!auth.user?.avatarSrc) return ''
@@ -58,11 +60,12 @@ async function logout() {
     <header class="app-header">
       <div class="brand" @click="$router.push('/')">
         <span class="brand__title">Tier Maker</span>
-        <span class="brand__sub">Vue</span>
+        <span class="brand__sub">by zenn</span>
       </div>
       <nav class="nav">
         <RouterLink to="/" class="nav__link">게임</RouterLink>
         <RouterLink to="/me" class="nav__link">내 티어표</RouterLink>
+        <RouterLink v-if="auth.user" to="/favorites" class="nav__link">즐겨찾기</RouterLink>
         <RouterLink v-if="isAdmin" to="/admin" class="nav__link">관리자</RouterLink>
 
         <RouterLink v-if="!auth.user" to="/login" class="nav__link">로그인</RouterLink>
@@ -81,6 +84,15 @@ async function logout() {
     <main class="app-main">
       <RouterView />
     </main>
+    <div class="toastStack" aria-live="polite" aria-atomic="true">
+      <div v-for="item in toasts" :key="item.id" class="toast" :class="[`toast--${item.type}`, { 'toast--closing': item.isClosing }]">
+        <div class="toast__body">
+          <div class="toast__message">{{ item.message }}</div>
+          <div v-if="item.count > 1" class="toast__count">x{{ item.count }}</div>
+        </div>
+        <button class="toast__close" @click="dismissToast(item.id)">닫기</button>
+      </div>
+    </div>
   </div>
 </template>
 
@@ -198,4 +210,74 @@ async function logout() {
 .menuItem:hover {
   background: rgba(255, 255, 255, 0.09);
 }
+.toastStack {
+  position: fixed;
+  top: 78px;
+  right: 18px;
+  z-index: 30;
+  display: grid;
+  gap: 10px;
+  width: min(360px, calc(100vw - 24px));
+}
+.toast {
+  display: flex;
+  gap: 12px;
+  align-items: flex-start;
+  justify-content: space-between;
+  padding: 12px 14px;
+  border-radius: 16px;
+  border: 1px solid rgba(255, 255, 255, 0.12);
+  background: rgba(11, 18, 32, 0.94);
+  backdrop-filter: blur(12px);
+  box-shadow: 0 14px 30px rgba(0, 0, 0, 0.28);
+  opacity: 1;
+  transform: translateY(0);
+  transition: opacity 220ms ease, transform 220ms ease;
+}
+.toast--closing {
+  opacity: 0;
+  transform: translateY(-6px);
+}
+.toast--success {
+  border-color: rgba(52, 211, 153, 0.38);
+}
+.toast--error {
+  border-color: rgba(239, 68, 68, 0.34);
+}
+.toast--info {
+  border-color: rgba(96, 165, 250, 0.34);
+}
+.toast__message {
+  line-height: 1.5;
+  font-size: 14px;
+}
+.toast__body {
+  min-width: 0;
+}
+.toast__count {
+  margin-top: 6px;
+  width: fit-content;
+  padding: 2px 8px;
+  border-radius: 999px;
+  background: rgba(255, 255, 255, 0.08);
+  font-size: 12px;
+  font-weight: 800;
+  opacity: 0.84;
+}
+.toast__close {
+  flex: 0 0 auto;
+  border: 0;
+  background: transparent;
+  color: rgba(255, 255, 255, 0.76);
+  cursor: pointer;
+  font-weight: 800;
+}
+@media (max-width: 640px) {
+  .toastStack {
+    top: 70px;
+    right: 12px;
+    left: 12px;
+    width: auto;
+  }
+}
 </style>

frontend/src/composables/useToast.js

@@ -0,0 +1,61 @@
+import { readonly, ref } from 'vue'
+
+const toasts = ref([])
+let toastSeq = 0
+const TOAST_EXIT_MS = 220
+
+function clearToastTimer(toast) {
+  if (toast?.timerId) {
+    window.clearTimeout(toast.timerId)
+    toast.timerId = 0
+  }
+}
+
+function removeToast(id) {
+  toasts.value = toasts.value.filter((toast) => toast.id !== id)
+}
+
+function dismissToast(id) {
+  const target = toasts.value.find((toast) => toast.id === id)
+  if (!target || target.isClosing) return
+
+  clearToastTimer(target)
+  target.isClosing = true
+  target.timerId = window.setTimeout(() => removeToast(id), TOAST_EXIT_MS)
+}
+
+function showToast(message, { type = 'info', duration = 2600 } = {}) {
+  if (!message) return ''
+  const duplicated = toasts.value.find((toast) => toast.message === message && toast.type === type && !toast.isClosing)
+
+  if (duplicated) {
+    duplicated.count = (duplicated.count || 1) + 1
+    clearToastTimer(duplicated)
+    if (duration > 0) {
+      duplicated.timerId = window.setTimeout(() => dismissToast(duplicated.id), duration)
+    }
+    toasts.value = [...toasts.value]
+    return duplicated.id
+  }
+
+  const id = `toast-${++toastSeq}`
+  const nextToast = { id, message, type, count: 1, isClosing: false, timerId: 0 }
+  toasts.value = [...toasts.value, nextToast]
+
+  if (duration > 0) {
+    nextToast.timerId = window.setTimeout(() => dismissToast(id), duration)
+  }
+
+  return id
+}
+
+export function useToast() {
+  return {
+    toasts: readonly(toasts),
+    dismissToast,
+    showToast,
+    success: (message, options = {}) => showToast(message, { type: 'success', ...options }),
+    error: (message, options = {}) => showToast(message, { type: 'error', ...options }),
+    info: (message, options = {}) => showToast(message, { type: 'info', ...options }),
+  }
+}

frontend/src/lib/api.js

@@ -33,10 +33,24 @@ export const api = {
   listGames: () => request('/api/games'),
   getGame: (gameId) => request(`/api/games/${encodeURIComponent(gameId)}`),
   updateAdminGameDisplayOrder: (payload) => request('/api/admin/games/display-order', { method: 'PATCH', body: payload }),
+  updateAdminGameItem: (gameId, itemId, payload) =>
+    request(`/api/admin/games/${encodeURIComponent(gameId)}/items/${encodeURIComponent(itemId)}`, { method: 'PATCH', body: payload }),
   listAdminCustomItems: ({ q = '', page = 1, limit = 50, orphanOnly = false } = {}) =>
     request(
       `/api/admin/custom-items?q=${encodeURIComponent(q)}&page=${encodeURIComponent(page)}&limit=${encodeURIComponent(limit)}&orphanOnly=${encodeURIComponent(orphanOnly)}`
     ),
+  listAdminTierLists: ({ q = '', page = 1, limit = 50 } = {}) =>
+    request(`/api/admin/tierlists?q=${encodeURIComponent(q)}&page=${encodeURIComponent(page)}&limit=${encodeURIComponent(limit)}`),
+  listAdminTemplateRequests: () => request('/api/admin/template-requests'),
+  promoteAdminCustomItem: (itemId, payload) =>
+    request(`/api/admin/custom-items/${encodeURIComponent(itemId)}/promote`, { method: 'POST', body: payload }),
+  promoteAdminTierListItems: (tierListId, payload) =>
+    request(`/api/admin/tierlists/${encodeURIComponent(tierListId)}/promote-items`, { method: 'POST', body: payload }),
+  createAdminGameTemplateFromTierList: (tierListId, payload) =>
+    request(`/api/admin/tierlists/${encodeURIComponent(tierListId)}/create-game-template`, { method: 'POST', body: payload }),
+  approveAdminTemplateRequest: (requestId, payload) =>
+    request(`/api/admin/template-requests/${encodeURIComponent(requestId)}/approve`, { method: 'POST', body: payload || {} }),
+  rejectAdminTemplateRequest: (requestId) => request(`/api/admin/template-requests/${encodeURIComponent(requestId)}/reject`, { method: 'POST', body: {} }),
   listAdminUsers: () => request('/api/admin/users'),
   updateAdminUser: (userId, payload) =>
     request(`/api/admin/users/${encodeURIComponent(userId)}`, { method: 'PATCH', body: payload }),
@@ -46,10 +60,34 @@ export const api = {
 
   listPublicTierLists: (gameId) =>
     request(`/api/tierlists/public?gameId=${encodeURIComponent(gameId || '')}`),
+  searchPublicTierLists: (gameId, q = '') =>
+    request(`/api/tierlists/public?gameId=${encodeURIComponent(gameId || '')}&q=${encodeURIComponent(q || '')}`),
   listMyTierLists: () => request('/api/tierlists/me'),
+  listMyFavoriteTierLists: ({ q = '', sort = 'favorited' } = {}) =>
+    request(`/api/tierlists/favorites/me?q=${encodeURIComponent(q)}&sort=${encodeURIComponent(sort)}`),
   getTierList: (id) => request(`/api/tierlists/${encodeURIComponent(id)}`),
+  favoriteTierList: (id) => request(`/api/tierlists/${encodeURIComponent(id)}/favorite`, { method: 'POST' }),
+  unfavoriteTierList: (id) => request(`/api/tierlists/${encodeURIComponent(id)}/favorite`, { method: 'DELETE' }),
   deleteTierList: (id) => request(`/api/tierlists/${encodeURIComponent(id)}`, { method: 'DELETE' }),
+  requestTierListTemplate: (id, payload) => request(`/api/tierlists/${encodeURIComponent(id)}/template-request`, { method: 'POST', body: payload }),
   saveTierList: (payload) => request('/api/tierlists', { method: 'POST', body: payload }),
+  uploadTierListThumbnail: async (file) => {
+    const fd = new FormData()
+    fd.append('thumbnail', file)
+    const res = await fetch(toApiUrl('/api/tierlists/thumbnail'), {
+      method: 'POST',
+      credentials: 'include',
+      body: fd,
+    })
+    const data = await res.json()
+    if (!res.ok) {
+      const err = new Error('request_failed')
+      err.status = res.status
+      err.data = data
+      throw err
+    }
+    return data
+  },
   deleteAdminCustomItem: (itemId) => request(`/api/admin/custom-items/${encodeURIComponent(itemId)}`, { method: 'DELETE' }),
   deleteAdminUnusedCustomItems: ({ q = '' } = {}) =>
     request(`/api/admin/custom-items?q=${encodeURIComponent(q)}`, { method: 'DELETE' }),

frontend/src/lib/runtime.js

@@ -3,7 +3,12 @@ const FALLBACK_API_ORIGIN = 'http://localhost:5179'
 export const API_ORIGIN = (import.meta.env.VITE_API_ORIGIN || FALLBACK_API_ORIGIN).replace(/\/+$/, '')
 
 export function toApiUrl(path = '') {
-  if (!path) return API_ORIGIN
+  const p = path.startsWith('/') ? path : `/${path}`
+
+  // 운영(Nginx 프록시)에서는 같은 도메인/프로토콜로 호출해야
+  // 세션 쿠키(`Set-Cookie`)가 브라우저에 정상 저장됩니다.
+  if (import.meta.env.PROD) return p
+
   if (/^https?:\/\//.test(path)) return path
-  return `${API_ORIGIN}${path.startsWith('/') ? path : `/${path}`}`
+  return `${API_ORIGIN}${p}`
 }

frontend/src/router/index.js

@@ -5,6 +5,7 @@ import GameHubView from '../views/GameHubView.vue'
 import TierEditorView from '../views/TierEditorView.vue'
 import LoginView from '../views/LoginView.vue'
 import MyTierListsView from '../views/MyTierListsView.vue'
+import FavoriteTierListsView from '../views/FavoriteTierListsView.vue'
 import AdminView from '../views/AdminView.vue'
 import ProfileView from '../views/ProfileView.vue'
 
@@ -18,9 +19,9 @@ export function createRouter() {
       { path: '/editor/:gameId/:tierListId', name: 'editEditor', component: TierEditorView },
       { path: '/login', name: 'login', component: LoginView },
       { path: '/me', name: 'me', component: MyTierListsView },
+      { path: '/favorites', name: 'favorites', component: FavoriteTierListsView },
       { path: '/admin', name: 'admin', component: AdminView },
       { path: '/profile', name: 'profile', component: ProfileView },
     ],
   })
 }
-

frontend/src/style.css

@@ -172,7 +172,7 @@ code {
 }
 
 #app {
-  width: 1126px;
+  /* width: 1126px; */
   max-width: 100%;
   margin: 0 auto;
   text-align: center;

frontend/src/views/AdminView.vue

@@ -1,11 +1,15 @@
 <script setup>
-import { computed, nextTick, onMounted, onUnmounted, ref } from 'vue'
+import { computed, nextTick, onMounted, onUnmounted, ref, watch } from 'vue'
+import { useRouter } from 'vue-router'
 import Sortable from 'sortablejs'
 import { api } from '../lib/api'
 import { toApiUrl } from '../lib/runtime'
 import { useAuthStore } from '../stores/auth'
+import { useToast } from '../composables/useToast'
 
+const router = useRouter()
 const auth = useAuthStore()
+const toast = useToast()
 const isAdmin = computed(() => !!auth.user?.isAdmin)
 
 const activeTab = ref('games')
@@ -22,6 +26,21 @@ const customItemPage = ref(1)
 const customItemLimit = ref(50)
 const customItemTotal = ref(0)
 const customItemOrphanOnly = ref(false)
+const customItemTargetGameId = ref('')
+
+const adminTierLists = ref([])
+const adminTierListQuery = ref('')
+const adminTierListPage = ref(1)
+const adminTierListLimit = ref(50)
+const adminTierListTotal = ref(0)
+const templateRequests = ref([])
+const importModalOpen = ref(false)
+const importModalMode = ref('existing')
+const importModalTierList = ref(null)
+const importModalItems = ref([])
+const importModalTargetGameId = ref('')
+const importModalNewGameId = ref('')
+const importModalNewGameName = ref('')
 
 const users = ref([])
 
@@ -45,16 +64,18 @@ const hasSelectedGame = computed(() => !!selectedGame.value?.game?.id)
 const canApplyThumbnail = computed(() => !!thumbFile.value && !!selectedGameId.value)
 const canAddItem = computed(() => uploadFiles.value.length > 0 && !!selectedGameId.value)
 const customItemPageCount = computed(() => Math.max(1, Math.ceil(customItemTotal.value / customItemLimit.value)))
+const adminTierListPageCount = computed(() => Math.max(1, Math.ceil(adminTierListTotal.value / adminTierListLimit.value)))
 const featuredGames = computed(() =>
   featuredGameIds.value
     .map((gameId) => games.value.find((game) => game.id === gameId))
     .filter(Boolean)
 )
 const availableGamesForFeatured = computed(() => games.value.filter((game) => !featuredGameIds.value.includes(game.id)))
+const importModalItemCount = computed(() => importModalItems.value.length)
 
 onMounted(async () => {
   await auth.refresh()
-  await Promise.all([refreshGames(), refreshCustomItems(), refreshUsers()])
+  await Promise.all([refreshGames(), refreshCustomItems(), refreshAdminTierLists(), refreshUsers(), refreshTemplateRequests()])
   await syncFeaturedSortable()
 })
 
@@ -64,6 +85,18 @@ onUnmounted(() => {
   destroyFeaturedSortable()
 })
 
+watch(error, (message) => {
+  if (!message) return
+  toast.error(message)
+  error.value = ''
+})
+
+watch(success, (message) => {
+  if (!message) return
+  toast.success(message)
+  success.value = ''
+})
+
 function resetMessages() {
   error.value = ''
   success.value = ''
@@ -72,12 +105,18 @@ function resetMessages() {
 function setTab(tab) {
   resetMessages()
   activeTab.value = tab
+  if (tab === 'items' && !customItemTargetGameId.value && games.value.length) {
+    customItemTargetGameId.value = games.value[0].id
+  }
 }
 
 async function refreshGames() {
   try {
     const data = await api.listGames()
     games.value = data.games || []
+    if (!customItemTargetGameId.value && games.value.length) {
+      customItemTargetGameId.value = games.value[0].id
+    }
     featuredGameIds.value = games.value
       .filter((game) => game.displayRank != null)
       .sort((a, b) => a.displayRank - b.displayRank)
@@ -134,6 +173,47 @@ async function refreshCustomItems() {
   }
 }
 
+async function refreshAdminTierLists() {
+  if (!auth.user?.isAdmin) return
+  try {
+    const data = await api.listAdminTierLists({
+      q: adminTierListQuery.value,
+      page: adminTierListPage.value,
+      limit: adminTierListLimit.value,
+    })
+    adminTierLists.value = data.tierLists || []
+    adminTierListTotal.value = data.total || 0
+    adminTierListPage.value = data.page || 1
+    adminTierListLimit.value = data.limit || adminTierListLimit.value
+  } catch (e) {
+    error.value = '관리자 티어표 목록을 불러오지 못했어요.'
+  }
+}
+
+async function refreshTemplateRequests() {
+  if (!auth.user?.isAdmin) return
+  try {
+    const data = await api.listAdminTemplateRequests()
+    templateRequests.value = (data.requests || []).map((request) => ({
+      ...request,
+      draftGameId:
+        request.type === 'create'
+          ? (request.sourceTierListTitle || '')
+              .toLowerCase()
+              .replace(/[^a-z0-9]+/g, '-')
+              .replace(/^-+|-+$/g, '')
+              .slice(0, 80) || 'new-template'
+          : request.targetGameId || request.sourceGameId || '',
+      draftGameName:
+        request.type === 'create'
+          ? `${request.sourceTierListTitle || request.sourceGameName || '새 템플릿'}`
+          : request.targetGameName || request.sourceGameName || '',
+    }))
+  } catch (e) {
+    error.value = '템플릿 요청 목록을 불러오지 못했어요.'
+  }
+}
+
 async function refreshUsers() {
   if (!auth.user?.isAdmin) return
   try {
@@ -196,7 +276,13 @@ async function loadGame() {
 
   try {
     const data = await api.getGame(selectedGameId.value)
-    selectedGame.value = data
+    selectedGame.value = {
+      ...data,
+      items: (data.items || []).map((item) => ({
+        ...item,
+        draftLabel: item.label,
+      })),
+    }
   } catch (e) {
     error.value = '게임 정보를 불러오지 못했어요.'
   }
@@ -346,6 +432,29 @@ async function removeGameItem(itemId) {
   }
 }
 
+async function saveGameItemLabel(item) {
+  resetMessages()
+  if (!selectedGameId.value) return
+  const nextLabel = (item.draftLabel || '').trim()
+  if (!nextLabel) {
+    error.value = '아이템 이름을 입력해주세요.'
+    return
+  }
+  if (nextLabel === item.label) return
+
+  try {
+    item.isSavingLabel = true
+    const data = await api.updateAdminGameItem(selectedGameId.value, item.id, { label: nextLabel })
+    item.label = data.item.label
+    item.draftLabel = data.item.label
+    success.value = '기본 아이템 이름을 수정했어요.'
+  } catch (e) {
+    error.value = '기본 아이템 이름 수정에 실패했어요.'
+  } finally {
+    item.isSavingLabel = false
+  }
+}
+
 async function removeGame() {
   resetMessages()
   if (!selectedGameId.value || !selectedGame.value?.game) return
@@ -442,6 +551,24 @@ function changeCustomItemLimit(limit) {
   refreshCustomItems()
 }
 
+function submitAdminTierListSearch() {
+  adminTierListPage.value = 1
+  refreshAdminTierLists()
+}
+
+function changeAdminTierListLimit(limit) {
+  adminTierListLimit.value = limit
+  adminTierListPage.value = 1
+  refreshAdminTierLists()
+}
+
+function moveAdminTierListPage(direction) {
+  const nextPage = adminTierListPage.value + direction
+  if (nextPage < 1 || nextPage > adminTierListPageCount.value) return
+  adminTierListPage.value = nextPage
+  refreshAdminTierLists()
+}
+
 function moveCustomItemPage(direction) {
   const nextPage = customItemPage.value + direction
   if (nextPage < 1 || nextPage > customItemPageCount.value) return
@@ -482,6 +609,165 @@ async function removeUnusedCustomItems() {
   }
 }
 
+async function promoteCustomItem(item) {
+  resetMessages()
+  if (!customItemTargetGameId.value) {
+    error.value = '가져올 게임을 먼저 선택해주세요.'
+    return
+  }
+
+  try {
+    item.isPromoting = true
+    await api.promoteAdminCustomItem(item.id, { gameId: customItemTargetGameId.value })
+    const targetGameName = games.value.find((game) => game.id === customItemTargetGameId.value)?.name || customItemTargetGameId.value
+    if (selectedGameId.value === customItemTargetGameId.value) await loadGame()
+    success.value = `"${item.label}" 아이템을 ${targetGameName} 기본 템플릿으로 추가했어요.`
+  } catch (e) {
+    error.value = '커스텀 아이템을 기본 템플릿으로 가져오지 못했어요.'
+  } finally {
+    item.isPromoting = false
+  }
+}
+
+function tierListThumbUrl(tierList) {
+  return tierList.thumbnailSrc ? toApiUrl(tierList.thumbnailSrc) : ''
+}
+
+function tierListAuthorDisplayName(tierList) {
+  return tierList.authorName || '알 수 없음'
+}
+
+function tierListVisibilityLabel(tierList) {
+  return tierList.isPublic ? '공개' : '비공개'
+}
+
+function openAdminTierList(tierList) {
+  router.push(`/editor/${tierList.gameId}/${tierList.id}`)
+}
+
+function openTierListImportModal(tierList, items) {
+  resetMessages()
+  const nextItems = (items || []).filter(Boolean)
+  if (!nextItems.length) {
+    error.value = '가져올 아이템이 없어요.'
+    return
+  }
+
+  importModalTierList.value = tierList
+  importModalItems.value = nextItems
+  importModalMode.value = 'existing'
+  importModalTargetGameId.value = ''
+  importModalNewGameId.value = tierList.gameId === 'freeform' ? '' : `${tierList.gameId}-copy`
+  importModalNewGameName.value =
+    tierList.gameId === 'freeform' ? `${tierList.title} 템플릿` : `${tierList.gameName || tierList.gameId} 파생 템플릿`
+  importModalOpen.value = true
+}
+
+function closeTierListImportModal() {
+  importModalOpen.value = false
+  importModalTierList.value = null
+  importModalItems.value = []
+}
+
+async function confirmTierListImport() {
+  resetMessages()
+  if (!importModalTierList.value || !importModalItems.value.length) {
+    error.value = '가져올 티어표 정보를 확인하지 못했어요.'
+    return
+  }
+
+  const tierList = importModalTierList.value
+  const itemIds = importModalItems.value.map((item) => item.id)
+
+  try {
+    if (importModalMode.value === 'existing') {
+      if (!importModalTargetGameId.value) {
+        error.value = '아이템을 추가할 기존 게임을 선택해주세요.'
+        return
+      }
+
+      const data = await api.promoteAdminTierListItems(tierList.id, {
+        gameId: importModalTargetGameId.value,
+        itemIds,
+      })
+      if (selectedGameId.value === importModalTargetGameId.value) await loadGame()
+      success.value = `${data.items?.length || 0}개의 아이템을 기존 템플릿에 추가했어요.`
+    } else {
+      const nextGameId = (importModalNewGameId.value || '').trim()
+      const nextGameName = (importModalNewGameName.value || '').trim()
+      if (!nextGameId || !nextGameName) {
+        error.value = '새 게임 ID와 이름을 모두 입력해주세요.'
+        return
+      }
+
+      const data = await api.createAdminGameTemplateFromTierList(tierList.id, {
+        gameId: nextGameId,
+        name: nextGameName,
+        itemIds,
+      })
+      await refreshGames()
+      success.value = `"${data.game?.name || nextGameName}" 템플릿을 생성했어요.`
+    }
+
+    closeTierListImportModal()
+  } catch (e) {
+    error.value = '티어표 아이템 가져오기에 실패했어요.'
+  }
+}
+
+function templateRequestTypeLabel(request) {
+  return request.type === 'create' ? '템플릿 등록 요청' : '템플릿 업데이트 요청'
+}
+
+function templateRequestTargetLabel(request) {
+  return request.type === 'create' ? '새 게임 템플릿 생성' : request.targetGameName || request.targetGameId || request.sourceGameName
+}
+
+async function approveTemplateRequest(request) {
+  resetMessages()
+  try {
+    request.isHandling = true
+    if (request.type === 'create') {
+      const nextGameId = (request.draftGameId || '').trim()
+      const nextGameName = (request.draftGameName || '').trim()
+      if (!nextGameId || !nextGameName) {
+        error.value = '새 게임 ID와 이름을 모두 입력해주세요.'
+        return
+      }
+      await api.approveAdminTemplateRequest(request.id, {
+        gameId: nextGameId,
+        name: nextGameName,
+      })
+      await refreshGames()
+      success.value = `"${nextGameName}" 템플릿 생성을 승인했어요.`
+    } else {
+      const data = await api.approveAdminTemplateRequest(request.id)
+      if (selectedGameId.value === (request.targetGameId || request.sourceGameId)) await loadGame()
+      success.value = `${data.items?.length || 0}개의 아이템 추가 요청을 승인했어요.`
+    }
+    await refreshTemplateRequests()
+    await refreshAdminTierLists()
+  } catch (e) {
+    error.value = request.type === 'create' ? '템플릿 등록 요청 승인에 실패했어요.' : '템플릿 업데이트 요청 승인에 실패했어요.'
+  } finally {
+    request.isHandling = false
+  }
+}
+
+async function rejectTemplateRequest(request) {
+  resetMessages()
+  try {
+    request.isHandling = true
+    await api.rejectAdminTemplateRequest(request.id)
+    await refreshTemplateRequests()
+    success.value = '요청을 반려했어요.'
+  } catch (e) {
+    error.value = '요청 반려에 실패했어요.'
+  } finally {
+    request.isHandling = false
+  }
+}
+
 const displayThumbnailUrl = computed(() => {
   if (thumbPreviewUrl.value) return thumbPreviewUrl.value
   if (selectedGame.value?.game?.thumbnailSrc) return toApiUrl(selectedGame.value.game.thumbnailSrc)
@@ -498,6 +784,18 @@ function fmt(ts) {
   })
 }
 
+function userAvatarUrl(user) {
+  return user?.avatarSrc ? toApiUrl(user.avatarSrc) : ''
+}
+
+function userDisplayName(user) {
+  return user?.nickname || user?.email?.split('@')[0] || '알 수 없음'
+}
+
+function userAvatarFallback(user) {
+  return (user?.email?.trim()?.[0] || '?').toUpperCase()
+}
+
 function addFeaturedGame(gameId) {
   resetMessages()
   if (!gameId || featuredGameIds.value.includes(gameId)) return
@@ -554,12 +852,10 @@ async function saveFeaturedOrder() {
         <div class="tabs">
           <button class="tab" :class="{ 'tab--active': activeTab === 'games' }" @click="setTab('games')">게임 관리</button>
           <button class="tab" :class="{ 'tab--active': activeTab === 'items' }" @click="setTab('items')">아이템 관리</button>
+          <button class="tab" :class="{ 'tab--active': activeTab === 'tierlists' }" @click="setTab('tierlists')">티어표 관리</button>
           <button class="tab" :class="{ 'tab--active': activeTab === 'users' }" @click="setTab('users')">회원 관리</button>
         </div>
 
-        <div v-if="error" class="error">{{ error }}</div>
-        <div v-if="success" class="success">{{ success }}</div>
-
         <template v-if="activeTab === 'games'">
           <div class="panel">
             <div class="sectionHeader">
@@ -708,8 +1004,17 @@ async function saveFeaturedOrder() {
               <div v-else class="thumbGrid">
                 <div v-for="item in selectedGame.items" :key="item.id" class="thumbCard">
                   <img class="thumb thumb--game" :src="toApiUrl(item.src)" :alt="item.label" />
-                  <div class="thumbLabel">{{ item.label }}</div>
-                  <button class="btn btn--danger btn--small" @click="removeGameItem(item.id)">아이템 삭제</button>
+                  <input v-model="item.draftLabel" class="input input--labelEdit" placeholder="아이템 이름" />
+                  <div class="thumbCard__actions">
+                    <button
+                      class="btn btn--ghost btn--small"
+                      :disabled="item.isSavingLabel || !item.draftLabel?.trim() || item.draftLabel.trim() === item.label"
+                      @click="saveGameItemLabel(item)"
+                    >
+                      {{ item.isSavingLabel ? '저장중...' : '이름 저장' }}
+                    </button>
+                    <button class="btn btn--danger btn--small" @click="removeGameItem(item.id)">아이템 삭제</button>
+                  </div>
                 </div>
               </div>
             </div>
@@ -736,6 +1041,10 @@ async function saveFeaturedOrder() {
             </div>
 
             <div class="toolbar toolbar--secondary">
+              <select v-model="customItemTargetGameId" class="select toolbar__select">
+                <option value="">가져올 게임 선택</option>
+                <option v-for="game in games" :key="game.id" :value="game.id">{{ game.name }}</option>
+              </select>
               <label class="checkRow checkRow--toolbar">
                 <input v-model="customItemOrphanOnly" type="checkbox" @change="toggleCustomItemOrphanOnly" />
                 <span>미사용 커스텀 이미지만 보기</span>
@@ -757,6 +1066,9 @@ async function saveFeaturedOrder() {
                   <div class="customItemCard__meta">{{ fmt(item.createdAt) }}</div>
                   <div class="customItemCard__actions">
                     <a class="btn btn--small btn--ghost" :href="toApiUrl(item.src)" :download="item.label">이미지 다운로드</a>
+                    <button class="btn btn--small btn--ghost" :disabled="!customItemTargetGameId || item.isPromoting" @click="promoteCustomItem(item)">
+                      {{ item.isPromoting ? '추가중...' : '기본 템플릿에 추가' }}
+                    </button>
                     <button class="btn btn--small btn--danger" :disabled="item.usageCount > 0" @click="removeCustomItem(item)">개별 삭제</button>
                   </div>
                 </div>
@@ -771,6 +1083,166 @@ async function saveFeaturedOrder() {
           </div>
         </template>
 
+        <template v-else-if="activeTab === 'tierlists'">
+          <div class="panel">
+            <div class="sectionHeader">
+              <div>
+                <div class="panel__title">사용자 템플릿 요청</div>
+                <div class="hint hint--tight">freeform 템플릿 등록 요청과 기존 게임 템플릿 업데이트 요청을 여기서 승인하거나 반려할 수 있어요.</div>
+              </div>
+              <button class="btn btn--ghost" @click="refreshTemplateRequests">새로고침</button>
+            </div>
+
+            <div v-if="!templateRequests.length" class="hint">현재 처리 대기 중인 템플릿 요청이 없어요.</div>
+            <div v-else class="templateRequestList">
+              <article v-for="request in templateRequests" :key="request.id" class="templateRequestCard">
+                <div class="templateRequestCard__head">
+                  <div>
+                    <div class="templateRequestCard__title">{{ request.sourceTierListTitle }}</div>
+                    <div class="templateRequestCard__meta">
+                      {{ templateRequestTypeLabel(request) }} · {{ request.requesterName }} · {{ fmt(request.createdAt) }}
+                    </div>
+                    <div class="templateRequestCard__meta">{{ templateRequestTargetLabel(request) }}</div>
+                  </div>
+                  <button class="btn btn--ghost btn--small" @click="openAdminTierList({ id: request.sourceTierListId, gameId: request.sourceGameId })">
+                    원본 보기
+                  </button>
+                </div>
+
+                <div v-if="request.items?.length" class="templateRequestItems">
+                  <div v-for="item in request.items" :key="item.id" class="templateRequestItem">
+                    <img class="templateRequestItem__thumb" :src="toApiUrl(item.src)" :alt="item.label" />
+                    <div class="templateRequestItem__label">{{ item.label }}</div>
+                  </div>
+                </div>
+
+                <div v-if="request.type === 'create'" class="templateRequestCard__form">
+                  <input v-model="request.draftGameId" class="input" placeholder="새 게임 ID" />
+                  <input v-model="request.draftGameName" class="input" placeholder="새 게임 이름" />
+                </div>
+
+                <div class="templateRequestCard__actions">
+                  <button class="btn btn--primary" :disabled="request.isHandling" @click="approveTemplateRequest(request)">
+                    {{ request.isHandling ? '처리중...' : '승인' }}
+                  </button>
+                  <button class="btn btn--danger" :disabled="request.isHandling" @click="rejectTemplateRequest(request)">반려</button>
+                </div>
+              </article>
+            </div>
+          </div>
+
+          <div class="panel">
+            <div class="sectionHeader">
+              <div>
+                <div class="panel__title">전체 티어표 관리</div>
+                <div class="hint hint--tight">공개/비공개를 포함한 최근 티어표를 모두 확인하고, 추가 아이템을 기존 게임 템플릿으로 승격하거나 커스텀 티어표를 새 게임 템플릿으로 만들 수 있어요.</div>
+              </div>
+              <button class="btn btn--ghost" @click="refreshAdminTierLists">새로고침</button>
+            </div>
+
+            <div class="toolbar">
+              <input
+                v-model="adminTierListQuery"
+                class="input toolbar__search"
+                placeholder="제목, 작성자, 게임 이름 검색"
+                @keydown.enter.prevent="submitAdminTierListSearch"
+              />
+              <button class="btn btn--ghost toolbar__button" @click="submitAdminTierListSearch">검색</button>
+              <select :value="adminTierListLimit" class="select toolbar__select" @change="changeAdminTierListLimit(Number($event.target.value))">
+                <option :value="50">50개씩 보기</option>
+                <option :value="200">200개씩 보기</option>
+              </select>
+            </div>
+
+            <div v-if="!adminTierLists.length" class="hint">조건에 맞는 티어표가 없어요.</div>
+            <div v-else class="tierAdminList">
+              <article v-for="tierList in adminTierLists" :key="tierList.id" class="tierAdminCard">
+                <div class="tierAdminCard__preview" @click="openAdminTierList(tierList)">
+                  <img v-if="tierListThumbUrl(tierList)" class="tierAdminCard__thumb" :src="tierListThumbUrl(tierList)" :alt="tierList.title" />
+                  <div v-else class="tierAdminCard__thumb tierAdminCard__thumb--empty"></div>
+                </div>
+
+                <div class="tierAdminCard__body">
+                  <div class="tierAdminCard__head">
+                    <div>
+                      <div class="tierAdminCard__title">{{ tierList.title }}</div>
+                      <div class="tierAdminCard__meta">
+                        {{ tierList.gameName || tierList.gameId }} · {{ tierListAuthorDisplayName(tierList) }} · {{ tierListVisibilityLabel(tierList) }}
+                      </div>
+                      <div class="tierAdminCard__meta">{{ fmt(tierList.updatedAt) }}</div>
+                    </div>
+                    <button class="btn btn--ghost btn--small" @click="openAdminTierList(tierList)">완성본 보기</button>
+                  </div>
+
+                  <div class="tierAdminCard__stats">
+                    <span class="pill">전체 아이템 {{ tierList.itemCount }}개</span>
+                    <span class="pill" :class="{ 'pill--accent': tierList.extraItemCount > 0 }">추가 아이템 {{ tierList.extraItemCount }}개</span>
+                  </div>
+
+                  <div v-if="tierList.extraItems?.length" class="tierAdminSection">
+                    <div class="tierAdminSection__title">추가로 넣은 아이템</div>
+                    <div class="tierAdminItemList">
+                      <button v-for="item in tierList.extraItems" :key="item.id" class="tierAdminItem" @click="openTierListImportModal(tierList, [item])">
+                        <img class="tierAdminItem__thumb" :src="toApiUrl(item.src)" :alt="item.label" />
+                        <div class="tierAdminItem__title">{{ item.label }}</div>
+                      </button>
+                    </div>
+                    <div class="tierAdminSection__actions">
+                      <button class="btn btn--ghost btn--small" @click="openTierListImportModal(tierList, tierList.extraItems)">추가 아이템 전체 가져오기</button>
+                      <button v-if="tierList.gameId === 'freeform'" class="btn btn--primary btn--small" @click="openTierListImportModal(tierList, tierList.extraItems)">
+                        새 템플릿으로 가져오기
+                      </button>
+                    </div>
+                  </div>
+                </div>
+              </article>
+            </div>
+
+            <div class="pager">
+              <button class="btn btn--ghost" :disabled="adminTierListPage <= 1" @click="moveAdminTierListPage(-1)">이전</button>
+              <div class="pager__info">{{ adminTierListPage }} / {{ adminTierListPageCount }} 페이지 · 총 {{ adminTierListTotal }}개</div>
+              <button class="btn btn--ghost" :disabled="adminTierListPage >= adminTierListPageCount" @click="moveAdminTierListPage(1)">다음</button>
+            </div>
+          </div>
+
+          <div v-if="importModalOpen" class="modalOverlay" @click.self="closeTierListImportModal">
+            <div class="modalCard modalCard--import" role="dialog" aria-modal="true">
+              <div class="modalCard__title">티어표 아이템 가져오기</div>
+              <div class="modalCard__desc">
+                "{{ importModalTierList?.title }}"의 아이템 {{ importModalItemCount }}개를 어디로 가져올지 선택해주세요.
+              </div>
+
+              <div class="importModeTabs">
+                <button class="modeTab" :class="{ 'modeTab--active': importModalMode === 'existing' }" @click="importModalMode = 'existing'">
+                  기존 템플릿에 추가
+                </button>
+                <button class="modeTab" :class="{ 'modeTab--active': importModalMode === 'new' }" @click="importModalMode = 'new'">
+                  새 템플릿 만들기
+                </button>
+              </div>
+
+              <div v-if="importModalMode === 'existing'" class="modalCard__form">
+                <select v-model="importModalTargetGameId" class="select">
+                  <option value="">기존 게임 선택</option>
+                  <option v-for="game in games" :key="game.id" :value="game.id">{{ game.name }}</option>
+                </select>
+              </div>
+
+              <div v-else class="modalCard__form">
+                <input v-model="importModalNewGameId" class="input" placeholder="새 게임 ID" />
+                <input v-model="importModalNewGameName" class="input" placeholder="새 게임 이름" />
+              </div>
+
+              <div class="modalCard__actions">
+                <button class="btn btn--ghost" @click="closeTierListImportModal">취소</button>
+                <button class="btn btn--primary" @click="confirmTierListImport">
+                  {{ importModalMode === 'existing' ? '여기로 가져오기' : '새 템플릿 생성' }}
+                </button>
+              </div>
+            </div>
+          </div>
+        </template>
+
         <template v-else>
           <div class="panel">
             <div class="sectionHeader">
@@ -785,15 +1257,32 @@ async function saveFeaturedOrder() {
             <div v-else class="userList">
               <article v-for="user in users" :key="user.id" class="userCard">
                 <div class="userCard__head">
-                  <div>
-                    <div class="userCard__title">{{ user.nickname || '닉네임 없음' }}</div>
-                    <div class="userCard__meta">{{ fmt(user.createdAt) }}</div>
+                  <div class="userCard__identity">
+                    <div class="userAvatar">
+                      <img v-if="userAvatarUrl(user)" class="userAvatar__image" :src="userAvatarUrl(user)" :alt="userDisplayName(user)" />
+                      <span v-else class="userAvatar__fallback">{{ userAvatarFallback(user) }}</span>
+                    </div>
+                    <div>
+                      <div class="userCard__title">{{ userDisplayName(user) }}</div>
+                      <div class="userCard__meta">가입일 {{ fmt(user.createdAt) }}</div>
+                    </div>
                   </div>
                   <span class="roleBadge" :class="{ 'roleBadge--admin': user.draftIsAdmin }">
                     {{ user.draftIsAdmin ? '관리자' : '일반 회원' }}
                   </span>
                 </div>
 
+                <div class="userStats">
+                  <div class="userStat">
+                    <span class="userStat__label">작성 티어표</span>
+                    <strong class="userStat__value">{{ user.tierListCount }}개</strong>
+                  </div>
+                  <div class="userStat">
+                    <span class="userStat__label">최근 활동</span>
+                    <strong class="userStat__value">{{ fmt(user.recentActivityAt || user.createdAt) }}</strong>
+                  </div>
+                </div>
+
                 <input v-model="user.draftEmail" class="input" placeholder="이메일" />
                 <input v-model="user.draftNickname" class="input" placeholder="닉네임" />
                 <label class="checkRow">
@@ -1011,7 +1500,7 @@ async function saveFeaturedOrder() {
   align-items: end;
 }
 .toolbar--secondary {
-  grid-template-columns: minmax(0, 1fr) auto;
+  grid-template-columns: auto minmax(0, 1fr) auto;
   align-items: center;
 }
 .toolbar__search,
@@ -1047,6 +1536,9 @@ async function saveFeaturedOrder() {
 .input--compact {
   max-width: 320px;
 }
+.input--labelEdit {
+  margin-top: 10px;
+}
 .hint {
   margin-top: 10px;
   opacity: 0.78;
@@ -1251,6 +1743,11 @@ async function saveFeaturedOrder() {
   opacity: 0.9;
   word-break: break-word;
 }
+.thumbCard__actions {
+  margin-top: 10px;
+  display: grid;
+  gap: 8px;
+}
 .thumbLabel--preview {
   text-align: center;
 }
@@ -1289,7 +1786,7 @@ async function saveFeaturedOrder() {
 }
 .customItemCard__actions {
   display: grid;
-  grid-template-columns: repeat(2, minmax(0, 1fr));
+  grid-template-columns: repeat(3, minmax(0, 1fr));
   gap: 10px;
   margin-top: 4px;
 }
@@ -1336,6 +1833,12 @@ async function saveFeaturedOrder() {
   justify-content: space-between;
   align-items: flex-start;
 }
+.userCard__identity {
+  display: flex;
+  gap: 12px;
+  align-items: center;
+  min-width: 0;
+}
 .userCard__title {
   font-weight: 900;
 }
@@ -1344,6 +1847,48 @@ async function saveFeaturedOrder() {
   opacity: 0.72;
   font-size: 13px;
 }
+.userAvatar {
+  width: 48px;
+  height: 48px;
+  flex: 0 0 auto;
+  display: grid;
+  place-items: center;
+  border-radius: 999px;
+  overflow: hidden;
+  border: 1px solid rgba(255, 255, 255, 0.14);
+  background: rgba(96, 165, 250, 0.18);
+}
+.userAvatar__image {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+}
+.userAvatar__fallback {
+  font-size: 18px;
+  font-weight: 900;
+}
+.userStats {
+  margin-top: 12px;
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 10px;
+}
+.userStat {
+  display: grid;
+  gap: 4px;
+  padding: 10px 12px;
+  border-radius: 12px;
+  border: 1px solid rgba(255, 255, 255, 0.08);
+  background: rgba(255, 255, 255, 0.03);
+}
+.userStat__label {
+  font-size: 12px;
+  opacity: 0.66;
+}
+.userStat__value {
+  font-size: 14px;
+  font-weight: 900;
+}
 .userCard__actions {
   display: grid;
   grid-template-columns: repeat(2, minmax(0, 1fr));
@@ -1365,6 +1910,229 @@ async function saveFeaturedOrder() {
 .roleBadge--admin {
   background: rgba(96, 165, 250, 0.18);
 }
+.templateRequestList {
+  margin-top: 14px;
+  display: grid;
+  gap: 14px;
+}
+.templateRequestCard {
+  display: grid;
+  gap: 14px;
+  padding: 16px;
+  border-radius: 18px;
+  border: 1px solid rgba(255, 255, 255, 0.12);
+  background: rgba(255, 255, 255, 0.03);
+}
+.templateRequestCard__head {
+  display: flex;
+  gap: 12px;
+  justify-content: space-between;
+  align-items: flex-start;
+  flex-wrap: wrap;
+}
+.templateRequestCard__title {
+  font-weight: 900;
+  font-size: 18px;
+}
+.templateRequestCard__meta {
+  margin-top: 4px;
+  font-size: 13px;
+  opacity: 0.72;
+}
+.templateRequestItems {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(96px, 1fr));
+  gap: 10px;
+}
+.templateRequestItem {
+  display: grid;
+  gap: 8px;
+}
+.templateRequestItem__thumb {
+  width: 100%;
+  aspect-ratio: 1 / 1;
+  object-fit: cover;
+  border-radius: 12px;
+  border: 1px solid rgba(255, 255, 255, 0.12);
+  background: rgba(255, 255, 255, 0.04);
+}
+.templateRequestItem__label {
+  font-size: 12px;
+  font-weight: 800;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.templateRequestCard__form {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 10px;
+}
+.templateRequestCard__actions {
+  display: flex;
+  gap: 10px;
+  justify-content: flex-end;
+  flex-wrap: wrap;
+}
+.tierAdminList {
+  margin-top: 14px;
+  display: grid;
+  gap: 14px;
+}
+.tierAdminCard {
+  display: grid;
+  grid-template-columns: minmax(220px, 280px) minmax(0, 1fr);
+  gap: 16px;
+  border: 1px solid rgba(255, 255, 255, 0.12);
+  border-radius: 18px;
+  background: rgba(255, 255, 255, 0.03);
+  padding: 14px;
+}
+.tierAdminCard__preview {
+  cursor: pointer;
+}
+.tierAdminCard__thumb {
+  width: 100%;
+  aspect-ratio: 16 / 9;
+  object-fit: cover;
+  display: block;
+  border-radius: 14px;
+  background: rgba(255, 255, 255, 0.04);
+}
+.tierAdminCard__thumb--empty {
+  background: linear-gradient(135deg, rgba(255,255,255,0.08), rgba(255,255,255,0.03));
+}
+.tierAdminCard__body {
+  min-width: 0;
+  display: grid;
+  gap: 14px;
+}
+.tierAdminCard__head {
+  display: flex;
+  gap: 12px;
+  justify-content: space-between;
+  align-items: flex-start;
+}
+.tierAdminCard__title {
+  font-size: 18px;
+  font-weight: 900;
+}
+.tierAdminCard__meta {
+  margin-top: 4px;
+  opacity: 0.74;
+  font-size: 13px;
+  word-break: break-word;
+}
+.tierAdminCard__stats {
+  display: flex;
+  gap: 8px;
+  flex-wrap: wrap;
+}
+.pill {
+  display: inline-flex;
+  align-items: center;
+  padding: 7px 10px;
+  border-radius: 999px;
+  border: 1px solid rgba(255, 255, 255, 0.12);
+  background: rgba(255, 255, 255, 0.05);
+  font-size: 12px;
+  font-weight: 800;
+}
+.pill--accent {
+  border-color: rgba(251, 191, 36, 0.32);
+  background: rgba(251, 191, 36, 0.12);
+  color: rgba(253, 230, 138, 0.96);
+}
+.tierAdminSection {
+  display: grid;
+  gap: 10px;
+  padding: 12px;
+  border-radius: 14px;
+  border: 1px solid rgba(255, 255, 255, 0.08);
+  background: rgba(0, 0, 0, 0.14);
+}
+.tierAdminSection__title {
+  font-weight: 800;
+}
+.tierAdminSection__actions {
+  display: flex;
+  gap: 10px;
+  flex-wrap: wrap;
+}
+.tierAdminItemList {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(100px, 1fr));
+  gap: 10px;
+}
+.tierAdminItem {
+  display: grid;
+  gap: 8px;
+  justify-items: center;
+  padding: 10px;
+  border-radius: 12px;
+  border: 1px solid rgba(255, 255, 255, 0.08);
+  background: rgba(255, 255, 255, 0.03);
+  color: rgba(255, 255, 255, 0.92);
+  cursor: pointer;
+  text-align: center;
+  min-width: 0;
+}
+.tierAdminItem__thumb {
+  width: min(100%, 72px);
+  aspect-ratio: 1;
+  object-fit: cover;
+  border-radius: 12px;
+}
+.tierAdminItem__title {
+  width: 100%;
+  font-weight: 800;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-size: 12px;
+}
+.modalOverlay {
+  position: fixed;
+  inset: 0;
+  z-index: 20;
+  display: grid;
+  place-items: center;
+  padding: 20px;
+  background: rgba(3, 7, 18, 0.66);
+  backdrop-filter: blur(6px);
+}
+.modalCard {
+  width: min(560px, 100%);
+  display: grid;
+  gap: 14px;
+  padding: 18px;
+  border-radius: 20px;
+  border: 1px solid rgba(255, 255, 255, 0.12);
+  background: rgba(11, 18, 32, 0.96);
+}
+.modalCard__title {
+  font-size: 18px;
+  font-weight: 900;
+}
+.modalCard__desc {
+  opacity: 0.78;
+  line-height: 1.5;
+}
+.modalCard__form {
+  display: grid;
+  gap: 10px;
+}
+.modalCard__actions {
+  display: flex;
+  gap: 10px;
+  justify-content: flex-end;
+  flex-wrap: wrap;
+}
+.importModeTabs {
+  display: flex;
+  gap: 10px;
+  flex-wrap: wrap;
+}
 .checkRow {
   margin-top: 12px;
   display: inline-flex;
@@ -1379,12 +2147,21 @@ async function saveFeaturedOrder() {
   .featuredOrderPanel,
   .section--topGrid,
   .toolbar,
-  .itemComposer {
+  .itemComposer,
+  .tierAdminCard,
+  .userStats,
+  .templateRequestCard__form {
+    grid-template-columns: 1fr;
+  }
+  .toolbar--secondary {
     grid-template-columns: 1fr;
   }
   .itemPreviewCard {
     max-width: none;
   }
+  .userCard__identity {
+    width: 100%;
+  }
 }
 @media (max-width: 640px) {
   .thumbGrid,
@@ -1392,6 +2169,9 @@ async function saveFeaturedOrder() {
   .userList {
     grid-template-columns: 1fr;
   }
+  .tierAdminCard__head {
+    display: grid;
+  }
   .customItemCard {
     align-items: stretch;
   }

frontend/src/views/FavoriteTierListsView.vue

@@ -0,0 +1,261 @@
+<script setup>
+import { computed, onMounted, ref } from 'vue'
+import { useRouter } from 'vue-router'
+import { api } from '../lib/api'
+import { toApiUrl } from '../lib/runtime'
+import { useToast } from '../composables/useToast'
+
+const router = useRouter()
+const toast = useToast()
+
+const favorites = ref([])
+const query = ref('')
+const sort = ref('favorited')
+const sortLabel = computed(() =>
+  sort.value === 'favorited' ? '즐겨찾기한 날짜' : sort.value === 'updated' ? '최종 업데이트' : '즐겨찾기 수'
+)
+
+function fmt(ts) {
+  return new Date(ts).toLocaleString(undefined, {
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+  })
+}
+
+function displayNameOf(tierList) {
+  return tierList.authorName || '알 수 없음'
+}
+
+function avatarSrcOf(tierList) {
+  return tierList.authorAvatarSrc ? toApiUrl(tierList.authorAvatarSrc) : ''
+}
+
+function avatarFallbackOf(tierList) {
+  return (tierList.authorAccountName || 'u').trim().charAt(0).toUpperCase() || '?'
+}
+
+function tierListThumbnailUrl(tierList) {
+  return tierList.thumbnailSrc ? toApiUrl(tierList.thumbnailSrc) : ''
+}
+
+async function loadFavorites() {
+  try {
+    const data = await api.listMyFavoriteTierLists({ q: query.value, sort: sort.value })
+    favorites.value = data.tierLists || []
+  } catch (e) {
+    toast.error('로그인이 필요해요.')
+    router.push('/login?redirect=/favorites')
+  }
+}
+
+function openTierList(tierList) {
+  router.push(`/editor/${tierList.gameId}/${tierList.id}`)
+}
+
+onMounted(loadFavorites)
+</script>
+
+<template>
+  <section class="wrap">
+    <div class="head">
+      <div>
+        <h2 class="title">내 즐겨찾기</h2>
+        <div class="desc">마음에 드는 티어표를 모아보고, 원하는 기준으로 정렬할 수 있어요.</div>
+      </div>
+      <div class="toolbar">
+        <input v-model="query" class="input" placeholder="제목, 게임, 작성자 검색" @keydown.enter.prevent="loadFavorites" />
+        <select v-model="sort" class="select" @change="loadFavorites">
+          <option value="favorited">즐겨찾기한 순</option>
+          <option value="updated">최신 업데이트순</option>
+          <option value="favorites">인기순</option>
+        </select>
+        <button class="btn" @click="loadFavorites">검색</button>
+      </div>
+    </div>
+
+    <div v-if="favorites.length === 0" class="empty">즐겨찾기한 티어표가 없어요.</div>
+    <div v-else class="list">
+      <article v-for="tierList in favorites" :key="tierList.id" class="row">
+        <button class="row__body" @click="openTierList(tierList)">
+          <div class="row__thumbWrap">
+            <img v-if="tierListThumbnailUrl(tierList)" class="row__thumb" :src="tierListThumbnailUrl(tierList)" :alt="tierList.title" />
+            <div v-else class="row__thumbPlaceholder"></div>
+          </div>
+          <div class="row__head">
+            <div class="row__title">{{ tierList.title }}</div>
+            <div class="row__author">
+              <img v-if="avatarSrcOf(tierList)" class="row__avatar" :src="avatarSrcOf(tierList)" :alt="displayNameOf(tierList)" />
+              <div v-else class="row__avatar row__avatar--fallback">{{ avatarFallbackOf(tierList) }}</div>
+              <span>by {{ displayNameOf(tierList) }}</span>
+            </div>
+          </div>
+        </button>
+        <div class="row__foot">
+          <div class="row__meta">
+            <div>{{ tierList.gameName || tierList.gameId }}</div>
+            <div>{{ sortLabel }}: {{ fmt(sort === 'favorited' ? tierList.favoritedAt : tierList.updatedAt) }}</div>
+          </div>
+          <div class="favoriteStat">★ {{ tierList.favoriteCount || 0 }}</div>
+        </div>
+      </article>
+    </div>
+  </section>
+</template>
+
+<style scoped>
+.wrap {
+  display: grid;
+  gap: 14px;
+}
+.head {
+  display: flex;
+  gap: 14px;
+  justify-content: space-between;
+  align-items: flex-end;
+  flex-wrap: wrap;
+}
+.title {
+  margin: 0;
+  font-size: 28px;
+}
+.desc {
+  margin-top: 6px;
+  opacity: 0.78;
+}
+.toolbar {
+  display: flex;
+  gap: 10px;
+  flex-wrap: wrap;
+}
+.input,
+.select {
+  padding: 10px 12px;
+  border-radius: 12px;
+  border: 1px solid rgba(255, 255, 255, 0.12);
+  background: rgba(0, 0, 0, 0.18);
+  color: rgba(255, 255, 255, 0.92);
+}
+.btn {
+  padding: 10px 12px;
+  border-radius: 12px;
+  border: 1px solid rgba(255, 255, 255, 0.14);
+  background: rgba(255, 255, 255, 0.06);
+  color: rgba(255, 255, 255, 0.92);
+  font-weight: 800;
+  cursor: pointer;
+}
+.empty {
+  opacity: 0.76;
+}
+.list {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 14px;
+}
+.row {
+  border-radius: 16px;
+  border: 1px solid rgba(255, 255, 255, 0.12);
+  background: rgba(255, 255, 255, 0.04);
+  overflow: hidden;
+  display: grid;
+  gap: 10px;
+}
+.row__body {
+  border: 0;
+  background: transparent;
+  color: inherit;
+  padding: 0;
+  text-align: left;
+  cursor: pointer;
+  display: grid;
+  gap: 10px;
+}
+.row__thumbWrap {
+  width: 100%;
+  aspect-ratio: 16 / 9;
+  background: rgba(255, 255, 255, 0.03);
+}
+.row__thumb,
+.row__thumbPlaceholder {
+  width: 100%;
+  height: 100%;
+  display: block;
+}
+.row__thumb {
+  object-fit: cover;
+}
+.row__thumbPlaceholder {
+  background: linear-gradient(135deg, rgba(255,255,255,0.06), rgba(255,255,255,0.02));
+}
+.row__head {
+  padding: 14px 14px 0;
+  display: grid;
+  gap: 10px;
+}
+.row__title {
+  font-weight: 800;
+  font-size: 18px;
+}
+.row__author {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  font-size: 13px;
+  opacity: 0.86;
+}
+.row__avatar {
+  width: 28px;
+  height: 28px;
+  border-radius: 999px;
+  object-fit: cover;
+  background: rgba(255, 255, 255, 0.08);
+}
+.row__avatar--fallback {
+  display: grid;
+  place-items: center;
+  font-size: 12px;
+  font-weight: 900;
+}
+.row__foot {
+  padding: 0 14px 14px;
+  display: flex;
+  gap: 12px;
+  align-items: center;
+  justify-content: space-between;
+}
+.row__meta {
+  display: grid;
+  gap: 4px;
+  opacity: 0.78;
+  font-size: 13px;
+}
+.favoriteStat {
+  border: 1px solid rgba(255, 255, 255, 0.12);
+  background: rgba(255, 255, 255, 0.05);
+  color: rgba(255, 255, 255, 0.92);
+  border-radius: 999px;
+  padding: 7px 10px;
+  font-weight: 800;
+}
+@media (max-width: 1100px) {
+  .list {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+}
+@media (max-width: 720px) {
+  .list {
+    grid-template-columns: 1fr;
+  }
+  .toolbar {
+    width: 100%;
+  }
+  .input,
+  .select,
+  .btn {
+    width: 100%;
+  }
+}
+</style>

frontend/src/views/GameHubView.vue

@@ -14,6 +14,7 @@ const gameId = computed(() => route.params.gameId)
 const gameName = ref('')
 const tierLists = ref([])
 const error = ref('')
+const query = ref('')
 
 function fmt(ts) {
   return new Date(ts).toLocaleString(undefined, {
@@ -37,15 +38,26 @@ function avatarFallbackOf(tierList) {
   return (tierList.authorAccountName || 'u').trim().charAt(0).toUpperCase() || '?'
 }
 
+function tierListThumbnailUrl(tierList) {
+  return tierList.thumbnailSrc ? toApiUrl(tierList.thumbnailSrc) : ''
+}
+
 onMounted(async () => {
+  await loadTierLists()
+})
+
+async function loadTierLists() {
   try {
-    const [gameRes, listRes] = await Promise.all([api.getGame(gameId.value), api.listPublicTierLists(gameId.value)])
+    const [gameRes, listRes] = await Promise.all([
+      api.getGame(gameId.value),
+      api.searchPublicTierLists(gameId.value, query.value),
+    ])
     gameName.value = gameRes.game?.name || gameId.value
     tierLists.value = listRes.tierLists || []
   } catch (e) {
     error.value = '게임 정보를 불러오지 못했어요.'
   }
-})
+}
 
 function createNew() {
   if (!auth.user) {
@@ -58,6 +70,10 @@ function createNew() {
 function openTierList(id) {
   router.push(`/editor/${gameId.value}/${id}`)
 }
+
+function submitSearch() {
+  loadTierLists()
+}
 </script>
 
 <template>
@@ -74,20 +90,37 @@ function openTierList(id) {
 
   <div v-if="error" class="error">{{ error }}</div>
   <section class="panel">
-    <div class="panel__title">공개 티어표</div>
+    <div class="panel__head">
+      <div class="panel__title">공개 티어표</div>
+      <div class="searchBar">
+        <input v-model="query" class="searchBar__input" placeholder="제목 또는 작성자 검색" @keydown.enter.prevent="submitSearch" />
+        <button class="searchBar__button" @click="submitSearch">검색</button>
+      </div>
+    </div>
     <div v-if="tierLists.length === 0" class="empty">아직 공개 티어표가 없어요.</div>
     <div v-else class="list">
-      <button v-for="t in tierLists" :key="t.id" class="row" @click="openTierList(t.id)">
-        <div class="row__head">
-          <div class="row__title">{{ t.title }}</div>
-          <div class="row__author">
-            <img v-if="avatarSrcOf(t)" class="row__avatar" :src="avatarSrcOf(t)" :alt="displayNameOf(t)" />
-            <div v-else class="row__avatar row__avatar--fallback">{{ avatarFallbackOf(t) }}</div>
-            <span>by {{ displayNameOf(t) }}</span>
+      <article v-for="t in tierLists" :key="t.id" class="row">
+        <button class="row__body" @click="openTierList(t.id)">
+          <div class="row__thumbWrap">
+            <img v-if="tierListThumbnailUrl(t)" class="row__thumb" :src="tierListThumbnailUrl(t)" :alt="t.title" />
+            <div v-else class="row__thumbPlaceholder"></div>
+          </div>
+          <div class="row__head">
+            <div class="row__title">{{ t.title }}</div>
+            <div class="row__author">
+              <img v-if="avatarSrcOf(t)" class="row__avatar" :src="avatarSrcOf(t)" :alt="displayNameOf(t)" />
+              <div v-else class="row__avatar row__avatar--fallback">{{ avatarFallbackOf(t) }}</div>
+              <span>by {{ displayNameOf(t) }}</span>
+            </div>
+          </div>
+        </button>
+        <div class="row__foot">
+          <div class="row__meta">{{ fmt(t.updatedAt) }}</div>
+          <div class="favoriteStat" :title="t.isFavorited ? '이미 즐겨찾기한 티어표' : '즐겨찾기 수'">
+            {{ t.isFavorited ? '★' : '☆' }} {{ t.favoriteCount || 0 }}
           </div>
         </div>
-        <div class="row__meta">{{ fmt(t.updatedAt) }}</div>
-      </button>
+      </article>
     </div>
   </section>
 </template>
@@ -141,8 +174,38 @@ function openTierList(id) {
 }
 .panel__title {
   font-weight: 800;
+}
+.panel__head {
+  display: flex;
+  gap: 12px;
+  align-items: center;
+  justify-content: space-between;
+  flex-wrap: wrap;
   margin-bottom: 10px;
 }
+.searchBar {
+  display: flex;
+  gap: 10px;
+  align-items: center;
+  flex-wrap: wrap;
+}
+.searchBar__input {
+  min-width: 240px;
+  padding: 10px 12px;
+  border-radius: 12px;
+  border: 1px solid rgba(255, 255, 255, 0.12);
+  background: rgba(0, 0, 0, 0.18);
+  color: rgba(255, 255, 255, 0.92);
+}
+.searchBar__button {
+  padding: 10px 12px;
+  border-radius: 12px;
+  border: 1px solid rgba(255, 255, 255, 0.14);
+  background: rgba(255, 255, 255, 0.06);
+  color: rgba(255, 255, 255, 0.92);
+  font-weight: 800;
+  cursor: pointer;
+}
 .empty {
   opacity: 0.75;
 }
@@ -152,22 +215,47 @@ function openTierList(id) {
   gap: 14px;
 }
 .row {
-  text-align: left;
-  padding: 14px;
   border-radius: 16px;
   border: 1px solid rgba(255, 255, 255, 0.12);
   background: rgba(255, 255, 255, 0.04);
   color: rgba(255, 255, 255, 0.92);
-  cursor: pointer;
-  width: 100%;
   display: grid;
   gap: 10px;
   align-content: start;
   min-height: 168px;
+  overflow: hidden;
 }
 .row:hover {
   background: rgba(255, 255, 255, 0.05);
 }
+.row__body {
+  text-align: left;
+  padding: 0;
+  border: 0;
+  background: transparent;
+  color: inherit;
+  cursor: pointer;
+  width: 100%;
+  display: grid;
+  gap: 10px;
+}
+.row__thumbWrap {
+  width: 100%;
+  aspect-ratio: 16 / 9;
+  background: rgba(255, 255, 255, 0.03);
+}
+.row__thumb {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  display: block;
+}
+.row__thumbPlaceholder {
+  width: 100%;
+  height: 100%;
+  background:
+    linear-gradient(135deg, rgba(255,255,255,0.06), rgba(255,255,255,0.02));
+}
 .row__title {
   font-weight: 800;
   min-width: 0;
@@ -175,6 +263,7 @@ function openTierList(id) {
   line-height: 1.35;
 }
 .row__head {
+  padding: 14px 14px 0;
   display: grid;
   gap: 12px;
   align-content: start;
@@ -204,8 +293,23 @@ function openTierList(id) {
 .row__meta {
   opacity: 0.78;
   font-size: 13px;
+}
+.row__foot {
+  padding: 0 14px 14px;
+  display: flex;
+  gap: 12px;
+  align-items: center;
+  justify-content: space-between;
   margin-top: auto;
 }
+.favoriteStat {
+  border: 1px solid rgba(255, 255, 255, 0.12);
+  background: rgba(255, 255, 255, 0.05);
+  color: rgba(255, 255, 255, 0.92);
+  border-radius: 999px;
+  padding: 7px 10px;
+  font-weight: 800;
+}
 @media (max-width: 1100px) {
   .list {
     grid-template-columns: repeat(2, minmax(0, 1fr));
@@ -215,5 +319,9 @@ function openTierList(id) {
   .list {
     grid-template-columns: 1fr;
   }
+  .searchBar__input {
+    min-width: 0;
+    width: 100%;
+  }
 }
 </style>

frontend/src/views/LoginView.vue

@@ -1,12 +1,14 @@
 <script setup>
-import { onMounted, ref } from 'vue'
+import { onMounted, ref, watch } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
 import { useAuthStore } from '../stores/auth'
 import { api } from '../lib/api'
+import { useToast } from '../composables/useToast'
 
 const router = useRouter()
 const route = useRoute()
 const auth = useAuthStore()
+const toast = useToast()
 
 const email = ref('')
 const password = ref('')
@@ -14,6 +16,12 @@ const mode = ref('login')
 const error = ref('')
 const hasUsers = ref(true)
 
+watch(error, (message) => {
+  if (!message) return
+  toast.error(message)
+  error.value = ''
+})
+
 onMounted(async () => {
   try {
     const meta = await api.authMeta()
@@ -46,9 +54,6 @@ async function submit() {
           회원가입
         </button>
       </div>
-
-      <div v-if="error" class="error">{{ error }}</div>
-
       <label class="label">이메일</label>
       <input v-model="email" class="input" placeholder="you@example.com" autocomplete="email" />
 
@@ -103,13 +108,6 @@ async function submit() {
   background: rgba(96, 165, 250, 0.18);
   border-color: rgba(255, 255, 255, 0.16);
 }
-.error {
-  margin-bottom: 10px;
-  padding: 10px 12px;
-  border-radius: 12px;
-  border: 1px solid rgba(239, 68, 68, 0.3);
-  background: rgba(239, 68, 68, 0.12);
-}
 .label {
   display: block;
   font-size: 13px;

frontend/src/views/MyTierListsView.vue

@@ -1,13 +1,21 @@
 <script setup>
-import { onMounted, ref } from 'vue'
+import { onMounted, ref, watch } from 'vue'
 import { useRouter } from 'vue-router'
 import { api } from '../lib/api'
 import { toApiUrl } from '../lib/runtime'
+import { useToast } from '../composables/useToast'
 
 const router = useRouter()
+const toast = useToast()
 const myLists = ref([])
 const error = ref('')
 
+watch(error, (message) => {
+  if (!message) return
+  toast.error(message)
+  error.value = ''
+})
+
 function fmt(ts) {
   return new Date(ts).toLocaleString(undefined, {
     year: 'numeric',
@@ -30,12 +38,17 @@ function avatarFallbackOf(tierList) {
   return (tierList.authorAccountName || 'u').trim().charAt(0).toUpperCase() || '?'
 }
 
+function tierListThumbnailUrl(tierList) {
+  return tierList.thumbnailSrc ? toApiUrl(tierList.thumbnailSrc) : ''
+}
+
 onMounted(async () => {
   try {
     const data = await api.listMyTierLists()
     myLists.value = data.tierLists || []
   } catch (e) {
-    error.value = '로그인이 필요해요.'
+    toast.error('로그인이 필요해요.')
+    router.push('/login?redirect=/me')
   }
 })
 
@@ -50,6 +63,7 @@ async function removeList(t) {
     if (!ok) return
     await api.deleteTierList(t.id)
     myLists.value = myLists.value.filter((entry) => entry.id !== t.id)
+    toast.success('티어표를 삭제했어요.')
   } catch (e) {
     error.value = '티어표 삭제에 실패했어요.'
   }
@@ -60,14 +74,14 @@ async function removeList(t) {
   <section class="wrap">
     <h2 class="title">내 티어표</h2>
     <div class="card">
-      <div v-if="error" class="error">
-        {{ error }}
-        <button class="link" @click="$router.push('/login')">로그인 하러가기</button>
-      </div>
       <div v-if="myLists.length === 0" class="empty">아직 저장한 티어표가 없어요.</div>
       <div v-else class="list">
         <article v-for="t in myLists" :key="t.id" class="row">
           <button class="row__body" @click="openList(t)">
+            <div class="row__thumbWrap">
+              <img v-if="tierListThumbnailUrl(t)" class="row__thumb" :src="tierListThumbnailUrl(t)" :alt="t.title" />
+              <div v-else class="row__thumbPlaceholder"></div>
+            </div>
             <div class="row__head">
               <div class="row__title">{{ t.title }}</div>
               <div class="row__author">
@@ -100,17 +114,6 @@ async function removeList(t) {
   border-radius: 16px;
   padding: 14px;
 }
-.error {
-  margin-bottom: 12px;
-  padding: 10px 12px;
-  border-radius: 12px;
-  border: 1px solid rgba(239, 68, 68, 0.3);
-  background: rgba(239, 68, 68, 0.12);
-  display: flex;
-  gap: 10px;
-  align-items: center;
-  justify-content: space-between;
-}
 .link {
   padding: 8px 10px;
   border-radius: 10px;
@@ -125,18 +128,17 @@ async function removeList(t) {
 }
 .list {
   display: grid;
-  gap: 10px;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 14px;
 }
 .row {
-  display: flex;
+  display: grid;
   gap: 10px;
-  justify-content: space-between;
-  align-items: center;
-  padding: 12px 14px;
   border-radius: 14px;
   border: 1px solid rgba(255, 255, 255, 0.10);
   background: rgba(0, 0, 0, 0.16);
   color: rgba(255, 255, 255, 0.92);
+  overflow: hidden;
 }
 .row__body {
   flex: 1 1 auto;
@@ -147,12 +149,32 @@ async function removeList(t) {
   background: transparent;
   color: inherit;
   padding: 0;
+  display: grid;
+  gap: 10px;
+}
+.row__thumbWrap {
+  width: 100%;
+  aspect-ratio: 16 / 9;
+  background: rgba(255, 255, 255, 0.03);
+}
+.row__thumb {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  display: block;
+}
+.row__thumbPlaceholder {
+  width: 100%;
+  height: 100%;
+  background:
+    linear-gradient(135deg, rgba(255,255,255,0.06), rgba(255,255,255,0.02));
 }
 .row__title {
   font-weight: 900;
   min-width: 0;
 }
 .row__head {
+  padding: 0 14px;
   display: flex;
   gap: 12px;
   align-items: center;
@@ -181,6 +203,7 @@ async function removeList(t) {
   font-weight: 900;
 }
 .row__meta {
+  padding: 0 14px;
   margin-top: 6px;
   opacity: 0.76;
   font-size: 13px;
@@ -188,5 +211,16 @@ async function removeList(t) {
 .link--danger {
   background: rgba(239, 68, 68, 0.14);
   border-color: rgba(239, 68, 68, 0.28);
+  margin: 0 14px 14px;
+}
+@media (max-width: 1100px) {
+  .list {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+}
+@media (max-width: 720px) {
+  .list {
+    grid-template-columns: 1fr;
+  }
 }
 </style>

frontend/src/views/ProfileView.vue

@@ -1,11 +1,13 @@
 <script setup>
-import { computed, onMounted, ref } from 'vue'
+import { computed, onMounted, ref, watch } from 'vue'
 import { useRouter } from 'vue-router'
 import { useAuthStore } from '../stores/auth'
 import { toApiUrl } from '../lib/runtime'
+import { useToast } from '../composables/useToast'
 
 const router = useRouter()
 const auth = useAuthStore()
+const toast = useToast()
 
 const error = ref('')
 const saving = ref(false)
@@ -13,6 +15,12 @@ const nickname = ref('')
 const previewUrl = ref('')
 const avatarFile = ref(null)
 
+watch(error, (message) => {
+  if (!message) return
+  toast.error(message)
+  error.value = ''
+})
+
 const avatarUrl = computed(() => {
   if (previewUrl.value) return previewUrl.value
   if (!auth.user?.avatarSrc) return ''
@@ -55,6 +63,7 @@ async function saveProfile() {
       URL.revokeObjectURL(previewUrl.value)
       previewUrl.value = ''
     }
+    toast.success('프로필을 저장했어요.')
   } catch (e2) {
     error.value = '프로필 저장에 실패했어요.'
   } finally {
@@ -66,7 +75,6 @@ async function saveProfile() {
 <template>
   <section class="wrap">
     <h2 class="title">프로필</h2>
-    <div v-if="error" class="error">{{ error }}</div>
 
     <div class="card" v-if="auth.user">
       <div class="row">
@@ -102,13 +110,6 @@ async function saveProfile() {
   font-size: 26px;
   letter-spacing: -0.02em;
 }
-.error {
-  margin-bottom: 10px;
-  padding: 10px 12px;
-  border-radius: 12px;
-  border: 1px solid rgba(239, 68, 68, 0.3);
-  background: rgba(239, 68, 68, 0.12);
-}
 .card {
   max-width: 520px;
   border: 1px solid rgba(255, 255, 255, 0.12);

frontend/src/views/TierEditorView.vue

@@ -1,15 +1,17 @@
 <script setup>
-import { computed, nextTick, onMounted, onUnmounted, ref } from 'vue'
+import { computed, nextTick, onMounted, onUnmounted, ref, watch } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
 import Sortable from 'sortablejs'
 import * as htmlToImage from 'html-to-image'
 import { api } from '../lib/api'
 import { toApiUrl } from '../lib/runtime'
 import { useAuthStore } from '../stores/auth'
+import { useToast } from '../composables/useToast'
 
 const route = useRoute()
 const router = useRouter()
 const auth = useAuthStore()
+const toast = useToast()
 const gameId = computed(() => route.params.gameId)
 const tierListId = computed(() => route.params.tierListId)
 const gameName = ref('')
@@ -26,6 +28,9 @@ const pool = ref([])
 const itemsById = ref({})
 
 const title = ref('')
+const thumbnailSrc = ref('')
+const pendingThumbnailFile = ref(null)
+const thumbnailPreviewUrl = ref('')
 const description = ref('')
 const isPublic = ref(true)
 const error = ref('')
@@ -38,6 +43,10 @@ const authorAccountName = ref('')
 const updatedAt = ref(0)
 const isDragActive = ref(false)
 const iconSize = ref(80)
+const isFavoriteBusy = ref(false)
+const favoriteCount = ref(0)
+const isFavorited = ref(false)
+const isRequestingTemplate = ref(false)
 
 const boardEl = ref(null)
 const exportBoardEl = ref(null)
@@ -45,13 +54,14 @@ const groupListEl = ref(null)
 const poolEl = ref(null)
 const groupDropEls = ref({})
 const fileEl = ref(null)
+const thumbnailFileEl = ref(null)
 const groupSortable = ref(null)
 const poolSortable = ref(null)
 const dropSortables = ref([])
 
 const isNewTierList = computed(() => tierListId.value === 'new')
 const canEdit = computed(() => !!auth.user && (!ownerId.value || ownerId.value === auth.user.id))
-const iconSizeOptions = [48, 60, 80, 100, 120]
+const iconSizeOptions = [48, 64, 80, 96, 112]
 const hasCustomTitle = computed(() => !!(title.value || '').trim())
 const fallbackTimestamp = computed(() => (updatedAt.value ? updatedAt.value : Date.now()))
 const effectiveAuthorName = computed(() => {
@@ -65,14 +75,34 @@ const effectiveAuthorName = computed(() => {
 const effectiveTitle = computed(() => {
   const customTitle = (title.value || '').trim()
   if (customTitle) return customTitle
-  return `이름 없음 ${formatTitleDate(fallbackTimestamp.value)}`
+  return (gameName.value || gameId.value || 'Tier Maker').trim()
 })
+const displayThumbnailUrl = computed(() => thumbnailPreviewUrl.value || (thumbnailSrc.value ? resolveItemSrc({ src: thumbnailSrc.value }) : ''))
 const untitledWarning = computed(
   () =>
     canEdit.value &&
     !hasCustomTitle.value &&
     '제목 없이 저장된 티어표는 무분별한 도배 방지를 위해 관리자에 의해 임의 삭제될 수 있어요.'
 )
+const canFavorite = computed(() => !!auth.user && !isNewTierList.value && !canEdit.value)
+const customItems = computed(() =>
+  Object.values(itemsById.value)
+    .filter((item) => item?.origin === 'custom')
+    .sort((a, b) => (a.label || '').localeCompare(b.label || '', 'ko'))
+)
+const hasPlacedItems = computed(() => groups.value.some((group) => (group.itemIds || []).length > 0))
+const canRequestTemplateCreate = computed(
+  () => canEdit.value && !isNewTierList.value && gameId.value === 'freeform' && !hasPlacedItems.value && customItems.value.length > 0
+)
+const canRequestTemplateUpdate = computed(
+  () => canEdit.value && !isNewTierList.value && gameId.value !== 'freeform' && customItems.value.length > 0
+)
+
+watch(error, (message) => {
+  if (!message) return
+  toast.error(message)
+  error.value = ''
+})
 
 function formatTitleDate(ts) {
   const date = new Date(ts)
@@ -98,6 +128,15 @@ function setIconSize(nextSize) {
   iconSize.value = nextSize
 }
 
+function removeItemFromGroup(groupId, itemId) {
+  if (!canEdit.value || !groupId || !itemId) return
+  const targetGroup = groups.value.find((group) => group.id === groupId)
+  if (!targetGroup) return
+  if (!targetGroup.itemIds.includes(itemId)) return
+  targetGroup.itemIds = targetGroup.itemIds.filter((id) => id !== itemId)
+  pool.value = [itemId, ...pool.value.filter((id) => id !== itemId)]
+}
+
 function setGroupDropEl(groupId, el) {
   if (!el) {
     delete groupDropEls.value[groupId]
@@ -232,11 +271,48 @@ function addCustomImage(file) {
   pool.value = [id, ...pool.value]
 }
 
+function updateCustomItemLabel(itemId, nextLabel) {
+  const item = itemsById.value[itemId]
+  if (!item || item.origin !== 'custom') return
+  itemsById.value = {
+    ...itemsById.value,
+    [itemId]: {
+      ...item,
+      label: nextLabel.slice(0, 60),
+    },
+  }
+}
+
 function openFile() {
   if (!canEdit.value) return
   fileEl.value?.click()
 }
 
+function openThumbnailFile() {
+  if (!canEdit.value) return
+  thumbnailFileEl.value?.click()
+}
+
+function onThumbnailChange(event) {
+  const file = event.target.files?.[0]
+  if (thumbnailPreviewUrl.value) {
+    URL.revokeObjectURL(thumbnailPreviewUrl.value)
+    thumbnailPreviewUrl.value = ''
+  }
+  pendingThumbnailFile.value = file || null
+  if (file) thumbnailPreviewUrl.value = URL.createObjectURL(file)
+  event.target.value = ''
+}
+
+function clearThumbnail() {
+  if (thumbnailPreviewUrl.value) {
+    URL.revokeObjectURL(thumbnailPreviewUrl.value)
+    thumbnailPreviewUrl.value = ''
+  }
+  pendingThumbnailFile.value = null
+  thumbnailSrc.value = ''
+}
+
 function onFileChange(e) {
   const files = Array.from(e.target.files || [])
   if (!files.length) return
@@ -322,12 +398,25 @@ async function uploadPendingCustomItems() {
   }
 }
 
+async function uploadPendingThumbnail() {
+  if (!pendingThumbnailFile.value) return thumbnailSrc.value || ''
+  const data = await api.uploadTierListThumbnail(pendingThumbnailFile.value)
+  if (thumbnailPreviewUrl.value) {
+    URL.revokeObjectURL(thumbnailPreviewUrl.value)
+    thumbnailPreviewUrl.value = ''
+  }
+  pendingThumbnailFile.value = null
+  thumbnailSrc.value = data.thumbnailSrc || ''
+  return thumbnailSrc.value
+}
+
 function buildPayload(existingId) {
   const finalTitle = effectiveTitle.value
   return {
     id: existingId || undefined,
     gameId: gameId.value,
     title: finalTitle,
+    thumbnailSrc: thumbnailSrc.value || '',
     description: (description.value || '').trim(),
     isPublic: !!isPublic.value,
     groups: groups.value.map((g) => ({ id: g.id, name: g.name, itemIds: g.itemIds })),
@@ -335,18 +424,26 @@ function buildPayload(existingId) {
   }
 }
 
+async function persistTierList({ showModal = false } = {}) {
+  await uploadPendingCustomItems()
+  await uploadPendingThumbnail()
+  const payload = buildPayload(tierListId.value && tierListId.value !== 'new' ? tierListId.value : null)
+  const res = await api.saveTierList(payload)
+  if (tierListId.value === 'new') history.replaceState({}, '', `/editor/${gameId.value}/${res.tierList.id}`)
+  updatedAt.value = Number(res.tierList?.updatedAt || Date.now())
+  authorName.value = res.tierList?.authorName || effectiveAuthorName.value
+  authorAccountName.value = res.tierList?.authorAccountName || authorAccountName.value
+  favoriteCount.value = Number(res.tierList?.favoriteCount || favoriteCount.value || 0)
+  isFavorited.value = !!res.tierList?.isFavorited
+  if (showModal) isSaveModalOpen.value = true
+  return res
+}
+
 async function save() {
   error.value = ''
   isSaving.value = true
   try {
-    await uploadPendingCustomItems()
-    const payload = buildPayload(tierListId.value && tierListId.value !== 'new' ? tierListId.value : null)
-    const res = await api.saveTierList(payload)
-    if (tierListId.value === 'new') history.replaceState({}, '', `/editor/${gameId.value}/${res.tierList.id}`)
-    updatedAt.value = Number(res.tierList?.updatedAt || Date.now())
-    authorName.value = res.tierList?.authorName || effectiveAuthorName.value
-    authorAccountName.value = res.tierList?.authorAccountName || authorAccountName.value
-    isSaveModalOpen.value = true
+    await persistTierList({ showModal: true })
   } catch (e) {
     error.value = '저장 실패: 로그인 상태인지 확인해주세요.'
   } finally {
@@ -365,12 +462,54 @@ async function removeTierList() {
     const ok = window.confirm(`"${title.value || gameName.value || '이 티어표'}"를 삭제할까요?`)
     if (!ok) return
     await api.deleteTierList(tierListId.value)
+    toast.success('티어표를 삭제했어요.')
     router.push(gameId.value === 'freeform' ? '/me' : `/games/${gameId.value}`)
   } catch (e) {
     error.value = '티어표 삭제에 실패했어요.'
   }
 }
 
+async function toggleFavorite() {
+  if (!canFavorite.value || isFavoriteBusy.value) return
+  try {
+    isFavoriteBusy.value = true
+    const data = isFavorited.value ? await api.unfavoriteTierList(tierListId.value) : await api.favoriteTierList(tierListId.value)
+    favoriteCount.value = Number(data.tierList?.favoriteCount || 0)
+    isFavorited.value = !!data.tierList?.isFavorited
+    toast.success(isFavorited.value ? '즐겨찾기에 추가했어요.' : '즐겨찾기를 해제했어요.')
+  } catch (e) {
+    error.value = '즐겨찾기 처리에 실패했어요.'
+  } finally {
+    isFavoriteBusy.value = false
+  }
+}
+
+async function requestTemplate(type) {
+  if (isNewTierList.value) {
+    toast.error('요청 전에 먼저 티어표를 저장해주세요.')
+    return
+  }
+
+  try {
+    isRequestingTemplate.value = true
+    await persistTierList({ showModal: false })
+    await api.requestTierListTemplate(tierListId.value, { type })
+    toast.success(type === 'create' ? '템플릿 등록 요청을 보냈어요.' : '템플릿 업데이트 요청을 보냈어요.')
+  } catch (e) {
+    if (e?.status === 409) {
+      toast.error('이미 처리 대기 중인 같은 요청이 있어요.')
+      return
+    }
+    if (e?.status === 400 && e?.data?.error === 'board_must_be_empty') {
+      toast.error('템플릿 등록 요청은 보드를 비운 상태에서만 보낼 수 있어요.')
+      return
+    }
+    toast.error(type === 'create' ? '템플릿 등록 요청에 실패했어요.' : '템플릿 업데이트 요청에 실패했어요.')
+  } finally {
+    isRequestingTemplate.value = false
+  }
+}
+
 onMounted(() => {
   ;(async () => {
     await auth.refresh()
@@ -405,11 +544,14 @@ onMounted(() => {
         const t = res.tierList
         ownerId.value = t.authorId
         title.value = t.title
+        thumbnailSrc.value = t.thumbnailSrc || ''
         description.value = t.description || ''
         isPublic.value = !!t.isPublic
         authorName.value = t.authorName || ''
         authorAccountName.value = t.authorAccountName || ''
         updatedAt.value = Number(t.updatedAt || 0)
+        favoriteCount.value = Number(t.favoriteCount || 0)
+        isFavorited.value = !!t.isFavorited
         groups.value = t.groups
         const map = {}
         ;(t.pool || []).forEach((it) => (map[it.id] = it))
@@ -430,29 +572,48 @@ onMounted(() => {
 })
 
 onUnmounted(() => {
+  if (thumbnailPreviewUrl.value) URL.revokeObjectURL(thumbnailPreviewUrl.value)
   destroySortables()
 })
 </script>
 
 <template>
   <section class="head">
-    <div class="head__meta">
-      <div class="kicker">{{ gameName || gameId }}</div>
-      <input v-model="title" class="titleInput" placeholder="티어표 이름을 입력하세요" :readonly="!canEdit" />
-      <div v-if="untitledWarning" class="titleNotice">{{ untitledWarning }}</div>
-      <input
-        v-model="description"
-        class="descInput"
-        placeholder="설명(선택): 이 티어표의 기준/룰"
-        :readonly="!canEdit"
-      />
-      <div class="hint">
-        <template v-if="canEdit">
-          그룹 이름/순서 변경과 아이템 드래그&드롭이 가능합니다. 저장하려면 <b>저장</b>을 누르세요.
-        </template>
-        <template v-else>
-          공개된 티어표를 보는 중입니다. 로그인한 작성자만 수정할 수 있어요.
-        </template>
+    <div class="heroCard">
+      <div class="heroCard__main">
+        <input v-model="title" class="titleInput" placeholder="티어표 이름을 입력하세요" :readonly="!canEdit" />
+        <div v-if="untitledWarning" class="titleNotice">{{ untitledWarning }}</div>
+        <input
+          v-model="description"
+          class="descInput"
+          placeholder="설명(선택): 이 티어표의 기준/룰"
+          :readonly="!canEdit"
+        />
+        <div class="hint">
+          <template v-if="canEdit">
+            그룹 이름/순서 변경과 아이템 드래그&드롭이 가능합니다. 저장하려면 <b>저장</b>을 누르세요.
+          </template>
+          <template v-else>
+            공개된 티어표를 보는 중입니다. 로그인한 작성자만 수정할 수 있어요.
+          </template>
+        </div>
+      </div>
+      <div class="heroCard__side">
+        <div class="thumbComposer">
+          <input ref="thumbnailFileEl" type="file" accept="image/*" class="hidden" @change="onThumbnailChange" />
+          <div class="thumbComposer__header">
+            <div class="thumbComposer__eyebrow">대표 썸네일</div>
+            <div class="thumbComposer__caption">목록 카드 상단에 표시됩니다.</div>
+          </div>
+          <div class="thumbComposer__preview">
+            <img v-if="displayThumbnailUrl" class="thumbComposer__image" :src="displayThumbnailUrl" alt="썸네일 미리보기" />
+            <div v-else class="thumbComposer__empty">썸네일 없음</div>
+          </div>
+          <div v-if="canEdit" class="thumbComposer__actions">
+            <button class="btn btn--ghost thumbComposer__button" @click="openThumbnailFile">썸네일 선택</button>
+            <button class="btn btn--danger thumbComposer__button" :disabled="!pendingThumbnailFile && !thumbnailSrc" @click="clearThumbnail">제거</button>
+          </div>
+        </div>
       </div>
     </div>
     <div class="actions">
@@ -461,6 +622,25 @@ onUnmounted(() => {
         <button v-if="canEdit && !isNewTierList" class="btn btn--danger" @click="removeTierList">삭제</button>
       </div>
       <div class="actions__right">
+        <button v-if="canFavorite" class="btn btn--ghost" :disabled="isFavoriteBusy" @click="toggleFavorite">
+          {{ isFavorited ? '★ 즐겨찾기' : '☆ 즐겨찾기' }} {{ favoriteCount }}
+        </button>
+        <button
+          v-if="canRequestTemplateCreate"
+          class="btn btn--ghost"
+          :disabled="isRequestingTemplate"
+          @click="requestTemplate('create')"
+        >
+          {{ isRequestingTemplate ? '요청중...' : '템플릿 등록 요청' }}
+        </button>
+        <button
+          v-if="canRequestTemplateUpdate"
+          class="btn btn--ghost"
+          :disabled="isRequestingTemplate"
+          @click="requestTemplate('update')"
+        >
+          {{ isRequestingTemplate ? '요청중...' : '템플릿 업데이트 요청' }}
+        </button>
         <label class="toggle" :class="{ 'toggle--disabled': !canEdit }">
         <input v-model="isPublic" type="checkbox" :disabled="!canEdit" />
           <span>{{ isPublic ? '공개 ON' : '공개 OFF' }}</span>
@@ -470,8 +650,6 @@ onUnmounted(() => {
     </div>
   </section>
 
-  <div v-if="error" class="error">{{ error }}</div>
-
   <div v-if="isSaveModalOpen" class="modalOverlay" @click.self="closeSaveModal">
     <div class="modalCard" role="dialog" aria-modal="true" aria-labelledby="saveModalTitle">
       <div id="saveModalTitle" class="modalCard__title">저장 완료</div>
@@ -527,6 +705,16 @@ onUnmounted(() => {
             <div v-if="!isExporting" class="row__empty" v-show="g.itemIds.length === 0">여기로 드래그해서 배치</div>
             <div v-for="id in g.itemIds" :key="id" class="cell" :data-item-id="id">
               <img :src="resolveItemSrc(itemsById[id])" class="thumb" :alt="itemsById[id]?.label || id" />
+              <button
+                v-if="canEdit && !isExporting"
+                class="cellRemoveBtn"
+                type="button"
+                title="아이템 빼내기"
+                @pointerdown.stop
+                @click.stop="removeItemFromGroup(g.id, id)"
+              >
+                ×
+              </button>
             </div>
           </div>
         </div>
@@ -549,6 +737,24 @@ onUnmounted(() => {
           <div class="poolItem__label">{{ itemsById[id]?.label || id }}</div>
         </div>
       </div>
+      <div v-if="canEdit && customItems.length" class="customItemEditor">
+        <div class="customItemEditor__title">추가한 커스텀 아이템 이름 정리</div>
+        <div class="customItemEditor__desc">
+          템플릿 요청 전에 이름을 정리해두면 관리자가 그대로 기본 템플릿으로 반영할 수 있어요.
+        </div>
+        <div class="customItemEditor__list">
+          <label v-for="item in customItems" :key="item.id" class="customItemEditor__row">
+            <img class="customItemEditor__thumb" :src="resolveItemSrc(item)" :alt="item.label" />
+            <input
+              class="customItemEditor__input"
+              :value="item.label"
+              maxlength="60"
+              placeholder="아이템 이름"
+              @input="updateCustomItemLabel(item.id, $event.target.value)"
+            />
+          </label>
+        </div>
+      </div>
       <div
         v-if="canEdit"
         class="dropzone"
@@ -573,30 +779,41 @@ onUnmounted(() => {
   gap: 14px;
   padding: 6px 2px 14px;
 }
-.head__meta {
+.heroCard {
   display: grid;
-  gap: 10px;
+  grid-template-columns: minmax(0, 1.5fr) minmax(280px, 360px);
+  gap: 18px;
+  align-items: stretch;
 }
-.kicker {
-  font-size: 12px;
-  opacity: 0.7;
+.heroCard__main,
+.heroCard__side {
+  min-width: 0;
+}
+.heroCard__main {
+  display: grid;
+  gap: 12px;
+}
+.heroCard__side {
+  display: flex;
 }
 .titleInput {
-  width: min(100%, 920px);
+  width: 100%;
   font-size: 22px;
   font-weight: 800;
   letter-spacing: -0.02em;
-  padding: 10px 12px;
-  border-radius: 14px;
+  padding: 14px 16px;
+  border-radius: 18px;
   border: 1px solid rgba(255, 255, 255, 0.12);
-  background: rgba(255, 255, 255, 0.04);
+  background: linear-gradient(180deg, rgba(255, 255, 255, 0.07), rgba(255, 255, 255, 0.04));
   color: rgba(255, 255, 255, 0.92);
   outline: none;
+  box-sizing: border-box;
 }
 .descInput {
-  width: min(100%, 920px);
-  padding: 10px 12px;
-  border-radius: 14px;
+  width: 100%;
+  min-height: 92px;
+  padding: 14px 16px;
+  border-radius: 18px;
   border: 1px solid rgba(255, 255, 255, 0.12);
   background: rgba(0, 0, 0, 0.18);
   color: rgba(255, 255, 255, 0.92);
@@ -606,11 +823,69 @@ onUnmounted(() => {
 .hint {
   opacity: 0.78;
   font-size: 13px;
+  line-height: 1.6;
+  padding: 0 2px;
 }
 .titleNotice {
   font-size: 13px;
   line-height: 1.5;
   color: rgba(251, 191, 36, 0.94);
+  padding: 0 2px;
+}
+.thumbComposer {
+  display: grid;
+  gap: 10px;
+  width: 100%;
+  padding: 16px;
+  border-radius: 22px;
+  border: 1px solid rgba(255, 255, 255, 0.12);
+  background:
+    radial-gradient(circle at top right, rgba(96, 165, 250, 0.12), transparent 46%),
+    rgba(255, 255, 255, 0.04);
+  box-sizing: border-box;
+}
+.thumbComposer__header {
+  display: grid;
+  gap: 4px;
+}
+.thumbComposer__eyebrow {
+  font-size: 13px;
+  font-weight: 900;
+  letter-spacing: 0.02em;
+}
+.thumbComposer__caption {
+  font-size: 12px;
+  opacity: 0.68;
+}
+.thumbComposer__preview {
+  width: 100%;
+  aspect-ratio: 16 / 9;
+  border-radius: 18px;
+  overflow: hidden;
+  border: 1px solid rgba(255, 255, 255, 0.12);
+  background: rgba(11, 18, 32, 0.78);
+}
+.thumbComposer__image {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+}
+.thumbComposer__empty {
+  width: 100%;
+  height: 100%;
+  display: grid;
+  place-items: center;
+  color: rgba(255, 255, 255, 0.62);
+  font-size: 13px;
+}
+.thumbComposer__actions {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 10px;
+}
+.thumbComposer__button {
+  width: 100%;
+  margin-top: 0;
 }
 .actions {
   display: flex;
@@ -687,7 +962,7 @@ onUnmounted(() => {
 }
 .btn--ghost {
   width: 100%;
-  margin-top: 10px;
+  margin-top: 0;
 }
 .layout {
   display: grid;
@@ -912,6 +1187,29 @@ onUnmounted(() => {
 .cell {
   display: inline-flex;
   flex: 0 0 auto;
+  position: relative;
+}
+.cellRemoveBtn {
+  position: absolute;
+  top: -6px;
+  right: -6px;
+  width: 24px;
+  height: 24px;
+  display: grid;
+  place-items: center;
+  border-radius: 999px;
+  border: 1px solid rgba(239, 68, 68, 0.32);
+  background: rgba(11, 18, 32, 0.92);
+  color: rgba(255, 255, 255, 0.92);
+  font-size: 16px;
+  line-height: 1;
+  font-weight: 900;
+  cursor: pointer;
+  z-index: 2;
+  box-shadow: 0 8px 18px rgba(0, 0, 0, 0.24);
+}
+.cellRemoveBtn:hover {
+  background: rgba(239, 68, 68, 0.9);
 }
 .thumb {
   width: var(--thumb-size, 80px);
@@ -936,6 +1234,51 @@ onUnmounted(() => {
   font-size: 13px;
   margin-bottom: 10px;
 }
+.customItemEditor {
+  margin-top: 12px;
+  padding: 12px;
+  border-radius: 16px;
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  background: rgba(255, 255, 255, 0.03);
+}
+.customItemEditor__title {
+  font-weight: 900;
+}
+.customItemEditor__desc {
+  margin-top: 6px;
+  font-size: 12px;
+  line-height: 1.5;
+  opacity: 0.72;
+}
+.customItemEditor__list {
+  margin-top: 12px;
+  display: grid;
+  gap: 10px;
+}
+.customItemEditor__row {
+  display: grid;
+  grid-template-columns: 44px minmax(0, 1fr);
+  gap: 10px;
+  align-items: center;
+}
+.customItemEditor__thumb {
+  width: 44px;
+  height: 44px;
+  border-radius: 10px;
+  object-fit: cover;
+  border: 1px solid rgba(255, 255, 255, 0.14);
+}
+.customItemEditor__input {
+  width: 100%;
+  min-width: 0;
+  padding: 9px 10px;
+  border-radius: 12px;
+  border: 1px solid rgba(255, 255, 255, 0.12);
+  background: rgba(0, 0, 0, 0.18);
+  color: rgba(255, 255, 255, 0.92);
+  outline: none;
+  box-sizing: border-box;
+}
 .dropzone {
   margin-top: 12px;
   padding: 14px;
@@ -986,6 +1329,9 @@ onUnmounted(() => {
   border-radius: 14px;
 }
 @media (max-width: 980px) {
+  .heroCard {
+    grid-template-columns: 1fr;
+  }
   .layout {
     grid-template-columns: 1fr;
   }
@@ -1002,5 +1348,13 @@ onUnmounted(() => {
   .row {
     grid-template-columns: 150px 1fr;
   }
+  .thumbComposer {
+    padding: 14px;
+    border-radius: 18px;
+  }
+  .titleInput,
+  .descInput {
+    border-radius: 16px;
+  }
 }
 </style>