# ISMS

**Repository Path**: jaffehe/isms

## Basic Information

- **Project Name**: ISMS
- **Description**: 智能空间管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-11-07
- **Last Updated**: 2024-11-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智能空间管理系统ISMS

# 项目立项

- 项目名称：智能空间管理系统/平台
- 项目定位：为“团队”中的空闲空间，提供快速便捷的管理平台/系统
- 项目背景：在日常生活中，常常会存在空间资源浪费的情况，比如在学校内，一个学生想要去学习，图书馆离自己太远，寝室不适合学习，常会选择去教室学习，需要自己去寻找教室，这时会遇见以下几种情况：
    - 第一：需要一层一层的寻找无人上课的教室，需要耗费大量的时间；
    - 第二：找到了无人上课的教室，但是可能被学生会或社团占用，又需要重新寻找；
    - 第三：无人占用，但是使用的时长很短，可能刚用一会，就会有人来上课；
    - 以上问题都是因为无法正确的管理和分配空间所造成，而我们可以提供一个管理平台，让学生可以在线上看见教室的使用情况，提供清晰的空间使用情况、便捷的查找未使用的空间和快速分配空间
- 项目价值
    - 我们系统面对用户提供共有资源管理模板，若需添加功能可以定制专属系统。并且我们系统可以减少人力和物力的消耗，帮助团队合理的分配空间资源和管理资源，将空间资源合理的利用，避免空间资源的浪费，让管理者更好的管理资源，也让使用这更方便的使用，
- 项目规划
    - 5月27日前：完成项目的选题，并提交立项文档
    - 6月3日前：完成项目的需求分析、接口设计、库表设计和优化立项文档
    - 6月11日前：搭建项目的架构并完成团队的分工
    - 6月17日-7月8前：对项目进行开发，并完成项目部署

## **项目成员：**

- 组长：唐炫鸿
- 组员：倪鑫、黎泽龙、艾则孜•艾尔肯

## **项目经理：刘术林**

# 智能空间管理系统需求分析

## 一、项目概述

智能空间管理系统旨在实现共享空间资源的合理分配和高效使用，确保各项任务能够有序进行。系统包括前台和后台两个部分，前台面向用户，提供用户管理、组织管理、资源共享、使用记录和反馈等功能；后台面向管理人员，提供资源管理、小信箱、人员管理、权限管理和组织管理等功能。

## 二、前台功能需求

1. 用户模块
    - 登录：用户通过输入用户名和密码进行登录，系统验证用户信息后允许用户进入系统主页。
    - 注册：新用户填写注册信息（如用户名、密码、邮箱等）并提交，系统验证信息后创建新用户账号。
    - 修改个人信息：用户可修改个人信息，如密码、联系方式、个人简介等。
    - 退出：用户点击退出按钮后，系统将清除当前会话，用户需要重新登录。
2. 组织模块
    - 创建组织：已登录用户可填写组织信息（如组织名称、描述、目的等）并提交，系统验证后创建新组织，并允许用户设置组织管理员。
    - 加入组织：用户可浏览已存在的组织列表，选择要加入的组织并提交加入申请，组织管理员审核后决定是否接受申请。
3. 资源共享模块
    - 查看资源：用户可查看组织内共享的空间资源列表，包括资源名称、描述、状态、位置等。
    - 预订资源：用户可选择需要预订的资源，指定预订时间和使用时长，系统验证后完成预订。
    - 归还资源：用户在使用完资源后，需在系统上标记已归还，系统更新资源状态。
4. 使用记录
    - 添加使用记录：用户在使用资源后，需添加使用记录，包括使用时间、使用人、使用目的等，以便后续管理和审计。
5. 反馈信箱
    - 添加反馈信息：用户可向系统提交反馈信息，包括对资源、服务或系统的建议、问题或投诉。
    - 删除反馈信息：用户可删除自己提交的未处理的反馈信息。
    - 修改反馈信息：用户可修改自己提交的未处理的反馈信息。
    - 查看反馈信息：用户可查看自己提交的反馈信息及其处理状态。

## 三、后台功能需求

