[Feat] 태그 관리 기능 구현

Data/CoreData/Repositories/PaperDataRepositoryImpl.swift

@@ -209,7 +209,7 @@ final class PaperDataRepositoryImpl: PaperDataRepository {
         }
     }
 
-    func addTag(to id: UUID, with tag: String) -> Result<VoidResponse, any Error> {
+    func addTag(to id: UUID, with tag: String) -> Result<Tag, any Error> {
         let dataContext = container.viewContext
         let fetchRequest: NSFetchRequest<PaperData> = PaperData.fetchRequest()
         fetchRequest.predicate = NSPredicate(format: "id == %@", id as CVarArg)
@@ -238,7 +238,10 @@ final class PaperDataRepositoryImpl: PaperDataRepository {
             paperTag.tagData = tag
 
             try dataContext.save()
-            return .success(VoidResponse())
+
+            // 추가된 Tag 반환
+            let result = Tag(id: tag.id, name: tag.name)
+            return .success(result)
         } catch {
             return .failure(error)
         }

Domain/Interfaces/Repositories/PaperDataRepository.swift

@@ -29,7 +29,7 @@ protocol PaperDataRepository: Sendable {
 
     // 문서에 태그를 추가합니다
     @discardableResult
-    func addTag(to id: UUID, with tag: String) -> Result<VoidResponse, Error>
+    func addTag(to id: UUID, with tag: String) -> Result<Tag, Error>
 
     // 문서의 태그를 삭제합니다 : 전체 태그 리스트에서는 유지
     @discardableResult

Domain/UseCases/HomeSearchUseCase.swift

@@ -103,7 +103,7 @@ extension DefaultHomeSearchUseCase {
     private func fetchPapersByTagName(_ tagName: String) -> [PaperInfo] {
         let response = tagDataRepository.fetchAllTags()
         if case let .success(tags) = response {
-            let result = tags.filter { $0.name == tagName }
+            let result = tags.filter { $0.name.localizedCaseInsensitiveContains(tagName) }
 
             if result.isEmpty {
                 return []

Domain/UseCases/TagControlUseCase.swift

@@ -0,0 +1,60 @@
+//
+//  TagControlUseCase.swift
+//  Reazy
+//
+//  Created by 문인범 on 3/6/25.
+//
+
+import Foundation
+
+
+/**
+ 태그 관리 유즈케이스 (태그 생성, 추가, 삭제 등)
+ */
+protocol TagControlUseCase {
+    @discardableResult
+    func addTagToPaper(to paperId: UUID, with tag: String) -> Result<Tag, Error>
+
+    @discardableResult
+    func removeTagFromPaper(to paperId: UUID, with tagId: UUID) -> Result<VoidResponse, Error>
+
+    @discardableResult
+    func createTag(_ name: String) -> Result<Tag, Error>
+
+    func searchTags(_ name: String) throws -> [Tag]
+}
+
+
+final class DefaultTagControlUseCase: TagControlUseCase {
+    private let paperDataRepository: PaperDataRepository
+    private let tagRepository: TagDataRepository
+
+    init(paperDataRepository: PaperDataRepository, tagRepository: TagDataRepository) {
+        self.paperDataRepository = paperDataRepository
+        self.tagRepository = tagRepository
+    }
+
+    func addTagToPaper(to paperId: UUID, with tag: String) -> Result<Tag, Error> {
+        paperDataRepository.addTag(to: paperId, with: tag)
+    }
+
+    func removeTagFromPaper(to paperId: UUID, with tagId: UUID) -> Result<VoidResponse, Error> {
+        paperDataRepository.removeTag(from: paperId, tagID: tagId)
+    }
+
+    func createTag(_ name: String) -> Result<Tag, Error> {
+        tagRepository.addTag(name: name)
+    }
+
+    func searchTags(_ name: String) throws -> [Tag] {
+        let tags = tagRepository.fetchAllTags()
+
+        switch tags {
+        case let .success(tags):
+            let filteredResult = tags.filter { $0.name.localizedCaseInsensitiveContains(name) }
+            return filteredResult
+        case .failure:
+            throw NSError()
+        }
+    }
+}

Presentation/Home/HomeSearch/Cell/HomePDFCell.swift

@@ -17,6 +17,7 @@ struct HomePDFCell: View {
     let starAction: () -> Void
     let tagAction: (UUID) -> Void
     let editAction: () -> Void
+    let setTagAction: () -> Void
     let copyAction: () -> Void
     let deleteAction: () -> Void
 
@@ -48,6 +49,9 @@ struct HomePDFCell: View {
                         EllipsisButtonView {
                             editAction()
                             popover.toggle()
+                        } setTagAction: {
+                            setTagAction()
+                            popover.toggle()
                         } copyPaperAction: {
                             copyAction()
                             popover.toggle()
@@ -148,6 +152,7 @@ private struct EllipsisView: View {
 // MARK: - Epllipsis 버튼 뷰
 private struct EllipsisButtonView: View {
     let editTitleAction: () -> Void
+    let setTagAction: () -> Void
     let copyPaperAction: () -> Void
     let deletePaperAction: () -> Void
 
@@ -174,6 +179,7 @@ private struct EllipsisButtonView: View {
 
             Button {
                 // TODO: 추후 연결 필요
+                setTagAction()
             } label: {
                 HStack {
                     Text("태그 관리")

Presentation/Home/HomeSearch/HomeSearchView.swift

@@ -12,11 +12,11 @@ struct HomeSearchView: View {
     @EnvironmentObject private var homeSearchViewModel: HomeSearchViewModel
 
     var body: some View {
-            if !homeSearchViewModel.searchText.isEmpty {
-                HomeSearchListView()
-            } else {
-                RecentlySearchedKeywordView()
-            }
+        if !homeSearchViewModel.searchText.isEmpty {
+            HomeSearchListView()
+        } else {
+            RecentlySearchedKeywordView()
+        }
     }
 }
 
@@ -76,10 +76,11 @@ private struct HomeSearchListView: View {
                             } starAction: {
                                 homeSearchViewModel.starButtonTapped(paperInfo)
                             } tagAction: { id in
-                                // TODO: 추후 수정 필요
                                 homeSearchViewModel.tagTapped(id)
                             } editAction: {
                                 homeSearchViewModel.editButtonTapped(paperInfo)
+                            } setTagAction: {
+                                homeSearchViewModel.setTagButtonTapped(paperInfo)
                             } copyAction: {
                                 homeSearchViewModel.copyButtonTapped(paperInfo)
                             } deleteAction: {

Presentation/Home/HomeSearch/ViewModel/HomeSearchViewModel.swift

@@ -34,6 +34,7 @@ final class HomeSearchViewModel: ObservableObject, Sendable {
     enum SearchViewStatus: Hashable {
         case normal
         case search(PaperInfo)
+        case setTag(PaperInfo)
     }
 }
 
@@ -134,6 +135,15 @@ extension HomeSearchViewModel {
     }
 }
 
+// MARK: - TagControl 메소드
+extension HomeSearchViewModel {
+    public func setTagButtonTapped(_ paperInfo: PaperInfo) {
+        withAnimation(.easeInOut) {
+            viewStatus = .setTag(paperInfo)
+        }
+    }
+}
+
 
 // MARK: - Internal Method
 extension HomeSearchViewModel {

Presentation/Home/HomeView.swift

@@ -221,6 +221,20 @@ struct HomeView: View {
                 } completeAction: { text in
                     homeSearchViewModel.completeButtonTappedInEditingTitle(title: text)
                 }
+                .onDisappear {
+                    homeSearchViewModel.searchPapers()
+                }
+            }
+            // 태그 관리
+            if case let .setTag(paperInfo) = homeSearchViewModel.viewStatus {
+                TagControlView(paperInfo: paperInfo) {
+                    homeSearchViewModel.viewStatus = .normal
+                } completeAction: {
+                    homeSearchViewModel.viewStatus = .normal
+                }
+                .onDisappear {
+                    homeSearchViewModel.searchPapers()
+                }
             }
         }
     }

Presentation/Home/TagControl/TagControlCell.swift

@@ -0,0 +1,44 @@
+//
+//  TagControlCell.swift
+//  Reazy
+//
+//  Created by 문인범 on 3/7/25.
+//
+
+import SwiftUI
+
+
+struct TagControlCell: View {
+    let tag: Tag?
+    let name: String
+
+    let action: () -> Void
+
+    init(name: String) {
+        self.tag = nil
+        self.name = name
+        self.action = {}
+    }
+
+    init(tag: Tag, action: @escaping () -> Void) {
+        self.tag = tag
+        self.name = tag.name
+        self.action = action
+    }
+
+    var body: some View {
+        Button {
+            action()
+        } label: {
+            Text(tag?.name ?? name)
+                .reazyFont(.body3)
+                .foregroundStyle(.gray800)
+                .frame(height: 28)
+                .padding(.horizontal, 9)
+                .background {
+                    RoundedRectangle(cornerRadius: 5)
+                        .foregroundStyle(.primary3)
+                }
+        }
+    }
+}