Files
railwaysystem/doc/README.md
T

52 lines
4.6 KiB
Markdown
Raw Normal View History

# 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 实测兼容性等技术事实。