README.md · 冰山work/ams-end

# 考勤信息管理系统后端实现

# 1.   系统功能介绍

本系统在实现考勤信息管理系统的基本功能（签到、申请请假、批准请假等）的基础上，还实现了授权认证管理功能（通过拦截器和Session实现）、薪资管理功能、组织层级管理功能、职级管理功能、邮件发送功能、EXCEL导入导出功能。

本系统具体有10个模块，分别是：

（1） 用户管理模块

（2） 考勤任务模块

（3） 考勤类型模块

（4） 组织层级（部门）模块

（5） 邮件模块

（6） 权限模块

（7） 职级模块

（8） 考勤记录模块

（9） 角色模块

（10）薪资模块

用户管理模块实现了用户注册、登录、退出、注销、通过EXCEL批量注册、EXCEL导出现有用户、发送验证码、条件查询和修改用户信息的功能。

考勤任务模块实现了考勤任务信息的增、改、查功能。

考勤类型模块实现了考勤任务信息的条件查询功能。

组织层级模块实现了组织层级信息的增、删、改、查功能。

邮件模块提供了按照简单模板发邮件的功能。

权限模块实现了权限信息的条件查询功能。

角色模块和职级模块实现了角色信息、权限信息的增、删、改、查功能。

考勤记录实现了考勤记录信息的增、删、改、查及签到、申请请假、批准请假功能。

薪资模块实现了薪资信息的条件查询功能。

# 2.  后端文件组织结构

（1）![img](README.assets/clip_image002.jpg)（2）![img](README.assets/clip_image004.jpg)

（3）![img](README.assets/clip_image006.jpg)（4）![img](README.assets/clip_image008.jpg)

（5）![img](README.assets/clip_image010.jpg)

# 3.   数据库设计

表3.1 组织层级表

| 字段名         | 说明       | 类型        | 备注（含主、外键等约束）     |
| -------------- | ---------- | ----------- | ---------------------------- |
| id             | 组织层级id | int         | primary  key、auto_increment |
| hierarchy      | 层级       | varchar(16) | not null                     |
| tier_subsidies | 层级工资   | double      | not null                     |

表3.2 权限表

| 字段名 | 说明       | 类型        | 备注（含主、外键等约束）     |
| ------ | ---------- | ----------- | ---------------------------- |
| id     | 权限id     | int         | primary  key、auto_increment |
| name   | 权限模块名 | varchar(16) | not null                     |

表3.3 职级表

| 字段名       | 说明     | 类型        | 备注（含主、外键等约束）     |
| ------------ | -------- | ----------- | ---------------------------- |
| id           | 职级id   | int         | primary  key、auto_increment |
| name         | 职级名称 | varchar(16) | not null                     |
| basic_salary | 职级薪资 | double      | not null                     |

表3.4 考勤记录表

| 字段名             | 说明       | 类型 | 备注（含主、外键等约束）     |
| ------------------ | ---------- | ---- | ---------------------------- |
| id                 | 记录号     | int  | primary  key、auto_increment |
| user_id            | 工号       | int  | not null                     |
| rank_id            | 职级号     | int  | not null                     |
| attendance_task_id | 考勤任务号 | int  | not null                     |
| attendance_type_id | 考勤类型号 | int  | not null                     |

表3.5 角色表

| 字段名     | 说明      | 类型          | 备注（含主、外键等约束）    |
| ---------- | --------- | ------------- | --------------------------- |
| id         | 角色id    | int           | auto_increment、primary key |
| name       | 角色名    | varchar(255)  | not null、unique            |
| permission | 权限Jason | varchar(2048) | not null                    |

表3.6 用户信息表

| 字段名        | 说明           | 类型          | 备注（含主、外键等约束）    |
| ------------- | -------------- | ------------- | --------------------------- |
| id            | 用户id         | int           | auto_increment、primary key |
| role_id       | 角色id         | int           | not null                    |
| full_name     | 全名（姓名）   | varchar(255)  | not null                    |
| department_id | 部门号         | int           | not null                    |
| rank_id       | 职级号         | int           | not null                    |
| user_name     | 用户名（邮箱） | varchar(1024) | not null                    |
| password      | 密码           | varchar(255)  | not null                    |

表3.7 考勤任务表

