云平台架构与数据流

云平台由后台前端 yunui 和后端服务 yunapi 组成，定位是运营管理与人工兜底后台。它负责系统管理、门店人员、订单查询、财务、保险、合同、培训、线索、表单、数据看板和工具能力。

系统定位

维度	说明
主要用户	运营、财务、产品、管理员、内部处理人员。
前端形态	Vue 2 + Element UI 管理后台，基于 RuoYi 风格的动态菜单和权限体系。
后端形态	FastAPI 云函数，入口为 yunapi/app.py 和 yunapi/server.py。
数据依赖	MySQL、Redis、上传文件目录、云函数、第三方文档生成/保险/通知能力。
发布方式	yunapi 走云函数自动部署，yunui 构建静态资源后上传站点目录。

主数据流

运营/财务/管理员
  -> yunui 后台页面
  -> yunui/src/api 请求封装
  -> yunapi controller
  -> yunapi service
  -> MySQL / Redis / 文件生成 / 第三方服务
  -> 返回列表、统计、导出、审核或配置结果

关键运行入口

文件	职责
yunui/src/router/index.js	静态路由、动态路由基础配置。实际业务菜单多由后端权限菜单加载。
yunui/src/views	后台页面目录。
yunui/src/api	页面请求封装。
yunapi/app.py	后端启动入口。
yunapi/server.py	注册 controller、初始化数据库、Redis、调度器、中间件和异常处理。
yunapi/s.yaml	云函数部署配置。

后端启动流程

1. 初始化 FastAPI。
2. 初始化数据库表。
3. 创建 Redis 连接池。
4. 初始化系统字典和配置缓存。
5. 根据配置启动调度器和未完成素材 AI 任务恢复。
6. 注册系统、商户、财务、订单、保险、合同、培训、线索和工具 controller。

接手风险

风险	说明
动态菜单	后台页面是否可见取决于权限菜单和按钮权限，不只看前端路由。
财务口径	平台收入、软件收入、品牌费、分账、充值、提现和渠道收入不能混用。
运营配置	配置误操作会直接影响线上流程，必须写清默认值、生效时间和回滚方式。
静态发布	yunui 发布不是云函数，构建后需要覆盖站点目录并检查静态资源。