wangzhibiao
b12ef9c9e4
- 厘清 doc（业务与产品需求）与 docs（技术架构与代码审计）的职责边界 - doc 根目录保持一期正式生效基线 PRD V1.0，甲供原始材料归整至 raw_materials/，历史过程稿归档至 archive/ - 规范化接纳 wxy_doc/ 早期原型与技术说明并完善说明 - 为 doc/、docs/ 及项目根目录补齐结构化 README.md 导航索引与一键启动指引
4.6 KiB
4.6 KiB
RailwaySystem 业务与产品需求文档中心（doc）
最高基线声明：当前系统一期唯一正式冻结并生效的业务需求基线为根目录下的 [RailwaySystem 智慧培训系统一期 PRD V1.0.md](file:///Users/wzb/Desktop/项目/RailwaySystem/doc/RailwaySystem 智慧培训系统一期 PRD V1.0.md)。 所有开发、测试、数据库建模与功能验收工作，均严格以 PRD V1.0 为最终判定依据。
目录组织架构
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 及 docs/codebase-audit/，获取当前工程架构、14张历史业务表与PRD差异对比（14_database_code_diff.md）、KingbaseES 实测兼容性等技术事实。