TEAMModelOS/TEAMModelOS.SDK/Models/Cosmos/School/CourseBase.cs

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace TEAMModelOS.SDK.Models 
{
    /*
     //课程基础信息
    "courseBase": {
        "id": " uuid1",
        "code": "CourseBase-hbcn",
        "pk": "CourseBase",
        "name": "语文课",
        "subject": {
            "id": "科目id1",
            "name": "高数"
        },
        "period": {
            "id": "学段id1",
            "name": "大学"
        },
        "major": { //专业信息在K12可不设置。
            "id": "专业id1",
            "name": "软件工程"
        },
        "scope": "school",
        "desc": "软件工程专业-高等数学",
        "no": "A101",
        "creatorId": "1595321354",
        "school": "hbcn",
        "color": "red", //用于标记课程表的排课颜色
        "gradeId": 2, //年级
        "status": 1
    }
     */
    /// <summary>
    /// 课程基础信息
    /// </summary>
    public class CourseBase : CosmosEntity
    {   /// <summary>
        /// 课程名称
        /// </summary>
        [Required(ErrorMessage = "{0} 必须填写")]
        public string name { get; set; }
        /// <summary>
        /// 科目
        /// </summary>
        public IdName subject { get; set; }
        /// <summary>
        /// 学段
        /// </summary>
        public IdName period { get; set; }
        /// <summary>
        /// 专业 不是必须的。
        /// </summary>
        public IdName major { get; set; }
        public string scope { get; set; }
        /// <summary>
        /// 描述
        /// </summary>
        public string desc { get; set; }
        /// <summary>
        /// 课程编号
        /// </summary>
        public string no { get; set; }
        /// <summary>
        /// 创建者的id 
        /// </summary>
        public string creatorId { get; set; }
        /// <summary>
        /// 学校编码
        /// </summary>
        public string school { get; set; }
        /// <summary>
        /// 颜色，课表标记颜色
        /// </summary>
        public string color { get; set; }
        /// <summary>
        /// 年级,此处的下标是从0-n开始的。
        ///  注：比如高二可能会将高三的课程学完，则该高三的课程的学年级应该是手动处理为高中二年级。不区分学期的目的，也是可能存在提前一学期学完第二学期的课程。
        /// </summary>
        public HashSet<int> grades { get; set; } = new HashSet<int>();

        /// <summary>
        /// 状态
        /// </summary>

        public int status { get; set; } = 1;
    }
    /*
     //课程排课任务
    "courseTask": {
        //年份+学期，2022-2023第一学期
        "id": " 2022-semesterId",
        "code": "CourseTask-hbcn-courseIduuid1",
        "pk": "CourseTask",
        "expire": 1577808000000,//默认-1 永不过期，学校的课程则自动根据学期的时间进行设置。
        "courseId": "courseIduuid1",//课程id
        "year": 2022,//课程所属年份
        "semesterId": "学期id",
        "weekCount": 20,//课程持续多少周,-1未设定
        "timeCount": 10,//课程一周有多少堂课,-1未设定
        "schedules": [
            {
                "roomId": "物理教室id",//
                "groupId": "名单id",
                "type": "名单类型-class行政班,teach教学班",
                "teacherId": "1595321354",
                //times可不设置，不设置也不影响HiTeach使用，只是不能展示为课表模式，只能是课程任务列表模式。
                "times": [
                    {
                        "id": "学校作息时间id",
                        "week": "MON",//星期几
                        "mode": "all全部,single单周,double双周,custom自定义",
                        "index": [
                            1,
                            5,
                            8,
                            15
                        ]
                    }
                ]
            }
        ]
    }
     */
    /// <summary>
    /// 课程任务
    /// 学校课程
    /// id 2022-semesterId-courseId
    /// code CourseTask-hbcn
    /// 个人课程
    /// id $"{_courseId}";
    ///  $"CourseTask-{tmdid}";
    /// </summary>
    public class CourseTask : CosmosEntity
    {
        /// <summary>
        /// 过期时间，-1永不过期， 1577808000000 2020-01-01。  学校的课程则自动根据学期的时间变化。
        /// </summary>
        public long expire { get; set; } = -1;
        /// <summary>
        /// 课程的id
        /// </summary>
        public string courseId { get; set; }
        /// <summary>
        /// 课表所属年份
        /// </summary>
        public int year { get; set; }
        /// <summary>
        /// semesterId 学期id
        /// </summary>
        public string semesterId { get; set; }
       
        public List<ScheduleTask> schedules { get; set; } = new List<ScheduleTask>();
        /// <summary>
        /// 课程持续多少周,-1未设定
        /// </summary>
        public int weekCount { get; set; } = -1;
        /// <summary>
        /// 课程一周有多少堂课,-1未设定
        /// </summary>
        public int timeCount { get; set; } = -1;

    }

    public class ScheduleTask
    {
        /// <summary>
        /// 教室id
        /// </summary>
        public string roomId { get; set; }
        /// <summary>
        /// 班级名单id：  行政班|教学班
        /// </summary>
        public string groupId { get; set; }
        /// <summary>
        /// type class行政班 teach教学班 
        /// </summary>
        public string type { get; set; }
        /// <summary>
        /// 教师的醍摩豆id
        /// </summary>
        public string teacherId { get; set; }
        /// <summary>
        /// 排课时间表
        /// </summary>
        public List<ScheduleTime> times { get; set; } = new List<ScheduleTime>();
        /// <summary>
        /// 个人课程，讲座，研讨会，直播开始时间。用通知预报开始时间。
        /// </summary>
        public long startTime { get; set; }
        /// <summary>
        /// 开课通知内容，比如临时调整上课地点，或需要准备的资料，开课主讲内容等。
        /// </summary>
        public string notice { get; set; }
        
    }

    public class ScheduleTime {
        /// <summary>
        /// 作息的第几节课的id
        /// </summary>
        public string id { get; set; }
        /// <summary>
        /// 星期几
        /// </summary>
        public string week { get; set; }
        /// <summary>
        /// all全部,single单周,double双周,custom自定义 
        /// </summary>
        public string mode { get; set; }
        /// <summary>
        /// 自定义序列
        /// </summary>
        //[1,2,5,8]
        public HashSet<int>index { get; set; }= new HashSet<int>();

    }
    public class IdName
    {
        public string id { get; set; }
        public string name { get; set; }
    }

   

    public class CourseCheckImport
    {
        /// <summary>
        /// 开学日期
        /// 必填，开学（开课）日期格式，用于计算学年，学期，课表周期，此日期需要大于或等于学校基础信息设置的开学日期: 2023-3-2(年-月-日)
        /// </summary>
        public string stime { get; set; }

        /// <summary>
        /// 课程名称 必填，导入课程的名称，需要与课程列表名称匹配才能导入
        /// </summary>
        public string name { get; set; }
        /// <summary>
        /// 名单类型
        /// 必填，    行政班=>class   教学班=>teach
        /// </summary>
        public string type { get; set; }
        /// <summary>
        /// 行政班编号，教学班名称
        /// 必填,
        /// 当名单类型为class行政班时：班级入学年-班号=>2022-1,2022-01
        /// 当名单类型为teach教学班时：教学班唯一名称=>高一2022物理班
        /// </summary>
        public string list { get; set; }
        /// <summary>
        /// 教师醍摩豆ID
        /// </summary>
        public string tmdid { get; set; }
        /// <summary>
        /// 教室编号 选题，表示网课或不确定上课教室，编号需要与现有教室列表的编号匹配，才能导入
        /// </summary>
        public string roomNo { get; set; }
        /// <summary>
        /// 排课时间段
        /// 选填，数据格式：
        /// 作息时间段-星期几-排课周期模式-自定义周数
        ///
        ///作息时间段（如果确定标记排课时间段，则此字段必填）:学校上课时间段的第几节课，自然数1,2,3-n
        ///星期几（必填）:1,2,3,4,5,6,7代表一周星期一到星期天
        ///排课周期模式（必填）:A(all 全部),S(single单周),D(double)双周,C(custom自定义)
        ///自定义周数(选填) :1,2,5,8
        /// </summary>
        public string schedule { get; set; }
        /// <summary>
        /// 课程结束时间 ，选填，用于展示课表，如果未展示则自动以下学期开学前的时间为准
        /// </summary>
        public string etime { get; set; }
        /// <summary>
        /// -1未验证的，0.验证通过的，1.课程名称无效的，2.醍摩豆ID无效的，3.教学班名称无效的，4.教室编号无效的,5.开学日期无效的，6.课程结束日期无效的,
        /// 7.排课时间格式不满足[1-n]-[1|2|3|4|5|6|7]-[A|D|C]，8.没有对应的上课时间段，9.上课时间不在星期一至星期日，10.自定义模式下，需要配置对应的上课周,11.自定义模式下，上课周不在1-20周
        /// 12.班级入学年-编号不存在，13.导入的班级入学年-编号在系统中重复，请检查行政班设置,14.班级入学年-编号格式错误,15根据开学时间无法获取学期信息
        /// </summary>
        public int invalidCode { get; set; } = -1;
    }
    public class CourseTaskInsert
    {
        /// <summary>
        /// 学年
        /// </summary>
        public int year { get; set; }
        /// <summary>
        /// 学期id
        /// </summary>
        public string semesterId { get; set; }
        /// <summary>
        /// 课程名称 必填，导入课程的名称，需要与课程列表名称匹配才能导入
        /// </summary>
        public string courseId { get; set; }
        /// <summary>
        /// 名单类型
        /// 必填，    行政班=>class   教学班=>teach
        /// </summary>
        public string type { get; set; }
        /// <summary>
        /// 行政班 教学班Id
        /// </summary>
        public string groupId { get; set; }
        /// <summary>
        /// 教师醍摩豆ID
        /// </summary>
        public string teacherId { get; set; }
        /// <summary>
        /// 教室编号 选题，表示网课或不确定上课教室，编号需要与现有教室列表的编号匹配，才能导入
        /// </summary>
        public string roomId { get; set; }

        /// <summary>
        /// 个人课程，讲座，研讨会，直播开始时间。用通知预报开始时间。
        /// </summary>
        public long startTime { get; set; }
        /// <summary>
        /// 开课通知内容，比如临时调整上课地点，或需要准备的资料，开课主讲内容等。
        /// </summary>
        public string notice { get; set; }


        /// <summary>
        /// -1未验证的，0.验证通过的，1.课程名称无效的，2.醍摩豆ID无效的，3.教学班名称无效的，4.教室编号无效的,5.开学日期无效的，6.课程结束日期无效的,
        /// 7.排课时间格式不满足[1-n]-[1|2|3|4|5|6|7]-[A|D|C]，8.没有对应的上课时间段，9.上课时间不在星期一至星期日，10.自定义模式下，需要配置对应的上课周,11.自定义模式下，上课周不在1-20周
        /// 12.班级入学年-编号不存在，13.导入的班级入学年-编号在系统中重复，请检查行政班设置,14.班级入学年-编号格式错误,15根据开学时间无法获取学期信息,16学期不存在
        /// </summary>
        public int invalidCode { get; set; } = -1;
    }
    public class CourseTaskChanged : CourseTaskInsert
    {
        /// <summary>
        /// 名单类型,变更后的名单类型
        /// 行政班=>class   教学班=>teach
        /// </summary>
        public string typeChanged { get; set; }
        /// <summary>
        /// 行政班 教学班Id,变更后的名单Id
        /// </summary>
        public string groupIdChanged { get; set; }
        /// <summary>
        /// 教师醍摩豆ID，变更后的教师id
        /// </summary>
        public string teacherIdChanged { get; set; }
    }
}