React / 系统课时
项目需求与领域模型
项目需求与领域模型
本课把“任务管理”拆成可实现、可验收的最小业务闭环:用户创建项目、邀请成员、分配任务并推进状态。完成后,你将得到页面流程、接口边界、核心表结构和首版验收标准。
学习目标
- 识别用户、项目、成员和任务四个核心领域对象
- 划分页面职责与前后端接口边界
- 设计可支持成员协作和任务流转的关系模型
从业务闭环确定范围
首版只实现一条完整主流程:用户进入项目列表,创建项目,在项目详情中添加成员、创建任务、指定负责人,并把任务从“待处理”推进到“进行中”或“已完成”。
暂不加入评论、附件、标签、通知和复杂权限。这样可以先验证领域模型是否稳定,避免在核心关系尚未确定时扩展大量次要功能。
首版页面可收敛为四个入口:登录页、项目列表页、项目详情页和成员管理页。项目详情页同时承担任务列表、任务创建和状态修改,减少不必要的页面跳转。

明确领域对象与规则
User 表示系统中的操作者,邮箱用于唯一识别,密码只保存不可逆哈希;Project 是任务协作边界,每个项目只有一个创建者;ProjectMember 连接用户与项目,并保存该用户在项目中的角色;Task 必须属于一个项目,可以暂时不指定负责人。
首版规则保持简单:项目创建者自动成为 OWNER;只有项目成员才能查看项目;只有 OWNER 能管理成员;任务状态只允许 TODO、DOING、DONE;负责人必须已经是该项目成员。
这些规则应由后端统一校验。前端可以隐藏无权限按钮,但不能把前端判断当作真正的访问控制。
划分页面与接口边界
| 页面 | 主要职责 | 需要的接口 |
|---|---|---|
| 登录注册 | 创建用户并建立会话 | POST /api/auth/register、POST /api/auth/login |
| 项目列表 | 查看和创建项目 | GET /api/projects、POST /api/projects |
| 项目详情 | 查看项目、任务与状态 | GET /api/projects/:projectId、GET /api/projects/:projectId/tasks |
| 任务操作 | 创建、编辑和推进任务 | POST /api/projects/:projectId/tasks、PATCH /api/tasks/:taskId |
| 成员管理 | 查询、添加和移除成员 | GET /api/projects/:projectId/members、POST /api/projects/:projectId/members、DELETE /api/projects/:projectId/members/:userId |
接口按资源划分,而不是按按钮命名。创建任务使用项目下的集合地址,修改任务使用任务自身地址;这样既能表达归属关系,也能避免出现 createTask、finishTask 一类难以扩展的动作式路径。
建立关系数据库模型
下面的 MySQL 结构覆盖首版核心关系。任务负责人允许为空,但创建人必须存在;成员表使用联合主键,防止同一用户被重复加入同一项目。
CREATE TABLE app_user (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
email VARCHAR(191) NOT NULL UNIQUE,
password_hash VARCHAR(255) NOT NULL,
display_name VARCHAR(100) NOT NULL,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
);
CREATE TABLE project (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
owner_id BIGINT NOT NULL,
name VARCHAR(120) NOT NULL,
description VARCHAR(500),
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
CONSTRAINT fk_project_owner
FOREIGN KEY (owner_id) REFERENCES app_user(id)
);
CREATE TABLE project_member (
project_id BIGINT NOT NULL,
user_id BIGINT NOT NULL,
role ENUM('OWNER', 'MEMBER') NOT NULL DEFAULT 'MEMBER',
joined_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (project_id, user_id),
CONSTRAINT fk_member_project
FOREIGN KEY (project_id) REFERENCES project(id) ON DELETE CASCADE,
CONSTRAINT fk_member_user
FOREIGN KEY (user_id) REFERENCES app_user(id) ON DELETE CASCADE
);
CREATE TABLE task (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
project_id BIGINT NOT NULL,
title VARCHAR(200) NOT NULL,
description TEXT,
status ENUM('TODO', 'DOING', 'DONE') NOT NULL DEFAULT 'TODO',
assignee_id BIGINT,
created_by BIGINT NOT NULL,
due_date DATE,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
INDEX idx_task_project_status (project_id, status),
INDEX idx_task_assignee (assignee_id),
CONSTRAINT fk_task_project
FOREIGN KEY (project_id) REFERENCES project(id) ON DELETE CASCADE,
CONSTRAINT fk_task_assignee
FOREIGN KEY (assignee_id) REFERENCES app_user(id),
CONSTRAINT fk_task_creator
FOREIGN KEY (created_by) REFERENCES app_user(id)
);
SELECT table_name
FROM information_schema.tables
WHERE table_schema = DATABASE()
AND table_name IN ('app_user', 'project', 'project_member', 'task')
ORDER BY table_name;预期结果
app_user
project
project_member
task表结构只能保证外键存在,不能保证负责人一定属于当前项目。因此,创建或修改任务时仍需先查询 project_member;创建项目时,也应在同一事务中写入 project 和对应的 OWNER 成员记录。
定义首版验收标准
项目需求应写成可验证结果,而不是“支持项目管理”这类宽泛描述。首版至少满足:用户能创建项目;创建者自动进入成员列表;项目所有者能添加成员;成员能创建和查看任务;任务能指定项目内成员;状态只能按允许值更新。
异常路径也要验收:非成员访问项目返回无权限;重复添加成员返回明确冲突;把任务指派给项目外用户时拒绝保存;删除项目后,其成员关系和任务随项目一起删除。