JSL_OrganizeInternalOA/doc/OrganizeInternalOA-SQL.md

OrganizeInternalOA 数据库设计

Author: 筱锋xiao_lfeng | Version: 1.1.0

数据库设计

本数据库设计基于原有 《数据库设计》 进行测试修改，进一步处理数据库结构与增加可维护性。

数据库所有字段均待定，后续可能会对某些字段进行删除，或者新增一些字段，尽量做成可维护的接口

所有的表之间，关联性尽量不要做的那么强，适当解耦，不然可维护性不高

另外，为保证数据库的完整性，对数据库适当位置加以外键约束，若后续需要进行维护删除表等操作，可删除外键约束后操作。

使用数据库系统 Mysql8

建表准备

总建表语句在 /mysql/organize_oa.sql 下存放。（重要：在执行导入中，请先看下面内容）

若需要导入数据库中，请先操作数据库进入对应数据库进行操作。无需执行表导入

USE organize_oa;

数据库、用户名和密码

为了保证业务后期可拓展性及充分利用 mysql 默认数据库中数据，请参考下面内容。

另外，由于各位开发者配置环境为本地环境，非测试环境。故数据库部署并非统一，避免在 application.yml 文件中对 spring.datasource 频繁修改（操作git）带来不必要的麻烦，建议开发者建数据库时，数据库名字为 organize_oa 。单独开设账号 organize_oa 密码 123456

-- 数据库及用户建表语句（执行后创建 organize_oa 数据库与同名 organize_oa 用户（密码：123456）
CREATE USER 'organize_oa'@'%' IDENTIFIED WITH caching_sha2_password BY '123456';GRANT USAGE ON *.* TO 'organize_oa'@'%';ALTER USER 'organize_oa'@'%' REQUIRE NONE WITH MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_USER_CONNECTIONS 0;CREATE DATABASE IF NOT EXISTS `organize_oa`;GRANT ALL PRIVILEGES ON `organize_oa`.* TO 'organize_oa'@'%';

application.yml 配置文件如下：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306
    username: organize_oa
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver

注意，url部分中，没有使用 jdbc:mysql://localhost:3306/organize_oa ，在 mysql 中存在默认数据库 information_schema 该部分可以提取出该数据库（含 organize_oa 数据库）的信息，以及可以支持同账户下多张数据表，对后期若有需要可以调整使用。

url差别对于mapper的使用区别

在习惯使用 jdbc:mysql://localhost:3306/organize_oa 下，Mapper中数据库语法的描写较为简单。

@Mapper
public interface UserMapper {
    @Select("SELECT * FROM oa_user WHERE username = #{username}")
    UserDO getUserByUsername(String username);
}

若修改为 jdbc:mysql://localhost:3306 之后，操作数据库都需要加上数据库名字，告知 DBMS 使用哪一个数据库后再选择数据表

@Mapper
public interface UserMapper {
    @Select("SELECT * FROM organize_oa.oa_user WHERE username = #{username}")
    UserDO getUserByUsername(String username);
}

为何这样使用。

上述这样操作可以保证此服务对应一个数据库的用户，不使用 root 用户。使用 root 用户是一个很危险的事情，分出专门一个用户处理并且专门的用户中对应 information_schema 也有自己及名下相关的数据内容方便利用。除此之外，可以进行业务拓展。**若后期需要额外的开发要求，需要多个数据库，而不是单个数据库对应多个数据表的时候。**无需进行Mapper内繁琐代码修改（替换），只需在编写新的业务Mapper代码写入新的数据表名称即可。

// 举个例子
@Mapper
public interface GeneralMapper {
    @Select("SELECT * FROM organize_oa.oa_user WHERE username = #{username}")
    UserDO getUserByUsername(String username);
    
    @Select("SELECT * FROM organize_log.oa_logs WHERE id = #{id}")
    LogDO getLogById(Long id);
}

organize_oa 数据库设计

oa_user 数据表

说明

【用户表】存放本项目所有用户数据

数据表字段属性

