ByteBites 🍔🎓

校园点餐 App「ByteBites」的核心架构与 Python 实现。 设计目标：80% 借鉴 Uber Eats 的成熟设计 + 20% 校园特色（校内取餐点、学生餐卡、上课时段配送、未来的 AI 电话语音点单）。

设计稿

完整 UML（文字描述 + Mermaid 类图）见 bytebites_spec.md。

项目结构

bytebites/
├── enums.py      固定选项清单（分类/订单状态/支付状态/履约方式/语言）
├── payment.py    支付家族：PaymentMethod 抽象 + 餐卡/银行卡/PayPal/Apple Pay
├── menu.py       菜单家族：Option → OptionGroup → MenuItem → Menu
├── cart.py       购物车：CartItem + Cart（一单一店）
├── users.py      用户家族：User → Customer/Merchant/Courier/Admin
├── order.py      订单：OrderLine（金额快照）+ Order（状态流转/退款）
└── channels.py   下单渠道：OrderChannel 抽象 + App（已实现）/ Voice（占位）
demo.py           端到端演练

关键设计

• 下单渠道解耦：核心类不关心订单来源，App / 语音走同一条创建路径。
• 支付可插拔：新增支付方式只需加一个 PaymentMethod 子类。
• 先付款后接单：所有渠道（含语音）必须先完成在线支付，商家才能接单。
• 商家取消即退款：取消已付款订单会把支付状态标记为已退款。

运行演示

py demo.py

仅依赖 Python 标准库，无需安装第三方包。