# 校园教室管理系统最新

**Repository Path**: jiaton/CM

## Basic Information

- **Project Name**: 校园教室管理系统最新
- **Description**: CM:classroom management
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 2
- **Created**: 2018-12-04
- **Last Updated**: 2023-09-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 页面总览
|    页面名称    |       页面路径       |      数据接口     | 负责人|
|:--------------|:--------------------| ---------------------:|-------:|
|第一屏主页|/index.html里的详细内容 | | 肖琪|
 |个人资料（可以在首页右上角点击进入）|/personal_area.html  |/personal_data.action | 陈凤竹|
 |教室预约页面  |   /classrooms.html |/classrooms.action| 陈凤竹|
 |我的预约——待审核页面 | /member/list.html  |/history_my_waiting.action| 肖琪|
 |我的预约——已通过页面 |  /member/pass.html  |/history_my_passed.action| 肖琪|
 |普通管理员——待审核页面  | /admin/general_waiting.html  |/history_general_waiting.action| 汝泽|
 |普通管理员——已通过页面  | /admin/general_passed.html  |/history_general_passed.action| 汝泽|
 |高级管理员——待审核页面  | /admin/advanced_waiting.html  |/history_advanced_waiting.action| 汝泽|
 |高级管理员——已通过页面  | /admin/advanced_passed.html  |/history_advanced_passed.action| 汝泽|
 |高级管理员——用户管理  | /admin/user_management.html  |/users_*.action(*的内容为list/add/del)| 陈淇|
 |高级管理员——教室管理  |  /admin/classroom_management.html  |/classrooms_*.action(*的内容为list/add/del)| 陈淇|
 |高级管理员——数据统计  | /admin/statistic.html  || 暂时不用做|

## 接口定义
**大家仿照 “我的预约——待审核页面” 的格式 把自己页面的数据格式定义一下**
* 个人资料--/personal_data.action
    /*获取个人资料*/
    * 请求方式：GET
     ```javascript
    <!-- 查询JSON: -->
        {
            "userId": '用户id'
        }
    <!-- 返回数据JSON -->
        {
            'userName': '用户名',
            'stuNum': '学号',
            'sex': '性别',
            'major': '专业',
            'phone': '电话号码',
            'imgUrl': '用户头像（可为空）'
        }

    /*修改密码*/
   * 请求方式： GET
     ```javascript
        <!-- 查询JSON: -->
          {
              "userId": '用户id',
              'password': '原密码',
              'newPassword': '新密码',
          }
        <!-- 返回数据JSON -->
          {
              data: '提示信息（成功或失败）'
          }

* 教室预约页面--/classrooms.action
        <!-- 查询以后获取符合条件的教室信息 -->
    * 请求方式：POST
    ```javascript
        <!-- 查询JSON: -->
      {
          date: '预约日期',
          time: '预约时间段',
          value: '教室容量',
          state: '教室状态'
      }
         <!-- 返回数据JSON -->
      {
          data: [         //返回可用的教室列表
              {
                  classroomId: '教室编号',
                  date: '预约日期',
                  time: '预约时间段',
                  value: '教室容量',
                  state: '教室状态(可用)'
              },
              {
                  classroomId: '教室编号',
                  date: '预约日期',
                  time: '预约时间段',
                  value: '教室容量',
                  state: '教室状态（可用）'
              }
          ]
      }

      <!-- 点击预约按钮之后的接口 -->
    * 请求方式： POST
      ```javascript
              <!-- 查询JSON: -->
              {
                  "classroomId": '教室编号',
                  "userId": '用户id',
                  'reason': '预约理由'
              }
              <!-- 返回数据JSON -->
                {
                  data: '返回信息（如服务器错误或提交成功请等待管理员审核）'
                }
* 我的预约——待审核页面 /history_my_waiting.action
    * 请求方式：POST
    ```json
    <!-- 查询JSON: -->
        {
            "user_id":用户id
        }
        根据用户id查询处于待审核状态的记录
    <!-- 后端返回数据JSON -->
    {
        "tabledata" : [{
            "apply_id":11111,
            "apply_classroom_id": "6-2-108",
            "apply_date": "2018-12-03 10:10:11",
            "user_date": "2018-12-29",
            "purpose":"模拟考试",
            "apply_status":"待审核"
        }, {
            "apply_id":11111,
            "user_id": "13016722",
            "apply_classroom_id": "11-1-306",
            "apply_date": "2018-12-5 13:56:11",
            "user_date": "2018-12-15",
            "purpose":"组织自习",
            "apply_status":"待审核"
        }]
    }
    ```


