Skip to content

PROJECT_PLAN.md

Latest commit

 

History

History
264 lines (201 loc) · 11.9 KB

PROJECT_PLAN.md

File metadata and controls

264 lines (201 loc) · 11.9 KB
Raw

TaskFlow MVP 项目计划

这是项目的持续规划文档，用来记录阶段目标、待办事项、优先级和完成状态。 后续新计划可以继续追加，不需要每次重写。

使用方式

  • [ ] 未开始
  • [~] 进行中
  • [x] 已完成
  • 优先级建议：P0 > P1 > P2 > P3（数字越小越优先；同档内按重要、紧急综合排序）

当前目标

  • 把 TaskFlow 从学习型 Demo 逐步演进为可展示、可部署、可扩展的 SaaS 风格项目
  • 兼顾功能完善、工程能力、线上演示和面试展示

本周重点

总优先级见下文 「产品待办 backlog」；此处只钉短期执行面。

  • P0 完成任务高级搜索与筛选第一版（含按更新时间日期范围 + 筛选标签）
  • [~] P0 引入更适合 SaaS 风格的 UI 组件体系（App Shell 已上，持续补组件）
  • P1 新增 1-2 个可展示模块/页面
  • P1 梳理并落地 ACL 权限设计第一版
  • P1 提升 README 与项目说明的展示质量
  • [~] P0 对标 Linear 第一波：App Shell 左侧导航、密度更高的列表样式
  • P0（backlog）截止提醒 Cron（站内通知，UTC）
  • P0（backlog）附件上传

明日开发清单

目标：先完成 UI 基座第一步，为任务筛选页改造做准备。

  • P0 安装并接入 lucide-react
  • P0 确认 UI 组件方案以 shadcn/ui + Radix 为主
  • P0 盘点 /tasks 页面将要替换的基础组件
  • P0 完成筛选条草图：关键词 / 状态 / 项目
  • P1 补充 Select 组件
  • P1 补充 Badge 组件
  • P1 补充 Popover 组件
  • P1 把任务页顶部改造成更像 SaaS 工具栏的结构
  • P2 记录一条 UI 改造原则，沉淀到 README 或后续文档

建议完成标准：

  • /tasks 页面顶部结构已经为筛选功能预留空间
  • 组件选型明确，不再来回切换
  • 后续“高级搜索与筛选”可以直接进入实现阶段

阶段一：UI 基座升级

目标：快速提升界面质感，建立可复用的 SaaS 风格组件基础。

  • P0 选定 UI 方案：shadcn/ui + Radix + lucide-react
  • P0 建立基础组件清单
  • P1 增加 Select
  • P1 增加 Popover
  • P1 增加 Command
  • P1 增加 Badge
  • P1 增加 Tabs
  • P1 增加 Sheet
  • [~] P1 统一全局间距、阴影、圆角和色板
  • [~] P2 优化 dashboard / tasks 页视觉层次

阶段二：高级搜索与筛选

目标：让 /tasks 成为真正可演示的任务工作台。

后端能力

  • P0 设计筛选参数：keyword
  • P0 设计筛选参数：status
  • P0 设计筛选参数：projectId
  • P0 设计筛选参数：dateFrom
  • P0 设计筛选参数：dateTo
  • P0 设计排序参数：sort
  • P0 抽离统一服务端查询函数
  • P1 为查询补充 Prisma 索引（Task.userId + updatedAt）

前端交互

  • P0 在 /tasks 顶部增加筛选条
  • P0 支持关键词搜索
  • P0 支持状态筛选
  • P0 支持项目筛选
  • P1 支持日期范围筛选（按 updatedAt，UTC 日界；快捷：近 7 / 30 天）
  • P1 支持 URL 参数同步
  • P1 支持刷新后保留筛选状态
  • P1 增加“清空筛选”
  • P2 增加“当前筛选条件标签”（可单独移除）

阶段三：ACL 权限系统

目标：让项目具备可讲述的权限设计，而不只是简单登录校验。

  • P0 设计 ACL 核心模型：can(user, action, resource)
  • P0 明确资源类型：任务 / 项目
  • P0 明确动作类型：read / create / update / delete
  • P1 前端按钮级权限控制（当前全部归属单用户，UI 层无需差异化）
  • P1 Server Actions 权限校验
  • P1 页面访问权限校验
  • P1 权限失败返回统一错误（assertCan）
  • P2 覆盖 Vitest 单元测试（8 项通过）
  • P2 增加权限设计文档

