智能快寄柜-05-+订单查看与取出 工单模块

一、全局公共支撑模块（所有订单流程依赖底层基础）

1.1 接口鉴权与操作管控子模块

1. 订单查询、开门、补缴、临时开柜等变更类接口统一鉴权
2. 操作权限校验：区分订单状态控制可执行动作（已完成订单不可开门）
3. 敏感信息脱敏：手机号、支付金额、押金、取件凭证脱敏展示
4. 防并发冲突：操作请求幂等、短锁防重复提交

1.2 订单状态机 & 操作审计子模块

1. 统一订单全生命周期状态定义：待支付 / 进行中 / 已完成 / 已退费 / 超时欠费
2. 状态流转强制校验，非法操作拦截告警
3. 全链路操作审计日志：开门、临时开柜、补缴、取件、换柜、下载凭证全部留痕，可追溯售后

1.3 多级缓存 & 冷热数据分层子模块

1. 进行中订单热点缓存，提升列表 / 详情访问速度；采用精准失效策略
2. 历史订单冷热分离：近期订单在线库，长期归档至冷数据，不影响查询性能
3. 网点、计费规则、柜格信息公共缓存复用

1.4 数据库 & 索引归档子模块

1. 订单主表、订单操作轨迹表、临时开柜授权表、补缴流水表设计
2. 复合索引：用户 ID、订单状态、创建时间、网点、城市索引
3. 历史订单归档、冷数据迁移脚本，分页游标查询方案

1.5 统一计费 & 费用计算工具子模块

1. 复用寄存计费规则，计算超时逾期费用、补缴金额、剩余押金
2. 费用明细统一封装，保证列表 / 详情金额字段一致
3. 幂等补缴逻辑，防止重复扣费，失败自动回滚重试

1.6 监控告警 & 异常兜底子模块

1. 订单列表 / 详情接口响应耗时监控、并发大盘采集
2. 超时未取、大额欠费、频繁临时开柜异常行为告警
3. 系统异常统一弹窗、客服联系方式兜底文案

二、模块 1：订单列表查询功能模块（首页订单入口基础模块）

2.1 当前进行中订单聚合子功能模块

1. 按用户维度查询全部「进行中」寄存订单，聚合统计：订单总数、即将超时数量、待补缴数量
2. 列表支持筛选：网点、城市、创建时间区间、订单状态；支持创建时间 / 预计结束时间排序
3. 前端页面：我的订单 - 当前订单 Tab
4. 接口：进行中订单列表查询接口，支持游标分页、高频索引优化
5. 业务提示：即将超时、欠费未补、柜门未关风险提示

2.2 历史归档订单检索子功能模块

1. 查询已完成、已退费、结束归档订单，支持时间范围、网点、关键词检索
2. 冷热数据自动路由，长期归档订单不阻塞在线查询
3. 前端页面：我的订单 - 历史订单 Tab
4. 展示字段：寄存网点、时长、总费用、退费标记

2.3 订单导出对账子功能模块

1. 支持用户导出历史订单凭证、对账明细、开票入口
2. 导出异步生成，限流控制，避免在线查询资源抢占
3. 记录用户下载 / 导出行为审计日志，满足合规要求

依赖：公共支撑模块；输出订单 ID 供给订单详情、取件、补缴、临时开柜模块

三、模块 2：订单详情聚合展示功能模块

3.1 订单基础信息聚合子功能模块

1. 统一返回全量订单数据：寄存网点、柜格位置、尺寸、寄存起止时间、计划时长
2. 费用完整明细：实付租金、优惠券抵扣、押金、剩余押金、超时补缴金额
3. 开门记录、操作轨迹、换柜 / 人工介入异常记录高亮标注
4. 前端页面：订单详情页，区分「正常进行中」「超时需补缴」「已完成历史单」三种视图

3.2 订单可执行动作控制子功能模块

1. 根据订单当前状态动态渲染操作按钮：立即取出、补缴并取出、临时开门、查看凭证
2. 权限拦截：已完成订单隐藏开门 / 补缴按钮；无需补缴订单隐藏补缴入口
3. 弹窗分支逻辑：取出时弹出「结束订单 / 临时开门」选择框（仅无欠费订单支持临时开门）

3.3 风险提示与异常指引子功能模块

1. 即将超时、欠费未补、网点停业、柜设备故障提示文案
2. 异常订单提供客服咨询入口，标注异常原因与处理指引，降低客服咨询量

依赖：公共支撑模块 + 订单列表模块（传入订单 ID）

四、模块 3：物品取出 & 临时开柜授权功能模块（核心取件业务）

4.1 正常结束取件子功能模块

1. 校验订单无欠费，下发一次性开门凭证（密码 / 二维码）
2. 开门成功后更新订单状态为「已完成」，锁定柜格释放，押金流程启动
3. 记录开门操作审计轨迹，推送取件完成通知

4.2 临时开柜授权子功能模块

1. 业务场景：设备 / 网络故障需临时开门，开门后可继续寄存不结束订单
2. 授权前置校验：订单状态、支付状态、网点设备可用性
3. 授权管控：限时、限制使用次数，与订单强绑定；过期自动作废释放资源
4. 授权使用后记录回写订单轨迹，触发风控校验，防止滥用

4.3 取件分支选择控制子功能模块

1. 弹窗区分两种取件类型：①结束订单全部取出 ②临时开门继续寄存
2. 规则限制：存在欠费、需补缴的订单，隐藏临时开门选项，仅允许补缴后结束取件

依赖：公共支撑模块 + 订单详情模块

五、模块 4：超时补缴费用处理功能模块

5.1 超时费用核算子功能模块

1. 读取寄存计费规则，自动计算逾期产生的补缴金额
2. 明细展示：基础租金、超时附加费、抵扣、待补缴总额，计算口径统一可追溯

5.2 补缴支付流程子功能模块

1. 对接支付网关生成补缴单据，关联原寄存订单
2. 幂等防重复扣费，支付失败友好回滚，支持用户重新发起补缴

5.3 补缴成功后置逻辑子功能模块

1. 支付完成自动下发开门凭证，支持直接取件结束订单
2. 可选配置：补缴后自动续期至标准寄存时长
3. 更新订单状态、写入补缴流水、审计轨迹，保证账实一致可对账

依赖：公共支撑模块 + 订单详情模块

六、模块 5：历史订单归档 & 售后凭证模块

6.1 归档订单详情查询子功能模块

1. 读取冷热归档数据，展示完整历史记录：寄存全流程、多次开门记录、退费金额、换柜记录
2. 异常历史高亮标注，便于售后核对、责任追溯

6.2 凭证 & 开票售后子功能模块

1. 提供寄存电子凭证下载、发票申请入口
2. 留存下载记录，满足财务对账、售后举证需求

依赖：公共支撑模块 + 订单列表模块

七、模块 6：系统异常兜底客服辅助模块

7.1 订单异常检测子功能模块

1. 识别柜设备离线、网络故障、授权失效、支付异常等订单异常状态
2. 异常订单在列表、详情页统一标记

7.2 异常客服弹窗子功能模块

1. 异常场景弹出客服联系弹窗，展示网点管理员电话、在线客服入口
2. 统一异常文案，区分不同故障类型提示处理方案