📚 图书管理系统 (Library Management System)

一个功能完整、现代化的图书管理系统，采用前后端分离架构，支持图书管理、库存管理、采购管理、销售管理、借阅管理等核心功能。

✨ 功能特性

📖 图书管理

图书信息 CRUD 操作
ISBN 自动识别
分类管理
图书搜索与筛选
批量导入导出
封面图片上传

📦 库存管理

实时库存监控
入库/出库操作
库存变动记录
低库存预警
库存盘点
批量入库

🛒 采购管理

供应商管理
采购订单创建
订单审核流程
采购入库
采购统计

💰 销售管理

销售订单管理
购物车功能
多种支付方式
销售统计分析
日/月/年报表
销售数据导出

📕 借阅管理

图书借阅/归还
借阅续期
逾期管理
罚款计算
借阅统计
借阅规则配置

👥 用户权限

用户管理
角色管理
权限控制 (RBAC)
操作日志
登录历史

📊 数据可视化

仪表盘概览
借阅趋势图表
销售趋势图表
分类统计
热门图书排行
预警信息提醒

🔧 系统功能

Redis 缓存支持
JWT 认证 + 黑名单
分布式锁
限流保护
文件上传
数据导出 (Excel)
操作日志记录
系统配置管理
全局搜索

🏗️ 技术架构

前端技术栈

技术	版本	说明
SvelteKit	latest	前端框架
TypeScript	5.0+	类型支持
Tailwind CSS	3.4+	样式框架
shadcn-svelte	latest	UI 组件库
Lucide Icons	latest	图标库
svelte-sonner	latest	Toast 通知

后端技术栈

技术	版本	说明
Go	1.21+	编程语言
Gin	latest	Web 框架
GORM	latest	ORM 框架
MySQL	8.0+	主数据库
MongoDB	7.0+	文档数据库
Redis	7.0+	缓存数据库
JWT	-	认证方案
excelize	latest	Excel 导出

📁 项目结构

library-management/
├── apps/
│   ├── backend/                    # Go 后端应用
│   │   ├── cmd/
│   │   │   └── server/
│   │   │       └── main.go         # 入口文件
│   │   ├── internal/
│   │   │   ├── config/             # 配置管理
│   │   │   ├── controllers/        # 控制器
│   │   │   │   ├── book_controller.go
│   │   │   │   ├── borrow_controller.go
│   │   │   │   ├── config_controller.go
│   │   │   │   ├── dashboard_controller.go
│   │   │   │   ├── export_controller.go
│   │   │   │   ├── log_controller.go
│   │   │   │   ├── permission_controller.go
│   │   │   │   ├── purchase_controller.go
│   │   │   │   ├── role_controller.go
│   │   │   │   ├── sale_controller.go
│   │   │   │   ├── stock_controller.go
│   │   │   │   ├── upload_controller.go
│   │   │   │   └── user_controller.go
│   │   │   ├── middleware/         # 中间件
│   │   │   │   ├── auth.go
│   │   │   │   └── logger.go
│   │   │   ├── models/             # 数据模型
│   │   │   │   ├── book.go
│   │   │   │   ├── borrow.go
│   │   │   │   ├── order.go
│   │   │   │   ├── purchase.go
│   │   │   │   ├── sale.go
│   │   │   │   └── user.go
│   │   │   ├── routes/             # 路由配置
│   │   │   │   └── routes.go
│   │   │   └── utils/              # 工具函数
│   │   │       └── response.go
│   │   ├── pkg/
│   │   │   └── database/           # 数据库连接
│   │   │       ├── database.go
│   │   │       └── redis.go
│   │   ├── Dockerfile
│   │   └── go.mod
│   │
│   └── frontend/                   # SvelteKit 前端应用
│       ├── src/
│       │   ├── lib/
│       │   │   ├── api/            # API 客户端
│       │   │   │   └── index.ts
│       │   │   ├── components/     # UI 组件
│       │   │   │   ├── common/     # 通用组件
│       │   │   │   ├── layout/     # 布局组件
│       │   │   │   └── ui/         # shadcn-svelte 组件
│       │   │   ├── stores/         # 状态管理
│       │   │   │   └── index.ts
│       │   │   ├── types/          # TypeScript 类型
│       │   │   │   └── index.ts
│       │   │   └── utils.ts        # 工具函数
│       │   └── routes/             # 页面路由
│       │       ├── +layout.svelte
│       │       ├── +page.svelte
│       │       ├── auth/           # 认证页面
│       │       ├── books/          # 图书管理
│       │       ├── borrows/        # 借阅管理
│       │       ├── purchases/      # 采购管理
│       │       ├── roles/          # 角色管理
│       │       ├── sales/          # 销售管理
│       │       ├── stocks/         # 库存管理
│       │       └── users/          # 用户管理
│       ├── static/                 # 静态资源
│       ├── Dockerfile
│       ├── package.json
│       ├── svelte.config.js
│       ├── tailwind.config.js
│       ├── tsconfig.json
│       └── vite.config.ts
│
├── docker/
│   ├── docker-compose.yml          # Docker 编排
│   └── init/
│       ├── mysql/                  # MySQL 初始化
│       │   └── 01_schema.sql
│       └── mongo/                  # MongoDB 初始化
│           └── 01_schema.js
│
├── .dockerignore
├── .gitignore
└── README.md

