railwaysystem/docs/handbook/01-project-overview.md

# 01. RailwaySystem 项目全景总览

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

---

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

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

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

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

---

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

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

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

---

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

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

```mermaid
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** 基线，系统已达成以下建设成果：

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

---

## 5. 关键系统特性

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

---

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

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