wxserver/部署检查清单.md

# 生日提醒小程序 - 云开发部署检查清单

## ✅ 部署前检查

### 1. 环境准备
- [ ] 已注册微信小程序账号
- [ ] 已获取 AppID
- [ ] 已开通云开发（环境ID：cloudbase-1gk3x0ia3a6b1f80）
- [ ] 已创建订阅消息模板（模板ID：6J7Stt-lu7DKU6jblJ0nZGq_D81z5glnksf7qWfy5Yw）

### 2. 代码检查
- [ ] app.js 已初始化云开发
- [ ] app.js 中的环境ID正确
- [ ] add-anniversary.js 已添加订阅授权代码
- [ ] add-anniversary.js 中的模板ID正确

---

## 📤 上传云函数

### 1. login 云函数
```
□ 右键点击 cloudfunctions/login
□ 选择 "上传并部署：云端安装依赖"
□ 等待上传成功
□ 在云开发控制台确认已上传
```

### 2. syncAnniversary 云函数
```
□ 右键点击 cloudfunctions/syncAnniversary
□ 选择 "上传并部署：云端安装依赖"
□ 等待上传成功
□ 在云开发控制台确认已上传
```

### 3. sendReminder 云函数
```
□ 右键点击 cloudfunctions/sendReminder
□ 选择 "上传并部署：云端安装依赖"
□ 等待上传成功
□ 在云开发控制台确认已上传
□ 确认定时触发器已自动创建
```

**验证**：
云开发控制台 → 云函数，应该看到3个云函数：
- ✅ login
- ✅ syncAnniversary
- ✅ sendReminder

---

## 🗄️ 创建数据库集合

### 1. anniversaries 集合
```
□ 进入云开发控制台 → 数据库
□ 点击"添加集合"
□ 集合名称：anniversaries
□ 权限设置：仅创建者可读写
□ 点击"确定"
```

### 2. remind_logs 集合
```
□ 点击"添加集合"
□ 集合名称：remind_logs
□ 权限设置：仅创建者可读写
□ 点击"确定"
```

**验证**：
云开发控制台 → 数据库，应该看到2个集合：
- ✅ anniversaries
- ✅ remind_logs

---

## ⏰ 配置定时触发器

### 检查触发器
```
□ 进入云开发控制台 → 云函数 → sendReminder
□ 点击"触发器"标签
□ 确认存在 dailyReminder 触发器
□ 确认 Cron 表达式为：0 0 9 * * * *
```

### 如果没有触发器，手动创建
```
□ 点击"新建触发器"
□ 触发器名称：dailyReminder
□ 触发周期：自定义
□ Cron表达式：0 0 9 * * * *
□ 点击"确定"
```

---

## 🧪 功能测试

### 1. 测试 openid 获取
```
□ 打开小程序
□ 查看控制台日志
□ 应该看到："获取openid成功: oABC..."
□ 打开"存储" → 查看 Storage
□ 应该看到 openid 已保存
```

### 2. 测试订阅消息授权
```
□ 在真机上打开小程序（必须真机）
□ 点击"添加纪念日"
□ 填写表单，开启"是否提醒"
□ 点击"保存"
□ 应该弹出订阅消息授权弹窗
□ 点击"允许"
□ 应该显示"添加成功"
```

### 3. 测试数据同步
```
□ 进入云开发控制台 → 数据库 → anniversaries
□ 应该看到刚才添加的纪念日记录
□ 记录中包含 _openid 字段
□ 数据完整无误
```

### 4. 测试云函数
```
□ 进入云开发控制台 → 云函数 → sendReminder
□ 点击"测试"
□ 输入参数：{}
□ 点击"运行测试"
□ 查看返回结果，应该包含：
  {
    "success": true,
    "total": 数字,
    "successCount": 数字,
    "failCount": 数字
  }
```

### 5. 测试订阅消息发送

**方法1：等待定时触发**
```
□ 添加一个明天的生日，提前1天提醒
□ 等到明天上午9:00
□ 应该收到订阅消息推送
```

**方法2：手动触发（推荐）**
```
□ 添加一个今天的生日
□ 手动执行 sendReminder 云函数
□ 应该立即收到订阅消息推送
```

**方法3：修改定时器（快速测试）**
```
□ 临时修改 Cron 为：0 */1 * * * * *
□ 等待1分钟
□ 应该收到订阅消息推送
□ 测试完成后改回：0 0 9 * * * *
```

---

## 🔍 验证清单

### 控制台日志验证
```
□ 看到："云开发初始化成功"
□ 看到："获取openid成功"
□ 看到："订阅消息授权结果"
□ 看到："云端同步成功"
```

### 数据库验证
```
□ anniversaries 集合有数据
□ 数据包含 _openid 字段
□ remindEnabled 为 true
□ personName 字段正确
```

### 提醒日志验证
```
□ remind_logs 集合有记录
□ status 为 "success"
□ sendDate 为今天
□ personName 正确
```

### 订阅消息验证
```
□ 收到了微信服务通知
□ 消息内容正确
□ 称呼、日期、提示都显示正确
□ 点击消息能跳转到小程序
```

---

## 🐛 故障排查

### 问题1：收不到订阅消息

**检查步骤**：
```
□ 确认用户已授权订阅
□ 确认 openid 已保存
□ 查看 sendReminder 云函数日志
□ 查看 remind_logs 是否有 failed 记录
□ 确认模板ID正确
□ 确认云函数权限包含 subscribeMessage.send
```

### 问题2：云函数执行失败

**检查步骤**：
```
□ 查看云函数日志，查找错误信息
□ 确认依赖已安装（查看 node_modules）
□ 确认 config.json 配置正确
□ 尝试重新上传云函数
```

### 问题3：数据没有同步到云端

**检查步骤**：
```
□ 确认 openid 已获取
□ 查看控制台是否有错误
□ 确认 syncAnniversary 云函数已上传
□ 手动测试 syncAnniversary 云函数
```

### 问题4：定时触发器不工作

**检查步骤**：
```
□ 确认触发器已创建
□ 确认 Cron 表达式正确
□ 查看云函数日志，确认有定时调用记录
□ 尝试手动触发云函数验证功能
```

---

## 📊 性能监控

### 每日检查（可选）
```
□ 查看云函数调用次数
□ 查看订阅消息发送成功率
□ 查看 remind_logs 记录
□ 查看是否有异常日志
```

### 每周检查（可选）
```
□ 导出数据库备份
□ 清理过期的 remind_logs（可选）
□ 查看云开发资源使用情况
```

---

## ✅ 部署完成确认

全部完成以下项目即表示部署成功：

- [ ] 3个云函数全部上传成功
- [ ] 2个数据库集合创建成功
- [ ] 定时触发器配置成功
- [ ] 能够获取用户 openid
- [ ] 订阅消息授权正常弹出
- [ ] 数据能够同步到云端
- [ ] 手动执行云函数成功
- [ ] 能够收到订阅消息推送
- [ ] 提醒日志正常记录

---

## 🎉 恭喜部署成功！

你的生日提醒小程序现在具备：
- ✅ 云端数据存储
- ✅ 自动推送提醒
- ✅ 多设备同步
- ✅ 安全可靠

**开始使用吧！** 🎂

---

## 📞 需要帮助？

如果遇到问题：
1. 查看《云开发部署指南.md》
2. 查看《云开发功能说明.md》
3. 查看云开发控制台的错误日志
4. 联系技术支持