Skip to content

MiraEvo/MiraClass

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 桌面端体验与可维护性
  • 音效逻辑已保留,但默认支持无音频资源时静默降级

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors