优搭校园 01|项目概览、技术选型与初始化
本文从需求分析、概要设计和技术选型开始,梳理优搭校园项目的初始化过程,并给出核心数据表设计。
项目完整开发流程
- 需求分析
- 设计
- 概要设计:总体架构、模块划分、数据库表设计、用户界面设计
- 详细设计:各个模块的接口设计、用户界面交互逻辑
- 技术选型
- 初始化,引依赖,写Demo
- 写代码(实现业务逻辑)
- 测试(单元测试):对项目的各个模块进行测试
- 代码提交,代码评审
- 部署:将代码部署到生产环境或测试环境,进行集成测试和性能测试
- 发布:后续进行维护和升级
项目简介(需求分析)
基于 Spring Boot + Vue 的优搭校园平台,实现了用户注册、登录、查询管理、按标签搜索用户、推荐相似用户、匹配、组队等功能。
概要设计
总体架构
B/S 架构
模块划分
- 用户模块:用户注册、用户登录、查询管理、按标签搜索用户、推荐相似用户
- 小队模块:组队
- 匹配模块:伙伴匹配
数据库表设计
创建表之后,利用 Generator X 自动生成 CRUD 代码
user 表:
| 字段 | 表示含义 | 数据类型 | |
|---|---|---|---|
| id | 主键 | bigint | 自增、主键 |
| username | 昵称 | varchar | 256 |
| userAccount | 登录账号 | varchar | 256 |
| avatarUrl | 头像 | varchar | 1024 |
| gender | 性别 | tinyint | |
| userPassword | 密码 | varchar | 512、非空 |
| phone | 电话 | varchar | 128 |
| 邮箱 | varchar | 512 | |
| userStatus | 用户状态 | int 0 正常1... | 默认值0、非空 |
| createTime | 创建时间 (数据插入时间) | datetime/ timestamp | 默认值CURRENT_TIMESTAMP、非空 |
| updateTime | 更新时间 (数据更新时间) | datetime/timestamp | 默认值CURRENT_TIMESTAMP、非空 |
| isDelete | 是否删除01 (逻辑删除) | tinyint | 默认值0、非空 |
| userRole | 用户角色 | int | 默认值0(普通用户),1(管理员) |
| planetCode | 星球用户 | varchar | 512 |
| tags | 标签列表 json | varchar | 256 |
tag 表:
父标签和子标签的划分:tag 表补充 isParent 字段,而不是父标签一个表,子标签一个表,关联关系一个表,降低表的维护成本
用户和标签的关系:用户表补充 tags 字段,而不是加一个关联表,降低表的维护成本
| 字段 | 表示含义 | 数据类型 | |
|---|---|---|---|
| id | 主键 | bigint | 自增、主键 |
| tagName | 标签名 | varchar | 256 |
| userId | 用户 id | int | |
| parentId | 父标签 id | int | |
| isParent | 是否为父标签 0 不是 1 是 | tinyint | |
| createTime | 创建时间 (数据插入时间) | datetime/ timestamp | 默认值CURRENT_TIMESTAMP、非空 |
| updateTime | 更新时间 (数据更新时间) | datetime/timestamp | 默认值CURRENT_TIMESTAMP、非空 |
| isDelete | 是否删除01 (逻辑删除) | tinyint | 默认值0、非空 |
team 表:
| 字段 | 表示含义 | 数据类型 | |
|---|---|---|---|
| id | 主键 | bigint | 自增、主键 |
| name | 队伍名称 | varchar | 256 |
| description | 描述 | varchar | 1024 |
| maxNum | 最大人数 | int | 默认值 1 |
| expireTime | 过期时间 | datetime | |
| userId | 创建人 id | bigint | |
| status | 状态 | int | 0 - 公开,1 - 私密,2 - 加密 |
| password | 密码 | varchar | 512 |
| createTime | 创建时间 (数据插入时间) | datetime/ timestamp | 默认值CURRENT_TIMESTAMP、非空 |
| updateTime | 更新时间 (数据更新时间) | datetime/timestamp | 默认值CURRENT_TIMESTAMP、非空 |
| isDelete | 是否删除01 (逻辑删除) | tinyint | 默认值0、非空 |
sql
create table team
(
id bigint auto_increment comment 'id'
primary key,
name varchar(256) not null comment '队伍名称',
description varchar(1024) null comment '描述',
maxNum int default 1 not null comment '最大人数',
expireTime datetime null comment '过期时间',
userId bigint comment '用户id',
status int default 0 not null comment '0 - 公开,1 - 私有,2 - 加密',
password varchar(512) null comment '密码',
createTime datetime default CURRENT_TIMESTAMP null comment '创建时间',
updateTime datetime default CURRENT_TIMESTAMP null on update CURRENT_TIMESTAMP,
isDelete tinyint default 0 not null comment '是否删除'
)
comment '队伍';
user_team 表
两个关系:
- 用户加了哪些队伍?
- 队伍有哪些用户?
方式:
- 建立用户 - 队伍关系表 teamId userId
- 优点:便于修改,性能高一点,不用全表遍历,如删除队伍时可以利用外键的级联删除与之相关的用户队伍记录
- 缺点:开发成本高(多维护一个表,写多对多 sql)
- 使用场景:并发量高、用户量多的场景
- 用户表补充已加入的队伍字段,队伍表补充已加入的用户字段
- 优点:便于查询,不用写多对多的代码,可以直接根据队伍查用户、根据用户查队伍
- 缺点:性能低,如删除队伍时需遍历用户表删除所有与之相关的记录
- 使用场景:并发量低、用户量少的场景
字段:
- id 主键
- userId 用户 id
- teamId 队伍 id
- joinTime 加入时间
- createTime 创建时间
- updateTime 更新时间
- isDelete 是否删除
sql
create table user_team
(
id bigint auto_increment comment 'id'
primary key,
userId bigint comment '用户id',
teamId bigint comment '队伍id',
joinTime datetime null comment '加入时间',
createTime datetime default CURRENT_TIMESTAMP null comment '创建时间',
updateTime datetime default CURRENT_TIMESTAMP null on update CURRENT_TIMESTAMP,
isDelete tinyint default 0 not null comment '是否删除'
)
comment '用户队伍关系';
用户界面设计
技术选型
项目采用前后端分离的 B/S 架构,后端以 Spring Boot 为核心,前端使用 Vue,数据持久化采用 MySQL。
后端:
- Java
- Spring(依赖注入框架,帮你管理 Java 对象)
- Spring MVC(web 框架,提供接口访问能力)
- SpringBoot(约定大于配置,快速启动项目,不用自己管理 Spring 配置,不用自己整合各种框架)
- Mybatis(Java 操作数据库的框架,持久层框架,对 jdbc 的封装)
- Mybatis-plus(对 Mybatis 的增强,提供基本增删改查功能)
- Junit(单元测试库)
- MySQL(数据库)
**部署:**服务器 / 容器
初始化,引依赖,写 Demo
初始化



引依赖,写 Demo
Mybatis-plus 官方文档:快速开始
(img-q6XMrjHA-1794994688239)]
外链图片转存中...(img-0or8QZeg-1794994688239)
引依赖,写 Demo
Mybatis-plus 官方文档:快速开始