* 我的预约——已通过页面 /history_my_passed.action
    * 请求方式：POST

        ```js
        <!-- 查询JSON: -->
            {
                "user_id":"用户id"
            }
            根据用户id查询已通过审核的记录的记录
        <!-- 后端返回数据格式 -->
        {
            tabledata: [{
            "apply_id":11111,
            "apply_classroom_id": "6-2-108",
            "apply_date": "2018-12-03 10:10:11",
            "user_date": "2018-12-29",
            "purpose":"模拟考试",
            "pass_time":"2018-12-05 10:10:11"
            }, {
            "apply_id":11111,
            "apply_classroom_id": "11-1-306",
            "apply_date": "2018-12-5 13:56:11",
            "user_date": "2018-12-15",
            "purpose":"组织自习",
            "pass_time":"2018-12-08 10:10:11"
            }]
        }
        ```

* 普通管理员——已通过页面 url：/history_general_passed.action
    * 请求方式：post

        ```javascript
         传入json：{}
         后台操作：页面加载，查询所有通过的教室申请
         请求json：[{
              "classroom_id": "7-4-211",
              "classroom_address": "7教4楼211教室",
              "user_id": "16000000",
              "classroomused_time": "2018-11-01 8:00-12:00",
              "user_reason": "召开班会"
                }, {
              "classroom_id": "12-1-106",
               "classroom_address": "12教1楼106教室",
                "user_id": "14050003",
                "classroomused_time": "2018-11-05 18:00-21:00",
                "user_reason": "组织活动"
                }.....]

        查询json：{"classroomused_time":"","classroom_Id":"","user_Id":""}
        后台操作:根据传入参数查询符合条件的历史教室使用信息
        请求json：[{
            "classroom_id": "7-4-211",
            "classroom_address": "7教4楼211教室",
            "user_id": "16000000",
            "classroomused_time": "2018-11-01 8:00-12:00",
            "user_reason": "召开班会"
        }, {
            "classroom_id": "12-1-106",
            "classroom_address": "12教1楼106教室",
            "user_id": "14050003",
            "classroomused_time": "2018-11-05 18:00-21:00",
            "user_reason": "组织活动"
        }]
        ```

* 普通管理员--待审核页面 /history_advanced_waiting.action
    * 请求方式：未知

        ```javascript
        传入json:{}
        后台操作:加载页面,显示所有普通管理员待审核信息
        请求json:[{
                           "apply_id":11111,
                           "user_id": "17008411",
                           "apply_classroom_id": "6-2-108",
                           "apply_date": "2018-12-03 10:10:11",
                           "user_date": "2018-12-29",
                           "purpose":"模拟考试",
                           "apply_status":"未处理"
                       }, {
                           "apply_id":11111,
                           "user_id": "13016722",
                           "apply_classroom_id": "11-1-306",
                           "apply_date": "2018-12-5 13:56:11",
                           "user_date": "2018-12-15",
                           "purpose":"组织自习",
                           "apply_status":"未处理"
                       }]

        传入json:{type: 0, passapplyId:" {"0":11111,"1":11111} "}     key 为序号   value 为apply_id
        后台操作:根据apply_id将指定的申请处理状态修改为!未通过!,查询未处理的教室预约返回。
        请求json:[{
            "apply_id":11111,
            "user_id": "17008411",
            "apply_classroom_id": "6-2-108",
            "apply_date": "2018-12-03 10:10:11",
            "user_date": "2018-12-29",
            "purpose":"模拟考试",
            "apply_status":"未处理"
        }, {
            "apply_id":11111,
            "user_id": "13016722",
            "apply_classroom_id": "11-1-306",
            "apply_date": "2018-12-5 13:56:11",
            "user_date": "2018-12-15",
            "purpose":"组织自习",
            "apply_status":"未处理"
        }]

        传入json:{type: 1, passapplyId: "{"0":11111,"1":11111}"}     key为序号value为apply_id
        后台操作:根据apply_id将指定的申请处理状态修改为,已通过,查询未处理的教室预约返回.
        Url:general_waiting.action
        请求数据:[{
            "apply_id":11111,
            "user_id": "17008411",
            "apply_classroom_id": "6-2-108",
            "apply_date": "2018-12-03 10:10:11",
            "user_date": "2018-12-29",
            "purpose":"模拟考试",
            "apply_status":"未处理"
        }, {
            "apply_id":11111,
            "user_id": "13016722",
            "apply_classroom_id": "11-1-306",
            "apply_date": "2018-12-5 13:56:11",
            "user_date": "2018-12-15",
            "purpose":"组织自习",
            "apply_status":"未处理"
        }]
        ```

