petwash/QUICK_START.md

无人自动洗宠机系统 - 快速启动指南

系统架构

本系统包含两个主要组件：

1. PetWash.Api - 后端API服务（ASP.NET Core）
2. PetWashControl - WPF工控屏界面（.NET 8.0 WPF）

启动步骤

1. 启动后端API服务

cd PetWash.Api
dotnet run

API将在以下地址运行：

• HTTP: http://localhost:5000
• HTTPS: https://localhost:5001

2. 启动WPF界面

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：

{
  "ConnectionStrings": {
    "DefaultConnection": "Data Source=petwash.db"
  },
  "Mqtt": {
    "BrokerHost": "localhost",
    "BrokerPort": 1883
  }
}

WPF配置

编辑 PetWashControl/appsettings.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 - 问题修复记录

许可证

本项目用于无人自动洗宠机智能控制系统。