From e62904a853819462b72bc4fe60d193c516c62f13 Mon Sep 17 00:00:00 2001 From: wangzhibiao Date: Thu, 17 Sep 2026 16:45:29 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=87=E6=A1=A3=E6=95=B4=E7=90=86=EF=BC=9A?= =?UTF-8?q?=E7=BB=9F=E4=B8=80=E4=B8=80=E6=9C=9F=E9=9C=80=E6=B1=82=E4=B8=8E?= =?UTF-8?q?PRD=E5=85=A5=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/current/02-phase1-status.md | 1 + docs/requirements/README.md | 24 +++++++++++++++++++ .../requirements/一期PRD-V1.0.md | 5 +++- 3 files changed, 29 insertions(+), 1 deletion(-) create mode 100644 docs/requirements/README.md rename doc/RailwaySystem 智慧培训系统一期 PRD V1.0.md => docs/requirements/一期PRD-V1.0.md (99%) diff --git a/docs/current/02-phase1-status.md b/docs/current/02-phase1-status.md index 7e006d39b..f6250f06a 100644 --- a/docs/current/02-phase1-status.md +++ b/docs/current/02-phase1-status.md @@ -23,6 +23,7 @@ 如需查阅每一条需求的详细代码文件位置、SQL 表名、测试用例或具体待确认问题，请点击以下权威文档： +- 📖 [**一期 PRD V1.0 (业务定义与需求基线)**](../requirements/一期PRD-V1.0.md)：一期系统正式业务需求冻结基线，涵盖核心领域对象、业务规则与一期开发边界。 - 📋 [**一期需求实现进度表 (逐项核验)**](../requirements/一期需求实现进度表.md)：包含域 A~G 共数十项功能点的前后端代码文件、断言证据与下一步建议。 - ❓ [**一期甲方需求确认清单 (开会对齐)**](../requirements/甲方需求确认清单.md)：系统归纳 P0(核心阻塞 18 项)、P1(业务形态 12 项)、P2(长远规划 8 项) 业务确认表。 diff --git a/docs/requirements/README.md b/docs/requirements/README.md new file mode 100644 index 000000000..ce8749fba --- /dev/null +++ b/docs/requirements/README.md @@ -0,0 +1,24 @@ +# SYFJGYD学员管理系统 — 需求与业务基线中心 (Requirements) + +> **最高原则**：严格区分“业务需求定义”、“代码实现现状”与“外部待确认事项”，三者职责明确、各司其职，不得相互混淆或替代。 + +--- + +## 🧭 需求文档矩阵与职责边界 + +本目录统领系统一期全部正式业务需求、逐项落地实现进度以及面向甲方的待对齐清单： + +| 权威文档 | 文档性质 | 职责与定位说明 | 适用场景 | +| :--- | :--- | :--- | :--- | +| [**一期PRD-V1.0.md**](一期PRD-V1.0.md) | **需求定义（业务基线）** | **一期唯一正式冻结的业务需求基线**。
定义系统应该做什么、业务领域模型（教师、学员、开班、课程、排课、考勤、成绩、宿舍、门禁等）、业务规则约束与一期开发边界。
不随日常开发进度而变动。 | 业务领域模型学习、规则裁决、验收准则对照 | +| [**一期需求实现进度表.md**](一期需求实现进度表.md) | **当前实现状态（代码事实）** | **客观反映一期各项规划功能在代码与数据库层面的实际落地度**。
逐项梳理域 A~G 几十个细分功能点的前后端代码文件、数据库表名、331项自动化测试与浏览器验证状态（区分 `DONE_VERIFIED`、`IN_PROGRESS`、`PARTIAL_FUNCTION` 与 `EXTERNAL_BLOCKER`）。 | 开发跟踪、代码走查、功能完成度盘点 | +| [**甲方需求确认清单.md**](甲方需求确认清单.md) | **待业务确认项（沟通清单）** | **提炼需要与沈阳房建公寓段业务主管/指导老师现场开会对齐的关键事项**。
系统归纳 P0（核心业务阻塞 18 项）、P1（业务形态优化 12 项）与 P2（长远规划 8 项）问题清单与推荐建议。 | 甲方会议、业务调研、客户沟通与策略确认 | + +--- + +## 📌 使用指引 + +1. **若需要了解业务逻辑与功能规则**：请通读 [一期PRD-V1.0.md](一期PRD-V1.0.md)； +2. **若需要核对系统某项功能到底做没做、在哪个文件**：请查阅 [一期需求实现进度表.md](一期需求实现进度表.md)； +3. **若需要与段方领导/老师沟通确认业务细节**：请调阅 [甲方需求确认清单.md](甲方需求确认清单.md)； +4. **若需要了解系统当前整体运行状态与共享试用说明**：请前往上层速览中心 [docs/current/](../current/README.md)。 diff --git a/doc/RailwaySystem 智慧培训系统一期 PRD V1.0.md b/docs/requirements/一期PRD-V1.0.md similarity index 99% rename from doc/RailwaySystem 智慧培训系统一期 PRD V1.0.md rename to docs/requirements/一期PRD-V1.0.md index 80b677457..2278f5b7c 100644 --- a/doc/RailwaySystem 智慧培训系统一期 PRD V1.0.md +++ b/docs/requirements/一期PRD-V1.0.md @@ -4,7 +4,10 @@ > **文档状态：** 一期内部开发基线 > **修订依据：** 第二次项目会议结论 > **适用阶段：** 业务模型冻结 → 数据库 V2 → API 设计 → Issue 拆分 → 开发 -> **后续版本：** 现场验证后根据甲方反馈升级 V1.1 +> **后续版本：** 现场验证后根据甲方反馈升级 V1.1
+> - **当前定位**：一期正式业务需求冻结基线
+> - **当前实现状态请参见**：[一期需求实现进度表.md](一期需求实现进度表.md)
+> - **甲方待确认事项请参见**：[甲方需求确认清单.md](甲方需求确认清单.md) > > 本版本遵循一个核心原则： >