企业官网建设流程全解析

项目名称

智能快寄柜系统

工单编号

全栈开发-智能快寄柜系统-物品寄存任务工单

创建时间

2026-01

创建人

邹世军

开发方向

全栈开发 GO 方向

原型地址

https://modao.cc/proto/3fxWzFGJsp37iiCk5fS2h/sharing?view_mode=read_only

原工时预估

3 人日

任务优先级

中

第 1 日

需求梳理、数据库与接口设计

当日工作

• 梳理物品寄存完整业务流程：选柜、计时、计费、优惠券、押金、支付、落单、异常换柜

• 设计数据库表结构：柜子表、订单表、支付记录表、优惠券表，含字段、索引与事务策略

• 绘制 ER 图、状态转换图，明确各状态流转（空闲→锁定→占用→释放）

• 定义接口报文：《柜子信息查询》《收费计算》《支付完成》《支付异常处理》接口设计

• 输出《设计说明书》初稿与数据库建表及索引脚本

当日产出

• ER 图

• 状态转换图

• 接口报文设计说明书

• 数据库建表及索引脚本

• 《设计说明书》初稿

第 2 日

柜子信息查询与收费计算接口开发

当日工作

• 实现“柜子信息查询”接口：返回当前网点所有柜子状态、尺寸、编号、空闲数量等

• 实现“收费规则”配置读取：支持按时间（小时/半天/天）、柜子尺寸、优惠策略等多维度计费

• 实现“收费计算”接口：依据寄存时长、格口类型、优惠券、押金计算最终应付金额

• 处理边界情况：优惠券金额大于应付金额、押金不足抵扣等

• 完善收费规则弹窗所需数据结构与接口文档

当日产出

• 柜子信息查询接口

• 收费计算接口

• 对应接口文档

• 柜子表与优惠券表脚本

• 收费规则配置项

第 3 日

支付流程与订单落单开发

当日工作

• 实现支付请求接口：对接支付网关，生成支付记录，保证幂等性

• 实现支付完成回调：更新柜子状态为“已占用”，写入订单表、支付记录表、柜子使用表

• 返回寄存凭证信息：订单号、柜门号、开柜密码/二维码

• 触发消息通知，提醒用户操作成功

• 加入事务保护，避免高并发下重复扣费或重复落单

当日产出

• 支付请求与回调接口

• 订单落单逻辑

• 支付记录表脚本

• 订单表脚本

• 消息通知接入

第 4 日

支付异常处理与换柜逻辑开发

当日工作

• 实现支付异常处理：支付失败、超时、柜门无法开启等场景的资源释放与状态回滚

• 实现换柜重试逻辑：分配新的可用柜门并生成新的支付订单

• 实现“下单开门后柜门异常更换柜门”流程

• 记录异常支付流水、异常原因、换柜信息，便于追踪与售后

• 完善接口鉴权与敏感信息脱敏存储

当日产出

• 支付异常处理接口

• 换柜重试逻辑

• 异常流水记录

• 换柜接口文档

• 安全鉴权与脱敏处理

第 5 日

测试、文档与上线准备

当日工作

• 编写单元测试，确保核心接口覆盖率 ≥70%

• 完成接口联调与压力测试：验证柜子信息查询 P95 ≤200ms、收费计算 P95 ≤250ms

• 输出接口测试用例与联调报告，解读压力测试报告

• 编写日志与审计规范文档、上线说明与回滚预案

• 在代码注释中标注工单编号，汇总全部接口文档与脚本

当日产出

• 单元测试代码（覆盖率 ≥70%）

• 压力测试报告

• 接口联调用例与测试报告

• 日志与审计规范文档

• 上线说明与回滚预案

维度

验收项

功能

可用柜子信息准确返回，包含状态、尺寸、编号等；收费规则正确计算，支持优惠券与押金逻辑；支付完成后落单成功，柜子状态更新为占用，凭证返回正确；支付异常能正确释放柜子资源并支持换柜重试。

性能

柜子信息查询接口 P95 响应 ≤200ms；收费计算接口 P95 响应 ≤250ms；系统支持高并发下柜子锁定与支付流程一致性。

安全

用户支付过程需鉴权，支付流水与订单双重校验；押金退款规则清晰，敏感信息脱敏存储；异常流水与换柜信息可审计、可追踪。

代码质量

单元测试覆盖率 ≥70%；错误码与日志格式统一；文档清晰，接口命名规范，变更可追溯。