# MathBaby

**Repository Path**: flvf/MathBaby

## Basic Information

- **Project Name**: MathBaby
- **Description**: MathBaby是一个解决孩子数学测练烦恼，多维度分析孩子的知识掌握情况的数学测练工具。孩子每一步的成长，都清晰可见。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-17
- **Last Updated**: 2026-04-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MathBaby（数学测练系统）

一个面向孩子日常数学练习/测验的轻量小工具：家长可以自主维护题库，系统会记录每一次测练的作答过程与结果，并用更直观的学习报告展示孩子的进步，减少纸张出题与手工统计的繁琐。

技术栈：Spring Boot + MyBatis-Plus + MySQL + HTML/CSS/JS（静态页面）

## 核心能力
- 自主题库：支持题库管理与导入（CSV 模板）
- 两种模式：练习 / 测验（测验支持限时）
- 自动判分：提交后判分入库，保留每次测练记录
- 错题沉淀：自动汇总错题，可标记掌握情况
- 学习报告：趋势折线图 + 练习详情，直观看到变化

## 页面预览

![主页](img/主页.png)

![开始练习](img/开始练习.png)

![练习](img/练习.png)

![测验](img/测验.png)

![测练详情](img/测练详情.png)

![学习报告](img/学习报告.png)

![错题本](img/错题本.png)

![题库管理](img/题库管理.png)

## 快速开始

### 1) 环境要求
- JDK 8+（推荐 8/11/17 均可）
- Maven 3.8+
- MySQL 8+

### 2) 初始化数据库
1. 在 MySQL 中执行 `sql/init.sql`
2. 修改 `src/main/resources/application.yml` 的数据库连接信息（至少确认 `url/username/password`）

### 3) 启动项目
```bash
mvn spring-boot:run
```

启动后访问：
- 首页：`http://localhost:8080/`
- 登录：`http://localhost:8080/login.html`
- 报告：`http://localhost:8080/report.html`
- 错题本：`http://localhost:8080/wrongbook.html`
- 题库管理（管理员页面）：`http://localhost:8080/admin/questions.html`

## 题库维护

- CSV 导入说明：见 [题库CSV导入说明.md](docs/题库CSV导入说明.md)
- 导入模板：`src/main/resources/static/templates/questions_import_template.csv`
- 示例题库：`题库/` 目录下提供了若干 CSV（可直接用于导入）
- 可以将CSV导入说明给到AI，然后让AI按你的题库要求（例如：凑十法、20以内加减法等）根据说明文档生成CSV文件

## 使用建议

- 内置管理员账号：`admin/123456`
- 先导入题库再开始练习/测验，数据积累后报告页更直观

## License

Apache License 2.0