209 lines
4.4 KiB
Markdown
209 lines
4.4 KiB
Markdown
# 无人自动洗宠机系统 - 快速启动指南
|
||
|
||
## 系统架构
|
||
|
||
本系统包含两个主要组件：
|
||
1. **PetWash.Api** - 后端API服务（ASP.NET Core）
|
||
2. **PetWashControl** - WPF工控屏界面（.NET 8.0 WPF）
|
||
|
||
## 启动步骤
|
||
|
||
### 1. 启动后端API服务
|
||
|
||
```bash
|
||
cd PetWash.Api
|
||
dotnet run
|
||
```
|
||
|
||
API将在以下地址运行：
|
||
- HTTP: http://localhost:5000
|
||
- HTTPS: https://localhost:5001
|
||
|
||
### 2. 启动WPF界面
|
||
|
||
```bash
|
||
cd PetWashControl
|
||
dotnet run
|
||
```
|
||
|
||
或者在Visual Studio中：
|
||
- 右键点击 `PetWashControl` 项目
|
||
- 选择"设为启动项目"
|
||
- 按 F5 运行
|
||
|
||
## 界面演示流程
|
||
|
||
### 完整操作流程
|
||
|
||
1. **待机界面**
|
||
- 系统启动后显示待机界面
|
||
- 显示硬件状态和实时数据
|
||
- 点击"点击开始"按钮
|
||
|
||
2. **选择套餐**
|
||
- 进入支付界面
|
||
- 显示可用套餐列表
|
||
- 点击任意套餐卡片
|
||
|
||
3. **确认支付**
|
||
- 弹出支付确认对话框
|
||
- 显示套餐信息和金额
|
||
- 点击"是"确认支付
|
||
|
||
4. **放入宠物**
|
||
- 支付成功后返回待机界面
|
||
- 系统提示"门已打开"
|
||
- （实际使用时）将宠物放入设备
|
||
|
||
5. **开始洗护**
|
||
- 门打开状态下，"关门开始"按钮可用
|
||
- 点击"关门开始"按钮
|
||
- 自动切换到洗护进度界面
|
||
|
||
6. **洗护进行中**
|
||
- 显示当前步骤和剩余时间
|
||
- 显示总体进度条
|
||
- 显示流程步骤列表
|
||
- 实时更新底部数据（水温、水位、门状态）
|
||
|
||
7. **完成**
|
||
- 洗护完成后弹出提示
|
||
- 自动返回待机界面
|
||
- 准备下一次使用
|
||
|
||
## 界面特点
|
||
|
||
### 深蓝科技风格
|
||
- 深蓝色渐变背景 (#0F3A7D)
|
||
- 高对比度文字 (#E8F0FF)
|
||
- 青蓝色强调元素 (#00D4FF)
|
||
- LED指示灯效果
|
||
- 发光按钮和数字显示
|
||
|
||
### 三个主要界面
|
||
1. **待机界面** - 系统状态和硬件监控
|
||
2. **支付界面** - 套餐选择和支付
|
||
3. **洗护界面** - 实时进度和流程监控
|
||
|
||
### 洗护流程步骤
|
||
1. 第一次冲水 (120秒)
|
||
2. 沐浴露喷洒 (30秒)
|
||
3. 第二次冲水 (180秒)
|
||
4. 香波喷洒 (30秒)
|
||
5. 第三次冲水 (180秒)
|
||
6. 热风吹毛 (300秒)
|
||
7. 冷热风混合 (120秒)
|
||
|
||
总时长：约17分钟（演示模式加速100倍）
|
||
|
||
## 配置说明
|
||
|
||
### API配置
|
||
编辑 `PetWash.Api/appsettings.json`：
|
||
|
||
```json
|
||
{
|
||
"ConnectionStrings": {
|
||
"DefaultConnection": "Data Source=petwash.db"
|
||
},
|
||
"Mqtt": {
|
||
"BrokerHost": "localhost",
|
||
"BrokerPort": 1883
|
||
}
|
||
}
|
||
```
|
||
|
||
### WPF配置
|
||
编辑 `PetWashControl/appsettings.json`（如果存在）：
|
||
|
||
```json
|
||
{
|
||
"ApiBaseUrl": "http://localhost:5000",
|
||
"MqttBrokerHost": "localhost",
|
||
"MqttBrokerPort": 1883
|
||
}
|
||
```
|
||
|
||
## 默认套餐
|
||
|
||
系统预置了4个套餐：
|
||
|
||
| 套餐名称 | 价格 | 时长 | 描述 |
|
||
|---------|------|------|------|
|
||
| 基础清洗 | ¥68 | 15分钟 | 基础清洗服务 |
|
||
| 标准套餐 | ¥98 | 20分钟 | 标准清洗+护理 |
|
||
| 豪华套餐 | ¥128 | 25分钟 | 深度清洗+护理+香薰 |
|
||
| 至尊套餐 | ¥168 | 30分钟 | 全套服务+特殊护理 |
|
||
|
||
## 故障排除
|
||
|
||
### API无法启动
|
||
- 检查端口5000/5001是否被占用
|
||
- 确认.NET 8.0 SDK已安装
|
||
- 查看控制台错误信息
|
||
|
||
### WPF界面无法连接API
|
||
- 确认API服务已启动
|
||
- 检查防火墙设置
|
||
- 验证API地址配置正确
|
||
|
||
### MQTT连接失败
|
||
- MQTT服务器是可选的
|
||
- 如果没有MQTT服务器，系统仍可正常运行
|
||
- 只是无法接收远程命令
|
||
|
||
## 开发模式特性
|
||
|
||
### 加速模拟
|
||
- 洗护流程加速100倍（100ms/秒）
|
||
- 方便快速测试完整流程
|
||
|
||
### 支付模拟
|
||
- 使用对话框确认代替真实支付
|
||
- 无需集成支付网关即可测试
|
||
|
||
### 日志输出
|
||
- 所有操作都会记录日志
|
||
- 便于调试和问题追踪
|
||
|
||
## 技术栈
|
||
|
||
### 后端
|
||
- ASP.NET Core 8.0
|
||
- Entity Framework Core
|
||
- SQLite数据库
|
||
- MQTTnet
|
||
|
||
### 前端
|
||
- WPF (.NET 8.0)
|
||
- MVVM架构
|
||
- CommunityToolkit.Mvvm
|
||
- Material Design风格
|
||
|
||
## 下一步
|
||
|
||
### 生产环境部署
|
||
1. 配置真实支付系统（微信/支付宝）
|
||
2. 连接真实硬件传感器
|
||
3. 部署MQTT服务器
|
||
4. 配置云端监控
|
||
5. 调整洗护时间为实际值
|
||
|
||
### 功能扩展
|
||
1. 添加参数设置界面
|
||
2. 添加故障诊断界面
|
||
3. 添加历史订单查询
|
||
4. 添加远程监控功能
|
||
5. 添加多语言支持
|
||
|
||
## 联系支持
|
||
|
||
如有问题，请查看：
|
||
- `UI_IMPLEMENTATION.md` - 界面实现详细说明
|
||
- `BUILD_SUCCESS.md` - 构建成功记录
|
||
- `FIX_SUMMARY.md` - 问题修复记录
|
||
|
||
## 许可证
|
||
|
||
本项目用于无人自动洗宠机智能控制系统。
|