一、公共支撑基础模块全局依赖所有业务模块共用1.1 接口鉴权与限流子模块统一接口身份校验拦截非法请求接口调用频次控制防刷、防恶意调用异常请求拦截日志输出对应工单验收标准安全 - 接口鉴权与频控生效1.2 多级缓存子模块用户定位结果缓存切换城市主动刷新全量城市列表全局缓存提升检索速度寄存点热点区域数据缓存降低 DB 压力寄存指南静态内容缓存缓存失效、更新策略统一封装1.3 全链路日志 用户行为埋点子模块接口请求 / 响应日志记录耗时、入参、出参、异常用户操作埋点定位、切换城市、搜索寄存点、查看指南日志持久化用于业务数据分析、迭代优化工单要求全链路记录埋点日志1.4 数据存储与索引子模块数据表设计城市信息表、寄存点表、寄存指南内容表索引设计城市名称 / 拼音索引、寄存点地理位置空间索引、分页索引提供建表、索引初始化脚本数据 CRUD 通用封装工具1.5 监控告警子模块接口性能指标采集响应耗时、并发量、错误率性能阈值告警定位接口 200ms、寄存点查询 P95300ms 触发告警千级并发降级监控、异常大盘输出输出文档监控指标与日志规范文档1.6 通用工具能力子模块地理计算工具两点直线距离计算分页统一封装工具多语言内容解析工具运营灰度下发工具分批开放城市接口版本兼容处理工具统一空状态、异常信息返回封装二、模块 1用户定位功能模块首页基础前置模块2.1 定位获取子功能模块多渠道定位优先级控制GPS 经纬度定位 IP 定位定位解析经纬度 / IP 转换为省份、城市名称、城市编码前端触发入口首页「我的附近」自动定位、手动刷新定位按钮对外接口获取当前城市定位接口2.2 定位缓存管理子功能模块缓存存储本次定位城市信息减少重复调用第三方定位服务缓存刷新触发规则手动切换城市、手动点击重新定位标准化输出城市结构体城市名、城市 code、省份2.3 定位异常降级子功能模块捕获异常场景定位权限关闭、GPS 超时、IP 服务调用失败、网络异常降级兜底策略返回系统默认城市异常日志埋点记录失败原因用于优化模块依赖仅依赖公共支撑模块输出数据供给城市选择、寄存点搜索模块三、模块 2城市选择管理功能模块3.1 全量服务城市列表子功能模块查询系统所有已开通寄存柜服务的城市城市分组展示、运营灰度下发分批次上线新城市用户可见不同城市池前端承载页面独立选择城市弹窗 / 城市选择页接口全量城市列表查询接口3.2 城市检索子功能模块检索支持中文模糊检索、拼音首字母检索检索结果过滤仅展示当前用户灰度范围内城市接口城市模糊搜索接口3.3 用户城市切换子功能模块用户选中城市后存储用户选择记录返回目标城市 ID、城市基础元信息给前端切换成功后自动联动触发寄存点重新查询行为埋点记录用户切换城市操作3.4 城市页面文案配置子功能模块未开通服务城市兜底提示文案年度城市拓展预告文案2025 年内覆盖百城文案后台可配置实时生效无需发版模块依赖公共支撑模块 用户定位模块输出城市 ID 给寄存点搜索模块四、模块 3寄存点地图搜索功能模块核心业务模块4.1 寄存点条件检索子功能模块双维度查询条件维度 1用户当前定位坐标附近查询维度 2用户输入关键词车站 / 景点 / 商圈搜索基于城市 ID 过滤仅查询当前选中城市寄存点基于空间索引快速匹配点位接口寄存点综合搜索接口4.2 距离排序 分页子功能模块计算用户坐标与寄存点坐标距离检索结果按距离由近到远排序分页封装批量返回寄存点基础信息名称、地址、距离、空闲柜数量高并发性能优化保障 P95 响应≤300ms4.3 地图点位渲染子功能模块批量输出当前城市所有寄存点地图坐标标记地图选中寄存点返回该点位完整详情卡片前端承载页面首页查询寄存点跳转地图页面4.4 空状态兜底子功能模块5km 范围内无寄存点时返回空页面提示文案埋点记录无寄存点场景支撑业务拓展分析模块依赖公共支撑模块 用户定位模块 城市选择模块五、模块 4寄存指南内容功能模块运营内容模块5.1 指南内容查询子功能模块统一接口返回全套指引内容寄存规则、操作流程、注意事项、常见问题前端承载首页寄存指南入口、长图文详情页接口寄存指南内容获取接口5.2 后台动态配置子功能模块运营后台可视化编辑图文内容内容修改实时生效无需服务端发版内容分层存储步骤图、文字说明、提示文案分离配置5.3 多语言 版本兼容子功能模块多套语言内容存储根据用户区域自动匹配对应语言接口携带版本号兼容新旧前端页面平滑迭代不兼容问题