功能与源码索引

本文为现行文档入口。功能规则在对应章节维护；源码行为发生变化时，同步修改对应章节。 旧任务书、历史审查结论和旧构建验收数字不作为当前功能依据。

主题	文档	工作区源码入口
架构与模块	架构总览	server/src/modules/registry.ts
日课表、作息与轮换	课表	server/src/lib/class-plan.ts、modules/class-plans/
学生、教师、班级	班级、学生与教师	server/src/lib/access.ts、modules/students/
权限组与岗位范围	角色与权限	shared/src/permissions.ts、server/src/lib/authz/、server/src/lib/permissions.ts
作业	作业	server/src/modules/homeworks/
AI 助手	解析与确认发布	server/src/modules/ai/、web-admin/src/views/AssistantView.vue
通知与叫人	通知、叫人	server/src/modules/notifications/、calls/
课件	课件上传与传输	三端 courseware 模块与 shared/src/courseware.ts
成绩与隐私	成绩	server/src/modules/grades/
经典与自定义常驻岛	灵动岛	desktop-client/src/island/LayoutIslandApp.vue、CustomIslandRuntime.vue
导入	表格与课表导入	server/src/modules/imports/、class-plans/profile-import.service.ts
API 与实时	REST API、实时事件	server/src/modules/、realtime/、shared/src/constants.ts
数据模型与迁移	数据模型	server/prisma/schema.prisma、migrations/
数据库管理	数据库管理、MySQL	server/src/lib/snapshot.ts、modules/database/
安装与升级	生产部署、Linux、更新	deploy/、scripts/dist-server.mjs
验证与发布	验收、发布	根 package.json、scripts/、.github/workflows/
当前实现约定	实现约定	课表、升级、岛、课件与设备维护的关键边界

表中的包路径均相对仓库 packages/；脚本和部署目录相对仓库根。 源码总入口：GitHub 仓库。 代理工程规则见 AGENTS.md。 ClassIsland 仅保留离线 JSON 导入与设计参考，在线联动插件及相关接口已退役。