# Project5books

**Repository Path**: damn4374/project5books

## Basic Information

- **Project Name**: Project5books
- **Description**: 5books项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2021-07-10
- **Last Updated**: 2021-08-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 0 公用对象

## 0.0 响应的SysResult对象：

| 参数名 | 参数说明                   | 备注                                      |
|--------|----------------------------|-------------------------------------------|
| status | 状态信息                   | 200表示服务器请求成功， 201表示服务器异常 |
| msg    | 服务器返回时携带的提示消息 | 可为null                                  |
| data   | 服务器返回的业务数据       | 返回值为PageResult对象                    |

## 0.1 Book对象

| 参数名 | 参数类型 | 参数说明 | 备注       |
|--------|----------|----------|------------|
| name   | String   | 书籍名   | 不可为null |
| zan    | Integer  | 点赞数   | 不可为null |
| price  | Double   | 图书价格 | 不可为null |
| …      | …        | …        | …          |

# 1 前端展示

## 1.1 页面展示模块

### 1.1.1 网站首页

#### A. 全站搜索

| 功能描述 | 用户输入“书名关键字”后，在当前页面进行局部刷新，将符合的书籍按列表显示在页面上。                 |
|----------|--------------------------------------------------------------------------------------------------|
| 请求路径 | /book/searchall                                                                                  |
| 请求类型 | get                                                                                              |
| 请求参数 | 前端以封装的queryInfo对象为参数； 后端用PageResult对象接收,并返回含有Book对象数组的SysResult对象 |
| 示例     | http://localhost:8091/home/searchall?query=查询关键字\&pageNum=1 \&pageSize=15                   |
| 涉及表   | 图书表（book）                                                                                   |

queryInfo对象：

| 参数名   | 参数说明             | 备注                 |
|----------|----------------------|----------------------|
| query    | 用户输入的书籍关键字 | 不可为null           |
| pageNum  | 分页查询的页数       | 不可为null，默认为1  |
| pageSize | 分页查询的条,数      | 不可为null，默认为15 |

PageResult 对象

| 参数名   | 参数类型 | 参数说明         | 备注       |
|----------|----------|------------------|------------|
| query    | String   | 用户的书籍关键字 | 不可为null |
| pageNum  | Integer  | 查询页数         | 不可为null |
| pageSize | Integer  | 查询条数         | 不可为null |
| total    | Long     | 结果总条数       | 不可为null |
| rows     | Object   | 分页查询的结果   | 不可为null |

#### B. 按类展览书籍

>   暂分计算机、科普、文学、教程四个一级分类，在各一级分类下再分若干二级分类。目前暂定3个级别的分类。

| 功能描述 | 首页加载时自动加载书籍的三级标题                                 |
|----------|------------------------------------------------------------------|
| 请求路径 | /book/getmenulist                                                |
| 请求类型 | get                                                              |
| 请求参数 | 前端：无；后端返回包含有List\<BookCat\>类型对象的SysResult对象 |
| 示例     | http://localhost:8091/book/getmenulist                          |
| 涉及表   | 图书类别表（book_cat）                                           |

>   BookCat对象

| 参数名   | 类型              | 参数说明           | 备注       |
|----------|-------------------|--------------------|------------|
| id       | Integer           | 书籍各级标题的id   | 不可为null |
| name     | String            | 书籍各级标题的名字 | 不可为null |
| parentId | Integer           | 标题的父标题id     | 不可为null |
| level    | Integer           | 标题所在的级别     | 不可为null |
| children | List\<BookCat\> | 标题的子标题       | 可为null   |

#### C. 网站信息

##### 关于本站；

| 功能描述 | 超链接. 关于本站的一些信息，如建站信息、管理员信息等 |
|----------|------------------------------------------------------|
| 请求路径 | /home/about                                          |
| 请求类型 | get                                                  |
| 请求参数 | 无。后端返回一个包含本站消息字符串的SysResult对象    |
| 示例     | http://localhost:8091/home/about                     |
| 涉及表   | 网站信息表（about）                                  |

##### 联系管理员；

| 功能描述 | 超链接. 关于管理员的联系方式                          |
|----------|-------------------------------------------------------|
| 请求路径 | /home/contactus                                       |
| 请求类型 | get                                                   |
| 请求参数 | 无。后端返回一个字符串联系方式（邮箱）的SysResult对象 |
| 示例     | http://localhost:8091/home/contactus                  |
| 涉及表   | 用户表（user）                                        |

