cfc

知行益家 (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

项目结构

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

快速开始

1. 环境准备

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

2. 数据库初始化

mysql -u root -p
CREATE DATABASE cfc CHARACTER SET utf8mb4;

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

3. 启动后端

cd cfc-backend
mvn clean install
mvn spring-boot:run

4. 启动小程序前端

cd cfc-frontend
npm install
npm run dev:mp-weixin

5. 启动Web管理端

cd cfc-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	录入测评结果

测试

cd cfc-backend
mvn test

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

开发规范

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

开发团队

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

许可证

MIT License