# pet_miniapp

**Repository Path**: dheth/pet_miniapp

## Basic Information

- **Project Name**: pet_miniapp
- **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-06-10
- **Last Updated**: 2026-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 宠物养成小程序 - UniApp + Vue3 + UniCloud

## 项目概述

基于 Vue3 + UniApp + UniCloud 框架开发的微信小程序，一比一复刻 Figma 设计稿。

## 技术栈

- **前端框架**: Vue3 + UniApp
- **样式**: SCSS
- **后端**: UniCloud 云开发 / SpringBoot (Java)
- **状态管理**: 本地 Storage

## 项目结构

```
pet-miniapp/
├── components/              # 公共组件
│   ├── EvolutionModal/      # 进化动画弹窗
│   └── PetSwitchModal/      # 换宠物弹窗
├── pages/                   # 页面
│   ├── home/                # 首页（宠物展示、签到、统计）
│   ├── quiz/                # 答题页
│   └── bag/                 # 背包页
├── static/                  # 静态资源
│   └── icons/               # TabBar 图标
├── utils/                   # 工具
│   ├── api.js               # API 接口封装（预留联调代码）
│   └── data.js              # 本地静态数据
├── App.vue                  # 应用入口
├── main.js                  # Vue3 入口
├── manifest.json            # 应用配置
├── pages.json               # 页面路由 + TabBar
└── uni.scss                 # 全局 SCSS 变量
```

## 功能模块

### 首页
- 宠物展示（emoji 形式，支持浮动动画）
- 宠物名称编辑
- 能量值显示
- 阶段徽章（蛋蛋/幼崽/少年/成年）
- 升级进度条
- 答题入口
- 每日签到（+10 能量）
- 连续签到统计
- 今日战绩（答题次数/答对题数/今日能量）

### 答题页
- 5 道随机题目（常识/成语/科普/历史/生活）
- 答题进度条
- 选项 A/B/C/D 选择
- 答对/答错反馈
- 结果统计（答对题数/获得能量）
- 5 题全对额外 +20 能量奖励

### 背包页
- 外观装扮（皮肤购买/装备）
- 场景主题（场景购买/使用）
- 能量消耗解锁

### 进化系统
- 蛋蛋 → 幼崽（1 能量）
- 幼崽 → 少年（200 能量）
- 少年 → 成年（600 能量）
- 进化动画（破壳/变身特效）

## 数据存储

使用 `uni.getStorageSync` / `uni.setStorageSync` 本地存储游戏状态，键名为 `petGameState_v2`。

## 接口联调

所有 API 接口已预留，位于 `utils/api.js` 中。联调时取消对应接口的注释即可：

```javascript
// 联调时取消注释
// const res = await getQuestionList(5)
```

## 运行方式

1. 使用 HBuilderX 打开项目
2. 运行到微信小程序模拟器
3. 或使用命令行：`npm run dev:mp-weixin`

## 后端项目

SpringBoot 后端项目位于同级目录 `pet-server/`，包含完整的 REST API 接口实现。