侧栏入口：提交收据（/me/submit）

这页就是“录一张新单”。系统会要求你先预览再提交，目的很简单：把最终金额先算清楚给你确认，减少返工。

谁能用

• 仅 admin、cashier。
• playmate 看不到这个入口，也无法访问该页面。

怎么进入

1. 左侧栏点击 提交收据
2. 或直接访问 /me/submit

页面怎么走（两步）

• 填写页：把客户、陪玩、日期、金额等信息填完整
• 预览页：核对信息和最终金额，确认后再提交

表单怎么填（字段解释 + 注意事项）

字段	如何填写	必填	备注
客户	点击客户搜索框，输入关键字并在下拉中选择	是	只能单选
陪玩	点击陪玩搜索框，勾选一个或多个陪玩	是	不能重复选择
服务日期	选择日期	是	日期控件
类别	普通 / 押金 / 礼物	是	会影响后续字段
押金到期日	当类别=押金时选择日期	条件必填	仅押金类型显示
金额	使用金额输入框输入“元”	是	如 100 或 100.50
折扣类型	无 / 百分比 / 金额	是	礼物类会锁定为“无”
折扣值	百分比或金额	条件必填	根据折扣类型显示
结算方式	现金 / 余额	是	若余额不足会报错
备注	文本输入	否	空值可不填

一次完整录单怎么做

填写并预览

1. 先选 客户
2. 再选 陪玩（至少 1 位）
3. 填 服务日期、类别
4. 填 金额
5. 根据业务填折扣
6. 选择 结算方式
7. 如类别是押金，填 押金到期日
8. 需要时填 备注
9. 点击 预览

确认并提交

1. 在预览页重点看两件事：信息是否选对、最终金额是否符合预期
2. 发现不对就点 返回编辑 修改后再预览
3. 确认无误后点 确认提交
4. 成功会跳转到收据图片页：/me/history/:receiptId

容易踩坑的规则

• 客户必须已选择。
• 陪玩必须至少 1 位，且不能重复。
• 类别为 礼物 时，折扣强制为“无”。
• 类别为 押金 时，必须填写押金到期日。
• 金额和折扣金额是“元”输入，系统会转换并校验格式。
• 页面有防连点冷却，避免重复预览/提交导致状态混乱。

常见报错怎么处理

• balance.insufficient（余额不足）：通常改用现金结算，或先去客户详情充值再回来提交。
• playmate.not_active（陪玩不可用）：换一个在职/可用的陪玩再试。
• validation.invalid_argument（字段不合法）：按字段下方提示修正即可。
• 报错一般会同时出现在字段附近和右下角 Toast，两边都可以参考。