序号	名称	描述	类型	键	为空	额外	默认值
1	id	主键	bigint unsigned	PRI	NO	auto_increment
2	job_id	工作ID：正则表达 "^[STU|TEA|OTH][0-9]{7}"	char(10)	UNI	NO
3	username	用户名	varchar(40)	UNI	NO
4	password	密码	varchar(255)		NO
5	address	用户家庭地址	varchar(255)		NO
6	phone	电话	varchar(11)	UNI	NO
7	email	邮箱	varchar(100)	UNI	NO
8	age	年龄	tinyint unsigned		NO
9	signature	一句话描述自己	varchar(50)		YES
10	sex	0/1/2:保密/男/女	tinyint unsigned		NO		0
11	avatar	头像地址	text		YES
12	nickname	昵称	varchar(20)		YES
13	enabled	账户是否可用	tinyint(1)		NO		1
14	account_no_expired	账户是否过期	tinyint(1)		NO		1
15	credentials_no_expired	密码是否过期	tinyint(1)		NO		0
16	recommend	账户是否被推荐	tinyint(1)		NO		0
17	account_no_locked	账户是否被锁定	tinyint(1)		NO
18	description	个人简介	text		YES
19	created_at	创建时间	timestamp		NO	DEFAULT_GENERATED	CURRENT_TIMESTAMP
20	updated_at	更新时间	timestamp		YES

oa_role 数据表

说明

数据表字段属性

序号	名称	描述	类型	键	为空	额外	默认值
1	id	角色id	int unsigned	PRI	NO	auto_increment
2	role_name	角色名称	varchar(20)		NO

oa_permissions 数据表

说明

数据表字段属性

序号	名称	描述	类型	键	为空	额外	默认值
1	id	主键	bigint unsigned	PRI	NO	auto_increment
2	pid	权限父id	bigint unsigned	MUL	YES
3	name	权限名称	varchar(100)		NO
4	code	权限编码	varchar(50)		NO
5	type	0为菜单，1为权限	tinyint(1)		NO		1
6	deleted_at	删除时间(没有删除应当为空)	timestamp		YES

oa_role_user 数据表

序号	名称	描述	类型	键	为空	额外	默认值
1	uid	用户id	bigint unsigned	PRI	NO
2	rid	角色id	int unsigned	MUL	NO

oa_role_permissions 数据表

序号	名称	描述	类型	键	为空	额外	默认值
1	rid	角色id	int unsigned	PRI	NO
2	pid	权限id	bigint unsigned	MUL	NO

oa_project 数据表

序号	名称	描述	类型	键	为空	额外	默认值
1	id	项目id	bigint unsigned	PRI	NO	auto_increment
2	name	项目名称	varchar(255)		NO
3	description	一句话描述	varchar(255)		NO
4	introduction	项目详细介绍	text		NO
5	code_open	代码是否开放	tinyint(1)		NO		0
6	core_code	核心代码内容（Markdown）	text		YES
7	git	git代码仓库内容	json		YES
8	difficulty_level	难度等级	tinyint unsigned		NO		1
9	type	类型	int unsigned	MUL	NO
10	reward	报酬	double		YES
11	status	状态	tinyint unsigned		NO		0

oa_project_type 数据表

序号	名称	描述	类型	键	为空	额外	默认值
1	id	项目类型id	int unsigned	PRI	NO	auto_increment
2	name	类型名字	varchar(50)		NO
3	created_at	创建时间	timestamp		NO	DEFAULT_GENERATED	CURRENT_TIMESTAMP
4	updated_at	修改时间	timestamp		YES

oa_user_project 数据表

序号	名称	描述	类型	键	为空	额外	默认值
1	id	主键id	bigint unsigned	PRI	NO	auto_increment
2	uid	用户id	bigint unsigned	MUL	NO
3	pid	接到分割项目内容	bigint unsigned		NO
4	created_at	创建时间	timestamp		NO	DEFAULT_GENERATED	CURRENT_TIMESTAMP
5	updated_at	修改时间	timestamp		YES

oa_config 数据表

序号	名称	描述	类型	键	为空	额外	默认值
1	id	主键	bigint unsigned	PRI	NO	auto_increment
2	value	调用关键字	varchar(50)	UNI	NO
3	data	json数据	json		YES
4	created_at	创建时间	timestamp		NO	DEFAULT_GENERATED	CURRENT_TIMESTAMP
5	updated_at	修改时间	timestamp		YES