# 积分宝

**Repository Path**: enterprise2021/integral-treasure

## Basic Information

- **Project Name**: 积分宝
- **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-05-17
- **Last Updated**: 2026-06-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 积分宝 - 儿童积分管理系统

一个面向家庭的儿童积分激励管理系统，通过积分奖励机制帮助家长培养孩子良好的行为习惯。

## ✨ 功能特性

- 👶 **孩子管理** - 添加、编辑、删除孩子信息
- 🏆 **积分管理** - 积分奖励、扣除、记录查询
- 📋 **行为规则** - 自定义奖励和惩罚规则
- 🎁 **奖品兑换** - 奖品管理和积分兑换
- 📊 **数据统计** - 积分统计和排行榜
- 📈 **成长曲线** - 积分趋势图表展示

## 🛠️ 技术栈

- **前端**: Vue 3 + Vue Router + Element Plus + Chart.js
- **后端**: Flask + SQLAlchemy（模块化架构）
- **数据库**: SQLite (轻量化文件数据库)

## 📁 项目结构

```
积分宝/
├── README.md                    # 项目说明文档
├── 需求文档.md                  # 需求和技术设计文档
├── .gitignore                   # Git忽略配置
│
├── backend/                     # Flask后端
│   ├── app.py                   # 应用入口
│   ├── config.py                # 配置文件
│   ├── requirements.txt         # Python依赖
│   ├── .env.example             # 环境变量示例
│   ├── instance/                # 数据库存储目录
│   │   └── database.db
│   ├── app/                     # 应用包
│   │   ├── __init__.py         # 工厂函数
│   │   ├── models/             # 数据模型
│   │   │   ├── __init__.py
│   │   │   ├── child.py
│   │   │   ├── point_record.py
│   │   │   ├── rule.py
│   │   │   ├── reward.py
│   │   │   └── exchange.py
│   │   ├── routes/             # 路由蓝图
│   │   │   ├── __init__.py
│   │   │   ├── children.py
│   │   │   ├── points.py
│   │   │   ├── rules.py
│   │   │   ├── rewards.py
│   │   │   ├── exchanges.py
│   │   │   └── ranking.py
│   │   └── utils/              # 工具函数
│   │       └── __init__.py
│   └── scripts/                 # 脚本目录
│       ├── init_db.py           # 数据库初始化
│       └── add_test_data.py     # 测试数据生成
│
├── frontend/                    # Vue前端
│   ├── index.html
│   ├── package.json
│   ├── vite.config.js
│   ├── .env.example             # 环境变量示例
│   ├── .eslintrc.js             # ESLint配置
│   ├── .prettierrc              # Prettier配置
│   └── src/
│       ├── main.js             # 入口文件
│       ├── App.vue             # 根组件
│       ├── router/             # 路由配置
│       │   └── index.js
│       ├── api/                # API封装
│       │   └── index.js
│       └── views/              # 页面组件
│           ├── HomeView.vue
│           ├── ChildrenView.vue
│           ├── PointsView.vue
│           ├── RulesView.vue
│           ├── RewardsView.vue
│           ├── ExchangeView.vue
│           └── RankingView.vue
│
└── miniprogram/                # 微信小程序
    ├── app.js                  # 应用入口
    ├── app.wxss               # 全局样式
    ├── pages.json             # 页面配置
    ├── project.config.json     # 项目配置
    ├── utils/                  # 工具函数
    │   └── api.js
    ├── static/                 # 静态资源
    │   └── icons/
    ├── pages/                  # 页面组件
    │   ├── index/
    │   ├── children/
    │   ├── points/
    │   ├── rules/
    │   ├── rewards/
    │   ├── exchange/
    │   └── ranking/
    ├── scripts/                # 构建脚本
    │   └── generate-icons.js
    └── 小程序上线指南.md      # 上线流程文档
```

## 🚀 快速开始

### 环境要求

- Python 3.8+
- Node.js 16+
- npm 或 yarn

### 运行步骤

#### 1. 克隆项目

```bash
git clone https://gitee.com/enterprise2021/integral-treasure.git
cd integral-treasure
```

#### 2. 启动后端服务

```bash
cd backend
pip install -r requirements.txt
python app.py
```

后端服务默认运行在 http://localhost:5000

**注意**：首次启动会自动创建数据库并初始化默认数据。

#### 3. 启动前端服务

打开新终端：

```bash
cd frontend
npm install
npm run dev
```

前端服务默认运行在 http://localhost:5173

#### 4. 访问应用

打开浏览器访问 http://localhost:5173

## 🗄️ 数据库初始化

### 自动初始化（推荐）

首次启动后端时，系统自动：
- 创建 `instance/database.db` 数据库文件
- 创建所有表结构
- 添加默认行为规则（8条）
- 添加默认奖品（5个）

### 手动初始化

如需重置数据库：

```bash
cd backend
python scripts/init_db.py
```

### 添加测试数据

用于开发测试：

```bash
cd backend
python scripts/add_test_data.py
```

## 🔧 配置说明

### 后端环境变量

复制 `backend/.env.example` 为 `.env` 并修改：

```env
FLASK_APP=app.py
FLASK_ENV=development
SECRET_KEY=your-secret-key
DATABASE_URI=sqlite:///instance/database.db
```

### 前端环境变量

复制 `frontend/.env.example` 为 `.env` 并修改：

```env
VITE_API_BASE_URL=http://localhost:5000/api
```

## 📝 代码规范

### 前端代码格式化

```bash
cd frontend

# 检查代码格式
npm run lint

# 自动修复格式问题
npm run lint:fix

# 格式化代码
npx prettier --write src/
```

## 📱 功能模块

| 页面 | 路径 | 功能 |
| :--- | :--- | :--- |
| 首页 | / | 积分概览、今日之星、积分成长曲线 |
| 孩子管理 | /children | 孩子列表、添加/编辑/删除 |
| 积分记录 | /points | 积分变动历史、统计图表 |
| 规则管理 | /rules | 行为规则管理 |
| 奖品管理 | /rewards | 奖品列表、库存管理 |
| 兑换中心 | /exchange | 奖品兑换 |
| 排行榜 | /ranking | 积分排行榜 |

## 📜 许可证

MIT License

---

**项目地址**：https://gitee.com/enterprise2021/integral-treasure