# early-bird-miniprogram

**Repository Path**: xuebin1989/early-bird-miniprogram

## Basic Information

- **Project Name**: early-bird-miniprogram
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-23
- **Last Updated**: 2026-03-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 早睡早起打卡小程序 - 发布指南

## 📱 项目概述

这是一个帮助打工人养成科学早睡早起习惯的微信小程序，包含以下核心功能：

- ✅ **早起/早睡打卡** - 弹性时间范围，智能验证
- 📊 **数据可视化** - 睡眠趋势图、统计报告
- 🏆 **成就系统** - 徽章、积分、排行榜
- 👥 **社群互助** - 打卡小组、团队挑战
- 🔔 **智能提醒** - 下班结界、入睡提醒
- 🎁 **激励体系** - 积分商城（虚拟奖励）

## 🚀 快速发布（个人开发者）

### 前置条件

1. **微信小程序账号** - 个人类型即可
   - 访问 https://mp.weixin.qq.com 注册
   - 完成实名认证

2. **微信开发者工具**
   - 下载地址：https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html

### 步骤 1: 获取 AppID

1. 登录微信小程序后台
2. 进入「开发」-「开发管理」-「开发设置」
3. 复制 **小程序 AppID**

### 步骤 2: 配置项目

1. 打开微信开发者工具
2. 导入项目：选择 `early-bird-miniprogram` 文件夹
3. 在 `project.config.json` 和 `project.private.config.json` 中替换 AppID：
   ```json
   "appid": "YOUR_APPID"  // 替换为你的真实 AppID
   ```

### 步骤 3: 开通云开发

1. 在开发者工具中，点击「云开发」按钮
2. 开通云开发环境（免费版即可）
3. 记录环境 ID（如：`early-bird-env`）
4. 在 `miniprogram/app.js` 中修改环境 ID：
   ```javascript
   wx.cloud.init({
     env: 'early-bird-env',  // 替换为你的环境 ID
     traceUser: true
   });
   ```

### 步骤 4: 部署云函数

1. 在开发者工具中，右键点击 `cloudfunctions/login` 文件夹
2. 选择「上传并部署：云端安装依赖」
3. 重复上述步骤，部署以下云函数：
   - `cloudfunctions/login`
   - `cloudfunctions/checkin`
   - `cloudfunctions/user`
   - `cloudfunctions/report`

### 步骤 5: 创建数据库集合

在云开发控制台创建以下集合：

1. **users** - 用户数据
   - 权限：所有用户可读，仅创建者可写

2. **checkins** - 打卡记录
   - 权限：所有用户可读，仅创建者可写

3. **groups** - 打卡小组
   - 权限：所有用户可读，仅创建者可写

### 步骤 6: 上传小程序代码

1. 在开发者工具中点击「上传」按钮
2. 填写版本号（如：1.0.0）和项目备注
3. 上传成功

### 步骤 7: 提交审核

1. 登录微信小程序后台
2. 进入「版本管理」
3. 选择刚上传的版本，点击「提交审核」
4. 填写审核信息：
   - **功能页面**：首页、打卡页、数据页、个人中心页、群组页
   - **测试账号**：无需提供（小程序使用微信登录）
   - **补充说明**：本小程序用于帮助用户养成早睡早起的健康习惯

### 步骤 8: 发布上线

1. 审核通过后，在小程序后台点击「发布」
2. 小程序正式上线！

## ⚠️ 个人开发者限制说明

个人类型小程序有以下限制，本项目已做适配：

| 功能 | 限制 | 解决方案 |
|------|------|----------|
| 微信支付 | ❌ 不支持 | 改为虚拟积分奖励 |
| 获取手机号 | ❌ 不支持 | 改为可选填写 |
| 企业微信集成 | ❌ 不支持 | 改为通用提醒 |
| 订阅消息 | ✅ 支持 | 需用户手动订阅 |

## 📁 项目结构

```
early-bird-miniprogram/
├── miniprogram/              # 小程序前端
│   ├── pages/               # 页面
│   │   ├── index/          # 首页
│   │   ├── checkin/        # 打卡页
│   │   ├── stats/          # 数据页
│   │   ├── profile/        # 个人中心
│   │   └── group/          # 群组页
│   ├── images/             # 图片资源
│   ├── app.js              # 小程序入口
│   ├── app.json            # 全局配置
│   └── app.wxss            # 全局样式
├── cloudfunctions/          # 云函数（后端）
│   ├── login/              # 登录
│   ├── checkin/            # 打卡
│   ├── user/               # 用户管理
│   └── report/             # 报告统计
└── project.config.json      # 项目配置
```

## 🎨 自定义配置

### 修改打卡时间范围

编辑 `miniprogram/app.js`：
```javascript
settings: {
  earlyRiseStartTime: '05:00',  // 早起开始时间
  earlyRiseEndTime: '07:30',    // 早起结束时间
  earlySleepStartTime: '19:00', // 早睡开始时间
  earlySleepEndTime: '23:00',   // 早睡结束时间
  sleepReminder: '22:30'        // 入睡提醒时间
}
```

### 修改积分规则

编辑 `cloudfunctions/checkin/index.js`：
```javascript
if (type === 'earlyRise') {
  points = 10;  // 早起积分
} else if (type === 'earlySleep') {
  points = 15;  // 早睡积分
}
```

### 修改徽章条件

编辑 `cloudfunctions/checkin/index.js` 中的 `checkBadges` 函数。

## 🔧 常见问题

### Q: 云函数调用失败？
A: 检查：
1. 云函数是否上传成功
2. 环境 ID 是否正确
3. 数据库集合是否创建

### Q: 打卡时间验证不生效？
A: 检查手机系统时间是否正确，打卡验证基于本地时间。

### Q: 如何添加订阅消息提醒？
A: 
1. 在小程序后台申请订阅消息模板
2. 在打卡成功时调用 `wx.requestSubscribeMessage`
3. 云函数中调用 `cloud.openapi.subscribeMessage.send`

### Q: 审核被拒怎么办？
A: 常见原因：
- 功能描述不清晰 → 详细说明打卡功能
- 隐私政策缺失 → 添加隐私保护指引
- 类目选择错误 → 选择「工具 - 效率」或「健康 - 健康管理」

## 📞 技术支持

遇到问题可参考：
- 微信小程序官方文档：https://developers.weixin.qq.com/miniprogram/dev/framework/
- 微信云开发文档：https://developers.weixin.qq.com/miniprogram/dev/wxcloud/basis/getting-started.html

## 📝 版本历史

- **v1.0.0** (2026-03-22) - 初始版本
  - 基础打卡功能
  - 数据统计
  - 成就系统
  - 小组功能

## 🎯 后续迭代计划

- **v1.1** - AI 解梦功能
- **v1.2** - 智能手环数据同步
- **v1.3** - 企业版健康仪表盘

---

**祝你发布顺利！🎉**