图书借阅管理系统

项目简介

这是一个完整的图书借阅管理平台，包含微信小程序端和PC管理后台。系统实现了图书展示、分类浏览、图书借阅、归还管理、收藏、评价等核心功能，采用前后端分离架构，适合作为微信小程序全栈开发学习项目或计算机设计参考。

技术栈

后端技术

技术	版本/说明
运行环境	Node.js
Web框架	Express 4.16.1
数据库	MySQL 5.7+
数据库驱动	mysql / mysql2
身份认证	jsonwebtoken (JWT)
文件上传	multer
跨域处理	cors
UUID生成	uuid
热重载	nodemon

管理后台技术

技术	版本/说明
前端框架	Vue 2.6.11
UI组件库	Element UI 2.15.6
路由管理	Vue Router 3.0.7
状态管理	Vuex 3.4.0
HTTP请求	Axios 0.24.0
图表库	ECharts 5.3.1
富文本编辑器	Quill 1.3.7
CSS预处理器	Less

小程序端技术

技术	版本/说明
开发框架	微信小程序原生框架
开发语言	JavaScript (ES6+)
样式语言	WXSS
模板语言	WXML

项目特点

• 前后端分离：后端提供RESTful API，前端独立开发部署
• 完整借阅流程：涵盖图书浏览、收藏、借阅、归还全流程
• 多角色管理：支持管理员和普通用户角色
• 借阅限制：支持设置每本书的借阅数量限制
• 数据可视化：管理后台集成ECharts图表展示
• 富文本支持：支持富文本图书详情编辑和展示

功能模块

小程序端功能

1. 首页模块 (pages/index)

• 轮播图展示
• 图书分类导航
• 热门图书推荐
• 新书上架展示
• 搜索功能入口

2. 书架模块 (pages/cate)

• 按分类浏览图书
• 分类列表展示
• 图书筛选

3. 图书详情模块 (pages/detail)

• 图书封面展示
• 图书基本信息（书名、作者、简介）
• 图书详情富文本展示
• 收藏功能
• 加入收藏夹
• 立即借阅

4. 搜索模块 (pages/search)

• 关键词搜索
• 搜索结果展示
• 搜索历史

5. 收藏夹模块 (pages/shopCart)

• 收藏图书列表
• 图书数量修改
• 移除收藏
• 批量借阅

6. 借阅订单模块

• 借阅确认 (pages/comfirm)
• 借阅记录列表 (pages/orderList)
• 借阅详情 (pages/orderDetail)
• 借阅状态查看（已借阅/已归还）

7. 评价模块 (pages/comment)

• 图书评价
• 评价列表查看

8. 个人中心模块 (pages/my)

• 用户信息展示
• 我的收藏 (pages/star)
• 我的借阅
• 问题反馈 (pages/question)
• 用户信息编辑 (pages/userInfo)

管理后台功能

1. 首页仪表盘 (Welcome.vue)

• 数据统计概览
• 借阅图表展示

2. 分类管理 (Cate)

• 图书分类列表
• 新增/编辑/删除分类
• 分类图标上传

3. 图书管理 (Product)

• 图书信息列表
• 新增/编辑/删除图书
• 图书封面上传
• 热门/新书标记
• 富文本详情编辑
• 借阅限制设置

4. 借阅管理 (Order)

• 借阅记录列表
• 借阅状态管理（已借阅/已归还）
• 借阅详情查看

5. 用户管理 (User.vue)

• 用户列表
• 用户信息查看
• 用户状态管理

6. 收藏管理 (Star.vue)

• 收藏记录列表
• 收藏统计

7. 问题反馈 (Question.vue)

• 用户反馈列表
• 回复处理

项目结构

