项目实训第五周第一次

微信PC端部分接口

教学管理接口

请求示例：

http://grandland.gl-data.com:14332/manage/activitymanage/xxx

1. 查询可用的教室

TODO:

查询可用的教室

URL	method
/find_avaiable_room	GET

传入数据	类型	说明
act_start_time	string	活动开始时间
act_end_time	string	活动结束时间

请求的返回数据格式如下：

[
  "测试教室1",
  "测试教室2"，
  "测试教室3"
]

返回数据	类型	说明
room_name	string	该时间范围内可以使用的教室名称

2. 查询教室的布局信息

TODO:

查询教室的布局信息

URL	method
/find_room_layout_by_room_name	GET

传入数据	类型	说明
room_name	string	需要查询的教室名称

请求的返回数据格式如下：

{
  "row": 4,
  "col": 4,
  "layout": "1101110111011101"
}

返回数据	类型	说明
row	int	所查询教室的行数
col	int	所查询教室的列数
layout	string	所查询教室的布局信息字符串，0表示过道，1表示座位

3. 创建教学活动

TODO:

创建教学活动

URL	method
/create_activity	POST

传入数据	类型	说明
act_name	string	活动名
act_desc	string	活动描述
act_start_time	string	活动开始时间
act_end_time	string	活动结束时间
room_name	string	活动占用的教室名称
pick_start_time	string	活动开始预约（选座）时间
pick_end_time	string	活动结束预约（选座）时间
sign_in_time	string	活动开始签到时间
sign_out_time	string	活动停止签退时间
act_seat_status	string	针对活动的座位状态字符串

返回值（int）	含义
-1	创建教室活动失败，存在某个字段为空
>=3	创建教学活动成功

4. 更新教学活动

TODO:

更新教学活动

URL	method
/update_activity	POST

传入数据	类型	说明
act_id	string	活动id
act_name	string	活动名
act_desc	string	活动描述
act_start_time	string	活动开始时间
act_end_time	string	活动结束时间
room_name	string	活动占用的教室名称
pick_start_time	string	活动开始预约（选座）时间
pick_end_time	string	活动结束预约（选座）时间
sign_in_time	string	活动开始签到时间
sign_out_time	string	活动停止签退时间
act_seat_status	string	针对活动的座位状态字符串

返回值（int）	含义
-1	更新教室活动失败，存在某个字段为空
>=2	更新教学活动成功

5. 删除教学活动

TODO:

删除教学活动

URL	method
/delete_activity	POST

传入数据	类型	说明
act_id	string	活动id

返回值（int）	含义
0	删除教室活动失败，该教学活动已经开始
>=2	删除教学活动成功

6. 查询所有尚未开始的活动

TODO:

查询所有尚未开始的活动

URL	method
/find_not_start_activity	GET

传入数据	类型	说明
无	无	无

请求的返回数据格式如下：

[
  {
    "act_id": 1,
    "act_name": "测试教学",
    "act_desc": "测试",
    "act_start_time": "2021-07-19 16:00:00",
    "act_end_time": "2021-07-19 18:00:00",
    "room_name": "测试教室",
    "pick_start_time": "2021-07-15 12:00:00",
    "pick_end_time": "2021-07-19 12:00:00",
    "sign_in_time": "2021-07-19 15:55:00",
    "sign_out_time": "2021-07-19 18:05:00"
    "qrcode": "iVBORw0KGgoAAAANSUhEUgAAAV4AAAFeAQAAAADlUEq3AAABCElEQVR42u3awQ6DIAyAYW48Njw2hyWdE7BFt+FpWejPyTSfnhpoqUHur0cAg8FgMBgM/g3Ooa8oUkIqr4chCHaLoxwPm9lwGoNgzzjvCdNwjZggGJz7JpMEDL4kUuwRMPh0AO25pEbAvrGpUXM0WTSrcsHLY7uyBbPuGLw81kYmtG63vdXrWLBbfGp19Qv9FbBbrH3u2PYKGNxLEd1q7JEE9o1tU2ML1wT2ja+FqyZSmTc14IXxteGVotfsX4a24PWxvROrQ9t6GJXJjgT2gN8OX6ZDW7ArbNve/OFnD7BPLCaLbk14wavj062IlPEGFewW28LVbCxHXoHdYv6sBoPBYDAY/B/4CXKFUJMlhIC6AAAAAElFTkSuQmCC"
  }
]

返回数据	类型	说明
act_id	int	活动id
act_name	string	活动名
act_desc	string	活动描述
act_start_time	date	活动开始时间
act_end_time	date	活动结束时间
room_name	string	活动所占教室名
pick_start_time	date	活动开始预约（选座）时间
pick_end_time	date	活动结束预约（选座）时间
sign_in_time	date	活动开始签到时间
sign_out_time	date	活动停止签退时间
qrcode	string	活动二维码的base64编码

7. 查询所有正在进行的活动

TODO:

查询所有正在进行的活动

URL	method
/find_go_on_activity	GET

传入数据	类型	说明
无	无	无

请求的返回数据格式如下：

