关于AIBook
数智教材：连接教材编纂与课程协同的开放平台
AIBook 聚焦“教材结构化管理 + 课程协同”场景，结合 Gin 后端与 Next.js 前台打造一体化体验。平台以教材版本、课程团队与课堂实践为核心，帮助教研团队在紧凑迭代中保持一致视角。
平台以“教材 → 课程 → 班级”链路组织知识资产，通过 Server Actions 串联服务端能力与前台展示。工作台负责生产力场景，公共页面承载展示与传播，为后续生态扩展铺路。
统一教材结构
围绕 Book → Edition → Chapter → Section → Block 模型，支撑教材内容的结构化编排与差异对比。
对齐课程协作
以 Course、Class 与版本授权建模课程运营流程，确保教材与教学节奏同步。
开放式扩展能力
Gin API 与 Swagger 文档提供稳定接口，Next.js 前台复用同一 actions，便于二次开发与集成。
核心原则
- 坚持教材版本与课程节奏的强关联，形成覆盖全流转的生命周期管理。
- 通过分层架构保持业务边界清晰：Controller → Service → Repo → Entity。
- 统一响应与校验标准，确保前后台体验一致，可无缝扩展第三方接入。
核心模块概览
根据实体关系划分三大核心模块，支持从内容创作到课程运营的全链路协作。
教材工作台
面向主编与作者的结构化编辑体验。
- 版本管理：Edition 时间轴追踪版本发布节奏。
- 章节拆分：Chapter / Section / Block 粒度的内容编排与预览。
- 权限模型：BookAuthor 角色与校验确保协作文稿安全。
课程协同
让课程计划与教材版本保持一致。
- 教师梯队：CourseTeacher 与 ClassTeacher 明确职责划分。
- 班级治理：Class、Invitation 支撑教学组织与入班流程。
- 教材指派：CourseEdition 记录课程使用的版本，快速同步教材资源。
资源分发
保障课堂资料与多媒体的统一入口。
- 素材集成：Attachment、Image 模块管理外部资源。
- 内容组件：Block kind 承载不同教学内容模块。
- 统一输出：ResponseHandler 统一 API 返回结构。
协作模式
面向不同角色划定职责边界，结合权限模型与页面布局，实现数据安全与协作效率的平衡。
教研团队协作
教材主编教材作者审核成员
围绕教材版本的主编、作者与审核成员，在统一工作台中协同推进内容更新。
- BookAuthorService 控制权限，确保仅受邀成员可编辑教材。
- Edition 生命周期帮助主编掌握教材迭代节奏。
- 章节定位（Chapter / Section / Block）方便审核与讨论。
课程运营梯队
课程负责人班级教师课程助教
课程负责人、班级教师与助教共享教材上下文，让教学计划与教材版本保持一致。
- CourseTeacher 标记 owner 权限，明确课程决策责任。
- ClassTeacher / ClassStudent 结构支撑多班并行管理。
- CourseEdition 映射课程所用教材版本。
平台支撑团队
平台管理员研发团队
平台管理员与研发团队为业务提供稳定的发布、监控与接入能力。
- User 权限标识（is_admin / book_owner / course_owner）覆盖多种管理场景。
- Swagger 文档与自动化构建流程降低接入成本。
- 前台 Next.js 与后台 Gin 共享校验与响应策略，便于统一治理。
项目路线
AIBook 以迭代式节奏推进功能完善与生态扩展，确保每个阶段都有可衡量的交付物。
阶段一已上线
统一数据模型与基础权限
- 完成教材、课程、班级等核心实体的建模与接口编排。
- 实现 JWT 登录鉴权与 BookAuthor 关联校验。
- 提供 Workspace 工作台支撑日常教材与课程运营。
阶段二进行中
公共门户与展示体验
- 设计面向公众的课程 / 教材浏览体验。
- 完善 Server Actions，支持更多场景的 SSR 与缓存策略。
- 沉淀 UI 组件与页面布局规范，提升全站一致性。
阶段三规划中
生态扩展与数据连通
- 开放更多课程运行指标，构建可视化数据看板。
- 提供基于 Edition 的细粒度 API，支持外部系统订阅。
- 与第三方教学平台打通，拓展课堂与训练营场景。