会议室项目-需求与技术设计

在公司里开会，需要先预定会议室，这时候就会用到会议室预订系统。

第一个项目实战就来做这个系统吧。

这节来分析下需求：

首先，用户分为普通用户和管理员两种，各自有不同的功能。

普通用户可以注册，注册的时候会发邮件来验证身份，注册之后就可以登录系统了。

管理员账号密码是内置的，不需要注册。

普通用户可以查看会议室列表、搜索可用会议室、提交预订申请、取消预订、查看预订历史等。

预订成功会邮件通知，就是注册时的那个邮箱。

如果管理员一直没审批，可以催办。

管理员可以查看用户列表、冻结用户、会议室列表、搜索会议室、添加/修改/删除会议室、审批预订申请、查看会议室统计信息等。

整体分为用户管理、会议室管理、预订管理、统计这 4 部分。

如果超过 10 分钟没审批，会发送邮件提醒管理员，如果超过半个小时没审批，会发送短信。

管理员可以解除用户的预订，释放会议室。

冻结用户是指把用户设置为冻结状态，冻结状态的用户不能预订会议室。

统计模块会按照会议室维度和用户维度进行统计，并报表展示。

这些功能涉及到用户端和后台管理两套前端界面。

用户端原型图如下：

用户端--登录

可以用用户名 + 密码登录。

用户端--注册

注册要填入用户名（唯一）、昵称、密码、邮箱，还会发送邮箱验证码。

用户端--修改密码

修改密码也需要邮箱验证。

用户端--会议室列表

按照分页搜索会议室信息，可以指定名字、容纳人数、位置、设备来搜索。

用户端--预订会议室

填入开始时间、结束时间，参会人员等，就可以预订了。

用户端--预订历史

可以查看预订申请的历史，审核状态等，可以撤销预订，也可以催办。

用户端--个人信息修改

可以修改个人信息，比如头像、昵称、邮箱等，修改了邮箱需要验证码验证。

总之，用户注册账号后，可以登录系统，搜索会议室，提交预订申请，查看预订历史。也可以修改个人信息。

接下来是后台管理部分：

后台管理--登录

管理员通过用户名 + 密码登录。

后台管理--预订管理

管理员可以通过、驳回、解除预订信息。解除预订就是已经通过审核的预订在这里手动解除。

后台管理--会议室管理

管理员可以对搜索会议室，查看会议室信息、删除会议室。

后台管理--会议室添加/修改

管理员可以添加修改会议室。

后台管理--用户管理

管理员可以查看用户信息、冻结用户。冻结状态的用户不能预订会议室。

后台管理--统计

可以分别统计会议室使用频率、用户预订频率等，图表类型可以切换。

后台管理--信息修改

管理员可以修改个人信息，如果改了邮箱需要验证。

后台管理--密码修改

管理员可以修改密码，不过需要邮箱验证。

管理员登录系统后，可以管理用户、管理会议室、管理预订、查看会议室的使用统计等。

原型图链接：https://js.design/f/_Naq_y?p=C19K8IFcvq&mode=design

你也可以先看下整体测试这一节，看看这个项目做完的样子。

总结

这节分析了会议室预订系统的需求，并画了用例图、原型图。

很多功能的设计并不唯一：比如会议室需不需要先提申请、让管理员审批？用户信息管理员是否可以修改？

这些与具体需求有关，没有对错，都是可以的。

需求确定了之后，下一节就开始分析技术层面的实现方案。

上节梳理了有哪些需求，并且画了原型图，明确了要做什么。

这节来过一下技术方案，设计下数据库，也就是怎么做。

技术栈

要做的是一个全栈项目，前端用 React + AntD （或者可以换成其他前端框架），后端用 Nest。

技术栈如下：

前端使用 create-vite 脚手架创建项目（Vite + React + TypeScript），使用 react + antd 开发页面。

使用 11-Nginx基础概述 来网关层，实现静态资源的托管，并且对于动态资源请求做负载均衡。

使用 Nest 开发后端业务逻辑，使用 TypeORM + mysql 来做 CRUD。

使用 Redis 来做缓存，减轻数据库的压力，提高响应性能。

api 文档使用 Swagger 来生成。

部署使用 Docker Compose 的方式。

PM2 可用可不用，不用 PM2 就要启动容器的时候指定重启策略了，这里为了简单还是用 PM2。

都是前面讲过的技术，这里只是综合运用。

然后来设计下数据库：

数据库设计

首先是用户表 users：

用户需要区分普通用户和管理员，所以加了个 is_admin 字段。

然后是会议室表 meeting_rooms：

接下来是预订表 bookings：

然后是预订-参会人表 booking_attendees：

这几个表的关系如下：

再加上角色表、权限表，还有 2 个中间表：

角色表 roles

权限表 permissions

用户-角色中间表 user_roles

角色-权限中间表 role_permissions

设计完数据库，再来划分下模块：

模块划分

首先是用户模块，实现普通用户和管理员的登录、注册、信息修改的功能：

大概有这些接口：

然后是会议室管理模块：

然后是预订管理模块：

然后是统计模块：

角色划分

权限控制使用 RBAC 的方式，有普通用户和管理员两个角色。

两个角色各自可以操作的接口就是上节用例图画的那些：

总结

这节设计了下技术方案。

技术栈：前端是 antd + react（create-vite 创建），后端是 nest + typeorm，数据库是 mysql + redis，API 文档用 swagger 生成，部署用 docker compose + pm2，网关使用 11-Nginx基础概述。

数据库表有 8 个：用户表 users、会议室表 meeting_rooms、预订表 bookings、预订-参会者表 booking_attendees、角色表 roles、权限表 permissions、用户-角色表 user_roles、角色-权限表 role_permissions。

模块有 4 个：用户管理模块、会议室管理模块、预订管理模块、统计管理模块。

角色有两个：普通用户、管理员，各自拥有的权限按照用例图来。使用 RBAC 来控制接口访问权限。

技术方案确定之后，下节开始就正式进入开发了。