[
  {
    "act_id": 1,
    "act_name": "测试教学",
    "act_desc": "测试",
    "act_start_time": "2021-07-19 16:00:00",
    "act_end_time": "2021-07-19 18:00:00",
    "room_name": "测试教室",
    "pick_start_time": "2021-07-15 12:00:00",
    "pick_end_time": "2021-07-19 12:00:00",
    "sign_in_time": "2021-07-19 15:55:00",
    "sign_out_time": "2021-07-19 18:05:00"
    "qrcode": "iVBORw0KGgoAAAANSUhEUgAAAV4AAAFeAQAAAADlUEq3AAABCElEQVR42u3awQ6DIAyAYW48Njw2hyWdE7BFt+FpWejPyTSfnhpoqUHur0cAg8FgMBgM/g3Ooa8oUkIqr4chCHaLoxwPm9lwGoNgzzjvCdNwjZggGJz7JpMEDL4kUuwRMPh0AO25pEbAvrGpUXM0WTSrcsHLY7uyBbPuGLw81kYmtG63vdXrWLBbfGp19Qv9FbBbrH3u2PYKGNxLEd1q7JEE9o1tU2ML1wT2ja+FqyZSmTc14IXxteGVotfsX4a24PWxvROrQ9t6GJXJjgT2gN8OX6ZDW7ArbNve/OFnD7BPLCaLbk14wavj062IlPEGFewW28LVbCxHXoHdYv6sBoPBYDAY/B/4CXKFUJMlhIC6AAAAAElFTkSuQmCC"
  }
]

返回数据	类型	说明
act_id	int	活动id
act_name	string	活动名
act_desc	string	活动描述
act_start_time	date	活动开始时间
act_end_time	date	活动结束时间
room_name	string	活动所占教室名
pick_start_time	date	活动开始预约（选座）时间
pick_end_time	date	活动结束预约（选座）时间
sign_in_time	date	活动开始签到时间
sign_out_time	date	活动停止签退时间
qrcode	string	活动二维码的base64编码

8. 查询所有正在进行的活动

TODO:

查询所有已经结束的活动

URL	method
/find_have_finish_activity	GET

传入数据	类型	说明
无	无	无

请求的返回数据格式如下：

[
  {
    "act_id": 1,
    "act_name": "测试教学",
    "act_desc": "测试",
    "act_start_time": "2021-07-19 16:00:00",
    "act_end_time": "2021-07-19 18:00:00",
    "room_name": "测试教室",
    "pick_start_time": "2021-07-15 12:00:00",
    "pick_end_time": "2021-07-19 12:00:00",
    "sign_in_time": "2021-07-19 15:55:00",
    "sign_out_time": "2021-07-19 18:05:00"
    "qrcode": "iVBORw0KGgoAAAANSUhEUgAAAV4AAAFeAQAAAADlUEq3AAABCElEQVR42u3awQ6DIAyAYW48Njw2hyWdE7BFt+FpWejPyTSfnhpoqUHur0cAg8FgMBgM/g3Ooa8oUkIqr4chCHaLoxwPm9lwGoNgzzjvCdNwjZggGJz7JpMEDL4kUuwRMPh0AO25pEbAvrGpUXM0WTSrcsHLY7uyBbPuGLw81kYmtG63vdXrWLBbfGp19Qv9FbBbrH3u2PYKGNxLEd1q7JEE9o1tU2ML1wT2ja+FqyZSmTc14IXxteGVotfsX4a24PWxvROrQ9t6GJXJjgT2gN8OX6ZDW7ArbNve/OFnD7BPLCaLbk14wavj062IlPEGFewW28LVbCxHXoHdYv6sBoPBYDAY/B/4CXKFUJMlhIC6AAAAAElFTkSuQmCC"
  }
]

返回数据	类型	说明
act_id	int	活动id
act_name	string	活动名
act_desc	string	活动描述
act_start_time	date	活动开始时间
act_end_time	date	活动结束时间
room_name	string	活动所占教室名
pick_start_time	date	活动开始预约（选座）时间
pick_end_time	date	活动结束预约（选座）时间
sign_in_time	date	活动开始签到时间
sign_out_time	date	活动停止签退时间
qrcode	string	活动二维码的base64编码

9. 查询选座详情

TODO:

查询选座详情

URL	method
/show_pick_seat	GET

传入数据	类型	说明
act_id	string	需要查询的活动id

请求的返回数据格式如下：

[
  {
    "row": 4,
    "col": 4,
    "room_seats": "1，0，2，3，4，0，5，6，7，0，8，9，10，0，11，12",
    "pick_info": "1022101110314015",
    "user_openid": "owTEX5ZalNHYdBYtlOThtV4H3wkY",
    "username": "测试用户",
    "seat_no": 1
  }
]

返回数据	类型	说明
row	int	该活动占用教室的行数
col	int	该活动占用教室的列数
room_seats	string	该活动占用教室的座位编号串，用逗号分隔
pick_info	string	选座信息串，其中0表示过道，1表示尚未被选择的座位，2表示不可使用的座位，3表示可能损坏的座位，4表示已经损坏的座位，5表示被选择的座位
user_openid	string	选座用户openid
username	string	选座用户用户名
seat_no	int	用户所选座位相对于所在教室的编号

