railwaysystem/docs/archive/README.md

# SYFJGYD学员管理系统 — 历史资料归档中心 (Archive)

> **历史归档声明 (HISTORICAL REFERENCE)**：
> 本目录归档存放项目启动与早期研发阶段的**甲方原始资料、早期需求草案、早期技术原型与历史数据库设计稿**。
> 本目录所有内容仅供溯源、审计与沿革参考，**不作为当前系统实现的验收与业务依据**。
>
> - **当前一期正式生效需求基线**：[docs/requirements/一期PRD-V1.0.md](../requirements/一期PRD-V1.0.md)
> - **当前一期需求代码实现状态**：[docs/requirements/一期需求实现进度表.md](../requirements/一期需求实现进度表.md)
> - **当前面向甲方待确认事项**：[docs/requirements/甲方需求确认清单.md](../requirements/甲方需求确认清单.md)
> - **当前数据库物理结构事实源**：[docs/database-v2/](../database-v2/01_table_inventory.md) 与 `RuoYi-Vue/sql/train/v2/`
> - **当前系统运行与试用现状**：[docs/current/](../current/README.md)

---

## 🧭 历史资料组织架构

```text
docs/archive/
├── README.md                      # 【本文件】统一历史资料归档入口全景导览
├── raw-materials/                 # 甲方原始交付需求、功能分析与初版数据表设计（docx / md 原件）
├── requirements-history/          # 需求演进过程稿（PRD V0.9、V0.1 调研表、业务基线草案）
├── legacy-design/                 # 早期技术原型资料（详细开发说明书草案、ELK 拓扑原型）
└── database-history/              # 历史数据库设计资料（Kingbase DDL 规范草稿）
```

---

## 📂 归档子目录职责与清单

### 1. 甲方原始资料：`raw-materials/`
- **定位**：项目启动阶段业务方提供的原始需求文件、功能模块初稿与初版数据表设计草案。
- **清单**：
  - `学员管理系统相关需求.docx` / `.md`：业务方最初提出的学员、班级、住宿、培训宏观需求与业务设想；
  - `学员管理系统功能分析_20260831.docx` / `.md`：培训系统功能模块拆解、业务流梳理与菜单原型规划初稿；
  - `学员管理系统数据表设计_20260907_1_.docx` / `.md`：早期数据库数据表设计草案；
  - `README.md`：原始交付材料说明与演变提示。
- **演变说明**：所有有效需求已提炼至 [一期PRD-V1.0.md](../requirements/一期PRD-V1.0.md)，表结构差异详见 [14_database_code_diff.md](../codebase-audit/14_database_code_diff.md)。

### 2. 早期需求草案：`requirements-history/`
- **定位**：需求演进与讨论过程中的中间草稿，用于追溯决策依据。
- **清单**：
  - `RailwaySystem 智慧培训系统一期 PRD V0.9.md`：一期产品需求讨论草案（已升级为 V1.0）；
  - `RailwaySystem 一期 P0 需求确认表 V0.1.md`：核心功能优先级研讨与业务确认清单；
  - `RailwaySystem 一期需求分析与业务基线 V0.1.md`：面向业务方需求的初步分析与功能点映射草稿；
  - `RailwaySystem 一期默认开发决策与需求假设 V0.1.md`：早期针对甲供资料不完备部分制定的默认技术假设；
  - `README.md`：历史版本归档清单与核心演进对比。

### 3. 早期技术原型：`legacy-design/`
- **定位**：早期编写的系统设计与前端拓扑可视化原型（HISTORICAL REFERENCE）。
- **清单**：
  - `智慧培训系统一期详细开发说明书.md`：早期技术说明草案（基于旧数据表与旧需求）；
  - `railwaysystem.html`：基于 ELK 布局引擎生成的培训系统架构与业务拓扑可视化原型；
  - `elk.bundled.js`：前端拓扑布局引擎打包库；
  - `README.md`：早期技术原型归档说明。

### 4. 旧数据库设计：`database-history/`
- **定位**：数据库建模阶段的历史设计冻结稿，供追溯字段设计思路。
- **清单**：
  - `RailwaySystem 数据库 V2 字段设计与 Kingbase DDL 规范 V1.0.md`：早期数据表字段与 DDL 设计草案；
  - `README.md`：明确该文档为历史设计资料，物理事实源已迁移至 `docs/database-v2/`。

---

## 📌 历史资料与当前正式入口对应关系

| 历史资料分类 | 对应历史文档 | 当前生效的正式替代入口 | 说明 |
| :--- | :--- | :--- | :--- |
| **正式业务需求** | `requirements-history/PRD V0.9` | [**docs/requirements/一期PRD-V1.0.md**](../requirements/一期PRD-V1.0.md) | 一期唯一正式冻结的业务需求基线。 |
| **需求实现跟踪** | `requirements-history/P0确认表` | [**docs/requirements/一期需求实现进度表.md**](../requirements/一期需求实现进度表.md) | 按功能点跟踪前后端代码与验证状态。 |
| **待确认事项** | `raw-materials/相关需求` | [**docs/requirements/甲方需求确认清单.md**](../requirements/甲方需求确认清单.md) | 聚焦待与段方开会对齐的业务事项。 |
| **数据库物理表** | `database-history/DDL规范` | [**docs/database-v2/01_table_inventory.md**](../database-v2/01_table_inventory.md) | 物理建表与初始化脚本位于 `RuoYi-Vue/sql/train/v2/`。 |
| **系统架构与指南** | `legacy-design/详细开发说明书` | [**docs/handbook/01-project-overview.md**](../handbook/01-project-overview.md) | 系统级团队操作手册与全景指南。 |