using System; using System.Collections.Generic; using static mxdemo.Mind.IStudentClassDispatchService; namespace mxdemo.Mind { // 选科数据与决策会有很多重合的地方 public enum EnumElectiveGeneration { Init = 0, // 初始化态,选科正式开启前的状态,开启之后往下一代推进 Primary = 1, // 初选(正常报名)阶段,初选时间结束时往下一代推进 (先暂定进入PrimaryDM之前选科设置还可以修改,之后禁止,防止扰乱数据) PrimaryDM, // (PrimaryDecisionMaking)初选录取阶段,应用决策之后,开启补录报名(时间段)并往下一代推进 BackTracking, // 补录报名时间结束后往下一代推进 BackTrackingDM, // 调剂OR提醒,如果为直接调剂,则跳过FinalAdjust,如果为提醒(设时间段)并往下一代推进 FinalAdjust, // 调剂报名期间 FinalAdjustDM, // 调剂决策,这个阶段会最终定版 RankBalance, // 可选步骤,行为类似强制调剂 // Dispatch, // 分班?分班是否要进入此结构?貌似结构不太统一!应该还是要分出去做 Terminate // 最终代,选科流程数据全部封存 } public enum EnumElectiveOperation { None = 0, Canceled, Disabled, Optional, Rejected, Approved, Forced } // 待思考问题: /* 1 哪个结点开始不允许修改选科设置 2 未操作志愿、未选完志愿、未响应决策的学生是否需要区分显示 3 补录决策时,是否存在部分调剂、部分提醒的情况? 4 调剂行为定义:直接修改学生最终录取组合,触发发签名 */ #region models /// /// Generation init时生成的缓存数据,方便后续计算 /// 生成开放组合的数据即可 /// 每次修改选科设置(在允许范围内修改)需要刷新 /// public class ElectiveStudentScore { long id; long roundId; long studentId; long groupId; decimal scoreTotal; // 9科成绩,看是否有必要存 decimal scoreGroup; // 6科成绩 int rankTotal; // 9科全校排名,看是否有必要存 int rankGroup; // 6科全校排名 } /// /// 每一代都为体现学生的选科数据变化,任何操作都可以被记录下来,只是最终哪条生效的问题 /// 当然也可以根据实际情况减少部分记录,类下面的注解将讨论这些问题 /// public class ElectiveGenerationFlowData { long id; long roundId; long studentId; long groupId; EnumElectiveGeneration generation; EnumElectiveOperation operation; long operateBy; DateTime operateTime; int rank; // Primary中可能存在多志愿,用来控制此阶段的志愿优先级,如第1志愿=0,第2志愿=1,第三志愿=2 string remark; // 以下2个字段用来挂载生命周期关键引用对象,具体每个环节挂什么,需要再斟酌。 string refType; long refId; } public class ElectiveGenerationFlowLog : ElectiveGenerationFlowData { // + 区分ElectiveGenerationFlowData的字段 } public class RoundForFlow : mxdemo.Mind.IStudentClassDispatchService.Round // Round到时候合并在一起 { bool AllMatched; // 所有学生匹配完毕,可以开始推进排名均衡或者分班 EnumElectiveGeneration currentGeneration; // 内部字段 } // 1 初选决策时,需要进行设置 // 2 补录决策时,需要进行设置,此时要根据具体数据来定 // 如果所有学生都已经匹配完毕(Approved,Forced都属性已匹配),则可以推进排名均衡或者分班 // 如果还有未匹配的,则推进到FinalAdjust public class FlowPushSetting { long id; long roundId; DateTime begin; DateTime end; bool onlyRecommand; // 仅允许学生选择推荐组合, 否则允许学生填报有空缺的组合 bool onlyAgree; // 调剂阶段,只允许学生选择同意, 否则允许学生拒绝 } public class ElectiveEsign { long id; long roundId; long flowDataId; // 对应哪条匹配数据(录取或者调剂)【匹配算法结果表也可如此挂载flowDataId,这样可以追溯匹配原因】 string esignPath; // 签字保存图片 bool actived; // 有效标记,可以考虑:如果学生需要签名且未签名时,如果再遇到新的调剂时,旧的签名还要继续么?我觉得应该是不需要的 // 可能还有其它字段 } /* 总则:ElectiveGenerationFlowData记录的是每一代数据的最终结果,如果想要更精细的记录,可以结合ElectiveGenerationFlowLog 1 Generation.Init 可有可无,不需要生成初始数据? 2 Generation.Primary 报名时: ADD operation=Approved 取消时: UPDATE operation=Cancel 排名挤出时-被挤出人: UPDATE operation=Disabled, remark = '排名挤出' refType = 'ElectiveGenerationFlowData' refId = ElectiveGenerationFlowData.id // 报名解发挤出那条记录的ElectiveGenerationFlowData.id 取消时恢复补挤出的人(只有当被影响的人还有剩余报名次数的时候才自动恢复,因为期间他可能自己又补填了一个志愿): QueryBy refId UPDATE operation=Approved WHEN COUNT(operation=Approved) /// 选科过程中的统计数据值,除了要展示之外还需要做查询支持 /// public class ElectiveSummaryValue { // 展示字段 int groupId; // 组合ID,没有组合为0比如未参与报名人数(实际只有两种统计数据,针对某个组合的统计和不针对组合的统计) int value; // 数值 string color; // 支持'R','G','B','',或者'#FA1234'等hexString bool bold; // 加粗,重点展示 bool star; // 带*,重点展示 // 反向查询代码 将统计逻辑的条件关键字放入此代码,回传后台能反向解析并恢复明细 // 想法:让统计全部基于ElectiveGenerationFlowData,形成一种或多种QueryDto{roundId:'',generation:'',groupId:''...}等, 序列化实际查询条件 string queryCode; bool disabled; // 不支持查询 } /// /// 查询的某一列 /// public class ElectiveSummaryCategory { string category; // 身份标识,类似字段名/列名,可能被前端用来定制渲染模板 string displayName; // 显示名称 ElectiveSummaryValue[] values; } public interface IElectiveGenerationSummary { int roundId { get; set; } // 选科轮次 EnumElectiveGeneration generation { get; set; } // 进程代 } /// /// 进程代的统计结果从primary开始出数据 /// public class ElectivePrimarySummary : IElectiveGenerationSummary { ElectiveSummaryCategory[][] categories; // 是多维数组,以应对多志愿的情况 public int roundId { get => throw new NotImplementedException(); set => throw new NotImplementedException(); } public EnumElectiveGeneration generation { get => throw new NotImplementedException(); set => throw new NotImplementedException(); } } /// /// 非Primary非DM的某一代的统计结果 /// public class ElectiveGenerationSummary: IElectiveGenerationSummary { /// /// 对某一代的统计项目,比如在初选决策、补录报名的统计等,下面接口会细述 /// ElectiveSummaryCategory[] categories; int IElectiveGenerationSummary.roundId { get => throw new NotImplementedException(); set => throw new NotImplementedException(); } EnumElectiveGeneration IElectiveGenerationSummary.generation { get => throw new NotImplementedException(); set => throw new NotImplementedException(); } } public class ElectiveGenerationDMSummary: ElectiveGenerationSummary { /// /// 迭加到某决策代的统计项目,比如当前选科的总录取人数、待签人数、已签人数等,下面接口会细述 /// ElectiveSummaryCategory[] accumulates; } /// /// 获取选科进程的统计数据,一直汇总到当前进程代 /// /// IElectiveGenerationSummary[] getElectiveSummary(); // 下面开始按代来描述ElectiveGenerationSummary需要返回的具体内容 /* 一、ElectivePrimarySummary,所需ElectiveSummaryCategory->{category:'',displayName:''}定义如下: * // hht.22/4/10 这个属性不要了 {'expectedCount','设置人数'}, -- 选科设置的人数, 为方便输出与图表展示,可能后续会有重复输出 * {'actualCount','实际人数'}, -- 填报第X志愿的人数 * {'unfinishedCount','未完成人数'}, -- 未填报第X志愿的人数(根据ElectiveGenerationFlowData实际Approved&Rank情况统计即可,因为如果报名还在进行中,本身就是动态变化的东西) * 按第一志愿、第二志愿、...的顺序输出数据 * * 二、ElectiveGenerationDMSummary.accumulates * 仅决策代需要统计此数据,决策代[PrimaryDM BackTrackingDM FinalAdjustDM RankBalance] * // hht.22/4/12 同上,这个属性也不要了 {'expectedCount', '设置人数'} -- 选科设置人数 * {'approvedCount', '正常录取人数'} -- 到此阶段为止,正常录取人数 * {'forcedCount', '调剂录取人数'} -- 到此阶段为止,调剂录取人数 * {'esignedCount', '已签人数'} -- 到此阶段为止,触发的有效签名统计 * {'esigningCount', '待签人数'} -- 到此阶段为止,阶段触发有效的应签未签统计 * * 三、ElectiveGenerationSummary.categories 只统计某代的数据 * A PrimaryDM * {'indicateCount','指标'} -- 正负表示超过设置的人数,负数表示低于设置的人数 * {'approvedCount, '录取人数'} -- 正常录取人数 * {'adjustCount','调剂人数'} -- 未录取人数,理论上应该<=指标的绝对值 * {'matchedCount','可调剂人数'} -- 未录取可被调剂的人(志愿不满足但自选专业满足) * {'nonmatchedCount','不可调剂人数'} -- 未录取不可被调剂的人(志愿与自选专业均不满足) * * B BackTracking FinalAdjust * {'matchedApproved','可调剂同意人数'} -- 统计有效补录报名,且报名与推荐相同 * {'matchedNotOptional','可调剂改填人数'} -- 统计有效补录报名,且报名与推荐不同 * {'matchedRejected','可调剂已拒绝人数'} -- 统计拒绝报名的人数 * {'matchedNonaction','可调剂未完成人数'} -- 统计未参的人数(因为有可能被排名挤出) * {'matchedRankout','可调剂被挤出'} -- 统计参与但已经失效的报名人数(因为有可能被排名挤出) * {'nonmatchedApproved','不可调剂已填人数'} * {'nonmatchedNotOptional','不可调剂改填人数'} * {'nonmatchedRejected','不可调剂已拒绝人数'} * {'nonmatchedNonaction','不可调剂未完成人数'} * {'nonmatchedRankout','不可调剂已填人数'} * * C BackTrackingDM FinalAdjustDM RankBalance * {'approvedCount','补录录取人数'} -- 正常录取 [BackTrackingDM FinalAdjustDM] * {'forcedCount','调剂录取人数'} -- 强制调剂录取 [BackTrackingDM FinalAdjustDM RankBalance] * {'matchedCount','可调剂人数'} -- 正常录取 [BackTrackingDM] * {'nonmatchedCount','不可调剂人数'} -- 正常录取 [BackTrackingDM] * */ #endregion #region getElectiveSummaryDetail 汇总明细清单 /// /// 明细肯定是通过 某个组合某个学生 来呈现的 /// public interface IElectiveGengerationDetail { long id { get; set; } EnumElectiveGeneration generation { get; set; } string category { get; set; } // ElectiveSummaryCategory.category int roundId { get; set; } int studentId { get; set; } string studentName { get; set; } int classId { get; set; } string className { get; set; } int groupId { get; set; } string groupName { get; set; } } /// /// 此类相当于ElectiveGenerationFlowData的DTO,将字段转义为UI需要的内容 /// 明细的学生组合信息, 主要包含报名信息; /// 还有一部分自选专业的信息,需要借助其它接口 /// public class ElectiveGenerationDetail: IElectiveGengerationDetail { int rankInTime { get; set; } // 组合即时排名 int rankInGroup { get; set; } // 组合全校排名 int rankInGrade { get; set; } // 总分全校排名 int rankPreference { get; set; } // 志愿RANK 第几志愿 string OperateTime { get; set; } // 报名时间 public long id { get => throw new NotImplementedException(); set => throw new NotImplementedException(); } public string category { get => throw new NotImplementedException(); set => throw new NotImplementedException(); } public EnumElectiveGeneration generation { get => throw new NotImplementedException(); set => throw new NotImplementedException(); } public int roundId { get => throw new NotImplementedException(); set => throw new NotImplementedException(); } public int studentId { get => throw new NotImplementedException(); set => throw new NotImplementedException(); } public string studentName { get => throw new NotImplementedException(); set => throw new NotImplementedException(); } public int classId { get => throw new NotImplementedException(); set => throw new NotImplementedException(); } public string className { get => throw new NotImplementedException(); set => throw new NotImplementedException(); } public int groupId { get => throw new NotImplementedException(); set => throw new NotImplementedException(); } public string groupName { get => throw new NotImplementedException(); set => throw new NotImplementedException(); } } /// /// 录取明细(包含approved正常录取;forced强制调剂录取),当前组合为录取项 /// public class ElectiveGenerationEnrollDetail: ElectiveGenerationDetail { ElectiveGenerationDetail[] otherEnlist; // 非录取报名清单 Dictionary failedReasons; // 如果有未录取原因,填充在此MAP{key: detailId, value: failed reason}中 bool forced; // 是否属于强制调剂 bool esigned; // 是否已经签名 } /// /// 未录取明细,当前组合是推荐项 /// public class ElectiveGenerationDisenrollDetail: ElectiveGenerationDetail { ElectiveGenerationDetail[] enlist; // 之前的报名清单(肯定都没有录取) Dictionary failedReasons; // 如果有未录取原因,填充在此MAP中 bool agreed; // 同意此组合 bool disagreed; // 不同意此组合 bool disagreeReason; // 不同意的原因 ElectiveGenerationDetail other; // 即没有同意,也没有不同意,选了其它组合 bool esigned; // 是否已经签名 } /// /// 初选报名搭配使用,展示其它可报组合情况 /// public class ElectiveGenerationOptionalMajor : ElectiveOptionalMajor { int bestMatchedGroupId; // 最佳匹配 } /// /// Map: {key: studentid, value: ElectiveGenerationOptionalMajor} /// /// /// 批量取学生自选专业匹配情况 Dictionary getGenerationOptionalMajorsBatch(int[] studentIds); /// /// 通过summary中输出的queryCode反查明细 /// /// /// List getElectiveGengerationDetails(string queryCode); #endregion #region decision-making /// /// 匹配算法,算法名称代表的具体逻辑请看注解(不要顾名思义) /// public enum EnumElectiveDMAlgorithm { /// /// 按成绩: /// ElectiveEngine中,相当于[未录学生]/[组合*ALL]/[志愿*ALL]一并运行,排序时排名优先; /// 以上逻辑循环迭代,每次只补空缺组合,直至未录学生=0。 /// 第1次迭代之后运算的学生均属于可调剂名单,不会有不可调剂名单 /// RankFirst, /// /// 按专业: /// ElectiveEngine中,相当于[未录学生]/[组合*ALL]/[志愿1][志愿2,志愿3][自选专业伪志愿]/三波运行,排序时排名优先; /// 以上逻辑循环迭代,每次只补空缺组合,直至伪志愿运算结束。 /// [志愿1][志愿2,志愿3]迭代的录取学生为正常录取;自选专业伪志愿为可调剂名单;运行结束后的未录学生为不可调剂名单。 /// MajorFirst, // } /// /// 执行选科匹配算法。为减少错误,对DM代数据全删全加可能好点。 /// /// void applyElectiveDMAlgorithm(EnumElectiveDMAlgorithm algorithm); #endregion #region forced /// /// 决策阶段,强制调剂录取 /// /// /// void enrollByForce(long studentId, int groupId); /// /// 取消强制调剂操作 /// /// ElectiveGenerationFlowData.id void cancelEnrollByForce(long id); #endregion #region generation推进 /// /// 决策完毕时,推进下一代进行 /// /// void pushGenerationSetting(FlowPushSetting setting); /// /// 如果在所有学生全部录取的情况,可以在任意决策结点跳转至排名均衡 /// void jumpGenerationRankBalance(); /// /// 如果在所有学生全部录取的情况,可以在任意决策结点跳转至终止态,封存数据 /// void terminateGeneration(); /// /// 在任意报名阶段,如果校长发现数据已经完全OK,则可以强制推进进程,提前进入决策 /// void flushIntoGenerationDM(); #endregion #region 排名均衡(略)先完成前面的 #endregion } }