10. 展示活动参加情况

TODO:

展示活动参加情况

URL	method
/show_activity_participation	GET

传入数据	类型	说明
act_id	string	需要查询的活动id

请求的返回数据格式如下：

[
  {
    "user_openid": "owTEX5ZalNHYdBYtlOThtV4H3wkY",
    "username": "测试用户",
    "sign_in": "1",
    "sign_out": "1",
    "seat_no": 1
  }
]

返回数据	类型	说明
user_openid	string	选座用户的openid
username	string	选座用户的用户名
sign_in	string	选座用户是否签到，其中1表示已签到，0表示未签到
sign_out	string	选座用户是否签退，其中1表示已签退，0表示未签退
seat_no	int	用户所选座位相对于所在教室的编号

10. 活动情况统计

TODO:

*** 活动情况统计***

URL	method
/statistic_activity	GET

传入数据	类型	说明
act_id	string	需要查询的活动id

请求的返回数据格式如下：

"10,8,2,3"

返回数据	类型	说明
statistics	string	采用逗号分割，第一个数字表示预约人员数，第二个数字表示签到人员数，第三个数字未签到人员数，第四个数字表示签到但未签离人员数

申诉管理接口

请求示例：

http://grandland.gl-data.com:14332/manage/appealmanage/xxx

1. 获取所有的申诉请求

TODO:

获取所有的申诉请求

URL	method
/find_all_appeal	GET

传入数据	类型	说明
无	无	无

请求的返回数据格式如下：

[
  {
    "appeal_id": 1,
    "act_name": "测试活动",
    "room_name": "测试教室",
    "seat_no": 1,
    "username": "测试用户",
    "appeal_time": "2021-07-25 21:07:27",
    "appeal_desc": "申诉测试",
    "appeal_result": 2,
    "appeal_remark": 无
  }
]

返回数据	类型	说明
appeal_id	int	申诉自增id
act_name	string	活动名
room_name	string	教室名称
seat_no	int	座位相对于所在教室的编号
username	string	小程序用户用户名
appeal_time	date	申诉提交的时间
appeal_desc	string	用户申诉的描述
appeal_result	string	管理员审核申诉的结果(‘0’,未通过)(‘1’,已通过)(‘2’,审核中)
appeal_remark	string	管理员对申诉理由的评价

2. 同意申诉请求

TODO:

同意申诉请求

URL	method
/agree_appeal	POST

传入数据	类型	说明
appeal_id	int	申诉自增id

返回值（int）	含义
0	错误，该申诉不是待审核的
4	同意用户的申诉
5	同意用户的申诉，并将是否禁止参加全部活动修改为否
6	同意用户的申诉，并将用户从黑名单中移除

3. 拒绝申诉请求

TODO:

拒绝申诉请求

URL	method
/disagree_appeal	POST

传入数据	类型	说明
appeal_id	String	申诉自增id
appeal_remark	String	管理员对申诉理由的评价

返回值（int）	含义
0	错误，该申诉不是待审核的
2	拒绝用户的申诉

报修管理接口

请求示例：

http://grandland.gl-data.com:14332/manage/repairmanage/xxx

1. 获取所有的报修请求

TODO:

获取所有的报修请求

URL	method
/find_all_repair	GET

传入数据	类型	说明
无	无	无

请求的返回数据格式如下：

[
  {
    "repair_id": 1,
    "room_name": "测试教室",
    "picture": "http://grandland.gl-data.com:14332/manage/picture/测试图片.jpg"
    "number": 1,
    "seat_no": 1,
    "user_openid": "owTEX5ZalNHYdBYtlOThtV4H3wkY",
    "username": "测试用户",
    "time": "2021-07-25 21:07:27",
    "repair_desc": "报修测试",
    "repaired": 2
  }
]

返回数据	类型	说明
repair_id	int	报修记录自增id
room_name	string	教室名称
picture	string	报修图片存放路径
number	int	手势认证数字
seat_no	int	座位相对于所在教室的编号
user_openid	string	报修的用户openid
username	string	小程序用户用户名
time	date	报修时间
repair_desc	string	损坏情况描述
repaired	string	是否已修复(‘0’,未修复)(‘1’,已修复)(‘2’,待审核)(‘3’,已拒绝)

2. 同意报修请求

TODO:

同意报修请求

URL	method
/agree_repair	POST

传入数据	类型	说明
repair_id	String	报修记录自增id

返回值（int）	含义
0	错误，该报修不是待审核的
3	同意用户的报修请求，从审核中变为未修复

3. 拒绝报修请求

TODO:

拒绝报修请求

URL	method
/disagree_repair	POST

传入数据	类型	说明
repair _id	String	报修记录自增id

返回值（int）	含义
0	错误，申诉不是待审核的
4	拒绝用户的申诉请求，从审核中变为已拒绝，且用户不可再报修

4. 修复座位

TODO:

修复座位

URL	method
/repair_seat	POST

传入数据	类型	说明
repair_id	String	报修记录自增id

返回值（int）	含义
0	错误，该报修不是未修复的
3	完成座位的修复，从未修复变为已修复