#288] Todo에서 다른 Todo를 참조할 수 있도록 구현한다 (#314)

* feat: 신규 사용자일 때 todo의 auto_increment 용 플래그를 추가

* style: 로그 개선

* feat: Todo 업데이트 시 한 트랜잭션 내에서 auto increment와 업데이트를 같이 하도록 추가

* feat: Todo 관련 모델에 number 추가

* ui: number을 보여줘야 하는 ui에 '#번호' 형태로 구성

* feat: todo refs resolve 로직 추가

* ui: todo refs 렌더링 결과를 상세와 프리뷰에 반영

* ui: 마크다운 렌더러에서 탭하면 시트로 해당 todo를 띄울수 있도록 추가

* feat: todo refs 조회 구조를 reference item 기반으로 변경

* ui: todo refs를 전용 markdown 컴포넌트로 렌더링

* ui: '- refs # ' 사용법 추가

* ui: '- refs # ' 사용법 추가

* style: 로그 원복

Author: opficdev

DevLog/App/Assembler/DomainAssembler.swift

@@ -55,6 +55,10 @@ private extension DomainAssembler {
             FetchTodoByIdUseCaseImpl(container.resolve(TodoRepository.self))
         }
 
+        container.register(FetchReferenceItemsUseCase.self) {
+            FetchReferenceItemsUseCaseImpl(container.resolve(TodoRepository.self))
+        }
+
         container.register(FetchTodosUseCase.self) {
             FetchTodosUseCaseImpl(container.resolve(TodoRepository.self))
         }

DevLog/App/RootView.swift

@@ -42,7 +42,8 @@ struct RootView: View {
             case .todoDetail(let todoId):
                 NavigationStack {
                     TodoDetailView(viewModel: TodoDetailViewModel(
-                        fetchUseCase: container.resolve(FetchTodoByIdUseCase.self),
+                        fetchTodoUseCase: container.resolve(FetchTodoByIdUseCase.self),
+                        fetchReferenceItemsUseCase: container.resolve(FetchReferenceItemsUseCase.self),
                         upsertUseCase: container.resolve(UpsertTodoUseCase.self),
                         todoId: todoId,
                         showEditButton: false

DevLog/Data/DTO/TodoDTO.swift

@@ -12,6 +12,7 @@ struct TodoRequest: Encodable {
     let isPinned: Bool
     let isCompleted: Bool
     let isChecked: Bool
+    let number: Int?
     let title: String
     let content: String
     let createdAt: Date
@@ -28,6 +29,7 @@ struct TodoResponse {
     let isPinned: Bool
     let isCompleted: Bool
     let isChecked: Bool
+    let number: Int
     let title: String
     let content: String
     let createdAt: Date

DevLog/Data/Mapper/TodoMapping.swift

@@ -12,6 +12,7 @@ extension TodoRequest {
             isPinned: entity.isPinned,
             isCompleted: entity.isCompleted,
             isChecked: entity.isChecked,
+            number: entity.number,
             title: entity.title,
             content: entity.content,
             createdAt: entity.createdAt,
@@ -35,6 +36,7 @@ extension TodoResponse {
             isPinned: self.isPinned,
             isCompleted: self.isCompleted,
             isChecked: self.isChecked,
+            number: self.number,
             title: self.title,
             content: self.content,
             createdAt: self.createdAt,

DevLog/Data/Repository/TodoRepositoryImpl.swift

@@ -24,6 +24,10 @@ final class TodoRepositoryImpl: TodoRepository {
         let response = try await todoService.fetchTodo(todoId: todoId)
         return try response.toDomain()
     }
+
+    func fetchReferenceItems(_ numbers: [Int]) async throws -> [Int: TodoReferenceItem] {
+        try await todoService.fetchReferenceItems(numbers)
+    }
 
     func upsertTodo(_ todo: Todo) async throws {
         let request = TodoRequest.fromDomain(todo)

DevLog/Domain/Entity/Todo.swift

@@ -12,6 +12,7 @@ struct Todo: Identifiable, Hashable {
     var isPinned: Bool      //  해당 할 일이 상단에 고정되어 있는지 여부
     var isCompleted: Bool   //  해당 할 일의 완료 여부
     var isChecked: Bool     //  해당 할 일의 체크 여부
+    var number: Int?        //  사용자에게 노출되는 Todo 번호
     var title: String       //  할 일의 제목
     var content: String //  할 일의 설명
     var createdAt: Date     //  할 일 생성 날짜

DevLog/Domain/Entity/TodoReferenceItem.swift

@@ -0,0 +1,14 @@
+//
+//  TodoReferenceItem.swift
+//  DevLog
+//
+//  Created by opfic on 3/25/26.
+//
+
+import Foundation
+
+struct TodoReferenceItem: Identifiable, Equatable {
+    let id: String
+    let title: String
+    let kind: TodoKind
+}

DevLog/Domain/Extension/Array.swift

@@ -28,3 +28,20 @@ extension Array: @retroactive RawRepresentable where Element: Codable {
         return result
     }
 }
+
+extension Array {
+    func chunked(maxCount: Int) -> [[Element]] {
+        guard 0 < maxCount else { return [] }
+
+        var chunks = [[Element]]()
+        var startIndex = 0
+
+        while startIndex < count {
+            let endIndex = Swift.min(startIndex + maxCount, count)
+            chunks.append(Array(self[startIndex..<endIndex]))
+            startIndex = endIndex
+        }
+
+        return chunks
+    }
+}

DevLog/Domain/Extension/String.swift

@@ -7,19 +7,37 @@
 
 import Foundation
 
-// UpperCamelCase → snake_case 변환
 extension String {
-    var toSnakeCase: String {
-        unicodeScalars.reduce("") {
-            if CharacterSet.uppercaseLetters.contains($1) {
-                return ($0.isEmpty ? "" : $0 + "_") + String($1).lowercased()
+    private static let todoReferencePattern = #"^([ \t]*)-[ \t]+refs[ \t]+#(\d+)[ \t]*$"#
+
+    var todoReferenceNumbers: [Int] {
+        guard
+            let expression = try? NSRegularExpression(
+                pattern: Self.todoReferencePattern,
+                options: [.anchorsMatchLines]
+            )
+        else {
+            return []
+        }
+
+        let range = NSRange(startIndex..., in: self)
+        let matches = expression.matches(in: self, options: [], range: range)
+        var numbers = [Int]()
+        var seen = Set<Int>()
+
+        for match in matches {
+            guard
+                let numberRange = Range(match.range(at: 2), in: self),
+                let number = Int(self[numberRange]),
+                !seen.contains(number)
+            else {
+                continue
             }
-            return $0 + String($1)
+
+            seen.insert(number)
+            numbers.append(number)
         }
-    }
-    
-    var upperCamelCase: String {
-        guard let first = self.first else { return "" }
-        return first.uppercased() + self.dropFirst()
+
+        return numbers
     }
 }

DevLog/Domain/Protocol/TodoRepository.swift

@@ -10,6 +10,7 @@ import Foundation
 protocol TodoRepository {
     func fetchTodos(_ query: TodoQuery, cursor: TodoCursor?) async throws -> TodoPage
     func fetchTodo(_ todoId: String) async throws -> Todo
+    func fetchReferenceItems(_ numbers: [Int]) async throws -> [Int: TodoReferenceItem]
     func upsertTodo(_ todo: Todo) async throws
     func deleteTodo(_ todoId: String) async throws
     func undoDeleteTodo(_ todoId: String) async throws