1. 资源管理
    - 新增资源：管理员可手动添加新的空间资源到系统中，包括填写资源的基本信息（如名称、描述、位置、容量等）和设置初始状态。
    - 资源信息管理：管理员可查看、添加、修改和删除资源信息，包括资源名称、描述、状态、位置、容量等。
    - 资源状态管理：管理员可实时更新资源的状态，如空闲、已预订、使用中、维护中等，并设置相应的使用规则和限制。
    - 资源的维护：管理员可对资源进行定期维护，并记录维护信息，如维护时间、维护内容等。
2. 小信箱
    - 查询反馈信息：管理员可查询用户提交的反馈信息，并进行处理，如回复、标记已处理等。管理员还可根据反馈信息进行系统优化和服务改进。
3. 组织模块
    - 人员管理
        - 添加人员：管理员可向组织添加新成员，并设置其权限和角色。
        - 查询人员：管理员可查询组织内所有成员的信息，包括姓名、联系方式、角色等。
        - 修改人员信息：管理员可修改组织成员的信息，如联系方式、角色等。
        - 删除人员：管理员可删除组织成员，同时处理其相关的资源和权限。
    - 权限管理4
        - 管理员：设置不同级别的管理员权限，如超级管理员、普通管理员等，确保系统安全稳定运行。
        - 用户：设置用户的权限，如资源预订、使用记录添加、查看反馈等，满足不同用户的需求。
    - 组织管理
        - 修改组织：管理员可修改组织的基本信息，如组织名称、描述等。
        - 注销组织：管理员可注销不再需要的组织，并处理相关资源和人员信息。
        - 查询组织：管理员可通过组织的名称查找已创建的组织
4. 退出
    - 管理员点击退出按钮后，系统将清除当前会话，管理员需要重新登录。

# 项目的功能模块
![](resource/gn.png)

# 概念模型设计（E-R图）实体+属性
![](resource/era.png)

# 概念模型设计（E-R图）仅实体
![](resource/er.png)

# 逻辑模型设计（数据库表）
![](resource/kb.png)



# 表结构设计：

# 用户表

| 字段 | 类型 | 描述 | 约束条件 |
| --- | --- | --- | --- |
| id | INT | 用户编号 | 主键 |
| name | VARCHAR(255) | 用户名 | 非空，唯一 |
| password | VARCHAR(255) | 用户密码 | 非空 |
| profile | TEXT | 用户简介 |  |
| mobile | VARCHAR(20) | 用户手机号码 | 非空，唯一 |
| email | VARCHAR(255) | 用户邮箱 |  |
| role | VARCHAR(50) | 用户角色 |  |
| org_id | INT | 组织编号 | 外键 |

# 资源表

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| id | INT | 资源编号 | 主键 |
| name | VARCHAR(255) | 资源名称 | 非空，唯一 |
| admin_id | INT | 管理员编号 | 外键 |
| org_id | INT | 组织编号 | 外键 |
| description | TEXT | 资源描述 |  |
| location | VARCHAR(255) | 资源位置 |  |
| capacity | INT | 资源容量 |  |
| occupants | INT | 正在使用人数 |  |
| status | ENUM | 资源状态 | empty 空闲, full 满, available 可用, maintaining 维护中 |

# 订单表

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| id | INT | 订单编号 | 主键 |
| user_id | INT | 用户编号 | 外键 |
| resource_id | INT | 资源编号 | 外键 |
| order_time | TIMESTAMP | 下单时间 |  |
| start_time | DATETIME | 预定开始时间 |  |
| end_time | DATETIME | 预定结束时间 |  |
| purpose | VARCHAR(255) | 使用目的 |  |

# 时间段表

（设计这个表是为了实现——实时查看资源在的预订情况，主要是指不同时间段的预订人数)

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| id | INT | 时间段编号 | 主键 |
| resource_id | INT | 资源编号 | 外键 |
| slot_start_time | TIME(3) | 时间段起始点 |  |
| slot_end_time | TIME(3) | 时间段结束点 |  |
| user_amount | INT | 在这时间段内预定人数 |  |

# 管理员表

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| id | INT | 管理员编号 | 主键 |
| name | VARCHAR(255) | 管理员名称 |  |
| org_id | INT | 组织编号 | 外键 |
| level | ENUM | 管理员级别 |  |

# 组织表

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| id | INT | 组织编号 | 主键 |
| name | VARCHAR(255) | 组织名称 | 非空，唯一 |
| description | TEXT | 组织描述 |  |

