cfc

知行益家 - 小程序

项目简介

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

技术栈

层级	技术
前端	微信小程序原生开发
后端	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. 数据库初始化

# 创建数据库
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：

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

4. 启动后端

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

或直接在IDE中运行 ZhixingyijiaApplication.java

5. 配置小程序

1. 在微信公众平台注册小程序获取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