该仓库未声明开源许可证文件(LICENSE),使用请关注具体项目描述及其代码上游依赖。
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README

智能空间管理系统ISMS

项目立项

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

项目成员:

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

项目经理:刘术林

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

一、项目概述

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

二、前台功能需求

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

三、后台功能需求

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

项目的功能模块

概念模型设计(E-R图)实体+属性

概念模型设计(E-R图)仅实体

逻辑模型设计(数据库表)

表结构设计:

用户表

字段 类型 描述 约束条件
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

回复

创建回复消息

接口地址: /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

删除

删除消息

接口地址:/isms/message/delete

请求方式:get

请求参数:

字段 类型 描述
id INT 消息id

返回参数:

删除回复

删除回复消息

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

请求方式:get

请求参数:

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

返回参数:

空文件

简介

暂无描述 展开 收起
Java 等 5 种语言
取消

发行版

暂无发行版

贡献者 (5)

全部

近期动态

不能加载更多了
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化