# class-pet-project

**Repository Path**: xiaoxiongz/class-pet-project

## Basic Information

- **Project Name**: class-pet-project
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-17
- **Last Updated**: 2026-05-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 班级宠物养成系统

一个帮助老师管理班级、培养学生责任心的互动积分管理系统。学生通过获得积分领养和养成自己的虚拟宠物。

## 功能特性

### 🐾 宠物养成
- 一键分配宠物（猫🐱、狗🐶、兔子🐰、仓鼠🐹、龙🐲、熊猫🐼）
- 学生自由领养喜欢的宠物
- 宠物饥饿和健康状态管理
- 宠物等级随积分自动提升（幼年期→成长期→成熟期→精英期→传说级）

### ⭐ 积分管理
- 加分/减分操作
- 批量积分操作
- 预设积分项目（课堂发言、作业完成、迟到等）
- 积分历史记录查看

### 🏫 班级管理
- 创建和管理多个班级
- 批量创建班级
- 学生分组管理

### 🏆 光荣榜
- 积分排行榜
- TOP 3 展示（金银铜牌）

### 🏪 小卖部
- 商品管理（增删改）
- 积分兑换

## 技术栈

**后端**: Spring Boot 3.2 + MyBatis-Plus 3.5 + JWT + Redis + MySQL 8.0

**前端**: React 18 + TypeScript + Vite + Ant Design 5 + Zustand

**部署**: Docker + Kubernetes

## 快速开始

### Docker Compose 部署

```bash
cd docker
docker-compose up -d
```

访问 http://localhost

### 手动部署

**后端**
```bash
cd backend
mvn spring-boot:run
```

**前端**
```bash
cd frontend
npm install
npm run dev
```

## 项目结构

```
class-pet-project/
├── PRD.md                    # 产品需求文档
├── backend/                  # Spring Boot 后端
│   ├── pom.xml
│   └── src/main/java/com/classpet/
│       ├── controller/       # REST API 控制器
│       ├── service/          # 业务逻辑
│       ├── repository/       # 数据访问
│       ├── domain/entity/    # 实体类
│       ├── dto/              # 数据传输对象
│       ├── config/           # 配置类
│       └── security/         # JWT 认证
├── frontend/                 # React 前端
│   ├── src/
│   │   ├── pages/           # 页面组件
│   │   ├── api/             # API 调用
│   │   ├── store/           # Zustand 状态
│   │   └── styles/          # 全局样式
│   └── package.json
├── docker/                   # Docker 配置
├── k8s/                      # Kubernetes 配置
└── mysql/                    # MySQL 脚本
```

## API 文档

启动后访问 http://localhost:8080/swagger-ui.html

## 默认账号

- 用户名: admin
- 密码: admin123

## License

MIT