[#602] 앱이 독에 내려갔을 때 Todo Fetch 요청이 되는 현상을 해결한다

AGENTS.md

@@ -107,6 +107,16 @@ These may proceed after inspection when they do not change architecture meaning:
 - Do not claim architecture work is complete without checking the diff scope.
 - Do not spend time on unrelated generated project or lockfile churn. Keep generated workspace/project and `Package.resolved` changes out of source control unless they are part of an explicitly approved dependency-lock policy.
 
+## Git and commit rules
+
+- Commit messages must start with a short prefix used by recent local commits, such as `feat`, `fix`, `refactor`, `chore`, `test`, `docs`, `ui`, or `rollback`.
+- Write commit message prose in Korean.
+- Keep implementation names such as `ToastPresenter`, `toastHost`, `MainView`, `DevLogPresentation`, file paths, commands, branch names, and commit hashes in their original form.
+- Do not translate implementation names into Korean unless the user explicitly asks for a user-facing Korean label.
+- Do not write a commit message body.
+- When checking recent commit-message style, do not infer local commit style from GitHub merge or squash-merge subjects such as `[#123] ... (#456)`.
+- For squash-merge commits, inspect the commit body and use the individual bullet commit messages as the style reference.
+
 ## Canonical project rules
 
 - DevLog-specific working rules belong in this repository, not in global agent memory.

Application/DevLogApp/Sources/App/DevLogApp.swift

@@ -18,6 +18,7 @@ struct DevLogApp: App {
     @Environment(\.diContainer) var container: DIContainer
     @Environment(\.scenePhase) var scenePhase
     @State private var windowEvent = TodoEditorWindowEvent()
+    @State private var syncDate = Date()
 
     init() {
         AppAssembler().assemble(AppDIContainer.shared)
@@ -38,7 +39,23 @@ struct DevLogApp: App {
             .autocorrectionDisabled()
             .onChange(of: scenePhase) { _, phase in
                 guard phase == .background else { return }
-                container.resolve(WidgetSyncEventBus.self).publish(.syncRequested)
+                let now = Date()
+                let bus = container.resolve(WidgetSyncEventBus.self)
+
+                // 위젯 갱신은 앱 실행 시 로그인 세션 흐름에서 한 번 요청된다. (WidgetSessionSyncHandler.swift:47)
+                // Todo 변경 성공 시에는 즉시 fetch하지 않고 WidgetSyncEventBus에 갱신 요청만 남긴다.
+                // 따라서 같은 날의 백그라운드 진입은 저장된 요청이 있을 때만 기존 syncRequested 흐름을 실행한다.
+                // 앱이 실행된 상태로 날짜가 넘어간 경우에는 Today widget의 분류 기준일 자체가 바뀌므로,
+                // 콘텐츠 변경 여부와 관계없이 기존 syncRequested 흐름을 즉시 허용한다.
+                guard Calendar.current.isDate(syncDate, inSameDayAs: now) else {
+                    syncDate = now
+                    _ = bus.confirmRequest()
+                    bus.publish(.syncRequested)
+                    return
+                }
+
+                guard bus.confirmRequest() else { return }
+                bus.publish(.syncRequested)
             }
         }
         WindowGroup(id: TodoEditorWindowValue.sceneId, for: TodoEditorWindowValue.self) { value in

Application/DevLogData/Sources/Protocol/WidgetConfigurationProvider.swift

@@ -0,0 +1,10 @@
+//
+//  WidgetConfigurationProvider.swift
+//  DevLogData
+//
+//  Created by opfic on 6/28/26.
+//
+
+public protocol WidgetConfigurationProvider {
+    func currentWidgetKinds() async throws -> Set<String>
+}

Application/DevLogData/Sources/Repository/TodoRepositoryImpl.swift

@@ -143,7 +143,7 @@ final class TodoRepositoryImpl: TodoRepository {
     private func upsertTodo(_ todoRequest: TodoRequest) async throws {
         do {
             try await todoService.upsertTodo(request: todoRequest)
-            widgetSyncEventBus.publish(.syncRequested)
+            widgetSyncEventBus.request()
         } catch {
             throw error.toDomain()
         }
@@ -152,7 +152,7 @@ final class TodoRepositoryImpl: TodoRepository {
     func deleteTodo(_ todoId: String) async throws {
         do {
             try await todoService.deleteTodo(todoId: todoId)
-            widgetSyncEventBus.publish(.syncRequested)
+            widgetSyncEventBus.request()
             todoMutationEventBus.publish(.deleted(todoId))
         } catch {
             throw error.toDomain()
@@ -162,7 +162,7 @@ final class TodoRepositoryImpl: TodoRepository {
     func undoDeleteTodo(_ todoId: String) async throws {
         do {
             try await todoService.undoDeleteTodo(todoId: todoId)
-            widgetSyncEventBus.publish(.syncRequested)
+            widgetSyncEventBus.request()
             todoMutationEventBus.publish(.restored(todoId))
         } catch {
             throw error.toDomain()

Application/DevLogData/Sources/Widget/WidgetSyncEventBus.swift

@@ -9,5 +9,7 @@ import Combine
 
 public protocol WidgetSyncEventBus {
     func publish(_ event: WidgetSyncEvent)
+    func request()
+    func confirmRequest() -> Bool
     func observe() -> AnyPublisher<WidgetSyncEvent, Never>
 }

Application/DevLogData/Tests/Repository/TodoRepositoryImplTests.swift

@@ -13,17 +13,16 @@ import DevLogDomain
 @testable import DevLogData
 
 struct TodoRepositoryImplTests {
-    @Test("Todo 변경 성공 시 위젯 동기화와 mutation 이벤트를 발행한다")
-    func todo_변경_성공_시_위젯_동기화와_mutation_이벤트를_발행한다() async throws {
+    @Test("Todo 변경 성공 시 위젯 동기화 요청과 mutation 이벤트를 발행한다")
+    func todo_변경_성공_시_위젯_동기화_요청과_mutation_이벤트를_발행한다() async throws {
         let fixture = makeFixture()
         let todo = makeTodo()
 
         try await fixture.repository.upsertTodo(todo)
         try await fixture.repository.deleteTodo(todo.id)
         try await fixture.repository.undoDeleteTodo(todo.id)
 
-        let events = fixture.widgetSyncEventBus.events
-        #expect(events == [.syncRequested, .syncRequested, .syncRequested])
+        #expect(fixture.widgetSyncEventBus.requestCallCount == 3)
 
         let mutationEvents = fixture.todoMutationEventBus.publishedEvents()
         #expect(mutationEvents == [.updated(todo.id), .deleted(todo.id), .restored(todo.id)])
@@ -55,8 +54,7 @@ struct TodoRepositoryImplTests {
             #expect(error as? TodoRepositoryImplTestsError == .serviceFailed)
         }
 
-        let syncEvents = fixture.widgetSyncEventBus.events
-        #expect(syncEvents.isEmpty)
+        #expect(fixture.widgetSyncEventBus.requestCallCount == 0)
 
         let mutationEvents = fixture.todoMutationEventBus.publishedEvents()
         #expect(mutationEvents.isEmpty)
@@ -177,14 +175,20 @@ private final class TodoRepositoryMemoryCacheStoreSpy: MemoryCacheStore {
 }
 
 private final class WidgetSyncEventBusSpy: WidgetSyncEventBus {
-    private(set) var events = [WidgetSyncEvent]()
+    private(set) var requestCallCount = 0
 
-    func observe() -> AnyPublisher<WidgetSyncEvent, Never> {
-        Empty().eraseToAnyPublisher()
+    func publish(_ event: WidgetSyncEvent) { }
+
+    func request() {
+        requestCallCount += 1
     }
 
-    func publish(_ event: WidgetSyncEvent) {
-        events.append(event)
+    func confirmRequest() -> Bool {
+        false
+    }
+
+    func observe() -> AnyPublisher<WidgetSyncEvent, Never> {
+        Empty().eraseToAnyPublisher()
     }
 }
 

Application/DevLogData/Tests/Repository/UserPreferencesRepositoryImplTests.swift

@@ -112,6 +112,12 @@ private final class WidgetSyncEventBusSpy: WidgetSyncEventBus {
         events.append(event)
     }
 
+    func request() { }
+
+    func confirmRequest() -> Bool {
+        false
+    }
+
     func observe() -> AnyPublisher<WidgetSyncEvent, Never> {
         Empty().eraseToAnyPublisher()
     }

Application/DevLogWidget/Sources/Widget/WidgetAssembler.swift

@@ -20,6 +20,9 @@ public final class WidgetAssembler: Assembler {
         container.register(WidgetSyncEventBus.self) {
             WidgetSyncEventBusImpl()
         }
+        container.register(WidgetConfigurationProvider.self) {
+            WidgetConfigurationProviderImpl()
+        }
         container.register(WidgetSharedDefaultsStore.self) {
             WidgetSharedDefaultsStore()
         }
@@ -41,7 +44,8 @@ public final class WidgetAssembler: Assembler {
             WidgetSyncEventHandler(
                 eventBus: container.resolve(WidgetSyncEventBus.self),
                 repository: container.resolve(WidgetTodoSnapshotRepository.self),
-                snapshotUpdater: container.resolve(WidgetSnapshotUpdater.self)
+                snapshotUpdater: container.resolve(WidgetSnapshotUpdater.self),
+                configurationProvider: container.resolve(WidgetConfigurationProvider.self)
             )
         }
         container.register(WidgetSessionSyncHandler.self) {

Application/DevLogWidget/Sources/Widget/WidgetConfigurationProviderImpl.swift

@@ -0,0 +1,25 @@
+//
+//  WidgetConfigurationProviderImpl.swift
+//  DevLogWidget
+//
+//  Created by opfic on 6/28/26.
+//
+
+import WidgetKit
+import DevLogData
+
+public final class WidgetConfigurationProviderImpl: WidgetConfigurationProvider {
+    public init() { }
+
+    public func currentWidgetKinds() async throws -> Set<String> {
+        try await withCheckedThrowingContinuation { continuation in
+            WidgetCenter.shared.getCurrentConfigurations { result in
+                continuation.resume(
+                    with: result.map { configurations in
+                        Set(configurations.map(\.kind))
+                    }
+                )
+            }
+        }
+    }
+}

Application/DevLogWidget/Sources/Widget/WidgetSyncEventBusImpl.swift

@@ -6,17 +6,35 @@
 //
 
 import Combine
+import Foundation
 import DevLogData
 
 public final class WidgetSyncEventBusImpl: WidgetSyncEventBus {
     private let subject = PassthroughSubject<WidgetSyncEvent, Never>()
+    private let lock = NSLock()
+    private var isRequested = false
 
     public init() { }
 
     public func publish(_ event: WidgetSyncEvent) {
         subject.send(event)
     }
 
+    public func request() {
+        lock.lock()
+        defer { lock.unlock() }
+        isRequested = true
+    }
+
+    public func confirmRequest() -> Bool {
+        lock.lock()
+        defer { lock.unlock() }
+
+        guard isRequested else { return false }
+        isRequested = false
+        return true
+    }
+
     public func observe() -> AnyPublisher<WidgetSyncEvent, Never> {
         subject.eraseToAnyPublisher()
     }

Application/DevLogWidget/Sources/Widget/WidgetSyncEventHandler.swift

@@ -9,21 +9,25 @@ import Combine
 import Foundation
 import DevLogCore
 import DevLogData
+import DevLogWidgetCore
 
 public final class WidgetSyncEventHandler {
     private let repository: WidgetTodoSnapshotRepository
     private let snapshotUpdater: WidgetSnapshotUpdater
+    private let configurationProvider: WidgetConfigurationProvider
     private let pageSize = 100
     private let logger = Logger(category: "WidgetSyncEventHandler")
     private var cancellables = Set<AnyCancellable>()
 
     public init(
         eventBus: WidgetSyncEventBus,
         repository: WidgetTodoSnapshotRepository,
-        snapshotUpdater: WidgetSnapshotUpdater
+        snapshotUpdater: WidgetSnapshotUpdater,
+        configurationProvider: WidgetConfigurationProvider
     ) {
         self.repository = repository
         self.snapshotUpdater = snapshotUpdater
+        self.configurationProvider = configurationProvider
 
         eventBus.observe()
             .sink { [weak self] event in
@@ -40,13 +44,32 @@ private extension WidgetSyncEventHandler {
             Task { [weak self] in
                 guard let self else { return }
                 let now = Date()
-                async let todaySnapshot: Void = updateTodayWidgetSnapshot(now: now)
-                async let heatmapSnapshot: Void = updateHeatmapWidgetSnapshot(now: now)
-                _ = await (todaySnapshot, heatmapSnapshot)
+                let targets = await enabledSnapshotTargets()
+                await withTaskGroup(of: Void.self) { group in
+                    if targets.contains(.today) {
+                        group.addTask { await self.updateTodayWidgetSnapshot(now: now) }
+                    }
+                    if targets.contains(.heatmap) {
+                        group.addTask { await self.updateHeatmapWidgetSnapshot(now: now) }
+                    }
+                }
             }
         }
     }
 
+    func enabledSnapshotTargets() async -> Set<WidgetSnapshotTarget> {
+        do {
+            let kinds = try await configurationProvider.currentWidgetKinds()
+            return WidgetSnapshotTarget.targets(for: kinds)
+        } catch {
+            logger.error(
+                "Failed to fetch current widget configurations.",
+                error: error
+            )
+            return Set(WidgetSnapshotTarget.allCases)
+        }
+    }
+
     func updateTodayWidgetSnapshot(now: Date) async {
         do {
             async let todosWithDueDate = fetchTodayTodos(
@@ -143,3 +166,19 @@ private extension WidgetSyncEventHandler {
         )
     }
 }
+
+private enum WidgetSnapshotTarget: CaseIterable {
+    case today
+    case heatmap
+
+    static func targets(for kinds: Set<String>) -> Set<Self> {
+        var targets = Set<Self>()
+        if kinds.contains(WidgetKind.todayTodo) {
+            targets.insert(.today)
+        }
+        if kinds.contains(WidgetKind.heatmap) {
+            targets.insert(.heatmap)
+        }
+        return targets
+    }
+}

Application/DevLogWidget/Tests/Handler/WidgetSessionSyncHandlerTests.swift

@@ -75,6 +75,12 @@ private final class WidgetSyncEventBusSpy: WidgetSyncEventBus {
         events.append(event)
     }
 
+    func request() { }
+
+    func confirmRequest() -> Bool {
+        false
+    }
+
     func observe() -> AnyPublisher<WidgetSyncEvent, Never> {
         Empty().eraseToAnyPublisher()
     }

Application/DevLogWidget/Tests/Widget/WidgetSyncEventBusTests.swift

@@ -25,4 +25,16 @@ struct WidgetSyncEventBusTests {
         #expect(receivedEvents == [.syncRequested])
         _ = cancellable
     }
+
+    @Test("WidgetSyncEventBus는 요청 여부를 한 번만 소비한다")
+    func widgetSyncEventBus는_요청_여부를_한_번만_소비한다() {
+        let bus = WidgetSyncEventBusImpl()
+
+        #expect(bus.confirmRequest() == false)
+
+        bus.request()
+
+        #expect(bus.confirmRequest())
+        #expect(bus.confirmRequest() == false)
+    }
 }