From 1039754adcb215ea3b6a4e0a29d59340d6c07238 Mon Sep 17 00:00:00 2001 From: wangzhibiao Date: Thu, 17 Sep 2026 16:10:31 +0800 Subject: [PATCH 1/7] =?UTF-8?q?=E6=96=87=E6=A1=A3=E5=BD=92=E6=A1=A3?= =?UTF-8?q?=EF=BC=9A=E4=B8=8B=E6=B2=89=E6=97=A9=E6=9C=9F=E4=BA=A4=E4=BB=98?= =?UTF-8?q?=E6=8A=A5=E5=91=8A=E8=87=B3archive=E7=9B=AE=E5=BD=95=E5=B9=B6?= =?UTF-8?q?=E5=BB=BA=E7=AB=8B=E6=8A=A5=E5=91=8A=E6=80=BB=E5=AF=BC=E8=88=AA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/reports/README.md | 46 +++++++++++++++++++ .../20260915}/browser-acceptance-report.md | 0 .../20260915}/deployment-report.md | 0 .../20260915}/final-test-report.md | 0 .../{ => archive/20260915}/release-notes.md | 0 5 files changed, 46 insertions(+) create mode 100644 docs/reports/README.md rename docs/reports/{ => archive/20260915}/browser-acceptance-report.md (100%) rename docs/reports/{ => archive/20260915}/deployment-report.md (100%) rename docs/reports/{ => archive/20260915}/final-test-report.md (100%) rename docs/reports/{ => archive/20260915}/release-notes.md (100%) diff --git a/docs/reports/README.md b/docs/reports/README.md new file mode 100644 index 000000000..63bbd6072 --- /dev/null +++ b/docs/reports/README.md @@ -0,0 +1,46 @@ +# RailwaySystem 质量验收与测试报告中心 (Reports) + +> **当前法定最终验收报告入口**：[`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)**，三角色浏览器端到端全链路打通。 + +--- + +## 🧭 报告分类导览 + +本目录记录了系统在多轮质量门禁、物理数据库落库断言、角色权限穿透及真实浏览器自动化验证中的所有报告与执行证据： + +### 🌟 1. 当前最终验收法定报告 (CURRENT FINAL ACCEPTANCE) + +若需了解当前系统最新验收结论、质量门禁数据与试用准备度，**请直接查阅以下目录**： + +- [**FINAL_PHASE1_20260917_101044/**](integrated-acceptance/FINAL_PHASE1_20260917_101044/README.md)：一期综合验收最终收口汇总 + - [执行总摘要 (Executive Summary)](integrated-acceptance/FINAL_PHASE1_20260917_101044/executive-summary.md)：一页纸全景计分卡与最终结论 + - [测试构建全景报告 (Build & Test Final)](integrated-acceptance/FINAL_PHASE1_20260917_101044/build-test-final.md)：331 项后端测试与构建门禁 + - [浏览器端到端终验报告 (Browser E2E Final)](integrated-acceptance/FINAL_PHASE1_20260917_101044/browser-e2e-final.md)：管理员/教师/学员三端交互与防越权 + - [试用就绪度评估 (Trial Readiness)](integrated-acceptance/FINAL_PHASE1_20260917_101044/phase-one-trial-readiness.md)：共享试用准入与环境核验 + - [DMS 最终集成状态 (DMS Final Status)](integrated-acceptance/FINAL_PHASE1_20260917_101044/dms-final-status.md)：接口连通与外部硬件阻塞客观评定 + - [已知缺口清单 (Known Gaps)](integrated-acceptance/FINAL_PHASE1_20260917_101044/known-gaps.md)：C03 成绩闭环与 C05 画像功能边界 + +--- + +### 📂 2. 历史验收过程证据链 (HISTORICAL EVIDENCE) + +以下子目录为自动化测试工具与阶段性验收留存的过程性底稿与截图，**仅供合规审计与历史溯源调阅，日常无需通读**： + +- [**integrated-acceptance/INT_QA_R1_20260916_153800/**](integrated-acceptance/INT_QA_R1_20260916_153800/round-1/README.md)：Round 1 纯净基线、环境隔离与数据库无孤儿记录验证 +- [**integrated-acceptance/INT_QA_R2_20260916_155300/**](integrated-acceptance/INT_QA_R2_20260916_155300/round-2/README.md)：Round 2 Scenario A~F 业务场景穿透与 DMS Mock 验证 +- [**integrated-acceptance/INT_QA_R3A_20260916_190300/**](integrated-acceptance/INT_QA_R3A_20260916_190300/round-3a/README.md)：Round 3A 管理员端 Playwright 浏览器自动化交互与录屏截图 +- [**integrated-acceptance/INT_QA_R3B_20260917_094500/**](integrated-acceptance/INT_QA_R3B_20260917_094500/round-3b/README.md)：Round 3B 教师端/学员端工作台交互、业务身份绑定与防 IDOR 越权审计 +- [**dms-r3/**](dms-r3/)：DMS 智能门锁平台实测连通性探针 (real-api-probe)、Mock 生命周期与合并前回归报告 +- [**git-history-normalization/**](git-history-normalization/chinese-commit-history-20260917.md)：Git 提交历史中文重写与树哈希一致性审计记录 + +--- + +### 📦 3. 历史早期交付物归档 (ARCHIVED LEGACY REPORTS) + +以下内容为早期阶段性产物，已被最新终检报告与证据体系全量替代： + +- [**archive/20260915/**](archive/20260915/)：2026-09-15 早期 Final Candidate 报告（含旧版 154 测试报告、旧发版说明等） +- [**e2e-demo/**](e2e-demo/DEMO_E2E_20260915_122800/README.md)：2026-09-15 早期 E2E 演示包（已被 Round 3A 覆盖） +- [**e2e-r2/**](e2e-r2/RBAC_E2E_R2_20260916_102500/README.md)：2026-09-16 早期 RBAC 演示包（已被 Round 3B 覆盖） diff --git a/docs/reports/browser-acceptance-report.md b/docs/reports/archive/20260915/browser-acceptance-report.md similarity index 100% rename from docs/reports/browser-acceptance-report.md rename to docs/reports/archive/20260915/browser-acceptance-report.md diff --git a/docs/reports/deployment-report.md b/docs/reports/archive/20260915/deployment-report.md similarity index 100% rename from docs/reports/deployment-report.md rename to docs/reports/archive/20260915/deployment-report.md diff --git a/docs/reports/final-test-report.md b/docs/reports/archive/20260915/final-test-report.md similarity index 100% rename from docs/reports/final-test-report.md rename to docs/reports/archive/20260915/final-test-report.md diff --git a/docs/reports/release-notes.md b/docs/reports/archive/20260915/release-notes.md similarity index 100% rename from docs/reports/release-notes.md rename to docs/reports/archive/20260915/release-notes.md From bef9b49c6c07da32251178189540f2132881c479 Mon Sep 17 00:00:00 2001 From: wangzhibiao Date: Thu, 17 Sep 2026 16:11:46 +0800 Subject: [PATCH 2/7] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E6=96=87=E6=A1=A3?= =?UTF-8?q?=EF=BC=9A=E5=BB=BA=E7=AB=8B=E5=BD=93=E5=89=8D=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E5=85=A5=E5=8F=A3=20docs/current?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/current/01-current-status.md | 73 +++++++++++++++++++++++++++++++ docs/current/02-phase1-status.md | 35 +++++++++++++++ docs/current/03-shared-trial.md | 55 +++++++++++++++++++++++ docs/current/04-known-gaps.md | 34 ++++++++++++++ docs/current/05-next-actions.md | 50 +++++++++++++++++++++ docs/current/README.md | 28 ++++++++++++ 6 files changed, 275 insertions(+) create mode 100644 docs/current/01-current-status.md create mode 100644 docs/current/02-phase1-status.md create mode 100644 docs/current/03-shared-trial.md create mode 100644 docs/current/04-known-gaps.md create mode 100644 docs/current/05-next-actions.md create mode 100644 docs/current/README.md diff --git a/docs/current/01-current-status.md b/docs/current/01-current-status.md new file mode 100644 index 000000000..241fa6093 --- /dev/null +++ b/docs/current/01-current-status.md @@ -0,0 +1,73 @@ +# 01. 系统当前真实状态速览 (Current Status) + +> **系统正式名称**：`SYFJGYD学员管理系统`（内部工程代号：RailwaySystem） +> **共享试用分支**：`feat/cicd-pipeline` +> **共享试用地址**：[http://192.168.139.230:8082/](http://192.168.139.230:8082/) +> **共享试用数据库**：`training`（国产人大金仓 KingbaseES V9 实例） +> **当前试用就绪度**：`READY_WITH_EXTERNAL_BLOCKERS`（具备教务与教学现场试用条件） + +--- + +## 1. 核心质量与验证状态表 + +系统在完全隔离的真实局域网与 KingbaseES 数据库环境下完成了全量自动化验收与真实浏览器端到端交互，核心能力验证状态如下： + +| 验证维度 | 验证项 / 指标 | 状态结论 | 事实说明 | +| :--- | :--- | :---: | :--- | +| **核心教务主闭环** | 计划→课程→名单→排课→报到→考勤→结训 | **`PASS`** | 业务主链路 6 大正向场景全线打通，数据流转完整合规。 | +| **管理员端交互** | Admin 控制台全生命周期管理 | **`PASS`** | 覆盖师资、学员、教室、场地、计划、考勤报表等无阻断操作。 | +| **教师端工作台** | Teacher 个人课表、应到名单、代签打卡 | **`PASS`** | 真实无头 Chrome 浏览器 E2E 验证通过，课表与名单精准过滤。 | +| **学员端培训中心** | Student 个人日程、考勤明细、住宿查询 | **`PASS`** | 仅展示本人培训与出勤数据，界面交互流畅。 | +| **RBAC 与防越权** | 角色最小权限与防 IDOR 水平越权 | **`PASS`** | `IDOR_LEAK_COUNT = 0`，跨工号/跨学员数据篡改请求全部被 403 拦截。 | +| **后端测试套件** | Maven 离线测试门禁 | **`331 / 331 PASS`** | 全量单元测试与契约测试 0 Failures / 0 Errors。 | +| **数据库完整性** | 数据孤儿、重复调宿、外键断言 | **`PASS (0 孤儿)`** | 6 项完整性断言全部为 0，数据底座纯净。 | +| **凭证合规审计** | 全量源码与配置文件 Secret 扫描 | **`PASS`** | `REAL_SECRET_COMMITTED_COUNT = 0`，无硬编码生产密码。 | +| **成绩管理 (C03)** | 新成绩科目权重与录入计算 | **`IN_PROGRESS`** | 基础数据表已就绪，一期业务全闭环与交互正在推进中。 | +| **学员画像 (C05)** | 综合画像雷达图与多维能力分析 | **`PARTIAL_FUNCTION`** | 基础档案与学时检索可用，高阶多维加权画像待业务数据沉淀。 | +| **智能门禁 (DMS)** | 真实环境连通与门锁联动 | **`PARTIALLY_VERIFIED`** | 鉴权/TTL/只读连通验证通过；真实设备与物理硬件因无资源外部阻塞。 | + +--- + +## 2. 当前共享试用业务数据大盘 (Live Dataset) + +共享试用数据库 `training` 当前承载的数据来源于全量验证后的综合验收数据集，真实业务规模如下： + +```text +======================================================================== + 共享试用环境现存业务数据体量 +======================================================================== + - 培训开班计划 (Plans) : 13 期 (覆盖多专业、不同生命周期阶段) + - 授课教师档案 (Teachers) : 20 名 (涵盖各专业骨干教员) + - 参训学员档案 (Students) : 200 名 (全量完成身份证密文存储与脱敏) + - 标准培训课程 (Courses) : 24 门 (理论与实作多门类) + - 排课课次日程 (Lessons) : 118 次 (含四维冲突校验通过数据) + - 学员参训关系 (Enrollments) : 242 条 + - 宿舍分配台账 (Accommodations): 57 条 (防混住与单在用约束生效) + - 真实考勤流水 (Attendance) : 77 条流水 (含签到、签退与请假修正) +======================================================================== +``` + +--- + +## 3. DMS 智能门禁当前精确状态 + +针对 DMS 智能门禁系统，团队已完成详尽技术探测与隔离验证，客观界定如下： + +1. **已验证通过部分 (Contract Verified)**： + - 针对文档示例凭据对应的可访问 DMS 环境，已在局域网下打通 HTTP 通信； + - 登录鉴权（AUTH=PASS）、Token TTL 机制（7200秒有效）、以及 Cookie Token 存储机制正常运行； + - 4 个只读接口连通性正常，外层响应结构符合空列表契约。 +2. **客观外部阻塞部分 (BLOCKED_EXTERNAL)**： + - 该可访问环境下目前**挂载的测试空间与实体门锁数量均为 0**； + - 真实空间与门锁行级字段映射尚未在运行时通过真实数据验证； + - 真实密码下发变更操作（Mutation）与实体通电门锁硬件属于客观外部依赖，待甲方划拨指定真实测试房间与硬件通电后方可闭环。 + +--- + +## 4. 结论与指引 + +- **系统定性**：当前系统核心业务链路稳定，三角色体验完善，已具备交付沈阳房建公寓段业务老师进行**局域网教务教学试运行**的全部条件； +- **后续阅读**： + - 需求完成度与待确认项：[02-phase1-status.md](02-phase1-status.md) + - 试用环境使用与反馈：[03-shared-trial.md](03-shared-trial.md) + - 未决缺口与外部阻塞：[04-known-gaps.md](04-known-gaps.md) diff --git a/docs/current/02-phase1-status.md b/docs/current/02-phase1-status.md new file mode 100644 index 000000000..99640736a --- /dev/null +++ b/docs/current/02-phase1-status.md @@ -0,0 +1,35 @@ +# 02. 一期需求实现状态全景判定 (Phase 1 Status) + +> **最高原则**：**具备共享试用条件 ≠ 一期全部需求正式完成**。 +> 团队坚持实事求是，严格区分“核心教务已验证能力”与“待业务确认/研发推进中能力”，杜绝虚报与浮夸。 + +--- + +## 1. 需求落地分类汇总 + +根据系统真实代码、数据库落地结构以及自动化 E2E 验证结果，一期规划需求状态精简分类如下： + +| 状态分类 | 包含的核心业务功能 | 现状说明与边界 | +| :--- | :--- | :--- | +| **`DONE_VERIFIED`**
(已完成并验证) | **1. 基础资源**：教师档案、学员主档（国密脱敏）、课程库、教室、实训场地、宿舍房间
**2. 教务主链**：开班计划（草稿/发布/结训）、一班多课绑定、参训名册导入、排课四维时段冲突预检
**3. 现场执行**：开班报到确认、课次出勤打卡、教师代签与请假修正、自主学时台账
**4. 权限与门户**：管理员控制台、教师个人课表工作台、学员个人培训中心、最小权限防越权 | 前后端代码、Kingbase 物理表、自动化测试（331 项）及浏览器 E2E 已全部通过，业务正向主闭环已完全就绪。 | +| **`IN_PROGRESS`**
(研发推进中) | **成绩管理闭环 (C03)** | 新成绩体系基础表结构已就绪，成绩科目设置、加权得分计算及综合统计正在进行最终代码闭环与页面联调。 | +| **`PARTIAL_FUNCTION`**
(部分能力具备) | **学员能力画像 (C05)** | 基础档案信息卡、学时积累与报到出勤雷达基础模型已可用；高阶动态加权能力画像有待考核数据进一步沉淀后完善。 | +| **`EXTERNAL_BLOCKER`**
(外部客观阻塞) | **真实门禁写操作与硬件联动 (DMS)** | 协议通信与只读连通已验证；因真实环境尚未挂载测试房间及门锁硬件通电，物理下发判定为外部客观阻塞。 | +| **`CUSTOMER_CONFIRMATION`**
(待甲方业务确认) | **业务口径与组织架构归属** | 详见下方清单，涉及学员名册导入模版格式、报到核验现场硬件配备、请假与门禁权限保留策略等。 | + +--- + +## 2. 权威需求跟踪入口 + +如需查阅每一条需求的详细代码文件位置、SQL 表名、测试用例或具体待确认问题，请点击以下权威文档： + +- 📋 [**一期需求实现进度表 (逐项核验)**](../requirements/一期需求实现进度表.md)：包含域 A~G 共数十项功能点的前后端代码文件、断言证据与下一步建议。 +- ❓ [**一期甲方需求确认清单 (开会对齐)**](../requirements/甲方需求确认清单.md)：系统归纳 P0(核心阻塞 18 项)、P1(业务形态 12 项)、P2(长远规划 8 项) 业务确认表。 + +--- + +## 3. 验收与交付策略 + +1. **共享试用准入**：当前 `DONE_VERIFIED` 覆盖了沈阳房建公寓段开展职工日常集中面授的核心操作，已在局域网开放试用； +2. **闭环收口原则**：针对 `IN_PROGRESS`（成绩）和 `PARTIAL_FUNCTION`（画像），研发团队在小版本迭代中收敛闭环； +3. **外部硬件解除阻塞**：待甲方明确门锁房间划拨并完成物理连通后，即刻组织现场专项联调验收。 diff --git a/docs/current/03-shared-trial.md b/docs/current/03-shared-trial.md new file mode 100644 index 000000000..87db1097b --- /dev/null +++ b/docs/current/03-shared-trial.md @@ -0,0 +1,55 @@ +# 03. 局域网共享试用指南 (Shared Trial Guide) + +> **重要性质声明**： +> 1. 本环境为面向沈阳房建公寓段业务主管、教务人员与授课教员的**内部共享试用环境 (Shared Trial Environment)**； +> 2. **本环境不是最终正式生产环境**，请勿录入未经授权的敏感业务核心数据； +> 3. 代码部署分支为 `feat/cicd-pipeline`，请勿随意向该分支推送未经验证的代码。 + +--- + +## 1. 试用环境访问信息 + +- **系统访问地址**：[http://192.168.139.230:8082/](http://192.168.139.230:8082/) +- **网络准入要求**：需接入单位办公内网或通过指定局域网网段直接访问 +- **数据源基线**：已从综合验收基线（Integrated QA）全量提升导入至共享试用数据库 `training`，自带 13 个完整测试培训班及对应的人员、排课与出勤流水，开箱即用，无需从零制表。 + +--- + +## 2. 账号体系与角色类型 + +系统严格划分三类业务角色，支持针对性体验（账号密码已通过线下安全方式交接给现场管理员，严禁在文档中明文记录）： + +| 角色类型 | 代表账号身份 | 试用推荐场景 | +| :--- | :--- | :--- | +| **系统管理员 (Admin)** | 教务主管账号 | 登录后进入全功能控制台：体验新建培训计划、配置多门课程、导入参训学员、执行四维冲突排课、现场扫码/刷卡报到核验、宿舍房间分配等。 | +| **授课教师 (Teacher)** | 专业主讲教员账号 | 登录后自动进入“教师工作台”：直观查阅个人本周授课日程、点击课次查看应到学员名册、进行课堂签到签退核验及代签补卡。 | +| **参训学员 (Student)** | 在训职工学员账号 | 登录后自动进入“学员培训中心”：查阅本人参训计划、课表安排、个人历史考勤打卡记录、以及分配入住的宿舍房间。 | + +--- + +## 3. 试用反馈与问题流转流程 + +为确保试用反馈高效闭环，请按以下流程反馈问题与建议： + +```text +[试用人员发现问题/提出需求] + │ + ▼ +[记录现象截图与复现步骤] + │ + ▼ +[提交至项目微信群 / 试用问题登记表] + │ + ▼ +[研发团队定级分类] + ├── 🔴 BUG (功能缺陷) ── 即时排查，进入热修复流程 + ├── 🟡 UX (操作体验/展示优化) ── 纳入小版本 UI 优化 + ├── 🔵 KNOWN_GAP (已知缺口) ── 对齐 C03/C05 计划进度 + └── ⚪ REQUIREMENT (新增需求) ── 登记入《甲方需求确认清单》待甲方定级 +``` + +--- + +## 4. 试用注意事项 +1. **请勿执行清库或破坏性测试**：试用数据已形成完整的教学业务流转闭环，请在现有数据或新增独立计划基础上开展测试； +2. **硬件联动说明**：若在界面上触发智能门锁相关操作，系统当前采用安全模拟与受控状态机流转，不会对外部物理设备产生破坏性冲击。 diff --git a/docs/current/04-known-gaps.md b/docs/current/04-known-gaps.md new file mode 100644 index 000000000..13f90124a --- /dev/null +++ b/docs/current/04-known-gaps.md @@ -0,0 +1,34 @@ +# 04. 内部已知缺口与外部阻塞清单 (Known Gaps) + +> **透明度原则**：所有历史已修复缺陷已从本清单移出；本文件仅客观记录**当前尚未完全闭环的内部业务缺口**与**客观外部依赖项**，供研发排期与客户沟通时对照。 + +--- + +## 1. 内部研发已知缺口 (Internal Gaps) + +| 编号 | 模块 / 缺口项 | 当前实际状态 | 预期差距与原因说明 | 详细依据文档 | +| :---: | :--- | :---: | :--- | :--- | +| **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) | + +--- + +## 2. 外部客观阻塞事项 (External Blockers) + +| 编号 | 外部依赖项 | 当前判定 | 阻塞原因与解除条件 | 详细依据文档 | +| :---: | :--- | :---: | :--- | :--- | +| **B-01** | **DMS 真实空间与门锁行级映射** | `BLOCKED_EXTERNAL` | 文档示例凭据对应的 DMS 局域网环境认证连通通过，但该环境内挂载的房间与门锁资源数量均为 0，缺少真实行级数据以在运行时验证行级字段映射契约。
**解除条件**：厂商向测试环境分配真实房间数据。 | [DMS 终检状态报告](../reports/integrated-acceptance/FINAL_PHASE1_20260917_101044/dms-final-status.md) | +| **B-02** | **DMS 真实写操作变更 (Mutation)** | `BLOCKED_EXTERNAL` | 密码下发与远程撤权接口在本地及 Mock 环境测试通过；在无真实测试房间挂载下，禁止向未知外部系统发起真实写操作。
**解除条件**：获得正式授权的测试门锁设备标识。 | [DMS 外部阻塞清单](../reports/integrated-acceptance/FINAL_PHASE1_20260917_101044/external-blockers.md) | +| **B-03** | **DMS 物理硬件与实体通电** | `BLOCKED_EXTERNAL` | 缺少现场实体通电门锁与物理沙箱，无法验证物理刷卡开门或密码键盘实际响应。
**解除条件**：现场硬件通电联调。 | [DMS 外部阻塞清单](../reports/integrated-acceptance/FINAL_PHASE1_20260917_101044/external-blockers.md) | + +--- + +## 3. 甲方待确认事项 (Customer Confirmations) + +目前有若干业务细节形态需要沈阳房建公寓段业务老师明确： +1. **学员档案批量导入模版**：确认标准 Excel 表头字段口径与必填项； +2. **现场报到主交互设备**：确认是一期现场电脑人工点击确认，还是外接读卡器或扫码枪； +3. **住宿分配颗粒度**：确认一期排宿精确到具体房间号，还是必须精确到固定床位编号； +4. **学员请假与门禁权限保留策略**：确认请假期间是否保留宿舍进出权限（当前系统默认策略：保留进门权限）。 + +👉 详细确认清单请查阅：[甲方需求确认清单 (P0/P1/P2)](../requirements/甲方需求确认清单.md)。 diff --git a/docs/current/05-next-actions.md b/docs/current/05-next-actions.md new file mode 100644 index 000000000..04ab047bc --- /dev/null +++ b/docs/current/05-next-actions.md @@ -0,0 +1,50 @@ +# 05. 下一阶段工作模式与行动计划 (Next Actions) + +> **工作模式转型**：随着一期教务核心主链路与三角色工作台全面通过综合验收，项目工作模式已正式由“大规模基础闭环开发”转向**“共享试用驱动、敏捷小版本迭代”**。 + +--- + +## 1. 敏捷运作机制 + +后续研发与交付严格遵循以下反馈流转机制： + +```text + ┌────────────────────────────────────────────────────────┐ + │ 1. 局域网共享试用 (http://192.168.139.230:8082/) │ + │ 段内业务老师与教务主管开展真实教学排课与考勤试用 │ + └─────────────────────────┬──────────────────────────────┘ + │ 发现问题/提出需求 + ▼ + ┌────────────────────────────────────────────────────────┐ + │ 2. 问题归类与定级 (Triage) │ + │ - 🔴 BUG : 阻断缺陷，当日修复并自动化回归 │ + │ - 🟡 UX : 界面与交互体验，周版本批次优化 │ + │ - 🔵 KNOWN_GAP : 归入已知技术缺口专项排期 │ + │ - ⚪ REQUIREMENT : 登记入甲方确认清单待批复 │ + └─────────────────────────┬──────────────────────────────┘ + │ 敏捷推进 + ▼ + ┌────────────────────────────────────────────────────────┐ + │ 3. 小版本迭代与发布 (Release Cycles) │ + │ 本地构建验证 → Surefire 全量通过 → 部署试用分支 │ + └────────────────────────────────────────────────────────┘ +``` + +--- + +## 2. 下一阶段四大核心开发任务 + +| 优先级 | 任务主题 | 核心目标与交付内容 | 负责范围 | +| :---: | :--- | :--- | :--- | +| **P0** | **响应共享试用现场反馈** | 快速响应业务老师在局域网试用中提出的交互阻滞、文案不准确或表单校验细节问题，保障试用体验平滑顺畅。 | 前端交互、教务微调 | +| **P1** | **成绩管理闭环 (C03)** | 完善成绩科目配置、教师端分项打分、加权综合成绩折算与导出台账，完成该模块最后一公里闭环。 | `ruoyi-train` 后端及前端 | +| **P2** | **学员画像能力完善 (C05)** | 丰富学员多维画像雷达图指标计算，引入培训考评与实训维度的实际得分联动，提升画像深度。 | 数据分析、ECharts 视图 | +| **P3** | **DMS 真实物理联调准备** | 持续跟踪段内智能门锁测试环境房间划拨与通电进度，一旦资源具备，立即启动现场行级数据验证与物理发码。 | DMS 适配器、现场联调 | + +--- + +## 3. 分支与质量纪律 + +1. **共享试用分支保护**：`feat/cicd-pipeline` 必须保持随时可试用状态；任何代码合并前必须通过 `mvn clean test`（331 项全绿）； +2. **Git 中文规范**：所有新提交严格遵循 `<中文类型><可选范围>：<中文说明>` 格式； +3. **安全底线**：严禁提交真实密码凭证，严禁执行非备份的清库操作。 diff --git a/docs/current/README.md b/docs/current/README.md new file mode 100644 index 000000000..9fd5bebcc --- /dev/null +++ b/docs/current/README.md @@ -0,0 +1,28 @@ +# SYFJGYD学员管理系统 — 当前项目速览中心 (Current) + +> **核心定位**：专为任何需要“在 3 分钟内快速掌握项目当前实际现状”的读者提供的唯一权威速览入口。 +> **正式业务名称**：`SYFJGYD学员管理系统`（内部工程代号：RailwaySystem） +> **共享试用环境**：[http://192.168.139.230:8082/](http://192.168.139.230:8082/)（部署分支：`feat/cicd-pipeline`） +> **当前试用就绪度**：`READY_WITH_EXTERNAL_BLOCKERS`（核心业务全通，具备局域网教学试用条件） + +--- + +## 🧭 当前速览文件导航 + +本目录包含 5 份精简、客观、直击核心事实的速览文档： + +| 文件 | 核心内容 | 推荐阅读对象 | +| :--- | :--- | :--- | +| [**01-current-status.md**](01-current-status.md) | **系统当前真实状态速览**（涵盖业务闭环、三角色、测试门禁与试用数据大盘） | 全体项目成员、新接手人员、管理层 | +| [**02-phase1-status.md**](02-phase1-status.md) | **一期需求完成度判定**（严格分类 DONE / IN_PROGRESS / PARTIAL / 阻塞项） | 需求分析师、产品经理、验收人员 | +| [**03-shared-trial.md**](03-shared-trial.md) | **共享试用环境使用指南**（环境用途、账号类型、试用反馈与问题流转规范） | 试用教师、业务主管、运维测试 | +| [**04-known-gaps.md**](04-known-gaps.md) | **内部已知缺口与外部阻塞清单**（C03成绩、C05画像、DMS门锁与待确认项） | 研发人员、外部联调人员 | +| [**05-next-actions.md**](05-next-actions.md) | **下一阶段行动路线**（工作模式转变、小版本迭代计划与近期重点） | 研发团队、项目协调人 | + +--- + +## 📌 阅读建议 +- 如果你只想知道**“系统做成啥样了、跑通了哪些功能”**：请直接阅读 [01-current-status.md](01-current-status.md)； +- 如果你要去和**“沈阳房建公寓段领导/指导老师开会对需求”**：请直接阅读 [02-phase1-status.md](02-phase1-status.md) 并带上需求清单； +- 如果你正准备**“在局域网试用系统并提出反馈”**：请直接阅读 [03-shared-trial.md](03-shared-trial.md)； +- 如果你要**“继续写代码或排期”**：请直接阅读 [04-known-gaps.md](04-known-gaps.md) 与 [05-next-actions.md](05-next-actions.md)。 From d5ffc05ae49a2afdf40ec55d4e9c57e6ee24879d Mon Sep 17 00:00:00 2001 From: wangzhibiao Date: Thu, 17 Sep 2026 16:12:09 +0800 Subject: [PATCH 3/7] =?UTF-8?q?=E6=96=87=E6=A1=A3=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=EF=BC=9A=E9=87=8D=E6=9E=84=E6=A0=B9=E7=9B=AE=E5=BD=95=E4=B8=8E?= =?UTF-8?q?=E6=96=87=E6=A1=A3=E4=B8=AD=E5=BF=83=E5=AF=BC=E8=88=AA=E5=9C=B0?= =?UTF-8?q?=E5=9B=BE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 135 ++++++++++++------------------------------- docs/README.md | 154 ++++++++++++++++++++----------------------------- 2 files changed, 100 insertions(+), 189 deletions(-) diff --git a/README.md b/README.md index 367e37f5e..728c0d4df 100644 --- a/README.md +++ b/README.md @@ -1,125 +1,64 @@ -# RailwaySystem 智慧培训系统 +# SYFJGYD学员管理系统 -> **当前交付候选版本 (Final Candidate)**：`5a49b2e2988bf23ca2a70568264c05b24dfda1b6` -> **远程基线分支**：`origin/feat/cicd-pipeline` -> **自动化测试覆盖**：后端单元与契约测试 154/154 PASS，核心业务主链集成用例 6/6 PASS，Kingbase 物理断言 11/11 PASS，端到端浏览器真实验收 PASS (0 阻断 / 0 异常 / Swagger 连通)。 +> **内部工程代码代号**：`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`（核心教务全链路打通，具备局域网试用条件）。 --- -## 📖 项目简介 +## 📖 系统简介 -RailwaySystem 是一套专为铁路职工与业务学员量身打造的一站式智慧培训管理系统。系统基于 Spring Boot 2.5、若依（RuoYi-Vue）企业级底座、Vue 2.6 前端框架以及国产人大金仓（KingbaseES）高安全数据库构建。系统全面贯穿从基础教务资源维护、开班计划编排、学员批量建档、现场开班报到、课次冲突检测、多模式考勤打卡、自动结训归档到多维学情画像与综合分析的全业务生命周期。 +**SYFJGYD学员管理系统**是专为沈阳房建公寓段短周期铁路职工集中面授培训量身研发的一体化数字化教务管理平台。 ---- - -## 🛠 技术架构栈 - -- **后端架构**：Java 8+ / Spring Boot 2.5 / Spring Security / MyBatis / PageHelper / RuoYi-Vue - - **核心培训业务模块**：`ruoyi-train`（独立封装教务、排课、考勤、计划、住宿等完整业务域逻辑与应用服务） - - **系统管理与支撑底座**：`ruoyi-system`、`ruoyi-framework`、`ruoyi-common`、`ruoyi-admin` -- **前端架构**：Vue 2.6 / Vue Router / Vuex / Element UI / Axios / ECharts - - **交互工程**：`build_ui`（当前 Final Candidate 实际构建和部署使用的 Vue 前端工程） - - **历史资产**：`RuoYi-Vue/ruoyi-ui`（若依原始/历史前端资产，不作为当前 Final Browser Acceptance 主构建源） -- **数据存储与持久化**： - - **国产主库**：人大金仓 **KingbaseES V009R003C018**（MySQL 兼容模式，驱动版本 `com.kingbase:kingbase8:8.6.0`） - - **缓存与会话**：Redis 6+（支持密码预检与分布式缓存） -- **发布与数据库增量 (Release DB Delta)**： - - 当前增量版本：`CURRENT_RELEASE_DB_DELTA = 3`（包括 `001_sys_oper_log_cost_time.sql`、`002_legacy_analytics_permissions.sql`、`003_report_attendance_action_permissions.sql`） - ---- - -## 🔄 核心业务闭环主链 - -系统严格遵循业务不变量与领域模型设计，构建了从教务准备到结业归档的标准业务闭环： +系统基于 Spring Boot 2.5、若依（RuoYi-Vue）企业级底座、Vue 2.6 前端框架以及国产人大金仓（KingbaseES）高安全数据库构建。全面贯穿从基础教务资源维护、开班计划编排、学员批量建档（国密SM4脱敏）、四维时段冲突排课、现场人脸/扫码报到、课次考勤打卡到结训归档的全生命周期。 ```mermaid -flowchart TD - A["基础资源准备
(教师/学员/课程/教室/场地/宿舍)"] --> B["培训计划 (Plan)
创建开班计划 · 0:草稿"] - B --> C["本期课程 (PlanCourse)
绑定课程、教师与学时"] - C --> D["参训学员 (Enrollment)
名单批量导入 · 0:待报到"] - D --> E["开班发布 (Plan Publish)
锁定计划配置 · 1:进行中"] - - E --> F1["现场报到 (Report)
人脸/刷卡/扫码核验
状态更新为 1:已报到"] - E --> F2["课次排课 (Scheduling)
四维时段冲突预检
(教师/教室/场地/本班)"] - - F1 --> G["课次考勤 (Attendance)
签到/签退打卡，教师代签与请假修正留痕"] - F2 --> G - - G --> H["培训结训 (Completion)
计划置为 2:已结束，在读学员批量联动为 4:已完成"] - H --> I["学情分析 (Analytics - Read Only)
报到统计、考勤汇总、学习时长与综合能力画像"] +flowchart LR + A["基础资源就绪"] --> B["开班计划制定"] + B --> C["本期课程绑定"] + C --> D["参训学员名册"] + D --> E["四维冲突排课"] + E --> F["开班现场报到"] + F --> G["课堂考勤打卡"] + G --> H["结训状态流转"] + H --> I["历史档案沉淀"] ``` -*(注：学员宿舍安排作为生活保障支线，电子班牌作为现场多媒体与打卡硬件设备支撑)* --- -## 🧭 文档中心导航 +## 🧭 核心文档权威直达 (Documentation Map) -本项目采用**人类可读文档层（Human Documentation Layer）与技术契约事实源（Contract Sources）分层治理**： +为避免在海量文档中迷失，请根据当前需求直接点击对应权威入口： -| 入口推荐 | 文档位置 | 说明与适用对象 | +| 你的目标 | 推荐直达入口 | 核心内容与说明 | | :--- | :--- | :--- | -| 🌟 **视觉化展示门户 (推荐首先访问)** | [docs/visual/index.html](docs/visual/index.html) | **纯静态可离线浏览**。面向评审专家、客户与业务方的交互式展示门户，含业务流程拓扑、系统架构图、14 大模块导览与质量看板。 | -| 📚 **人类操作手册与架构白皮书** | [docs/handbook/](docs/handbook/) | 面向项目经理、开发与测试人员的系统级手册（涵盖项目总览、业务流程、架构设计、数据模型、模块指南与部署运维）。 | -| 📑 **综合验收与测试报告** | [docs/reports/](docs/reports/) | 包含自动化集成测试报告、发版说明 (Release Notes) 与浏览器端到端验收记录。 | -| 📋 **业务需求基线中心** | [doc/README.md](doc/README.md) | ★★★ [PRD V1.0 业务需求基线](doc/RailwaySystem%20智慧培训系统一期%20PRD%20V1.0.md)（正式冻结基线，32章全景规范）、原始甲供资料、历史版本演进。 | -| 🔒 **冻结技术契约 (Source of Truth)** | [docs/api-v2/](docs/api-v2/)
[docs/database-v2/](docs/database-v2/) | 开发与 Agent 技术事实源。包含冻结的 REST API 契约、DTO/VO 字典、21 张物理表字段规范与权限错误码。 | -| 📋 **技术文档全景索引** | [docs/README.md](docs/README.md) | 技术文档中心主索引，提供面向不同角色（业务/研发/测试/历史审计）的精确导读。 | +| 🌟 **想快速了解项目现在做到哪了** | [**docs/current/**](docs/current/README.md) | **【首选入口】** 当前系统状态速览、试用数据大盘、需求落地度与行动计划。 | +| 📋 **想对照一期功能需求与待确认项** | [**docs/requirements/**](docs/requirements/一期需求实现进度表.md) | 一期需求逐项代码实现进度表、以及面向甲方的待确认清单 (P0/P1/P2)。 | +| 📚 **想系统了解业务流程与技术架构** | [**docs/handbook/**](docs/handbook/01-project-overview.md) | 面向团队的系统级手册（涵盖项目总览、业务流程、架构设计、数据模型与开发部署）。 | +| 🔌 **想对接后端 API 接口或 DTO 契约** | [**docs/api-v2/**](docs/api-v2/00_readme.md) | 冻结的 REST API 契约、入参出参模型定义与业务错误码规范。 | +| 🗄️ **想查阅国产金仓数据库物理表结构** | [**docs/database-v2/**](docs/database-v2/01_table_inventory.md) | 21 张真实物理业务表字段清单、索引约束与迁移方案说明。 | +| 🖥️ **想给领导/老师/专家进行生动展示** | [**docs/visual/index.html**](docs/visual/index.html) | **纯静态离线交付门户**，包含可交互业务状态机拓扑、系统架构图与 14 大模块导览。 | +| 📑 **想查阅最终验收结果与测试日志** | [**docs/reports/**](docs/reports/README.md) | 包含当前唯一的最终验收报告 (FINAL_PHASE1) 及各轮次自动化测试证据链。 | --- -## 🚀 快速启动指南 +## 🚀 快速启动指南 (开发环境) -### 1. 环境准备 +### 1. 基础环境要求 - **JDK**：Java 8、11 或 17+ -- **Node.js**：Node 16+（已兼容 Node 22 与 OpenSSL 3.x） +- **Node.js**：Node 16+（兼容 Node 22 与 OpenSSL 3.x） - **Redis**：本地启动 Redis 6+ 服务（默认端口 `6379`，无密码） -- **数据库**：KingbaseES 8.6.0（通过跳板机隧道转发 `127.0.0.1:4321` 直连） +- **数据库**：国产人大金仓 KingbaseES V9（通过跳板机隧道直连 `127.0.0.1:4321`，库名 `train_v2`） -### 2. 一键本地启动（开发模式） -项目根目录下提供了全自动化本地启动脚本 [start-local.sh](start-local.sh)： +### 2. 一键启动本地服务 +项目根目录下提供了全自动化本地启动脚本： ```bash ./start-local.sh ``` 该脚本将自动唤醒本地 Redis、建立 Kingbase SSH 隧道、启动 Spring Boot 后端（端口 `8090`）以及启动前端工程（端口 `8080`）。 -### 3. 系统默认访问入口 -- **前端系统界面**：[http://localhost:8080](http://localhost:8080)（本地开发） / `http://192.168.139.230:8082`（生产部署环境） -- **后端 API 服务**：[http://localhost:8090](http://localhost:8090)（本地开发） / `http://192.168.139.230:8092`（生产部署环境） -- **初始管理账号**：`admin` / `admin123` - ---- - -## 📁 目录结构导览 - -```text -RailwaySystem/ -├── README.md # 【本文件】项目总览、架构导览与启动指南 -├── start-local.sh # 本地一键启动脚本（集成数据库隧道与前后端并发启动） -├── RuoYi-Vue/ # 后端工程（Spring Boot 单体增强版） -│ ├── ruoyi-admin/ # Web 启动入口与 Controller 接口层 -│ ├── ruoyi-framework/ # 框架核心配置、WebSecurity 与拦截器 -│ ├── ruoyi-system/ # 核心业务模块（含培训管理业务 Entity/Mapper/Service） -│ ├── ruoyi-common/ # 公共常量、工具类与通用组件 -│ └── ruoyi-ui/ # 若依原始/历史前端资产（不作为当前 Final Browser Acceptance 主构建源） -├── build_ui/ # 当前 Final Candidate 实际构建和部署使用的 Vue 前端工程 -│ ├── src/api/ # 前端 Axios 接口层（含 train 培训业务接口） -│ ├── src/views/train/ # 培训业务页面视图（学员、排课、宿舍、考勤等） -│ └── package.json # 前端依赖与 Webpack 构建配置 -├── deploy/ # 生产部署、平滑重启脚本与 Nginx 示例配置 -├── doc/ # 业务与产品需求中心（PRD V1.0、原始资料与归档） -├── docs/ # 技术架构、发布门禁、Human Documentation 与代码审计中心 -│ ├── visual/ # 视觉化交互展示门户（8 篇可离线全景架构与流程展示） -│ ├── handbook/ # 人类操作白皮书与开发指南（01~09 全景手册） -│ ├── reports/ # 验收测试报告与发版说明 -│ ├── _meta/ # 发布准备度、门禁清单与最终浏览器验收证据 -│ ├── api-v2/ # REST API 契约与 DTO/VO 字典 -│ └── database-v2/ # 数据库 V2 物理模型与迁移断言 -└── scripts/ # 驱动预检与质量断言脚本 -``` - ---- - -## 📌 开发与演进原则 - -1. **业务基线不可逆**：任何新页面开发、字段扩充与业务校验，统一以 [PRD V1.0](doc/RailwaySystem%20智慧培训系统一期%20PRD%20V1.0.md) 为唯一依据，旧版草案已全部归档。 -2. **非破坏性演进**：对 Kingbase 数据库与若依权限系统进行改造时，严格遵循技术审计报告结论，保持历史数据安全与可回滚性。 +### 3. 访问入口 +- **前端系统界面**：`http://localhost:8080`（本地开发） / [http://192.168.139.230:8082](http://192.168.139.230:8082)（内部共享试用环境） +- **后端 API 服务**：`http://localhost:8090`（本地开发） / `http://192.168.139.230:8092`（共享试用环境） +- **默认管理员**：`admin`（密码请咨询管理员，文档中不记录敏感凭据） diff --git a/docs/README.md b/docs/README.md index 2abadb2eb..2a27cd934 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,117 +1,89 @@ -# RailwaySystem 文档中心总导航 +# SYFJGYD学员管理系统 — 文档中心全景地图 (Docs Map) -> **当前工程基线**：Final Candidate `5a49b2e2988bf23ca2a70568264c05b24dfda1b6` (`origin/feat/cicd-pipeline`) -> **数据库增量版本**：`CURRENT_RELEASE_DB_DELTA = 3` (增量迁移 `001_sys_oper_log_cost_time.sql`、`002_legacy_analytics_permissions.sql`、`003_report_attendance_action_permissions.sql` 已就绪；`007_dicts.sql` 明确严禁执行) -> **质量状态速览**：后端单元测试与契约测试 154 PASS，核心场景集成 6/6 PASS，110 次真实 HTTP 请求零 500 错误，Kingbase 物理断言 11/11 PASS，端到端浏览器自动化真实验收全量 PASS（Console 0 阻断，Swagger UI 正常连通）。 +> **正式业务名称**：`SYFJGYD学员管理系统`（内部工程代号：RailwaySystem） +> **共享试用环境**：[http://192.168.139.230:8082/](http://192.168.139.230:8082/)（部署分支：`feat/cicd-pipeline`） +> **核心质量结论**：核心教务正向闭环全面就绪，三角色工作台验证通过，测试全绿 **331 / 331 PASS**。 --- -## 🧭 角色化阅读路线 +## 🧭 第一屏直达：按你的目标快速找文档 -为了帮助不同背景的读者快速找到权威资料，本文档中心提供以下角色导航路径： +请直接根据你当下的工作任务，点击下方直达通道： -```mermaid -graph TD - Entry["RailwaySystem 访问入口选择"] - - subgraph R1["评审 / 领导 / 汇报"] - V["离线交互门户
visual/index.html"] - H1["项目全景总览
handbook/01"] - end - - subgraph R2["业务 / 教务员"] - H2["业务主链规范
handbook/02"] - H5["14大业务模块指南
handbook/05"] - PRD["业务需求PRD
../doc/README.md"] - end - - subgraph R3["开发 / 架构师"] - H3["系统架构设计
handbook/03"] - H4["数据模型总览
handbook/04"] - H6["API与权限清单
handbook/06"] - API["API V2 事实源
api-v2/"] - end - - subgraph R4["测试 / 交付团队"] - H7["质量保障报告
handbook/07"] - TR["综合测试报告
reports/final-test-report.md"] - BR["浏览器验收报告
reports/browser-acceptance-report.md"] - DEP["部署与发版说明
reports/release-notes.md"] - end - - Entry --> R1 - Entry --> R2 - Entry --> R3 - Entry --> R4 +```text +┌────────────────────────────────────────────────────────────────────────┐ +│ 🎯 你当前的目标是？ │ +├────────────────────────────────────────────────────────────────────────┤ +│ 1. 只想快速了解当前系统做到哪了、能不能用？ ──► [docs/current/] │ +│ 2. 想看一期功能列表、代码对照与甲方确认项？ ──► [docs/requirements/] │ +│ 3. 想系统学习业务流程、系统架构与操作手册？ ──► [docs/handbook/] │ +│ 4. 想开发新功能、对接接口或查数据库字段？ ──► [docs/contracts/] │ +│ (包含 api-v2 / database-v2 / development) │ +│ 5. 想给领导、老师或评审专家进行生动展示？ ──► [docs/visual/] │ +│ 6. 想查阅最终验收报告或历史自动化测试证据？ ──► [docs/reports/] │ +└────────────────────────────────────────────────────────────────────────┘ ``` --- -### A. 第一次阅读（推荐入口） +## 📚 各目录体系深度说明 -如果您是**第一次接触本项目**，或者需要向老师、主管、客户汇报系统成果： -* 🌟 **强力推荐直达离线交互门户**：[visual/index.html](visual/index.html) - * **特点**：无需启动后端服务或数据库，双击即可在任意现代浏览器中离线打开。 - * **内容**：提供深色工业风大屏质感，涵盖系统业务主链 SVG 交互拓扑、系统六层分层架构图、14 大核心业务模块互动矩阵、核心指标 KPI 仪表盘与发版准备度看板。 -* 📖 **快速阅读项目总览白皮书**：[handbook/01-project-overview.md](handbook/01-project-overview.md) - * 专为人类读者编写，通俗阐述系统解决的教务痛点、服务对象、关键特性与一期交付边界。 +### 1. 🌟 [docs/current/](current/README.md) — 【首选】当前系统真实速览 +专为需要**“在 3 分钟内快速掌握项目当前实际现状”**的读者设计，杜绝翻阅陈旧长日志： +- [01-current-status.md](current/01-current-status.md)：当前系统真实状态、试用数据大盘与质量指标 +- [02-phase1-status.md](current/02-phase1-status.md)：一期需求完成度精简分类判定 +- [03-shared-trial.md](current/03-shared-trial.md)：局域网共享试用环境使用指引与反馈通道 +- [04-known-gaps.md](current/04-known-gaps.md)：当前有效技术缺口（C03成绩/C05画像/DMS外部阻塞） +- [05-next-actions.md](current/05-next-actions.md)：敏捷小版本迭代工作模式与近期重点 --- -### B. 业务人员与教务管理路径 - -关注业务流程、业务规则、状态流转与功能说明的读者，请查阅： -1. [handbook/02-business-process.md](handbook/02-business-process.md) —— **核心业务全流程与状态机规范**（开班计划、报到核验、四维排课冲突预检、考勤打卡与结训联动）。 -2. [handbook/05-module-guide.md](handbook/05-module-guide.md) —— **14 大业务模块详细指南**（教师、学员、课程、教室、场地、宿舍、开班、报到、排课、考勤、班牌、统计等）。 -3. [../doc/README.md (业务需求中心与 PRD V1.0)](../doc/README.md) —— **业务需求最高事实源**（包含正式冻结的 PRD V1.0 原文与原始资料索引）。 +### 2. 📋 [docs/requirements/](requirements/一期需求实现进度表.md) — 业务需求与确认清单 +连接业务与代码的法定事实依据： +- [一期需求实现进度表.md](requirements/一期需求实现进度表.md)：按模块逐项核对每一条需求的前后端代码实现、页面位置与测试证据 +- [甲方需求确认清单.md](requirements/甲方需求确认清单.md)：面向沈阳房建公寓段业务老师提炼的待确认分级清单（P0 核心 18 项、P1 细节 12 项、P2 规划 8 项） --- -### C. 开发人员与架构师路径 - -参与系统编码、功能扩展与架构审计的研发人员，请查阅： -1. [handbook/03-system-architecture.md](handbook/03-system-architecture.md) —— **系统技术架构设计**（Spring Boot 2.5 + 若依增强单体、`ruoyi-train` 核心模块、Kingbase 兼容适配模式）。 -2. [handbook/04-data-model-overview.md](handbook/04-data-model-overview.md) —— **数据模型总览**（核心实体关系与关键表结构设计）。 -3. [handbook/06-api-and-permission-overview.md](handbook/06-api-and-permission-overview.md) —— **API 与权限体系速览**（核心操作端点、RBAC 菜单权限与专用业务 Action）。 -4. [handbook/08-deployment-and-release.md](handbook/08-deployment-and-release.md) —— **部署与运维手册**（本地快速启动与生产多环境部署要求）。 -5. [handbook/deployment/kingbase-jdbc-provisioning.md](handbook/deployment/kingbase-jdbc-provisioning.md) —— **Kingbase JDBC 8.6.0 依赖供应指南**。 +### 3. 📖 [docs/handbook/](handbook/01-project-overview.md) — 团队操作白皮书与全景指南 +面向人类可读的系统级白皮书，涵盖业务、技术与运维全链路： +- [01-project-overview.md](handbook/01-project-overview.md)：系统建设背景、业务痛点与角色价值 +- [02-business-process.md](handbook/02-business-process.md)：核心业务闭环流程与状态机流转规则 +- [03-system-architecture.md](handbook/03-system-architecture.md)：系统分层架构、核心组件与技术选型 +- [04-data-model-overview.md](handbook/04-data-model-overview.md)：数据模型概念设计与关键实体关系 +- [05-module-guide.md](handbook/05-module-guide.md)：14 大业务功能模块使用与代码扩展指南 +- [06-api-and-permission-overview.md](handbook/06-api-and-permission-overview.md)：接口分类体系与 RBAC 权限矩阵 +- [07-testing-and-acceptance.md](handbook/07-testing-and-acceptance.md)：测试规范与自动化验证体系 +- [08-deployment-and-release.md](handbook/08-deployment-and-release.md)：共享试用环境部署拓扑与运维规范 +- [09-current-status.md](handbook/09-current-status.md)：团队级现状综合看板 --- -### D. 测试与质量验收路径 - -负责功能验收、回归测试与质量审计的人员，请查阅： -1. [reports/final-test-report.md](reports/final-test-report.md) —— **Final Candidate 自动化测试与场景集成最终报告**（154 单元测试 + 6 大场景全 PASS 证据）。 -2. [reports/browser-acceptance-report.md](reports/browser-acceptance-report.md) —— **端到端浏览器自动化验收报告**（真实环境验收通过：**PASS**，0 阻断，Swagger 连通）。 -3. [reports/release-notes.md](reports/release-notes.md) —— **发版说明与变更记录**。 -4. [_meta/core-business-test-matrix.md](_meta/core-business-test-matrix.md) —— **核心业务场景集成自动化测试矩阵**。 +### 4. 🔒 研发契约与开发规范 (Contracts & Development) +技术人员与智能 Agent 研发的核心事实源（只读冻结）： +- **[docs/api-v2/](api-v2/00_readme.md)**：RESTful API 契约总纲、Module A~D 接口规范、DTO/VO 字典与业务错误码 +- **[docs/database-v2/](database-v2/01_table_inventory.md)**：国产人大金仓 KingbaseES 物理表清单、索引约束设计与迁移说明 +- **[docs/development/](development/git-commit-convention.md)**： + - [git-commit-convention.md](development/git-commit-convention.md)：项目 Git 提交中文格式规范 + - [dms-r3/](development/dms-r3/00_source_and_scope.md)：DMS 智能门禁适配器架构设计与 Token 策略 + - [rbac-r2/](development/rbac-r2/00_current_state.md)：多角色 RBAC、业务身份绑定与防 IDOR 越权设计 --- -### E. Agent 与技术契约事实源（Contract Sources） - -本目录下的底层契约目录为系统自动代码生成、契约测试和 Agent 审计的**最高技术事实源（Source of Truth）**，已正式冻结，保持原路径不移动： -1. [api-v2/](api-v2/) —— **API V2 契约体系**： - - `00_readme.md`：API 体系总览与 REST 规范 - - `01_api_design_principles.md` ~ `05_module_d_score_learning_statistics_api.md`：各业务域端点定义 - - `06_dto_vo_catalog.md`：DTO/VO 字段定义字典 - - `08_transaction_and_invariants.md`：强事务与 6 大跨表业务不变量 - - `10_permission_and_error_codes.md`：权限字符串与 40001~50001 业务错误码字典 -2. [database-v2/](database-v2/) —— **数据库 V2 物理迁移与表结构事实源**： - - `01_table_inventory.md`：21 张物理表字段、约束、主外键最终定义 - - `05_execution_contract.md`：数据库物理迁移执行契约与验证门禁 -3. [issues-v1/](issues-v1/) —— **任务分解与验收条件**： - - `02_p0_issue_backlog.md`：P0 核心任务与 AC 验收条件定义 - - `06_acceptance_matrix.md`：AC 验收标准对应自动化用例矩阵 -4. [development/](development/) —— 各 Issue 实施过程记录与验收报告。 -5. [_meta/documentation-audit.md](_meta/documentation-audit.md) —— D.0 文档现状审计与资产盘点报告。 +### 5. 🖥️ [docs/visual/](visual/index.html) — 数字化离线交付门户 +纯静态 HTML + CSS + JS 构建的交互式展示门户，浏览器直接双击打开，适合大屏展示： +- [index.html](visual/index.html)：交付门户主页 +- [architecture.html](visual/architecture.html)：架构与技术栈 +- [business-flow.html](visual/business-flow.html)：全景业务状态机 +- [data-model.html](visual/data-model.html)：实体关系 (ER) 与表字典 +- [modules.html](visual/modules.html)：14 大模块导览 +- [testing.html](visual/testing.html)：质量与验证体系 +- [deployment.html](visual/deployment.html)：部署拓扑与 Delta 增量 +- [release-status.html](visual/release-status.html)：发版进度与门禁看板 --- -### F. 历史过程资料归档（Historical Snapshots） - -> ⚠️ **重要提示**：以下目录记录的是项目研发演进早期的阶段性快照或原始素材，**仅作为工程审计与技术溯源参考，不代表当前 Final Candidate 的代码与数据库现状**： -* [codebase-audit/](codebase-audit/)：**Phase 0 历史代码审计快照**（基于历史 Commit `e12eda05`，记录了重构前旧单体结构与旧 14 张表实测状态，已被 Database V2 与 API V2 替代）。 -* [../doc/raw_materials/](../doc/raw_materials/)：早期甲供原始需求与数据表草案。 -* [../doc/archive/](../doc/archive/)：一期 PRD V0.9、早期决策与假设讨论稿。 -* [../doc/wxy_doc/](../doc/wxy_doc/)：早期技术原型与开发说明书草案。 +### 6. 📑 [docs/reports/](reports/README.md) — 质量验收与历史证据 +- **当前唯一终验报告**：[FINAL_PHASE1_20260917_101044/](reports/integrated-acceptance/FINAL_PHASE1_20260917_101044/README.md)（含 [执行总摘要](reports/integrated-acceptance/FINAL_PHASE1_20260917_101044/executive-summary.md)） +- **过程性测试证据**：Round 1~3B 自动化测试日志、DMS 实测探针、Playwright 无头浏览器运行截图 +- **早期归档报告**：[archive/20260915/](reports/archive/20260915/)（已被终检报告全面覆盖的早期旧报告） From b633bbc0622ba1799a534ab6480d57512c5e0a49 Mon Sep 17 00:00:00 2001 From: wangzhibiao Date: Thu, 17 Sep 2026 16:16:03 +0800 Subject: [PATCH 4/7] =?UTF-8?q?=E4=BC=98=E5=8C=96=E5=B1=95=E7=A4=BA?= =?UTF-8?q?=EF=BC=9A=E6=A0=A1=E5=87=86=E5=8F=AF=E8=A7=86=E5=8C=96=E4=BA=A4?= =?UTF-8?q?=E4=BB=98=E9=97=A8=E6=88=B7=E7=8A=B6=E6=80=81=E4=B8=8E=E6=8C=87?= =?UTF-8?q?=E6=A0=87=E8=87=B3=E5=85=B1=E4=BA=AB=E8=AF=95=E7=94=A8=E5=9F=BA?= =?UTF-8?q?=E7=BA=BF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/visual/deployment.html | 22 ++++----- docs/visual/index.html | 24 ++++----- docs/visual/release-status.html | 86 ++++++++++++++++----------------- docs/visual/testing.html | 14 +++--- 4 files changed, 73 insertions(+), 73 deletions(-) diff --git a/docs/visual/deployment.html b/docs/visual/deployment.html index f9acef666..9e35b17f7 100644 --- a/docs/visual/deployment.html +++ b/docs/visual/deployment.html @@ -99,10 +99,10 @@
-
Production Deployment & Delta
-

生产部署拓扑与脚本 Delta

+
Shared Trial Deployment & Delta
+

局域网共享试用部署拓扑与脚本 Delta

- 默认仅呈现生产目标极简标准拓扑链路：User → Frontend (8082) → Backend (8092) → Kingbase / Redis。复杂的开发隧道端口与迁移文件名折叠收录于技术细节中。 + 呈现共享试用环境标准拓扑链路：User → Frontend (8082) → Backend (8092) → Kingbase (training) / Redis。开发隧道端口与技术细节折叠收录。

@@ -117,12 +117,12 @@ 仅执行增量 001~003 - +
-

生产目标部署标准拓扑 (Production Topology)

-

纯粹生产网络走向，无中间干扰项

+

共享试用部署标准拓扑 (Shared Trial Topology)

+

局域网试用网络走向，保障试用环境独立稳定

标准四层链路
@@ -148,7 +148,7 @@ - 生产前端静态容器 (Nginx 反向代理) + 共享试用前端静态容器 (Nginx 反向代理) 目标端口: 8082 · Vue 2.6 SPA 编译产物 @@ -159,7 +159,7 @@ - 生产后端单体服务 (Spring Boot 2.5.15) + 共享试用后端单体服务 (Spring Boot 2.5.15) 目标端口: 8092 · RuoYi-Vue 业务核心 JAR @@ -170,7 +170,7 @@ - KingbaseES (生产主库) + KingbaseES (training 试用库) V009R003C018 · 21张业务表 @@ -189,7 +189,7 @@

发布数据库增量变更 (Release Delta)

-

本次生产升级仅需依次执行 3 个幂等增量脚本，保障历史业务数据零丢失。

+

本次试用环境升级仅需依次执行 3 个幂等增量脚本，保障历史业务数据零丢失。

3 Required Migrations
@@ -200,7 +200,7 @@ DELTA = 3

- 生产环境已具备完整基础 Schema，本次升级严格限定于 3 个增量脚本，顺序执行即可完成日志耗时字段补齐、分析域权限闭环与报到考勤写权限补全： + 共享试用环境已具备完整基础 Schema，本次升级严格限定于 3 个增量脚本，顺序执行即可完成日志耗时字段补齐、分析域权限闭环与报到考勤写权限补全：

diff --git a/docs/visual/index.html b/docs/visual/index.html index 767ae870c..4903338fd 100644 --- a/docs/visual/index.html +++ b/docs/visual/index.html @@ -247,8 +247,8 @@ 浏览器端到端验收 PASS
- - 待正式生产部署 (PENDING) + + 共享试用就绪 (READY_WITH_EXTERNAL_BLOCKERS)
@@ -493,9 +493,9 @@
-
154 / 154
-
后端单元测试
-
Maven Surefire 全量通过
+
331 / 331
+
后端单元与集成测试
+
Maven Surefire 全量通过 (0 Failures)
@@ -529,7 +529,7 @@

发布执行状态追踪

-

开发、测试与验证均已圆满收官，当前进入生产部署待执行阶段。

+

开发与综合验收全面通过，当前系统处于局域网共享试用就绪状态。

查看发布看板 →
@@ -544,19 +544,19 @@
Stage 2 · COMPLETED
全层级质量验证
-
154个单元测试及6大核心场景门禁均通过。
+
全量 331 项后端测试及 6 大核心场景全绿通过。
Stage 3 · COMPLETED
浏览器端到端验收
-
真实浏览器端到端交互验收通过，无控制台阻断错误。
+
三端真实浏览器端到端交互验收通过，无控制台阻断错误。
-
-
Stage 4 · PENDING
-
正式生产部署
-
执行 001~003 数据库迁移增量脚本与环境烟测。
+
+
Stage 4 · ACTIVE TRIAL
+
局域网共享试用
+
已部署至共享试用环境 (8082)，具备真实教学试用条件。
diff --git a/docs/visual/release-status.html b/docs/visual/release-status.html index 94a59fd7c..83efcfa63 100644 --- a/docs/visual/release-status.html +++ b/docs/visual/release-status.html @@ -66,14 +66,14 @@
- 交付候选阶段 - Final Candidate 交付版本 + 共享试用就绪 + Shared Trial Release (8082)
- 基线 HEAD：5a49b2e2 - 代码冻结：已完成 (FROZEN) - 质量门禁：100% 通过 - 生产部署：待执行 (PENDING) + 部署分支：feat/cicd-pipeline + 代码状态：核心闭环已就绪 + 质量门禁：331 项测试全绿 (100% PASS) + 试用状态：READY_WITH_EXTERNAL_BLOCKERS
@@ -93,7 +93,7 @@ DONE

- 后端 ruoyi-train 业务主干、前端 Vue 路由及 docs/api-v2 接口契约全面封版冻结，基线锁定于 commit 5a49b2e2。 + 后端 ruoyi-train 业务主干、前端 Vue 路由及 docs/api-v2 接口契约全面封版，基线合并至 feat/cicd-pipeline。

@@ -106,11 +106,11 @@
-
2. 后端单元与契约测试门禁 (Unit & Contract Test)
+
2. 后端单元与集成测试门禁 (Unit & Integration Test)
DONE

- 执行 mvn test 极速离线门禁，154 个测试用例全部一次性通过 (0 Failures, 0 Errors, 0 Skipped)。 + 执行 mvn test 门禁，全量 331 个测试用例全部一次性通过 (0 Failures, 0 Errors, 0 Skipped)。

@@ -183,52 +183,52 @@ - -
+ +
-
7
+
✓
-
7. 正式生产环境部署执行 (Formal Deployment)
- PENDING +
7. 局域网共享试用环境部署 (Shared Trial Deployment)
+ DONE

- 在目标生产环境按序执行 3 个增量数据库迁移脚本 (001~003)，历史业务字典 007_dicts.sql 严禁执行；启动前端 8082 与后端 8092 生产进程。 + 在共享试用环境按序执行数据库增量脚本 (001~003)，严格隔离 training 试用库；启动前端 8082 与后端 8092 进程。

- -
+ +
-
8
+
✓
-
8. 生产环境自动化冒烟验证 (Deployment Smoke)
- PENDING +
8. 试用环境自动化冒烟与存活核准 (Trial Smoke)
+ DONE

- 服务启动后对 GET /login、教师列表与课表查询进行线上存活性健康检查与读写冒烟校验。 + 服务启动后对三角色登录、教师列表与课表查询进行线上存活性健康检查，具备局域网教学试用条件。

- -
+ +
-
9
+
✓
-
9. 最终交付签收与上线归档 (Final Release)
- PENDING +
9. 局域网教学试用与敏捷迭代 (Active Shared Trial)
+ ACTIVE

- 完成各方验收签字与资产封存归档，正式进入生产平稳运行维护阶段。 + 已交付沈阳房建公寓段开展真实教务试用；通过快速反馈机制流转缺陷并推进 C03 成绩与 C05 画像迭代。

@@ -240,37 +240,37 @@
-

阶段交付物与验证报告索引

-

所有阶段均有完整的可追溯报告文件支持，严格保证过程合规。

+

最终验收与状态报告索引

+

所有阶段均有完整的可追溯报告文件支持，严格保证过程合规真实。

-

综合测试报告

- PASS +

一期综合验收终审总结

+ 331 PASS
-

详细记录 154 个单元用例、6 大场景集成及 11 项物理落库断言的执行结果与证据。

- 查阅报告 (final-test-report.md) → +

全量 331 个单元/集成用例、三端无头浏览器 E2E 及 0 孤儿物理落库断言的执行结果与证据。

+ 查阅终审总摘要 (executive-summary.md) →
-

浏览器端到端验收报告

- PASS +

内部缺口与外部阻塞

+ KNOWN GAPS
-

记录真实浏览器端到端模拟教务员的全流程交互、表单提交、弹窗确认与控制台检查情况。

- 查阅报告 (browser-acceptance.md) → +

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

+ 查阅缺口清单 (known-gaps.md) →
-

部署与发版说明

- READY +

试用就绪度与发布说明

+ READY
-

提供生产环境前置条件预检、3 个必跑数据库增量脚本说明与环境冒烟指南。

- 查阅发版说明 (release-notes.md) → +

共享试用环境准入评估、增量迁移核查及面向段内业务老师的教学试用建议。

+ 查阅试用就绪报告 (phase-one-trial-readiness.md) →
@@ -279,9 +279,9 @@
-

RailwaySystem SYFJGYD学员管理系统 · 交付候选版 (Final Candidate)

+

RailwaySystem SYFJGYD学员管理系统 · 共享试用环境 (Shared Trial Active)

- 发版状态与交付基准 · 查阅发版说明 + 发版状态与交付基准 · 查阅报告中心总导航

diff --git a/docs/visual/testing.html b/docs/visual/testing.html index a630a13cc..353deb633 100644 --- a/docs/visual/testing.html +++ b/docs/visual/testing.html @@ -171,8 +171,8 @@
-
154 / 154
-
后端单元与契约测试
+
331 / 331
+
后端单元与集成测试
Maven Surefire · ALL PASS
@@ -254,10 +254,10 @@
-

第 1 层：后端单元与契约测试 (Backend Unit / Contract) PASS

-

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

+

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

+

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

- 154 / 154 PASS + 331 / 331 PASS
@@ -625,9 +625,9 @@ From 55cc2e8bcaacb7021ea0f6c1d5952d16cfe97dee Mon Sep 17 00:00:00 2001 From: wangzhibiao Date: Thu, 17 Sep 2026 16:16:19 +0800 Subject: [PATCH 5/7] =?UTF-8?q?=E6=96=87=E6=A1=A3=E5=AE=A1=E8=AE=A1?= =?UTF-8?q?=EF=BC=9A=E6=B2=89=E6=B7=80=E4=B8=80=E6=9C=9F=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E8=B5=84=E4=BA=A7=E5=85=A8=E9=87=8F=E5=AE=A1=E8=AE=A1=E4=B8=8E?= =?UTF-8?q?=E6=B2=BB=E7=90=86=E6=8A=A5=E5=91=8A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/reports/documentation-audit-20260917.md | 106 +++++++++++++++++++ 1 file changed, 106 insertions(+) create mode 100644 docs/reports/documentation-audit-20260917.md diff --git a/docs/reports/documentation-audit-20260917.md b/docs/reports/documentation-audit-20260917.md new file mode 100644 index 000000000..fe7b6ba87 --- /dev/null +++ b/docs/reports/documentation-audit-20260917.md @@ -0,0 +1,106 @@ +# SYFJGYD学员管理系统 — 全量文档资产盘点与信息架构审计报告 + +> **审计分支**：`feat/cicd-pipeline`（Commit: `73c8a68f`） +> **审计时间**：2026-09-17 +> **执行原则**：坚持客观事实，理清入口权威，消除歧义误导；本阶段不搞大规模文件破坏性搬迁，优先完成入口收敛与旧报告归档。 + +--- + +## 1. 核心指标与资产盘点概览 + +全工程文档资产及配套可视化、验收截图素材全量盘点指标如下： + +```text +======================================================================== + 文档资产全量审计核心指标卡 +======================================================================== + AUDIT_BRANCH : feat/cicd-pipeline + AUDIT_HEAD : 73c8a68f801dc4aed2a4d262747690cef0135fc3 + + TOTAL_DOCUMENT_COUNT : 423 份 (Markdown、Word、HTML 及配套媒体素材) + DOC_FILE_COUNT : 20 份 (doc/ 目录：原始材料与历史设计) + DOCS_FILE_COUNT : 395 份 (docs/ 目录：正式工程、架构、契约与验收报告) + REPORT_FILE_COUNT : 221 份 (docs/reports/ 下报告与自动化截图) + RUOYI_LEGACY_DOC_COUNT : 7 份 (框架原生自带文档) + ROOT_DOC_COUNT : 1 份 (根目录 README.md) + + CURRENT_AUTHORITATIVE_DOC_COUNT : 52 份 (当前活跃有效、日常必须参考的权威文档) + STALE_DOC_COUNT : 18 份 (包含过期 SHA、旧测试数或本地绝对路径) + POSSIBLE_DUPLICATE_COUNT : 8 组 (双格式或内容镜像) + SUPERSEDED_DOC_COUNT : 24 份 (已被更新报告或新规范替代) + + VISUAL_DOC_STATUS : PARTIALLY_STALE → 已校准为 SHARED_TRIAL_READY + CLEANUP_PHASE_1 : COMPLETED (docs/current 建立，旧顶层报告归档) +======================================================================== +``` + +--- + +## 2. doc/ 与 docs/ 两套目录深度关系分析 (DOC_VS_DOCS_ANALYSIS) + +### 2.1 为什么同时存在？ +- **`doc/` 的起源（业务需求与甲方起点）**： + 建于项目早期与业务方对接阶段。核心资产为甲方最初提供的业务功能分析与表设计 Word 原件（`doc/raw_materials/`）、王杏月师姐编写的早期技术说明与 ELK 拓扑原型（`doc/wxy_doc/`）、早期讨论稿（`doc/archive/`）、以及最终冻结的 PRD V1.0。**其本质是“产品需求与甲方原始输入中心”**。 +- **`docs/` 的起源（工程规范与研发交付）**： + 建于后续工程化推进阶段（Phase 0 代码审计、API V2 契约、国产 KingbaseES 物理表迁移、多轮综合验收）。包含当前系统的技术契约（`api-v2/`、`database-v2/`）、开发指南与白皮书（`handbook/`）、离线可视化门户（`visual/`）、以及数十次自动化测试生成的证据链（`reports/`）。后来在此目录下又建立了 `docs/requirements/`。**其本质是“工程技术实现、事实审计与质量验收中心”**。 + +### 2.2 处置策略 +- **Phase 1（当前）**：保持 `doc/` 物理目录不动，先在 `docs/current/` 与 `docs/README.md` 中收敛权威入口，明确 `doc/` 为“历史起点与原始资料”； +- **Phase 2（后续）**：择机将 `doc/` 下的 PRD V1.0 移入 `docs/requirements/`，其余原始 docx 与早期原型移入 `docs/archive/`，彻底消除同级目录歧义。 + +--- + +## 3. 全局唯一权威推荐入口 (Authoritative Source Identification) + +为避免开发者与用户在多份文档中迷失，现对全项目 17 个关键业务与技术领域确立唯一推荐权威入口： + +| 领域分类 | 唯一权威推荐文档入口 (AUTHORITATIVE SOURCE) | 推荐理由与事实依据 | +| :--- | :--- | :--- | +| **A. 项目总览** | [`docs/handbook/01-project-overview.md`](../handbook/01-project-overview.md) | 全面阐述铁路职工培训痛点、四类核心角色价值、14 大业务模块与核心流转。 | +| **B. 当前系统状态** | [`docs/current/01-current-status.md`](../current/01-current-status.md) | **最权威的一页纸现状速览**。包含试用数据大盘、核心闭环结论与 DMS 精确状态。 | +| **C. 一期需求** | [`docs/requirements/一期需求实现进度表.md`](../requirements/一期需求实现进度表.md) | 逐项核对代码与页面落地度、测试证据与分支边界，比静态 PRD 更加贴合真实交付。 | +| **D. 甲方待确认项** | [`docs/requirements/甲方需求确认清单.md`](../requirements/甲方需求确认清单.md) | 分级整理 P0(核心阻塞 18 项)、P1(业务细节 12 项)、P2(二期规划 8 项) 业务确认表。 | +| **E. 系统架构** | [`docs/handbook/03-system-architecture.md`](../handbook/03-system-architecture.md) | 详述 Spring Boot 2.5 + RuoYi-Vue + KingbaseES 分层架构、聚合边界及服务调用拓扑。 | +| **F. 数据库设计** | [`docs/database-v2/01_table_inventory.md`](../database-v2/01_table_inventory.md) | 完整记录 21 张真实物理业务表的字段语义、类型、索引及约束。 | +| **G. API** | [`docs/api-v2/00_readme.md`](../api-v2/00_readme.md) | 冻结的 REST API 契约总纲，统领 Module A~D 所有接口定义、DTO/VO 字段字典与业务错误码。 | +| **H. 部署/CI/CD** | [`docs/handbook/08-deployment-and-release.md`](../handbook/08-deployment-and-release.md) | 规范记录局域网共享试用环境 (`192.168.139.230:8082`) 的 Nginx 代理、隧道转发与发布增量 Delta。 | +| **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 孤儿的法定验收证明。 | +| **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 学员画像为基础功能，杜绝浮夸。 | +| **P. Visual Docs入口** | [`docs/visual/index.html`](../visual/index.html) | 面向专家评审与业务老师的纯静态离线交互式交付门户（双击即可本地运行）。 | +| **Q. 历史资料入口** | [`doc/README.md`](../../doc/README.md) | 统领甲方原始 Word 资料、早期草案与王杏月原型。 | + +--- + +## 4. 报告中心分级与收口治理 (Reports Restructuring) + +针对 `docs/reports/` 下累积的 220+ 份报告与截图，按以下规则完成治理收口： + +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 提交历史规范化记录，作为合规审计备查底稿； +3. **早期旧报告下沉归档 (ARCHIVED)**： + - 将顶层 4 篇旧报告移至 [`archive/20260915/`](archive/20260915/)，避免读者误读早期的 154 测试指标； +4. **统一导航建立**： + - 新建 [`docs/reports/README.md`](README.md)，建立清晰的父级索引。 + +--- + +## 5. Phase 1 落地成果与后续建议 + +### 本阶段已完成动作： +- ✅ 建立 `docs/current/` 极简速览中心（5 篇精炼人类速览文档）； +- ✅ 重写根目录 `README.md` 与 `docs/README.md`，构建清晰的六大直达通道； +- ✅ 全面校准 `docs/visual/`（4 篇核心 HTML），将 154 测试修正为全量 331 验收测试，消除“生产环境”误称； +- ✅ 下沉顶层旧报告至 `docs/reports/archive/20260915/` 并建立报告总导航； +- ✅ 全量检查 Markdown 与 HTML 链接，杜绝违规本地绝对路径。 + +### Phase 2 后续演进建议（待客户与团队审阅后实施）： +1. 将 `doc/RailwaySystem 智慧培训系统一期 PRD V1.0.md` 结构化移入 `docs/requirements/`； +2. 将 `doc/raw_materials/` 与 `doc/wxy_doc/` 归类移入 `docs/archive/`； +3. 清理已完全合并或淘汰的临时中间工作底稿。 From 72bdad8c7708d833abae41282e75e617a8d5fe7e Mon Sep 17 00:00:00 2001 From: wangzhibiao Date: Thu, 17 Sep 2026 16:16:50 +0800 Subject: [PATCH 6/7] =?UTF-8?q?=E7=BB=B4=E6=8A=A4=E6=A0=BC=E5=BC=8F?= =?UTF-8?q?=EF=BC=9A=E6=B8=85=E7=90=86=E6=96=87=E6=A1=A3=E8=A1=8C=E5=B0=BE?= =?UTF-8?q?=E7=A9=BA=E7=99=BD=E5=AD=97=E7=AC=A6=E4=BB=A5=E9=80=9A=E8=BF=87?= =?UTF-8?q?=E9=97=A8=E7=A6=81=E6=A0=B8=E9=AA=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 6 +++--- docs/README.md | 4 ++-- docs/current/01-current-status.md | 8 ++++---- docs/current/02-phase1-status.md | 2 +- docs/current/03-shared-trial.md | 6 +++--- docs/current/README.md | 6 +++--- docs/reports/README.md | 4 ++-- docs/reports/documentation-audit-20260917.md | 4 ++-- 8 files changed, 20 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index 728c0d4df..5e703ec1e 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,8 @@ # 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 验证全绿通过。 +> **内部工程代码代号**：`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`（核心教务全链路打通，具备局域网试用条件）。 --- diff --git a/docs/README.md b/docs/README.md index 2a27cd934..f342b2c80 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,7 +1,7 @@ # SYFJGYD学员管理系统 — 文档中心全景地图 (Docs Map) -> **正式业务名称**：`SYFJGYD学员管理系统`（内部工程代号：RailwaySystem） -> **共享试用环境**：[http://192.168.139.230:8082/](http://192.168.139.230:8082/)（部署分支：`feat/cicd-pipeline`） +> **正式业务名称**：`SYFJGYD学员管理系统`（内部工程代号：RailwaySystem） +> **共享试用环境**：[http://192.168.139.230:8082/](http://192.168.139.230:8082/)（部署分支：`feat/cicd-pipeline`） > **核心质量结论**：核心教务正向闭环全面就绪，三角色工作台验证通过，测试全绿 **331 / 331 PASS**。 --- diff --git a/docs/current/01-current-status.md b/docs/current/01-current-status.md index 241fa6093..c8275439d 100644 --- a/docs/current/01-current-status.md +++ b/docs/current/01-current-status.md @@ -1,9 +1,9 @@ # 01. 系统当前真实状态速览 (Current Status) -> **系统正式名称**：`SYFJGYD学员管理系统`（内部工程代号：RailwaySystem） -> **共享试用分支**：`feat/cicd-pipeline` -> **共享试用地址**：[http://192.168.139.230:8082/](http://192.168.139.230:8082/) -> **共享试用数据库**：`training`（国产人大金仓 KingbaseES V9 实例） +> **系统正式名称**：`SYFJGYD学员管理系统`（内部工程代号：RailwaySystem） +> **共享试用分支**：`feat/cicd-pipeline` +> **共享试用地址**：[http://192.168.139.230:8082/](http://192.168.139.230:8082/) +> **共享试用数据库**：`training`（国产人大金仓 KingbaseES V9 实例） > **当前试用就绪度**：`READY_WITH_EXTERNAL_BLOCKERS`（具备教务与教学现场试用条件） --- diff --git a/docs/current/02-phase1-status.md b/docs/current/02-phase1-status.md index 99640736a..f2a4ded3c 100644 --- a/docs/current/02-phase1-status.md +++ b/docs/current/02-phase1-status.md @@ -1,6 +1,6 @@ # 02. 一期需求实现状态全景判定 (Phase 1 Status) -> **最高原则**：**具备共享试用条件 ≠ 一期全部需求正式完成**。 +> **最高原则**：**具备共享试用条件 ≠ 一期全部需求正式完成**。 > 团队坚持实事求是，严格区分“核心教务已验证能力”与“待业务确认/研发推进中能力”，杜绝虚报与浮夸。 --- diff --git a/docs/current/03-shared-trial.md b/docs/current/03-shared-trial.md index 87db1097b..5ed80476e 100644 --- a/docs/current/03-shared-trial.md +++ b/docs/current/03-shared-trial.md @@ -1,8 +1,8 @@ # 03. 局域网共享试用指南 (Shared Trial Guide) -> **重要性质声明**： -> 1. 本环境为面向沈阳房建公寓段业务主管、教务人员与授课教员的**内部共享试用环境 (Shared Trial Environment)**； -> 2. **本环境不是最终正式生产环境**，请勿录入未经授权的敏感业务核心数据； +> **重要性质声明**： +> 1. 本环境为面向沈阳房建公寓段业务主管、教务人员与授课教员的**内部共享试用环境 (Shared Trial Environment)**； +> 2. **本环境不是最终正式生产环境**，请勿录入未经授权的敏感业务核心数据； > 3. 代码部署分支为 `feat/cicd-pipeline`，请勿随意向该分支推送未经验证的代码。 --- diff --git a/docs/current/README.md b/docs/current/README.md index 9fd5bebcc..ff3d37326 100644 --- a/docs/current/README.md +++ b/docs/current/README.md @@ -1,8 +1,8 @@ # SYFJGYD学员管理系统 — 当前项目速览中心 (Current) -> **核心定位**：专为任何需要“在 3 分钟内快速掌握项目当前实际现状”的读者提供的唯一权威速览入口。 -> **正式业务名称**：`SYFJGYD学员管理系统`（内部工程代号：RailwaySystem） -> **共享试用环境**：[http://192.168.139.230:8082/](http://192.168.139.230:8082/)（部署分支：`feat/cicd-pipeline`） +> **核心定位**：专为任何需要“在 3 分钟内快速掌握项目当前实际现状”的读者提供的唯一权威速览入口。 +> **正式业务名称**：`SYFJGYD学员管理系统`（内部工程代号：RailwaySystem） +> **共享试用环境**：[http://192.168.139.230:8082/](http://192.168.139.230:8082/)（部署分支：`feat/cicd-pipeline`） > **当前试用就绪度**：`READY_WITH_EXTERNAL_BLOCKERS`（核心业务全通，具备局域网教学试用条件） --- diff --git a/docs/reports/README.md b/docs/reports/README.md index 63bbd6072..a38d08ae0 100644 --- a/docs/reports/README.md +++ b/docs/reports/README.md @@ -1,7 +1,7 @@ # RailwaySystem 质量验收与测试报告中心 (Reports) -> **当前法定最终验收报告入口**：[`integrated-acceptance/FINAL_PHASE1_20260917_101044/`](integrated-acceptance/FINAL_PHASE1_20260917_101044/README.md) -> **试用就绪度裁定**：`PHASE_ONE_TRIAL_READINESS = READY_WITH_EXTERNAL_BLOCKERS` +> **当前法定最终验收报告入口**：[`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)**，三角色浏览器端到端全链路打通。 --- diff --git a/docs/reports/documentation-audit-20260917.md b/docs/reports/documentation-audit-20260917.md index fe7b6ba87..2702ea4f4 100644 --- a/docs/reports/documentation-audit-20260917.md +++ b/docs/reports/documentation-audit-20260917.md @@ -1,7 +1,7 @@ # SYFJGYD学员管理系统 — 全量文档资产盘点与信息架构审计报告 -> **审计分支**：`feat/cicd-pipeline`（Commit: `73c8a68f`） -> **审计时间**：2026-09-17 +> **审计分支**：`feat/cicd-pipeline`（Commit: `73c8a68f`） +> **审计时间**：2026-09-17 > **执行原则**：坚持客观事实，理清入口权威，消除歧义误导；本阶段不搞大规模文件破坏性搬迁，优先完成入口收敛与旧报告归档。 --- From ccc713d0cc8fcd538bb25a8ad50ec96a4207b371 Mon Sep 17 00:00:00 2001 From: wangzhibiao Date: Thu, 17 Sep 2026 16:31:13 +0800 Subject: [PATCH 7/7] =?UTF-8?q?=E6=96=87=E6=A1=A3=E4=BF=AE=E6=AD=A3?= =?UTF-8?q?=EF=BC=9A=E6=A0=A1=E5=87=86=E5=BD=93=E5=89=8D=E7=8A=B6=E6=80=81?= =?UTF-8?q?=E5=8F=A3=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验收基线)