##### 捐助链接

| 功能描述 | 超链接. 点击后跳转捐助页面                |
|----------|-------------------------------------------|
| 请求路径 | /home/donate                              |
| 请求类型 | get                                       |
| 请求参数 | 无。后端返回包含字符串链接的SysResult对象 |
| 示例     | http://localhost:8091/home/donate         |
| 涉及表   | 网站信息表（about）                       |

### 1.1.2 书籍详情页

#### A. 书籍简介

>   左图右字，关于该书的基本信息

| 功能描述 | 用户点击书籍后, 跳转此页                                            |
|----------|---------------------------------------------------------------------|
| 请求路径 | /book/view                                                         |
| 请求类型 | get                                                                 |
| 请求参数 | 前端以userId、bookId为参数。后端返回一个包含Book对象的SysResult对象 |
| 示例     | http://localhost:8091/book/view?userid=xx&bookId=xx                |
| 涉及表   | 图书表（book）、操作记录表(user_opra)                               |

#### B. 下载（购买）

>   免费书籍显示下载按钮，付费书籍显示购买按钮

| 功能描述 | 用户点击下载/购买按钮后，跳转下载地址/支付地址                               |
|----------|------------------------------------------------------------------------------|
| 请求路径 | /book/download                                                              |
| 请求类型 | get                                                                          |
| 请求参数 | 前端以userId、bookId为参数。后端返回一个包含下载链接/支付链接的SysResult对象 |
| 示例     | http://localhost:8091/book/download?userid=xx&bookId=xx                     |
| 涉及表   | 图书表（book）、操作记录表(user_opra)                                        |

注意：下载数目限制——每一用户一天下载限额20本。

#### C. 收藏（加入购物车）

>   类似于加入购物车的功能，之后可以在收藏夹内进行批量操作

| 功能描述 | 点击后，前端图标变为已收藏，后端将数据加入“用户收藏表”      |
|----------|-------------------------------------------------------------|
| 请求路径 | /book/collections/                                         |
| 请求类型 | put                                                         |
| 请求参数 | 前端以userId、bookId为参数； 后端返回SysResult对象          |
| 示例     | http://localhost:8091/book/collections?userid=xx&bookId=xx |
| 涉及表   | 用户收藏表（user_coll）                                     |

#### D. 点赞

>   为后面准备推出的按点赞数排序、本站热榜的功能做铺垫

| 功能描述 | 点击后，前端显示点赞效果，后端将“图书表”的点赞值+1                    |
|----------|-----------------------------------------------------------------------|
| 请求路径 | /book/zan                                                            |
| 请求类型 | put                                                                   |
| 请求参数 | 前端以封装的zanInfo对象为参数； 后端用zan对象接收,并返回SysResult对象 |
| 示例     | http://localhost:8091/book /zan                                      |
| 涉及表   | 图书表（book）、操作记录表(user_opra)                                 |

>   zanInfo对象

| 参数名 | 参数说明                           | 备注       |
|--------|------------------------------------|------------|
| userId | 绑定点赞的用户对应的id             | 不可为null |
| bookId | 绑定点赞的图书对应的id             | 不可为null |
| status | 绑定点赞的状态（单击为1、双击为0） | 不可为null |

>   Zan对象

| 参数名 | 类型    | 参数说明                         | 备注       |
|--------|---------|----------------------------------|------------|
| userId | Integer | 点赞的用户对应的id               | 不可为null |
| bookId | Integer | 点赞的图书对应的id               | 不可为null |
| status | Boolean | 点赞的状态（单击点赞、双击取消） | 不可为null |

#### E. 评论

| 功能描述 | 在书籍下方的评论区域                                                          |
|----------|-------------------------------------------------------------------------------|
| 请求路径 | /book/comment                                                                |
| 请求类型 | put                                                                           |
| 请求参数 | 前端以封装的commentInfo对象为参数； 后端用Comment对象接收,并返回SysResult对象 |
| 示例     | http://localhost:8091/book/comment                                           |
| 涉及表   | 用户评论表（user_comm）、操作记录表(user_opra)                                |

