1、立项原因：中小学班级管理普遍依赖纸质名单、口头点名和手工排座，学生信息、座位表与课堂评价数据分散在不同载体，排座调座效率低、课堂互动缺乏数字化留痕，且教室终端存在 Windows 与国产 Linux 并存的情况，原有工具难以跨平台统一交付，因此立项建设一体化的班级助手。
2、行业场景：面向中小学校日常课堂教学与班级管理，服务于班主任及任课教师的学生管理、随机点名、可视化排座、课堂评价与成绩统计工作，对接校园服务端统一管理班级、学生、座位和评价数据，适配 Windows 与信创 Linux 终端混合部署的教育信息化业务环境。
1、功能模块：包含登录与设备绑定、首页、班级中心、学生管理、座位编辑、随机抽选、课堂评价与成绩统计、AI 辅助、版本升级及主题设置等模块。
2、主要功能：支持账号密码与扫码登录，按设备序列号完成班级与终端一对一绑定，可创建、解散和切换班级；学生管理支持单个与批量添加、姓名双击编辑、删除、照片上传、拼音首字母检索及 AIGC 生成头像；座位编辑支持可视化拖拽排座、整行整列增删与座位绑定差量提交；随机抽选以倒计时方式抽取学生并可直接发起课堂评价，成绩统计汇总班级总分及表扬、待改进分数，支持评价撤销与分数清空；AI 模块提供会话、流式响应及文案与提示词润色；同时提供 OTA 检测升级、双主题切换与操作指引。
1、我负责的具体任务：作为客户端核心开发，负责跨平台桌面端整体架构与核心交互控件自研，包括首页与班级中心（班级信息、学生信息、成绩统计）页面、学生管理（单个与批量添加、拼音检索、照片上传与 AIGC 生成头像）、座位编辑控件的可视化拖拽排座、随机抽选与课堂评价链路，以及主题资源、扫码登录、设备绑定、OTA 升级和 Windows、Linux（UOS/loongarch64）双端打包发布，界面严格按 Figma 设计稿及节点编号落地。
2、技术栈与架构：采用 Avalonia UI 12.1 + .NET 8，MVVM（CommunityToolkit.Mvvm 8.4）配合依赖注入分层，视图、视图模型与 ApiRequest/Auth/Student/Main/Dialog 等服务解耦；以 RestSharp 与 Newtonsoft.Json 对接校园服务端，Serilog 记录日志，SkiaSharp 渲染，集成阿里云 OSS、QRCoder 扫码与 AIGC 流式接口，appsettings.json 统一管理服务地址、版本与主题。实现难点：Windows 与信创 Linux 双端渲染及打包一致性（Win32/X11 适配、Inno Setup 与 deb 双链路）；座位表拖拽中 UniformGrid 行列取整误差、长按与点击判定（500ms 长按、8px 容差）、整行整列增删后的座位绑定差量提交，以及异步加载学生数据时的 UI 线程调度；百人名单采用 x:DataType 编译绑定与 ObservableCollection 增量更新保障流畅。亮点：拖拽视觉层独立顶层画布、拼音首字母检索、AI 生成头像与文案润色、扫码登录配合设备 SN 与班级一对一绑定，形成课堂评价到成绩统计的数据闭环。
评论