# 知行益家 - 小程序

## 项目简介

知行益家是一款家庭教育任务管理小程序，通过积分奖励机制激励孩子自主完成任务，培养时间管理和延迟满足能力。

## 技术栈

| 层级 | 技术 |
|------|------|
| 前端 | 微信小程序原生开发 |
| 后端 | Java 1.8 + Spring Boot 2.7.18 |
| 数据库 | MySQL 8.0 |
| 认证 | JWT |
| 文档 | Swagger 3.0 |

## 项目结构

```
zhixingyijia/
├── backend/                          # Java后端
│   ├── pom.xml                       # Maven配置
│   ├── src/main/java/com/zhixingyijia/
│   │   ├── ZhixingyijiaApplication.java  # 启动类
│   │   ├── common/                   # 公共类（Result, JwtUtil）
│   │   ├── config/                   # 配置类
│   │   ├── controller/              # 控制器
│   │   ├── entity/                  # 实体类
│   │   ├── mapper/                  # MyBatis Mapper
│   │   ├── service/                 # 业务逻辑
│   │   └── dto/                     # 数据传输对象
│   └── src/main/resources/
│       ├── application.yml          # 配置文件
│       └── mapper/                  # MyBatis XML
│
├── miniprogram/                      # 微信小程序前端
│   ├── app.js / app.json / app.wxss # 应用入口
│   ├── pages/                       # 页面
│   │   ├── index/                   # 首页（角色分流）
│   │   ├── login/                   # 登录页
│   │   ├── parent-home/             # 家长端首页
│   │   ├── child-home/              # 孩子端首页
│   │   └── ...                      # 其他页面
│   └── utils/                       # 工具函数
│
├── docs/                            # 文档
│   └── superpowers/
│       ├── specs/                   # 设计文档
│       └── plans/                   # 实现计划
│
└── README.md                        # 本文件
```

## 快速开始

### 1. 环境准备

- JDK 1.8+
- Maven 3.6+
- MySQL 8.0+
- 微信开发者工具

### 2. 数据库初始化

```bash
# 创建数据库
mysql -u root -p
CREATE DATABASE zhixingyijia CHARACTER SET utf8mb4;

# 执行初始化脚本
mysql -u root -p zhixingyijia < backend/src/main/resources/sql/init.sql
mysql -u root -p zhixingyijia < backend/src/main/resources/sql/seed.sql
```

### 3. 配置后端

编辑 `backend/src/main/resources/application.yml`：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/zhixingyijia?...
    username: your_username    # 修改为你的数据库用户名
    password: your_password    # 修改为你的数据库密码
```

### 4. 启动后端

```bash
cd backend
mvn clean package
java -jar target/zhixingyijia-backend-1.0.0.jar
```

或直接在IDE中运行 `ZhixingyijiaApplication.java`

### 5. 配置小程序

1. 在[微信公众平台](https://mp.weixin.qq.com/)注册小程序获取AppID
2. 在微信开发者工具中导入 `miniprogram` 目录
3. 修改 `miniprogram/app.js` 中的 `baseUrl` 为你的后端地址

### 6. 访问API文档

启动后端后，访问：http://localhost:8080/api/swagger-ui.html

## 核心功能

### MVP版本（已完成）

| 功能 | 说明 |
|------|------|
| ✅ 用户认证 | 微信登录、JWT认证 |
| ✅ 任务管理 | 创建、执行、完成任务 |
| ✅ 积分系统 | 完成任务获积分、超时扣分 |
| ✅ 奖励体系 | 心愿单、兑换、审批 |
| ✅ 双模式切换 | 家长模式/孩子模式 |

### 待开发

| 功能 | 优先级 |
|------|--------|
| 连续打卡 | P1 |
| 专注训练 | P1 |
| AI审核 | P1 |
| DAN测评模板 | P1 |
| 勋章墙 | P1 |

## API接口

### 认证接口

| 接口 | 方法 | 说明 |
|------|------|------|
| /api/auth/login | POST | 微信登录 |
| /api/auth/info | GET | 获取用户信息 |

### 任务接口

| 接口 | 方法 | 说明 |
|------|------|------|
| /api/tasks/today/{childId} | GET | 获取今日任务 |
| /api/tasks | POST | 创建任务 |
| /api/tasks/{id}/complete | POST | 完成任务 |
| /api/tasks/{id}/review | POST | 审核任务 |

### 奖励接口

| 接口 | 方法 | 说明 |
|------|------|------|
| /api/rewards/family/{familyId} | GET | 获取家庭奖励 |
| /api/rewards | POST | 创建奖励 |

## 开发团队

- 需求分析：知行益家项目组
- 开发：AI辅助开发

## 许可证

MIT License