Files
wxserver/上线部署指南.md
T
yuming 3965e542fc
部署到群晖 / deploy (push) Failing after 6m22s
接入自建后端 + Gitea CI/CD
- 新增 server/:Node + Express + SQLite + node-cron 实现登录、纪念日 CRUD 和定时订阅消息推送
- 新增 .gitea/workflows/deploy.yml:推送即触发群晖 Docker 部署,监听 15002
- utils/api.js:自动按 envVersion 切换本地/线上 BASE_URL
- app.js 与 add-anniversary.js 移除 wx.cloud 调用,改走自建后端
- cloudfunctions/ 暂保留以便回滚
- 一并提交此前未入库的首页 / 设置页 / 日历 / 万年历等改造

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-06-01 15:44:09 +08:00

399 lines
8.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 生日提醒小程序 - 上线部署指南
## 📋 上线流程概览
```
注册账号 → 获取AppID → 配置项目 → 上传代码 → 提交审核 → 发布上线
↓ ↓ ↓ ↓ ↓ ↓
30分钟 即时 5分钟 5分钟 1-7天 即时
```
---
## 🎯 第一步:注册小程序账号
### 1.1 前往微信公众平台注册
**网址**https://mp.weixin.qq.com/
**注册步骤**
1. 点击"立即注册"
2. 选择"小程序"类型
3. 填写账号信息(邮箱、密码)
4. 激活邮箱(点击邮件中的链接)
5. 选择主体类型:
- **个人**:无需营业执照(推荐个人项目)
- **企业**:需要营业执照和对公账户
### 1.2 填写主体信息
**个人类型需要**
- 管理员身份证信息
- 管理员微信扫码认证(需要绑定银行卡)
**企业类型需要**
- 营业执照
- 对公账户信息
- 管理员身份信息
- 300元认证费(可选,认证后可开通支付等高级功能)
### 1.3 完成注册
注册成功后,你将获得:
-**AppID**(重要!)
- ✅ 小程序管理后台访问权限
---
## 🔑 第二步:获取并配置 AppID
### 2.1 获取 AppID
1. 登录 [微信公众平台](https://mp.weixin.qq.com/)
2. 进入"开发" → "开发管理" → "开发设置"
3. 找到 **AppID**(格式:wx1234567890abcdef
4. 复制保存
### 2.2 配置项目 AppID
修改 `project.config.json`
```json
{
"appid": "wx1234567890abcdef", // 替换为你的真实 AppID
"projectname": "birthday-reminder"
}
```
### 2.3 添加开发者
如果有其他人协作开发:
1. 进入小程序后台
2. "管理" → "成员管理" → "项目成员"
3. 添加开发者(需要对方微信号)
4. 设置权限(开发者/体验者)
---
## ⚙️ 第三步:完善小程序信息
### 3.1 基本信息设置
进入"设置" → "基本设置"
- **小程序名称**:生日提醒(或自定义)
- **小程序头像**:上传一个图标(推荐 256x256 像素)
- **小程序介绍**
```
一款轻量级的生日提醒工具,支持公历和农历生日,
智能提醒让你不错过任何重要日子。
```
- **服务类目**
- 工具 → 效率 → 备忘录/提醒
- 或 生活服务 → 综合生活服务
### 3.2 隐私保护设置
进入"设置" → "隐私与安全设置"
1. **用户隐私保护指引**
```
本小程序会收集和使用以下信息:
1. 您添加的人员姓名、生日等信息
2. 所有数据仅存储在您的设备本地
3. 我们不会上传或分享您的任何数据
数据使用目的:
- 提供生日提醒服务
- 展示纪念日列表和日历
您的权利:
- 可随时删除数据
- 可导出备份数据
```
2. **涉及的接口**
- 选择图片(上传头像)
- 剪贴板(导入/导出数据)
---
## 📤 第四步:上传代码
### 4.1 准备上传
在微信开发者工具中:
1. 点击工具栏的"上传"按钮
2. 填写版本号和备注:
```
版本号:1.0.0
备注:首次发布,包含核心功能
```
3. 点击"上传"
### 4.2 版本号规范
建议使用语义化版本:
- **1.0.0**:首次发布
- **1.0.1**:修复bug
- **1.1.0**:新增功能
- **2.0.0**:重大更新
### 4.3 上传成功
上传成功后,代码会出现在小程序后台的"开发管理" → "开发版本"中。
---
## 👥 第五步:体验测试
### 5.1 添加体验者
上传后先让其他人体验测试:
1. 进入小程序后台
2. "管理" → "成员管理" → "项目成员"
3. 添加"体验者"(最多50个)
4. 体验者扫码即可使用
### 5.2 体验版测试
- 体验者可以完整测试所有功能
- 发现问题及时修复
- 重新上传新版本
---
## 🚀 第六步:提交审核
### 6.1 配置审核信息
进入"开发管理" → "版本管理" → "开发版本" → "提交审核"
**填写信息**
1. **功能页面**
```
页面类型:首页
页面功能:查看人员生日列表
页面类型:添加页面
页面功能:添加人员信息和纪念日
页面类型:日历页面
页面功能:查看纪念日日历
```
2. **可提供的测试账号**
```
无需测试账号(或提供一个演示账号)
```
3. **版本描述**
```
生日提醒小程序首次发布版本,主要功能:
1. 添加和管理人员信息
2. 支持公历和农历生日
3. 多种纪念日类型(生日、结婚纪念日等)
4. 智能提醒功能
5. 日历视图展示
6. 数据导入导出
```
### 6.2 审核时长
- **正常情况**1-3个工作日
- **节假日**:可能延长至7天
- **首次审核**:可能会慢一些
### 6.3 审核要点
**容易被拒的原因**
- ❌ 功能描述不清晰
- ❌ 涉及未申请的类目
- ❌ 缺少隐私政策
- ❌ 测试账号无法登录
- ❌ 页面空白或无内容
**避免被拒**
- ✅ 填写清晰的功能描述
- ✅ 选择正确的服务类目
- ✅ 完善隐私保护指引
- ✅ 确保所有功能正常
- ✅ 添加测试数据供审核
---
## ✅ 第七步:发布上线
### 7.1 审核通过
收到审核通过通知后:
1. 进入"开发管理" → "版本管理"
2. 找到"审核通过"的版本
3. 点击"发布"按钮
4. 确认发布
### 7.2 发布后
- ⏱️ **生效时间**5-10分钟内全网生效
- 🔍 **搜索**:用户可以在微信搜索到你的小程序
- 📱 **分享**:可以分享给好友使用
### 7.3 获取小程序码
发布后可以生成小程序码:
1. 进入"设置" → "基本设置" → "小程序码"
2. 下载并分享给用户
---
## 📊 第八步:运营推广
### 8.1 数据监控
进入"统计" → "数据分析",查看:
- 访问次数
- 用户数量
- 留存率
- 使用时长
### 8.2 推广方式
1. **朋友圈分享**:生成小程序卡片
2. **微信群分享**:发送给感兴趣的群
3. **公众号关联**:如有公众号可关联推广
4. **附近的小程序**:设置门店位置
---
## 🔄 后续更新流程
### 9.1 版本更新
发现bug或要添加新功能:
1. 修改代码
2. 测试通过
3. 上传新版本(版本号递增)
4. 提交审核
5. 审核通过后发布
### 9.2 紧急修复
如果发现严重bug
1. 快速修复代码
2. 使用"加急审核"(有次数限制)
3. 通过后立即发布
---
## 💰 费用说明
### 个人类型(推荐)
-**注册**:免费
-**认证**:不需要(个人类型无需认证)
-**上线**:免费
-**使用**:免费
**限制**
- ❌ 无法开通支付功能
- ❌ 部分高级接口受限
- ✅ 本项目的所有功能都不受影响
### 企业类型
-**注册**:免费
- 💰 **认证**300元/年(可选)
-**上线**:免费
**优势**
- ✅ 可开通微信支付
- ✅ 可使用所有高级接口
- ✅ 可关联公众号
---
## 📝 常见问题
### Q1: 个人可以注册小程序吗?
**A**: 可以!个人注册完全免费,本项目的所有功能都支持。
### Q2: 多久可以上线?
**A**:
- 注册:30分钟
- 配置:10分钟
- 上传:5分钟
- 审核:1-7天
- **总计**:最快1天,一般3-5天
### Q3: 审核不通过怎么办?
**A**:
1. 查看拒绝原因
2. 根据要求修改
3. 重新提交审核
4. 审核次数不限
### Q4: 小程序可以改名吗?
**A**:
- 个人类型:一年可改2次
- 企业已认证:一年可改2次
- 需要在后台申请
### Q5: 需要服务器吗?
**A**: 本项目不需要!所有数据存储在用户本地。
### Q6: 可以商用吗?
**A**: 可以,建议使用企业类型注册。
---
## 🎯 快速检查清单
上线前检查:
- [ ] 已注册小程序账号
- [ ] 已获取并配置 AppID
- [ ] 已完善小程序信息(名称、头像、介绍)
- [ ] 已设置服务类目
- [ ] 已配置隐私保护指引
- [ ] 已在开发工具中测试通过
- [ ] 已添加体验者测试
- [ ] 代码已上传到小程序后台
- [ ] 已准备审核资料(功能描述、截图)
- [ ] 已提交审核
---
## 📞 需要帮助?
### 官方资源
- **开发文档**https://developers.weixin.qq.com/miniprogram/dev/framework/
- **社区论坛**https://developers.weixin.qq.com/community/minigame
- **客服**:登录小程序后台,右上角"客服"
### 关键联系方式
- **小程序客服**400-901-0500(工作日 9:00-18:00
---
## 🎉 恭喜!
按照本指南操作,你的小程序很快就能上线让全网用户使用了!
**预计时间线**
- 今天:注册账号、配置信息、上传代码
- 第2-3天:等待审核
- 第3-5天:审核通过,正式上线
加油!🚀