| 字段名          | 说明               | 类型    | 备注（含主、外键等约束）    |
| --------------- | ------------------ | ------- | --------------------------- |
| id              | 考勤任务id         | int     | auto_increment、primary key |
| day_of_the_week | 星期几             | int     | not null                    |
| is_repeat       | 是否重复           | int     | not null                    |
| start_hour      | 开始小时数（24制） | char(2) | not null                    |
| start_minute    | 开始分钟数         | char(2) | not null                    |
| end_hour        | 结束小时数（24制） | char(2) | not null                    |
| end_minute      | 开始分钟数         | char(2) | not null                    |

表3.8 考勤类型表

| 字段名 | 说明       | 类型        | 备注（含主、外键等约束）    |
| ------ | ---------- | ----------- | --------------------------- |
| id     | 考勤类型id | int         | auto_increment、primary key |
| name   | 考勤类型名 | varchar(16) | not null、unique            |

表3.9 薪资视图

| 字段名         | 说明           | 类型          | 备注（含主、外键等约束）       |
| -------------- | -------------- | ------------- | ------------------------------ |
| id             | 用户id         | int           | user.id                        |
| user_name      | 用户名（邮箱） | varchar(1024) | user.user_name                 |
| full_name      | 全名（姓名）   | varchar(255)  | user.full_name                 |
| basic_salary   | 职级工资       | varchar(16)   | basic.salary                   |
| tier_subsidies | 部门工资       | varchar(16)   | department.tier_subsidies      |
| total_salary   | 总工资         | double        | basic_salary  + tier_subsidies |

# 4.   功能实现

#### 4.1系统用到的主要配置文件

（1）application.yml文件内容

```yml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/ams?serverTimezone=UTC&characterEncoding=utf8&useUnicode=ture&useSSL=false
    username: root
    password:
    type: com.alibaba.druid.pool.DruidDataSource
    name: druid
  mvc:
    pathmatch:
      matching-strategy: ant_path_matcher
  redis:
    host: localhost
    port: 6379
    database: 0
  session:
    timeout: 86400
    store-type: redis

mybatis:
  mapper-locations: classpath:mapper/*.xml
```

（2）application.properties文件内容

```
# Use smtp protocol
spring.mail.protocol = smtp
spring.mail.host = smtp.qq.com
spring.mail.port = 587
spring.mail.username = xxxxxxxxx@xx.com
# Authorization code
spring.mail.password = xxxxxxxxxxxx
spring.mail.test-connection = false
spring.mail.properties.mail.smtp.auth = false
spring.mail.properties.mail.debug = false
spring.mail.properties.mail.mime.splitlongparameters = false
spring.mail.default-encoding = UTF-8
```

（3）CorsConfig.java文件内容

```
@Configuration
public class CorsConfig implements WebMvcConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        //添加映射路径
        registry.addMapping("/**")
                //是否发送Cookie
                .allowCredentials(true)
                //设置放行哪些原始域   SpringBoot2.4.4下低版本使用.allowedOrigins("*")    
                .allowedOrigins("*")
                //放行哪些请求方式
                //当浏览器发送json数据时，为将请求视为复杂请求，在发送PUT请求前，会先发送一次OPTIONS请求
                .allowedMethods(new String[]{"GET", "POST", "PUT", "DELETE", "OPTIONS"})
                //.allowedMethods("*") //或者放行全部
                //放行哪些原始请求头部信息
                .allowedHeaders("*")
                //暴露哪些原始请求头部信息
                .exposedHeaders("*");
    }
}
```

（4）InterceptorConfig.java文件内容

```
@Configuration
public class InterceptorConfig  implements WebMvcConfigurer {
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new Interceptor())
                //拦截所有的路径
                .addPathPatterns("/**")
                //放行
                .excludePathPatterns("/ams/user/**")
                .excludePathPatterns("/doc.html")
                .excludePathPatterns("/webjars/**")
                .excludePathPatterns("/swagger-resources")
                .excludePathPatterns("/favicon.ico");
    }

@Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        //配置拦截器访问静态资源
        registry.addResourceHandler("doc.html").addResourceLocations("classpath:/META-INF/resources/");
        registry.addResourceHandler("/favicon.ico").addResourceLocations("classpath:/META-INF/resources/");
        registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");
    }
}
```

（5）MybatisPlusConfig.java文件内容

```
@Configuration
public class MybatisPlusConfig {
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 分页插件
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        // 乐观锁插件
        interceptor.addInnerInterceptor(new OptimisticLockerInnerInterceptor());
        // 防全表更新与删除插件
        interceptor.addInnerInterceptor(new BlockAttackInnerInterceptor());
        return interceptor;
    }
}
```

