# mango_uni

**Repository Path**: cool-breeze_9/mango_uni

## Basic Information

- **Project Name**: mango_uni
- **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-01-04
- **Last Updated**: 2026-02-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 芒果学习 - 英语单词学习小程序

## 项目简介

芒果学习是一个基于 uniapp + uview Pro + Vue3 开发的英语单词学习小程序，主要支持微信小程序平台。应用提供了丰富的学习功能，帮助学生高效记忆英语单词。

## 功能模块

### 1. 单词快练（首页）
- 用户信息展示（头像、姓名、年级）
- 学习级别切换（小学/初中/高中）
- 芒果课堂横幅入口
- 随堂同步：
  - 课课练：课内单词选择题练习
  - 课课读：课内句子录音跟读
- 专属定制：
  - 综合练：自定义每日学习单词量
- 趣味挑战：
  - 挑战赛：单词随机测试排行榜

### 2. 芒果课堂
- 课程横幅展示
- 学习进度统计
- 推荐课程列表
- 学习小贴士

### 3. 作业广场
- 作业列表（待完成/进行中/已完成）
- 作业详情查看
- 学习进度跟踪
- 成绩展示

### 4. 个人中心
- 用户信息管理
- 学习数据统计（连续学习天数、学习单词数、积分）
- 学习报告（周报告/月报告）
- 徽章系统
- 学习目标设置
- 学习历史和收藏

### 5. 课课练
- 单词选择题练习
- 实时答题反馈
- 进度显示
- 成绩统计

### 6. 课课读
- 单词发音播放
- 录音跟读功能
- 单词详情展示

### 7. 综合练
- 自定义学习设置
- 练习模式选择（选择题/填空题）
- 难度等级选择
- 今日学习统计

### 8. 挑战赛
- 实时排行榜
- 挑战规则说明
- 个人战绩统计
- 限时答题

## 技术栈

- **框架**: uniapp (Vue3 + Composition API)
- **UI组件库**: uview-pro
- **数据存储**: 小程序本地存储（已封装，便于后续切换API）
- **图标**: uView内置图标
- **图片**: Unsplash API

## 项目结构


mango/
├── pages/                      # 页面目录
│   ├── index/         # 单词快练（首页）
│   ├── classroom/             # 芒果课堂
│   ├── homework/              # 作业广场
│   ├── profile/               # 个人中心
│   ├── lesson-practice/       # 课课练
│   ├── lesson-read/           # 课课读
│   ├── comprehensive/         # 综合练
│   └── challenge/             # 挑战赛
├── services/                   # 服务层
│   ├── wordService.js         # 单词数据服务
│   └── userService.js         # 用户数据服务
├── utils/                      # 工具函数
│   └── storage.js             # 存储封装
├── static/                     # 静态资源
│   ├── logo.png
│   └── tabbar/                # tabBar图标（需自行添加）
├── uni_modules/               # uni模块
│   └── uview-pro/            # uview-pro组件库
├── App.vue                    # 应用配置
├── main.js                    # 入口文件
├── pages.json                 # 页面配置
└── manifest.json              # 应用配置



## 数据结构

### 单词数据

{
  id: 1,
  word: 'apple',              // 单词
  translation: '苹果',         // 翻译
  phonetic: '/ˈæpl/',         // 音标
  level: 'primary',           // 级别
  grade: 1                    // 年级
}


### 用户数据

{
  id: 1,
  name: '王多多',
  avatar: 'url',
  grade: 5,                   // 年级
  level: 'primary',           // 学习级别
  levelName: '小学',
  totalStudyDays: 0,          // 总学习天数
  continuousStudyDays: 0,     // 连续学习天数
  totalWords: 0,              // 总学习单词数
  masteredWords: 0,           // 已掌握单词数
  points: 0,                  // 积分
  badges: []                  // 徽章
}


## 本地存储Key

- `user_info`: 用户信息
- `word_progress`: 单词学习进度
- `learning_records`: 学习记录
- `challenge_records`: 挑战赛记录
- `daily_goal`: 每日学习目标

## 核心功能说明

### 1. 存储服务封装
所有数据存储操作都通过 `storage.js` 进行，提供了同步和异步两种方式，方便后续切换为API接口。

### 2. 单词服务
- 提供单词数据的增删改查
- 学习进度跟踪
- 学习统计分析
- 学习记录管理

### 3. 用户服务
- 用户信息管理
- 学习目标设置
- 徽章系统
- 连续学习天数统计

## 使用说明

### 1. 安装依赖
项目已包含 uview-pro 组件库，无需额外安装。

### 2. 运行项目

# 在HBuilderX中打开项目
# 选择运行 -> 运行到小程序模拟器 -> 微信开发者工具


### 3. TabBar图标
需要在 `static/tabbar/` 目录下添加以下图标：
- word.png / word-active.png
- classroom.png / classroom-active.png
- homework.png / homework-active.png
- profile.png / profile-active.png

建议尺寸：81px * 81px

## 待优化功能

1. **图片资源**: 当前使用Unsplash API获取图片，建议替换为本地图片或CDN
2. **TabBar图标**: 需要设计并添加实际的图标文件
3. **音频功能**: 课课读页面的音频播放和录音功能需要接入实际API
4. **数据持久化**: 当前使用本地存储，后续可切换为后端API
5. **用户头像**: 可接入微信授权获取真实头像
6. **单词库扩展**: 当前仅有示例数据，需要扩充完整的单词库
7. **学习算法**: 可引入艾宾浩斯记忆曲线等算法优化学习效果

## 扩展建议

1. **社交功能**: 添加好友系统、学习小组
2. **激励系统**: 完善徽章系统、排行榜、积分商城
3. **学习报告**: 详细的学习数据分析和可视化
4. **AI辅助**: 接入语音识别、智能推荐
5. **离线功能**: 支持离线学习和数据同步
6. **多平台**: 扩展支持H5、App等平台

## 注意事项

1. 项目使用Vue3 Composition API编写，需要HBuilderX 3.2+版本
2. uview-pro需要正确配置才能使用，已在main.js中完成配置
3. 小程序开发需要在微信开发者工具中进行调试
4. 图片使用Unsplash API，需要网络连接

## 开发者

专业的uniapp+uview Pro+vue3开发专家

## 版本

v1.0.0

## 许可

MIT License