# 维护记录表

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| id | INT | 资源编号 | 主键 |
| resource_id | INT | 资源编号 | 外键 |
| admin_id | INT | 管理员编号 | 外键 |
| admin_name | VARCHAR(255) | 管理员名称 |  |
| resource_name | VARCHAR(255) | 资源名称 |  |
| start_time | DATETIME | 开始维护时间 |  |
| end_time | DATETIME | 结束维护时间 |  |
| content | TEXT | 维护内容 |  |

# 信箱表

| 字段 | 类型 | 可否为空 默认非 | 描述 |  |
| --- | --- | --- | --- | --- |
| id | INT |  | 消息编号 | 主键 |
| user_id | INT |  | 用户编号 | 外键 |
| user_name | VARCHAR(255) |  | 用户名称 |  |
| org_id | INT | 是 | 组织编号 | 当前所处组织id,可以为空 |
| org_name | VARCHAR(255) | 是 | 组织名称 |  |
| message_type | ENUM |  | 消息类型 | Application 申请, feedback 反馈, question 问题, complaint 投诉 |
| status | ENUM |  | 消息状态 | Draft  草稿， Sent 已发送， |
|  |  |  |  |  |
| update_time | INT |  | 最后修改时间 | 实现邮件的草稿功能。 |
| recipient_id | INT |  | 收件人id | 与收件组织id至少有一个。普通邮件填写本字段。 |
| recipient_org_id | INT |  | 收件组织id | 功能邮件必有此字段 |
| sent_time | TIMESTAMP |  | 消息发送时间 |  |
|  |  |  |  |  |
| user_msg | TEXT |  | 用户消息 |  |
| img_url | VARCHAR(255) | 是 | 图片链接 |  |

# 回复消息表

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| reply_msg_id | INT | 回复消息编号 | 主键 |
| inbox_msg_id | INT | 收件箱消息编号 | 外键 |
| org_id | INT | 组织编号 |  |
| org_name | INT | 组织名称 |  |
| reply_msg | TEXT | 回复消息 |  |
| update_time | TIMESTAMP | 更新时间 |  |
| sent_time | TIMESTAMP | 消息发送时间 |  |

# 使用记录表

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| user_id | INT | 用户编号 | 主键 |
| resource_id | INT | 资源编号 | 外键 |
| user_name | VARCHAR(255) | 用户名称 |  |
| resource_name | VARCHAR(255) | 资源名称 | 外键 |
| purpose | VARCHAR(255) | 使用目的 |  |
| start_time | TIMESTAMP | 开始时间 |  |
| end_time | TIMESTAMP | 结束时间 |  |

# 接口文档

# 用户模块

### 1.新建用户

接口地址： /isms/user/create

请求方式：post

请求参数：

| 说明 | 字段 | 类型 | 备注 | 是否必须 |
| --- | --- | --- | --- | --- |
| ID | id | int |  | 是 |
| 用户名 | username | string |  | 是 |
| 用户昵称 | nickname | string |  | 是 |
| 性别 | gander | string |  | 是 |
| 头像 | avatar | string |  | 否 |
| 密码 | password | string |  | 是 |
| 手机 | mobile | int |  | 否 |
| 邮箱 | email | string |  | 是 |
| 创建日期 | create_time | Date |  | 是 |
| 个性简介 | profile | string |  | 否 |

返回参数：

| 字段 | 说明 | 备注 | 类型 |
| --- | --- | --- | --- |
| code | 接口状态码 | 成功：
失败： | number |
| msg | 提示信息 | 成功：注册成功
用户名被占用：用户名已被占用
未知错误：发生未知错误请联系管理员为您解决 | string |

### 2.编辑用户信息

接口地址：/isms/v1/user/edit

请求方式：post

请求参数：

| 说明 | 字段 | 类型 | 备注 | 是否必须 |
| --- | --- | --- | --- | --- |
| ID | id | int | ID与用户名必须有其一 | 否 |
| 用户名 | username | string | ID与用户名必须有其一 | 否 |
| 用户昵称 | nickname | string |  | 否 |
| 性别 | gender | string |  | 否 |
| 密码 | password | string |  | 否 |
| 手机 | mobile | int |  | 否 |
| 邮箱 | email | string |  | 否 |
| 个性简介 | profile | string |  | 否 |

返回参数：

