# LexiGo_Frontend

**Repository Path**: AchieveMiniMax/lexi-go_-frontend

## Basic Information

- **Project Name**: LexiGo_Frontend
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-29
- **Last Updated**: 2026-03-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LexiGo 背单词微信小程序 - 前端项目

## 项目简介

LexiGo 是一款极简背单词微信小程序，核心价值在于"打开即学、操作零成本"。

## 技术栈

- **框架**: UniApp 3.x (Vue 3)
- **状态管理**: Pinia
- **样式**: SCSS
- **目标平台**: 微信小程序

## 项目结构

```
LexiGo_Frontend/
├── components/                # 公共组件
│   ├── lexigo-progress-bar/  # 进度条组件
│   ├── lexigo-action-button/  # 操作按钮组件
│   ├── lexigo-word-card/      # 单词卡片组件
│   └── lexigo-stat-card/      # 统计卡片组件
├── pages/                     # 页面文件
│   ├── index/                 # 学习页（首页）
│   ├── collection/            # 生词本
│   ├── statistics/            # 统计页
│   ├── profile/               # 个人中心
│   └── login/                 # 登录页
├── static/                    # 静态资源
│   └── tabs/                  # TabBar图标
├── stores/                    # 状态管理
│   └── user.js                # 用户状态
├── styles/                    # 样式文件
│   ├── variables.scss         # 样式变量
│   └── common.scss            # 公共样式
├── utils/                     # 工具函数
│   ├── request.js             # 网络请求
│   ├── api.js                 # API接口
│   ├── storage.js             # 本地存储
│   └── audio.js              # 音频播放
├── App.vue                    # 应用入口
├── main.js                    # 主入口
├── manifest.json              # 应用配置
├── pages.json                 # 页面配置
├── uni.scss                   # UniApp全局样式
└── package.json              # 依赖配置
```

## 功能模块

### 1. 学习页（首页）
- 顶部进度条展示
- 单词信息展示（词性、单词、音标、释义、例句）
- 发音播放功能
- 收藏/已掌握标记
- 分享功能
- 今日完成提示

### 2. 生词本
- 收藏单词列表
- 已掌握单词列表
- Tab切换
- 搜索功能
- 分页加载

### 3. 统计页
- 学习数据卡片（坚持天数、累计单词、今日完成、累计收藏）
- 近7天学习图表
- 成就徽章展示

### 4. 个人中心
- 用户信息展示
- 每日计划设置
- 偏好设置
- 每日提醒
- 离线单词包
- 帮助与反馈
- 退出登录

## 开发指南

### 环境要求

- Node.js >= 16.x
- HBuilderX 或 VS Code + UniApp插件

### 安装依赖

```bash
npm install
```

### 开发运行

```bash
# 使用 HBuilderX
1. 打开 HBuilderX
2. 导入项目
3. 运行到微信小程序

# 使用命令行
npm run dev:mp-weixin
```

### 项目编译

```bash
npm run build:mp-weixin
```

## 配置说明

### 1. 修改 AppID

在 `manifest.json` 中修改 `mp-weixin.appid` 为你的小程序 AppID：

```json
{
  "mp-weixin": {
    "appid": "your-appid"
  }
}
```

### 2. 添加 TabBar 图标

在 `static/tabs/` 目录下添加以下图标文件：

- `home.png` / `home-active.png`
- `book.png` / `book-active.png`
- `chart.png` / `chart-active.png`
- `user.png` / `user-active.png`

图标规格：
- 尺寸：24px × 24px
- 格式：PNG（支持透明）
- 未选中颜色：#94a3b8
- 选中颜色：#1e293b

### 3. 配置后端API

在 `utils/request.js` 中修改 `BASE_URL` 为你的后端接口地址：

```javascript
const BASE_URL = 'https://your-api-domain.com/word-api/v1'
```

## 接口文档

详细接口文档请参考：[架构师-接口契约结构.md](./架构师-接口契约结构.md)

## 数据库设计

数据库设计请参考：[DBA数据库设计师-数据库设计文档.md](./DBA数据库设计师-数据库设计文档.md)

## 产品需求

产品需求文档请参考：[产品经理-需求文档.md](./产品经理-需求文档.md)

## 性能优化

- 按钮防抖（500ms）
- 数据本地缓存
- 图片懒加载
- 列表分页加载
- 音频播放优化

## 兼容性

- 支持微信版本 >= 8.0
- 适配 iOS 和 Android
- 适配不同屏幕尺寸（使用 rpx 单位）
- 适配 iPhone X 及以上安全区域

## 后续迭代

- 复习机制（基于遗忘曲线）
- 学习激励（连续打卡、成就勋章）
- 单词筛选（按难度/场景）
- 社交功能（学习圈、好友PK）

## License

MIT License

## 联系方式

如有问题，请提交 Issue 或联系开发团队。