🚀 快速开始

方式一：Docker Compose（推荐）

# 进入 docker 目录
cd docker

# 启动所有服务
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看日志
docker-compose logs -f

服务启动后访问：

🌐 前端：http://localhost:3000
🔌 后端 API：http://localhost:8080
🗄️ MySQL：localhost:3306
🍃 MongoDB：localhost:27017
🔴 Redis：localhost:6379

方式二：本地开发

环境要求

Go 1.21+
Node.js 20+
pnpm 8+
MySQL 8.0+
MongoDB 7.0+
Redis 7.0+

后端启动

cd apps/backend

# 安装依赖
go mod download

# 设置环境变量
export MYSQL_HOST=localhost
export MYSQL_PORT=3306
export MYSQL_USER=root
export MYSQL_PASSWORD=your_password
export MYSQL_DATABASE=library_system
export MONGODB_URI=mongodb://localhost:27017
export MONGODB_DATABASE=library_borrow
export REDIS_HOST=localhost
export REDIS_PORT=6379
export REDIS_ENABLED=true
export JWT_SECRET=your-secret-key

# 运行
go run cmd/server/main.go

前端启动

cd apps/frontend

# 安装依赖
pnpm install

# 开发模式
pnpm dev

# 构建
pnpm build

📝 API 文档

API 风格

所有 API 均使用 POST 方法，请求和响应均为 JSON 格式。

主要接口

模块	接口	说明
仪表盘	POST /api/dashboard/overview	概览数据
	POST /api/dashboard/borrow-trend	借阅趋势
	POST /api/dashboard/sales-trend	销售趋势
	POST /api/dashboard/alerts	预警信息
	POST /api/search	全局搜索
认证	POST /api/login	用户登录
	POST /api/register	用户注册
	POST /api/logout	用户登出
	POST /api/profile	获取当前用户
图书	POST /api/books/list	图书列表
	POST /api/books/create	创建图书
	POST /api/books/update	更新图书
	POST /api/books/delete	删除图书
库存	POST /api/stocks/list	库存列表
	POST /api/stocks/in	入库操作
	POST /api/stocks/out	出库操作
借阅	POST /api/borrows/list	借阅记录
	POST /api/borrows/borrow	借阅图书
	POST /api/borrows/return	归还图书
销售	POST /api/sales/list	销售订单
	POST /api/sales/create	创建订单
批量	POST /api/batch/import-books	批量导入图书
	POST /api/batch/update-books	批量更新图书
