first commit
This commit is contained in:
149
README.md
Normal file
149
README.md
Normal file
@@ -0,0 +1,149 @@
|
|||||||
|
# AI学习助手 - UNIAPP 多端应用
|
||||||
|
|
||||||
|
## 项目概述
|
||||||
|
企业级多端应用项目,基于 UNIAPP 框架开发,支持微信小程序、H5、App 三端运行。
|
||||||
|
|
||||||
|
## 技术栈
|
||||||
|
- **核心框架**:UNIAPP (Vue 3 + Vite)
|
||||||
|
- **状态管理**:Pinia
|
||||||
|
- **样式方案**:Scss + UniApp 内置样式变量
|
||||||
|
- **网络请求**:统一封装的 request 工具
|
||||||
|
- **代码规范**:ESLint + Prettier + Husky
|
||||||
|
|
||||||
|
## 快速开始
|
||||||
|
```bash
|
||||||
|
# 安装依赖
|
||||||
|
npm install
|
||||||
|
|
||||||
|
# 运行微信小程序
|
||||||
|
npm run dev:mp-weixin
|
||||||
|
|
||||||
|
# 运行 H5
|
||||||
|
npm run dev:h5
|
||||||
|
|
||||||
|
# 运行 App
|
||||||
|
npm run dev:app
|
||||||
|
```
|
||||||
|
|
||||||
|
详细说明请查看 [快速开始.md](./快速开始.md)
|
||||||
|
|
||||||
|
## 项目特性
|
||||||
|
✅ 模块化架构设计
|
||||||
|
✅ 统一的状态管理
|
||||||
|
✅ 完善的错误处理
|
||||||
|
✅ 多端适配方案
|
||||||
|
✅ 性能优化策略
|
||||||
|
✅ 代码规范约束
|
||||||
|
|
||||||
|
## 核心功能模块
|
||||||
|
1. **AI助手** - 智能对话和心理辅导功能
|
||||||
|
2. **咨询** - 在线咨询服务
|
||||||
|
3. **测评** - 心理测评功能
|
||||||
|
4. **课程** - 学习课程管理
|
||||||
|
5. **我的** - 个人中心
|
||||||
|
|
||||||
|
## 文档
|
||||||
|
- [开发规范](./docs/开发规范.md)
|
||||||
|
- [多端适配方案](./docs/多端适配方案.md)
|
||||||
|
- [性能优化清单](./docs/性能优化清单.md)
|
||||||
|
- [TabBar样式说明](./TabBar样式说明.md)
|
||||||
|
- [图标准备说明](./图标准备说明.md)
|
||||||
|
|
||||||
|
## 项目结构
|
||||||
|
```
|
||||||
|
├── src/
|
||||||
|
│ ├── api/ # API 接口模块
|
||||||
|
│ ├── components/ # 通用组件
|
||||||
|
│ │ └── common/ # 公共组件(Loading、Empty、Error)
|
||||||
|
│ ├── config/ # 配置文件
|
||||||
|
│ │ ├── constants.js # 常量配置
|
||||||
|
│ │ └── env.js # 环境配置
|
||||||
|
│ ├── mixins/ # Vue 混入
|
||||||
|
│ │ ├── pageMixin.js # 页面混入
|
||||||
|
│ │ └── listMixin.js # 列表混入
|
||||||
|
│ ├── pages/ # 页面文件
|
||||||
|
│ │ ├── aibot/ # AI助手页面
|
||||||
|
│ │ ├── message/ # 咨询页面
|
||||||
|
│ │ ├── target/ # 测评页面
|
||||||
|
│ │ ├── library/ # 课程页面
|
||||||
|
│ │ ├── cloud/ # 我的页面
|
||||||
|
│ │ └── login/ # 登录页面
|
||||||
|
│ ├── static/ # 静态资源
|
||||||
|
│ │ ├── icons/ # 图标文件
|
||||||
|
│ │ ├── images/ # 图片文件
|
||||||
|
│ │ └── tabbar/ # TabBar 图标
|
||||||
|
│ ├── store/ # Pinia 状态管理
|
||||||
|
│ │ └── modules/ # 状态模块
|
||||||
|
│ ├── styles/ # 全局样式
|
||||||
|
│ │ ├── common.scss # 公共样式
|
||||||
|
│ │ ├── variables.scss # 样式变量
|
||||||
|
│ │ ├── mixins.scss # 样式混入
|
||||||
|
│ │ └── tabbar.scss # TabBar 样式
|
||||||
|
│ ├── utils/ # 工具函数
|
||||||
|
│ │ ├── request.js # 网络请求
|
||||||
|
│ │ ├── storage.js # 本地存储
|
||||||
|
│ │ ├── validator.js # 数据校验
|
||||||
|
│ │ ├── platform.js # 平台判断
|
||||||
|
│ │ └── performance.js # 性能优化
|
||||||
|
│ ├── App.vue # 应用入口
|
||||||
|
│ ├── main.js # 主入口文件
|
||||||
|
│ ├── pages.json # 页面配置
|
||||||
|
│ └── manifest.json # 应用配置
|
||||||
|
├── docs/ # 文档目录
|
||||||
|
├── tests/ # 测试文件
|
||||||
|
├── .eslintrc.js # ESLint 配置
|
||||||
|
├── .prettierrc.js # Prettier 配置
|
||||||
|
├── vite.config.js # Vite 配置
|
||||||
|
└── package.json # 项目配置
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
## 开发注意事项
|
||||||
|
|
||||||
|
### TabBar 配置
|
||||||
|
- 字体:PingFang SC, Weight 600, Size 11px
|
||||||
|
- 颜色:未选中 #A1A1AA,选中 #27272A
|
||||||
|
- 图标位置:`src/static/tabbar/`
|
||||||
|
|
||||||
|
### AI助手页面
|
||||||
|
- 使用自定义导航栏
|
||||||
|
- 背景图使用在线 URL
|
||||||
|
- 功能卡片支持横向滚动
|
||||||
|
- 暂时使用 emoji 作为图标占位符
|
||||||
|
|
||||||
|
### 静态资源
|
||||||
|
功能卡片图标需要准备以下文件(详见 [图标准备说明.md](./图标准备说明.md)):
|
||||||
|
- diary.png - 心情日记
|
||||||
|
- emotion.png - 情绪分析
|
||||||
|
- stress.png - 压力测评
|
||||||
|
- meditation.png - 冥想放松
|
||||||
|
- sleep.png - 睡眠助手
|
||||||
|
|
||||||
|
## 环境配置
|
||||||
|
项目支持三种环境:
|
||||||
|
- **开发环境** (development)
|
||||||
|
- **测试环境** (test)
|
||||||
|
- **生产环境** (production)
|
||||||
|
|
||||||
|
环境配置文件:`src/config/env.js`
|
||||||
|
|
||||||
|
## 代码规范
|
||||||
|
- 使用 ESLint 进行代码检查
|
||||||
|
- 使用 Prettier 进行代码格式化
|
||||||
|
- 使用 Husky 进行 Git 提交前检查
|
||||||
|
- 遵循 Vue 3 组合式 API 最佳实践
|
||||||
|
|
||||||
|
## 浏览器支持
|
||||||
|
- Chrome >= 87
|
||||||
|
- Firefox >= 78
|
||||||
|
- Safari >= 14
|
||||||
|
- Edge >= 88
|
||||||
|
|
||||||
|
## 小程序支持
|
||||||
|
- 微信小程序基础库 >= 2.10.0
|
||||||
|
|
||||||
|
## 许可证
|
||||||
|
MIT
|
||||||
|
|
||||||
|
## 联系方式
|
||||||
|
如有问题,请联系开发团队。
|
||||||
Reference in New Issue
Block a user