태그 헤더 이미지 설정 추가

server/utils/admin-tag-input.js

@@ -4,6 +4,9 @@ export const adminTagInputSchema = z.object({
   name: z.string().trim().min(1),
   slug: z.string().trim().min(1).regex(/^[a-z0-9가-힣]+(?:-[a-z0-9가-힣]+)*$/),
   description: z.string().default(''),
+  headerImageUrl: z.string().trim().max(500).optional().default(''),
+  headerTitle: z.string().trim().max(120).optional().default(''),
+  headerText: z.string().trim().max(280).optional().default(''),
   sortOrder: z.number().int().min(0).default(0),
   color: z.string().trim().regex(/^#[0-9a-fA-F]{6}$/).default('#15171a'),
   tagType: z.enum(['managed', 'general']).default('managed')

server/utils/media-library.js

@@ -1,7 +1,7 @@
 import { readdir, rename, rm, stat } from 'node:fs/promises'
 import { basename, dirname, extname, join, relative } from 'node:path'
 import { createError } from 'h3'
-import { getSiteSettings, listAdminPosts, listPages } from '../repositories/content-repository'
+import { getSiteSettings, listAdminPosts, listAdminTags, listPages } from '../repositories/content-repository'
 import { getPostgresClient } from '../repositories/postgres-client'
 import {
   getPostThumbnailUrl,
@@ -506,17 +506,40 @@ const getMediaUsage = (url, posts, pages) => {
   return [...postUsages, ...pageUsages]
 }
 
+/**
+ * 태그 헤더 이미지 사용처 조회
+ * @param {string} url - 미디어 URL
+ * @param {Array<Object>} tags - 태그 목록
+ * @returns {Array<Object>} 사용처 목록
+ */
+const getTagMediaUsage = (url, tags) => tags
+  .filter((tag) => tag.headerImageUrl === url)
+  .map((tag) => ({
+    type: 'tag',
+    typeLabel: '태그',
+    id: tag.id,
+    title: tag.name,
+    slug: tag.slug,
+    adminUrl: `/admin/tags/${tag.id}`,
+    publicUrl: `/tag/${tag.slug}`,
+    status: tag.tagType,
+    location: 'headerImageUrl',
+    label: '태그 헤더 이미지'
+  }))
+
 /**
  * 미디어 URL이 실제 사용처에서 쓰이는지 조회한다.
  * @param {string} url - 미디어 URL
  * @param {Array<Object>} posts - 게시물 목록
  * @param {Array<Object>} pages - 페이지 목록
  * @param {Object} siteSettings - 사이트 설정
+ * @param {Array<Object>} tags - 태그 목록
  * @returns {Array<Object>} 사용처 목록
  */
-const getDirectMediaUsage = (url, posts, pages, siteSettings) => [
+const getDirectMediaUsage = (url, posts, pages, siteSettings, tags = []) => [
   ...getMediaUsage(url, posts, pages),
-  ...getSiteSettingsMediaUsage(url, siteSettings)
+  ...getSiteSettingsMediaUsage(url, siteSettings),
+  ...getTagMediaUsage(url, tags)
 ]
 
 /**
@@ -673,10 +696,11 @@ const getSiteSettingsMediaUsage = (url, siteSettings) => {
 export const listMediaItems = async () => {
   const items = await readMediaDirectory(uploadRoot)
   const metadataMap = await getMediaMetadataMap()
-  const [posts, pages, siteSettings] = await Promise.all([
+  const [posts, pages, siteSettings, tags] = await Promise.all([
     listAdminPosts(),
     listPages(),
-    getSiteSettings()
+    getSiteSettings(),
+    listAdminTags()
   ])
   const avatarOwnerByUrl = await getAvatarOwnersByUrls(items.map((item) => item.url))
   const itemUrlSet = new Set(items.map((item) => item.url))
@@ -685,7 +709,7 @@ export const listMediaItems = async () => {
     const rawCategory = metadataMap[item.url]?.category ?? item.category
     const category = normalizeStoredDisplayCategory(item.url, rawCategory)
     const avatarOwner = avatarOwnerByUrl.get(item.url) || null
-    const directUsage = getDirectMediaUsage(item.url, posts, pages, siteSettings)
+    const directUsage = getDirectMediaUsage(item.url, posts, pages, siteSettings, tags)
     const thumbnailUsage = getPostThumbnailMediaUsage(item.url, thumbnailOwnerByUrl, posts, pages, siteSettings)
     const originalUrl = thumbnailOwnerByUrl.get(item.url) || ''
 
@@ -818,13 +842,14 @@ export const updateMediaCategories = async (urls, category) => {
  * @returns {Promise<void>}
  */
 export const deleteMediaItem = async (url) => {
-  const [posts, pages, siteSettings] = await Promise.all([
+  const [posts, pages, siteSettings, tags] = await Promise.all([
     listAdminPosts(),
     listPages(),
-    getSiteSettings()
+    getSiteSettings(),
+    listAdminTags()
   ])
   const usage = [
-    ...getDirectMediaUsage(url, posts, pages, siteSettings),
+    ...getDirectMediaUsage(url, posts, pages, siteSettings, tags),
     ...getPostThumbnailMediaUsage(url, buildPostThumbnailOwnerMap(await readMediaDirectory(uploadRoot)), posts, pages, siteSettings)
   ]
 
@@ -860,13 +885,14 @@ export const renameMediaItem = async (url, name) => {
     })
   }
 
-  const [posts, pages, siteSettings] = await Promise.all([
+  const [posts, pages, siteSettings, tags] = await Promise.all([
     listAdminPosts(),
     listPages(),
-    getSiteSettings()
+    getSiteSettings(),
+    listAdminTags()
   ])
   const usage = [
-    ...getDirectMediaUsage(url, posts, pages, siteSettings),
+    ...getDirectMediaUsage(url, posts, pages, siteSettings, tags),
     ...getPostThumbnailMediaUsage(url, buildPostThumbnailOwnerMap(await readMediaDirectory(uploadRoot)), posts, pages, siteSettings)
   ]