云平台技术运维与排障

本页用于云平台上线、配置、菜单、任务和业务异常排查。云平台影响运营操作和规则生效，变更前要确认权限、菜单、接口和数据都齐。

运行和发布

对象	方式	检查
yunapi	验证通过后提交并推送远程分支，后端自动部署。	接口启动、controller 注册、权限、SQL 菜单脚本。
yunui	执行 npm run build:prod，上传 dist 到 /www/wwwroot/yun.jingangai.cn 覆盖发布。	构建通过、远端 index.html 和静态资源存在。
MySQL	与金刚系统共用业务库。	Schema 变更必须兼容金刚侧。
计划任务	后台调度或宝塔脚本。	日志、锁、任务参数、失败重试。

菜单和权限排查

现象	排查顺序
页面 404	查 sys_menu 路由是否存在，再查 src/views 文件路径。
菜单不可见	查用户角色、sys_role_menu、菜单状态。
按钮不可见	查按钮权限码和前端 v-hasPermi 使用。
接口 403	查后端依赖的登录用户、权限标识和角色。
新菜单上线后无效	查 SQL 脚本是否执行到目标环境，前端是否已重新构建发布。

计划任务

任务	入口	作用	排查
门店积分日结	scripts/cron/yun_store_score_daily_settlement_bt.sh、module_task/store_score_settlement_task.py	后台触发门店积分日结。	查日志、store_score_settlement_batch、分布式锁。
简历分享过期	module_task/resume_share_expire_task.py	过期分享链接失效。	查 resume_share_validity。
平台收入报表	scripts/platform_revenue_*.py	生成平台收入、奖金、半月调整报表。	查脚本参数、输出文件、统计口径。

宝塔脚本失败时先看脚本日志，不要直接重复执行生产任务。需要重跑时先确认任务是否幂等。

常见问题

云平台操作成功但员工端没变化

1. 查云平台接口是否写入业务表。
2. 查金刚侧接口是否读取同一字段。
3. 查小程序是否缓存了旧数据。
4. 查是否需要后端任务补偿或通知 outbox。
5. 涉及小程序新字段时确认旧包兼容。

标准员工池预检失败

1. 查员工是否在平台店或已映射。
2. 查证件、手机号、服务区域、产品能力是否完整。
3. 查易宝入网状态是否成功。
4. 查省级师傅绑定是否缺失。
5. 查 standard_staff_service.py 预检摘要和候选列表返回。

平台产品不能上架

1. 查产品状态是否属于允许值：下架、上架、暂停销售。
2. 上架时必须有有效工种。
3. 查 SKU 是否属于产品。
4. 查来源映射是否完整。
5. 查区域价格和门店价格是否影响展示。

门店积分日结失败

1. 查是否启用日结开关。
2. 查分布式锁是否被其他实例持有。
3. 查 store_score_settlement_batch 对应日期状态。
4. 查失败门店的业务条件和异常信息。
5. 修复后按日期重跑，确认幂等。

月度品牌费执行异常

1. 云平台只是触发入口，实际扣款在金刚后端内部任务。
2. 查内部服务凭证是否有效。
3. 查金刚后端返回是否 skipped_by_lock、partial_failed 或失败。
4. 查 store_wallet_transaction 和 company_transaction 是否一致。
5. 查 store_score_account.dispatch_status 是否被暂停或恢复。

保险退款文档无法生成

1. 查保单是否符合退保材料生成条件。
2. 查公章来源、主体、模板字段、付款截图是否完整。
3. 查 insurance_surrender_document 状态。
4. 查文档生成服务和 OBS 上传结果。
5. 查第三方退保接口操作记录。

财务统计口径不一致

1. 先确认统计页面使用的 service。
2. 查是否包含退款、撤销、补价、品牌费、分账。
3. 查时间字段使用创建时间、支付成功时间还是结算时间。
4. 查状态过滤条件。
5. 导出口径以服务层查询为准，不能只按页面列名猜。

发布前检查

类型	检查
新页面	src/views、src/api、sys_menu、角色权限、前端构建。
新接口	controller 注册、service 事务、权限、错误处理、日志。
新配置	默认值、生效条件、回滚方式、文档说明。
新任务	dry-run、日志、锁、幂等、失败重试、宝塔参数。
财务改动	金额精度、幂等键、流水、反向冲正方案。
跨系统改动	金刚后端、小程序旧包、云平台菜单和数据库兼容。

回滚方式

变更	回滚
yunui 静态站点	重新上传上一版 dist，确认远端资源存在。
yunapi 后端	回退代码并推送触发自动部署。
菜单 SQL	更新菜单状态或删除错误菜单，记录操作。
配置	恢复原值，记录生效时间和影响范围。
任务	停止任务或改 dry-run，再补偿数据。
财务数据	使用反向流水或补偿流水，不直接改最终余额。