94 lines
7.2 KiB
Markdown
94 lines
7.2 KiB
Markdown
# SYFJGYD学员管理系统 — 历史资料归档中心 (Archive)
|
||
|
||
> **历史归档声明 (HISTORICAL REFERENCE)**：
|
||
> 本目录归档存放项目启动与早期研发阶段的**甲方原始资料、早期需求草案、早期技术原型与历史数据库设计稿**。
|
||
> 本目录所有内容仅供溯源、审计与沿革参考，**不作为当前系统实现的验收依据**。
|
||
>
|
||
> - **当前一期正式生效业务基线**：[docs/requirements/一期PRD-V1.0.md](../requirements/一期PRD-V1.0.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/`
|
||
- **定位**：项目启动阶段业务方提供的原始需求文件、功能模块初稿与初始 14 张表设计草案。
|
||
- **清单**：
|
||
- `学员管理系统相关需求.docx` / `.md`：业务方最初提出的学员、班级、住宿、培训宏观需求与业务设想；
|
||
- `学员管理系统功能分析_20260831.docx` / `.md`：培训系统功能模块拆解、业务流梳理与菜单原型规划初稿；
|
||
- `学员管理系统数据表设计_20260907_1_.docx` / `.md`：早期数据库 14 张培训业务表设计草案；
|
||
- `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`：核心功能优先级（P0/P1/P2）研讨与业务确认清单；
|
||
- `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`：早期 21 张表字段与 DDL 设计草案；
|
||
- `README.md`：明确该文档为历史设计资料，物理事实源已迁移至 `docs/database-v2/`。
|
||
|
||
---
|
||
|
||
## 📌 业务与技术演进对照
|
||
|
||
| 历史资料分类 | 对应历史文档 | 当前生效的正式替代入口 | 核心差异说明 |
|
||
| :--- | :--- | :--- | :--- |
|
||
| **正式业务需求** | `requirements-history/PRD V0.9` | [**docs/requirements/一期PRD-V1.0.md**](../requirements/一期PRD-V1.0.md) | V1.0 厘清了多对多开班课程、课次、床位与门禁解耦、动态成绩模型等关键规则。 |
|
||
| **需求实现跟踪** | `requirements-history/P0确认表` | [**docs/requirements/一期需求实现进度表.md**](../requirements/一期需求实现进度表.md) | 当前进度表具备逐项前后端源码、数据库表与 331 项测试断言证据。 |
|
||
| **待确认事项** | `raw-materials/相关需求` | [**docs/requirements/甲方需求确认清单.md**](../requirements/甲方需求确认清单.md) | 当前清单聚焦 P0/P1/P2 精准业务阻塞项，用于与段方对齐。 |
|
||
| **数据库物理表** | `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) | 当前团队手册完整涵盖项目总览、业务流、架构设计、数据模型与开发规范。 |
|
||
|
||
---
|
||
|
||
## 核心业务基线速览（PRD V1.0）
|
||
|
||
详细业务规范请完整阅读 [一期PRD-V1.0.md](../requirements/一期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 章 |
|
||
|
||
---
|
||
|
||
## 业务与技术文档的对应关系
|
||
|
||
- **历史资料中心 (`docs/archive/`)**：归档早期交付材料、讨论稿与旧设计。
|
||
- **业务需求中心 (`docs/requirements/`)**：定义**系统应该做什么、业务对象是什么、业务规则与输入输出约束**。
|
||
- **技术审计中心 (`docs/`)**：技术人员请参阅 [docs/README.md](../README.md) 及 [docs/codebase-audit/](../codebase-audit/)，获取当前工程架构、14张历史业务表与PRD差异对比（[14_database_code_diff.md](../codebase-audit/14_database_code_diff.md)）、KingbaseES 实测兼容性等技术事实。
|