一、工单基本信息项目名称智能快寄柜系统工单编号全栈开发-智能快寄柜系统-物品寄存任务工单创建时间2026-01创建人邹世军开发方向全栈开发 GO 方向原型地址https://modao.cc/proto/3fxWzFGJsp37iiCk5fS2h/sharing?view_moderead_only原工时预估3 人日任务优先级中二、任务概述本工单围绕物品寄存业务场景重点实现柜子选择、时间配置、优惠券与押金规则、收费规则定义与计算、支付完成流程、支付异常时的容错与换柜逻辑。该功能是寄存业务的核心链路之一直接影响用户下单体验和支付闭环稳定性。核心功能点• 柜子信息查询返回网点柜门编号、尺寸、状态、空闲数量等• 收费规则与计算按时间、柜子尺寸、优惠策略等维度计算最终应付金额• 支付流程对接支付网关生成支付记录保证幂等• 支付完成落单更新柜子状态为占用写入订单与支付流水返回凭证• 支付异常与换柜支付失败/超时/柜门异常时释放资源、换柜重试、记录异常流水三、五日工作安排第 1 日需求梳理、数据库与接口设计当日工作• 梳理物品寄存完整业务流程选柜、计时、计费、优惠券、押金、支付、落单、异常换柜• 设计数据库表结构柜子表、订单表、支付记录表、优惠券表含字段、索引与事务策略• 绘制 ER 图、状态转换图明确各状态流转空闲→锁定→占用→释放• 定义接口报文《柜子信息查询》《收费计算》《支付完成》《支付异常处理》接口设计• 输出《设计说明书》初稿与数据库建表及索引脚本当日产出• ER 图• 状态转换图• 接口报文设计说明书• 数据库建表及索引脚本• 《设计说明书》初稿第 2 日柜子信息查询与收费计算接口开发当日工作• 实现“柜子信息查询”接口返回当前网点所有柜子状态、尺寸、编号、空闲数量等• 实现“收费规则”配置读取支持按时间小时/半天/天、柜子尺寸、优惠策略等多维度计费• 实现“收费计算”接口依据寄存时长、格口类型、优惠券、押金计算最终应付金额• 处理边界情况优惠券金额大于应付金额、押金不足抵扣等• 完善收费规则弹窗所需数据结构与接口文档当日产出• 柜子信息查询接口• 收费计算接口• 对应接口文档• 柜子表与优惠券表脚本• 收费规则配置项第 3 日支付流程与订单落单开发当日工作• 实现支付请求接口对接支付网关生成支付记录保证幂等性• 实现支付完成回调更新柜子状态为“已占用”写入订单表、支付记录表、柜子使用表• 返回寄存凭证信息订单号、柜门号、开柜密码/二维码• 触发消息通知提醒用户操作成功• 加入事务保护避免高并发下重复扣费或重复落单当日产出• 支付请求与回调接口• 订单落单逻辑• 支付记录表脚本• 订单表脚本• 消息通知接入第 4 日支付异常处理与换柜逻辑开发当日工作• 实现支付异常处理支付失败、超时、柜门无法开启等场景的资源释放与状态回滚• 实现换柜重试逻辑分配新的可用柜门并生成新的支付订单• 实现“下单开门后柜门异常更换柜门”流程• 记录异常支付流水、异常原因、换柜信息便于追踪与售后• 完善接口鉴权与敏感信息脱敏存储当日产出• 支付异常处理接口• 换柜重试逻辑• 异常流水记录• 换柜接口文档• 安全鉴权与脱敏处理第 5 日测试、文档与上线准备当日工作• 编写单元测试确保核心接口覆盖率 ≥70%• 完成接口联调与压力测试验证柜子信息查询 P95 ≤200ms、收费计算 P95 ≤250ms• 输出接口测试用例与联调报告解读压力测试报告• 编写日志与审计规范文档、上线说明与回滚预案• 在代码注释中标注工单编号汇总全部接口文档与脚本当日产出• 单元测试代码覆盖率 ≥70%• 压力测试报告• 接口联调用例与测试报告• 日志与审计规范文档• 上线说明与回滚预案四、验收标准维度验收项功能可用柜子信息准确返回包含状态、尺寸、编号等收费规则正确计算支持优惠券与押金逻辑支付完成后落单成功柜子状态更新为占用凭证返回正确支付异常能正确释放柜子资源并支持换柜重试。性能柜子信息查询接口 P95 响应 ≤200ms收费计算接口 P95 响应 ≤250ms系统支持高并发下柜子锁定与支付流程一致性。安全用户支付过程需鉴权支付流水与订单双重校验押金退款规则清晰敏感信息脱敏存储异常流水与换柜信息可审计、可追踪。代码质量单元测试覆盖率 ≥70%错误码与日志格式统一文档清晰接口命名规范变更可追溯。五、备注• 代码注释中需写明工单编号全栈开发-智能快寄柜系统-物品寄存任务工单• 各接口开发完成后需及时更新接口文档确保前后端联调顺畅• 支付相关接口必须保证幂等性与事务一致性避免重复扣费或重复落单• 压力测试与日志审计文档需在上线前完成并通过评审