# secondhandbook

**Repository Path**: shenzikun/secondhandbook

## Basic Information

- **Project Name**: secondhandbook
- **Description**: 郑州轻工业大学
国教小组作业
雅韵书城
- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-12-04
- **Last Updated**: 2024-12-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 雅韵旧书网 - YaYun Books

基于若依框架进行开发的商城项目。

## 小组成员

xu：胥锦灏

shen：沈梓坤

ning：宁点石

sun：孙博文

tang：唐钰涵

wang：王隆隆

## 项目介绍

雅韵旧书网是一个现代化的图书销售平台，采用前后端分离架构开发。项目致力于为用户提供优质的图书购买体验，为商家提供高效的图书销售管理系统。

## 项目架构
```
项目根目录
├── back/                          # 后端项目
│   ├── yayun-merchant/           # 商户管理模块(主要业务代码)
│   ├── yayun-admin/             # 后台管理模块
│   ├── yayun-framework/         # 框架核心模块
│   ├── yayun-system/           # 系统功能模块
│   ├── yayun-common/           # 公共工具模块
│   └── yayun-quartz/           # 定时任务模块
│
└── front/                         # 前端项目
    ├── src/                      # 源码目录
    ├── public/                   # 静态资源
    └── ...
```

## 技术栈

### 后端技术
- 核心框架：Spring Boot
- 安全框架：Spring Security
- 持久层框架：MyBatis
- 数据库：MySQL
- 缓存：Redis
- 定时任务：Quartz
- API文档：Swagger
- 日志：SLF4J + Logback

### 前端技术
- 核心框架：Vue.js
- 构建工具：Vite
- 路由：Vue Router
- 状态管理：Vuex
- UI框架：Element Plus
- HTTP客户端：Axios

## 数据库设计

### 商品模块表(PMS)
- `pms_product`: 书籍信息表
  - 包含书籍基本信息：书名、作者、ISBN、价格、库存等
  - 支持出版信息：出版社、出版日期、页数、开本等
  - 关联分类和品牌（出版社）信息
- `pms_category`: 书籍分类表
  - 支持多级分类结构
  - 包含分类名称、层级、排序等信息
- `pms_brand`: 出版社信息表
  - 管理出版社基本信息
  - 包含名称、logo等信息
- `pms_sku`: SKU信息表
  - 管理书籍具体销售规格
  - 记录价格、库存等信息

### 订单模块表(OMS)
- `oms_order`: 订单主表
  - 记录订单基本信息
  - 包含订单状态、支付信息、收货信息等
- `oms_order_item`: 订单明细表
  - 记录订单中的具体商品信息
  - 关联商品和SKU信息
- `oms_cart`: 购物车表
  - 记录用户购物车信息
  - 关联商品和SKU信息
- `oms_aftersale`: 售后服务表
  - 管理退货退款等售后服务
  - 记录售后处理状态和流程

### 系统模块表(SYS)
- `sys_user`: 用户信息表
  - 管理系统用户信息
  - 包含账号、密码、权限等
- `sys_role`: 角色信息表
  - 定义系统角色
  - 关联权限信息
- `sys_menu`: 菜单权限表
  - 管理系统菜单和权限
  - 支持多级菜单结构
- `sys_dept`: 部门管理表
  - 管理组织架构
  - 支持多级部门结构


## 主要功能

### 用户端功能
- [ ] 用户注册登录
- [ ] 图书分类浏览
- [ ] 图书搜索
- [ ] 购物车管理
- [ ] 订单管理
- [ ] 个人中心
- [ ] 收货地址管理

### 商户端功能
- [ ] 商品管理
  - [ ] 图书信息管理
  - [ ] 库存管理
  - [ ] 分类管理
- [ ] 订单管理
  - [ ] 订单处理
  - [ ] 发货管理
  - [ ] 退款处理
- [ ] 统计分析
  - [ ] 销售统计
  - [ ] 订单统计

### 系统功能
- [ ] 用户权限管理

- [ ] 角色权限管理

- [ ] 菜单管理

- [ ] 部门管理

  

## 开发环境
- JDK 1.8
- MySQL 8.0+
- Redis 3.0+
- Node.js 16+
- npm 8+

## 项目配置
1. 后端配置
```bash
# 数据库配置
spring.datasource.url=jdbc:mysql://localhost:3306/yayun_books
spring.datasource.username=root
spring.datasource.password=password

# Redis配置
spring.redis.host=localhost
spring.redis.port=6666
```

2. 前端配置
```bash
# 开发环境配置
VITE_APP_BASE_API=/dev-api
VITE_APP_PORT=80
```

## 项目运行
1. 后端运行
```bash
cd back
mvn clean install
java -jar yayun-admin/target/yayun-admin.jar
```

2. 前端运行
```bash
cd front
npm install
npm run dev
```

## 项目进度
- [x] 项目初始化搭建
- [x] 数据库设计
- [x] 用户端开发
- [x] 商户端开发
- [ ] 系统功能完善
- [ ] 项目部署上线

## 贡献指南
1. Fork 本仓库
2. 创建新的分支 `git checkout -b feature/your-feature`
3. 提交你的更改 `git commit -m 'Add some feature'`
4. 推送到分支 `git push origin feature/your-feature`
5. 提交 Pull Request

## 许可证
本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详细信息