111 lines (95 loc) · 5.94 KB

📌 WeWaiter 接下来路线图

📌 0. 阶段 0：冻结旧业务认知

✅ 已完成：梳理旧表字段和实体关系。
✅ 已完成：梳理旧小程序接口和页面链路。
✅ 已完成：梳理旧微信支付流程。
✅ 已完成：固化新订单、支付、退款、渠道、设备枚举。
✅ 已完成：确认 ZPAY 公开文档和小程序跳转方式。
⚠️ 阻塞：使用真实 ZPAY 商户账号验证后台配置、退款权限和回调域名。

📌 1. 阶段 1：新后端骨架

✅ 已完成：新建 src 目录。
✅ 已完成：新建 WeWaiter.Api。
✅ 已完成：新建 WeWaiter.Application。
✅ 已完成：新建 WeWaiter.Domain。
✅ 已完成：新建 WeWaiter.Infrastructure。
✅ 已完成：新建 WeWaiter.Worker。
✅ 已完成：接入 ASP.NET Core 10.0。
✅ 已完成：接入 EF Core + PostgreSQL。
✅ 已完成：建立租户模型。
✅ 已完成：建立门店模型。
✅ 已完成：建立桌台模型。
✅ 已完成：建立菜品分类模型。
✅ 已完成：建立菜品模型。
✅ 已完成：建立顾客模型。
✅ 已完成：建立订单模型。
✅ 已完成：建立订单项模型。
✅ 已完成：建立 migrations。
✅ 已完成：建立 OpenAPI。
✅ 已完成：建立 JWT 登录基础设施。
✅ 已完成：写入种子数据。
✅ 已完成：复刻现有小程序点餐链路。
✅ 已完成：将 mpvue 小程序迁入 src/WeWaiter.MiniProgram。
✅ 已完成：移除旧 WeWaiter 后端源码和旧 Manager WinForms 管理端源码。

📌 2. 阶段 2：支付闭环

✅ 已完成：定义 IPaymentProvider。
✅ 已完成：实现 FakePaymentProvider。
✅ 已完成：建立支付单表。
✅ 已完成：建立支付事件表。
✅ 已完成：建立退款单表。
✅ 已完成：实现支付回调幂等处理。
🚧 进行中：实现微信小程序原生支付 provider，占位和配置边界已完成，真实 JSAPI 下单与验签待商户参数接入。
🚧 进行中：实现 ZPAY provider，下单 URL、签名和回调验签骨架已完成，真实账号后台配置待确认。
✅ 已完成：增加超时关单 worker。
✅ 已完成：增加支付查询补偿 worker。
⚠️ 阻塞：真实微信支付和 ZPAY 联调需商户号、密钥、证书/回调域名和后台权限确认。
✅ 已完成：新增顾客端业务闭环集成测试，覆盖扫码菜单、微信开发登录、下单、Fake 支付回调、支付事件、订单状态、账务流水和后厨打印任务落库。

📌 3. 阶段 3：管理端 MVP

✅ 已完成：新建 Blazor + Element-Blazor 管理端。
✅ 已完成：评估 Element-Blazor 是否需要源码子模块化；当前 NuGet 包可作为基线，暂不引入子模块。
⏸️ 暂缓：必要时引入 external/Element-Blazor git 子模块并保留 MIT 许可证声明。
✅ 已完成：登录页。
✅ 已完成：工作台。
✅ 已完成：门店管理。
✅ 已完成：桌台管理。
✅ 已完成：分类管理。
✅ 已完成：菜品管理。
✅ 已完成：订单中心。
✅ 已完成：支付设置。
✅ 已完成：打印设置，阶段 5 已补设备与打印页面。
🚧 进行中：图片上传，当前支持图片 URL 录入，二进制上传待对象存储接入。
🚧 进行中：二维码生成和下载，当前支持二维码 payload 生成和复制，图片下载待二维码组件接入。

📌 4. 阶段 4：结算与报表

✅ 已完成：支付流水查询。
✅ 已完成：退款流水查询。
✅ 已完成：日结和周期结算。
✅ 已完成：结算单确认。
✅ 已完成：CSV 导出。
✅ 已完成：财务权限，当前允许 owner、manager、finance 访问。
✅ 已完成：结算生成、结算确认和账务导出操作审计。
🚧 进行中：真实退款状态机和退款回调入账，当前按已成功退款单生成负向流水。
⏳ 待开始：Excel 原生格式导出。

📌 5. 阶段 5：设备与出品

✅ 已完成：建立 printers、print_jobs、devices 表和迁移。
✅ 已完成：支付成功或管理端接单后生成后厨打印任务。
✅ 已完成：管理端设备与打印页面，支持打印机、设备和打印任务查看/重打。
✅ 已完成：设备密钥认证、心跳、打印任务拉取和回写 API。
✅ 已完成：厨房屏 KDS 待出品订单接口和订单项出品状态流转。
🚧 进行中：打印模板当前为后厨小票文本模板，模板设计器和多模板配置待后续扩展。
🚧 进行中：本地打印 Agent 已有服务端 API，独立进程和真实打印协议待实现。
🚧 进行中：取餐屏和 POS 已预留设备类型与密钥接入，专用接口待细化。
⏳ 待开始：平板点餐 PWA。

📌 6. 总体进度

阶段	状态	目标
0	✅ 已完成	冻结旧业务认知
1	✅ 已完成	新后端骨架
2	🚧 进行中	支付闭环
3	🚧 进行中	管理端 MVP
4	✅ 已完成	结算与报表
5	🚧 进行中	设备与出品

📌 7. 下一步优先级

🔜 优先：把微信小程序接口切到新 src/WeWaiter.Api 顾客端 API，先跑通开发登录、扫码菜单、创建订单和 Fake 支付。
🔜 优先：接入真实微信支付商户参数后完成 JSAPI 下单、回调验签、金额校验和服务端状态落库验证。
🔜 优先：接入真实 ZPAY 商户参数后完成下单、GET 回调验签、重复通知幂等和退款权限验证。
🔜 优先：补管理端订单操作到端到端测试，覆盖接单、制作、出餐、完成、退款发起和打印重打。
🔜 优先：补本地打印 Agent 独立进程，先实现从设备 API 拉取任务、回写打印结果和失败重试。