01. RailwaySystem 项目全景总览

文档定位：面向评审专家、业务主管、系统管理员及新入职人员的业务与系统总览手册。 当前基线：Final Candidate 5a49b2e2988bf23ca2a70568264c05b24dfda1b6 (origin/feat/cicd-pipeline)

1. 系统建设背景与解决的问题

铁路运输体系对从业人员的专业技能、作业标准与应急处置能力有着极其严苛的要求，常态化、规范化的职工培训是保障铁路行车安全的基石。然而，在传统的铁路职工培训与教务管理实践中，普遍存在以下业务痛点：

教务协同链条割裂：开班计划、学员名单、师资配置、教室安排分散在不同表格或独立系统中，排课冲突（如同一名教师或教室在同一时间被多班复用）频发，依赖人工协调效率低下。
学员档案与敏感信息保护不足：学员来自全国各铁路局集团公司，身份证号、手机号等关键个人隐私直接明文存储，存在合规与信息安全泄露隐患。
现场考勤与打卡真实性难以保证：以往多采用纸质签到或事后手工补录，存在代签、漏签问题；同时，缺乏针对具体课次（上午/下午不同课程）的精准到课统计。
后勤保障与教务脱钩：学员集中面授期间的宿舍分配往往滞后，男女混住风险、床位超额入住等情况难以在教务源头进行有效拦截。
学情考核与画像不够多维：传统的固定单一分数无法真实衡量学员在理论考试、实操演练、课堂出勤及自学时长等维度的综合素质。

RailwaySystem 智慧培训系统正是为了解决上述问题而研发的一体化数字化教务中枢，旨在打造一个规范、高效、安全、智能的铁路全生命周期培训管理平台。

2. 核心用户角色与使用场景

系统围绕铁路职工培训的实际业务场景，为四类典型用户提供针对性服务：

用户角色	核心使用场景	核心关注价值
教务管理员 (Admin)	编制年度/月度培训班计划、批量导入参训学员名单、调度教室与实训场地、统筹宿舍分配、监控全校开班运行状态。	全局资源统筹无冲突、批量操作高效、敏感数据安全合规。
授课教师 (Teacher)	查看个人授课日程表、查看本堂课应到/实到学员花名册、现场核验与代签补卡、登记课后学员考核成绩。	课表清晰直观、打卡操作便捷、考勤修正留痕可追溯。
参训学员 (Student)	凭身份证/人脸/动态码完成开班现场报到、按课次完成出勤打卡、查询个人住宿房间、查阅培训课程得分与学时。	报到极速通行、个人信息受保护、培训档案清晰透明。
管理决策者 (Leader)	查阅各期培训班综合报表、出勤率合格率分布、职工学时积累与多维能力画像，为岗位评定与人才选拔提供数据支撑。	数据真实权威、多维画像全面、决策有据可依。

3. 系统核心业务模块布局

系统在一期建设中构建了覆盖全业务流程的 14 大核心功能模块：

graph TD
    subgraph M1["基础资源主数据"]
        T["教师档案管理"]
        S["学员主数据建档"]
        C["培训课程资源库"]
        CR["理论教室信息"]
        TS["实训演练基地"]
    end

    subgraph M2["教务与计划管理"]
        P["开班计划编制"]
        PC["本期课程绑定"]
        E["参训名单导入"]
        L["课次编排排课"]
        SC["四维冲突智能预检"]
    end

    subgraph M3["现场执行与后勤"]
        R["开班现场报到 (人脸/刷卡/扫码)"]
        A["课次考勤打卡 (签到/签退/修正)"]
        D["宿舍楼栋与床位分配 (防混住)"]
        B["电子班牌物联终端展示"]
    end

    subgraph M4["考核分析与成果"]
        AN["报到/考勤统计分析"]
        DU["学习时长精准累计"]
        PT["学员多维能力画像"]
    end

    M1 --> M2
    M2 --> M3
    M3 --> M4

4. 一期核心成果与交付边界

截至当前 Final Candidate 基线，系统已达成以下建设成果：

业务闭环 100% 贯通：从教务准备、开班发布、现场报到、智能排课、课堂考勤、计划结训到学情分析，全流程 10 个正式业务环节实现数据无缝流转与状态联动。
跨表业务不变量强管控：
- 学员敏感数据防护：学员身份证号在数据库落库时采用不可逆散列 + 安全加密存储，界面与接口统一进行掩码脱敏（仅显示后 4 位）。
- 四维排课防冲突算法：教师时段冲突、教室占用冲突、实训场地占用冲突及同一班级课次重叠在编排时实时预检，确保教学资源不出现撞车。
- 严格宿舍防混住校验：男性学员严禁分入女寝，女性学员严禁分入男寝，且严格受限于房间核定容纳人数。
- 结训联动流转：培训计划完结时，一键自动批量将班级在读学员状态联动更新为“已完成”，杜绝人工遗漏。
国产化适配与平滑升级：
- 全面完成国产人大金仓数据库（KingbaseES V009R003C018）的生产级适配与 21 张物理表重构。
- 建立了严谨的发布增量迁移机制（CURRENT_RELEASE_DB_DELTA = 3），确保数据迁移的安全可控。

5. 关键系统特性

严密的权限安全体系：基于 RBAC 标准模型，对数据查询、导出、报到确认及考勤调整等敏感操作进行细粒度权限控制，所有人工代签与状态修正强制写入审计流水留痕。
高鲁棒性的业务接口：全系统定义了统一的业务错误码体系（40001~50001），杜绝系统级 500 异常直接暴露给前端用户，提供友好的业务提示。
工业级自动化质量门禁：后端测试套件（154 项单元与契约测试、6 大场景核心闭环测试）全部通过，真实 API 请求 0 报错，数据库无脏数据残留。

6. 技术参考链接 (Technical References)

业务需求最高基线：一期 PRD V1.0 与业务需求中心
系统业务全流程与状态机：02-business-process.md
系统技术架构设计：03-system-architecture.md
核心 API 契约总览：docs/api-v2/00_readme.md
数据库物理模型清单：docs/database-v2/01_table_inventory.md

6.6 KiB Raw Permalink Blame History Unescape Escape