金刚系统架构与数据流

金刚系统由员工端小程序 storeui 和后端服务 storeapi 组成，定位是一线履约承接系统。它负责员工登录、门店和人员资料、订单服务、服务记录、员工钱包、合同保险、支付分账、培训素材和业务通知。

系统定位

维度	说明
主要用户	员工、门店、队长、运营辅助角色。
前端形态	uni-app 小程序，主包加多个分包。
后端形态	FastAPI 云函数，端口 9099，入口为 storeapi/app.py 和 storeapi/server.py。
数据依赖	MySQL、Redis、文件静态目录、第三方支付、保险、短信、企微通知等。
发布约束	小程序需要微信审核；后端是云函数自动部署，需要兼容旧小程序包。

主数据流

员工/门店
  -> storeui 页面
  -> storeui/src/api 请求封装
  -> storeapi controller
  -> storeapi service
  -> MySQL / Redis / 第三方服务
  -> 返回页面状态、通知、支付或服务结果

关键运行入口

文件	职责
storeui/src/pages.json	小程序主包、分包、页面标题和导航配置。
storeui/src/main.js	小程序前端初始化和全局注册。
storeui/src/api/http.js	前端请求基础封装。
storeapi/app.py	FastAPI 启动入口，读取运行环境。
storeapi/server.py	应用初始化、controller 注册、Redis/数据库/中间件/后台监听器初始化。
storeapi/s.yaml	阿里云函数计算部署配置。

后端启动流程

1. 设置运行环境和时区。
2. 初始化数据库表结构并做运行时 schema 校验。
3. 创建 Redis 连接池。
4. 初始化字典和系统配置缓存。
5. 注册中间件、异常处理、静态资源和子应用。
6. 注册业务 controller。
7. 按配置启动或禁用后台任务和监听器。

后台任务边界

storeapi 中存在后台监听器和宝塔计划任务两类机制。云函数环境不适合依赖响应结束后的隐式后台任务，长期补偿、重试、结算、超时、通知应优先走明确脚本或内部任务接口。

接手风险

风险	说明
小程序审核延迟	前后端同步改造时，后端必须兼容旧包。
配置敏感	s.yaml、环境文件中包含生产依赖配置，文档不得公开明文密钥。
业务集中	storeapi controller/service 数量多，改动前要先定位是否已有相似服务。
定时补偿	结算、派发、通知、提现等任务需要关注是否可重复执行。