项目六 · 搭一个可验收的链上收银台
学完能做到:结合界面、模拟回调、订单状态与故障验收,交付完整支付流程。
先看一个场景
课程项目要在手机和桌面完成一次模拟付款,并允许第三方按测试数据重放。服务端使用固定样本模拟链上事件和异常,页面只读取订单结果并解释下一步。
分成四个交付物
| 交付物 | 需要看到什么 |
|---|---|
| 页面 | 应付资产、网络、付款地址、订单状态与过期时间 |
| 订单接口 | 状态、历史事件、确认规则和业务操作 ID |
| 模拟监听 | 事件输入、验收结果、去重日志与手工撤回 |
| 验收脚本 | 25 USDC 正常、两笔 12.5、重放、错资产与重组样本 |
建议先通过交互实验室理解对账状态,再按收银台课程设计网络接口。应用与数据使用模拟账户,提交时附上 Markdown 使用说明。
给第一次动手的人一份开工顺序
一、先在纸上写对账单
创建模拟订单 P-120,应收 25 USDC。记录教学网络、代币合约标识、收款地址和小数精度。先让页面可以清楚展示应收,然后准备五行记录:正确付款、分两笔付款、重复事件、错资产及事件撤回。
二、把初始界面接到订单结果
界面按订单查询返回待付款、部分付款、已确认或待核对。模拟监听每次接收事件后,服务端核验并更新订单,前端继续查询和显示。第一版可以用本地函数和文件数据完成。做成接口时,再验收刷新页面后仍能查同一笔结果。
三、在移动端完整重放一遍
| 重放到哪一步 | 应看到 |
|---|---|
| 第一笔 12.5 已确认 | 部分付款,剩余 12.5 |
| 同一事件通知重来 | 累计不变 |
| 第二笔 12.5 已确认 | 足额,按规则生成一次履约动作 |
| 第二笔被撤回 | 累计退回 12.5,记录冲销原因 |
| 同名错资产到达 | 提示核对,保留异常记录 |
最终交付应包含页面截图、原始事件表、可复现操作和预期结果。把测试数据交给同伴,要求从空状态重放并核对每一步。如果哪一步只能靠开发者口头解释,就把说明放进交付材料。
关键验收
- 已支付订单再次打开会显示已确认。重复回调保持一次发货。
- 先付 12.5 进入部分付款,第二次足额后进入确认。错资产保留异常记录。
- 事件撤回后能冲销,保留历史原因。刷新及换页可恢复同一个订单。
- 手机可核对网络和资产,键盘能访问所有表单。错误文案能告诉用户做什么。
自测
模拟服务重启,前端本地缓存还是「已支付」时,可以直接展示可发货吗?
查看参考答案
要向订单服务重新确认状态。缓存可以标为上次观察,不能替代后端已经对账的状态及履约记录。