[#289] Todo 카테고리를 유저가 CRUD 할 수 있도록 개선한다 (#337)

* feat: 기존 TodoCategory를 SystemTodoCategory로 수정, UserTodoCategory를 생성하고 기존 카테코리는 두 종류를 아우르는 형태로 구성

* feat: 카테고리와 색상을 입력하는 프레젠테이션 구성

* feat: 사용자 커스텀 카테고리는 삭제 가능

* ui: 색상 대신 코드를 보여주고, 해당 색상으로 폰트 색 적용

* chore: 아키텍쳐 특성 상 발생하는 패턴 disable

* feat: 서비스 카테고리 설정과 사용자 카테고리 설정을 Firestore을 통해 영속성을 지원하도록 구현

* ui: 사용자가 내릴 수 있다는 표시 추가

* feat: 커스텀 카테고리를 삭제하면 얼럿이 뜨고 확인 버튼을 눌러야 삭제되도록 구현

* feat: Firestore에서 fetch 시 로딩뷰가 뜨도록 추가

* feat: 카테고리를 제거 시 해당 카테고리를 선택한 TODO를 기타 카테고리로 수정하는 Cloud Functions 구현

* style: 이름이 어려운 메서드명을 직관적으로 수정

* fix: 커스텀 카테고리가 디코딩 되지 않는 현상 해결

* feat: TODO 수정 시 커스텀 카테고리도 떠있을 수 있도록 추가

* fix: 푸시알림 데이터가 시스템 카테고리만 디코딩 가능한 현상 해결

* feat: TODO의 카테고리를 변경하면 그에 대응되는 푸시 알림의 데이터도 수정되도록 구현

* refactor: 커스텀 카테고리를 id로 관리

* chore: firebase 업데이트

* feat: TODO에서 다른 TODO를 참조 시 커스텀 카테고리로 되어 있어도 참조가 가능하도록 구현

* feat: 사용자 카테고리를 수정할 수 있도록 구현

* feat: 카테고리를 수정해도 최근 수정 섹션에서는 반영되지 않는 현상 해결

* feat: 최대 20자 제한

* feat: 색상 hex 코드를 탭하면 랜덤으로 색상을 뽑도록 구현

* fix: oDomain 메서드가 다른 곳에서 resolve되지 않은 DTO와 함께 호출될 경우 잠재적 오류 발생 가능성 해결

* refactor: 공통 로직을 헬퍼로 묶음

* refactor: 불필요 case 문 제거

* fix: 사용자 커스텀 카테고리 끼리는 검사하지 않아 추가

* refactor: 각 레이어별 모델 사용처 명확화

* fix: 언어에 따라 비교값이 달라질 수 있는 문제 해결

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

* refactor: TodoCategoryPreferenceItem -> TodoCategoryItem

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Author: opficdev

.swiftlint.yml

@@ -3,3 +3,5 @@ disabled_rules:
   - multiple_closures_with_trailing_closure
   - trailing_whitespace
   - type_body_length
+  - cyclomatic_complexity
+  - function_body_length

DevLog/App/Assembler/DataAssembler.swift

@@ -28,7 +28,14 @@ final class DataAssembler: Assembler {
 
         container.register(TodoRepository.self) {
             TodoRepositoryImpl(
-                todoService: container.resolve(TodoService.self)
+                todoService: container.resolve(TodoService.self),
+                todoCategoryService: container.resolve(TodoCategoryService.self)
+            )
+        }
+
+        container.register(TodoCategoryRepository.self) {
+            TodoCategoryRepositoryImpl(
+                todoCategoryService: container.resolve(TodoCategoryService.self)
             )
         }
 
@@ -67,7 +74,10 @@ final class DataAssembler: Assembler {
         }
 
         container.register(PushNotificationRepository.self) {
-            PushNotificationRepositoryImpl(pushNotificationService: container.resolve(PushNotificationService.self))
+            PushNotificationRepositoryImpl(
+                pushNotificationService: container.resolve(PushNotificationService.self),
+                todoCategoryService: container.resolve(TodoCategoryService.self)
+            )
         }
 
         container.register(WebPageRepository.self) {

DevLog/App/Assembler/DomainAssembler.swift

@@ -11,6 +11,7 @@ final class DomainAssembler: Assembler {
         registerConnectivityUseCases(container)
         registerAuthProviderUseCases(container)
         registerTodoUseCases(container)
+        registerTodoCategoryUseCases(container)
         registerUserDataUseCases(container)
         registerPushNotificationUseCases(container)
         registerWebPageUseCases(container)
@@ -85,6 +86,20 @@ private extension DomainAssembler {
         }
     }
 
+    func registerTodoCategoryUseCases(_ container: DIContainer) {
+        container.register(FetchTodoCategoryPreferencesUseCase.self) {
+            FetchTodoCategoryPreferencesUseCaseImpl(
+                container.resolve(TodoCategoryRepository.self)
+            )
+        }
+
+        container.register(UpdateTodoCategoryPreferencesUseCase.self) {
+            UpdateTodoCategoryPreferencesUseCaseImpl(
+                container.resolve(TodoCategoryRepository.self)
+            )
+        }
+    }
+
     func registerUserDataUseCases(_ container: DIContainer) {
         container.register(FetchUserDataUseCase.self) {
             FetchUserDataUseCaseImpl(container.resolve(UserDataRepository.self))

DevLog/App/Assembler/InfraAssembler.swift

@@ -36,6 +36,10 @@ final class InfraAssembler: Assembler {
             TodoService()
         }
 
+        container.register(TodoCategoryService.self) {
+            TodoCategoryService()
+        }
+
         container.register(UserService.self) {
             UserService()
         }

DevLog/Data/DTO/PushNotificationResponse.swift

@@ -14,5 +14,5 @@ struct PushNotificationResponse {
     let receivedAt: Date
     let isRead: Bool
     let todoId: String
-    let todoCategory: String
+    let todoCategory: TodoCategoryResponse
 }

DevLog/Data/DTO/TodoCategoryResponse.swift

@@ -0,0 +1,13 @@
+//
+//  TodoCategoryResponse.swift
+//  DevLog
+//
+//  Created by opfic on 3/30/26.
+//
+
+import Foundation
+
+enum TodoCategoryResponse {
+    case raw(String)
+    case decoded(TodoCategory)
+}

DevLog/Data/DTO/TodoDTO.swift

@@ -20,7 +20,7 @@ struct TodoRequest: Encodable {
     let completedAt: Date?
     let dueDate: Date?
     let tags: [String]
-    let category: TodoCategory
+    let category: String
 }
 
 struct TodoResponse {
@@ -36,5 +36,5 @@ struct TodoResponse {
     let completedAt: Date?
     let dueDate: Date?
     let tags: [String]
-    let category: String
+    let category: TodoCategoryResponse
 }

DevLog/Data/DTO/TodoReferenceResponse.swift

@@ -0,0 +1,15 @@
+//
+//  TodoReferenceResponse.swift
+//  DevLog
+//
+//  Created by opfic on 3/30/26.
+//
+
+import Foundation
+
+struct TodoReferenceResponse {
+    let id: String
+    let number: Int
+    let title: String
+    let category: TodoCategoryResponse
+}

DevLog/Data/Mapper/PushNotificationMapping.swift

@@ -7,8 +7,15 @@
 
 extension PushNotificationResponse {
     func toDomain() throws -> PushNotification {
-        guard let todoCategory = TodoCategory(rawValue: self.todoCategory) else {
-            throw DataError.invalidData("PushNotificationResponse.todoCategory is invalid: \(self.todoCategory)")
+        let todoCategory: TodoCategory
+
+        switch self.todoCategory {
+        case .decoded(let category):
+            todoCategory = category
+        case .raw(let category):
+            throw DataError.invalidData(
+                "PushNotificationResponse.todoCategory must be resolved before toDomain(): \(category)"
+            )
         }
 
         return PushNotification(

DevLog/Data/Mapper/TodoMapping.swift

@@ -20,15 +20,20 @@ extension TodoRequest {
             completedAt: entity.completedAt,
             dueDate: entity.dueDate,
             tags: entity.tags,
-            category: entity.category
+            category: entity.category.storageValue
         )
     }
 }
 
 extension TodoResponse {
     func toDomain() throws -> Todo {
-        guard let category = TodoCategory(rawValue: self.category) else {
-            throw DataError.invalidData("TodoResponse.category is invalid: \(self.category)")
+        let todoCategory: TodoCategory
+
+        switch category {
+        case .decoded(let category):
+            todoCategory = category
+        case .raw(let category):
+            throw DataError.invalidData("TodoResponse.category must be resolved before toDomain(): \(category)")
         }
 
         return Todo(
@@ -44,7 +49,7 @@ extension TodoResponse {
             completedAt: self.completedAt,
             dueDate: self.dueDate,
             tags: self.tags,
-            category: category
+            category: todoCategory
         )
     }
 }