- 新增 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>
This commit is contained in:
yuming
@@ -0,0 +1,398 @@
|
||||
# 生日提醒小程序 - 上线部署指南
|
||||
|
||||
## 📋 上线流程概览
|
||||
|
||||
```
|
||||
注册账号 → 获取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天：审核通过，正式上线
|
||||
|
||||
加油！🚀
|
||||
|
||||
Reference in New Issue
Block a user