| 字段 | 说明 | 备注 | 类型 |
| --- | --- | --- | --- |
| code | 接口状态码 | 成功：1
失败：0或抛出异常 | int |
| msg | 提示信息 | 成功：修改成功
失败：发生未知错误请联系管理员为您解决 | string |

### 3.查询用户信息

接口地址：/isms/v1/user/select        

请求方式：post

请求参数：

| 说明 | 字段 | 类型 | 备注 | 是否必须 |
| --- | --- | --- | --- | --- |
| ID | id | int | ID与用户名必须有其一，优先ID查询 | 否 |
| 用户名 | username | string | ID与用户名必须有其一 | 否 |

返回参数：

| 字段 | 说明 | 类型 | 备注 |
| --- | --- | --- | --- |
| id | ID | int |  |
| username | 用户名 | string |  |
| nickname | 用户昵称 | string |  |
| gander | 性别 | string |  |
| avatar | 头像 | string |  |
| password | 密码 | string |  |
| mobile | 手机 | int |  |
| email | 邮箱 | string |  |
| create_time | 创建日期 | Date |  |
| profile | 个性简介 | string |  |

### 4.删除用户

接口地址：/isms/v1/user/delete

请求方式：post

请求参数：

| 说明 | 字段 | 类型 | 备注 | 是否必须 |
| --- | --- | --- | --- | --- |
| ID | id | int | ID与用户名必须有其一，优先ID查询 | 否 |
| 用户名 | username | string | ID与用户名必须有其一 | 否 |
| 密码 | password | string | 注销账号需要验证密码 | 是 |

返回参数：

| 字段 | 说明 | 备注 | 类型 |
| --- | --- | --- | --- |
| code | 接口状态码 | 成功：1
失败：0或抛出异常 | int |
| msg | 提示信息 | 成功：删除成功
失败：发生未知错误请联系管理员为您解决 | string |

### 5.登入

接口地址：post /isms/user/login

请求地址：post

请求参数：

| 说明 | 字段 | 类型 | 备注 | 是否必须 |
| --- | --- | --- | --- | --- |
| 用户名 | username | string |  | 是 |
| 密码 | password | string |  | 是 |

返回参数：

| 字段 | 说明 | 备注 | 类型 |
| --- | --- | --- | --- |
| code | 接口状态码 | 登录成功：1001
无用户名：1003
无此邮箱：1004
无手机号：1005
密码错误：1002 | int |
| msg | 提示信息 | 成功：登录成功
无用户名：该用户名尚未注册
无此邮箱：该邮箱尚未注册
无手机号：该手机号尚未注册
密码错误：密码错误 | string |

### 6.登出

接口地址：/isms/v1/user/logout

请求方式：post

请求参数：null

返回参数：

| 字段 | 说明 | 备注 | 类型 |
| --- | --- | --- | --- |
| code | 接口状态码 | 成功：1001
失败：0或抛出异常 | int |
| msg | 提示信息 | 成功：已退出登录
失败：发生未知错误请联系管理员为您解决 | string |

# 组织模块（前）：

### 创建组织

接口地址：/isms/organization/add_organization

请求方式：post

请求参数：OrgSaveParam

| 参数名称 | 参数说明 | 是否必须 | 数据类型 |
| --- | --- | --- | --- |
| orgSaveParam | orgSaveParam | true | orgSaveParam |
| id | 组织id | false | Integer |
| name | 组织名称 | true | string |
| description | 组织描述 | true | string |
| user_id | 用户id | true | Integer |
| role | 用户角色 | true | string |

返回参数：

| 参数名称 | 参数说明 | 类型 | 示例 |
| --- | --- | --- | --- |
| code | 内部状态码 | Integer |  |
| msg | 提示信息 | String | 操作成功；组织名被占用 |
| data | 响应数据 | String |  |

### 加入组织：

接口地址：/isms/organization/join_organization

请求方式：post

请求参数：OrgSaveParam

| 参数名称 | 参数说明 | 是否必须 | 数据类型 |
| --- | --- | --- | --- |
| orgSaveParam | orgSaveParam | true | orgSaveParam |
| id | 组织id | true | Integer |
| name | 组织名称 | false | string |
| description | 组织描述 | false | string |
| user_id | 用户id | true | Integer |
| role | 用户角色 | true | string |

响应参数：

