智能快寄柜系统-订单查看与取出任务工单 五日工作计划

项目名称

智能快寄柜系统

工单编号

全栈开发-智能快寄柜系统-订单查看与取出任务工单

创建时间

2026-01

开发方向

全栈开发 GO 方向

原型地址

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

原工时预估

5.5 人日

任务优先级

中

第 1 日

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

当日工作

• 梳理“查—看—取—补—归档”全链路业务流程，明确各阶段状态与可执行动作

• 设计订单域状态机与可执行动作清单（取消、取出、续期、临时开柜、超时补缴）

• 设计数据库表结构：订单表、历史/归档订单表、开柜授权表、支付流水表等

• 设计读写分离、热点缓存、分区/归档策略与审计字段规范

• 输出 ER 图、状态转换图、接口报文设计说明书与《设计说明书》初稿

当日产出

• ER 图

• 状态转换图

• 接口报文设计说明书

• 数据库建表与索引方案

• 《设计说明书》初稿

第 2 日

订单列表与详情接口开发

当日工作

• 实现“当前订单列表”接口：按创建时间、网点、城市、状态组合过滤，支持排序与游标分页

• 实现聚合统计字段：进行中订单数量、即将超时数量、待补缴数量

• 实现“历史订单列表”接口：按时间范围、网点、关键字检索，支持导出与异步生成

• 实现“订单详情”接口：返回全量信息、寄存地点与位置、费用明细、状态轨迹、操作审计

• 接入缓存优先与精准失效策略，确保金额/状态字段一致性

当日产出

• 当前订单列表接口

• 历史订单列表接口

• 订单详情接口

• 对应接口文档

• 列表/详情缓存策略

第 3 日

取出与临时开柜接口开发

当日工作

• 实现取出类型选择逻辑：结束订单全部取出、临时开门关门后继续寄存

• 实现“结束订单取出”接口：状态校验、柜门解锁、费用结算、订单完结

• 实现“临时开柜授权”接口：生成一次性开柜凭证，限时限次，与订单强绑定

• 完成授权使用回执、订单轨迹更新、风险检查与过期自动作废

• 实现鉴权与幂等控制，防止重复触发与并发冲突

当日产出

• 结束订单取出接口

• 临时开柜授权接口

• 开柜授权审计记录

• 对应接口文档

• 幂等与并发控制机制

第 4 日

超时补交与订单归档

当日工作

• 实现“超时费用计算”接口：对齐计费系统，返回明细项与可解释费用来源

• 实现“超时补缴”接口：支付成功后自动解锁取件或按配置续期

• 加入补缴幂等控制、失败回退与重新发起机制

• 实现已结束订单归档写入与冷数据读取策略

• 支持凭证下载、发票入口、售后申诉通道与异常历史标识

当日产出

• 超时费用计算接口

• 超时补缴接口

• 归档与分区策略实现

• 对账与凭证支持

• 对应接口文档

第 5 日

测试、监控与上线准备

当日工作

• 编写核心路径单元测试与集成测试，确保关键接口稳定

• 进行接口联调与压力测试，验证列表/详情接口 P95 响应与并发稳定性

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

• 统一错误码与日志格式，编写监控指标面板与报警规则文档

• 编写上线说明与回滚预案，并在代码注释中标注工单编号

当日产出

• 单元/集成测试代码

• 压力测试报告

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

• 日志与监控规范文档

• 上线说明与回滚预案

维度

验收项

功能

当前与历史订单列表按条件检索准确，分页与排序稳定；详情页返回寄存地点与寄存位置等信息完整，金额与状态一致；临时开柜授权可生成、可使用、可审计并严格受限时限次；超时补交费用计算正确，补缴成功触发解锁或续期逻辑；进行中订单聚合正确展示可执行动作并校验并发安全。

性能

列表与详情接口在高并发下保持稳定，关键接口 P95 响应达到目标；超时计算与补缴链路延迟可控，幂等与重试机制有效。

安全

所有变更类操作需鉴权与幂等控制，敏感信息脱敏；临时开柜授权具备时效控制与滥用防护，审计可追溯。

代码质量

核心路径具备充分单元与集成测试，日志与错误码规范统一；文档齐全，变更记录清晰，可按预案完成上线与回滚。