智能快寄柜-04-+物品寄存任务 工单模块

一、公共底层支撑模块全局共用所有寄存业务模块依赖1.1 接口鉴权与安全校验子模块寄存全流程接口统一身份鉴权支付流水、订单双重校验防篡改敏感信息脱敏存储押金、支付金额、用户隐私异常操作、换柜记录留审计日志可追溯对应验收标准安全 - 支付鉴权、敏感信息脱敏、流水可审计1.2 分布式柜子锁与事务控制子模块柜子资源分布式锁防止高并发下同一柜格被重复占用下单、支付、换柜全流程事务保障失败自动回滚柜格资源柜格状态一致性维护空闲 / 锁定 / 占用 / 故障1.3 多级缓存子模块网点柜格基础信息缓存提升柜格查询速度收费规则、优惠券配置缓存减少配置库查询压力订单、支付流水热点数据缓存1.4 全链路日志 行为埋点子模块柜格选择、时长设置、优惠券使用、支付、换柜、异常全流程日志记录异常流水、换柜信息单独归档日志用于售后排查性能耗时打点支撑接口响应监控1.5 数据库 索引子模块数据表柜子表、订单表、支付记录表、优惠券表索引网点索引、柜格状态索引、订单用户索引、支付单号唯一索引提供建表、索引初始化脚本订单、支付、柜格关联查询通用封装1.6 通用工具子模块费用计算工具按时长 / 柜型计费、优惠券抵扣、押金叠加计算分布式消息通知工具支付成功推送取件通知状态机工具寄存订单完整状态流转管理统一异常、空状态、错误码封装二、模块 1网点柜格信息查询功能模块寄存首页前置基础模块2.1 网点柜格列表查询子功能模块根据用户选中网点查询该网点全部柜格基础数据柜格编号、尺寸规格小 / 中 / 大、当前空闲状态支持地图导航跳转网点地址前端页面寄存页面顶部网点信息、柜格规格选择区域对外接口网点可用柜格查询接口性能指标接口 P95 响应≤200ms2.2 柜格收费规则展示子功能模块根据柜格规格拉取对应计费规则小时单价、单日封顶、超时计费、网点营业截止时间、押金标准弹窗可视化展示完整收费说明、超时赔付规则支持配置动态更新规则实时生效2.3 柜格状态管理子功能模块标记柜格空闲 / 占用 / 故障不可选状态前端置灰禁用记录柜格使用流水统计柜格占用记录为后续锁定、占用、释放柜格提供状态数据源依赖仅依赖公共支撑模块输出柜格数据供给费用计算、下单模块三、模块 2寄存费用计算功能模块核心计费模块3.1 基础时长计费子功能模块用户输入寄存时长小时 / 天匹配所选柜格单价计算基础租金自动处理边界当日营业截止、24 小时封顶、超时续计费逻辑输出租金明细计算结果可追溯3.2 优惠券核销抵扣子功能模块查询用户可用优惠券校验有效期、适用网点、适用柜型、剩余抵扣额度按规则自动抵扣租金处理优惠券金额大于应付金额边界场景核销优惠券记录抵扣流水防止重复使用3.3 押金计算子功能模块根据柜格规格配置返回对应押金金额标注押金退还条件取件完成后全额退还押金不参与优惠券抵扣单独明细展示3.4 费用明细汇总子功能模块整合租金、优惠券抵扣、押金输出最终应付总金额前端展示预估费用、分项明细租金 / 优惠 / 押金接口寄存费用预估接口性能指标 P95≤250ms依赖公共支撑模块 网点柜格模块费用结果供给下单支付模块四、模块 3寄存订单创建 柜格锁定功能模块4.1 柜格分布式锁定子功能模块用户确认寄存前通过分布式锁锁定选中柜格锁定窗口期防并发抢占锁定成功标记柜格为「已锁定」锁定超时自动释放资源高并发下保障柜格分配唯一性4.2 寄存订单生成子功能模块整合网点、柜格、寄存时长、费用、优惠券、押金信息生成寄存订单初始化订单状态待支付记录订单创建时间、用户信息写入订单数据表生成唯一订单号4.3 寄存须知弹窗校验子功能模块前端弹出寄存须知用户勾选同意后方可发起支付后台可配置须知文案实时更新无需发版埋点记录用户查看须知、确认操作行为依赖公共支撑模块 柜格信息模块 费用计算模块输出订单供给支付模块五、模块 4支付流程管理功能模块5.1 支付渠道对接子功能模块调用第三方支付网关传入订单、应付金额、押金信息创建支付单据生成支付凭证、支付流水号关联寄存订单5.2 支付结果回调处理子功能模块接收支付成功 / 失败回调双重校验订单与支付流水一致性支付成功更新订单状态为「已支付」、柜格状态改为「已占用」写入支付流水表生成开门凭证柜门编号、开箱密码 / 二维码返回前端5.3 支付成功消息通知子功能模块支付完成推送消息提醒用户开门取件消息携带订单、柜格、取件凭证信息5.4 支付正常成功页面渲染子功能模块前端展示开门页面、柜格编号、查看订单入口依赖公共支撑模块 寄存订单模块六、模块 5支付异常 柜格故障容错处理功能模块6.1 异常资源释放子功能模块支付超时、支付失败、开门故障场景自动释放已锁定柜格恢复为空闲状态回滚订单支付状态取消待支付单据6.2 更换柜格重试子功能模块用户选择「继续操作」时系统重新分配同网点空闲柜格生成全新寄存订单、新支付单据旧订单标记作废归档记录换柜日志原柜号、新柜号、异常原因、操作时间用于审计售后6.3 异常兜底提示子功能模块区分支付超时、柜门故障、网点停业等不同异常文案提示提供客服咨询入口引导依赖公共支撑模块 柜格锁定模块 支付流程模块七、模块 6优惠券配置管理辅助模块运营配置支撑7.1 优惠券基础配置子功能模块后台配置优惠券面额、有效期、适用城市 / 网点、适用柜型配置优惠券叠加规则、抵扣上限7.2 用户优惠券查询子功能模块查询当前用户名下有效优惠券列表过滤匹配当前寄存场景可用券标记过期、已核销优惠券前端置灰不可选7.3 优惠券核销记录子功能模块用户下单抵扣后记录核销流水统计使用额度、关联对应寄存订单