| 参数名称 | 参数说明 | 类型 | 示例 |
| --- | --- | --- | --- |
| code | 内部状态码 | Integer |  |
| msg | 提示信息 | String | 操作成功；组织不存在 |
| data | 响应数据 | String |  |

# 组织模块（后）：

## 人员管理

### 添加人员

接口地址：/isms/organization/add_people

请求方式：post

请求参数：PeoSaveParam

| 参数名称 | 参数说明 | 是否必须 | 数据类型 |
| --- | --- | --- | --- |
| PeoSaveParam | PeoSaveParam | true | PeoSaveParam |
| user_id | 用户id | true | Integer |
| org_id | 组织id | true | Integer |
| role | 角色 | true | string |

响应参数：

| 参数名称 | 参数说明 | 类型 | 示例 |
| --- | --- | --- | --- |
| code | 内部状态码 | Integer |  |
| msg | 提示信息 | String | 操作成功；人员已存在 |
| data | 响应数据 | String |  |

### 查询人员

接口地址：/isms/organization/select_people

请求方式：get

请求参数：PeoQueryParam

| 参数名称 | 参数说明 | 是否必须 | 数据类型 |
| --- | --- | --- | --- |
| peoQueryParam | PeoQueryParam | true | peoSaveParam |
| user_id | 用户id | true | Integer |
| name | 用户名 | true | Integer |
| role | 角色 | true | string |

响应参数：

| 参数名称 | 参数说明 | 类型 | 示例 |
| --- | --- | --- | --- |
| code | 内部状态码 | Integer |  |
| msg | 提示信息 | String | 操作成功；查无此人 |
| data | 响应数据 | String | PeoInfoVO |

PeoInfoVO

| 参数名称 | 参数说明 | 是否必须 | 类型 |
| --- | --- | --- | --- |
| id | 用户id | true | Integer |
| name | 用户名 | true | String |
| password | 用户密码 | true | String |
| profile | 用户简介 | true | String |
| mobile | 用户手机号 | true | String |
| email | 用户邮箱 | true | String |
| role | 用户角色 | true | String |
| org_id | 组织id | true | Integer |
| name | 组织名 | true | String |
| description | 组织描述 | true | String |

### 修改人员信息

接口地址：/isms/organization/update_people_info

请求方式：post

请求参数：PeoUpdateParam

| 参数名称 | 参数说明 | 是否必须 | 数据类型 |
| --- | --- | --- | --- |
| peoUpdateParam | peoUpdateParam | true | peoUpdateParam |
| id | 用户id | true | Integer |
| name | 用户名 | false | Integer |
| profile | 用户简介 | false | String |
| mobile | 用户手机号 | false | String |
| email | 用户邮箱 | false | String |
| role | 用户角色 | false | String |
| org_id | 组织id | false | String |

响应参数：

| 参数名称 | 参数说明 | 类型 | 示例 |
| --- | --- | --- | --- |
| code | 内部状态码 | Integer |  |
| msg | 提示信息 | String | 操作成功；修改失败 |
| data | 响应数据 | String |  |

### 删除人员：

接口地址：/isms/organization/delete_people

请求方式：post

请求参数：

| 参数名称 | 参数说明 | 是否必须 | 数据类型 |
| --- | --- | --- | --- |
| id | 用户id | true | Integer |

响应参数：

| 参数名称 | 参数说明 | 类型 | 示例 |
| --- | --- | --- | --- |
| code | 内部状态码 | Integer |  |
| msg | 提示信息 | String | 操作成功；删除失败 |
| data | 响应数据 | String |  |

## 组织管理

### 修改组织

接口地址：/isms/organization/update_org_info

请求方式：post

请求参数：OrgUpdateParam

| 参数名称 | 参数说明 | 是否必须 | 数据类型 |
| --- | --- | --- | --- |
| id | 组织id | true | Integer |
| name | 组织名 | true | String |
| description | 组织描述 | true | String |

响应参数：

| 参数名称 | 参数说明 | 类型 | 示例 |
| --- | --- | --- | --- |
| code | 内部状态码 | Integer |  |
| msg | 提示信息 | String | 操作成功；修改失败 |
| data | 响应数据 | String |  |

### 注销组织

接口地址：/isms/organization/delete_org

请求方式：post

请求参数：

