快速开始与账号
访问系统
- 前后端分离开发环境：访问
http://localhost:5173。
- 单服务本地运行：访问
http://localhost:5255。
- 生产环境：使用学校配置的 HTTPS 域名访问。手机 App 与浏览器使用同一套账号和权限。
登录后，首页“教务总览”展示与当前角色相关的待办、统计与快捷入口。左侧或顶部菜单会根据角色显示可进入的业务模块。
登录与退出
- 在登录页输入已有账号和密码。
- 按页面验证码图片输入字符；验证码可点击图片或“换一张”刷新。验证码有效期约两分钟，每次登录或单点登录只使用一次。
- 登录成功后，系统保存短期访问令牌并依据 Web 或 App 的空闲时长维持会话。
- 使用完毕后从右上角个人菜单退出，尤其是在公共计算机上。
验证码输入错误、过期或登录失败后，页面会自动刷新验证码；请使用新图片重新输入。验证码只用于登录前的安全校验，不是“个人账户”中的动态验证码。若账号已启用认证器二次验证，密码正确后还需输入认证器生成的 6 位验证码或恢复码。
若学校启用了 Keycloak 单点登录，登录页会显示统一身份认证入口。Keycloak 仅负责确认身份；本系统中的账号启用状态、角色和数据范围仍由本系统控制。首次单点登录会优先匹配同名本地账号；用户名不同则按页面提示验证已有本地账号完成绑定，不会自动创建高权限账号。
学生自助激活
学生档案与登录账号分开维护。导入或新增学生档案后，不会自动生成密码或账号。学生首次使用时：
- 在登录页选择“自助激活”。
- 如实填写姓名、学号、学院、专业、年级和行政班。
- 系统验证信息与在籍学生档案完全一致后，自行设置密码。
- 激活成功后即可用学号/账号登录。
信息不匹配时不要反复猜测；应联系学院教务人员核对学生档案的姓名、学号、专业、年级和行政班。已停用、休学、退学或未关联有效学生档案的账号不能按正常学生身份使用相关功能。
个人账户与个人信息
右上角进入“个人账户”可查看当前账号、角色及单点登录绑定状态；可按授权操作绑定或解除 Keycloak 账号。解除绑定需要再次验证本地密码，以防止仅凭未锁屏会话误操作。
“个人信息”用于查看本人档案信息。人员档案由学校管理人员维护；修改档案不会自动修改登录账号，也不会把密码写入人员档案。
密码与账号安全
- 不共用账号，不以聊天、邮件明文发送密码。
- 第一次获得临时密码后，应尽快修改为个人密码。
- 发现异常登录、账号被锁定或角色不正确时，联系超级管理员在“用户与权限”处理。
- 浏览器提示无权限、页面自动返回首页，通常表示当前角色不具备该路由的使用条件；是否允许仍以接口的服务端校验结果为准。
公开入口
/timetable：学校对外开放的课表页面（是否开放及可见内容以部署设置为准）。/verify/{凭证编号}：官方电子凭证验真页面。可扫描成绩单、学籍证明 PDF 上的二维码，或手工输入凭证编号验证真伪和有效性。
常见问题
| 现象 |
优先处理方式 |
| 忘记密码 |
联系有账号管理权限的管理员按学校流程重置，不要新建重复账号。 |
| 验证码看不清或提示失效 |
点击验证码图片或“换一张”获取新图片，并在同一次登录尝试中输入新验证码。 |
| 自助激活失败 |
对照学生档案逐项核对六项身份信息；无法确认时由学院核查。 |
| 看不到菜单 |
确认账号角色、关联的教师/学生档案、学院范围及业务状态。 |
| 登录后频繁失效 |
检查网络、浏览器隐私/存储限制和部署的 JWT 空闲时长配置。 |
| SSO 回调失败 |
核对 Keycloak 的回调地址、HTTPS 域名与系统 Sso__CallbackUrl 配置是否完全一致。 |