# math_course

**Repository Path**: allmyteacher/math_course

## Basic Information

- **Project Name**: math_course
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-27
- **Last Updated**: 2026-04-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 📚 人教版小学数学多媒体课件

> 卡通动画 · 内容详实 · 贴近课本 · 多媒体互动

![版本](https://img.shields.io/badge/版本-v1.0.0-blue)
![年级](https://img.shields.io/badge/年级 -3-6 年级-green)
![技术栈](https://img.shields.io/badge/技术栈-HTML5%2BCSS3%2BJS-orange)

---

## 📖 项目简介

本项目是人教版小学 3-6 年级数学多媒体课件系统，采用 H5 原生技术打造，具有以下特点：

### ✨ 核心特色

- **🎨 卡通动画风格** - 生动有趣的视觉效果，激发学习兴趣
- **📱 全平台适配** - 完美兼容手机、平板、电脑
- **📄 PDF 一键导出** - 方便教师和学生下载、传阅、打印
- **📝 智能测验系统** - 随堂测验、单元测试、期中期末考试
- **🔗 统一导航入口** - HTML 链接互相跳转，结构清晰
- **📊 丰富图片资源** - 贴近课本，参考主流教辅

---

## 📁 目录结构

```
primary-math-ppt/
├── index.html              # 统一入口首页
├── nginx.conf              # Nginx 配置文件
├── docker-compose.yml      # Docker 部署配置
├── README.md               # 项目说明文档
├── assets/                 # 静态资源
│   ├── css/               # 样式文件
│   │   ├── style.css      # 主样式表
│   │   └── animate.css    # 动画效果库
│   ├── js/                # JavaScript 文件
│   │   └── main.js        # 主功能脚本
│   ├── images/            # 图片资源
│   └── audio/             # 音频资源
├── grades/                # 年级课件
│   ├── 3/                 # 三年级
│   │   ├── index.html     # 三年级首页
│   │   ├── unit1/         # 第一单元：时、分、秒
│   │   ├── unit2/         # 第二单元：万以内的加减法
│   │   ├── midterm/       # 期中考试
│   │   └── final/         # 期末考试
│   ├── 4/                 # 四年级
│   ├── 5/                 # 五年级
│   └── 6/                 # 六年级
└── quiz/                  # 测验中心
    └── index.html         # 测验首页
```

---

## 🚀 快速开始

### 方式一：直接打开（开发/本地使用）

```bash
# 直接用浏览器打开 index.html
open index.html
# 或
xdg-open index.html
```

### 方式二：Nginx 部署（生产环境）

```bash
# 1. 复制配置文件
sudo cp nginx.conf /etc/nginx/sites-available/primary-math-ppt

# 2. 创建软链接
sudo ln -s /etc/nginx/sites-available/primary-math-ppt /etc/nginx/sites-enabled/

# 3. 测试配置
sudo nginx -t

# 4. 重启 Nginx
sudo systemctl restart nginx
```

### 方式三：Docker 部署（推荐）

```bash
# 一键启动
docker-compose up -d

# 查看状态
docker-compose ps

# 访问 http://localhost
```

### 方式四：Python 简易服务器

```bash
# Python 3
python3 -m http.server 8080

# 访问 http://localhost:8080
```

---

## 📱 功能模块

### 1. 统一入口首页

- 年级选择（3-6 年级）
- 快速导航（随堂测验、单元测试、期中期末）
- 搜索功能
- 特色功能展示

### 2. 课件系统

每个单元包含：
- 📖 知识点讲解
- 🎯 例题解析
- ⚠️ 易错点提示
- 📝 随堂测验
- 💪 课后练习
- 🎓 知识总结

### 3. 测验系统

- **随堂测验** - 学完即测，即时反馈
- **单元测试** - 巩固单元知识
- **期中考试** - 综合测试前半学期
- **期末考试** - 全册综合测试

### 4. PDF 导出

所有页面支持：
- 一键导出 PDF
- 打印友好样式
- 保持卡通风格

---

## 🎨 设计规范

### 配色方案

| 用途 | 颜色 | 色值 |
|------|------|------|
| 主色 | 红色 | #FF6B6B |
| 辅色 | 青色 | #4ECDC4 |
| 强调色 | 黄色 | #FFE66D |
| 成功色 | 绿色 | #95E1D3 |
| 警告色 | 橙色 | #FFD93D |

### 年级配色

- 三年级：🌟 #FF9FF3（粉色）
- 四年级：🚀 #54A0FF（蓝色）
- 五年级：💫 #5F27CD（紫色）
- 六年级：🎯 #00D2D3（青色）

### 字体

- 主字体：Comic Sans MS（卡通风格）
- 备用：Microsoft YaHei, PingFang SC

---

## 📋 已完成的课件

### 三年级上册（示例）

| 单元 | 主题 | 状态 |
|------|------|------|
| 第一单元 | 时、分、秒 | ✅ 完成 |
| 第二单元 | 万以内的加法和减法 | 📁 待填充 |
| 第三单元 | 测量 | 📁 待填充 |
| 第四单元 | 万以内的加法和减法（二） | 📁 待填充 |
| 第五单元 | 倍的认识 | 📁 待填充 |
| 第六单元 | 多位数乘一位数 | 📁 待填充 |
| 第七单元 | 长方形和正方形 | 📁 待填充 |
| 第八单元 | 分数的初步认识 | 📁 待填充 |
| 期中 | 期中考试卷 | ✅ 完成 |
| 期末 | 期末考试卷 | ✅ 完成 |

### 四、五、六年级

目录结构已创建，可参照三年级模板快速填充内容。

---

## 🛠️ 扩展指南

### 添加新单元

1. 在对应年级目录下创建单元文件夹
2. 复制 `grades/3/unit1/index.html` 作为模板
3. 修改内容和题目
4. 更新导航链接

### 添加新年级

1. 复制 `grades/3/` 目录
2. 重命名为对应年级
3. 修改首页内容和配色
4. 更新主入口链接

### 自定义样式

- 修改 `assets/css/style.css` 中的 CSS 变量
- 添加新的动画效果到 `animate.css`
- 调整响应式断点

---

## 📊 技术特性

### 响应式设计

- 移动端优先（Mobile First）
- 支持 480px、768px、1200px 断点
- 触摸友好的交互设计

### 性能优化

- 纯静态页面，无需后端
- CSS/JS 压缩（生产环境）
- 浏览器缓存策略
- Gzip 压缩支持

### 可访问性

- 语义化 HTML
- 键盘导航支持
- 打印友好样式
- 字体大小可调

---

## 📝 使用建议

### 教师使用

1. **课堂展示** - 投影或电子白板直接打开课件
2. **布置作业** - 导出 PDF 发给学生打印
3. **组织测验** - 使用随堂测验即时检测
4. **复习备考** - 期中期末试卷模拟练习

### 学生使用

1. **课前预习** - 提前浏览课件内容
2. **课后复习** - 回顾知识点和例题
3. **自我检测** - 完成随堂测验
4. **打印学习** - 导出 PDF 做笔记

### 家长使用

1. **辅导孩子** - 查看课件了解学习内容
2. **打印练习** - 导出试卷给孩子练习
3. **跟踪进度** - 查看测验结果

---

## 🔧 常见问题

### Q: 如何在手机上使用？

A: 本项目采用响应式设计，自动适配手机屏幕。可以直接在浏览器中打开，或部署到服务器后通过手机访问。

### Q: PDF 导出功能如何使用？

A: 每个课件页面都有"导出 PDF"按钮，点击即可生成 PDF 文件。也可以使用浏览器的打印功能（Ctrl+P）另存为 PDF。

### Q: 如何添加更多题目？

A: 编辑对应 HTML 文件，复制 `.quiz-question` 块，修改题目内容和答案即可。

### Q: 可以离线使用吗？

A: 可以！所有文件都是静态的，下载到本地后直接用浏览器打开即可，无需联网（PDF 导出功能首次需要加载库文件）。

---

## 📄 许可证

本项目仅供教育教学使用。

---

## 👥 开发团队

**结构化研发团队** 🏗️

- 产品负责人（PO）
- 项目经理（PM）
- 系统架构师
- 前端工程师
- 后端工程师
- DevOps 工程师

---

## 📞 技术支持

如有问题或建议，欢迎反馈！

---

> **Build it right, ship it fast.** 🚀

最后更新：2026-03-24  
版本：v1.0.0