金刚系统运维交接

本页用于金刚系统日常排查、发布和问题升级。

常用定位路径

问题	先看	再看
员工无法登录	storeui 登录页和 auth API	storeapi 登录、用户、Redis token、角色权限。
服务记录提交失败	员工端服务记录页面	staff_order_controller、订单状态、附件上传、服务记录落库。
代客下单无法新建	代客下单页面提示	当前后端直接返回 1048 暂停异常，属于已知业务暂停，不按接口故障处理。
员工能力或档期不生效	能力/可服务时间页面	staff_capability_service、staff_availability_service、派发过滤逻辑。
钱包或提现异常	钱包页面	钱包记录、提现账户、打款任务、通知和财务流水。
保险或合同异常	保险/签约页面	保险支付、合同签署、保单状态、第三方回调。
小程序页面错位	对应 Vue 页面	安全区、分包样式、微信基础库、历史导航规范。

后端运行和发布

• 后端入口：storeapi/app.py
• 应用初始化：storeapi/server.py
• 云函数配置：storeapi/s.yaml
• 运行端口：9099
• 生产环境：通过云函数部署，不通过 Web 目录上传。

发布前至少确认：

1. 关键接口本地或测试环境可启动。
2. 涉及数据库结构时，兼容旧数据和旧小程序包。
3. 涉及定时任务时，明确是否需要暂停、补跑或改宝塔脚本。
4. 涉及客户可见流程时，更新客户说明或客服口径。

当前重点状态

事项	当前口径
标准单配置	全国标准单总开关已开启，允许来源为金刚下单端和门店开发码，城市范围为 ["*"]。
标准单生产沉淀	派发 attempt、通知 outbox、结算任务和员工钱包流水当前仍为 0 条，放量前必须干跑和小额验证。
员工能力数据	员工能力、平台产品绑定、服务区域和员工积分已有数据，候选问题要优先查这些表。
代客下单	新建已暂停，后端返回 1048；页面和历史逻辑保留但不可按可用主链路交接。
小羽佳旧协同	计划删除，不继续补文档细节。

前端运行和发布

• 前端项目：storeui
• 构建体系：uni-app + Vue 2
• 微信小程序构建：npm run build:mp-weixin
• H5 构建：npm run build:h5

发布前至少确认：

1. 主包页面能进入。
2. 员工端服务首页、服务记录、我的等核心页面无明显布局问题。
3. 新接口对旧后端或旧小程序包有兼容策略。
4. 小程序审核和后端上线窗口已协调。

敏感配置处理

文档中只写配置项名称和用途，不写明文值。接手时如果需要查看生产配置，应在受控环境中查看云函数配置、环境文件或部署平台。

升级优先级

优先级	场景
P0	登录不可用、服务记录大面积不可提交、支付/提现/保险资金异常。
P1	核心页面无法进入、派发或结算任务异常、合同签约大面积失败。
P2	单个门店或员工数据异常、导出异常、通知失败。
P3	文案、样式、非核心入口问题。