blp/railwaysystem
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

文档修正：校准当前状态口径与归档引用

Browse Source
This commit is contained in:
wangzhibiao committed 2026-09-17 16:31:13 +08:00
1 parent 72bdad8c77
commit ccc713d0cc
17 files changed
+28 -28
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

README.md
+2 -2
View File
@@ -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/)。
---
docs/README.md
+1 -1
View File
@@ -39,7 +39,7 @@
---
### 2. 📋 [docs/requirements/](requirements/一期需求实现进度表.md) — 业务需求与确认清单
连接业务与代码的法定事实依据：
连接业务与代码的正式事实依据：
- [一期需求实现进度表.md](requirements/一期需求实现进度表.md)：按模块逐项核对每一条需求的前后端代码实现、页面位置与测试证据
- [甲方需求确认清单.md](requirements/甲方需求确认清单.md)：面向沈阳房建公寓段业务老师提炼的待确认分级清单（P0 核心 18 项、P1 细节 12 项、P2 规划 8 项）
docs/current/01-current-status.md
+3 -3
View File
@@ -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 名 (涵盖各专业骨干教员)
docs/current/02-phase1-status.md
+1 -1
View File
@@ -13,7 +13,7 @@
| :--- | :--- | :--- |
| **`DONE_VERIFIED`**<br>(已完成并验证) | **1. 基础资源**：教师档案、学员主档（国密脱敏）、课程库、教室、实训场地、宿舍房间<br>**2. 教务主链**：开班计划（草稿/发布/结训）、一班多课绑定、参训名册导入、排课四维时段冲突预检<br>**3. 现场执行**：开班报到确认、课次出勤打卡、教师代签与请假修正、自主学时台账<br>**4. 权限与门户**：管理员控制台、教师个人课表工作台、学员个人培训中心、最小权限防越权 | 前后端代码、Kingbase 物理表、自动化测试（331 项）及浏览器 E2E 已全部通过，业务正向主闭环已完全就绪。 |
| **`IN_PROGRESS`**<br>(研发推进中) | **成绩管理闭环 (C03)** | 新成绩体系基础表结构已就绪，成绩科目设置、加权得分计算及综合统计正在进行最终代码闭环与页面联调。 |
| **`PARTIAL_FUNCTION`**<br>(部分能力具备) | **学员能力画像 (C05)** | 基础档案信息卡、学时积累与报到出勤雷达基础模型已可用；高阶动态加权能力画像有待考核数据进一步沉淀后完善。 |
| **`PARTIAL_FUNCTION`**<br>(部分能力具备) | **学员能力画像 (C05)** | 当前具备基础画像能力（档案卡与基础数据概览可用），完整业务范围与后续增强内容仍需继续完善或确认。 |
| **`EXTERNAL_BLOCKER`**<br>(外部客观阻塞) | **真实门禁写操作与硬件联动 (DMS)** | 协议通信与只读连通已验证；因真实环境尚未挂载测试房间及门锁硬件通电，物理下发判定为外部客观阻塞。 |
| **`CUSTOMER_CONFIRMATION`**<br>(待甲方业务确认) | **业务口径与组织架构归属** | 详见下方清单，涉及学员名册导入模版格式、报到核验现场硬件配备、请假与门禁权限保留策略等。 |
docs/current/03-shared-trial.md
+1 -1
View File
@@ -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 数据库为准。
---
docs/current/04-known-gaps.md
+1 -1
View File
@@ -9,7 +9,7 @@
| 编号 | 模块 / 缺口项 | 当前实际状态 | 预期差距与原因说明 | 详细依据文档 |
| :---: | :--- | :---: | :--- | :--- |
| **G-01** | **成绩管理闭环 (C03)** | `IN_PROGRESS`<br>(推进中) | 物理数据库支持动态科目与权重设计已落地；一期完整正向评分流（教师端录入得分、加权自动折算、结业成绩汇总台账）前端交互正处于最后收敛阶段。 | [Round 3B 成绩能力评估](../reports/integrated-acceptance/INT_QA_R3B_20260917_094500/round-3b/score-current-capability.md) |
| **G-02** | **学员画像能力 (C05)** | `PARTIAL_FUNCTION`<br>(部分能力) | `/portrait` 页面中，学员基本档案卡、累计自学学时、出勤率分布等基础信息已正常可用；多维能力雷达图目前使用基础模型呈现，高阶动态加权画像需在培训班真实考核数据积累后发挥效用。 | [Round 3B 画像能力评估](../reports/integrated-acceptance/INT_QA_R3B_20260917_094500/round-3b/portrait-current-capability.md) |
| **G-02** | **学员画像能力 (C05)** | `PARTIAL_FUNCTION`<br>(部分能力) | `/portrait` 页面中基础档案与学时概览可用；当前具备基础画像能力，完整业务范围与后续增强内容仍需继续完善或确认。 | [Round 3B 画像能力评估](../reports/integrated-acceptance/INT_QA_R3B_20260917_094500/round-3b/portrait-current-capability.md) |
---
docs/current/05-next-actions.md
+1 -1
View File
@@ -38,7 +38,7 @@
| :---: | :--- | :--- | :--- |
| **P0** | **响应共享试用现场反馈** | 快速响应业务老师在局域网试用中提出的交互阻滞、文案不准确或表单校验细节问题，保障试用体验平滑顺畅。 | 前端交互、教务微调 |
| **P1** | **成绩管理闭环 (C03)** | 完善成绩科目配置、教师端分项打分、加权综合成绩折算与导出台账，完成该模块最后一公里闭环。 | `ruoyi-train` 后端及前端 |
| **P2** | **学员画像能力完善 (C05)** | 丰富学员多维画像雷达图指标计算，引入培训考评与实训维度的实际得分联动，提升画像深度。 | 数据分析、ECharts 视图 |
| **P2** | **学员画像能力完善 (C05)** | 在基础画像能力已具备的基础上，根据试用反馈和业务确认推进画像完整业务范围与后续增强内容。 | 数据分析、ECharts 视图 |
| **P3** | **DMS 真实物理联调准备** | 持续跟踪段内智能门锁测试环境房间划拨与通电进度，一旦资源具备，立即启动现场行级数据验证与物理发码。 | DMS 适配器、现场联调 |
---
docs/handbook/06-api-and-permission-overview.md
+1 -1
View File
@@ -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)
docs/handbook/07-testing-and-acceptance.md
+2 -2
View File
@@ -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)
docs/handbook/08-deployment-and-release.md
+2 -2
View File
@@ -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)
docs/handbook/09-current-status.md
+2 -2
View File
@@ -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)
docs/reports/README.md
+2 -2
View File
@@ -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)
若需了解当前系统最新验收结论、质量门禁数据与试用准备度，**请直接查阅以下目录**：
docs/reports/documentation-audit-20260917.md
+2 -2
View File
@@ -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 提交历史规范化记录，作为合规审计备查底稿；
docs/visual/deployment.html
+1 -1
View File
@@ -319,7 +319,7 @@
<footer class="site-footer">
<p>RailwaySystem SYFJGYD学员管理系统 · 交付候选版 (Final Candidate)</p>
<p style="margin-top: 0.35rem; color: var(--text-muted);">
部署拓扑与 Delta 规范 · <a href="http://192.168.139.218:9980/sict/railwaysystem/-/blob/feat/cicd-pipeline/docs/handbook/08-deployment-and-release.md" target="_blank" rel="noopener noreferrer">查阅部署手册</a> · <a href="http://192.168.139.218:9980/sict/railwaysystem/-/blob/feat/cicd-pipeline/docs/reports/deployment-report.md" target="_blank" rel="noopener noreferrer">查阅部署报告</a>
部署拓扑与 Delta 规范 · <a href="http://192.168.139.218:9980/sict/railwaysystem/-/blob/feat/cicd-pipeline/docs/handbook/08-deployment-and-release.md" target="_blank" rel="noopener noreferrer">查阅部署手册</a> · <a href="../reports/archive/20260915/deployment-report.md" target="_blank" rel="noopener noreferrer">查阅部署报告</a>
</p>
</footer>
docs/visual/index.html
+1 -1
View File
@@ -495,7 +495,7 @@
<div class="kpi-item">
<div class="kpi-num">331 / 331</div>
<div class="kpi-label">后端单元与集成测试</div>
<div class="kpi-sub">Maven Surefire 全量通过 (0 Failures)</div>
<div class="kpi-sub">2026-09-17一期综合验收基线：331项后端测试通过</div>
</div>
<div class="kpi-item">
docs/visual/release-status.html
+3 -3
View File
@@ -72,7 +72,7 @@
<div style="display: flex; flex-wrap: wrap; gap: 1.5rem; font-size: 0.84rem; color: var(--text-muted);">
<span>部署分支：<strong style="color: var(--navy-800); font-family: var(--font-mono);">feat/cicd-pipeline</strong></span>
<span>代码状态：<strong style="color: var(--navy-800);">核心闭环已就绪</strong></span>
<span>质量门禁：<strong style="color: var(--pass-color);">331 项测试全绿 (100% PASS)</strong></span>
<span>质量门禁：<strong style="color: var(--pass-color);">2026-09-17一期综合验收基线：331项后端测试通过</strong></span>
<span>试用状态：<strong style="color: var(--pass-color);">READY_WITH_EXTERNAL_BLOCKERS</strong></span>
</div>
</div>
@@ -110,7 +110,7 @@
<span class="badge badge-pass">DONE</span>
</div>
<p class="step-desc">
执行 <code>mvn test</code> 门禁，全量 331 个测试用例全部一次性通过 (0 Failures, 0 Errors, 0 Skipped)。
2026-09-17一期综合验收基线：331项后端测试全部一次性通过 (0 Failures, 0 Errors, 0 Skipped)。
</p>
</div>
</div>
@@ -260,7 +260,7 @@
<h3 class="card-title" style="font-size: 0.98rem;">内部缺口与外部阻塞</h3>
<span class="badge badge-neutral">KNOWN GAPS</span>
</div>
<p class="card-body-text">客观界定 C03 成绩研发中 (IN_PROGRESS)、C05 画像基础可用 (PARTIAL)、DMS 真实设备外部阻塞。</p>
<p class="card-body-text">客观界定：C03 = IN_PROGRESS，C05 = PARTIAL_FUNCTION；DMS：真实鉴权与只读连通已验证，真实资源行级映射、Mutation、物理硬件仍为外部阻塞。</p>
<a href="../reports/integrated-acceptance/FINAL_PHASE1_20260917_101044/known-gaps.md">查阅缺口清单 (known-gaps.md) &rarr;</a>
</div>
docs/visual/testing.html
+2 -2
View File
@@ -173,7 +173,7 @@
<div class="kpi-card kpi-pass">
<div class="kpi-value">331 / 331</div>
<div class="kpi-label">后端单元与集成测试</div>
<div class="kpi-sub">Maven Surefire · ALL PASS</div>
<div class="kpi-sub">2026-09-17一期综合验收基线：331项后端测试通过</div>
</div>
<div class="kpi-card kpi-pass">
@@ -257,7 +257,7 @@
<h3><span>第 1 层：后端单元与集成测试 (Backend Unit / Integration)</span> <span class="badge badge-pass">PASS</span></h3>
<p>Maven Surefire 全量测试集，涵盖状态机流转、排课冲突算法、脱敏工具类与权限注解断言。</p>
</div>
<span class="card-code">331 / 331 PASS</span>
<span class="card-code">331 PASS (2026-09-17验收基线)</span>
</div>
</div>
</div>