# CYT

**Repository Path**: cmalou/cyt

## Basic Information

- **Project Name**: CYT
- **Description**: 这是cyt的毕业设计
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-08
- **Last Updated**: 2026-02-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 猫咪领养与宠物用品商城 - 项目说明

## 📊 当前开发进度

### ✅ 已完成模块（70%）

#### 1. 基础框架（100%）
- ✅ SpringBoot项目结构
- ✅ Maven依赖配置
- ✅ 数据库设计（12张表）
- ✅ 统一返回结果封装
- ✅ 全局异常处理
- ✅ JWT认证与拦截器
- ✅ 跨域配置
- ✅ Swagger API文档
- ✅ MyBatis-Plus配置

#### 2. 用户管理模块（100%）
- ✅ 用户注册/登录
- ✅ 用户信息管理
- ✅ 密码修改
- ✅ JWT Token认证

**API接口：**
- `POST /api/user/register` - 用户注册
- `POST /api/user/login` - 用户登录
- `GET /api/user/info` - 获取用户信息
- `PUT /api/user/info` - 更新用户信息
- `PUT /api/user/password` - 修改密码

#### 3. 猫咪领养模块（100%）
- ✅ 猫咪列表（分页、搜索、筛选）
- ✅ 猫咪详情（自动增加浏览次数）
- ✅ 领养申请提交
- ✅ 我的领养申请
- ✅ 领养申请审核（管理员）
- ✅ 猫咪信息管理（管理员）

**用户端API接口：**
- `GET /api/cat/list` - 猫咪列表
- `GET /api/cat/{id}` - 猫咪详情
- `POST /api/adoption/apply` - 提交领养申请
- `GET /api/adoption/my` - 我的领养申请

**管理员API接口：**
- `GET /api/admin/cat/list` - 猫咪列表管理
- `POST /api/admin/cat` - 添加猫咪
- `PUT /api/admin/cat/{id}` - 更新猫咪
- `DELETE /api/admin/cat/{id}` - 删除猫咪
- `GET /api/admin/adoption/list` - 领养申请列表
- `PUT /api/admin/adoption/audit/{id}` - 审核领养申请

#### 4. 商品管理模块（100%）
- ✅ 商品分类管理
- ✅ 商品列表（分页、搜索、筛选）
- ✅ 商品详情（自动增加浏览次数）
- ✅ 热门商品
- ✅ 商品库存管理
- ✅ 商品信息管理（管理员）

**用户端API接口：**
- `GET /api/category/list` - 分类列表
- `GET /api/product/list` - 商品列表
- `GET /api/product/{id}` - 商品详情
- `GET /api/product/hot` - 热门商品

**管理员API接口：**
- `GET /api/admin/category/list` - 分类管理
- `POST /api/admin/category` - 添加分类
- `PUT /api/admin/category/{id}` - 更新分类
- `DELETE /api/admin/category/{id}` - 删除分类
- `GET /api/admin/product/list` - 商品管理
- `POST /api/admin/product` - 添加商品
- `PUT /api/admin/product/{id}` - 更新商品
- `DELETE /api/admin/product/{id}` - 删除商品

---

### 🚧 待开发模块（30%）

#### 5. 购物车模块（待开发）
- 添加购物车
- 购物车列表
- 更新购物车数量
- 删除购物车商品
- 清空购物车

#### 6. 订单管理模块（待开发）
- 创建订单
- 订单支付（模拟）
- 订单列表
- 订单详情
- 取消订单
- 订单发货（管理员）
- 订单统计（管理员）

#### 7. 收货地址模块（待开发）
- 地址列表
- 添加地址
- 更新地址
- 删除地址
- 设置默认地址

#### 8. 轮播图和公告模块（待开发）
- 轮播图列表
- 轮播图管理（管理员）
- 公告列表
- 公告管理（管理员）

#### 9. 文件上传模块（待开发）
- 图片上传
- 图片删除
- 文件类型验证
- 文件大小限制

#### 10. 数据统计模块（待开发）
- 用户统计
- 订单统计
- 销售额统计
- 猫咪领养统计

---

## 🚀 快速开始

### 1. 环境要求
- JDK 1.8
- MySQL 5.7+
- Maven 3.6+
- IDEA / Eclipse

### 2. 数据库初始化

使用MySQL客户端或Navicat执行SQL脚本：

```bash
mysql -u root -p123456 < D:/project/CYT/database/init.sql
```

或者在MySQL客户端中执行 `D:/project/CYT/database/init.sql` 文件。

### 3. 启动后端项目

#### 方式一：使用IDEA
1. 用IDEA打开 `D:/project/CYT/backend` 目录
2. 等待Maven下载依赖
3. 右键点击 `PetApplication.java`
4. 选择 "Run PetApplication"