>   commentInfo对象

| 参数名 | 参数说明               | 备注       |
|--------|------------------------|------------|
| userId | 绑定评论的用户对应的id | 不可为null |
| bookId | 绑定评论的图书对应的id | 不可为null |
| comm   | 评论的内容             | 不可为null |

>   Comment对象

| 参数名 | 类型    | 参数说明               | 备注       |
|--------|---------|------------------------|------------|
| userId | Integer | 绑定评论的用户对应的id | 不可为null |
| bookId | Integer | 绑定评论的图书对应的id | 不可为null |
| comm   | String  | 评论的内容             | 不可为null |

#### F. 举报

| 功能描述 | 书籍下方的举报按钮，单击举报，双击取消                                |
|----------|-----------------------------------------------------------------------|
| 请求路径 | /book/report                                                         |
| 请求类型 | put                                                                   |
| 请求参数 | 前端以userId、bookId为参数； 后端用Report对象接收,并返回SysResult对象 |
| 示例     | http://localhost:8091/book/ report?userid=xx&bookId=xx               |

>   Comment对象

| 参数名 | 类型    | 参数说明           | 备注       |
|--------|---------|--------------------|------------|
| userId | Integer | 举报的用户对应的id | 不可为null |
| bookId | Integer | 举报的图书对应的id | 不可为null |

#### G. 书籍预览

>   提供该书籍的前几页的预览，展示书籍情况，尤其是付费书籍的清晰度、版次信息等

## 1.2 用户模块

### 1.2.1 注册、登陆页

#### A. 游客登录

>   默认没有登录的用户提供游客账号，不能够发布、下载书籍，但是可以进行网站的正常浏览

#### B. 注册

>   在当前窗口打开一个新页面用手机号进行注册，同时需设定用户名、密码信息。

| 功能描述 | 用户用手机号注册，同时设定用户名和密码                   |
|----------|----------------------------------------------------------|
| 请求路径 | /user/addUser                                            |
| 请求类型 | post                                                     |
| 请求参数 | 前端以封装的signUpForm对象为参数； 后端返回SysResult对象 |
| 示例     | http://localhost:8091/user/ addUser                      |
| 涉及表   | 用户表（user）                                           |

>   signUpForm对象

| 参数名   | 参数说明   | 备注       |
|----------|------------|------------|
| phone    | 用户手机号 | 不可为null |
| username | 用户名     | 不可为null |
| password | 用户密码   | 不可为null |

#### C. 登陆

| 功能描述 | 用户用手机号登录                                                       |
|----------|------------------------------------------------------------------------|
| 请求路径 | /user/login                                                            |
| 请求类型 | post                                                                   |
| 请求参数 | 前端以封装的loginForm对象为参数； 后端返回带有token密钥的SysResult对象 |
| 示例     | http://localhost:8091/user/login                                       |
| 涉及表   | 用户表（user）                                                         |

>   loginForm对象

| 参数名   | 参数说明   | 备注       |
|----------|------------|------------|
| phone    | 用户手机号 | 不可为null |
| password | 用户密码   | 不可为null |

#### D. 找回密码

| 功能描述 | 手机验证码重置密码                                                     |
|----------|------------------------------------------------------------------------|
| 请求路径 | /user/repass                                                           |
| 请求类型 | post                                                                   |
| 请求参数 | 前端以封装的loginForm对象为参数； 后端返回带有token密钥的SysResult对象 |
| 示例     | http://localhost:8091/user/login                                       |
| 涉及表   | 用户表（user）                                                         |

### 1.2.2 用户个人中心

#### A. 消息通知

| 功能描述 | 用户收到的消息                                                   |
|----------|------------------------------------------------------------------|
| 请求路径 | /user/message                                                    |
| 请求类型 | get                                                              |
| 请求参数 | 前端以用户id为参数； 后端返回包含有string类型消息的SysResult对象 |
| 示例     | http://localhost:8091/user/message                               |
| 涉及表   | 管理员-用户表（admin\_user）                                     |

#### B. 发送消息（暂时不做）

| 功能描述 | 用户输入消息后，后端入库                                    |
|----------|-------------------------------------------------------------|
| 请求路径 | /user/message                                               |
| 请求类型 | post                                                        |
| 请求参数 | 前端以封装的msgtInfo对象为参数；后端返回无参的SysResult对象 |
| 示例     | http://localhost:8091/user/message                          |
| 涉及表   | 管理员-用户表（admin\_user）                                |

