# 数据定义

**Repository Path**: guet16/data_definition

## Basic Information

- **Project Name**: 数据定义
- **Description**: 暂时弃用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-13
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 数据规范化

**&emsp;因为应用设计之初分成前后端设计模式，需要对数据的交换进行数据的定义，避免前后端的数据对接的混乱。<br>&emsp;针对现在还在学习期间，使用的是JavaServlet实现的后端，暂不打算实现用Token进行用户身份的辨识(主要是SpringBoot可以用拦截器实现，JavaServlet暂时不知道如何实现)。数据的交换形式主要以json格式进行传输<br><br>&emsp;现对交换的数据进行规范处理。**

---
# 各模块定义

## **登录模块**
>  主要用于实现用户登录应用进行后续操作，如员工签到或者管理员操作等

**所需对应数据：**

用户名：username<br>
密码：password

状态码：code （200：成功  401：失败）
<br>
响应状态：status （succeed：成功  failed：失败）
<br>
消息：msg （自定义）

**前端接收数据：**
```json
{
    "code":200,
    "status":"succeed",  
    "msg":"登录成功！"
}
```

**后端接收参数：**
*`接口：login`*
```
username=xxx&password=xxx
```


## **考勤模块**
>  主要用于实现员工的考勤功能，员工考勤需携带员工的编号。(位置信息的判断可以暂时不纳入考虑的范围)

**所需对应数据：**

用户名：username<br>
位置信息：location （地理位置，判断用户是否在公司进行打卡）

状态码：code （200：成功  401：鉴权失败）`400为参数错误`
<br>
响应状态：status （succeed：成功  failed：失败）
<br>
消息：msg （自定义内容）

**前端接收数据：**
```json
{
    "code":200,
    "status":"succeed",
    "msg":"打卡成功！"
}
```

**后端接收参数：**
*`接口：sign`*
```
username=xxx&location=xxx
```

## **申请模块**
>  主要用于实现员工的申请提交，如请假申请、离职申请等等

**所需对应数据：**

用户名：username<br>
姓名：name<br>
标题：title<br>
申请内容：content<br>
处理部门：departed （处理申请的部门）

状态码：code （200：成功  400：参数错误）
<br>
响应状态：status （succeed：成功  failed：失败）
<br>
消息：msg （自定义）

**前端接收数据：**
```json
{
    "code":400,
    "status":"failed",    
    "msg":"提交失败！"
}
```

**后端接收参数：**
*`接口：application`*
```
username=xxx&name=xxx&title=xxx&content=xxx&departed=xxx
```

## **个人审批状态**
>  查询员工的申请审批情况，这里前端从后端收到的是json数组

**所需对应数据：**

状态：status<br>
用户名：username<br>
姓名：name<br>
标题：title<br>
申请内容：content<br>
处理进度：progress （waiting：等待处理  processing：处理中  finish：已处理）<br>
处理状态：pstatus （即申请的通过与否：succeed 和 failed）<br>
处理结果：result <br>


用户名：username <br>
查询部分：parted （哪一部分申请）<br>
 （待定）

**前端接收数据：**
```json
[{
    "status":"succeed",    
    "username":"xxx",
    "name":"xxx",
    "title":"xxx",
    "content":"xxx",
    "progress":"xxx",
    "pstatus":"succeed",
    "result":"申请通过"
},{
      "status":"succeed",    
      "username":"xxx",
      "name":"xxx",
      "title":"xxx",
      "content":"xxx",
      "progress":"xxx",
      "pstatus":"succeed",
      "result":"申请通过"
  },"....."]
```

**后端接收参数：**
*`接口：applicationList`*
```$xslt
        username=xxx&parted=xxx
```