# 学业邑规划 - 小程序前端

## 项目概述

基于 UniApp + Vue 3 + TypeScript 开发的微信小程序，提供多元智能测评和学业规划服务。

## 技术栈

| 技术 | 版本 | 说明 |
|------|------|------|
| UniApp | 3.x | 跨平台框架 |
| Vue | 3.x | 前端框架 (Composition API) |
| Pinia | 2.x | 状态管理 |
| uni-ui | latest | UI 组件库 |
| Sass | latest | CSS 预处理器 |

## 快速开始

```bash
# 安装依赖
npm install

# 开发模式（微信小程序）
npm run dev:mp-weixin

# 构建生产版本
npm run build:mp-weixin
```

## 项目结构

```
uniapp/
├── api/                        # API 接口
│   ├── request.js              # 请求封装
│   ├── user.js                 # 用户接口
│   ├── home.js                 # 首页接口
│   ├── assessment.js           # 测评接口
│   ├── order.js                # 订单接口
│   ├── planner.js              # 规划师接口
│   ├── invite.js               # 分销接口
│   └── index.js                # 统一导出
├── components/                 # 公共组件
│   ├── common/                 # 通用组件
│   └── business/               # 业务组件
├── composables/                # 组合式函数
│   ├── useAuth.js              # 认证相关
│   ├── usePayment.js           # 支付相关
│   └── useShare.js             # 分享相关
├── config/                     # 配置
│   └── index.js                # 环境配置
├── pages/                      # 页面
│   ├── index/                  # 首页（TabBar）
│   ├── team/                   # 团队（TabBar）
│   ├── mine/                   # 我的（TabBar）
│   ├── login/                  # 登录
│   ├── assessment/             # 测评相关
│   ├── order/                  # 订单相关
│   ├── planner/                # 学业规划
│   ├── invite/                 # 邀请分销
│   └── about/                  # 关于/协议
├── static/                     # 静态资源
│   ├── images/                 # 图片
│   └── icons/                  # 图标
├── store/                      # Pinia 状态管理
│   ├── user.js                 # 用户状态
│   ├── app.js                  # 应用状态
│   └── index.js                # 统一导出
├── styles/                     # 全局样式
│   ├── variables.scss          # 变量定义
│   ├── mixins.scss             # 混入
│   └── common.scss             # 通用样式
├── utils/                      # 工具函数
│   ├── storage.js              # 本地存储
│   ├── format.js               # 格式化
│   └── validate.js             # 验证
├── App.vue                     # 根组件
├── main.js                     # 入口文件
├── manifest.json               # 应用配置
├── pages.json                  # 页面配置
└── uni.scss                    # uni-app 样式变量
```

## 相关文档

- [开发规范](./docs/开发规范.md)
- [页面清单](./docs/页面清单.md)
- [组件文档](./docs/组件文档.md)
- [API 文档](./docs/API文档.md)

## 设计资源

- Figma 设计图：https://www.figma.com/design/88edYGASUcyID6afiwILdf/项目?node-id=432-1991
- 本地设计图：`docs/设计图/`
- 切图资源：`docs/切图/`