TaskProvider 增量更新重构报告

重构目标

优化 ~/masterplan/lib/providers/task_provider.dart 的 TaskProvider 为增量更新，移除全量 reload 调用。

修改内容

1. createTask - 增量添加

修改前：

// 1. 保存到数据库
final id = await _repository.create(task);
_trackSelfEmittedEvent(TaskEvents.taskCreated, id);
_eventBus.emit(...);

// 2. 重新加载全部数据（简单可靠）
await _reload();

修改后：

// 1. 保存到数据库
final id = await _repository.create(task);
final createdTask = task.copyWith(id: id);

// 🔥 【增量更新】直接添加到内存列表，避免全量重载
_allTasks.add(createdTask);

_trackSelfEmittedEvent(TaskEvents.taskCreated, id);
_eventBus.emit(...);

2. updateTask - 增量更新

修改前：

await _repository.update(task);
_trackSelfEmittedEvent(TaskEvents.taskUpdated, task.id);
_eventBus.emit(...);
await _reload();  // ❌ 全量重载

修改后：

await _repository.update(task);

// 🔥 【增量更新】直接在内存中更新任务，避免全量重载
final index = _allTasks.indexWhere((t) => t.id == task.id);
if (index >= 0) {
  _allTasks[index] = task;
} else {
  _allTasks.add(task);
}

_trackSelfEmittedEvent(TaskEvents.taskUpdated, task.id);
_eventBus.emit(...);

3. deleteTask - 增量删除

修改前：

await _repository.deleteWithChildren(id);

// 🔥 【修复】立即从内存中移除任务，不等待 _reload()
_allTasks.removeWhere((t) => t.id == id);

// 🔥 【修复】立即通知 UI，让用户看到删除效果
_isLoading = false;
notifyListeners();
if (kDebugMode) { debugPrint('🔥 [TaskProvider] 立即更新 UI...'); }

// 🔥 【修复】后台异步重新加载，确保数据一致性
_reload().then((_) { ... });

修改后：

await _repository.deleteWithChildren(id);

// 🔥 【增量更新】立即从内存中移除任务，不等待全量重载
_allTasks.removeWhere((t) => t.id == id);

_trackSelfEmittedEvent(TaskEvents.taskDeleted, id);
_eventBus.emit(...);

4. updateTaskHierarchy - 增量更新层级

修改前：

await _repository.updateHierarchy(taskId, newParentId, newLevel);
_trackSelfEmittedEvent(TaskEvents.taskHierarchyChanged, taskId);
_eventBus.emit(...);

final reloadStart = DateTime.now();
await _reload();  // ❌ 全量重载

修改后：

await _repository.updateHierarchy(taskId, newParentId, newLevel);

// 🔥 【增量更新】直接在内存中更新任务的层级关系
final index = _allTasks.indexWhere((t) => t.id == taskId);
if (index >= 0) {
  final task = _allTasks[index];
  _allTasks[index] = task.copyWith(
    parentId: newParentId,
    level: newLevel,
    updatedAt: DateTime.now(),
  );
}

_trackSelfEmittedEvent(TaskEvents.taskHierarchyChanged, taskId);
_eventBus.emit(...);

性能提升

涉及的调用链

• createTask() → 已有增量逻辑
• updateTask() → 已有增量逻辑
• deleteTask() → 已有增量逻辑
• toggleTaskCompletion() → 调用 updateTask()，自动受益
• setTaskFocus() → 调用 updateTask()，自动受益
• setTaskPriority() → 调用 updateTask()，自动受益
• updateTaskHierarchy() → 已有增量逻辑

注意事项

1. _reload() 方法保留，用于：
2. refresh() 手动刷新（外部强制全量刷新）

3. 事件总线外部刷新场景

4. 事件监听器 _handleIncrementalUpdate() 已实现增量更新逻辑，监听外部事件时使用

5. TaskListProvider 是按需加载架构，与 TaskProvider 是不同 Provider，不受影响