读者社区图书借阅系统

一个基于现代化技术栈构建的综合性图书馆管理系统，集成了图书借阅、座位预约、活动管理、在线咨询及完善的会员与财务管理功能。系统采用前后端分离架构，提供极致的用户体验和强大的后台管理能力。

🌟 核心亮点

• 全方位业务覆盖：从图书借还到座位预约，从活动报名到在线咨询，一站式满足图书馆管理需求。
• 精细化财务管理：内置钱包系统，支持充值、押金自动扣除与退还、逾期费/损坏费计算，账目清晰透明。
• 现代化交互体验：基于 Vue 3 + Element Plus 打造的响应式界面，操作流畅，视觉美观。
• 灵活的权限控制：基于 RBAC 模型的权限管理，支持超级管理员、工作人员、普通会员等多种角色。
• 数据可视化大屏：直观展示借阅趋势、活动热度、会员增长等关键运营指标。

---

🛠 技术栈

前端 (admin-vue3)

• 核心框架: Vue 3 (Composition API)
• 构建工具: Vite (极速构建与热重载)
• UI 组件库: Element Plus (饿了么团队出品)
• 状态管理: Pinia (轻量级状态管理)
• 路由管理: Vue Router 4
• HTTP 客户端: Axios
• 数据可视化: ECharts
• CSS 预处理: Sass
• 工具库: Day.js (日期处理), marked (Markdown 渲染)

后端 (express)

• 运行环境: Node.js
• Web 框架: Express
• 数据库: MySQL (5.7 / 8.0)
• ORM/驱动: mysql2
• 身份认证: JWT (JSON Web Tokens)
• 加密安全: bcryptjs
• 文件上传: multer
• 开发工具: nodemon

---

📂 目录结构

reader-community-system/
├── admin-vue3/                # 前端项目根目录
│   ├── src/
│   │   ├── api/               # API 接口统一管理
│   │   ├── assets/            # 静态资源 (图片, 样式)
│   │   ├── components/        # 公共组件
│   │   ├── hooks/             # Vue 组合式函数 (如 useRole)
│   │   ├── layouts/           # 页面布局组件
│   │   ├── router/            # 路由配置
│   │   ├── stores/            # Pinia 状态仓库
│   │   ├── utils/             # 工具函数与常量
│   │   ├── views/             # 页面视图
│   │   │   ├── dynamic/       # 核心业务页面 (图书, 座位, 活动等)
│   │   │   └── system/        # 系统管理页面 (用户, 角色, 菜单)
│   │   └── App.vue            # 根组件
│   ├── vite.config.js         # Vite 配置
│   └── package.json           # 前端依赖配置
│
├── express/                   # 后端项目根目录
│   ├── bin/                   # 启动脚本
│   ├── config/                # 配置文件 (数据库连接)
│   ├── controllers/           # 业务逻辑控制器
│   ├── migrations/            # 数据库迁移脚本
│   ├── routes/                # 路由定义
│   ├── services/              # 业务服务层
│   ├── util/                  # 通用工具
│   ├── app.js                 # Express 应用入口
│   └── package.json           # 后端依赖配置
│
├── reader-community-system.sql # 数据库初始化脚本
├── 功能图.jpg                  # 系统功能架构图
└── 项目说明.md                 # 项目文档

---

🧩 功能模块详情

1. 📚 图书管理与借阅

• 图书库管理：支持图书的增删改查，分类管理，库存监控。
• 借阅流程：
  • 申请：会员在线申请借阅，系统自动检查账户余额是否满足押金要求。
  • 审核：工作人员审核借阅请求，审核通过自动冻结/扣除押金。
  • 归还：支持图书归还及逾期费/损坏费计算，剩余押金自动返还至钱包。
• 我的借阅：会员可查看当前借阅状态、历史记录及费用明细。

2. 💺 座位预约系统

• 可视化选座：直观展示阅览室座位布局及实时状态（空闲/占用/维护）。
• 预约规则：支持按时段预约，提供签到/签退功能。
• 报修管理：提供座位设施报修流程。

3. 🎉 活动中心

• 活动发布：管理员发布讲座、读书会等活动信息。
• 在线报名：会员查看活动详情并在线报名。
• 签到管理：活动现场签到记录。

4. 💬 咨询与互动

• 在线咨询：会员可向工作人员发起实时咨询，支持消息历史记录。
• 公告通知：系统公告发布与管理，重要信息及时触达。

5. 💰 财务与会员中心

• 会员钱包：
  • 充值：支持虚拟充值流程。
  • 明细：每一笔押金扣除、退还、消费记录都有据可查。
• 个人管理：个人资料修改、密码安全管理、会员等级展示。

6. ⚙️ 系统管理 (RBAC)

• 用户管理：系统后台账号管理。
• 角色管理：自定义角色及其权限分配。
• 菜单管理：动态配置左侧菜单显隐及路由权限。

---

🚀 快速开始

环境准备

• Node.js (>= 16.0.0)
• MySQL (5.7 或 8.0)
• pnpm (推荐) 或 npm

1. 数据库设置

1. 登录 MySQL 创建数据库：

   CREATE DATABASE `reader-community-system` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
   

2. 导入数据表结构及初始数据：

   mysql -u root -p reader-community-system < reader-community-system.sql
   

3. (可选) 执行额外的迁移脚本（如果在 express/migrations 下有未合并的更新）。

2. 后端服务启动

1. 进入后端目录：

   cd express
   

2. 安装依赖：

   pnpm install
   

3. 配置数据库： 修改 express/config/db.js 中的数据库连接信息（用户名、密码）。
4. 启动服务：

   pnpm run dev
   

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

3. 前端项目启动

1. 进入前端目录：

   cd admin-vue3
   

2. 安装依赖：

   pnpm install
   

3. 启动开发服务器：

   pnpm run dev
   

   前端服务默认运行在 http://localhost:5173。

4. 访问系统

打开浏览器访问 http://localhost:5173。

默认测试账号：

• 超级管理员: admin / 123456
• 工作人员: staff001 / 123456
• 普通会员: member001 / 123456

---

📝 开发规范

• 代码风格：遵循 ESLint + Prettier 规范。
• 提交规范：推荐使用 Conventional Commits (feat, fix, docs, refactor 等)。
• API 交互：前端统一封装 Axios 请求在 src/api 目录，通过 service 实例处理拦截器与响应格式。

🤝 贡献与反馈

欢迎提交 Issue 或 Pull Request 来改进本项目。

📄 版权说明

本项目仅供学习与交流使用。