blp/railwaysystem
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
f7db7b592cf2cb5f4b6ecd0a0c25dc62a8551f0d
railwaysystem/docs/archive/README.md
T

7.2 KiB
Raw Blame History

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

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

🧭 历史资料组织架构

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，表结构差异详见 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 V1.0 厘清了多对多开班课程、课次、床位与门禁解耦、动态成绩模型等关键规则。
需求实现跟踪 requirements-history/P0确认表 docs/requirements/一期需求实现进度表.md 当前进度表具备逐项前后端源码、数据库表与 331 项测试断言证据。
待确认事项 raw-materials/相关需求 docs/requirements/甲方需求确认清单.md 当前清单聚焦 P0/P1/P2 精准业务阻塞项，用于与段方对齐。
数据库物理表 database-history/DDL规范 docs/database-v2/01_table_inventory.md 当前金仓物理表结构及初始化脚本位于 RuoYi-Vue/sql/train/v2/。
系统架构与指南 legacy-design/详细开发说明书 docs/handbook/01-project-overview.md 当前团队手册完整涵盖项目总览、业务流、架构设计、数据模型与开发规范。

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

详细业务规范请完整阅读 一期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 及 docs/codebase-audit/，获取当前工程架构、14张历史业务表与PRD差异对比（14_database_code_diff.md）、KingbaseES 实测兼容性等技术事实。
Reference in new issue View Git Blame Copy Permalink