配置	POST /api/config/list	获取配置
	POST /api/config/update	更新配置

🔐 默认账户

角色	用户名	密码
管理员	admin	admin123

⚙️ 环境变量

后端环境变量

变量名	说明	默认值
SERVER_PORT	服务端口	8080
MYSQL_HOST	MySQL 主机	localhost
MYSQL_PORT	MySQL 端口	3306
MYSQL_USER	MySQL 用户	root
MYSQL_PASSWORD	MySQL 密码	-
MYSQL_DATABASE	MySQL 数据库	library_system
MONGODB_URI	MongoDB 连接串	mongodb://localhost:27017
MONGODB_DATABASE	MongoDB 数据库	library_borrow
REDIS_HOST	Redis 主机	localhost
REDIS_PORT	Redis 端口	6379
REDIS_ENABLED	是否启用 Redis	true
JWT_SECRET	JWT 密钥	-
JWT_EXPIRE	JWT 过期时间(秒)	86400

📊 数据库设计

MySQL 表结构

users - 用户表
roles - 角色表
permissions - 权限表
user_roles - 用户角色关联表
role_permissions - 角色权限关联表
books - 图书表
stocks - 库存表
stock_records - 库存变动记录表
suppliers - 供应商表
purchase_orders - 采购订单表
purchase_order_items - 采购订单明细表
sale_orders - 销售订单表
sale_order_items - 销售订单明细表
carts - 购物车表
operation_logs - 操作日志表
system_configs - 系统配置表

MongoDB 集合

borrow_records - 借阅记录
borrow_rules - 借阅规则
reservations - 预约记录
borrow_statistics - 借阅统计

🔄 更新日志

v1.2.0 (2024-02-28)

✨ 添加仪表盘数据可视化（概览、趋势图表、预警信息）
✨ 添加全局搜索功能
✨ 添加批量操作功能（导入、更新、删除）
✨ 添加系统配置管理
🔧 优化项目结构，清理冗余代码
🐛 优化性能和错误处理

v1.1.0 (2024-02-27)

✨ 实现 Redis 功能（JWT黑名单、缓存、分布式锁、限流器）
✨ 添加操作日志记录功能
✨ 完善前端 API 调用和状态管理
✨ 添加文件上传功能
✨ 添加数据导出功能（Excel）

v1.0.0 (2024-02-27)

🎉 初始版本发布

🤝 贡献指南

Fork 本仓库
创建特性分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
提交 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件

🙏 致谢

Made with ❤️ by idleRain

Name		Name	Last commit message	Last commit date
Latest commit History 13 Commits
.github/workflows		.github/workflows
.husky		.husky
apps		apps
docker		docker
docs		docs
scripts		scripts
.dockerignore		.dockerignore
.gitignore		.gitignore
.prettierrc		.prettierrc
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
Makefile		Makefile
README.md		README.md
commitlint.config.js		commitlint.config.js
package.json		package.json
pnpm-workspace.yaml		pnpm-workspace.yaml

Folders and files

Latest commit

History

Repository files navigation

📚 图书管理系统 (Library Management System)

✨ 功能特性

📖 图书管理

📦 库存管理

🛒 采购管理

💰 销售管理

📕 借阅管理

👥 用户权限

📊 数据可视化

🔧 系统功能

🏗️ 技术架构

前端技术栈

后端技术栈

📁 项目结构

🚀 快速开始

方式一：Docker Compose（推荐）

方式二：本地开发

环境要求

后端启动

前端启动

📝 API 文档

API 风格

主要接口

🔐 默认账户

⚙️ 环境变量

后端环境变量

📊 数据库设计

MySQL 表结构

MongoDB 集合

🔄 更新日志

v1.2.0 (2024-02-28)

v1.1.0 (2024-02-27)

v1.0.0 (2024-02-27)

🤝 贡献指南

📄 许可证

🙏 致谢

About

Resources

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages