Skip to content

MemoryClear/class-pet-garden

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
.github
.github
 
 
backend
backend
 
 
frontend
frontend
 
 
.dockerignore
.dockerignore
 
 
.gitignore
.gitignore
 
 
Dockerfile
Dockerfile
 
 
README.md
README.md
 
 
SPEC.md
SPEC.md
 
 
docker-compose.yml
docker-compose.yml
 
 

Repository files navigation

🐾 课堂宠物乐园 (ClassPet)

一款面向中小学教师的课堂行为管理系统——以"宠物养成"为情感化载体，将学生的课堂表现转化为宠物食物积累与等级成长。让课堂管理从"奖惩压力"变成"成长陪伴"。

演示激活码（不区分大小写）：memory_clear

✨ 功能一览

模块 功能
朗读系统 服务端 Edge TTS（中文 zh-CN-XiaoxiaoNeural / 英文 en-US-JennyNeural），连续重复字自动插入顿号避免声调压平
认证系统 注册 / 登录 / 激活码 / Token 验证 / Token 滑动过期
学生管理 添加 / 编辑 / 删除 / 随机分配宠物
宠物系统 10 种宠物可选 · 等级 Lv.1~Lv.6 · 进度条实时显示 · 各等级独立视觉特效
宝可梦系统 68 种 Gen1 宝可梦 · 精灵球领取 · 食物进化（进度条实时显示） · 道具进化 · 进化道具商店 · 代表宝可梦设置
加减分 评分项自由配置 · 分数历史可追溯 · 支持撤销
道具商店 虚拟装备（头饰/衣饰/配饰/特效）· 宠物更换卡 · 进化道具（水/火/叶/月/雷之石、联系绳）
光荣榜 食物排名 + 总积分排名 · 🥇🥈🥉 奖牌展示 · 6级徽章样式
学生明细 积分明细 + 道具使用记录双 Tab
课堂模块 语文诗词（朗读/默写/注音/声母韵母翻转卡/诗词填空测验）· 数学四则运算 · 英语字母测验 · 朗读打卡积分（5种活动，每日每人每项上限10分）
主题切换 10 套主题色，登录后全局生效

🏗 技术栈

层级 技术
前端 Vue 3 + Vite + Pinia + Vue Router + Axios
后端 Spring Boot 3.2 + Spring Security + JWT
数据库 SQLite（随 JAR 自带，零配置）
容器 Docker / Docker Compose

🚀 快速部署

Docker 部署（推荐）

# 拉取镜像
docker pull namejoe/class-pet-garden:latest

# 创建数据目录（bind mount 持久化数据）
mkdir -p ./data
chmod 777 ./data   # Linux/macOS 确保可写

# 运行容器
docker run -d \
  --name class-pet-garden \
  -p 8080:8080 \
  -v $(pwd)/data:/app/data \
  namejoe/class-pet-garden:latest

访问 http://localhost:8080 即可使用。

Docker Compose 部署

version: '3'
services:
  class-pet-garden:
    image: namejoe/class-pet-garden:latest
    container_name: class-pet-garden
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
docker compose up -d

手动运行（JAR）

cd backend
# 构建
mvn clean package -DskipTests

# 运行（数据存储在当前目录 ./data/）
java -jar target/class-pet-garden-1.0.0.jar

🐳 本地开发

后端

cd backend
# 首次运行自动建表
mvn spring-boot:run

后端端口：8080

前端

cd frontend
npm install
npm run dev

前端端口：5173（开发时自动代理 /api 到后端 8080）

完整重启

# 后端
Get-NetTCPConnection -LocalPort 8080 -ErrorAction SilentlyContinue | ForEach-Object { Stop-Process -Id $_.OwningProcess -Force }
cd D:\workspace\class-pet-garden\backend; mvn spring-boot:run

# 前端（新窗口）
cd D:\workspace\class-pet-garden\frontend; npm run dev

📁 项目结构

class-pet-garden/
├── backend/                  # Spring Boot 后端
│   ├── src/main/java/com/classpet/
│   │   ├── controller/       # REST API 控制器
│   │   ├── service/         # 业务逻辑
│   │   ├── repository/      # JPA 数据访问
│   │   ├── entity/          # 数据库实体
│   │   ├── dto/             # 数据传输对象
│   │   └── config/          # 安全配置 / CORS
│   └── src/main/resources/
│       ├── application.properties
│       ├── data/            # 宝可梦数据（species.json / evolution_rules.json）
│       └── pokemon/         # 宝可梦图片资源
│
├── frontend/                 # Vue 3 前端
│   ├── src/
│   │   ├── api/             # Axios 实例封装
│   │   ├── views/           # 页面组件
│   │   ├── components/      # 通用组件（PetCard、ScoreModal 等）
│   │   ├── stores/          # Pinia 状态管理
│   │   └── router/          # 路由守卫
│   └── package.json
│
├── data/                    # SQLite 数据文件（git 忽略）
├── Dockerfile
├── docker-compose.yml
├── SPEC.md                  # 项目规格说明书
└── README.md

🔑 核心 API

方法 路径 说明
POST /api/auth/register 注册账号
POST /api/auth/login 登录
POST /api/auth/activate 激活码激活
GET /api/auth/validate 验证 Token 有效性
GET /api/students 获取学生列表
POST /api/students 添加学生
PUT /api/students/{id} 编辑学生
DELETE /api/students/{id} 删除学生
POST /api/students/{id}/adopt 领养宠物
POST /api/students/assign-pets 随机分配宠物
POST /api/students/{id}/score 加减分
GET /api/score-items 评分项列表
POST /api/score-items 添加评分项
DELETE /api/score-items/{id} 删除评分项
GET /api/history 积分历史（支持 studentId/from/to 过滤）
DELETE /api/history/{id} 撤销积分记录
GET /api/pets 宠物库（10种宠物）
GET /api/shop/items 商店商品列表
POST /api/shop/exchange 兑换商品
POST /api/shop/gift 赠送道具
GET /api/settings 获取系统设置
PUT /api/settings 更新系统设置
GET /api/leaderboard/* 光荣榜排名
GET /api/student-pokemon 学生宝可梦列表
POST /api/student/pokemon-balls 使用精灵球领取宝可梦
POST /api/pokemon/{id}/evolve 宝可梦进化
POST /api/student/represent-pokemon 设置代表宝可梦

🐾 宠物等级

等级 所需食物 标签
Lv.1 0-9 🥚 幼崽期
Lv.2 10-29 🌱 少年期
Lv.3 30-59 ⚡ 成长期
Lv.4 60-99 💎 精英期
Lv.5 100-199 🔥 大师期
Lv.6 200+ 👑 传说期

🎮 宝可梦系统

核心功能

  • 精灵球领取：每月自动发放 1 个精灵球，使用后随机获得一只 Gen1 宝可梦
  • 食物进化：宝可梦食物积累到指定数量自动进化（如妙蛙种子 → 妙蛙草 → 妙蛙花），进度条实时显示还需多少食物
  • 道具进化：使用进化道具（水之石、火之石等）触发特殊进化
  • 代表宝可梦：设置一只宝可梦作为学生头像展示

进化道具

道具 价格 说明
💧 水之石 30 让特定宝可梦进化
🔥 火之石 30 让特定宝可梦进化
🍃 叶之石 30 让特定宝可梦进化
🌙 月之石 30 让特定宝可梦进化
⚡ 雷之石 30 让特定宝可梦进化
🔗 联系绳 30 让特定宝可梦进化

数据来源

  • 宝可梦数据：42arch/pokemon-dataset-zh
  • species.json 包含 Gen1Gen8 共 166 条（含Mega/极巨化等形态），班级可抽取池为 Gen1（#001#151）tier=1 的 68 种宝可梦

⚙️ 配置说明

配置项 说明 默认值
server.port 服务端口 8080
spring.datasource.url 数据库路径 ./data/classpet.db
jwt.secret JWT 签名密钥 内置默认（请自行修改）
jwt.expiration Token 有效期 7 天（滑动过期）

📝 版本历史

  • v1.4.1 - 服务端 Edge TTS 朗读（中文/英文），朗读打卡积分系统上线
  • v1.2.0 - 宝可梦系统上线（精灵球领取 / 食物进化 / 道具进化 / 代表宝可梦）
  • v1.1.3 - 扩展等级体系至 6 级（幼崽/少年/成长/精英/大师/传说），各等级独立视觉特效
  • v1.1.2 - 全局 ConfirmModal 替换原生 alert/confirm，统一 UI 风格
  • v1.1.1 - 学生端功能完善（登录/领养宠物/积分明细/道具记录/测验）
  • v1.1.0 - 课堂模块上线（语文诗词/数学四则运算/英语字母翻转卡）
  • v1.0.21 - 清理测试脚本，添加 .gitignore 规则
  • v1.0.20 - 修复路由守卫无限重定向
  • ...（详见 GitHub Releases）

📌 演示激活码：memory_clear

About

🐾 课堂宠物养成系统 — Spring Boot + Vue 3 + SQLite，将学生课堂表现转化为宠物成长，让课堂管理更有温度。

Resources

Readme
Activity

Stars

3 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases 4

v1.4.3 Latest
May 29, 2026
+ 3 releases

Packages

 
 
 

Contributors

Languages