petwash/QUICK_START_PAYMENT.md

快速启动指南 - 完整支付流程演示

5分钟快速体验

第一步：启动后端服务（1分钟）

打开终端，执行：

cd PetWash.Api
dotnet run

等待看到：

Now listening on: http://localhost:5000

第二步：启动WPF客户端（1分钟）

打开新的终端，执行：

cd PetWashControl
dotnet run

等待应用程序窗口打开。

第三步：体验完整流程（3分钟）

1. 待机界面 → 点击"点击开始"

2. 套餐选择 → 点击任意套餐（如"标准版"）

3. 二维码支付 → 点击"模拟支付成功"

• 等待1.5秒支付处理
• 弹出"支付成功"提示
• 点击确定

4. 门已打开 → 点击"关闭门并开始洗护"

5. 洗护进行中 → 观看自动流程

• 自动执行7个步骤
• 实时更新进度和剩余时间
• 约10秒完成（加速模拟）

6. 洗护完成 → 点击确定

• 返回待机界面
• 准备下一次服务

完整流程图

┌─────────────┐
│  待机界面    │ ← 系统就绪
└──────┬──────┘
       │ 点击开始
       ↓
┌─────────────┐
│ 套餐选择界面 │ ← 显示3个套餐
└──────┬──────┘
       │ 选择套餐
       ↓
┌─────────────┐
│ 二维码支付   │ ← 显示二维码和订单信息 ✨ 新增
└──────┬──────┘
       │ 模拟支付成功
       ↓
┌─────────────┐
│  待机界面    │ ← 门已打开，显示关门按钮
└──────┬──────┘
       │ 关闭门并开始洗护
       ↓
┌─────────────┐
│ 洗护进度界面 │ ← 自动执行7个步骤
└──────┬──────┘
       │ 自动完成
       ↓
┌─────────────┐
│  待机界面    │ ← 返回初始状态
└─────────────┘

关键功能演示

✨ 新增功能：二维码支付界面

特点：

• 显示订单信息（套餐名称、金额）
• 模拟二维码图案
• 支付处理动画（1.5秒）
• 支付成功提示
• 取消支付选项

操作：

1. 选择套餐后自动跳转
2. 点击"模拟支付成功"完成支付
3. 或点击"取消支付"返回套餐选择

✨ 优化功能：门状态控制

特点：

• 根据门状态动态显示不同按钮
• 门关闭：显示"点击开始"
• 门打开：显示橙色警告和"关闭门并开始洗护"

操作：

1. 支付成功后门自动打开
2. 用户放入宠物
3. 点击关门按钮启动洗护

✨ 完善功能：洗护流程

特点：

• 实时显示当前步骤
• 倒计时显示剩余时间
• 动态更新进度百分比
• 流程步骤列表可视化

步骤：

1. 第一次冲水 (120秒)
2. 沐浴露喷洒 (30秒)
3. 第二次冲水 (180秒)
4. 香波喷洒 (30秒)
5. 第三次冲水 (180秒)
6. 热风吹毛 (300秒)
7. 冷热风混合 (120秒)

测试要点

✅ 必测项目

• 完整流程走通（开始→支付→关门→洗护→完成）
• 支付取消功能
• 门状态切换
• 进度实时更新
• 错误提示显示

✅ 界面检查

• 二维码支付界面显示正常
• 订单信息正确
• 按钮响应正常
• 界面切换流畅
• 数据绑定正确

✅ 状态验证

• 门状态正确（开/关）
• 订单状态正确
• 进度计算准确
• 时间倒计时正确

常见问题

Q1: 后端连接失败

现象： 弹出"无法连接到服务器"错误

解决：

1. 检查PetWash.Api是否正在运行
2. 确认端口5000未被占用
3. 查看防火墙设置

Q2: 界面不切换

现象： 点击按钮后界面没有变化

解决：

1. 检查日志输出
2. 重启应用程序
3. 查看是否有异常提示

Q3: 进度不更新

现象： 洗护界面进度条不动

解决：

1. 检查IsWashing属性
2. 查看后台任务是否运行
3. 重新启动洗护流程

Q4: 支付后门没打开

现象： 支付成功但待机界面没有显示关门按钮

解决：

1. 检查IsDoorOpen属性
2. 查看API返回数据
3. 重新进行支付流程

演示技巧

讲解要点

1. 支付流程：强调二维码支付的真实感
2. 门控制：展示自动开门和关门功能
3. 实时反馈：指出进度和状态的实时更新
4. 用户体验：说明操作简单直观

演示顺序

1. 先演示完整正常流程
2. 再演示取消支付流程
3. 最后回答观众问题

时间控制

• 完整流程：3-4分钟
• 取消流程：1分钟
• Q&A：5-10分钟
• 总计：10-15分钟

下一步

查看详细文档

• PAYMENT_FLOW_GUIDE.md - 完整功能说明
• TEST_FLOW.md - 详细测试清单
• DEMO_SCRIPT.md - 演示脚本和讲解词
• IMPLEMENTATION_SUMMARY.md - 技术实现总结

开始开发

• 查看源代码了解实现细节
• 参考文档进行功能扩展
• 运行测试验证功能正确性

反馈和改进

• 记录使用过程中的问题
• 提出改进建议
• 参与功能讨论

---

祝您使用愉快！ 🎉

如有问题，请查看详细文档或联系开发团队。