* 高级管理员——待审核页面 /history_advanced_waiting.action
    * 请求方式：未知

        ```javascript
        传入json:null
        后台操作:加载页面,显示所有高级管理员待审核信息
        请求json:[{
             "apply_id":11111,
             "user_id": "17008411",
              "apply_classroom_id": "6-2-108",
              "apply_date": "2018-12-03 10:10:11",
               "user_date": "2018-12-29",
               "purpose":"模拟考试",
               "apply_status":"未处理"
             }, {
                "apply_id":11111,
               "user_id": "13016722",
                "apply_classroom_id": "11-1-306",
                 "apply_date": "2018-12-5 13:56:11",
                 "user_date": "2018-12-15",
                 "purpose":"组织自习",
                 "apply_status":"未处理"
            }]

        传入json:{type: 0, passapplyId:"{"0":11111,"1":11111}"}    key为序号   value为apply_id
        后台操作:根据apply_id将指定的申请处理状态修改为!未通过!查询未处理的教室预约返回.
        请求json:[{
            "apply_id":11111,
            "user_id": "17008411",
            "apply_classroom_id": "6-2-108",
            "apply_date": "2018-12-03 10:10:11",
            "user_date": "2018-12-29",
            "purpose":"模拟考试",
            "apply_status":"未处理"
        }, {
            "apply_id":11111,
            "user_id": "13016722",
            "apply_classroom_id": "11-1-306",
            "apply_date": "2018-12-5 13:56:11",
            "user_date": "2018-12-15",
            "purpose":"组织自习",
            "apply_status":"未处理"
        }]

        传入json:{type: 1, passapplyId: "{"0":11111,"1":11111}"}     key为序号   value为apply_id
        后台操作:根据apply_id将指定的申请处理状态修改为 !已通过!查询未处理的教室预约返回。
        请求json:[{
            "apply_id":11111,
            "user_id": "17008411",
            "apply_classroom_id": "6-2-108",
            "apply_date": "2018-12-03 10:10:11",
            "user_date": "2018-12-29",
            "purpose":"模拟考试",
            "apply_status":"未处理"
        }, {
            "apply_id":11111,
            "user_id": "13016722",
            "apply_classroom_id": "11-1-306",
            "apply_date": "2018-12-5 13:56:11",
            "user_date": "2018-12-15",
            "purpose":"组织自习",
            "apply_status":"未处理"
        }]
        ```

* 高级管理员——已通过页面 /history_advanced_passed.action
    * 请求方式：post

        ```javascript
        传入json:{}
        后台操作:加载页面,显示所有高级管理员已通过信息
         请求json:[{
                    "classroom_id": "7-4-211",
                    "classroom_address": "7教4楼211教室",
                    "user_id": "16000000",
                    "classroomused_time": "2018-11-01 8:00-12:00",
                    "user_reason": "召开班会"
                }, {
                    "classroom_id": "12-1-106",
                    "classroom_address": "12教1楼106教室",
                    "user_id": "14050003",
                    "classroomused_time": "2018-11-05 18:00-21:00",
                    "user_reason": "组织活动"
                }];

        传入数据:{"classroomused_time":"","classroom_Id":"","user_Id":""}
        后台操作:根据传入参数查询符合条件的历史教室使用信息
        请求数据:var tabledata =[{
            "classroom_id": "7-4-211",
            "classroom_address": "7教4楼211教室",
            "user_id": "16000000",
            "classroomused_time": "2018-11-01 8:00-12:00",
            "user_reason": "召开班会"
        }, {
            "classroom_id": "12-1-106",
            "classroom_address": "12教1楼106教室",
            "user_id": "14050003",
            "classroomused_time": "2018-11-05 18:00-21:00",
            "user_reason": "组织活动"
        }]
        ```

* 高级管理员——用户管理
    * 请求方式：POST
    ``` js

          <!-- 查询JSON 直接请求url: -->

          <!-- 返回数据JSON -->

        data:{
          "id": 1,
          "usernumber": 1601,
          "Realname": "chenqi",
          "role": "nihao"
        },
        {
           "id": 2,
           "usernumber": 1602,
           "Realname": "zhangliyuan",
           "role": "niyehao"
          }
         <!-- 增加用户 -->
        data: {
            "usernumber": usernumber,
            "Realname": realname,
            "email": email,
            "role": userrole_value,
            "password": password
        }

             <!-- 无返回数据 -->
            <!-- 删除用户 -->
         data: {
            "usernumber": number
                    }

           }
           <!-- 无返回数据 -->
          ```
