EEO 系统概述
EEO 系统概述
EEO 提供一个实时在线教室系统及相关服务。 系统主要包含两部分：
- 客户端产品：产品名为 ClassIn，支持 Windows 和 Mac OS 、iOS 、 Android 移动端平台。
- 基于 Web 的后台管理系统，访问网址为 www.eeo.cn。
ClassIn 概述
ClassIn 是一个客户端应用程序，需要安装后使用，提供最高支持1v15（1个老师/助教和最多15个学生有视频）以内的各种班型的实时在线课堂。
eeo.cn 概述
其为基于 Web 的后台管理系统，机构可以使用这个系统来进行课程、课节的管理，老师、学生、旁听的设置，上课数据的收集与展示，实时监课的管理云盘、课件的管理等。 另外 eeo.cn 支持 API 对接，使得机构可以自行开发更加适合自身业务逻辑的管理系统。
eeo.cn 的 API 对接说明
基本概念
身份相关（用户、老师、学生、旁听、机构、子帐号等）
- EEO 的系统是一个强帐号系统，每个人都需要有一个用户帐号。
- 用户必须登陆 ClassIn 或者 eeo.cn 才能使用各项业务功能。
- 机构需要将某些用户添加为机构老师，才能在设置课程、课节的时候将机构老师指定为本课程、课节的老师。
- 学生、旁听等都是针对课程或课节而言的一种身份。一个用户可以在某节课下为老师，同时也可以在其他课程或课节下是学生或其他身份。
- 任何用户都可以被指定为课程、课节下的学生（机构账号不可以指定为学生）。
- 旁听只能针对课程来设置。
- 任何用户在一个课节下只能具有一种身份。
- 机构帐号就是经过机构认证后的用户。机构帐号具备添加机构老师、创建课程、指定子帐号等功能。
- 子帐号是机构用来指定多名管理人员的，eeo.cn 后台支持机构配置多个子帐号，并且可以为每个子帐号指定不同的权限。子帐号设置暂时不支持通过 API 设置。
- 具有监课权限的子帐号可以通过Web链接唤起客户端的形式，以旁听身份进入机构下的任何课节。
课程相关（课程、课节）
- EEO 的系统对课程的管理分为两个层级。第一层是课程，第二层是课节。
- 机构可以创建任意多个课程
- 每个课程下可以有多个课节，建议多个课节不要有时间重叠。
- 如果机构没有课程的概念，可以每个课程里面搭配创建一个课节来使用EEO的系统。
云盘相关
- EEO 为每个用户都创建了一个系统内部的云盘。
- 云盘是目录（文件夹）结构的，每个目录下都可以创建多个目录和文件。目录的总数最大限制是5000个，目录深度最多是15级。
- 目前云盘可以存放 PPT、Word、PDF、audio、video 等系统支持的课件类型。
- 云盘里的课件支持在 ClassIn 的教室里打开使用。
- 老师在上课时可以打开自己个人云盘里的任何系统支持的课件。
- 经过机构认证后的用户的云盘，这里简称为机构云盘。
- 机构可以为课程或课节指定一个机构云盘里的目录，老师在上这节课时，可以打开该目录下的任何系统支持的课件。
API 中的名词及关系
- 用户：ClassIn 是一个强帐号系统，所有的用户必须先登录，才能看到属于用户的相关课程信息，以及使用其他系统提供的各项功能。也因此所有的用户都需要有 EEO 的帐号。
- 课程、课节：一个课程包含多个课节，不支持独立的课节，也就是必须先有课程，然后再课程下添加一个或多个课节。
- 班级群：每创建一个标准课程时，系统会自动创建一个班级群（可以在 ClassIn IM 查看此群）。
课程下的属性有：
- 课程名称：会显示在 ClassIn 的界面上。为了便于管理，建议精心设计课程名称的命名规则。
- 课程图片：会显示在 ClassIn 的界面上。该图片不支持修改。
- 过期时间：每个课程都有一个截止日期，截止日期之后，系统将不再支持针对该课程的任何增、删、改等操作。如果没有设置该值，系统自动设置为该课程下最后一节课之后的90天。
- 课程资源：EEO 系统支持机构为每个课程设置一个云盘目录（没有为课节节设置云盘目录），授课老师在该课程的上课过程中，可以访问、使用这个云盘目录下的所有可用课件。如果为单个课节设置了云盘目录，那么授课老师在该课节的上课过程中，将只能访问、使用该课节所设置的云盘目录。
- 课程学生：逻辑和课程资源类似，课程学生可以进入该课程下的所有课节，后创建的课节也允许课程学生进入。课程下总学生人数，称之为班容。
- 课程旁听：逻辑等同于课程学生。只是角色是旁听，老师、学生完全感知不到旁听存在。旁听可用来做家长兼课等用途。
课节下的属性有：
- 课节名称：会显示在 ClassIn 的界面上。为了便于管理，建议精心设计课节名称的命名规则。
- 上下课时间：必须为每节课设置正确的起止时间。老师可以上课时间前20分钟进入教室，学生、旁听等可以提前10分钟进入。下课时间的20分钟后，系统会强制所有人退出教室。上课时间必须晚于当前时间。
- 课节老师：因为同一套课程可能由多个老师来共同完成，所以老师是以课节为单位来设置的。课节开课前20分钟就不能再修改课节老师了。
- 台上人数：教室内同时在台上的最大人数，例如1v6表示最多可上台1名教师和6名学生。
- 课节学生：针对一些场景，如不同的课节下有不同的学生、或者调课等场景，需要针对课节配置可以进入的学生，那么就可以使用这个属性。课节学生是以课节为单位来设置的。
备注：
- 如果您想调大以下三个参数值，您可以联系客户顾问：最大台上人数，课程学生最大人数（即班容），课程旁听生最大人数。
机构在做 API 对接时的主要工作
注意：为了给您提供更好的产品和服务，系统会在每个季度末的第三个星期二凌晨（北京时间）进行例行维护，具体维护时间请访问以下链接。
https://docs.eeo.cn/product/zh-hans/function/System/Maintainance.html
请您在排课的时候，确保课节时间与系统维护时间没有重合。在系统维护期间的所有API请求，都会返回 901 的状态码。
对接用户
- 机构必须使用真实手机号来创建 EEO 的用户帐号（需要其他形式，请与商务人员联系咨询）
- 把所有老师的用户帐号添加为机构老师（调用 API，或者在 eeo.cn 手工完成）
- API 手册里有创建用户、修改密码、修改用户信息等接口
创建课程
- API 手册里有课程对应的增删改查接口
- 为课程设置学生、旁听等用户（可选）
- 为课程设置云盘资源（可选）
为指定课程创建课节
- API 手册里有课节对应的增删改查接口
- 为课节设置老师、学生（可选）等用户
创建网页链接唤起客户端（可选）
- 有两种方式创建链接
- 一种方法是根据底层API 获得必要信息，自行生成链接
- 另一种方法是调用API 直接获得该链接
云盘资源管理（可选）
- API 手册里有云盘相关增删改查接口