# ExamStack

**Repository Path**: pharaoh1995/exam-stack

## Basic Information

- **Project Name**: ExamStack
- **Description**: NKD - 迎新考试系统
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-03-29
- **Last Updated**: 2021-03-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 项目概述
### 工程结构
```
ExamStack
├── Common -- Common公共模块
├── Portal -- 学生考试模块，学生考试功能
├── Management -- 后台管理模块，考试类别，试题库等信息管理
```
### 技术说明
- 本项目采用传统的war包构建方式，请先安装好tomcat，并集成在IDE中调试使用
- 前端使用jsp模板渲染，Bootstrap作为主要的UI库，同时使用jQuery
- 后端Spring + Mybatis + Cas
## 项目部署
### 1. portal
- 进入`ExamStack\portal\src\main\resources\env`，确认数据源配置，日志配置，redis配置是否有误
- 没有问题后，构建war包
    ``` 
    mvn clean package -pl portal -am  -Dmaven.test.skip=true -Pprod
    ```
- 将构建在`target`目录下的复制到`war-home`目录下
- 提交更新到gitlab后即可

### 2. management
- 进入`ExamStack\portal\src\main\resources\env`，确认数据源配置，日志配置，redis配置是否有误
- 没有问题后，构建war包
    ``` 
    mvn clean package -pl management -am  -Dmaven.test.skip=true -Pprod
    ```
- 将构建在`target`目录下的复制到`war-home`目录下
- 提交更新到gitlab后即可

### 3.补充
- 当然你觉得麻烦可以一次性打包
    ```
    mvn clean package -Dmaven.test.skip=true -Pprod
    ```
## 接口列表
在此处只列举`portal`的几个关键接口；其他不做具体解释   

接口 | 路径 | 入参 | 主要出参
---|---|---|---
获取考试token | /api/examToken | 招生系统编号，考试类别 | token
获取试卷 | /public/exam-start-new/{token} | token | 考试页面，包含试题
提交试卷及答题卡 | /public/exam-submit-token | AnswerSheet | 试卷记录编号
考试结果 | /public/finished-submit/{histId} | 试卷记录编号 | 结果页面，包含分数
核对答案 | /public/finished-submit-result/{histId} | 试卷记录编号 | 答案页面，包含试题，正确答案与所选答案

## 数据表说明
在此处只列举几个常用表；其他的在开发过程中熟悉了解 

表名 | 描述 | 说明
---|---|---
**et_field** | 考试类别表 | 
**et_knowledge_point** | 知识点信息表| `et_field`与此表为一对多关系，但目前需求，只要保持一对一即可，即一个类别保证有一个知识点信息
**et_question** | 试题库|`et_knowledge_point`与此表为多对多关系，但目前需求，只要保持一对一即可，即一个试题保证有一个知识点信息
**cfg_exam_paper** | 试卷配置信息|`et_field`与此表为一对一关系，`获取试卷`接口被调用时，对应类别的考试以此表数据准生成具体的试卷
**et_exam_paper_temp** | 试卷记录|`获取试卷`接口被调用生成的试卷保存至该表中，当考生重新获取试卷时，该考生之前的记录会被删除
**et_user_exam_history** | 试卷及答题记录|`提交试卷及答题卡`接口被调用生成的试卷保存至该表中，并永久保存，后期的**数据导出**工作以此表为准