feat(member): 썸네일 교체/삭제 시 자산 자동 정리 추가

회원 아바타를 교체·삭제·탈퇴하는 흐름에서 이전 썸네일 파일과 메타데이터가 남지 않도록 공통 정리 로직을 연결했다.

Co-authored-by: Cursor <cursoragent@cursor.com>

server/api/auth/account.delete.js

@@ -3,6 +3,7 @@ import { createError, readBody } from 'h3'
 import { z } from 'zod'
 import { deleteMember, getUserByIdWithPassword } from '../../repositories/member-repository'
 import { clearMemberSession, requireMemberSession } from '../../utils/member-auth'
+import { removeManagedAvatarAsset } from '../../utils/member-avatar'
 
 const deleteAccountSchema = z.object({
   password: z.string().min(1)
@@ -40,6 +41,10 @@ export default defineEventHandler(async (event) => {
     })
   }
 
+  if (user.avatarUrl) {
+    await removeManagedAvatarAsset(user.avatarUrl)
+  }
+
   await deleteMember(session.userId)
   clearMemberSession(event)
 

server/api/auth/avatar.delete.js

@@ -0,0 +1,34 @@
+import { createError } from 'h3'
+import { getUserById, updateMemberProfile } from '../../repositories/member-repository'
+import { requireMemberSession } from '../../utils/member-auth'
+import { removeManagedAvatarAsset } from '../../utils/member-avatar'
+
+/**
+ * 회원 썸네일 삭제 API
+ * @param {import('h3').H3Event} event - 요청 이벤트
+ * @returns {Promise<{ ok: true }>} 처리 결과
+ */
+export default defineEventHandler(async (event) => {
+  const session = requireMemberSession(event)
+  const user = await getUserById(session.userId)
+
+  if (!user) {
+    throw createError({
+      statusCode: 404,
+      message: '회원 정보를 찾을 수 없습니다.'
+    })
+  }
+
+  if (user.avatarUrl) {
+    await removeManagedAvatarAsset(user.avatarUrl)
+  }
+
+  await updateMemberProfile({
+    userId: user.id,
+    username: user.username,
+    avatarUrl: ''
+  })
+
+  return { ok: true }
+})
+

server/api/auth/avatar.post.js

@@ -5,6 +5,7 @@ import { createError, readMultipartFormData } from 'h3'
 import { getPostgresClient } from '../../repositories/postgres-client'
 import { updateMemberProfile, getUserById } from '../../repositories/member-repository'
 import { requireMemberSession } from '../../utils/member-auth'
+import { removeManagedAvatarAsset } from '../../utils/member-avatar'
 
 const allowedImageTypes = new Map([
   ['image/jpeg', '.jpg'],
@@ -114,6 +115,10 @@ export default defineEventHandler(async (event) => {
     `
   }
 
+  if (currentUser.avatarUrl && currentUser.avatarUrl !== avatarUrl) {
+    await removeManagedAvatarAsset(currentUser.avatarUrl)
+  }
+
   return {
     avatarUrl
   }

server/utils/member-avatar.js

@@ -0,0 +1,66 @@
+import { rm } from 'node:fs/promises'
+import { join, relative } from 'node:path'
+import { createError } from 'h3'
+import { getPostgresClient } from '../repositories/postgres-client'
+
+const managedAvatarPrefix = '/uploads/members/avatars/'
+
+/**
+ * 회원 전용 썸네일 URL인지 확인한다.
+ * @param {string} url - 대상 URL
+ * @returns {boolean} 회원 썸네일 여부
+ */
+export const isManagedAvatarUrl = (url) => String(url || '').startsWith(managedAvatarPrefix)
+
+/**
+ * 회원 썸네일 URL을 실제 파일 경로로 변환한다.
+ * @param {string} url - 썸네일 URL
+ * @returns {string} 파일 시스템 경로
+ */
+export const resolveMemberAvatarPath = (url) => {
+  if (!isManagedAvatarUrl(url)) {
+    throw createError({
+      statusCode: 400,
+      message: '회원 썸네일 경로가 아닙니다.'
+    })
+  }
+
+  const decodedUrl = decodeURIComponent(url)
+  const filePath = join(process.cwd(), 'public', decodedUrl)
+  const uploadRoot = join(process.cwd(), 'public', 'uploads')
+  const relativePath = relative(uploadRoot, filePath)
+
+  if (relativePath.startsWith('..') || relativePath === '') {
+    throw createError({
+      statusCode: 400,
+      message: '회원 썸네일 경로가 올바르지 않습니다.'
+    })
+  }
+
+  return filePath
+}
+
+/**
+ * 회원 썸네일 파일과 메타데이터를 정리한다.
+ * @param {string} url - 정리 대상 URL
+ * @returns {Promise<void>}
+ */
+export const removeManagedAvatarAsset = async (url) => {
+  if (!isManagedAvatarUrl(url)) {
+    return
+  }
+
+  const filePath = resolveMemberAvatarPath(url)
+  await rm(filePath, { force: true })
+
+  const sql = getPostgresClient()
+  if (!sql) {
+    return
+  }
+
+  await sql`
+    DELETE FROM media_metadata
+    WHERE url = ${url}
+  `
+}
+