学生、任课关系、周次口径三处长期靠约定维持的事情,改为由数据模型保证。 学生不是账号 - 拆出独立 Student 表,没有 passwordHash / role / 任何登录字段 - 「学生不能登录」由表结构保证,不再靠「登录前判 role 再 403」的代码分支 - 三张个人数据表外键 userId → studentId;删掉 Enrollment 与 ClassTeacher - 学生一律称「学号」、教师一律称「工号」,「学生账号」这个概念消失 任课关系唯一来源 = Course(班级 + 科目 + 教师) - 班主任 = Class.teacherId,科任 = Course.teacherId,同一人两处指向同一账号、不重复建号 - 作业与成绩按科目再收一道:挂科目只由该科任课老师改,没挂科目归班主任 / 管理员 - 新增「任课教师分配」与「班级教师批量导入」(带「使用工号匹配」开关) 成绩与名单 - 成绩等级:百分制 / 等级制 A·B·C·D / 自定义,支持单个与批量改等级 - 按学号查成绩明细(教师端 + 班级端 + 设备令牌),受按班开关控制 - 调班 / 转出(单个与批量)+ 可查历史;学号不变、历史作业成绩留原归属 - 毕业归档页(按年度记录毕业班级 / 毕业生 / 转出学生 / 该届通知与作业) - 学年升级(未毕业不归档、数据沿用);班级称呼改为「2026级1班」 ClassHelper 班级端在线状态 - Web 端显示 班级 / 设备名 / 设备号 / 在线离线 / 最后在线 / 最后心跳 - lastHeartbeatAt 驱动 60 秒在线窗口,与只表示「带状态上报」的 lastSeenAt 分开 学期周次 - 新增 TermWeek(classId 空串 = 全校默认),管理员可用日期范围选择器逐周配置 - 一键按开学日期生成整学期;联网拉取调休建议(只给建议、不改数据,无外网失败属正常) - 改周次后随课表下发给教室的 ClassHelper 班级端 课表方向反转 - 主方向改为「服务端 → 教室」自动下发;教室不再自动回传 - 取教室课表改为手动动作(点击前弹警告),插件按待办标记在下一次心跳补报 改名 - 班级小助手 → ClassHelper:界面、窗口标题、托盘、灵动岛、EXE、安装包、 安装目录、systemd 描述、插件清单与设置页、官网、文档站、README BREAKING CHANGE: 产品名与 EXE 名变更(班级小助手.exe → ClassHelper.exe), 安装目录随之改变,不支持覆盖安装,需先卸载旧版。 服务端首次启动会自动应用 6 个数据库迁移(学生行按 id 原样搬迁,历史数据不丢), 升级前请先备份。
171 lines
11 KiB
XML
171 lines
11 KiB
XML
<controls:SettingsPageBase x:Class="ClassHelper.ClassIslandPlugin.Views.BridgeSettingsPage"
|
|
xmlns="https://github.com/avaloniaui"
|
|
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
|
|
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
|
|
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
|
|
xmlns:local="clr-namespace:ClassHelper.ClassIslandPlugin.Views"
|
|
xmlns:controls="clr-namespace:ClassIsland.Core.Abstractions.Controls;assembly=ClassIsland.Core"
|
|
xmlns:ci="clr-namespace:ClassIsland.Core.Controls;assembly=ClassIsland.Core"
|
|
xmlns:fa="clr-namespace:FluentAvalonia.UI.Controls;assembly=FluentAvalonia"
|
|
mc:Ignorable="d"
|
|
d:DesignHeight="450" d:DesignWidth="800"
|
|
d:DataContext="{d:DesignInstance local:BridgeSettingsPage}"
|
|
Loaded="OnLoaded"
|
|
Unloaded="OnUnloaded">
|
|
<ScrollViewer>
|
|
<StackPanel Classes="settings-container animated-intro" Spacing="0">
|
|
<!-- 连接 -->
|
|
<TextBlock Text="连接 ClassHelper"
|
|
Theme="{StaticResource SubtitleTextBlockStyle}" />
|
|
<TextBlock Margin="0 6 0 12" TextWrapping="Wrap"
|
|
Text="填入 ClassHelper后端的地址与设备令牌。设备令牌在 ClassHelper Web 端「ClassIsland 联动」页面里为本班新建设备后生成,只显示一次。" />
|
|
|
|
<TextBox Watermark="http://127.0.0.1:4000"
|
|
Text="{Binding Settings.ServerUrl, Mode=TwoWay}" />
|
|
<TextBox Margin="0 8 0 0"
|
|
Watermark="chci_..."
|
|
PasswordChar="●"
|
|
Text="{Binding Settings.DeviceToken, Mode=TwoWay}" />
|
|
<!-- 令牌是设备级长期凭证(只有管理员在 Web 端重置才会失效),而 ClassIsland 的插件配置
|
|
是明文 JSON 且会随档案备份/迁移一起被带走,所以这里明确提示用户别外传。 -->
|
|
<TextBlock Margin="0 6 0 0" TextWrapping="Wrap" Opacity="0.7"
|
|
Text="令牌是这台教室机器的长期凭证(仅管理员在 Web 端重置才会失效),会明文保存在本机配置文件里并随 ClassIsland 档案备份一起复制,请不要外传或提交到版本库。" />
|
|
|
|
<StackPanel Orientation="Horizontal" Margin="0 12 0 0" Spacing="8">
|
|
<Button Content="立即上报" Command="{Binding ReportCommand}" IsEnabled="{Binding !Bridge.Busy}" />
|
|
<Button Content="检查连接" Command="{Binding TestCommand}" IsEnabled="{Binding !Bridge.Busy}" />
|
|
<Button Content="拉取待提醒" Command="{Binding PullCommand}" IsEnabled="{Binding !Bridge.Busy}" />
|
|
<Button Content="重建档案课表" Command="{Binding MirrorCommand}"
|
|
IsEnabled="{Binding Settings.MirrorSchedule}" />
|
|
</StackPanel>
|
|
|
|
<!-- 状态 -->
|
|
<Border Margin="0 16 0 0" Padding="12" CornerRadius="4"
|
|
Background="{DynamicResource SystemFillColorNeutralBackgroundBrush}">
|
|
<StackPanel Spacing="4">
|
|
<TextBlock Text="{Binding StatusText}" TextWrapping="Wrap" FontWeight="SemiBold" />
|
|
<TextBlock Text="{Binding Bridge.LastReportMessage}" TextWrapping="Wrap" />
|
|
<TextBlock Text="{Binding DetailText}" TextWrapping="Wrap" Opacity="0.8" />
|
|
</StackPanel>
|
|
</Border>
|
|
|
|
<!-- 同步 -->
|
|
<TextBlock Margin="0 24 0 0" Text="同步内容"
|
|
Theme="{StaticResource SubtitleTextBlockStyle}" />
|
|
<TextBlock Margin="0 6 0 12" TextWrapping="Wrap"
|
|
Text="课表以「合并」方式写入 ClassHelper:同一星期、同一时间的课目会被更新,不会产生重复行。" />
|
|
|
|
<fa:SettingsExpander Header="自动上报课表到 ClassHelper"
|
|
Description="把 ClassIsland 里启用的课表**自动**同步给 ClassHelper。默认关闭:课表以 ClassHelper 为准,自动回传会在老师手排课之后被教室的旧课表悄悄覆盖。要取教室的课表,请在 Web 端点「从教室机器获取课表」——那是一次显式的人工请求,与本开关无关。">
|
|
<fa:SettingsExpander.IconSource>
|
|
<ci:FluentIconSource Glyph="" />
|
|
</fa:SettingsExpander.IconSource>
|
|
<fa:SettingsExpander.Footer>
|
|
<ToggleSwitch IsChecked="{Binding Settings.UploadSchedule, Mode=TwoWay}" />
|
|
</fa:SettingsExpander.Footer>
|
|
</fa:SettingsExpander>
|
|
|
|
<fa:SettingsExpander Header="把班级课表镜像回 ClassIsland"
|
|
Description="反方向同步:把 ClassHelper上排好的课表写回 ClassIsland,会新建一份以「ClassHelper-」开头的档案课表,不会修改老师原有的课表。">
|
|
<fa:SettingsExpander.IconSource>
|
|
<ci:FluentIconSource Glyph="" />
|
|
</fa:SettingsExpander.IconSource>
|
|
<fa:SettingsExpander.Footer>
|
|
<ToggleSwitch IsChecked="{Binding Settings.MirrorSchedule, Mode=TwoWay}" />
|
|
</fa:SettingsExpander.Footer>
|
|
</fa:SettingsExpander>
|
|
|
|
<fa:SettingsExpander Header="自动上报"
|
|
Description="应用启动、课表变化以及每隔一段时间各上报一次;关闭后只能用上面的「立即上报」手动触发。">
|
|
<fa:SettingsExpander.IconSource>
|
|
<ci:FluentIconSource Glyph="" />
|
|
</fa:SettingsExpander.IconSource>
|
|
<fa:SettingsExpander.Footer>
|
|
<ToggleSwitch IsChecked="{Binding Settings.AutoReport, Mode=TwoWay}" />
|
|
</fa:SettingsExpander.Footer>
|
|
</fa:SettingsExpander>
|
|
|
|
<Grid Margin="0 8 0 0" ColumnDefinitions="*,Auto">
|
|
<StackPanel>
|
|
<TextBlock Text="上报间隔(秒)" />
|
|
<TextBlock Text="最小 15 秒;教室机器建议 60 秒。" Opacity="0.7" TextWrapping="Wrap" />
|
|
</StackPanel>
|
|
<NumericUpDown Grid.Column="1" Width="140"
|
|
Minimum="15" Maximum="3600" Increment="15"
|
|
FormatString="0"
|
|
IsEnabled="{Binding Settings.AutoReport}"
|
|
Value="{Binding Settings.ReportIntervalSeconds, Mode=TwoWay}" />
|
|
</Grid>
|
|
|
|
<!-- 提醒 -->
|
|
<TextBlock Margin="0 24 0 0" Text="提醒"
|
|
Theme="{StaticResource SubtitleTextBlockStyle}" />
|
|
<TextBlock Margin="0 6 0 12" TextWrapping="Wrap"
|
|
Text="老师在 ClassHelper上发布的提醒会以 ClassIsland 的全屏提醒呈现;未弹出的提醒在应用重开后会自动补发,确认弹出后不再重复。" />
|
|
|
|
<fa:SettingsExpander Header="接收 ClassHelper提醒"
|
|
Description="关闭后本机会忽略老师在 ClassHelper上发布的提醒(提醒仍会留在班级通知中心)。">
|
|
<fa:SettingsExpander.IconSource>
|
|
<ci:FluentIconSource Glyph="" />
|
|
</fa:SettingsExpander.IconSource>
|
|
<fa:SettingsExpander.Footer>
|
|
<ToggleSwitch IsChecked="{Binding Settings.ReceiveNotifications, Mode=TwoWay}" />
|
|
</fa:SettingsExpander.Footer>
|
|
</fa:SettingsExpander>
|
|
|
|
<fa:SettingsExpander Header="语音朗读"
|
|
Description="提醒弹出时按 ClassIsland 的语音设置为全机朗读提醒内容。">
|
|
<fa:SettingsExpander.IconSource>
|
|
<ci:FluentIconSource Glyph="" />
|
|
</fa:SettingsExpander.IconSource>
|
|
<fa:SettingsExpander.Footer>
|
|
<ToggleSwitch IsChecked="{Binding Settings.SpeechEnabled, Mode=TwoWay}" />
|
|
</fa:SettingsExpander.Footer>
|
|
</fa:SettingsExpander>
|
|
|
|
<Grid Margin="0 8 0 0" ColumnDefinitions="*,Auto">
|
|
<StackPanel>
|
|
<TextBlock Text="默认显示时长(秒)" />
|
|
<TextBlock Text="老师在下发单条提醒时可以另外指定更长的时长。" Opacity="0.7" TextWrapping="Wrap" />
|
|
</StackPanel>
|
|
<NumericUpDown Grid.Column="1" Width="140"
|
|
Minimum="1" Maximum="120" Increment="1"
|
|
FormatString="0"
|
|
Value="{Binding Settings.NotificationDurationSeconds, Mode=TwoWay}" />
|
|
</Grid>
|
|
|
|
<Grid Margin="0 8 0 0" ColumnDefinitions="*,Auto">
|
|
<StackPanel>
|
|
<TextBlock Text="提醒轮询间隔(秒)" />
|
|
<TextBlock Text="老师按下发送到教室弹出之间的最大延迟(插件不持有长连接,是轮询取回提醒)。默认 10 秒。"
|
|
Opacity="0.7" TextWrapping="Wrap" />
|
|
</StackPanel>
|
|
<NumericUpDown Grid.Column="1" Width="140"
|
|
Minimum="5" Maximum="600" Increment="5"
|
|
FormatString="0"
|
|
IsEnabled="{Binding Settings.ReceiveNotifications}"
|
|
Value="{Binding Settings.NotificationPollSeconds, Mode=TwoWay}" />
|
|
</Grid>
|
|
|
|
<!-- 调试 -->
|
|
<TextBlock Margin="0 24 0 0" Text="调试"
|
|
Theme="{StaticResource SubtitleTextBlockStyle}" />
|
|
<fa:SettingsExpander Header="显示调试信息"
|
|
Description="显示设备标识、时钟差等细节,排查「为什么同步不上」时打开。">
|
|
<fa:SettingsExpander.IconSource>
|
|
<ci:FluentIconSource Glyph="" />
|
|
</fa:SettingsExpander.IconSource>
|
|
<fa:SettingsExpander.Footer>
|
|
<ToggleSwitch IsChecked="{Binding Settings.ShowDebugInfo, Mode=TwoWay}" />
|
|
</fa:SettingsExpander.Footer>
|
|
</fa:SettingsExpander>
|
|
|
|
<StackPanel Margin="0 8 0 0" Spacing="2" IsVisible="{Binding Settings.ShowDebugInfo}">
|
|
<TextBlock Text="{Binding DebugText}" TextWrapping="Wrap" FontFamily="Consolas,monospace" />
|
|
</StackPanel>
|
|
|
|
<TextBlock Margin="0 24 0 0" Opacity="0.6" TextWrapping="Wrap"
|
|
Text="提示:ClassHelper Web 端 →「ClassIsland 联动」可以新建/重置设备令牌、开关同步项,并实时看到本机当前上的课。" />
|
|
</StackPanel>
|
|
</ScrollViewer>
|
|
</controls:SettingsPageBase> |