概要
独立推进共享擦窗宝租赁系统的多端闭环,覆盖终端用户小程序、管理端、渠道端与 Spring Boot 后端,围绕支付、免押、设备、归还、结算和审计收敛测试期上线链路。
业务价值
把共享租赁业务从小程序下单、支付担保、柜机开锁、归还审核到渠道结算串成可上线闭环,降低线下设备、资金和运营协同的交付风险。
工程深度
覆盖模块化单体、支付/免押网关、设备适配层、回调验签、幂等与重放防护、渠道结算、审计日志、Flyway 迁移和多端前端工程化。
证据来源
本地仓库 README / AGENTS / doc/技术方案说明 / server / miniapp / tests / deploy
仓库 · 置信度 高 · 验证时间 2026-05-17
- 证据级别:严格复核(核心区仅展示可复核指标)
- 来源类型:仓库/代码记录
- 来源链接:未提供公开链接,需结合履历或交付记录复核
- 验证时间:2026-05-17(距今 0 天,时效性高)
判定原因:判定为高置信度:按严格口径整理,可回溯到仓库或代码记录,验证时间距今 0 天。
背景
目标是面向共享擦窗宝租赁场景交付可测试上线的业务系统,同时承接用户端、后台运营、渠道合作、支付担保和柜机厂商联调。
挑战
支付、免押、设备开锁、归还审核和渠道结算都存在外部回调、人工补偿和状态乱序风险;如果仅靠前端流程推进,容易出现重复扣款、错发开锁或状态倒退。
行动与成果
解决方案
- 组织多端闭环:用
server / admin / channel / miniapp / shared 单仓组织后端、管理端、渠道端和 uni-app 小程序,统一接口、状态文案和交付文档。 - 收敛状态真相:将订单、支付、免押、设备指令、归还审核和资金补偿收敛到服务端状态机,并保留状态历史、审计日志和人工处理入口。
- 隔离外部集成:通过
DeviceGateway、DepositFreeGateway、支付网关和回调验签服务隔离微信支付、微信支付分、柜机厂商 WebApi 与业务主流程。 - 固化交付路径:补齐 Flyway 版本策略、Maven 测试、前端构建、小程序验证清单和宿主机 release 上传/切换脚本,控制上线与回滚风险。
成果
形成共享租赁业务的测试期最小闭环,覆盖扫码租用、在线预约、支付/免押、开门取机、归还审核、渠道结算、后台运维和宿主机发布链路。
关键指标
按单仓多端组织 `server / admin / channel / miniapp / shared / deploy`,让用户租借、后台运营、渠道结算和宿主机发布处在同一套可验证工程链路里。 围绕订单、支付、免押、设备开锁、归还审核和资金补偿建立服务端状态真相,结合 Redis / JDBC 幂等、分布式锁、状态历史与审计日志降低重复回调和乱序推进风险。 抽象 `DeviceGateway` 与 `DepositFreeGateway`,对接微信支付 v3、微信支付分和柜机厂商 WebApi;外部参数未就绪时返回真实阻塞态,而不是用模拟成功绕过风险。 沉淀 Maven 测试、Vite 构建、小程序真机验证清单、Flyway 版本策略和宿主机 release 切换脚本,保证多端交付可回归、可回滚、可审计。 技术栈
Java 21Spring Boot 3.5MySQLRedisFlywayReact 19TypeScriptViteuni-appWeChat PayWeChat Pay ScoreDevice Gateway