发布与运维总览

本页记录六个在用项目的发布、验证和回滚口径。流水线字段、日志入口和生产核实方式见 部署与流水线。

发布对象

项目	类型	发布方式	验证重点
clientapi	FastAPI 云函数	阿里云 FC3；实际触发分支和云效流水线需按生产配置核实。	下单、支付回调、退款、订单查询。
clientui	uni-app 下单端	H5 或微信小程序构建；实际生产上传方式需按当前渠道核实。	产品、下单、支付、订单和退款。
storeapi	FastAPI 云函数	验证通过后提交并推送远程分支，云函数自动部署。	云函数启动、接口健康、数据库/Redis 连接、关键内部任务。
storeui	uni-app 微信小程序	构建小程序包，提交微信审核，审核通过后按发布时间发布。	小程序构建、登录、首页、服务记录、我的、关键分包加载。
yunapi	FastAPI 云函数	验证通过后提交并推送远程分支，后端自动部署。	/prod-api 代理、后台登录、菜单、核心管理接口。
yunui	Vue 后台静态站点	npm run build:prod 后上传 dist 到服务器站点目录覆盖发布。	index.html、静态资源目录、后台登录、菜单和核心页面。
docs-kb	VitePress 文档站	npm run docs:build 生成静态站点。	侧边栏、链接、构建输出和中文内容可读性。

后端发布注意事项

• clientapi、storeapi 和 yunapi 都有阿里云 FC3 配置，不通过普通 Web 目录发布后端代码。
• 云函数里不要依赖响应结束后的后台任务稳定执行；补偿、重试、定时处理优先放到宝塔计划任务或明确的内部任务接口。
• 生产配置中存在数据库、Redis、JWT、内部任务 token 等敏感项，文档只记录配置项名称和用途，不记录明文值。
• 后端改动涉及数据库结构时，需要先评估兼容旧前端、历史数据和回滚方式。

前端发布注意事项

storeui

• storeui 是微信小程序，不按普通 Web 静态站点发布。
• 涉及 storeui 与 storeapi 同步改造时，需要考虑小程序审核延迟。
• 后端上线必须兼容旧小程序包，避免新后端提前破坏旧包流程。

yunui

• yunui 是云平台后台，构建命令为 npm run build:prod。
• 构建产物为 dist，通过 SSH/MCP 发布到 /www/wwwroot/yun.jingangai.cn。
• 发布后至少检查远端 index.html 和静态资源目录存在，并验证后台登录和核心菜单。

clientui

• H5 构建命令为 npm run build:h5，产物为 dist/build/h5。
• 微信小程序构建命令为 npm run build:mp-weixin，产物为 dist/build/mp-weixin。
• 仓库没有记录生产 H5 上传目录和微信发布账号，交接时必须从当前发布负责人处确认。

回滚思路

场景	回滚方式
后端接口异常	回滚到上一版本云函数代码或提交修复兼容逻辑。
云平台前端异常	恢复上一版 dist，或重新构建上一提交并覆盖发布。
小程序异常	优先通过后端兼容修复；小程序新包需走微信审核流程，不能指望立即回滚。
配置误操作	查操作日志、恢复原配置值、通知运营重新验证影响页面。
定时任务异常	暂停脚本、确认任务游标和数据状态，再决定补跑或回滚数据。

发布动作涉及推送远程分支、部署生产云函数、覆盖远端静态文件或提交微信审核时，必须按发布窗口执行并保留操作记录。