MiraClass

MiraClass 是一个以 Windows 桌面端为主的班级积分管理应用，使用 Flutter、Riverpod、Drift(SQLite) 构建。

当前功能

• 学生与分组管理
  • 学生/分组增删改查
  • 学生搜索与分组筛选
  • 分组拖拽排序
• 积分系统
  • 学生/分组加减分
  • 行为模板管理
  • 历史记录筛选与 24 小时内撤销
• 随机抽人
  • 全班 / 分组 / 自定义名单
  • 排除最近 N 次
  • 连抽多人且不放回
  • 结果可直接带入加减分
• 统计看板
  • Dashboard 摘要
  • 前 10 排行
  • 近 7 天趋势
  • 分组占比
• 设置与数据工具
  • 班级名称、教师姓名、积分单位
  • 主题、深色模式、音效开关与音量
  • 学生名单导入（CSV / XLSX）
  • 原始记录 CSV 导出
  • PDF 报告导出
  • 数据库备份、恢复、积分清零

运行环境

• 主平台：Windows Desktop
• 次平台：Android / iOS
• Flutter 3.x
• Dart 3.x

本地运行

cd MiraClass
flutter pub get
flutter run -d windows

常用命令

cd MiraClass
dart run build_runner build --delete-conflicting-outputs
dart analyze
flutter test
flutter build windows

数据备份与恢复

• 备份文件格式为 .db
• Windows 桌面端通过文件选择器选择备份或恢复路径
• 恢复数据库后，应用会自动重新加载数据，无需手动重启
• 积分清零只会清空积分记录并归零总分，不会删除学生、分组、模板和设置

项目结构

主要应用代码位于：

• MiraClass/lib/
• MiraClass/assets/
• MiraClass/test/

技术栈

• Flutter
• flutter_riverpod / riverpod_generator
• Drift + SQLite
• go_router
• fl_chart
• excel / pdf / printing / file_picker / shared_preferences

说明

• 当前仓库优先保证 Windows 桌面端体验与可维护性
• 音效逻辑已保留，但默认支持无音频资源时静默降级