iTodo++

一个多端待办任务管软件，包含 后端 API、桌面 / 移动端 App 与 Web 前端 三端，可跨平台使用同一套数据。

iTodo++: a Rails JSON API, a Flutter desktop/mobile app, and a Vue 3 web client.

功能特性

• 任务管理：创建、编辑、完成、删除、拖拽排序；支持描述、优先级、标签。


• 清单（ Task Lists ）：将任务归类到不同清单，内置「工作 / 个人 / 学习」默认清单。


• 标签（ Tags ）：可自定义带颜色的标签，并按标签筛选任务。


• 优先级：无 / 低 / 中 / 高 四级优先级，配合 Eisenhower （四象限）视图使用。


• 提醒：支持「准时 / 提前 5 分钟 / 30 分钟 / 1 小时 / 1 天」提醒。


• 重复：不重复 / 每天 / 工作日 / 每周 / 每月 / 每年。


• 回收站：软删除、恢复、清空。


• 多视图：收集箱（ Inbox ）、今天、未来 7 天、已完成、回收站、自定义清单、四象限、日历、专注模式。


• 多端同步：后端提供统一 REST API ，Web 与 App 共享数据。

技术栈

三端约定的后端地址均为 http://localhost:3000/api（ Android 模拟器请改用 10.0.2.2）。

目录结构

.

├── todo_api/   # Rails JSON API （ PostgreSQL ）

├── todo_app/   # Flutter 桌面 / 移动 / Web 客户端

└── todo_web/   # Vue 3 + Vite Web 前端

快速开始

1. 后端 API (todo_api)

环境要求：Ruby 3.2+、PostgreSQL 14+。

cd todo_api



# 安装依赖

bundle install



# 配置数据库（可通过 .env 设置 DB_HOST / DB_USERNAME / DB_PASSWORD / DB_NAME ）

cp .env.example .env   # 如存在，按需修改

rails db:create db:migrate



# 启动服务（默认监听 http://localhost:3000 ）

bin/rails server



# 健康检查

curl http://localhost:3000/api/health

或使用 Docker 进行容器化部署（参见 Dockerfile 与 Gemfile 中的 kamal）。

主要 API：

• GET/POST/PUT/DELETE /api/tasks — 任务 CRUD ，支持 view、list_id、tag_id、q 筛选


• PATCH /api/tasks/:id/toggle — 切换完成状态


• PATCH /api/tasks/:id/trash、restore，DELETE /api/tasks/trash/empty — 回收站


• GET/POST/PUT/DELETE /api/task_lists — 清单


• GET/POST/PUT/DELETE /api/tags — 标签

2. Web 前端 (todo_web)

环境要求：Node.js 18+。

cd todo_web



npm install



# 开发模式（默认 http://localhost:5173 ，/api 自动代理到后端 :3000 ）

npm run dev



# 构建生产包到 dist/

npm run build



# 预览构建产物

npm run preview

3. 桌面 / 移动 App (todo_app)

环境要求：Flutter 3.11+（本机已配置 SDK ）。

cd todo_app



flutter pub get



# 运行（ macOS / Windows / Linux 桌面，或连接设备 / 模拟器）

flutter run



# 构建各平台产物

flutter build macos     # macOS

flutter build windows   # Windows

flutter build linux     # Linux

flutter build apk       # Android

flutter build ios       # iOS

flutter build web       # Web

App 默认使用本地存储（shared_preferences），并内置 TodoApi 服务可连接后端 todo_api 进行同步（修改 lib/services/api_service.dart 中的 _baseUrl）。

开发说明

• 本地联调推荐：先启动 todo_api（:3000 ），再启动 todo_web（:5173 ，已配置代理）或 todo_app。


• 前后端通过 rack-cors 处理跨域；生产环境请在 todo_api/config/initializers/cors.rb 中限制允许的来源。


• 各子目录均保留有各自的技术文档（如 todo_api/README.md、todo_app/README.md），可查阅更细致的说明。

QQ 交流群

项目仓库

https://gitee.com/appbook/itodo