Functional Domain Architecture
14 大核心业务模块清单
按照能力域严格分为培训资源、教务编排、现场执行与数据分析 4 大分组。默认仅呈现模块标识与一句话作用，点击可展开详细业务规则与物理表。
Domain 1
6 模块全部实现
培训资源域 (Master Data)
支撑智慧培训基地的基础人、货、场与生活主数据设施。
教师管理
Teacher
维护培训师资档案、所属专业领域、职称与联系方式，支撑课程主讲人指派。
查看详细规则与模型
唯一性规则：教师手机号全局唯一，重复录入强行拦截 (40001)。
物理表名：
train_teacher (主键 t_id)实测结论：页面访问、列表查询、手机号防重复验证通过。
学员档案
Student
统一管理铁路职工参训人员主档，维护所属铁路局、站段、工种及敏感身份证安全脱敏。
查看详细规则与模型
脱敏与安全：身份证散列存盘，对外接口仅返回末4位脱敏掩码，杜绝明文暴露。
主档状态：维护
status=1:正常 与 status=0:停用，停用学员严禁报名。物理表名：
train_student (主键 s_id 为 32 位 UUID)课程管理
Course
标准化课程库管理，定义课程编码、理论与实操学时、课程类别及教材大纲。
查看详细规则与模型
业务约束：课程编码全局唯一；学时
c_duration 必须大于 0。物理表名：
train_course (主键 c_id)实测结论：课程建档、课时汇总与状态维护通过。
理论教室
Classroom
管理基地理论教学教室，设定容纳人数、楼层门牌号并关联挂载电子班牌终端。
查看详细规则与模型
容量约束：容量非空且大于 0，作为排课选址基础参考。
班牌绑定：支持绑定 0/1/N 块电子班牌，详情接口实时映射。
物理表名：
train_classroom_info (主键 class_room_id)实训场地
Training Site
管理机务、电务、工务、供电等室外实训演练基地，支持大型特种设备实训排产。
查看详细规则与模型
互斥规则：在排课中与理论教室满足严格 XOR 互斥逻辑。
物理表名：
train_training_site (主键 site_id 为 32 位 UUID)实测结论：场地创建、容量校验与排课占用预警验证通过。
后勤宿舍
Dormitory
提供基地学员宿舍楼栋、房号与床位分配管理，联动学员报名中的住宿需求。
查看详细规则与模型
业务联动：由报名表
accommodation_required = 1 驱动床位分配。物理表名：
train_dormitory_info (主键 dorm_id), train_accommodation实测结论：宿舍主数据维护及入住状态管理正常。
Domain 2
4 模块全部实现
教务编排域 (Scheduling Core)
负责计划拟定、课程师资绑定、参训名单导入及四维排课防重叠调度。
培训计划
Training Plan
拟定培训班方案，维护班级周期、报到截止日、计划招生人数上限及全生命周期状态流转。
查看详细规则与模型
状态流转：
0:草稿 → 1:进行中 → 2:已结束。结训保护：结训时 Plan 置为 2，锁定排课变更，批量完成活动学员。
物理表名：
train_class_plan (主键 plan_id 32 位 UUID)计划课程
Plan Course
构建培训计划与课程的关联映射，指派授课教师，自动汇总开班总学时。
查看详细规则与模型
关联一致性：作为排课 Lesson 的外键依赖，禁止跨计划引用。
物理表名：
train_plan_course (主键 plan_course_id)实测结论：课程批量绑定与学时自动联动通过。
参训管理
Enrollment
管理学员入班名单、招生容量防超额守卫，并维护学员在班级的参训状态流转。
查看详细规则与模型
双重硬拦截：重复报名拦截 (40030)；招生容量上限拦截 (40031)。
参训状态机：
0:待报到 → 1:已报到 → 2:请假 → 3:退训 → 4:已完成。物理表名：
train_enrollment (主键 enrollment_id)排课调度
Scheduling
编制每日具体课次，集成四维冲突预检机制，输出可视化聚合日课表视图。
查看详细规则与模型
四维冲突预检：教师冲突硬检；教室/场地/班级重叠 Warning 提示并允许确认保存。
合规要求：严格禁止任何 force / override 违规旁路参数。
物理表名：
train_lesson (主键 lesson_id)
Domain 3
3 模块全部通过验证
现场执行域 (Execution & IoT)
支撑学员现场核验报到、课堂考勤打卡留痕与电子班牌终端信息交互。
开班报到
Class Report
学员到校开班报到身份核验，强事务联动流转报名状态至已报到，防重复报到。
查看详细规则与模型
强事务联动：报到写入
train_class_report，同时联动更新 enrollment_status = 1 且记录 join_time。重复报到防范：已报到学员再次报到触发拦截 (40050)。
物理表名：
train_class_report (主键 report_id)课次考勤
Attendance
处理课次签到与签退打卡，保证首次打卡时间幂等性，支持人工代签审计留痕。
查看详细规则与模型
打卡幂等性：重复调用签到或签退时，严格保持首次
signInTime/signOutTime 不变。人工代签留痕：后台调整考勤自动置
manual_flag = 1，记录调整人与备注。物理表名：
train_student_checkin (主键 checkin_id)电子班牌
Electronic Board
管理挂载在教室的电子显示终端，在课表中提供智能降级映射与物联页面呈现。
查看详细规则与模型
课表降级规则：0 块板为 null，恰好 1 块板为对应 SN，>1 块板降级为 null。
前端路由：前端正式路由为
/equip/board，对应后端接口 /train/board。物理表名：
train_electronic_board (主键 board_id 32 位 UUID)
Domain 4
V2 READ MODEL · PASS
数据分析域 (Analytics & Reports)
聚合教务执行过程数据，提供只读统计报表与画像导出，保持架构隔离。
统计分析与报表
Analytics
涵盖报到率统计、考勤打卡统计、学员课时完成度及综合画像等只读报表展示与数据导出。
查看详细规则与模型
架构隔离：当前版本已完成 V2 Read Model 接入，提供稳定的只读查询与导出能力，保持数据库单向读取。
涵盖视图：Report 报到报表、Checkin 考勤报表、Duration 学时统计、Portrait 画像表 4 个视图均通过验收。
演进规划：高级画像算法模型与多维统计扩展标为
RESERVED / FUTURE EXTENSION。