阶段四：新增模块

目标：新增 1-2 个更有作品感的页面。

  • P0 新增 /dashboard/insights
  • P1 展示任务状态统计
  • P1 展示最近 7 天新增趋势
  • P1 展示项目分布情况
  • P2 新增“筛选结果概览”模块
  • P2 看板视图第一版：/tasks?view=board，按状态分列（只读，未做拖拽）

阶段五：工程化

目标：提升项目稳定性、可维护性和面试含金量。

  • P0 增加关键流程测试：登录
  • P0 增加关键流程测试：创建任务
  • P0 增加关键流程测试：权限拦截
  • P1 配置 CI：lint + test + build（GitHub Actions）
  • P1 增加错误日志与边界处理
  • P1 评估接入监控/埋点
  • P2 迁移 Prisma 配置到 prisma.config.ts

阶段六：部署与展示

目标：保证项目可演示、可访问，并适合求职展示。

  • P0 保持 Vercel 演示链路稳定
  • P0 整理环境变量说明
  • P1 增加一套兼顾国内访问的部署方案
  • P1 形成部署手册
  • P1 形成数据库迁移手册
  • P2 梳理回滚方案

阶段七：文档包装

目标：让项目不仅能跑，还能讲清楚。

  • P0 升级 README 结构
  • P0 增加项目亮点说明
  • P1 增加架构图
  • P1 增加权限设计说明
  • P1 增加部署说明
  • P2 增加踩坑与复盘记录

产品待办 backlog（按重要 · 紧急排序）

说明：与上文各「阶段」章节互补——这里是跨阶段的总优先级视图；实现时仍以对应阶段的技术约束为准。
已落地的能力在下列条目中用 [x] 标出，避免与旧「愿望清单」重复。

P0 — 高重要 · 建议优先排期

  • 任务负责人 / 「分配给我」：Task.assigneeId（MVP 仅本人）；URL assignee=mine / unassigned；筛选面板 + 命令面板入口；详情与新建表单可指派。
  • 子任务或检查清单：TaskChecklistItem（标题 + done + position）；详情内增删勾选；列表/看板显示 完成数/总数 徽标。
  • 标签系统：多对多标签、/dashboard/labels、任务详情勾选、列表/看板展示标签。
  • 按标签筛选任务：URL labelId= + 工具栏筛选 + 标签管理页「查看任务」链到 /tasks。
  • 评论 @ 提及 + 基础通知：@完整邮箱 / @显示名 解析并匹配用户；Notification + /dashboard/notifications；侧栏未读角标；评论正文高亮 @。

P1 — 高价值 · 协作与信息完整

  • 附件：任务/评论上传；对象存储 + 大小/类型限制；删除任务时级联或孤儿策略。
  • 活动流 / 审计日志：任务详情「活动流」+ /dashboard/activity 全部动态；TaskActivity 覆盖创建/状态/详情/负责人/标签/清单/评论。
  • 截止提醒（站内）：URL due=today|tomorrow|… 快捷视图；每日 UTC Cron 写入 Notification（due_today / due_tomorrow）；邮件可后置。
  • 项目成员协作：项目维度成员与权限（在现有 ACL 上扩展资源范围）。

P2 — 体验与扩展

  • 多标签组合筛选：AND/OR 与 URL 设计（如 labelIds）。
  • [~] 命令面板增强：已支持「分配给我的任务」跳转；其余（按标签快捷创建等）待续。
  • 重复任务：recurrence + 定时或惰性生成实例。
  • 数据导入导出：CSV/JSON，迁移与备份。
  • 看板视图：/tasks?view=board（及项目页），按状态分列；拖拽改状态可后续迭代。
  • 评论系统：任务下评论 CRUD，读权限与任务一致。

P3 — 数据与集成（中长期）

  • Insights 加深：按人/标签/项目的周期、逾期率、简易燃尽。
  • 日历 / ICS 导出、Webhook / 公开 API（按是否面向开发者/自动化决定投入）。
  • Git / PR 关联任务（若目标用户是研发场景）。

