📚 学伴

小学 1～5 年级 · 全科学习辅助平台

Node.js + Express React / Vue betterbaby‑ui SQLite Docker / PM2

🌟 项目定位

部署在家庭局域网内的轻量级 Web 学习平台，Pad / 电脑浏览器直接打开，免安装。 不替代课堂，只做 课后巩固、假期预习、专项突破，培养习惯，可视化成长。

🧸 陪伴不灌输
📖 同步教材
📊 成长可见

📅 各年级核心功能

🧒 一年级 · 习惯养成期
语文 识字闯关（300字+笔顺动画）、拼音启蒙、课文听读、每日听写
数学 数感培养（1-20）、10/20以内加减、图形认知
习惯 番茄钟（15/5）、每日任务卡打卡
🧒 二年级 · 基础夯实期
语文 识字进阶（850字）、形近字辨析、看图写话、课文背诵辅助
数学 表内乘除、100以内加减竖式、长度单位估测
英语 字母认知（发音/笔顺）、主题词汇（颜色/数字/动物）
🧒 三年级 · 分水岭期
语文 分级阅读+阅读理解、作文提纲生成、古诗75首
数学 分数可视化（披萨图）、面积/周长、时间计算
英语 词汇拓展（每单元20-30词）、情景对话、课文点读
🧒 四年级 · 能力提升期
语文 非连续性文本、批注式阅读、AI辅助润色作文
数学 小数意义/加减、三角形分类/内角和、简便运算
英语 一般现在/进行时、短篇阅读理解
🧒 五年级 · 小高衔接期
语文 小古文入门、群文阅读、议论文初步
数学 分数乘除算理、方程入门、立体几何（3D展开图）、因数倍数
英语 时态综合（过去/将来）、英语小作文模板

🔧 通用功能（全年级）

📊 成长树可视化
📈 学习周报/月报
🔥 薄弱点热力图
📕 自动错题本+打印
🎖️ 积分/勋章系统
📅 连续打卡
🛡️ 家长控制（时长/时段/内容）
👨‍👩‍👧‍👦 多孩支持

🛠️ 技术栈

前端

  • React 19 + TypeScript / Vue 3（二选一）
  • Vite 构建工具
  • betterbaby‑ui（儿童专用组件库）
  • Tailwind CSS
  • React Router / Vue Router
  • Axios、Zustand / Pinia

后端 & 部署

  • Node.js LTS + Express
  • SQLite（轻量）/ MySQL
  • JWT + bcrypt 认证
  • Docker Compose / PM2
  • Nginx（可选）
  • 部署在树莓派 / NUC / 旧电脑
关键库： hanzi-writer（笔顺）, pinyin-pro（拼音）, howler.js（音频）, chart.js（图表）, pdf-lib（导出PDF）

✅ 开发任务清单（按阶段）

🚩 第一阶段 – MVP（2～3周）

  • 初始化项目：前端（Vite+React/Vue）+ 后端（Express+SQLite）
  • 用户模型：家长账号 + 孩子子账号（JWT 登录）
  • 一年级语文：识字模块（集成 HanziWriter 笔顺动画）+ 拼音认读
  • 一年级数学：10以内加减法口算（随机出题 + 计时）
  • 家长控制：每日使用时长设置（超时锁屏）
  • Dockerfile 编写，实现一键部署

🚩 第二阶段 – 核心扩展（4～6周）

  • 补齐 2～5 年级语文功能（识字进阶、阅读、作文、古诗）
  • 补齐 2～5 年级数学功能（乘除、分数、面积、方程、几何）
  • 错题本系统（自动收录 + 分类 + 重练推送）
  • 学习数据看板（成长树 SVG 动画 + 周报/月报图表）
  • 积分与勋章系统（任务完成自动发放）

🚩 第三阶段 – 英语 + 完善（3～4周）

  • 3～5 年级英语模块（词汇、听力、情景对话、点读）
  • 支持多个孩子独立学习记录
  • 家长控制中心完整版（时段管控、内容开关）
  • 学习报告 PDF 导出（含错题、掌握度）

🚩 第四阶段 – 优化迭代（持续）

  • 全面应用 betterbaby‑ui，优化儿童交互体验
  • 性能优化（懒加载、缓存、首屏速度）
  • 根据真实使用反馈调整功能难度与趣味性

🏠 局域网部署架构

家庭路由器 (192.168.1.1) │ ├── Pad / 电脑 / 手机 (浏览器访问 http://192.168.1.100) │ └── 小主机 / 树莓派 (192.168.1.100) ├── Docker Compose 或 PM2 ├── 前端静态服务 (Nginx 或 Node) ├── 后端 API (Express, 端口 3001) └── SQLite 数据库 (持久化到本地卷)

✨ 全离线运行，数据不出家门，家长手机也能随时查看学习报告。

📎 参考资源