技术交接总览

本页用于给接手人建立系统级判断：先分清入口，再沿着业务链路查页面、接口、服务、表和任务。文档依据当前代码目录、FastAPI 路由注册、小程序分包、云平台菜单目录以及 MySQL jingangdata 表结构整理，不写计划删除的“小羽佳订单协同”细节。

交接目标

目标	交接要求
能定位问题	接手人能从用户反馈判断应该查 storeui、storeapi、yunui 还是 yunapi。
能理解链路	每条主链路要说明入口、状态、写入表、日志、通知、兜底方式。
能安全上线	必须知道后端云函数、小程序审核、云平台静态站点发布的差异。
能做运维	必须知道哪些任务由宝塔计划任务或后台调度触发，失败后查哪里。
能避免误写	历史外部协同链路只作为旧代码，不继续沉淀为交接主线。

系统分层

金刚到家员工/门店小程序
  storeui
    页面: 员工端、门店端、订单、钱包、合同、保险、培训、海报、资料
    API: src/api/*.js
  storeapi
    路由: module_admin/controller
    业务: module_admin/service
    任务: module_task + scripts/run_scheduled_worker.py + scripts/cron
  MySQL / Redis / 微信 / 易宝 / 支付宝安心生活 / 大地保险 / 人保

云平台运营后台
  yunui
    页面: src/views
    API: src/api
  yunapi
    路由: module_admin/controller
    业务: module_admin/service
    任务: module_task + scripts/cron
  同一个 MySQL 业务库

主业务域

业务域	金刚侧职责	云平台侧职责	主要数据
订单履约	员工接单、服务记录、评价、异常处理、通知	订单查询、人工派单、异常兜底、统计导出	order、order_details、order_logs、order_waiter
全国标准单	自动进入员工池、候选筛选、通知、超时顺延、结算	员工池预检、产品工种配置、运营中心、人工处理	platform_order、platform_product、standard_staff_*、standard_order_*
员工与能力	员工登录、服务能力、服务区域、档期、钱包、提现	员工池、跨门店人员、入驻预检、队长绑定配置	service_staff、staff_service_capability、standard_staff_service_region、staff_wallet_*
门店与积分	门店资料、门店端能力、积分账户、钱包、合同维护	门店管理、积分配置、日结、线索派发、钱包开关	store、store_info、store_score_*、store_wallet_*
合同与保险	合同购买、续费、补录、换人、保险下单、退保资料	合同管理、合同收入、保险对账、退保文档	contract、contract_payment、contract_insurance、insurance_*
支付与财务	易宝/余额/扫码支付、钱包流水、员工提现、内部财务任务	充值、提现、平台收入、渠道收入、月度品牌费	payment_channel、store_payment_order、company_transaction、staff_wallet_ledger
内容与工具	公告、培训、AI 图片、海报、简历分享、素材	培训素材、招聘海报、固定表单、企微通知、系统配置	training_*、store_material_*、fixed_form*、sys_wecom_webhook_*

阅读顺序

1. 先看 系统边界与模块地图，确认系统职责。
2. 再看 MySQL 数据地图，确认主表归属。
3. 查金刚侧问题时，看 金刚技术模块目录 和 金刚数据与状态模型。
4. 查云平台问题时，看 云平台技术模块目录 和 云平台数据与状态模型。
5. 计划任务、发布、排障分别看两个系统的技术运维页。

交接原则

场景	判断方式
客户反馈服务状态不对	先查 order 当前状态，再查 order_logs，再按是否全国标准单查看 standard_staff_dispatch_*。
员工收不到单	先查员工是否有效、能力是否覆盖产品、服务区域是否覆盖城市、档期是否冲突，再查派发日志和通知 outbox。
门店积分或钱包异常	先分清是 store_score_* 积分，还是 store_wallet_* 钱包资金；两者不能互相替代。
合同保险支付异常	先查支付订单状态，再查合同支付记录、保险记录和第三方回调日志。
云平台菜单看不到	先查 sys_menu、角色菜单、前端 src/views 和 src/api 是否同时存在。
定时任务没有执行	先确认是系统内 APScheduler 任务，还是宝塔调用脚本；云函数内不要依赖响应结束后的后台任务。

明确不沉淀的内容

“小羽佳订单协同”旧链路计划删除。本次交接只保留一句边界说明：遇到相关旧代码时，不把它当成未来方案的依据；后续以新的设计文档和实现为准。