>   msgtInfo对象

| 参数名  | 参数说明             | 备注       |
|---------|----------------------|------------|
| from    | 发送消息的人对应的id | 不可为null |
| to      | 接收消息的人对应的id | 不可为null |
| message | 消息的内容           | 不可为null |

#### C. 账号信息显示

| 功能描述 | 进入此页后，显示用户的个人信息                          |
|----------|---------------------------------------------------------|
| 请求路径 | /user/profile                                           |
| 请求类型 | get                                                     |
| 请求参数 | 前端以userid为参数；后端返回含有User对象的SysResult对象 |
| 示例     | http://localhost:8091/user/ profile?userid=xx           |
| 涉及表   | 用户表（user）                                          |

>   User对象

| 参数名   | 类型    | 参数说明           | 备注       |
|----------|---------|--------------------|------------|
| id       | Integer | 相应用户对应的id   | 不可为null |
| name     | String  | 用户名             | 不可为null |
| password | String  | 用户的密码         | 不可为null |
| headAddr | String  | 用户头像的所在地址 | 不可为null |
| phone    | String  | 用户的手机号       | 不可为null |
| …        |         |                    |            |

#### D.账号信息修改

| 功能描述 | 头像设置                                                |
|----------|---------------------------------------------------------|
| 请求路径 | /user/ updateHead                                       |
| 请求类型 | put                                                     |
| 请求参数 | 前端以userid、headaddr为参数；后端返回无参SysResult对象 |
| 示例     | http://localhost:8091/user/ updateUser                  |
| 涉及表   | 用户表（user）                                          |

| 功能描述 | 用户名设置                                              |
|----------|---------------------------------------------------------|
| 请求路径 | /user/ updateName                                       |
| 请求类型 | put                                                     |
| 请求参数 | 前端以userid、username为参数；后端返回无参SysResult对象 |
| 示例     | http://localhost:8091/user/ updateName                  |
| 涉及表   | 用户表（user）                                          |

手机号修改：

流程：1. 解绑原手机号，验证通过后点击下一步进入新手机号的设置界面

