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` - 问题修复记录
|
|||
|
|
|
|||
|
|
## 许可证
|
|||
|
|
|
|||
|
|
本项目用于无人自动洗宠机智能控制系统。
|