（6）RedisConfig.java文件内容

```
@Configuration
@EnableCaching
public class RedisConfig {
    @Bean
    public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(factory);
        // 使用Jackson2JsonRedisSerialize 替换默认的jdkSerialize序列化
        Jackson2JsonRedisSerializer<Object> jackson2JsonRedisSerializer = new Jackson2JsonRedisSerializer<>(Object.class);
        ObjectMapper om = new ObjectMapper();
        om.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.ANY);
        om.activateDefaultTyping(om.getPolymorphicTypeValidator(),ObjectMapper.DefaultTyping.NON_FINAL);
        jackson2JsonRedisSerializer.setObjectMapper(om);
        // Redis字符串序列化
        StringRedisSerializer stringRedisSerializer = new StringRedisSerializer();
        // key采用String的序列化方式
        template.setKeySerializer(stringRedisSerializer);
        // hash的key也采用String的序列化方式
        template.setHashKeySerializer(stringRedisSerializer);
        // value序列化方式采用jackson
        template.setValueSerializer(jackson2JsonRedisSerializer);
        // hash的value序列化方式采用jackson
        template.setHashValueSerializer(jackson2JsonRedisSerializer);
        template.afterPropertiesSet();
        return template;
    }
}
```

（7）SwaggerConfig.java文件内容

```
@Configuration
@EnableSwagger2WebMvc
public class SwaggerConfig {

@Bean(value = "defaultApi2")
    public Docket defaultApi2() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(new ApiInfoBuilder()
                        .description("# swagger-bootstrap-ui-demo RESTful APIs")
                        .version("1.0")
                        .build())
                //分组名称
                .groupName("AMS")
                .select()
                //这里指定Controller扫描包路径
                .apis(RequestHandlerSelectors.basePackage("com.ams.end.controller"))
                .paths(PathSelectors.any())
                .build();
    }
}
```

（8）pom.xml

```xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>ams-end</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>ams-end</name>
    <description>ams-end</description>

<properties>
        <java.version>1.8</java.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <spring-boot.version>2.3.7.RELEASE</spring-boot.version>
    </properties>

<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-redis</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-security</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

<dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
            <exclusions>
                <exclusion>
                    <groupId>org.junit.vintage</groupId>
                    <artifactId>junit-vintage-engine</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    
        
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.4.0</version>
        </dependency>
        
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-generator</artifactId>
            <version>3.4.0</version>
        </dependency>
        <dependency>
            <groupId>org.freemarker</groupId>
            <artifactId>freemarker</artifactId>
            <version>2.3.30</version>
        </dependency>
        
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-jdbc</artifactId>
            <version>5.2.8.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid</artifactId>
            <version>1.1.3</version>
        </dependency>
        
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>easyexcel</artifactId>
            <version>3.0.5</version>
        </dependency>
        
        <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>knife4j-spring-boot-starter</artifactId>
            <version>2.0.8</version>
        </dependency>
        <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>knife4j-aggregation-spring-boot-starter</artifactId>
            <version>2.0.8</version>
            <exclusions>
                <exclusion>
                    <groupId>cn.hutool</groupId>
                    <artifactId>hutool-all</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        
        <dependency>
            <groupId>cn.hutool</groupId>
            <artifactId>hutool-all</artifactId>
            <version>5.7.16</version>
            <optional>true</optional>
        </dependency>
        
        
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-mail</artifactId>
            <version>2.6.3</version>
        </dependency>
        
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
            <version>2.6.3</version>
        </dependency>
        
        <dependency>
            <groupId>org.springframework.session</groupId>
            <artifactId>spring-session-data-redis</artifactId>
            <version>2.6.3</version>
        </dependency>
        
        <dependency>
            <groupId>org.hibernate.validator</groupId>
            <artifactId>hibernate-validator</artifactId>
            <version>6.1.7.Final</version>
        </dependency>
    </dependencies>

<dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>${spring-boot.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

<build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                    <encoding>UTF-8</encoding>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <version>2.3.7.RELEASE</version>
                <configuration>
                    <mainClass>com.ams.end.AmsEndApplication</mainClass>
                </configuration>
                <executions>
                    <execution>
                        <id>repackage</id>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

</project>
```

冰山work/ams-end

简介

发行版

贡献者

近期动态

冰山work/ams-end .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

冰山work/ams-end