![Image description](https://images.gitee.com/uploads/images/2021/0715/194959_1c11aefb_9209494.png "屏幕截图.png")

2.
绑定新手机号，验证成功则修改完成；验证失败则提示验证失败，可重新进行验证。三次验证失败则提示修改失败。

![Image description](https://images.gitee.com/uploads/images/2021/0715/195012_1174bf08_9209494.png "屏幕截图.png")

注意点：事务性修改，绑定新手机失败则回滚。

| 功能描述 | 新手机绑定                                           |
|----------|------------------------------------------------------|
| 请求路径 | /user/ updatePhone                                   |
| 请求类型 | put                                                  |
| 请求参数 | 前端以userid、phone为参数；后端返回无参SysResult对象 |
| 示例     | http://localhost:8091/user/ updatePhone              |
| 涉及表   | 用户表（user）                                       |

>   密码修改：

| 功能描述 | 密码修改：先输原密码，验证后再输新密码                  |
|----------|---------------------------------------------------------|
| 请求路径 | /user/ updatePwd                                        |
| 请求类型 | put                                                     |
| 请求参数 | 前端以userid、password为参数；后端返回无参SysResult对象 |
| 示例     | http://localhost:8091/user/ updatePwd                   |
| 涉及表   | 用户表（user）                                          |

#### E. 收藏夹

>   批量操作：删除、下载

>   单独操作：删除、下载

| 功能描述 | 用户的购物车，查出并显示                                          |
|----------|-------------------------------------------------------------------|
| 请求路径 | /user/collections                                                 |
| 请求类型 | get                                                               |
| 请求参数 | 前端以用户id为参数；后端返回含有UserCollection对象的SysResult对象 |
| 示例     | http://localhost:8091/user/ profile?userId=xx                     |
| 涉及表   | 用户收藏表（user\_coll）                                          |

| 功能描述 | 用户的购物车，批量操作并修改库再显示                                    |
|----------|-------------------------------------------------------------------------|
| 请求路径 | /user/collections                                                       |
| 请求类型 | post                                                                    |
| 请求参数 | 前端以userColl对象为参数；后端返回含有UserCollection对象的SysResult对象 |
| 示例     | http://localhost:8091/user/ profile                                     |
| 涉及表   | 用户收藏表（user\_coll）                                                |

>   userColl对象

| 参数名 | 参数说明                   | 备注                 |
|--------|----------------------------|----------------------|
| userId | 批量操作图书的用户对应的id | 不可为null           |
| bookId | 操作图书者对应的id         | 数组类型，不可为null |
| time   | 操作时的时间               | 不可为null           |

>   UserCollection对象

| 参数名 | 类型     | 参数说明           | 备注       |
|--------|----------|--------------------|------------|
| userId | Integer  | 收藏的用户对应的id | 不可为null |
| bookId | Integer  | 收藏的图书对应的id | 不可为null |
| time   | Datetime | 操作的时间         | 不可为null |

#### F. 用户操作记录

>   全部、浏览记录、上传记录、下载/购买记录

| 功能描述 | 显示用户的操作记录                                          |
|----------|-------------------------------------------------------------|
| 请求路径 | /user/operation                                             |
| 请求类型 | get                                                         |
| 请求参数 | 前端以userId为参数；后端返回含有UserOper对象的SysResult对象 |
| 示例     | http://localhost:8091/user/ operation？userid=xxx           |
| 涉及表   | 操作记录表（user_opra）                                     |

>   UserOper对象

| 参数名    | 类型     | 参数说明           | 备注       |
|-----------|----------|--------------------|------------|
| userId    | Integer  | 操作的用户对应的id | 不可为null |
| bookId    | Integer  | 操作的图书对应的id | 不可为null |
| time      | Datetime | 操作的时间         | 不可为null |
| operation | Integer  | 操作的名称         | 不可为null |

#### G. 上传书籍

>   书籍文件、名称、分类、简介

| 功能描述 | 用户上传书籍的接口                             |
|----------|------------------------------------------------|
| 请求路径 | /user/upload                                   |
| 请求类型 | post                                           |
| 请求参数 | 前端以userId为参数；后端返回SysResult对象      |
| 示例     | http://localhost:8091/user/ upload？userid=xxx |
| 涉及表   | 图书临时表（book_temp）、书籍图片表（book_pic）                        |

# 2 前端后台管理

## 2.1 用户管理模块

### 2.1.1 审核注册人员(暂时不做此功能)

### 2.1.2 管理已有用户

#### A. 权限设置

| 功能描述 | 禁止下载：管理员通过开关来禁止用户的下载权限                 |
|----------|--------------------------------------------------------------|
| 请求路径 | /user/banDown                                                |
| 请求类型 | put                                                          |
| 请求参数 | 前端以封装的banDown对象为参数。后端返回一个无参SysResult对象 |
| 示例     | http://localhost:8091/user/banDown                           |
| 涉及表   | 用户表（user）、操作记录表(user_opra)                        |

>   banDown对象

| 参数名    | 参数说明       | 备注       |
|-----------|----------------|------------|
| adminId   | 处理的管理员id | 不可为null |
| userId    | 被封禁的用户id | 不可为null |
| downRight | 下载权限的标识 | 不可为null |

| 功能描述 | 禁止上传：管理员通过开关来禁止用户的上传权限               |
|----------|------------------------------------------------------------|
| 请求路径 | /user/banUp                                                |
| 请求类型 | put                                                        |
| 请求参数 | 前端以封装的banUp对象为参数。后端返回一个无参SysResult对象 |
| 示例     | http://localhost:8091/user/banUp                           |
| 涉及表   | 用户表（user）、操作记录表(user_opra)                      |

>   banUp对象

| 参数名  | 参数说明       | 备注       |
|---------|----------------|------------|
| adminId | 处理的管理员id | 不可为null |
| userId  | 被封禁的用户id | 不可为null |
| upRight | 上传权限的标识 | 不可为null |

| 功能描述 | 账号封禁：管理员通过下拉框（1天/7天/1月/6月/永久）来设置封禁时间 |
|----------|------------------------------------------------------------------|
| 请求路径 | /user/banTime                                                    |
| 请求类型 | put                                                              |
| 请求参数 | 前端以封装的banInfo对象为参数。后端返回一个无参SysResult对象     |
| 示例     | http://localhost:8091/user/banTime                               |
| 涉及表   | 用户表（user）、操作记录表(user_opra)                            |

>   banInfo对象

| 参数名   | 参数说明       | 备注                  |
|----------|----------------|-----------------------|
| adminId  | 处理的管理员id | 不可为null            |
| userId   | 被封禁的用户id | 不可为null            |
| banRight | 账号封禁标识   | 不可为null            |
| banTime  | 账号的封禁时间 | 不可为null，默认为1天 |

#### B. 发送信息： 

| 功能描述 | 管理员通过此接口（文本输入区域）像指定用户发送违规警告、封禁通知、书籍审核结果等消息 |
|----------|--------------------------------------------------------------------------------------|
| 请求路径 | /user/message                                                                        |
| 请求类型 | put                                                                                  |
| 请求参数 | 前端以封装的msgtInfo对象为参数；后端返回无参的SysResult对象                          |
| 示例     | http://localhost:8091/user/message                                                   |
| 涉及表   | 管理员-用户表（admin\_user）                                                         |

>   msgtInfo对象

| 参数名  | 参数说明             | 备注       |
|---------|----------------------|------------|
| from    | 发送消息的人对应的id | 不可为null |
| to      | 接收消息的人对应的id | 不可为null |
| message | 消息的内容           | 不可为null |

## 2.2 书籍管理模块

### 2.2.1 审核用户上传的书籍：同意、拒绝

| 功能描述 | 通过查询图书临时表，审核用户上传的书籍，审核通过则入图书表并删除图书临时表中的条目；审核不通过则删除临时表条目，并给相应用户发送一个审核不通过的消息（内容固定写在后端中） |
|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 请求路径 | /book/addBook                                                                                                                                                             |
| 请求类型 | put                                                                                                                                                                        |
| 请求参数 | 前端以封装的addBook对象为参数。后端返回一个无参SysResult对象                                                                                                               |
| 示例     | http://localhost:8091/book/addBook                                                                                                                                        |
| 涉及表   | 图书临时表（book_temp）、图书表（book）、消息表(msg)                                                                                                                       |

>   addBook对象

| 参数名  | 参数说明       | 备注              |
|---------|----------------|-------------------|
| adminId | 审核的管理员id | 不可为null        |
| userId  | 上传者的id     | 不可为null        |
| opinion | 审核结果位     | 0：不通过 1：通过 |

### 2.2.2 管理已有书籍

#### A. 信息修改：名、价格、简介

| 功能描述 | 通过查询图书表，查看、修改书籍信息                              |
|----------|-----------------------------------------------------------------|
| 请求路径 | /book/ updateBook                                              |
| 请求类型 | put                                                             |
| 请求参数 | 前端以封装的updateBook对象为参数。后端返回一个无参SysResult对象 |
| 示例     | http://localhost:8091/book/ updateBook                         |
| 涉及表   | 图书表（book）、操作记录表(user_opra)                           |

>   updateBook对象

| 参数名   | 参数说明                 | 备注                             |
|----------|--------------------------|----------------------------------|
| adminId  | 操作的管理员id           | 不可为null                       |
| book对象 | 封装的修改后book具体信息 | 不可为null，这是一个对象中的对象 |

Book对象

| 参数名   | 参数类型 | 参数说明         | 备注              |
|----------|----------|------------------|-------------------|
| name     | String   | 书籍名           | 不可为null        |
| price    | Double   | 图书价格         | 不可为null        |
| status   | Integer  | 是否显示的标识位 | 0：隐藏； 1：显示 |
| downAddr | String   | 下载地址         | 不可为null        |
| intro    | String   | 简介             | 不可为null        |
| faceAdd  | String   | 封面图片的地址   | 不可为null        |
| …        | …        | …                | …                 |

#### C. 删除

| 功能描述 | 通过查询图书表，删除选中的书籍                               |
|----------|--------------------------------------------------------------|
| 请求路径 | /book/deleteBook                                            |
| 请求类型 | delete                                                       |
| 请求参数 | 前端以adminId、bookId为参数。后端返回一个无参SysResult对象   |
| 示例     | http://localhost:8091/book/ deleteBook?adminid=xx&bookid=xx |
| 涉及表   | 图书表（book）、操作记录表(user_opra)                        |

## 2.3 全站数据统计模块

### 2.3.1 书籍相关

#### A. 全站书籍总数

| 功能描述 | 统计全站书籍总数的接口                                         |
|----------|----------------------------------------------------------------|
| 请求路径 | /book/count                                                    |
| 请求类型 | get                                                            |
| 请求参数 | 前端参数: 无；后端返回包含有Integer类型书籍总数的SysResult对象 |
| 示例     | http://localhost:8091/user/ count                              |
| 涉及表   | 图书表（book）                                                 |

#### B. 每月新增书籍数、每月改动数

| 功能描述 | 通过查询符合时间区间的书籍总数，完成书籍的每月统计功能         |
|----------|----------------------------------------------------------------|
| 请求路径 | /book/moncount                                                 |
| 请求类型 | get                                                            |
| 请求参数 | 前端参数: 无；后端返回包含有Integer类型书籍总数的SysResult对象 |
| 示例     | http://localhost:8091/ book / moncount                         |
| 涉及表   | 图书描述表（book_desc）、操作记录表(user_opra)                 |

#### C. 全站书籍操作记录表

>   主要包括“时间、操作、人员”三个信息

| 功能描述 | 按时间顺序分页显示全站书籍的更改记录                    |
|----------|---------------------------------------------------------|
| 请求路径 | /book/allbookope                                        |
| 请求类型 | get                                                     |
| 请求参数 | 前端参数: 无；后端返回包含有UserOper对象的SysResult对象 |
| 示例     | http://localhost:8091/book/allbookope                   |
| 涉及表   | 操作记录表（user_opra）                                 |

>   UserOper对象

| 参数名    | 类型     | 参数说明           | 备注       |
|-----------|----------|--------------------|------------|
| userId    | Integer  | 操作的用户对应的id | 不可为null |
| bookId    | Integer  | 操作的图书对应的id | 不可为null |
| time      | Datetime | 操作的时间         | 不可为null |
| operation | Integer  | 操作的名称         | 不可为null |

### 2.3.2 用户相关

#### 实时统计全站的用户注册数目

| 功能描述 | 统计全站用户数目                                               |
|----------|----------------------------------------------------------------|
| 请求路径 | /user/alluser                                                  |
| 请求类型 | get                                                            |
| 请求参数 | 前端参数: 无；后端返回包含有Integer类型用户数目的SysResult对象 |
| 示例     | http://localhost:8091/ user/alluser                            |
| 涉及表   | 用户表（user）                                                 |

#### 每月新增用户数目

| 功能描述 | 统计全站每月新增用户数目                                           |
|----------|--------------------------------------------------------------------|
| 请求路径 | /user/monincre                                                     |
| 请求类型 | get                                                                |
| 请求参数 | 前端参数: 无；后端返回包含有Integer类型用户新增数目的SysResult对象 |
| 示例     | http://localhost:8091/ user/ monincre                              |
| 涉及表   | 用户表（user）                                                     |

#### 日活、月活数目

| 功能描述 | 统计全站日活数目                                               |
|----------|----------------------------------------------------------------|
| 请求路径 | /user/dayalive                                                 |
| 请求类型 | get                                                            |
| 请求参数 | 前端参数: 无；后端返回包含有Integer类型日活数目的SysResult对象 |
| 示例     | http://localhost:8091/ user/ dayalive                          |
| 涉及表   | 用户表（user）                                                 |

| 功能描述 | 统计全站月活数目                                               |
|----------|----------------------------------------------------------------|
| 请求路径 | /user/monalive                                                 |
| 请求类型 | get                                                            |
| 请求参数 | 前端参数: 无；后端返回包含有Integer类型月活数目的SysResult对象 |
| 示例     | http://localhost:8091/ user/ monalive                          |
| 涉及表   | 用户表（user）                                                 |

#### 实时在线人数

| 功能描述 | 统计全站的在线人数                                             |
|----------|----------------------------------------------------------------|
| 请求路径 | /user/online                                                   |
| 请求类型 | get                                                            |
| 请求参数 | 前端参数: 无；后端返回包含有Integer类型在线人数的SysResult对象 |
| 示例     | http://localhost:8091/ user/ online                            |
| 涉及表   | 用户表（user）                                                 |