业务背景
在传统的补习机构与教育咨询业务中，教务管理与财务结算往往面临着“数据孤岛”与“计算繁杂”的双重压力。随着机构规模的扩大，管理者通常会遇到以下核心痛点：
数据冗余与“幽灵”排课： 课程档案更新频繁，删除的课程或已结课的项目仍残留在排课表中，导致管理界面臃肿，容易产生排课冲突。
复杂的劳务结算逻辑： 讲师薪资并非一成不变。同一讲师在不同班级课酬不同；临时代课时，薪酬结算标准往往难以界定，人工计算极易出错且费时费力。
考勤与薪资脱钩： 传统的纸质或简单表格考勤无法自动触发财务结算，导致每月初财务人员需要耗费数天时间进行交叉核对。
数据安全与迁移成本： 依赖云端系统担心数据泄露，依赖本地表格担心电脑损坏。
系统设计理念：
本系统坚持“以课程项目为核心，讲师为资源分配”的原则。通过高度智能化的算法，实现从“档案建立”到“智能排课”，再到“自动核算”的全链路闭环，彻底解放教务管理者的双手。
1. 智能全息排课引擎 (v8.7 GC 引擎)
这是系统的灵魂模块，在 v8.7 版本中实现了质的飞跃：
幽灵数据自动清剿： 点击“一键排课”时，系统会自动扫描全库。若课程档案已被删除，其在课表中的所有“幽灵痕迹”将被立即清除，确保网格纯净。
生命周期自动拦截： 系统会判断课程的“结课日期”。一旦过期，系统会自动抹除未来多余的排课格子，而保留历史考勤记录。
特派讲座覆盖机制： 临时讲座具有最高优先级，会自动覆盖同时间段的常规班级，并采用独立的讲座课酬体系。
2. 班级与课程生命周期管理
状态分类管理： 自动将课程区分为“活跃进行中”与“已结课历史”，方便管理者回溯数据。
精细化任期配置： 支持为一个班级分配多名讲师，并能精确设置每位讲师的“任期时间段”，实现无缝的教学交接。
3. 多级智能劳务结算系统
系统内置了一套精密的长效核算逻辑，自动处理四种薪资优先级：
特派优先级： 优先执行临时讲座设定的专属课酬。
档案优先级： 提取课程档案中为该讲师定制的单次课酬。
代课继承机制 (核心)： 若检测到代课行为（非档案指派老师），系统会自动提取该课程组内所有老师的最高标价作为代课结算标准，确保公平。
底线保障机制： 若以上皆无，则触发讲师档案中的“全局保底薪水”。
自动代扣个税： 内置个税计算模型，一键生成税后实发工资单。
4. 教职工全息档案库
可视化管理： 支持上传讲师照片、记录所属单位及个人简介。
薪资锚点设置： 预设每位老师的默认课酬与补助，作为系统核算的“防坠网”。
5. 财务总结与审计
多维报表输出： 生成直观的月度劳务总结表，支持导出为 CSV 格式，方便与银行发放系统对接。
核算日志溯源： 每位老师的工资单都附带详细的“核算日志”，记录薪资来源、代课继承依据及拦截的未出勤次数。
6. 企业级数据容灾体系
异步 I/O 架
全部由我个人实现
1. 智能清理与排课算法 (GC Algorithm)
系统在前端 autoGenerateSchedule 函数中实现了类似 JVM 的“垃圾回收”机制：
存活探测： 每次排课前，系统首先提取当前所有 ActiveCourseIds。
孤儿节点清剿： 遍历现有课表网格，凡是无法在活跃 ID 库中匹配到的行，均判定为“幽灵数据”并执行物理删除。
生命周期拦截： 在填充日期格时，系统会实时校验 currentDate > course.endDate。若满足条件，系统将阻断填充并主动清空未来格子，实现了教务层面的“过期自动清理”。
2. 代课薪酬继承逻辑
在后端 process_payroll_worker 算力节点中，系统采用递归查找逻辑：
身份识别： 系统对比“实际出勤人”与“班级指派人”。
价值提取： 若识别为代课，系统会扫描该课程在当前日期所有有效的 assignments，通过 max() 函数提取最高课酬。这种实现方式确保了代课讲师的利益受到制度化保护，无需人工干预。
3. 金融级数据持久化方案
异步写入队列： 后端引入 AsyncIOWorker 守护线程，所有保存操作均先入队再写盘，避免了瞬时高并发导致的磁盘 I/O 阻塞。
原子级覆盖： 使用 os.replace 实现文件的原子交换，确保即使在写盘瞬间断电，也不会产生破损的 JSON 文件。
分布式碎片化： 数据按“核心档案”与“月度数据”切片存储，既降低了单文件体积，也提高了检索效率。
4. 环境自适应部署
通过 start.bat 脚本，系统实现了对宿主环境的零配置要求：
多节点容灾下载： 脚本内置了华为云、阿里淘宝、Python 官网三级下载节点，确保在不同网络环境下均能成功部署 Python 环境。
评论