* 高级管理员——教室管理
     * * 请求方式：POST

                <!-- 查询JSON 直接请求url: -->

                 <!-- 返回数据JSON -->

                  data:{
            "classroom_id": "7-4-211",
            "classroom_address": "7教4楼211教室",
            "classroom_capacity":"120",
            "classroom_usedtime": "2018-11-01 8:00-12:00",
            "used_times": "16"
                 },
{
            "classroom_id": "7-4-212",
            "classroom_address": "7教4楼212教室",
            "classroom_capacity":"120",
            "classroomused_time": "2018-11-01 8:00-20:00",
            "used_times": "46"
                  }
                 <!-- 增加教室 -->
                data: {
            "classroom_id": "7-4-212",
            "classroom_address": "7教4楼212教室",
            "classroom_capacity":"120",
            "classroomused_time": "2018-11-01 8:00-20:00",
            "used_times": "46"

                }

                     <!-- 无返回数据 -->
                    <!-- 删除教室 -->
                 data: {
                            "classroom_id": id,
                        },

                   }
               <!-- 无返回数据 -->
* 高级管理员——数据统计
    *


## 使用说明
* 有两个前端可选 默认WebContent 若要切换可在idea中设置web resource directory
## 左侧菜单 （这里是以前写的 以上面新加的内容为准）
* 个人资料（默认首页）：显示用户id 用户名
    * 页面名称：index.html
* 预约页面： 默认显示可预约教室 和每个教室的可预约时间
    * action:/get_classrooms.do
    * 页面名称：classrooms.html
    * 查询方法：按空闲时间查询 按教室号查询 action:/search_classrooms.do ，采用post请求
        ```javascript
        <!-- 查询json： -->
        {
            "condition":"time"|"id",
            "detail":如条件为时间段则为1（上午）| 2（下午）| 3（晚上）
                    如条件为id则为教室id
        }
        ```
    * 提交预约请求： action: /reserve.do 采用post请求
         ```javascript
        <!-- 提交请求json： -->
        {
            "id":教室id,
            "time":借用时间段 1（上午）| 2（下午） | 3（晚上）
        }
         ```

* 我的预约（可展开,展开后有待审核和已通过两个子页面）： action: /myhistory.do 采用post请求
    * 待审核：myhistory_waiting.html
    * 已通过: myhistory_passed.html

    ```javascript
    <!-- 查询json: -->
        {
            "id":用户id,
            "condition":"waiting"(待审核) | "passed"(已通过)
        }
    ```

* 普通管理界面（可展开）：
    action: general_manage.do
    * 待审核：general_waiting.html
    * 已通过: general_passed.html
* 高级管理界面（可展开）：
    action: advanced_manage.do
    * 待审核：advanced_waiting.html
    * 已通过: advanced_passed.html
    * 用户管理
    * 教室管理
    * 数据统计



## 数据库设计

* 调用存储过程用call，调用函数用select
* 返回单一值时是函数，无返回值或返回多个值时是存储过程
* 连接数据库记得try catch finally
* 因为编码类型使用的是最多三字节的utf8编码而不是utf8mb4，将不支持emoji和某些罕见字符
* 没有对借的天进行限制（比如只能查询和借七天以内的）
* 没有主动对权限进行限制，普通用户也可能调用所有函数
* 密码没有最小长度及其他复杂度限制

### 用户表

* 属性

    属性含义|真实字段名|真实类型|限制|备注
    ---|---|---|---|---
    学号|id|char(8)|<ul><li>最多8位</li><li>前后端需保证只含数字</li></ul>|主键
    姓名|name|varchar(8)|最多8个中英文字符
    密码|password|varchar(32)|无|此为加盐MD5后的结果，实际密码最多16位
    盐|salt|char(4)|最多4个字符|默认'6666'
    级别|level|enum('1', '2', '3')|只能是123|<ul><li>默认为1</li><li>分别代表用户、普通管理员、高级管理员</li></ul>
    头像|avatar|blob|最大64kb|没有时为null
    性别|sex|enum('男', '女', '其他')|只能是男女其他|
    专业|major|varchar(16)|最多16个中英文字符|没填时为null
    电话|phone|char(11)|最多11个数字|未限制只能为数字
    创建时间|createtime|timestamp|最多到2038年|自动生成

