[#160] TodoListView에서 정렬 및 필터 옵션을 스티키 헤더로 재구성하고 description에 있는 데로 옵션을 수정한다 (#165)

* ui: 스티키 헤더로 정렬, 필터링 옵션을 위치시킨다

* refactor: Todo 여러개 가져올 수 있는 유즈케이스를 쿼리를 통해 fetch하도록 병합

Author: opficdev

DevLog/App/Assembler/DomainAssembler.swift

@@ -51,24 +51,12 @@ private extension DomainAssembler {
     }
 
     func registerTodoUseCases(_ container: DIContainer) {
-        container.register(FetchPinnedTodosUseCase.self) {
-            FetchPinnedTodosUseCaseImpl(container.resolve(TodoRepository.self))
-        }
-
         container.register(FetchTodoByIDUseCase.self) {
             FetchTodoByIDUseCaseImpl(container.resolve(TodoRepository.self))
         }
 
-        container.register(FetchTodosByKindUseCase.self) {
-            FetchTodosByKindUseCaseImpl(container.resolve(TodoRepository.self))
-        }
-
-        container.register(FetchTodosByDateRangeUseCase.self) {
-            FetchTodosByDateRangeUseCaseImpl(container.resolve(TodoRepository.self))
-        }
-
-        container.register(FetchTodosByKeywordUseCase.self) {
-            FetchTodosByKeywordUseCaseImpl(container.resolve(TodoRepository.self))
+        container.register(FetchTodosUseCase.self) {
+            FetchTodosUseCaseImpl(container.resolve(TodoRepository.self))
         }
 
         container.register(UpsertTodoUseCase.self) {

DevLog/Data/DTO/TodoCursorDTO.swift

@@ -8,6 +8,6 @@
 import Foundation
 
 struct TodoCursorDTO {
-    let createdAt: Date
+    let orderedAt: Date
     let documentID: String
 }

DevLog/Data/Mapper/TodoMapping.swift

@@ -50,14 +50,14 @@ extension TodoResponse {
 extension TodoCursorDTO {
     func toDomain() -> TodoCursor {
         TodoCursor(
-            createdAt: createdAt,
+            orderedAt: orderedAt,
             documentID: documentID
         )
     }
 
     static func fromDomain(_ cursor: TodoCursor) -> Self {
         TodoCursorDTO(
-            createdAt: cursor.createdAt,
+            orderedAt: cursor.orderedAt,
             documentID: cursor.documentID
         )
     }

DevLog/Domain/Entity/TodoCursor.swift

@@ -8,6 +8,6 @@
 import Foundation
 
 struct TodoCursor {
-    let createdAt: Date
+    let orderedAt: Date
     let documentID: String
 }

DevLog/Domain/Entity/TodoQuery.swift

@@ -8,31 +8,77 @@
 import Foundation
 
 struct TodoQuery {
-    let kind: TodoKind?
-    let keyword: String?
-    let isPinned: Bool?
-    let createdAtFrom: Date?
-    let createdAtTo: Date?
-    let createdAtDescending: Bool
-    let pageSize: Int
-    let fetchAllPages: Bool
+    enum SortTarget: Equatable, Hashable {
+        case createdAt
+        case updatedAt
+
+        var fieldName: String {
+            switch self {
+            case .createdAt:
+                return "createdAt"
+            case .updatedAt:
+                return "updatedAt"
+            }
+        }
+    }
+
+    enum SortOrder: Equatable, Hashable {
+        case latest
+        case oldest
+
+        var isDescending: Bool {
+            self == .latest
+        }
+    }
+
+    enum CompletionFilter: Equatable, Hashable {
+        case all
+        case incomplete
+        case completed
+
+        var isCompletedValue: Bool? {
+            switch self {
+            case .all:
+                return nil
+            case .incomplete:
+                return false
+            case .completed:
+                return true
+            }
+        }
+    }
+
+    var kind: TodoKind?
+    var keyword: String?
+    var isPinned: Bool?
+    var completionFilter: CompletionFilter
+    var createdAtFrom: Date?
+    var createdAtTo: Date?
+    var sortTarget: SortTarget
+    var sortOrder: SortOrder
+    var pageSize: Int
+    var fetchAllPages: Bool
 
     init(
         kind: TodoKind? = nil,
         keyword: String? = nil,
         isPinned: Bool? = nil,
+        completionFilter: CompletionFilter = .all,
         createdAtFrom: Date? = nil,
         createdAtTo: Date? = nil,
-        createdAtDescending: Bool = true,
+        sortTarget: SortTarget = .createdAt,
+        sortOrder: SortOrder = .latest,
         pageSize: Int = 20,
         fetchAllPages: Bool = false
     ) {
         self.kind = kind
         self.keyword = keyword
         self.isPinned = isPinned
+        self.completionFilter = completionFilter
         self.createdAtFrom = createdAtFrom
         self.createdAtTo = createdAtTo
-        self.createdAtDescending = createdAtDescending
+        self.sortTarget = sortTarget
+        self.sortOrder = sortOrder
         self.pageSize = pageSize
         self.fetchAllPages = fetchAllPages
     }

DevLog/Domain/UseCase/Todo/Fetch/FetchPinnedTodosUseCase.swift

@@ -0,0 +1,10 @@
+//
+//  FetchTodosUseCase.swift
+//  DevLog
+//
+//  Created by opfic on 3/3/26.
+//
+
+protocol FetchTodosUseCase {
+    func execute(_ query: TodoQuery, cursor: TodoCursor?) async throws -> TodoPage
+}