#### 方式二：使用Maven命令
```bash
cd D:/project/CYT/backend
mvn clean install
mvn spring-boot:run
```

### 4. 访问Swagger API文档

启动成功后，访问：
```
http://localhost:8080/swagger-ui.html
```

---

## 📱 测试账号

数据库初始化后，已经创建了测试账号：

### 管理员账号
- 用户名：`admin`
- 密码：`123456`
- 角色：ADMIN

### 普通用户
- 用户名：`user001`
- 密码：`123456`
- 角色：USER

---

## 🗂️ 项目结构

```
backend/
├── src/
│   ├── main/
│   │   ├── java/com/pet/
│   │   │   ├── PetApplication.java          # 启动类
│   │   │   ├── common/                      # 通用类
│   │   │   │   ├── Result.java              # 统一返回结果
│   │   │   │   ├── ResultCode.java          # 返回码枚举
│   │   │   │   ├── BaseEntity.java          # 基础实体类
│   │   │   │   └── PageResult.java          # 分页结果
│   │   │   ├── config/                      # 配置类
│   │   │   │   ├── CorsConfig.java          # 跨域配置
│   │   │   │   ├── SwaggerConfig.java       # Swagger配置
│   │   │   │   ├── MybatisPlusConfig.java   # MyBatis-Plus配置
│   │   │   │   └── WebConfig.java           # 拦截器配置
│   │   │   ├── controller/                  # 控制层
│   │   │   │   ├── user/                    # 用户端
│   │   │   │   │   ├── UserController.java
│   │   │   │   │   ├── CatController.java
│   │   │   │   │   ├── AdoptionController.java
│   │   │   │   │   ├── CategoryController.java
│   │   │   │   │   └── ProductController.java
│   │   │   │   └── admin/                   # 管理端
│   │   │   │       ├── AdminCatController.java
│   │   │   │       ├── AdminAdoptionController.java
│   │   │   │       ├── AdminCategoryController.java
│   │   │   │       └── AdminProductController.java
│   │   │   ├── dto/                         # 数据传输对象
│   │   │   ├── entity/                      # 实体类
│   │   │   ├── exception/                   # 异常处理
│   │   │   ├── interceptor/                 # 拦截器
│   │   │   ├── mapper/                      # 数据访问层
│   │   │   ├── service/                     # 业务逻辑层
│   │   │   │   └── impl/                    # 实现类
│   │   │   ├── util/                        # 工具类
│   │   │   └── vo/                          # 视图对象
│   │   └── resources/
│   │       ├── application.yml              # 主配置文件
│   │       ├── application-dev.yml          # 开发环境配置
│   │       ├── application-prod.yml         # 生产环境配置
│   │       └── static/upload/               # 上传文件目录
│   └── test/                                # 测试代码
└── pom.xml                                  # Maven配置

database/
└── init.sql                                 # 数据库初始化脚本

开发文档.md                                   # 完整开发文档
```

---

## 📋 数据库表清单

已创建12张数据表：

1. `sys_user` - 用户表
2. `cat_info` - 猫咪信息表
3. `adoption_application` - 领养申请表
4. `product_category` - 商品分类表
5. `product` - 商品表
6. `shopping_cart` - 购物车表
7. `order_info` - 订单表
8. `order_item` - 订单明细表
9. `user_address` - 收货地址表
10. `banner` - 轮播图表
11. `notice` - 公告表
12. `product_comment` - 商品评价表

---

## 🔧 技术栈

### 后端
- SpringBoot 2.3.12
- MyBatis-Plus 3.4.3
- MySQL 5.7+
- JWT 0.9.1
- Swagger 2.9.2
- Lombok
- Hutool 5.7.20
- FastJSON 1.2.78

### 前端（待开发）
- Vue 2.6.x
- Element UI 2.15.x
- Axios 0.27.x
- Vue Router 3.5.x
- Vuex 3.6.x

---

## 📖 API文档

启动项目后，访问Swagger文档查看完整的API接口说明：

```
http://localhost:8080/swagger-ui.html
```

---

## 🎯 下一步开发计划

1. ✅ **完成购物车模块**（预计1天）
2. ✅ **完成订单管理模块**（预计2天）
3. ✅ **完成收货地址模块**（预计0.5天）
4. ✅ **完成轮播图和公告模块**（预计0.5天）
5. ✅ **完成文件上传模块**（预计0.5天）
6. ✅ **完成数据统计模块**（预计1天）
7. ⏳ **开始前端开发**（预计10-15天）

---

## 📞 联系方式

如有问题，请查看开发文档或联系开发团队。

---

**最后更新：** 2024年