Files
nxxmdata/government-mini-program/QUICK_START.md

139 lines
3.1 KiB
Markdown
Raw Normal View History

2025-09-19 17:52:28 +08:00
# 政府端小程序快速开始指南
## 🚀 快速启动
### 1. 环境检查
确保您的开发环境满足以下要求:
- Node.js 16.20.2 或更高版本
- npm 8.0.0 或更高版本
- 微信开发者工具(用于小程序开发)
### 2. 后端服务
确保政府端后端服务正在运行:
```bash
# 在 government-backend 目录下
npm start
# 服务将在 http://localhost:5352 启动
```
### 3. 启动小程序
```bash
# 进入项目目录
cd government-mini-program
# 安装依赖
npm install
# 启动H5开发服务器
npm run dev:h5
```
### 4. 访问应用
打开浏览器访问http://localhost:8080
## 🔑 登录信息
使用以下默认账号登录:
- **用户名**: admin
- **密码**: 123456
## 📱 功能导航
### 主要功能模块
1. **首页** - 数据概览和快捷功能
2. **数据看板** - 统计图表和数据分析
3. **监管管理** - 监管记录和检查管理
4. **审批管理** - 审批流程和状态跟踪
5. **人员管理** - 工作人员信息管理
6. **疫情监控** - 疫情数据和预警
7. **服务管理** - 政府服务项目管理
8. **仓库管理** - 物资仓库管理
9. **个人中心** - 用户设置和个人信息
### 快捷操作
- **搜索**: 在列表页面使用搜索框快速查找
- **筛选**: 点击筛选按钮进行条件筛选
- **新增**: 点击右上角"+"按钮添加新记录
- **编辑**: 点击列表项的编辑按钮
- **删除**: 点击列表项的删除按钮
## 🛠️ 开发模式
### H5开发
```bash
npm run dev:h5
```
- 支持热重载
- 自动打开浏览器
- 支持移动端调试
### 微信小程序开发
```bash
# 构建小程序
npm run build:mp-weixin
# 使用微信开发者工具打开 dist/mp-weixin 目录
```
### 生产构建
```bash
# H5生产构建
npm run build:h5
# 微信小程序生产构建
npm run build:mp-weixin
```
## 🔧 配置说明
### API配置
`src/utils/request.js` 中配置API基础地址
```javascript
const BASE_URL = process.env.NODE_ENV === 'development'
? 'http://localhost:5352/api'
: 'https://your-domain.com/api'
```
### 微信小程序配置
`manifest.json` 中配置小程序信息:
```json
{
"mp-weixin": {
"appid": "your-wechat-appid",
"setting": {
"urlCheck": false
}
}
}
```
## 📋 常见问题
### Q: 无法连接到后端服务
A: 确保后端服务正在运行检查端口5352是否被占用
### Q: 登录失败
A: 检查用户名密码是否正确,确保后端认证接口正常
### Q: 页面显示异常
A: 检查浏览器控制台错误信息,确保所有依赖已正确安装
### Q: 微信小程序无法预览
A: 确保已配置正确的AppID检查网络连接
## 🎯 下一步
1. **自定义配置**: 根据实际需求修改API地址和配置
2. **添加功能**: 在现有基础上扩展新的功能模块
3. **样式调整**: 根据设计稿调整UI样式和布局
4. **数据对接**: 连接真实的后端API接口
5. **测试部署**: 进行功能测试和生产环境部署
## 📞 技术支持
如有问题,请参考:
- 项目README.md文件
- 项目PROJECT_SUMMARY.md文件
- 微信小程序官方文档
- Vue.js官方文档