接手快速索引

本页用于新人第一天接手时快速判断“系统是什么、入口在哪里、出问题先看哪里”。

第一层：先分清系统

你听到的问题	优先看哪里	判断依据
员工端、小程序、服务记录、接单、钱包、保险、合同、员工能力	金刚系统	一线员工或门店在移动端处理业务。
后台菜单、运营配置、财务对账、保险退款文档、门店积分、人员审核	云平台	运营、财务、产品在管理后台处理业务。
发布云函数、接口 500、数据库连接、Redis、定时任务	对应后端	storeapi 或 yunapi 的运行配置、日志和控制器。
页面空白、按钮没权限、菜单不显示、构建失败	对应前端	storeui 或 yunui 的页面、API 封装、菜单权限和构建配置。
表结构、状态字段、业务日志、资金流水	MySQL 数据地图	先按业务域定位主表、日志表、流水表和配置表。

第二层：按角色定位

角色	主要系统	常见入口
员工	金刚小程序	服务首页、服务记录、我的、钱包、能力、保险、签约。
门店/队长	金刚小程序、云平台	门店资料、人员管理、订单处理、积分与钱包。
运营	云平台	订单管理、门店管理、服务人员、配置、财务、保险、合同、培训、线索。
财务	云平台	资金流水、充值、提现、平台收入、软件收入、渠道收入、品牌费、分账。
产品/开发	docs-kb、源码、Swagger	规则、模块边界、接口、发布说明和排障路径。

第三层：常见排查顺序

问题类型	排查顺序
员工端接口异常	小程序页面 API 封装 -> storeapi controller -> service -> 数据库/Redis -> 云函数日志。
云平台页面异常	yunui 页面 -> yunui/src/api -> yunapi controller -> service -> 权限菜单/字典/配置。
定时任务没执行	宝塔脚本或后台任务配置 -> 脚本入参和 token -> 后端内部任务接口 -> 日志 -> 数据状态。
订单状态不一致	订单主记录 -> 支付/分账记录 -> 履约记录 -> 后台人工操作记录 -> 通知或回调记录。
财务金额异常	流水来源 -> 分账记录 -> 充值/提现/品牌费/渠道收入口径 -> 导出或统计逻辑。

技术资料入口

要查什么	入口
系统怎么分层	技术交接总览
MySQL 表怎么归类	MySQL 数据地图
金刚模块和服务	金刚技术模块目录
金刚员工端细节	员工端完整模块与逻辑
金刚门店端细节	门店端完整模块与逻辑
金刚状态和数据	金刚数据与状态模型
金刚任务和排障	金刚技术运维与排障
云平台模块和服务	云平台技术模块目录
云平台配置和数据	云平台数据与配置模型
云平台任务和排障	云平台技术运维与排障

不要先做的事

• 不要在没有确认数据口径前手动改生产数据。
• 不要把金刚系统的员工端履约问题当成云平台菜单问题处理。
• 不要把员工入驻师傅队长池和其他业务队伍池混用。
• 不要继续补“小羽佳订单协同”细节文档，该链路不纳入本次交接。