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

## 项目概述

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

## 技术栈

| 技术 | 版本 | 说明 |
|------|------|------|
| UniApp | 3.x | 跨平台框架 |
| Vue | 3.x | 前端框架 |
| TypeScript | 5.x | 类型系统 |
| Pinia | 2.x | 状态管理 |
| uni-ui | latest | UI 组件库 |
| Sass | latest | CSS 预处理器 |

## 快速开始

```bash
# 安装依赖
npm install

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

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

## 项目结构

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

## 相关文档

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

## 设计资源

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