发布与运维总览

本页记录四个核心项目的发布、验证和回滚口径。

发布对象

项目	类型	发布方式	验证重点
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 生成静态站点。	侧边栏、链接、构建输出和中文内容可读性。

后端发布注意事项

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

前端发布注意事项

storeui

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

yunui

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

回滚思路

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