library-management-system/
├── admin/                          # 管理后台（Vue2 + Element UI）
│   ├── public/                     # 静态资源
│   ├── src/
│   │   ├── api/                    # API接口封装
│   │   ├── assets/                 # 静态资源
│   │   ├── components/             # 公共组件
│   │   ├── filters/                # 过滤器
│   │   ├── router/                 # 路由配置
│   │   ├── store/                  # Vuex状态管理
│   │   ├── utils/                  # 工具函数
│   │   ├── views/                  # 页面视图
│   │   │   ├── Cate/               # 分类管理
│   │   │   ├── Order/              # 借阅管理
│   │   │   ├── Product/            # 图书管理
│   │   │   ├── Home.vue            # 主布局
│   │   │   ├── Login.vue           # 登录页
│   │   │   ├── Question.vue        # 问题反馈
│   │   │   ├── Star.vue            # 收藏管理
│   │   │   ├── User.vue            # 用户管理
│   │   │   └── Welcome.vue         # 首页仪表盘
│   │   ├── App.vue                 # 根组件
│   │   └── main.js                 # 入口文件
│   ├── package.json
│   └── vue.config.js               # Vue配置
│
├── express/                        # 后端服务（Express + MySQL）
│   ├── bin/
│   │   └── www                     # 启动入口
│   ├── config/
│   │   ├── db.js                   # 数据库配置
│   │   └── index.js                # 全局配置
│   ├── public/
│   │   └── images/                 # 上传图片存储
│   ├── routes/
│   │   ├── admin/                  # 管理端API
│   │   ├── web/                    # 小程序端API
│   │   ├── index.js                # 路由入口
│   │   └── upload.js               # 文件上传
│   ├── util/
│   │   ├── index.js                # 工具函数
│   │   └── wechat.js               # 微信相关工具
│   ├── app.js                      # Express应用配置
│   └── package.json
│
├── min/                            # 微信小程序
│   ├── components/                 # 自定义组件
│   │   ├── productItem/            # 图书列表项组件
│   │   └── wxParse/                # 富文本解析组件
│   ├── images/                     # 图片资源
│   │   ├── order/                  # 订单相关图标
│   │   └── tabbar/                 # TabBar图标
│   ├── pages/                      # 页面目录
│   │   ├── index/                  # 首页
│   │   ├── cate/                   # 书架分类
│   │   ├── detail/                 # 图书详情
│   │   ├── search/                 # 搜索页
│   │   ├── shopCart/               # 收藏夹
│   │   ├── comfirm/                # 借阅确认
│   │   ├── orderList/              # 借阅记录
│   │   ├── orderDetail/            # 借阅详情
│   │   ├── comment/                # 评价页
│   │   ├── star/                   # 我的收藏
│   │   ├── my/                     # 个人中心
│   │   ├── userInfo/               # 用户信息
│   │   └── question/               # 问题反馈
│   ├── utils/
│   │   ├── api.js                  # API接口封装
│   │   ├── request.js              # 请求封装
│   │   ├── feedback.js             # 反馈工具
│   │   └── util.js                 # 工具函数
│   ├── app.js                      # 小程序入口
│   ├── app.json                    # 小程序配置
│   ├── app.wxss                    # 全局样式
│   └── project.config.json         # 项目配置
│
├── 截图/                            # 项目截图
├── 图书资源/                        # 图书图片资源
├── library.sql                     # 数据库SQL文件
├── mysql.sh                        # MySQL脚本
├── mysql操作手册.md                 # MySQL操作说明
├── 数据库创建方法.md                # 数据库创建说明
├── 新 - 运行必读.docx              # 运行说明文档
├── 图书管理系统.xmind              # 项目思维导图
├── 图书管理-小程序.mp4              # 小程序演示视频
└── 图书管理-admin.mp4              # 管理后台演示视频

数据模型

用户表 (user)

{
  id: int,                    // 用户ID
  phone: varchar(11),         // 手机号
  password: varchar(100),     // 密码
  username: varchar(10),      // 用户名
  nickname: varchar(255),     // 昵称
  openId: varchar(100),       // 微信OpenID
  avatar: varchar(1000),      // 头像
  sex: int,                   // 性别
  role: int,                  // 角色 (0普通用户, 99管理员)
  active: int,                // 状态 (0禁用, 1正常)
  create_time: timestamp,     // 创建时间
  update_time: timestamp      // 更新时间
}

图书表 (product)

{
  id: int,                    // 图书ID
  title: varchar(255),        // 书名
  content: longtext,          // 图书详情（富文本）
  cover: varchar(255),        // 封面图
  imgs: longtext,             // 图集
  is_hot: int,                // 是否热门 (0否 1是)
  is_new: int,                // 是否新书 (0否 1是)
  is_like: int,               // 是否推荐 (0否 1是)
  remark: varchar(100),       // 备注
  cate_id: int,               // 分类ID
  limit: int,                 // 借阅限制数量（默认5）
  create_time: timestamp,     // 创建时间
  update_time: timestamp      // 更新时间
}

分类表 (cate)

{
  id: int,                    // 分类ID
  title: varchar(100),        // 分类名称
  cover: varchar(100),        // 分类图标
  create_time: timestamp,     // 创建时间
  update_time: timestamp      // 更新时间
}

借阅订单表 (orders)

{
  id: int,                    // 订单ID
  user_id: int,               // 用户ID
  phone: varchar(100),        // 联系电话
  username: varchar(100),     // 借阅人
  goods: varchar(1000),       // 借阅图书（格式：图书ID_数量）
  total_count: int,           // 借阅总数
  status: int,                // 状态 (0已借阅 1已归还)
  order_no: varchar(30),      // 订单号
  create_time: timestamp,     // 借阅时间
  update_time: timestamp      // 更新时间
}