技术债与工程（穿插安排）

  • 关键路径 E2E 或集成测试：登录 → 建任务 → 标签/评论 → URL 筛选。
  • 无障碍与快捷键文档：与真实行为同步（含命令面板、任务页快捷键）。
  • Prisma 7：package.json#prisma 已提示废弃，迁移到 prisma.config.ts（与阶段五条目一致）。

已完成记录

  • 接入 NextAuth 凭证登录
  • 接入 Prisma + PostgreSQL
  • 跑通基础迁移与 seed
  • 完成任务页与项目页基本链路
  • 增加基础 loading 骨架页
  • 优化 /tasks 页面查询为并行执行
  • 引入 lucide-react + Radix（Select / Popover）
  • 新增基础组件：Badge / Select / Popover
  • 任务页顶部改造为 SaaS 风格工具栏（关键词 + 状态 + 项目 + 清空）
  • getTasksForUser 支持 keyword/status/projectId/sort 服务端筛选
  • /tasks 筛选与 URL 参数同步，刷新后保留
  • 全站切换为 Linear 风格 App Shell（左侧导航 + 右侧工作区）
  • 任务列表改为密度更高的 Linear 风格行（状态图标、项目徽标、悬浮操作）
  • Dialog / Sheet 基础组件（Radix）
  • 新建项目改为 Dialog
  • 新建任务改为右侧 Drawer
  • 登录页新增注册 Dialog（含 registerAction）
  • 视觉升级：按钮与聚焦环引入 violet 强调色、Sidebar 顶部渐变质感
  • 首页与 About 页整体改造：Hero + 特性卡 + Roadmap，与应用风格统一
  • 登录页 C 方案炫酷特效：RetroGrid / Spotlight / Particles / Meteors / TiltCard / 渐变描边
  • 任务详情抽屉（点击任务标题右侧 Sheet 滑出，内含编辑/状态/删除）
  • 接入 sonner Toast：创建/保存/状态切换/删除/注册 全量反馈
  • 命令面板（Cmd+K）：cmdk 搜索/跳转/新建任务/新建项目/访问项目
  • 命令面板服务端任务搜索：GET /api/command/search，命中项跳转 /tasks?taskId= 并打开详情抽屉
  • GitHub Actions：pnpm lint + pnpm test + pnpm build
  • Sidebar 增加「搜索 / ⌘K」入口
  • Insights 数据洞察页：指标卡 / 近 7 天趋势 / 状态分布 / 项目分布
  • Sidebar + CommandMenu 新增 Insights 入口
  • ACL 第一版：can() / assertCan()，覆盖 Server Actions 与页面鉴权
  • Vitest 覆盖 ACL 规则（8 项通过）
  • 对标 Linear：dateFrom/dateTo + 筛选 Chips + @@index([userId, updatedAt])
  • Vitest：date-query 日历与区间（parse / normalize / filter）
  • 任务优先级（TaskPriority）+ 截止日期（dueDate），列表/详情/新建/命令面板展示，URL priority= 筛选，排序 due_asc / due_desc
  • /tasks 快捷键 C：打开新建任务 Sheet 并保留当前筛选参数
  • /tasks 快捷键 F：聚焦关键词搜索；Input 改为 forwardRef
  • 列表/看板切换写入 URL view=，命令面板「任务看板」入口
  • Prisma 索引：@@index([userId, dueDate])
  • 标签系统：Label 多对多、标签管理页、任务详情勾选、侧栏与命令面板入口
  • 任务评论：Comment 模型与 Server Actions，任务详情内列表/发送/删除
  • URL labelId= 按标签筛选、TaskLabelChips 可点击跳转筛选
  • 任务负责人：assigneeId、URL assignee= 筛选、列表「我」徽标、详情指派、新建「指派给我」、⌘K「分配给我的任务」
  • 检查清单：TaskChecklistItem、任务详情块、列表/看板 n/m 进度徽标
  • 评论 @ 与通知：Notification、提及解析、/dashboard/notifications、侧栏角标、⌘K 入口
  • 任务活动流：TaskActivity + 详情时间线；关键操作写入审计摘要
  • 全局全部动态：/dashboard/activity、侧栏与 ⌘K 入口
  • 截止日站内提醒：NotificationKind + dedupeKey 幂等、/api/cron/due-reminders、CRON_SECRET、vercel.json 每日 UTC 0 点