食养打卡小程序

道家养生 + 食养文化的社群打卡工具，帮助学员养成每日食养和养生习惯。

功能特性

打卡系统

• ✅ 拍照打卡
• ✅ 模板打卡（早餐/午餐/晚餐、食物名称、食材搭配、感受/状态、练习时长）
• ✅ 连续打卡统计

社群功能

• ✅ 打卡圈（浏览、点赞、评论）
• ✅ 排行榜（连续天数/总天数）
• ✅ 小组/班级管理

课程管理

• ✅ 作业/任务系统
• ✅ 积分奖励

技术栈

层级	技术方案
小程序	原生微信小程序 + WeUI
后端	Node.js + Express
数据库	MongoDB
图片存储	七牛云/阿里云OSS

项目结构

shiyang-daka/
├── miniapp/              # 微信小程序前端
│   ├── pages/           # 页面
│   │   ├── index/       # 首页
│   │   ├── checkin/     # 打卡页
│   │   ├── circle/      # 打卡圈
│   │   ├── rank/        # 排行榜
│   │   ├── me/          # 我的
│   │   └── task/        # 作业任务
│   ├── components/      # 组件
│   └── utils/           # 工具函数
├── backend/             # 后端服务
│   ├── models/          # 数据模型
│   ├── routes/          # API路由
│   └── server.js        # 入口文件
└── SPEC.md              # 设计文档

快速开始

1. 配置后端

cd backend
npm install

# 创建 .env 文件
cp .env.example .env
# 编辑 .env，配置 MongoDB 和微信参数

# 启动服务
npm run dev

2. 配置小程序

// miniapp/app.js
// 修改 API 地址
globalData: {
  apiBase: 'https://your-domain.com/api'
}

3. 导入微信开发者工具

1. 下载 微信开发者工具
2. 新建项目，选择 miniapp 目录
3. 填入小程序 AppID

环境变量

# .env
PORT=3000
MONGODB_URI=mongodb://localhost:27017/shiyang-daka
JWT_SECRET=your-secret-key
WX_APPID=your-wechat-appid
WX_SECRET=your-wechat-secret

API 接口

方法	路径	说明
POST	/api/auth/login	微信登录
GET	/api/auth/user	获取用户信息
PUT	/api/auth/user	更新用户信息
POST	/api/checkin	提交打卡
GET	/api/checkin	获取打卡列表
GET	/api/checkin/rank	获取排行榜
POST	/api/checkin/:id/like	点赞
POST	/api/checkin/:id/comment	评论
GET	/api/task	获取作业列表
POST	/api/task/:id/submit	提交作业

下一步

• 接入七牛云/阿里云OSS图片上传
• 实现定时打卡提醒推送
• 添加签到日历功能
• 实现班主任/组长管理后台

---

祝你开发顺利！