102 lines
3.7 KiB
Markdown
102 lines
3.7 KiB
Markdown
# 学业邑规划 - 小程序前端
|
||
|
||
## 项目概述
|
||
|
||
基于 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/切图/`
|