From ccc713d0cc8fcd538bb25a8ad50ec96a4207b371 Mon Sep 17 00:00:00 2001 From: wangzhibiao Date: Thu, 17 Sep 2026 16:31:13 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=87=E6=A1=A3=E4=BF=AE=E6=AD=A3=EF=BC=9A?= =?UTF-8?q?=E6=A0=A1=E5=87=86=E5=BD=93=E5=89=8D=E7=8A=B6=E6=80=81=E5=8F=A3?= =?UTF-8?q?=E5=BE=84=E4=B8=8E=E5=BD=92=E6=A1=A3=E5=BC=95=E7=94=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 4 ++-- docs/README.md | 2 +- docs/current/01-current-status.md | 6 +++--- docs/current/02-phase1-status.md | 2 +- docs/current/03-shared-trial.md | 2 +- docs/current/04-known-gaps.md | 2 +- docs/current/05-next-actions.md | 2 +- docs/handbook/06-api-and-permission-overview.md | 2 +- docs/handbook/07-testing-and-acceptance.md | 4 ++-- docs/handbook/08-deployment-and-release.md | 4 ++-- docs/handbook/09-current-status.md | 4 ++-- docs/reports/README.md | 4 ++-- docs/reports/documentation-audit-20260917.md | 4 ++-- docs/visual/deployment.html | 2 +- docs/visual/index.html | 2 +- docs/visual/release-status.html | 6 +++--- docs/visual/testing.html | 4 ++-- 17 files changed, 28 insertions(+), 28 deletions(-) diff --git a/README.md b/README.md index 5e703ec1e..7b9d08f93 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,9 @@ # SYFJGYD学员管理系统 > **内部工程代码代号**：`RailwaySystem` +> **当前状态**：一期核心业务已完成综合验收，目前进入共享试用阶段。 > **共享试用环境**：[http://192.168.139.230:8082/](http://192.168.139.230:8082/)（部署分支：`feat/cicd-pipeline`） -> **质量验证状态**：后端全量测试 **331 / 331 PASS (0 Failures / 0 Errors)**，管理员/教师/学员三角色无头浏览器 E2E 验证全绿通过。 -> **试用就绪度判定**：`READY_WITH_EXTERNAL_BLOCKERS`（核心教务全链路打通，具备局域网试用条件）。 +> **验收质量详情**：具体测试数量与各模块验证结果请查阅 [一期综合验收最终报告](docs/reports/integrated-acceptance/FINAL_PHASE1_20260917_101044/)。 --- diff --git a/docs/README.md b/docs/README.md index f342b2c80..00c6b0382 100644 --- a/docs/README.md +++ b/docs/README.md @@ -39,7 +39,7 @@ --- ### 2. 📋 [docs/requirements/](requirements/一期需求实现进度表.md) — 业务需求与确认清单 -连接业务与代码的法定事实依据： +连接业务与代码的正式事实依据： - [一期需求实现进度表.md](requirements/一期需求实现进度表.md)：按模块逐项核对每一条需求的前后端代码实现、页面位置与测试证据 - [甲方需求确认清单.md](requirements/甲方需求确认清单.md)：面向沈阳房建公寓段业务老师提炼的待确认分级清单（P0 核心 18 项、P1 细节 12 项、P2 规划 8 项） diff --git a/docs/current/01-current-status.md b/docs/current/01-current-status.md index c8275439d..d82904445 100644 --- a/docs/current/01-current-status.md +++ b/docs/current/01-current-status.md @@ -23,18 +23,18 @@ | **数据库完整性** | 数据孤儿、重复调宿、外键断言 | **`PASS (0 孤儿)`** | 6 项完整性断言全部为 0，数据底座纯净。 | | **凭证合规审计** | 全量源码与配置文件 Secret 扫描 | **`PASS`** | `REAL_SECRET_COMMITTED_COUNT = 0`，无硬编码生产密码。 | | **成绩管理 (C03)** | 新成绩科目权重与录入计算 | **`IN_PROGRESS`** | 基础数据表已就绪，一期业务全闭环与交互正在推进中。 | -| **学员画像 (C05)** | 综合画像雷达图与多维能力分析 | **`PARTIAL_FUNCTION`** | 基础档案与学时检索可用，高阶多维加权画像待业务数据沉淀。 | +| **学员画像 (C05)** | 学员画像能力 | **`PARTIAL_FUNCTION`** | 当前具备基础画像能力，完整业务范围与后续增强内容仍需继续完善或确认。 | | **智能门禁 (DMS)** | 真实环境连通与门锁联动 | **`PARTIALLY_VERIFIED`** | 鉴权/TTL/只读连通验证通过；真实设备与物理硬件因无资源外部阻塞。 | --- -## 2. 当前共享试用业务数据大盘 (Live Dataset) +## 2. 共享试用发布基线数据（2026-09-17） 共享试用数据库 `training` 当前承载的数据来源于全量验证后的综合验收数据集，真实业务规模如下： ```text ======================================================================== - 共享试用环境现存业务数据体量 + 共享试用发布基线数据（2026-09-17） ======================================================================== - 培训开班计划 (Plans) : 13 期 (覆盖多专业、不同生命周期阶段) - 授课教师档案 (Teachers) : 20 名 (涵盖各专业骨干教员) diff --git a/docs/current/02-phase1-status.md b/docs/current/02-phase1-status.md index f2a4ded3c..7e006d39b 100644 --- a/docs/current/02-phase1-status.md +++ b/docs/current/02-phase1-status.md @@ -13,7 +13,7 @@ | :--- | :--- | :--- | | **`DONE_VERIFIED`**
(已完成并验证) | **1. 基础资源**：教师档案、学员主档（国密脱敏）、课程库、教室、实训场地、宿舍房间
**2. 教务主链**：开班计划（草稿/发布/结训）、一班多课绑定、参训名册导入、排课四维时段冲突预检
**3. 现场执行**：开班报到确认、课次出勤打卡、教师代签与请假修正、自主学时台账
**4. 权限与门户**：管理员控制台、教师个人课表工作台、学员个人培训中心、最小权限防越权 | 前后端代码、Kingbase 物理表、自动化测试（331 项）及浏览器 E2E 已全部通过，业务正向主闭环已完全就绪。 | | **`IN_PROGRESS`**
(研发推进中) | **成绩管理闭环 (C03)** | 新成绩体系基础表结构已就绪，成绩科目设置、加权得分计算及综合统计正在进行最终代码闭环与页面联调。 | -| **`PARTIAL_FUNCTION`**
(部分能力具备) | **学员能力画像 (C05)** | 基础档案信息卡、学时积累与报到出勤雷达基础模型已可用；高阶动态加权能力画像有待考核数据进一步沉淀后完善。 | +| **`PARTIAL_FUNCTION`**
(部分能力具备) | **学员能力画像 (C05)** | 当前具备基础画像能力（档案卡与基础数据概览可用），完整业务范围与后续增强内容仍需继续完善或确认。 | | **`EXTERNAL_BLOCKER`**
(外部客观阻塞) | **真实门禁写操作与硬件联动 (DMS)** | 协议通信与只读连通已验证；因真实环境尚未挂载测试房间及门锁硬件通电，物理下发判定为外部客观阻塞。 | | **`CUSTOMER_CONFIRMATION`**
(待甲方业务确认) | **业务口径与组织架构归属** | 详见下方清单，涉及学员名册导入模版格式、报到核验现场硬件配备、请假与门禁权限保留策略等。 | diff --git a/docs/current/03-shared-trial.md b/docs/current/03-shared-trial.md index 5ed80476e..bfd5fe51b 100644 --- a/docs/current/03-shared-trial.md +++ b/docs/current/03-shared-trial.md @@ -11,7 +11,7 @@ - **系统访问地址**：[http://192.168.139.230:8082/](http://192.168.139.230:8082/) - **网络准入要求**：需接入单位办公内网或通过指定局域网网段直接访问 -- **数据源基线**：已从综合验收基线（Integrated QA）全量提升导入至共享试用数据库 `training`，自带 13 个完整测试培训班及对应的人员、排课与出勤流水，开箱即用，无需从零制表。 +- **数据源基线**：已从综合验收基线（Integrated QA）全量提升导入至共享试用数据库 `training`，自带共享试用发布基线数据（2026-09-17 快照：13 计划、20 教师、200 学员、24 课程、118 课次、242 选课、57 住宿、77 考勤）；上述数据为发布快照，试用期间数据会持续变化，实时数量以 training 数据库为准。 --- diff --git a/docs/current/04-known-gaps.md b/docs/current/04-known-gaps.md index 13f90124a..af802b09c 100644 --- a/docs/current/04-known-gaps.md +++ b/docs/current/04-known-gaps.md @@ -9,7 +9,7 @@ | 编号 | 模块 / 缺口项 | 当前实际状态 | 预期差距与原因说明 | 详细依据文档 | | :---: | :--- | :---: | :--- | :--- | | **G-01** | **成绩管理闭环 (C03)** | `IN_PROGRESS`
(推进中) | 物理数据库支持动态科目与权重设计已落地；一期完整正向评分流（教师端录入得分、加权自动折算、结业成绩汇总台账）前端交互正处于最后收敛阶段。 | [Round 3B 成绩能力评估](../reports/integrated-acceptance/INT_QA_R3B_20260917_094500/round-3b/score-current-capability.md) | -| **G-02** | **学员画像能力 (C05)** | `PARTIAL_FUNCTION`
(部分能力) | `/portrait` 页面中，学员基本档案卡、累计自学学时、出勤率分布等基础信息已正常可用；多维能力雷达图目前使用基础模型呈现，高阶动态加权画像需在培训班真实考核数据积累后发挥效用。 | [Round 3B 画像能力评估](../reports/integrated-acceptance/INT_QA_R3B_20260917_094500/round-3b/portrait-current-capability.md) | +| **G-02** | **学员画像能力 (C05)** | `PARTIAL_FUNCTION`
(部分能力) | `/portrait` 页面中基础档案与学时概览可用；当前具备基础画像能力，完整业务范围与后续增强内容仍需继续完善或确认。 | [Round 3B 画像能力评估](../reports/integrated-acceptance/INT_QA_R3B_20260917_094500/round-3b/portrait-current-capability.md) | --- diff --git a/docs/current/05-next-actions.md b/docs/current/05-next-actions.md index 04ab047bc..65fef2102 100644 --- a/docs/current/05-next-actions.md +++ b/docs/current/05-next-actions.md @@ -38,7 +38,7 @@ | :---: | :--- | :--- | :--- | | **P0** | **响应共享试用现场反馈** | 快速响应业务老师在局域网试用中提出的交互阻滞、文案不准确或表单校验细节问题，保障试用体验平滑顺畅。 | 前端交互、教务微调 | | **P1** | **成绩管理闭环 (C03)** | 完善成绩科目配置、教师端分项打分、加权综合成绩折算与导出台账，完成该模块最后一公里闭环。 | `ruoyi-train` 后端及前端 | -| **P2** | **学员画像能力完善 (C05)** | 丰富学员多维画像雷达图指标计算，引入培训考评与实训维度的实际得分联动，提升画像深度。 | 数据分析、ECharts 视图 | +| **P2** | **学员画像能力完善 (C05)** | 在基础画像能力已具备的基础上，根据试用反馈和业务确认推进画像完整业务范围与后续增强内容。 | 数据分析、ECharts 视图 | | **P3** | **DMS 真实物理联调准备** | 持续跟踪段内智能门锁测试环境房间划拨与通电进度，一旦资源具备，立即启动现场行级数据验证与物理发码。 | DMS 适配器、现场联调 | --- diff --git a/docs/handbook/06-api-and-permission-overview.md b/docs/handbook/06-api-and-permission-overview.md index 1c9ec6913..3720014a3 100644 --- a/docs/handbook/06-api-and-permission-overview.md +++ b/docs/handbook/06-api-and-permission-overview.md @@ -74,4 +74,4 @@ * API V2 契约总纲：[docs/api-v2/00_readme.md](../api-v2/00_readme.md) * 全量 DTO/VO 字典：[docs/api-v2/06_dto_vo_catalog.md](../api-v2/06_dto_vo_catalog.md) * 权限与全量错误码定义：[docs/api-v2/10_permission_and_error_codes.md](../api-v2/10_permission_and_error_codes.md) -* 报到与考勤权限迁移验证：[docs/reports/release-notes.md](../reports/release-notes.md) +* 报到与考勤权限迁移验证：[docs/reports/archive/20260915/release-notes.md](../reports/archive/20260915/release-notes.md) diff --git a/docs/handbook/07-testing-and-acceptance.md b/docs/handbook/07-testing-and-acceptance.md index 7800acec5..2210a1f99 100644 --- a/docs/handbook/07-testing-and-acceptance.md +++ b/docs/handbook/07-testing-and-acceptance.md @@ -85,5 +85,5 @@ graph TD ## 5. 技术参考链接 (Technical References) * 核心测试矩阵明细：[docs/_meta/core-business-test-matrix.md](../_meta/core-business-test-matrix.md) -* 最终测试综合报告：[docs/reports/final-test-report.md](../reports/final-test-report.md) -* 浏览器端到端验收进度：[docs/reports/browser-acceptance-report.md](../reports/browser-acceptance-report.md) +* 最终测试综合报告：[docs/reports/archive/20260915/final-test-report.md](../reports/archive/20260915/final-test-report.md) +* 浏览器端到端验收进度：[docs/reports/archive/20260915/browser-acceptance-report.md](../reports/archive/20260915/browser-acceptance-report.md) diff --git a/docs/handbook/08-deployment-and-release.md b/docs/handbook/08-deployment-and-release.md index 75d46001b..08ed1a68f 100644 --- a/docs/handbook/08-deployment-and-release.md +++ b/docs/handbook/08-deployment-and-release.md @@ -97,6 +97,6 @@ npm run build:prod ## 4. 技术参考链接 (Technical References) * Kingbase JDBC 驱动依赖说明：[deployment/kingbase-jdbc-provisioning.md](deployment/kingbase-jdbc-provisioning.md) -* 发版说明与变更记录：[docs/reports/release-notes.md](../reports/release-notes.md) -* 部署验收与就绪报告：[docs/reports/deployment-report.md](../reports/deployment-report.md) +* 发版说明与变更记录：[docs/reports/archive/20260915/release-notes.md](../reports/archive/20260915/release-notes.md) +* 部署验收与就绪报告：[docs/reports/archive/20260915/deployment-report.md](../reports/archive/20260915/deployment-report.md) * 数据库物理模型清单：[docs/database-v2/01_table_inventory.md](../database-v2/01_table_inventory.md) diff --git a/docs/handbook/09-current-status.md b/docs/handbook/09-current-status.md index 8741c98e7..ef7ed77f0 100644 --- a/docs/handbook/09-current-status.md +++ b/docs/handbook/09-current-status.md @@ -54,6 +54,6 @@ ## 4. 技术参考链接 (Technical References) * 视觉化展示门户：[docs/visual/index.html](../visual/index.html) -* 最终测试综合报告：[docs/reports/final-test-report.md](../reports/final-test-report.md) -* 发版说明：[docs/reports/release-notes.md](../reports/release-notes.md) +* 最终测试综合报告：[docs/reports/archive/20260915/final-test-report.md](../reports/archive/20260915/final-test-report.md) +* 发版说明：[docs/reports/archive/20260915/release-notes.md](../reports/archive/20260915/release-notes.md) * 架构白皮书：[03-system-architecture.md](03-system-architecture.md) diff --git a/docs/reports/README.md b/docs/reports/README.md index a38d08ae0..d79f4894b 100644 --- a/docs/reports/README.md +++ b/docs/reports/README.md @@ -1,6 +1,6 @@ # RailwaySystem 质量验收与测试报告中心 (Reports) -> **当前法定最终验收报告入口**：[`integrated-acceptance/FINAL_PHASE1_20260917_101044/`](integrated-acceptance/FINAL_PHASE1_20260917_101044/README.md) +> **当前权威最终验收报告入口**：[`integrated-acceptance/FINAL_PHASE1_20260917_101044/`](integrated-acceptance/FINAL_PHASE1_20260917_101044/README.md) > **试用就绪度裁定**：`PHASE_ONE_TRIAL_READINESS = READY_WITH_EXTERNAL_BLOCKERS` > **测试覆盖总览**：全模块后端单元/集成测试 **331 / 331 PASS (0 Failures / 0 Errors)**，三角色浏览器端到端全链路打通。 @@ -10,7 +10,7 @@ 本目录记录了系统在多轮质量门禁、物理数据库落库断言、角色权限穿透及真实浏览器自动化验证中的所有报告与执行证据： -### 🌟 1. 当前最终验收法定报告 (CURRENT FINAL ACCEPTANCE) +### 🌟 1. 当前最终综合验收报告 (CURRENT FINAL ACCEPTANCE) 若需了解当前系统最新验收结论、质量门禁数据与试用准备度，**请直接查阅以下目录**： diff --git a/docs/reports/documentation-audit-20260917.md b/docs/reports/documentation-audit-20260917.md index 2702ea4f4..88cb058b6 100644 --- a/docs/reports/documentation-audit-20260917.md +++ b/docs/reports/documentation-audit-20260917.md @@ -67,7 +67,7 @@ | **I. 开发规范** | [`docs/handbook/05-module-guide.md`](../handbook/05-module-guide.md) | 详细指导如何基于 `ruoyi-train` 扩展代码、遵循业务不变量与事务设计。 | | **J. Git规范** | [`docs/development/git-commit-convention.md`](../development/git-commit-convention.md) | 明确全中文提交规范（`<中文类型><可选范围>：<中文说明>`）及合规禁令。 | | **K. 测试说明** | [`docs/handbook/07-testing-and-acceptance.md`](../handbook/07-testing-and-acceptance.md) | 涵盖 Maven 单元测试、契约用例、场景集成及 Playwright 浏览器自动化的完整执行体系。 | -| **L. 综合验收结果** | [`docs/reports/integrated-acceptance/FINAL_PHASE1_20260917_101044/executive-summary.md`](integrated-acceptance/FINAL_PHASE1_20260917_101044/executive-summary.md) | 汇总全模块 331 项后端测试、三端无头浏览器 E2E 及数据完整性 0 孤儿的法定验收证明。 | +| **L. 综合验收结果** | [`docs/reports/integrated-acceptance/FINAL_PHASE1_20260917_101044/executive-summary.md`](integrated-acceptance/FINAL_PHASE1_20260917_101044/executive-summary.md) | 汇总全模块 331 项后端测试、三端无头浏览器 E2E 及数据完整性 0 孤儿的最终综合验收证明。 | | **M. 共享试用发布状态**| [`docs/current/03-shared-trial.md`](../current/03-shared-trial.md) | 评定系统试用条件为 `READY_WITH_EXTERNAL_BLOCKERS`，界定局域网教学试用准入范围。 | | **N. DMS当前状态** | [`docs/current/04-known-gaps.md`](../current/04-known-gaps.md) | 客观记录：平台鉴权通过、Token TTL 7200s、只读接口连通；因环境无资源，真实行级映射未验证，物理门锁判定外部阻塞。 | | **O. 已知缺口** | [`docs/current/04-known-gaps.md`](../current/04-known-gaps.md) | 实事求是界定 C03 成绩管理推进中、C05 学员画像为基础功能，杜绝浮夸。 | @@ -80,7 +80,7 @@ 针对 `docs/reports/` 下累积的 220+ 份报告与截图，按以下规则完成治理收口： -1. **当前最终验收法定总结 (CURRENT_SUMMARY)**： +1. **当前最终综合验收总结 (CURRENT_SUMMARY)**： - 确立 [`integrated-acceptance/FINAL_PHASE1_20260917_101044/`](integrated-acceptance/FINAL_PHASE1_20260917_101044/README.md) 为唯一最终收口目录； 2. **历史验收过程证据 (HISTORICAL_EVIDENCE)**： - 保留 `INT_QA_R1` ~ `INT_QA_R3B`、`dms-r3` 实测探针与 Git 提交历史规范化记录，作为合规审计备查底稿； diff --git a/docs/visual/deployment.html b/docs/visual/deployment.html index 9e35b17f7..b4372e82c 100644 --- a/docs/visual/deployment.html +++ b/docs/visual/deployment.html @@ -319,7 +319,7 @@ diff --git a/docs/visual/index.html b/docs/visual/index.html index 4903338fd..e33439984 100644 --- a/docs/visual/index.html +++ b/docs/visual/index.html @@ -495,7 +495,7 @@
331 / 331
后端单元与集成测试
-
Maven Surefire 全量通过 (0 Failures)
+
2026-09-17一期综合验收基线：331项后端测试通过
diff --git a/docs/visual/release-status.html b/docs/visual/release-status.html index 83efcfa63..622692e2c 100644 --- a/docs/visual/release-status.html +++ b/docs/visual/release-status.html @@ -72,7 +72,7 @@
部署分支：feat/cicd-pipeline 代码状态：核心闭环已就绪 - 质量门禁：331 项测试全绿 (100% PASS) + 质量门禁：2026-09-17一期综合验收基线：331项后端测试通过 试用状态：READY_WITH_EXTERNAL_BLOCKERS
@@ -110,7 +110,7 @@ DONE

- 执行 mvn test 门禁，全量 331 个测试用例全部一次性通过 (0 Failures, 0 Errors, 0 Skipped)。 + 2026-09-17一期综合验收基线：331项后端测试全部一次性通过 (0 Failures, 0 Errors, 0 Skipped)。

@@ -260,7 +260,7 @@

内部缺口与外部阻塞

KNOWN GAPS -

客观界定 C03 成绩研发中 (IN_PROGRESS)、C05 画像基础可用 (PARTIAL)、DMS 真实设备外部阻塞。

+

客观界定：C03 = IN_PROGRESS，C05 = PARTIAL_FUNCTION；DMS：真实鉴权与只读连通已验证，真实资源行级映射、Mutation、物理硬件仍为外部阻塞。

查阅缺口清单 (known-gaps.md) → diff --git a/docs/visual/testing.html b/docs/visual/testing.html index 353deb633..a83502904 100644 --- a/docs/visual/testing.html +++ b/docs/visual/testing.html @@ -173,7 +173,7 @@
331 / 331
后端单元与集成测试
-
Maven Surefire · ALL PASS
+
2026-09-17一期综合验收基线：331项后端测试通过
@@ -257,7 +257,7 @@

第 1 层：后端单元与集成测试 (Backend Unit / Integration) PASS

Maven Surefire 全量测试集，涵盖状态机流转、排课冲突算法、脱敏工具类与权限注解断言。

- 331 / 331 PASS + 331 PASS (2026-09-17验收基线)