wangzhibiao
b12ef9c9e4
- 厘清 doc（业务与产品需求）与 docs（技术架构与代码审计）的职责边界 - doc 根目录保持一期正式生效基线 PRD V1.0，甲供原始材料归整至 raw_materials/，历史过程稿归档至 archive/ - 规范化接纳 wxy_doc/ 早期原型与技术说明并完善说明 - 为 doc/、docs/ 及项目根目录补齐结构化 README.md 导航索引与一键启动指引
53 lines
4.6 KiB
Markdown
53 lines
4.6 KiB
Markdown
# 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 实测兼容性等技术事实。
|