cgx/petwash

Fork 0

Files

GukSang.Jin 9c66b6cd82

2026-03-03 16:55:02 +08:00

4.4 KiB

Raw Blame History

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

系统架构

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

PetWash.Api - 后端API服务（ASP.NET Core）
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 运行

界面演示流程

完整操作流程

待机界面
- 系统启动后显示待机界面
- 显示硬件状态和实时数据
- 点击"点击开始"按钮
选择套餐
- 进入支付界面
- 显示可用套餐列表
- 点击任意套餐卡片
确认支付
- 弹出支付确认对话框
- 显示套餐信息和金额
- 点击"是"确认支付
放入宠物
- 支付成功后返回待机界面
- 系统提示"门已打开"
- （实际使用时）将宠物放入设备
开始洗护
- 门打开状态下，"关门开始"按钮可用
- 点击"关门开始"按钮
- 自动切换到洗护进度界面
洗护进行中
- 显示当前步骤和剩余时间
- 显示总体进度条
- 显示流程步骤列表
- 实时更新底部数据（水温、水位、门状态）
完成
- 洗护完成后弹出提示
- 自动返回待机界面
- 准备下一次使用

界面特点

深蓝科技风格

深蓝色渐变背景 (#0F3A7D)
高对比度文字 (#E8F0FF)
青蓝色强调元素 (#00D4FF)
LED指示灯效果
发光按钮和数字显示

三个主要界面

待机界面 - 系统状态和硬件监控
支付界面 - 套餐选择和支付
洗护界面 - 实时进度和流程监控

洗护流程步骤

第一次冲水 (120秒)
沐浴露喷洒 (30秒)
第二次冲水 (180秒)
香波喷洒 (30秒)
第三次冲水 (180秒)
热风吹毛 (300秒)
冷热风混合 (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风格

下一步

生产环境部署

配置真实支付系统（微信/支付宝）
连接真实硬件传感器
部署MQTT服务器
配置云端监控
调整洗护时间为实际值

功能扩展

添加参数设置界面
添加故障诊断界面
添加历史订单查询
添加远程监控功能
添加多语言支持

联系支持

如有问题，请查看：

UI_IMPLEMENTATION.md - 界面实现详细说明
BUILD_SUCCESS.md - 构建成功记录
FIX_SUMMARY.md - 问题修复记录

许可证

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

4.4 KiB Raw Blame History Unescape Escape