交付与上线

这篇写给购买源码后负责上线的人。目标不是「能编译」，而是能对外营业：支付、账号、权限、数据、法务和回滚都准备好。

先确认范围

交付内容以订单为准。本文按三端齐全的交付说明；如果你购买的是部分模块，跳过不存在的步骤。

1. 工程结构

企数家商店通常包含三个工程和一个云空间：

目录	作用
qishujia-app	移动端（App / Web / 微信小程序），uni-app x
qishujia-web	桌面 Web 商店
qishujia-admin	运营中台
uniCloud-alipay	云函数、数据库 schema、公共模块

作品数据、封面、画廊和品牌资源通常来自项目内的 catalog / static 目录；上线前替换成你自己的作品与品牌素材。

2. 环境准备

• HBuilderX 5.33 或更高版本（uni-app x 蒸汽模式需要）。
• Node.js 22+，npm 可用。
• 一个 uniCloud 支付宝云空间，三个工程绑定到同一个空间。
• 已备案域名 + HTTPS 证书。
• 微信小程序 AppID（如需要小程序端）和微信支付商户号（如需要支付）。
• 短信服务商账号、签名和模板（如需要短信）。
• 对象存储或云存储（用于封面、视频、交付文件）。

不要复用演示 AppID

演示构建使用统一 AppID __UNI__18FE52B。正式环境必须换成你自己的 AppID；直接使用演示 AppID 会导致推送、登录和发布异常。

3. 初始化项目

1. 用 HBuilderX 打开三个工程，确认版本和依赖。
2. 修改 manifest.json 的 AppID、应用名称、包名、图标和隐私清单。
3. 检查 manifest.web.devServer.port，避免三个工程端口冲突。
4. 绑定 uniCloud 支付宝云空间到三个工程。
5. 上传云函数、公共模块和数据库 schema。
6. 运行 npm run seed，把样例数据写入数据库（只用于初始化，不要在生产环境反复执行）。
7. 创建第一个管理员账号，修改初始密码。

4. 配置第三方服务

支付

• 配置商户号、应用 ID、密钥和回调地址。
• 回调地址必须是公网 HTTPS，且能从支付渠道访问。
• 先做一笔小额支付和一笔退款，确认回调、订单状态和退款记录都正确。

微信小程序

• 配置小程序 AppID。
• 在微信后台把正式域名加入业务域名。
• 配置订阅消息模板；模板 ID 与后台一致。
• 小程序端如需登录，配置对应的登录方式。

短信与通知

• 配置短信签名、模板和服务商密钥。
• 不要在前端或仓库里保存密钥。
• 先用测试手机号验证验证码、订单和发货通知。

存储

• 配置封面、画廊、视频和交付文件的存储空间。
• 检查上传大小限制、访问权限和 CDN 缓存。
• 交付文件不要放在公开可猜测的路径。

5. 构建与部署

Web 商店与运营中台

1. 设置正式环境的 API/云空间地址。
2. 构建 Web 与运营中台产物。
3. 如果部署在子目录，设置正确的 router base，确保静态资源路径带前缀。
4. 上传到静态托管或你的服务器，配置 HTTPS 和缓存。
5. 打开首页、作品详情、订单和中台登录，确认没有白屏和 404。

App

1. 配置 iOS/Android/鸿蒙的证书、包名、图标和启动图。
2. 配置隐私政策、权限说明和第三方 SDK 清单。
3. 构建正式包，真机安装测试。
4. 上架前检查深色模式、字体、支付和安全区。

微信小程序

1. 使用正式 AppID 构建。
2. 上传体验版，检查业务域名、登录、支付和订阅消息。
3. 提交审核前准备好隐私政策和类目资质。

6. 上线前检查

• 三个端都能登录，角色和权限正确。
• 作品列表、详情、在线预览、搜索正常。
• 下单、支付、订单状态、退款全链路走通。
• 免费作品领取和订单记录正常。
• 定制需求提交、后台报价和回复正常。
• 封面、画廊、视频和交付文件可访问。
• 短信、订阅消息、站内通知能收到。
• 管理员账号已改密码，演示账号已停用。
• 用户协议、隐私政策、退款条款换成自己的主体。
• 域名备案、HTTPS、小程序业务域名已完成。
• 数据备份和回滚方案已确认。

7. 常用命令

在移动端工程目录：

npm run check      # 结构、硬规则与类型检查
npm test           # 单元测试
npm run web        # 完整 Web 构建
npm run seed       # 重新生成云函数数据库种子
npm run api:test   # 后端云函数本地集成测试
npm run shot       # Web 运行时门禁与截图

具体命令以交付工程的 package.json 和 README 为准。

8. 常见上线问题

问题	先查
Web 白屏	静态资源路径、router base、构建是否完整上传
登录后立刻退出	Cookie、域名、系统时间、登录票据配置
支付成功订单未更新	回调地址、密钥、商户号、订单号
小程序打不开	AppID、业务域名、HTTPS、体验版配置
图片不显示	存储权限、CDN 缓存、资源路径
后台看不到菜单	角色权限、账号绑定

9. 交付后的建议

• 保留一份可回滚的上一版产物和数据库备份。
• 先小范围试用，再对外推广。
• 把支付、短信、存储的负责人和密钥保管人写清楚。
• 每次发版前跑一遍本页的检查清单。

需要上线协助或定制改动，联系 biz@qishujia.com。