Planify项目架构设计与核心流程解析

项目概述

Planify是一款基于GTK框架开发的任务管理应用程序，采用典型的前后端分离架构设计。该应用提供了任务管理、项目规划、日程安排等核心功能，支持本地存储与云端同步。

整体架构设计

前端架构

前端部分位于src目录中，采用分层设计模式：

1. 视图层(Views)：负责不同功能模块的界面展示
2. 布局层(Layouts)：组织界面元素的排列组合
3. 组件层(Widgets)：实现具体的交互控件

这种分层设计使得UI组件可以高度复用，同时保持各功能模块的独立性。

后端架构

后端核心位于core目录，主要包含：

1. 数据模型(Objects)：定义应用中的各类数据结构
2. 服务层(Services)：处理业务逻辑
3. 存储控制(Store)：作为控制器协调前后端交互

数据流机制

Planify采用发布-订阅模式实现数据更新：

1. 视图向Store订阅特定事件
2. 当模型数据变更时，Store通知所有订阅的视图
3. 视图接收新数据并更新UI
4. 用户交互触发视图调用Store方法处理数据

这种机制确保了数据与UI的实时同步，同时降低了模块间的耦合度。

核心数据结构设计

类关系模型

Planify的核心数据模型围绕三个关键对象构建：

1. 项目(Project)：最高层级的组织单元

   • 可包含多个子项目
   • 可包含多个分区(Section)

2. 分区(Section)：项目的子单元

   • 归属于特定项目
   • 包含多个任务(Item)

3. 任务(Item)：基础工作单元

   • 可包含子任务
   • 关联提醒(Reminder)和附件(Attachment)
   • 拥有截止日期(DueDate)

数据库设计

数据库采用SQLite实现本地存储，主要特点包括：

1. 支持复杂的关系型数据存储
2. 提供高效的数据查询能力
3. 确保数据持久化和完整性

关键流程解析

应用启动流程

1. 初始化主窗口(MainWindow)
2. 连接并加载SQLite数据库
3. 获取本地存储的所有数据
4. 启动外部数据源同步
5. 异步获取更新数据
6. 使用完整数据初始化UI

该流程确保了应用启动时能快速呈现界面，同时后台完成数据同步。

页面切换机制

Planify提供三种主要视图模式：

1. 标签视图(Label List)：按标签组织任务
2. 任务列表视图(Task List)：展示项目/分区中的任务
3. 日程视图(Day List)：按时间维度展示任务

视图切换通过侧边栏导航实现，各视图保持独立的状态管理。

任务创建流程

1. 用户触发新建任务操作
2. 前端调用Store的创建方法
3. Store处理业务逻辑并更新数据库
4. 数据库返回更新后的数据
5. Store通知相关视图更新
6. 前端展示新任务

整个过程实现了数据的完整闭环。

高级功能实现

数据同步机制

Planify支持多种外部数据源同步：

1. 定时同步：每15分钟自动执行
2. 手动同步：通过同步按钮触发
3. 多源适配：
   • Todoist：通过API令牌认证
   • CalDAV：使用Bearer令牌认证并解析XML

同步过程包括数据比对、冲突解决和本地/远程数据合并。

提醒系统设计

提醒功能采用智能调度机制：

1. 创建提醒时检查时间有效性
2. 当天提醒设置精确超时
3. 未来提醒等待每日刷新
4. 午夜时间监控器触发全局检查

这种设计既保证了提醒的准确性，又优化了系统资源使用。

架构优势分析

1. 模块化设计：前后端分离，职责明确
2. 响应式更新：基于事件通知的UI刷新
3. 扩展性强：易于添加新的数据源和功能
4. 性能优化：异步操作保障UI流畅性
5. 数据安全：本地存储与云端同步相结合

Planify的架构设计体现了现代桌面应用的典型模式，既保证了功能的完整性，又提供了良好的用户体验。