3965e542fc
部署到群晖 / deploy (push) Failing after 6m22s
- 新增 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>
399 lines
8.5 KiB
Markdown
399 lines
8.5 KiB
Markdown
# 生日提醒小程序 - 上线部署指南
|
||
|
||
## 📋 上线流程概览
|
||
|
||
```
|
||
注册账号 → 获取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天:审核通过,正式上线
|
||
|
||
加油!🚀
|
||
|