← 返回进销存

☁️ 云端部署指南

把进销存小程序升级为多人协作 · 数据云端共享 · 任何地方都能用
预计 30 分钟完成 · 月成本 ≈ 5 元

1. 准备工作 必做

1.1 注册腾讯云账号

访问 cloud.tencent.com/register 注册并完成实名认证（个人身份证即可）。

1.2 开通云开发 CloudBase

访问 console.cloud.tencent.com/tcb → 新建环境

1.3 安装命令行工具

打开终端（Win+R → 输入 cmd）执行：

npm install -g @cloudbase/cli
tcb login

扫码登录腾讯云账号。

2. 创建数据库集合 必做

进入 CloudBase 控制台 → 左侧"数据库" → 创建以下 4 个集合：

集合名说明
sakura_users用户表
sakura_products商品表
sakura_purchases进货记录
sakura_sales销售记录

权限建议先设为"仅创建者可读写"，部署完再调整（数据安全）。

3. 部署云函数 必做

把 sakura-cloud/cloudfunctions/ 整个目录复制到你电脑上，然后：

cd sakura-cloud/cloudfunctions/api
npm install
tcb fn deploy api

cd ../seed
npm install
tcb fn deploy seed

部署成功会在 CloudBase 控制台 → 云函数看到 api 和 seed 两个函数。

4. 配置 HTTP 触发器 必做

  1. CloudBase 控制台 → 云函数 → 点 api
  2. 左侧"函数配置" → "HTTP 触发器" → "添加触发器"
  3. 路径填 /api，方法选 ANY（或者 GET + POST 都勾上）
  4. 创建后获得形如的 URL： 
    https://env-xxxxxx.ap-shanghai.tcb-api.tencentcloud.com/api
    复制这个 URL，后面要用

5. 设置环境变量 推荐

云函数 api → "函数配置" → "环境变量"，添加：

变量名值
SAKURA_JWT_SECRET一串随机字符串（终端执行 node -e "console.log(require('crypto').randomBytes(32).toString('hex'))" 复制结果）
SAKURA_SEED_SECRET自定义密码，比如 my-seed-2026

6. 初始化商品数据 必做

CloudBase 控制台 → 云函数 → 点 seed → "函数测试"，输入：

{
  "secret": "my-seed-2026"
}

点"运行测试"，看到返回 { code: 0, data: { count: 596 } } 即成功。

7. 接入前端 必做

  1. 打开小程序首页（CloudStudio 链接）
  2. 点 "数据管理"
  3. 滚到 "☁️ 云同步配置" 卡片
  4. 把第 4 步拿到的 URL 填进去，点"保存配置" → 自动测试连接
  5. 连接成功后会自动跳到登录页
  6. 点"立即注册"创建第一个账号（自动登录）
  7. 告诉员工这个链接 + 注册他们自己的账号即可

8. 给员工开通账号

员工自己用小程序链接打开 → 在登录页点"立即注册" → 选自己的用户名和密码即可（不需要店主操作）。

如果员工忘密码：店主进 CloudBase 控制台 → 数据库 → sakura_users → 删除该员工的记录，让他重新注册。

9. 常见问题

Q：测试连接提示 "CORS" 错误？
A：HTTP 触发器已默认开启 CORS，不会拦截。如仍报错，检查 URL 是否带 /api 路径。

Q：员工看到的数据不一致？
A：刷新一下页面就行。当前版本每次操作会全量重拉，简单粗暴。如需实时同步可加 WebSocket。

Q：数据库被刷爆了怎么办？
A：小店业务一天最多几十条记录，远低于免费额度。如果真担心，CloudBase 控制台可设置预算告警。

Q：想加更多功能（会员价、打印小票、微信收款对账）怎么办？
A：跟我说，我加。

🌸 樱花树下 · 进销存管理 · 2026