[Refactor] UserWord 기반 낱말 관리 전체 리팩토링 (#92)

Author: munwalk

prisma/migrations/20260218190000_remove_wordid_and_categoryid_from_userword/migration.sql

@@ -0,0 +1,8 @@
+-- UserWord 테이블에서 word_id, category_id 컬럼 및 외래키 제약조건 제거
+ALTER TABLE UserWord
+  DROP FOREIGN KEY UserWord_word_id_fkey,
+  DROP FOREIGN KEY UserWord_category_id_fkey;
+
+ALTER TABLE UserWord
+  DROP COLUMN word_id,
+  DROP COLUMN category_id;

prisma/schema.prisma

@@ -144,7 +144,7 @@ model Category {
 
   // Relations
   words     Word[]
-  userWords UserWord[]
+  // userWords relation 제거: UserWord에서 categoryId 삭제됨
 
   @@map("Category")
 }
@@ -164,7 +164,7 @@ model Word {
 
   // Relations
   category  Category   @relation(fields: [categoryId], references: [id], onDelete: Cascade)
-  userWords UserWord[]
+  // userWords relation 제거: UserWord에서 wordId 삭제됨
 
   @@index([categoryId])
   @@index([word])
@@ -204,8 +204,8 @@ model UserCategory {
 model UserWord {
   id             String       @id @default(uuid()) @db.Char(36)
   userId         String       @map("user_id") @db.Char(36)
-  wordId         String?      @map("word_id") @db.Char(36)
-  categoryId     String?      @map("category_id") @db.Char(36)
+  // wordId 필드 제거: 이제 사용자 낱말만 관리
+  // categoryId 필드 제거: 이제 사용자 카테고리만 사용
   userCategoryId String?      @map("user_category_id") @db.Char(36)
   partOfSpeech   PartOfSpeech @map("part_of_speech")
   customWord     String?      @map("custom_word") @db.VarChar(100)
@@ -218,14 +218,14 @@ model UserWord {
 
   // Relations
   user         User          @relation(fields: [userId], references: [id], onDelete: Cascade)
-  word         Word?         @relation(fields: [wordId], references: [id], onDelete: SetNull)
-  category     Category?     @relation(fields: [categoryId], references: [id], onDelete: SetNull)
+  // word relation 제거
+    // category relation 제거
   userCategory UserCategory? @relation(fields: [userCategoryId], references: [id], onDelete: Cascade)
 
   @@index([userId])
   @@index([userId, isFavorite])
   @@index([userId, isDeleted]) // 삭제된 항목 필터링용
-  @@index([userCategoryId, displayOrder])
+    // categoryId 인덱스 제거
   @@map("UserWord")
 }
 

src/category/category.service.js

@@ -77,6 +77,22 @@ export const getCategoryListService = async ({ userId }) => {
     categories = await listUserCategories({ userId });
   }
 
+    // 기본 UserCategory 생성 후, 각 카테고리별 Word를 UserWord로 복사
+    const wordsRepo = (await import("../words/repositories/words.repository.js")).default;
+    for (const userCategory of categories.filter(c => c.isDefault)) {
+      // 기본 카테고리 이름으로 Category 찾기
+      const category = await prisma.category.findFirst({
+        where: {
+          categoryName: userCategory.categoryName,
+          isDefault: true
+        }
+      });
+      if (category) {
+        // 해당 Category의 Word를 UserWord로 복사
+        await wordsRepo.createSnapshotFromWords(userId, userCategory.id);
+      }
+    }
+
   return Promise.all(
     categories.map(async (c) => {
       let wordCount = 0;

src/history/history.repository.js

@@ -59,7 +59,7 @@ export const findFrequentWords = async (userId, frequentLimit = 80) => {
   // 1. 즐겨찾기 데이터 전체 조회 (개수 제한 없음)
   const favorites = await prisma.userWord.findMany({
     where: { userId, isFavorite: true, isDeleted: false },
-    include: { category: true, word: true }
+    include: { userCategory: true }
   });
 
   // 2. 최근 3개월 대화 이력 조회

src/words/repositories/words.repository.js

@@ -141,8 +141,6 @@ export class WordsRepository {
     return await prisma.userWord.findMany({
       where,
       include: {
-        word: true,
-        category: true,
         userCategory: true
       },
       orderBy: { displayOrder: 'asc' }
@@ -186,7 +184,6 @@ export class WordsRepository {
     return await prisma.userWord.create({
       data: {
         userId,
-        categoryId: isUserCategory ? null : categoryId,
         userCategoryId: isUserCategory ? categoryId : null,
         partOfSpeech: partOfSpeech, // NLP 서비스에서 받은 품사
         customWord: word,
@@ -219,8 +216,6 @@ export class WordsRepository {
     return await prisma.userWord.findUnique({
       where: { id: userWordId },
       include: {
-        word: true,
-        category: true,
         userCategory: true
       }
     });
@@ -323,8 +318,6 @@ export class WordsRepository {
       where: { id: userWordId },
       data,
       include: {
-        word: true,
-        category: true,
         userCategory: true
       }
     });
@@ -382,16 +375,16 @@ export class WordsRepository {
     });
     const isUserCategory = !!userCategory;
 
-    // 3. 각 Word를 참조하는 UserWord 생성 (필드 분기)
+    // 3. 각 Word를 UserWord로 복사 (wordId, categoryId 제거)
     const createPromises = words.map((word, index) =>
       prisma.userWord.create({
         data: {
           userId,
-          wordId: word.id,
-          categoryId: isUserCategory ? null : word.categoryId,
           userCategoryId: isUserCategory ? categoryId : null,
           partOfSpeech: word.partOfSpeech,
-          displayOrder: index, // 생성 순서대로 0, 1, 2...
+          customWord: word.word,
+          customImageUrl: word.imageUrl,
+          displayOrder: index,
           isFavorite: false,
           isDeleted: false
         }