187 lines
3.5 KiB
Markdown
187 lines
3.5 KiB
Markdown
# 校园管理移动端
|
||
|
||
基于 uniapp + uView UI 构建的校园管理移动端应用。
|
||
|
||
## 项目特性
|
||
|
||
- 🚀 基于 uniapp 框架，支持多端部署
|
||
- 🎨 采用 uView UI 组件库，界面美观
|
||
- 📱 响应式设计，适配各种屏幕尺寸
|
||
- 🔐 完整的登录认证系统
|
||
- 📊 丰富的数据展示组件
|
||
- 🛠 完善的工具函数和 API 封装
|
||
|
||
## 技术栈
|
||
|
||
- **框架**: uniapp (Vue 3)
|
||
- **UI 库**: uView UI 2.x
|
||
- **状态管理**: Vuex
|
||
- **网络请求**: uni.request 封装
|
||
- **样式**: SCSS
|
||
- **构建工具**: Vue CLI
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
xgxt-mobile/
|
||
├── pages/ # 页面文件
|
||
│ ├── login/ # 登录页面
|
||
│ ├── index/ # 首页
|
||
│ ├── workbench/ # 工作台
|
||
│ └── mine/ # 我的页面
|
||
├── static/ # 静态资源
|
||
│ └── tabbar/ # 底部导航图标
|
||
├── utils/ # 工具函数
|
||
│ ├── auth.js # 认证相关
|
||
│ └── request.js # 网络请求
|
||
├── api/ # API接口
|
||
│ ├── auth.js # 认证接口
|
||
│ └── common.js # 通用接口
|
||
├── uni_modules/ # uni_modules目录
|
||
├── App.vue # 应用入口
|
||
├── main.js # 主入口文件
|
||
├── pages.json # 页面配置
|
||
├── manifest.json # 应用配置
|
||
└── uni.scss # 全局样式变量
|
||
```
|
||
|
||
## 功能模块
|
||
|
||
### 1. 登录认证
|
||
|
||
- 用户名密码登录
|
||
- 登录状态保持
|
||
- 自动登录检查
|
||
- 退出登录
|
||
|
||
### 2. 首页
|
||
|
||
- 用户信息展示
|
||
- 轮播图
|
||
- 快捷功能入口
|
||
- 数据统计
|
||
- 最新动态
|
||
|
||
### 3. 工作台
|
||
|
||
- 工作统计
|
||
- 待办事项
|
||
- 工作流程
|
||
- 快速操作
|
||
|
||
### 4. 我的页面
|
||
|
||
- 个人信息
|
||
- 功能设置
|
||
- 应用配置
|
||
- 退出登录
|
||
|
||
## 安装和运行
|
||
|
||
### 1. 安装依赖
|
||
|
||
```bash
|
||
npm install
|
||
```
|
||
|
||
### 2. 安装 uView UI
|
||
|
||
```bash
|
||
npm install uview-ui@2.0.36
|
||
```
|
||
|
||
### 3. 运行项目
|
||
|
||
```bash
|
||
# H5端开发
|
||
npm run dev:h5
|
||
|
||
# 微信小程序
|
||
npm run dev:mp-weixin
|
||
|
||
# APP端
|
||
npm run dev:app-plus
|
||
```
|
||
|
||
### 4. 构建项目
|
||
|
||
```bash
|
||
# H5端构建
|
||
npm run build:h5
|
||
|
||
# 微信小程序构建
|
||
npm run build:mp-weixin
|
||
|
||
# APP端构建
|
||
npm run build:app-plus
|
||
```
|
||
|
||
## 默认登录信息
|
||
|
||
- 用户名: admin
|
||
- 密码: admin
|
||
|
||
## 配置说明
|
||
|
||
### 1. 网络请求配置
|
||
|
||
在 `utils/request.js` 中修改 `BASE_URL` 为实际的 API 地址：
|
||
|
||
```javascript
|
||
const BASE_URL = 'https://your-api-domain.com';
|
||
```
|
||
|
||
### 2. 应用配置
|
||
|
||
在 `manifest.json` 中修改应用基本信息：
|
||
|
||
```json
|
||
{
|
||
"name": "你的应用名称",
|
||
"appid": "你的应用ID",
|
||
"description": "应用描述"
|
||
}
|
||
```
|
||
|
||
### 3. 页面配置
|
||
|
||
在 `pages.json` 中配置页面路由和 tabBar：
|
||
|
||
- 添加新页面路由
|
||
- 修改 tabBar 图标和文字
|
||
- 配置页面样式
|
||
|
||
## 开发规范
|
||
|
||
### 1. 命名规范
|
||
|
||
- 文件名使用小写+连字符
|
||
- 组件名使用大驼峰
|
||
- 变量名使用小驼峰
|
||
|
||
### 2. 代码规范
|
||
|
||
- 使用 ESLint 进行代码检查
|
||
- 统一使用 2 空格缩进
|
||
- 使用分号结尾
|
||
|
||
### 3. 提交规范
|
||
|
||
- feat: 新功能
|
||
- fix: 修复 bug
|
||
- docs: 文档更新
|
||
- style: 代码格式调整
|
||
- refactor: 重构
|
||
- test: 测试相关
|
||
|
||
## 注意事项
|
||
|
||
1. 请确保已安装 uView UI 插件
|
||
2. 静态资源文件需要替换为实际的图片文件
|
||
3. API 接口需要根据后端实际情况进行调整
|
||
4. 不同平台可能需要特殊配置
|
||
|
||
## 许可证
|
||
|
||
MIT License
|