| 参数名称 | 参数说明 | 是否必须 | 数据类型 |
| --- | --- | --- | --- |
| id | 组织id | true | Integer |

响应参数：

| 参数名称 | 参数说明 | 类型 | 示例 |
| --- | --- | --- | --- |
| code | 内部状态码 | Integer |  |
| msg | 提示信息 | String | 操作成功；删除失败 |
| data | 响应数据 | String |  |

# 资源模块

### **添加资源**

- 请求方式：post
- 接口地址：/isms/resource/addResource
- 请求参数：

| 字段 | 类型 | 描述 |
| --- | --- | --- |
| name | VARCHAR(255) | 资源名称 |
| adminName | VARCHAR(255) | 管理员名称 |
| orgName | VARCHAR(255) | 组织名称 |
| description | TEXT | 资源描述 |
| location | VARCHAR(255) | 资源位置 |
| capacity | INT | 资源容量 |
- 响应参数：

| 字段 | 说明 | 备注 | 类型 |
| --- | --- | --- | --- |
| code | 接口状态码 | 成功：1001 失败：0或抛出异常 | int |
| msg | 提示信息 | 成功：添加成功  失败：添加失败 | string |

### 删除资源

- 请求方式：delete
- 接口地址：/isms/resource/deleteResource
- 请求参数：

| 字段 | 类型 | 描述 | 数据库表名 |
| --- | --- | --- | --- |
| name | VARCHAR(255) | 资源名称 | resource |
- 响应参数：

| 字段 | 说明 | 备注 | 类型 |
| --- | --- | --- | --- |
| code | 接口状态码 | 成功：1001 失败：0或抛出异常 | int |
| msg | 提示信息 | 成功：删除成功  失败：删除失败 | string |

### 更改资源

- 请求方式：put
- 接口地址：/isms/resource/alterResource
- 请求参数：

| 字段 | 类型 | 描述 |
| --- | --- | --- |
| name | VARCHAR(255) | 资源名称 |
| adminName | VARCHAR(255) | 管理员名称 |
| orgName | VARCHAR(255) | 组织名称 |
| description | TEXT | 资源描述 |
| location | VARCHAR(255) | 资源位置 |
| capacity | INT | 资源容量 |
- 响应参数：

| 字段 | 说明 | 备注 | 类型 |
| --- | --- | --- | --- |
| code | 接口状态码 | 成功：1001 失败：0或抛出异常 | int |
| msg | 提示信息 | 成功：更改成功  失败：更改失败 | string |

### 查询资源

- 请求方式：get
- 接口地址：/isms/resource/checkResouce
- 请求参数：

| 字段 | 类型 | 描述 |
| --- | --- | --- |
| name | VARCHAR(255) | 资源名称 |
| adminName | VARCHAR(255) | 管理员名称 |
| orgName | VARCHAR(255) | 组织名称 |
| description | TEXT | 资源描述 |
| location | VARCHAR(255) | 资源位置 |
| capacity | INT | 资源容量 |
- 响应参数：

| 字段 | 类型 | 描述 |
| --- | --- | --- |
| name | VARCHAR(255) | 资源名称 |
| adminName | VARCHAR(255) | 管理员名称 |
| orgName | VARCHAR(255) | 组织名称 |
| description | TEXT | 资源描述 |
| location | VARCHAR(255) | 资源位置 |
| capacity | INT | 资源容量 |

### 维护资源记录

- 请求方式：post
- 接口地址：/isms/resource/maintain
- 请求参数：

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| resource_id | INT | 资源编号 | 外键 |
| admin_id | INT | 管理员编号 | 外键 |
| admin_name | VARCHAR(255) | 管理员名称 |  |
| resource_name | VARCHAR(255) | 资源名称 |  |
| start_time | DATETIME | 开始维护时间 | 主键 |
| end_time | DATETIME | 结束维护时间 |  |
| content | TEXT | 维护内容 |  |
- 响应参数：

| 字段 | 说明 | 备注 | 类型 |
| --- | --- | --- | --- |
| code | 接口状态码 | 成功：1001 失败：0或抛出异常 | int |
| msg | 提示信息 | 成功：记录成功  失败：记录失败 | string |

### 共享资源：（状态查询，资源预定，资源分配，资源收回）

### 状态查询

