# 知行益家 (ZXYJ) - 家庭教育任务管理小程序

## 项目简介

知行益家是一款家庭教育任务管理小程序，通过积分奖励机制激励孩子自主完成任务，培养时间管理和延迟满足能力。支持家长端、孩子端、成长规划师（Web端）三端使用。

## 技术栈

| 层级 | 技术 |
|------|------|
| 后端 | Java 1.8 + Spring Boot 2.7.18 + MyBatis-Plus |
| 前端小程序 | uni-app (Vue 2) |
| Web管理端 | Vue 2 + Element UI |
| 数据库 | MySQL 8.0 |
| 认证 | JWT |
| 文档 | Swagger 3.0 |

## 项目结构

```
zxyj/
├── zxyj-backend/                    # Java后端服务
│   ├── src/main/java/com/zxyj/
│   │   ├── controller/             # REST API (按功能分组)
│   │   │   ├── admin/              # 管理端接口
│   │   │   ├── auth/               # 认证接口
│   │   │   ├── guide/              # 成长规划师接口
│   │   │   ├── task/               # 任务接口
│   │   │   ├── reward/             # 奖励接口
│   │   │   └── assessment/         # DAN评估接口
│   │   ├── service/                # 业务逻辑
│   │   ├── mapper/                 # MyBatis Mapper
│   │   ├── entity/                 # 数据实体
│   │   ├── dto/                    # 数据传输对象
│   │   └── config/                 # 配置类
│   └── src/main/resources/
│       ├── application.yml         # 配置文件
│       └── schema.sql              # 数据库初始化
│
├── zxyj-frontend/                   # 微信小程序前端
│   ├── pages/                      # 页面组件
│   │   ├── index/                  # 首页（角色分流）
│   │   ├── parent/                # 家长端
│   │   ├── child/                 # 孩子端
│   │   ├── teacher/               # 成长规划师端
│   │   ├── assessment/            # DAN评估
│   │   └── tasks/                 # 任务相关
│   ├── utils/                     # 工具函数
│   └── pages.json                 # 页面注册
│
├── zxyj-web/                        # Web管理端
│   └── src/
│       ├── views/                  # 页面组件
│       ├── api/                   # API调用
│       └── router/                 # 路由配置
│
└── docs/                           # 项目文档
    ├── 需求分析/                   # 需求分析文档
    ├── 系统设计/                   # 系统设计文档
    └── 系统测试/                   # 测试文档
```

## 快速开始

### 1. 环境准备

- JDK 1.8+
- Maven 3.6+
- MySQL 8.0+
- Node.js 14+ (前端开发)
- 微信开发者工具

### 2. 数据库初始化

```bash
mysql -u root -p
CREATE DATABASE zxyj CHARACTER SET utf8mb4;

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

### 3. 启动后端

```bash
cd zxyj-backend
mvn clean install
mvn spring-boot:run
```

### 4. 启动小程序前端

```bash
cd zxyj-frontend
npm install
npm run dev:mp-weixin
```

### 5. 启动Web管理端

```bash
cd zxyj-web
npm install
npm run serve
```

### 6. 访问API文档

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

## 核心功能

### 已完成

| 功能 | 说明 |
|------|------|
| ✅ 用户认证 | 微信登录、手机验证码登录、JWT认证 |
| ✅ 任务管理 | 创建、执行、审核任务，支持小游戏类任务 |
| ✅ 积分系统 | 完成任务获积分、超时扣分、积分流水 |
| ✅ 奖励体系 | 心愿单、兑换、审批流程 |
| ✅ 双角色切换 | 家长模式/孩子模式即时切换 |
| ✅ 成长规划师 | 套餐管理、家庭绑定、任务下发、DAN评估 |
| ✅ 小游戏任务 | 舒尔特方格、猜数字、数独 |
| ✅ 评估预约 | DAN评估预约、订单管理 |

## 角色系统

- **家长端**：管理孩子、创建任务、审批奖励、查看进度
- **孩子端**：执行任务、完成任务、兑换奖励
- **成长规划师**：服务家庭、创建套餐、下发任务、DAN评估

## API接口（按模块）

### 认证模块

| 接口 | 方法 | 说明 |
|------|------|------|
| /api/auth/phone-login | POST | 手机验证码登录 |
| /api/auth/wechat-login | POST | 微信登录 |
| /api/user/info | POST | 获取用户信息 |

### 任务模块

| 接口 | 方法 | 说明 |
|------|------|------|
| /api/tasks/create | POST | 创建任务 |
| /api/tasks/complete | POST | 完成任务 |
| /api/tasks/review | POST | 审核任务 |
| /api/tasks/minigame-options | POST | 获取小游戏列表 |

### 奖励模块

| 接口 | 方法 | 说明 |
|------|------|------|
| /api/rewards/create | POST | 创建奖励 |
| /api/rewards/approve | POST | 审批奖励 |
| /api/rewards/exchange | POST | 兑换奖励 |

### 成长规划师模块

| 接口 | 方法 | 说明 |
|------|------|------|
| /api/guide/package/create | POST | 创建套餐 |
| /api/guide/families | POST | 绑定家庭列表 |
| /api/guide/task/create | POST | 下发任务 |
| /api/guide/assessment/enable | POST | 启用家庭评估 |

### 评估模块

| 接口 | 方法 | 说明 |
|------|------|------|
| /api/assessment/appointment/create | POST | 创建评估预约 |
| /api/assessment/appointment/confirm | POST | 确认预约 |
| /api/assessment/record/create | POST | 录入测评结果 |

## 测试

```bash
cd zxyj-backend
mvn test
```

测试覆盖：Service层单元测试、集成测试、小游戏任务测试、成长规划师测试

## 开发规范

- 控制器分组：按功能模块分为 admin, auth, guide, task, reward, assessment
- 接口规范：统一使用 `@PostMapping`，禁止 `@GetMapping`
- ORM：使用 MyBatis-Plus 注解
- 响应包装：统一 `Result<T>` 返回
- DI注解：使用 `@Resource`，字段名与 Bean Name 一致

## 开发团队

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

## 许可证

MIT License