railwaysystem/docs/archive/README.md

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

历史归档声明 (HISTORICAL REFERENCE)： 本目录归档存放项目启动与早期研发阶段的甲方原始资料、早期需求草案、早期技术原型与历史数据库设计稿。 本目录所有内容仅供溯源、审计与沿革参考，不作为当前系统实现的验收与业务依据。

• 当前一期正式生效需求基线：docs/requirements/一期PRD-V1.0.md
• 当前一期需求代码实现状态：docs/requirements/一期需求实现进度表.md
• 当前面向甲方待确认事项：docs/requirements/甲方需求确认清单.md
• 当前数据库物理结构事实源：docs/database-v2/ 与 RuoYi-Vue/sql/train/v2/
• 当前系统运行与试用现状：docs/current/

---

🧭 历史资料组织架构

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，表结构差异详见 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-history/P0确认表	docs/requirements/一期需求实现进度表.md	按功能点跟踪前后端代码与验证状态。
待确认事项	raw-materials/相关需求	docs/requirements/甲方需求确认清单.md	聚焦待与段方开会对齐的业务事项。
数据库物理表	database-history/DDL规范	docs/database-v2/01_table_inventory.md	物理建表与初始化脚本位于 RuoYi-Vue/sql/train/v2/。
系统架构与指南	legacy-design/详细开发说明书	docs/handbook/01-project-overview.md	系统级团队操作手册与全景指南。