- 请求方式：post
- 接口地址：/isms/resource
- 请求参数：

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| resource_id | INT | 资源编号 | 外键 |
| slot_start_time | TIME(3) | 时间段起始点 |  |
| slot_end_time | TIME(3) | 时间段结束点 |  |
| user_amount | INT | 在这时间段内预定人数 |  |
- 响应参数：

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| id | INT | 时间段编号 | 主键 |
| slot_start_time | TIME(3) | 时间段起始点 |  |
| slot_end_time | TIME(3) | 时间段结束点 |  |
| user_amount | INT | 在这时间段内预定人数 |  |

### 资源预定

- 请求方式：post
- 接口地址：/isms/resource
- 请求参数：

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| id | INT | 订单编号 | 主键 |
| user_id | INT | 用户编号 | 外键 |
| resource_id | INT | 资源编号 | 外键 |
| order_time | TIMESTAMP | 下单时间 |  |
| start_time | DATETIME | 预定开始时间 |  |
| end_time | DATETIME | 预定结束时间 |  |
| purpose | VARCHAR(255) | 使用目的 |  |
- 响应参数：

| 字段 | 说明 | 备注 | 类型 |
| --- | --- | --- | --- |
| code | 接口状态码 | 成功：1001 失败：0或抛出异常 | int |
| msg | 提示信息 | 成功：更改成功  失败：更改失败 | string |

# 信箱

## 新建消息

> 用户点击新建消息按钮或申请事件等到前置请求
> 

接口地址：/isms/message/create

请求方式：post

请求参数:

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| id | INT | 消息编号 |  |
| user_id | INT | 用户编号 |  |
| user_name | VARCHAR(255) | 用户名称 |  |
| org_id | INT | 组织编号 |  |
| org_name | VARCHAR(255) | 组织名称 |  |
| message_type | ENUM | 消息类型 | Application 申请, feedback 反馈, question 问题, complaint 投诉 |
| recipient_id | INT | 收件人id |  |
| recipient_org_id | INT | 收件组织id |  |

返回参数：

## 保存/更改

> 保存或修改草稿。
> 

接口地址：/isms/message/save

请求方式：post

请求参数：

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| id | INT | 消息编号 |  |
| user_id | INT | 用户编号 |  |
| user_name | VARCHAR(255) | 用户名称 |  |
| org_id | INT | 组织编号 |  |
| org_name | VARCHAR(255) | 组织名称 |  |
| message_type | ENUM | 消息类型 | Application 申请, feedback 反馈, question 问题, complaint 投诉 |
| recipient_id | INT | 收件人id |  |
| recipient_org_id | INT | 收件组织id |  |

返回参数：

## 发送

> 发送消息或申请
> 

接口地址：/isms/message/sent 

请求方式：post

请求参数:

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| id | INT | 消息编号 |  |
| recipient_id | INT | 收件人id | 收件方至少有一个 |
| recipient_org_id | INT | 收件组织id |  |

返回参数：

## 查看信箱

> 获取所有邮件信息。
> 

接口地址：/isms/message/get_list

请求方式：get

请求参数:

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| id | INT | 当前用户id | 必选 |
| organization_id | INT	 | 组织id | 若有此参数，则值查看当前组织中的消息 |

返回参数： data: List<MessageVO>

## 回复

> 创建回复消息
> 

接口地址: /isms/message/reply/create

请求方式：post

请求参数：

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| reply_msg_id | INT | 回复消息编号 |  |
| inbox_msg_id  | INT  | 起始消息编号 |  |
| org_id | INT | 组织编号 |  |
| org_name | TEXT |  |  |
| update_time | TIMESTAMP | 更新时间 |  |
| sent_time | TIMEsTAMP | 发送时间 |  |

返回参数：

## 查询所有回复

> 查看一条消息下的所有回复
> 

接口地址: /isms/message/reply/get_list

请求方式：

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| inbox_msg_id | INT | 起始消息编号 |  |

返回参数：List<ReplyVO>

## 删除

> 删除消息
> 

接口地址：/isms/message/delete

请求方式：get

请求参数：

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| id | INT | 消息id |  |

返回参数：

## 删除回复

> 删除回复消息
> 

接口地址：/isms/message/reply/delete

请求方式：get

请求参数：

| 字段 | 类型 | 描述 |  |
| --- | --- | --- | --- |
| reply_msg_id | INT | 回复消息编号 |  |

返回参数：