收藏夹表 (shop_cart)

{
  id: int,                    // 收藏ID
  user_id: int,               // 用户ID
  product_id: int,            // 图书ID
  product_count: int,         // 数量
  create_time: timestamp,     // 创建时间
  update_time: timestamp      // 更新时间
}

评论表 (comment)

{
  id: int,                    // 评论ID
  user_id: int,               // 用户ID
  product_id: int,            // 图书ID
  order_id: int,              // 订单ID
  content: varchar(1000),     // 评论内容
  cover: varchar(1000),       // 评论图片
  create_time: timestamp,     // 创建时间
  update_time: timestamp      // 更新时间
}

问题反馈表 (question)

{
  id: int,                    // 反馈ID
  user_id: int,               // 用户ID
  cover: varchar(2000),       // 图片
  remark: varchar(1000),      // 反馈内容
  email: varchar(100),        // 邮箱
  reply: varchar(1000),       // 回复内容
  create_time: timestamp,     // 创建时间
  update_time: timestamp      // 更新时间
}

图书分类

分类名称	说明
文艺	文学艺术类图书
教育	教育教学类图书
经管	经济管理类图书
人文社科	人文社会科学类图书
生活	生活百科类图书
科技	科学技术类图书
童书	儿童读物

借阅状态说明

状态码	状态名称	说明
0	已借阅	图书已借出，等待归还
1	已归还	图书已归还完成

运行环境要求

后端环境

• Node.js 14.0+
• MySQL 5.7+
• npm 或 yarn

管理后台

• Node.js 14.0+
• npm 或 yarn
• 现代浏览器（Chrome、Firefox、Edge等）

小程序端

• 微信开发者工具（最新稳定版）
• 基础库版本 2.19.0+
• 需要有效的AppID

快速开始

1. 数据库配置

1. 创建MySQL数据库

CREATE DATABASE library CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

2. 导入数据库文件

mysql -u root -p library < library.sql

3. 修改数据库配置 编辑 express/config/db.js：

var db = mysql.createConnection({
  database: 'library', // 数据库名称
  port: '3306', // 端口号
  host: 'localhost', // 主机地址
  user: 'root', // 用户名
  password: 'root', // 密码（修改为你的密码）
});

2. 启动后端服务

# 进入后端目录
cd express

# 安装依赖
npm install

# 启动服务（开发模式）
npm run dev

后端服务默认运行在 http://localhost:5002

3. 启动管理后台

# 进入管理后台目录
cd admin

# 安装依赖
npm install

# 启动开发服务器
npm run serve

管理后台默认运行在 http://localhost:8080

4. 运行小程序

1. 打开微信开发者工具
2. 选择"导入项目"
3. 选择 min 目录
4. 填入AppID（可使用测试号）
5. 点击"导入"

5. 配置小程序API地址

编辑 min/utils/request.js，修改API基础地址：

const baseUrl = 'http://localhost:5002'; // 修改为你的后端地址

默认账号

管理后台

• 手机号：1871502XXXX
• 密码：123456

小程序端

• 支持微信授权登录
• 或使用手机号登录

界面预览

项目包含演示视频文件：

• 图书管理-小程序.mp4 - 小程序端完整功能演示
• 图书管理-admin.mp4 - 管理后台完整功能演示

扩展建议

如需进一步完善项目，可考虑以下扩展：

1. 逾期提醒：添加借阅逾期提醒功能
2. 预约功能：支持图书预约
3. 续借功能：支持在线续借
4. 罚款系统：逾期罚款管理
5. 图书推荐：基于借阅历史推荐图书
6. 电子书：支持在线阅读电子书
7. 扫码借还：支持扫描ISBN码借还书
8. 数据统计：借阅数据分析报表

注意事项

1. 本项目为学习演示项目，部分数据为模拟数据
2. 生产环境部署需要配置HTTPS
3. 小程序上线需要完成微信认证
4. 建议定期备份数据库数据

常见问题

Q: 数据库连接失败？

A: 检查MySQL服务是否启动，数据库配置是否正确

Q: 图片无法显示？

A: 检查后端服务是否启动，图片路径配置是否正确

Q: 小程序无法请求后端？

A: 检查request.js中的baseUrl配置，开发时需在微信开发者工具中关闭"不校验合法域名"

Q: 管理后台登录失败？

A: 确认数据库中user表有管理员账号（role=99）

Q: 借阅数量超限？

A: 每本图书有借阅限制（默认5本），可在管理后台修改

许可证

本项目仅供学习交流使用，请勿用于商业用途。