# 必杀吧-积分变身

**Repository Path**: mtus22/kids-score-miniprogram

## Basic Information

- **Project Name**: 必杀吧-积分变身
- **Description**: 给家长和小朋友用的积分累计和兑换系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-14
- **Last Updated**: 2026-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 必杀吧！积分变身 🏆

> 用积分鼓励孩子养成好习惯——微信小程序，全家一起用。

一个小而美的家庭积分管理系统，家长给孩子设置加分项，完成任务加分，攒够分数兑换心仪的礼物。

## ✨ 功能

- **多孩子支持** — 每个孩子独立积分
- **家庭协作** — 爸爸、妈妈、家人一起参与加分
- **自定义加分项** — 自己设置：自己洗澡、整理房间、主动写作业……
- **物品兑换** — 孩子攒分兑换喜欢的礼物
- **积分流水** — 清楚知道每天加了什么分、换了什么奖
- **自定义兑换物品** — 添加照片、设置积分、管理库存
- **内容安全** — 集成微信内容安全检测，保障合规
- **管理员后台** — 家庭管理、数据总览

## 📱 使用流程

1. 🏠 **创建家庭** → 生成邀请码
2. 🔑 **家庭成员加入** → 输入邀请码
3. 👶 **添加孩子** → 设置孩子姓名
4. ⭐ **日常加分** → 孩子表现好就加分
5. 🎯 **攒分兑换** → 攒够分数换礼物

## 🛠️ 技术栈

- **前端**：微信小程序原生（WXML + WXSS + JS）
- **后端**：微信云开发（云函数 + 云数据库）
- **存储**：云存储（头像、物品照片）
- **安全**：微信云调用 `security.msgSecCheck` / `imgSecCheck`
- **认证**：微信云函数 `wxContext.OPENID`

## 📁 项目结构

```
├── app.json / app.js / app.wxss      # 小程序入口
├── logo.svg                           # 应用图标
├── utils/
│   └── db.js                          # 数据库工具（所有V3数据操作）
├── pages/
│   ├── guide/                         # 首页 - 创建/加入家庭
│   ├── index/                         # 首页 - 积分仪表盘
│   ├── addScore/                      # 加分页面
│   ├── scoreHistory/                  # 积分流水
│   ├── goods/                         # 物品超市
│   ├── exchange/                      # 积分兑换
│   ├── exchangeHistory/               # 兑换记录
│   ├── addGoods/                      # 添加物品
│   ├── settings/                      # 设置（孩子管理、密码、加分项）
│   │   └── editReasons/              # 编辑加分项
│   ├── createFamily/                  # 创建家庭
│   ├── joinFamily/                    # 加入家庭
│   ├── admin/                         # 管理员后台
│   └── guide/guideOnboard/            # 新手指引
├── cloudfunctions/
│   ├── login/                         # 获取用户openid
│   ├── secCheck/                      # 内容安全检测
│   └── updateFamily/                  # 家庭数据操作（邀请码、密码、成员）
└── README.md
```

## 🗄️ 数据库集合

| 集合 | 说明 |
|------|------|
| `families_v3` | 家庭信息、成员、邀请码 |
| `children_v3` | 孩子信息 |
| `scores_v3` | 加分记录 |
| `score_reasons_v3` | 自定义加分项模板 |
| `goods_v3` | 可兑换物品 |
| `exchanges_v3` | 兑换记录 |
| `admin_config_v3` | 管理员密码 |

## 🚀 部署

1. 在微信开发者工具打开项目
2. 修改 `project.config.json` 中的 `appid` 为你的 AppID
3. 右键 `cloudfunctions/` 下的各个云函数 → 上传并部署
4. 在云开发控制台创建上述数据库集合
5. 编译运行

## 👨‍👩‍👦 开发者说

这个项目是为我家孩子做的。曾经只存在于脑海里的想法，借助微信生态的能力变成了现实——不花一分钱服务器费用，全家一起用。源码开源，供有同样需求的朋友参考或使用。