系统边界与模块地图

本页按“用户入口、后端职责、数据和运维”说明项目边界，避免接手时跨系统混淆。

总体关系

客户
  -> clientui
  -> clientapi
  -> jingangdata：创建订单、支付、退款和客户查询

员工/门店小程序
  -> storeui
  -> storeapi
  -> jingangdata：派发、履约、结算、合同和保险

运营管理后台
  -> yunui
  -> yunapi
  -> jingangdata：配置、查询、人工处理、财务和对账

三个后端
  -> 各自 Redis / 阿里云函数 / 第三方服务
  -> 共享 MySQL 业务库，不等同于彼此直接调用

知识库
  -> docs-kb
  -> VitePress 静态站点

金刚下单端

层级	模块	说明
前端入口	clientui/pages、pages-mine	客户选产品、提交订单、支付、退款、发票和个人中心。
API 封装	clientui/api	默认调用 clientapi，部分历史页面仍有外部接口，排查时要看是否使用 outsideUrl。
后端入口	clientapi/app.py、clientapi/server.py	FastAPI 云函数入口。
路由聚合	clientapi/module_client/routes.py	会员、订单、商品、支付、微信、支付宝、发票、提现和归因。
数据职责	order、支付和产品相关表	创建标准单并完成支付，支付后由金刚侧继续派发和履约。

金刚到家系统

层级	模块	说明
前端入口	storeui/src/pages、pages-staff、pages-home、pages-set、pages-sister-business	小程序主包和分包页面，承载员工端、门店端、业务管理和个人中心。
API 封装	storeui/src/api	订单、员工、钱包、保险、合同、培训、支付、门店和业务功能请求封装。
后端入口	storeapi/server.py	FastAPI 应用，注册 controller，初始化数据库、Redis、中间件和后台任务。
控制器	storeapi/module_admin/controller	登录、订单、员工、门店、合同、保险、支付、钱包、配置、数据看板等接口入口。
服务层	storeapi/module_admin/service	业务规则、事务、第三方服务对接、通知、定时任务落点。
计划任务	storeapi/scripts/cron	派发、超时、结算、通知、员工入驻后处理、提现和积分相关脚本。

云平台

层级	模块	说明
前端入口	yunui/src/views	Vue 2 + Element UI 后台页面，按订单、门店、员工、财务、保险、合同、培训、线索等目录组织。
API 封装	yunui/src/api	后台页面请求封装，和 yunapi controller 一一对应。
后端入口	yunapi/server.py	FastAPI 应用，注册系统管理、商户、财务、保险、合同、订单和运营接口。
控制器	yunapi/module_admin/controller	后台菜单对应的接口入口。
服务层	yunapi/module_admin/service	运营规则、查询统计、导出生成、财务保险合同处理。
计划任务	yunapi/scripts/cron	云平台门店积分日结脚本。

共享依赖

依赖	说明
MySQL	金刚与云平台共用业务数据库，涉及订单、门店、员工、财务、合同、保险、配置等数据。
下单端 API	clientapi 与金刚、云平台后端共用 jingangdata，负责下单和支付阶段。
Redis	登录态、字典配置、缓存、后台监听或延迟任务依赖。
阿里云函数计算	storeapi、yunapi 后端部署方式。
静态资源服务器	yunui 构建后上传到云平台站点目录。
微信小程序	storeui 需要按小程序审核节奏发布。

详细表归属看 MySQL 数据地图。

排除边界

本次交接文档不整理金刚系统中的“小羽佳订单协同”链路。涉及该链路的旧文档和旧代码只作为历史参考，不作为接手后的维护依据。

sysui、sysapi 已停用，不出现在在用系统调用图中。家姐联盟线索派发仍属于金刚与云平台的运营链路，不能与已排除的订单协同旧链路混为一谈。