# RailwaySystem 业务与产品需求文档中心（doc）

> **最高基线声明**：当前系统一期唯一正式冻结并生效的业务需求基线为根目录下的 [RailwaySystem 智慧培训系统一期 PRD V1.0.md](file:///Users/wzb/Desktop/项目/RailwaySystem/doc/RailwaySystem 智慧培训系统一期 PRD V1.0.md)。
> 所有开发、测试、数据库建模与功能验收工作，均严格以 **PRD V1.0** 为最终判定依据。

---

## 目录组织架构

```text
doc/
├── README.md                                          # 【本文件】产品与业务需求中心全景导览
├── RailwaySystem 智慧培训系统一期 PRD V1.0.md          # ★★★ 当前唯一正式生效的一期业务需求基线（已冻结）
├── raw_materials/                                     # 甲方原始交付需求与设计资料
│   ├── README.md                                      # 原始材料目录说明
│   ├── 学员管理系统功能分析_20260831.docx / .md         # 原始功能拆解与菜单规划初稿
│   ├── 学员管理系统数据表设计_20260907_1_.docx / .md     # 原始14张培训业务表设计草案
│   └── 学员管理系统相关需求.docx / .md                   # 原始学员培训与教务综合需求
├── archive/                                           # 历史演进过程稿与讨论底稿归档
│   ├── README.md                                      # 历史归档说明
│   ├── RailwaySystem 智慧培训系统一期 PRD V0.9.md      # 一期 PRD 历史讨论稿（上一版草案）
│   ├── RailwaySystem 一期 P0 需求确认表 V0.1.md        # 早期核心优先级对齐清单
│   ├── RailwaySystem 一期需求分析与业务基线 V0.1.md     # 早期需求分析报告
│   └── RailwaySystem 一期默认开发决策与需求假设 V0.1.md # 早期技术假设与边界推演
└── wxy_doc/                                           # 早期技术原型与设计说明（仅作技术演进参考）
    ├── README.md                                      # 目录说明
    ├── 智慧培训系统一期详细开发说明书.md               # 早期技术说明草案（暂不使用）
    ├── railwaysystem.html                             # 基于 ELK 的系统拓扑可视化原型
    └── elk.bundled.js                                 # 拓扑可视化依赖 JS 引擎
```

---

## 核心业务基线速览（PRD V1.0）

详细业务规范请完整阅读 [RailwaySystem 智慧培训系统一期 PRD V1.0.md](file:///Users/wzb/Desktop/项目/RailwaySystem/doc/RailwaySystem 智慧培训系统一期 PRD V1.0.md)，主要核心域包括：

| 业务域 | 涉及核心对象 | 关键业务规则与一期边界 | PRD 对应章节 |
| :--- | :--- | :--- | :--- |
| **基础信息** | 教师、学员、课程 | 学员身份证国密/SM4加密存储与脱敏；课程支持一期基础属性，不做多版本与审批流 | 第 5、6、7 章 |
| **教学资源** | 教室、实训场地、电子班牌 | 支持资源状态流转；电子班牌支持与教室、课次绑定及日程轮播展示 | 第 8、9、10 章 |
| **培训与教务** | 开班计划、开班课程、课次、参训学员 | **开班计划支持多门课程**；排课细化到具体课次；明确独立的班级—学员参训关系 | 第 11、12、13、14 章 |
| **报到与考勤** | 开班报到、课次考勤、学习记录 | 区分班级报到与具体课次考勤；考勤记录精确关联到课次；记录学员自学与实训时长 | 第 15、16、17 章 |
| **生活后勤** | 宿舍楼栋、房间、床位、门禁授权 | **房间与床位拆分**为两级模型；**住宿事实与门禁权限解耦**，支持按床位安排并独立下发门禁授权 | 第 18、19、20 章 |
| **考核与画像** | 成绩科目/权重、学员得分、综合画像 | 彻底摒弃固定三列成绩，支持**动态成绩科目与权重**；多维雷达图与基础能力画像分析 | 第 21、22、23 章 |

---

## 业务与技术文档的对应关系

- **业务需求中心 (`doc/`)**：定义**系统应该做什么、业务对象是什么、业务规则与输入输出约束**。
- **技术审计中心 (`docs/`)**：技术人员请参阅 [docs/README.md](file:///Users/wzb/Desktop/项目/RailwaySystem/docs/README.md) 及 [docs/codebase-audit/](file:///Users/wzb/Desktop/项目/RailwaySystem/docs/codebase-audit/)，获取当前工程架构、14张历史业务表与PRD差异对比（[14_database_code_diff.md](file:///Users/wzb/Desktop/项目/RailwaySystem/docs/codebase-audit/14_database_code_diff.md)）、KingbaseES 实测兼容性等技术事实。