U's TaskFlow

项目地址

GitHub - Uonlra/TaskFlow: 围绕私人日程安排设计的任务工作台，把任务管理、到期风险、标签组织、进度趋势和个人资料整合到同一个前端项目。

围绕私人日程安排设计的任务工作台，把任务管理、到期风险、标签组织、进度趋势和个人资料整合到同一个前端项目。 - Uonlra/TaskFlow

https://github.com/Uonlra/TaskFlow

在线地址

• 生产部署：https://fronted-flame-five.vercel.app/

• 项目文章：https://www.uon1ra.top/article/taskflow

• 如果线上环境变量未配置完整，站点会回退到本地演示数据模式。

• 本地 .env.local 配好 Appwrite 后，可以直接联调真实认证与真实任务数据。

当前能力

• Next.js App Router 架构

• Appwrite Auth + Tasks 真实数据链路

• Dashboard 时间范围与 URL 同步

• Tasks 搜索 / 标签 / 状态 / 优先级 / 排序与 URL 同步

• 本地演示模式与远程真实数据模式平滑切换

• 任务详情页、设置页、登录注册页共用统一视觉语言

• 到期、今天到期、逾期风险提示

• Dashboard 图表：完成趋势、状态分布、标签分布

真实数据架构

• 浏览器只调用本站 Next.js API

• Next.js API 再调用 Appwrite Cloud

• 登录态通过站点自己的 httpOnly cookie 保持

• profile 使用 Appwrite Account.name + prefs.avatarUrl

• tasks 使用 Appwrite table + row-level permissions

• 未配置 Appwrite 时，任务仍由 Zustand + localStorage 支持 demo 模式

• 认证 API： src/app/api/auth/login/route.tssrc/app/api/auth/register/route.tssrc/app/api/auth/logout/route.tssrc/app/api/auth/me/route.ts

• 资料 API： src/app/api/profile/route.ts

• 任务 API： src/app/api/tasks/route.tssrc/app/api/tasks/[id]/route.ts

• Appwrite 适配层： src/lib/appwrite/env.tssrc/lib/appwrite/server.tssrc/lib/appwrite/session.tssrc/lib/appwrite/tasks.ts

页面清单

• /login

• /register

• /dashboard

• /tasks

• /tasks/[id]

• /settings

技术栈

• Next.js 16

• React 19

• TypeScript

• Appwrite

• React Hook Form

• Zod

• Zustand

• Vercel

目录概览

本地启动

1. 安装依赖

1. 配置 .env.local

1. 启动开发环境

1. 打开浏览器

Appwrite 配置

1. 创建 Appwrite Project

2. 添加本地与线上 Web Platform

3. 开启邮箱密码认证

4. 创建 Database

5. 创建 tasks table

6. 打开 Row security

7. 配置 API key

当前联调结果

• 未登录访问 /api/auth/me 返回 401

• 未登录访问 /dashboard 重定向到 /login

• 真实账号登录

• 资料更新

• 任务创建

• 任务列表读取

• 任务状态更新

• 任务删除

Vercel 部署