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 结构覆盖首版核心关系。任务负责人允许为空,但创建人必须存在;成员表使用联合主键,防止同一用户被重复加入同一项目。

sql
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;

预期结果

text
app_user
project
project_member
task

表结构只能保证外键存在,不能保证负责人一定属于当前项目。因此,创建或修改任务时仍需先查询 project_member;创建项目时,也应在同一事务中写入 project 和对应的 OWNER 成员记录。

定义首版验收标准

项目需求应写成可验证结果,而不是“支持项目管理”这类宽泛描述。首版至少满足:用户能创建项目;创建者自动进入成员列表;项目所有者能添加成员;成员能创建和查看任务;任务能指定项目内成员;状态只能按允许值更新。

异常路径也要验收:非成员访问项目返回无权限;重复添加成员返回明确冲突;把任务指派给项目外用户时拒绝保存;删除项目后,其成员关系和任务随项目一起删除。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

项目需求与领域模型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通