* 函数/存储过程

    函数作用|返回值|真实函数名称|函数参数|备注
    ---|---|---|---|---
    注册|无|register|见[CM.sql](./CM.sql#L54)|<ul><li>真实密码，最多16位</li><li>学号重复时会报错</li>
    登陆|bool|login|学号，密码|真实密码
    获取用户信息|见[CM.sql](./CM.sql#L27)|get_user_info|学号|
    用户已存在|bool|user_exist|学号|
    修改用户信息|无|modify_prof_conditional|见[CM.sql](./CM.sql#L72)|不变的传null
    修改用户级别|无|modify_level|学号，级别|
    修改用户密码|bool|modify_password|见[CM.sql](./CM.sql#L107)|新盐传null不会改变盐

### 教室表

* 属性

    属性含义|真实字段名|真实类型|限制|备注
    ---|---|---|---|---
    流水号|id|int(11) zerofill|无|<ul><li>主键</li><li>自动生成</li></ul>
    教学楼号|building|char(8)|最多8个中英文字符|
    教室号|room|char(8)|最多8个中英文字符|
    多媒体|multimedia|bool||默认为有
    借用次数|count|int unsigned|无|只能通过`add_classroom_count`增加
    容量|capacity|tinyint unsigned|无|未设置时为null
    唯一约束|未知，系统生成|unique index(building, room)|不能有教学楼号和教师号同时相同的记录|

* 函数/存储过程

    函数作用|返回值|真实函数名称|函数参数|备注
    ---|---|---|---|---
    获得教室流水号|int(11) zerofill|get_classroom_id|教学楼号，教室号|仅供内部使用
    获得教室信息|教学楼号，教室号，多媒体|get_classroominfo_conditional|不限的传null
    教室已存在|bool|classroom_exist|教学楼号，教室号
    添加教室|无|add_classroom|教学楼号，教室号，多媒体|幻读时会报错
    增加教室使用次数|无|add_classroom_count|教室流水号|

### 借用记录表

* 属性

    属性含义|真实字段名|真实类型|限制|备注
    ---|---|---|---|---
    流水号|id|int(11) zerofill|无|<ul><li>主键</li><li>自动生成</li></ul>
    教室流水号|classroomid|int(11) zerofill|外键约束参照教室表|
    要借的日期|borrowdate|date|只有日期，没有时间
    借用的时间段|borrowtime|enum('1', '2', '3')|只能是123|分别代表上午、下午、晚上
    借用人的学号|userid|char(8)|外键约束参照用户表|
    借教室的原因|reason|text|最多64kb|
    审核状态|status|enum('1', '2', '3' ,'4' ,'5')|只能是12345|分别代表待审核、普通管理员已通过、高级管理员已通过、已拒绝、已取消
    申请的时间|applytime|timestamp|最多到2038年|自动生成
    通过的时间|passtime|timestamp|最多到2038年|普通和高级管理员审批后都会更新
    唯一约束|未知，系统生成|unique index(borrowdate, borrowtime)|不能有要借的日期和借用的时间段同时相同的记录|

* 函数

    函数作用|返回值|真实函数名称|函数参数|备注
    ---|---|---|---|---
    获得借用记录流水号|int(11) zerofill|get_borrowlog_id|见[CM.sql](./CM.sql#L226)|
    根据学号获得记录|见[CM.sql](./CM.sql#L238)|get_borrowlog_by_userid|学号
    获得教室借用记录|见[CM.sql](./CM.sql#L202)|get_borrowlog_conditional|见[CM.sql](./CM.sql#L200)|不限的传null
    借教室|无|borrow|见[CM.sql](./CM.sql#L246)|
    取消借|无|borrow_cancle|借用记录流水号|状态123都可以取消借
    审批通过|无|borrow_cancle|借用记录流水号，级别|普通级别的用户调用此函数不会有效但不报错
    审批不通过|无|borrow_cancle|借用记录流水号|只有状态是1或2才会生效，否则无效但不报错

### 备注

未决定是否需要实现的功能：

* [ ] 【属性】教室人数大小
* [ ] 【函数】查询教室是否为空

不会实现的功能：

* [ ] 【功能】批量查询哪些教室为空
* [ ] 【功能】权限控制，哪些功能让普通用户用不了
* [ ] 【功能】删除教室

未确定实现是否合理的功能：

* [ ] 【函数】调整用户级别是否需要单独一个函数，修改其他所有不敏感信息用另一个函数
* [x] 【函数】取消借、审批通过、审批拒绝都是用流水号确定条目的，然而只有`get_borrowlog_id`返回了流水号，不清楚这样是否方便

不打算实现的功能：

* 【功能】通过邮箱找回密码