wangzhibiao
122a242dd0
1. 明确 build_ui/ 为前端唯一构建与部署真源，RuoYi-Vue/ruoyi-ui 标记为历史归档备份； 2. 标记 ACCOM-PERM-01 为 RESOLVED_2026-09-23 已彻底闭环，内部 P0 阻断项清零； 3. 对全量 104 项内部 API 端点完成源码级表追踪 (VERIFIED_FROM_SOURCE) 与 build_ui 视图引用验证； 4. 外部 Client API 矩阵全面引入最后验证时间、验证方式、证据源与实时响应四项证据字段； 5. 更新下一阶段标准化行动路线图为严格 16 步标准流。
144 lines
8.4 KiB
Markdown
144 lines
8.4 KiB
Markdown
# 01 - 系统当前运行基线与真实状态 (Current System State)
|
||
|
||
> **更新时间**：2026-09-23
|
||
> **数据核验基准**：底层源码、真实 Kingbase 迁移脚本与当前 Git HEAD 状态。
|
||
|
||
---
|
||
|
||
## 1. 核心事实核验基线总览
|
||
|
||
```text
|
||
================================================================================
|
||
RAILWAYSYSTEM RUNTIME VERIFIED STATE
|
||
================================================================================
|
||
CURRENT_GIT_BRANCH = fix/phase0-product-defects-20260923
|
||
CURRENT_GIT_HEAD_COMMIT = 2f05f310
|
||
DEPLOYMENT_TRACKING_BRANCH = feat/cicd-pipeline (HEAD: eb1ddfca)
|
||
SHARED_TRIAL_URL = http://192.168.139.230:8082/
|
||
SHARED_TRIAL_DB = training (KingbaseES V9 at 192.168.139.218:4321)
|
||
|
||
ACTIVE_FRONTEND_SOURCE = build_ui/ (Vue 2.6 / Element UI)
|
||
INACTIVE_LEGACY_FRONTEND = RuoYi-Vue/ruoyi-ui (LEGACY COPY, NOT BUILD/DEPLOY SOURCE)
|
||
BACKEND_SOURCE_OF_TRUTH = RuoYi-Vue (Spring Boot 2.5.15 / Java 8)
|
||
BACKEND_TEST_SUITE_STATUS = 331 / 331 PASS (Surefire Verified)
|
||
|
||
DEMO_STATUS = OLD_DEMO_UNTRUSTWORTHY / NEW_DEMO_NOT_YET_STARTED
|
||
DOCS_STATUS = PHASE_A6_1_COMPLETE / PHASE_B_GATE_BLOCKED
|
||
CLIENT_REQUIREMENT_STATUS = CLIENT_REFERENCE_PACK_UNCONFIRMED (INTERNAL_FREEZE)
|
||
|
||
CURRENT_OPEN_P0_BLOCKERS = NONE (0 open internal P0 blockers)
|
||
RECENTLY_RESOLVED_BLOCKERS = ACCOM-PERM-01 (RESOLVED_2026-09-23)
|
||
EXTERNAL_BLOCKERS = DMS_EXTERNAL_HARDWARE (BLOCKED_EXTERNAL)
|
||
================================================================================
|
||
```
|
||
|
||
---
|
||
|
||
## 2. 前后端源码与技术栈真实情况
|
||
|
||
### 2.1 前端工程事实：`build_ui/` 唯一活跃真源
|
||
- **活跃构建与部署真源**：`build_ui/`
|
||
- **核心证据 1**：`.gitlab-ci.yml` 构建脚本明确执行 `cd build_ui && npm run build:prod`；
|
||
- **核心证据 2**：CI/CD 部署发布步骤直接复制产物：`cp -r build_ui/dist/* /data2/wzb/deploy/frontend/`；
|
||
- **核心证据 3**：最新业务缺陷修复与界面交互优化均发生于 `build_ui/src/...`；
|
||
- **核心证据 4**：本地 Vue dev server 统一从 `build_ui` 目录启动运行。
|
||
- **历史非活跃目录声明**：
|
||
- `RuoYi-Vue/ruoyi-ui` 明确定义为 **`LEGACY / INACTIVE FRONTEND COPY`**；
|
||
- 严禁将其视为构建源或部署源，未来文档清理时归档。
|
||
- **技术栈**：Vue 2.6.12 + Vuex 3.6.0 + Vue Router 3.4.9 + Element UI 2.15.8 + Axios + ECharts 5.x。
|
||
- **业务视图根路径**：`build_ui/src/views/train/`
|
||
- `teacher/`：教师档案管理、资质证书与任教历史；
|
||
- `student/`：学员主档、身份信息密文展示与报到流水；
|
||
- `course/`：课程库、教学大纲与学时学分配置；
|
||
- `plan/`：培训班级计划、开班生命周期阶段流转；
|
||
- `lesson/`：排课课表、四维冲突时段预检；
|
||
- `accommodation/`：宿舍房间管理、床位分配与住宿履历（**入住/退宿/调房已验证通过**）；
|
||
- `checkin/`：学员考勤流水、教师代签补卡与请假核验；
|
||
- `portrait/`：学员 360 度成长素养画像视图；
|
||
- `board/`：电子班牌设备信息管理。
|
||
- **自服务专属界面**：
|
||
- 教师工作台 (`teacher/workbench` / `TrainTeacherMeController`)
|
||
- 学员个人培训中心 (`student/center` / `TrainStudentMeController`)
|
||
|
||
### 2.2 后端工程事实 (`RuoYi-Vue`)
|
||
- **核心框架**：Spring Boot 2.5.15 + MyBatis 3.5.6 + PageHelper + 国产人大金仓驱动 (`kingbase8-8.6.0.jar`)。
|
||
- **工程模块分层**：
|
||
- `ruoyi-admin`：Web 控制器、Spring Security 过滤链、全局异常处理、登录鉴权；
|
||
- `ruoyi-train`：铁路教务核心业务服务（Domain, Service, Mapper, DMS 集成适配器）；
|
||
- `ruoyi-framework`：Shiro/Security 配置、数据源切面、数据权限切面 (`DataScopeAspect`)；
|
||
- `ruoyi-system`：RuoYi 系统底座（用户、角色、部门、岗位、字典、配置）；
|
||
- `ruoyi-common`：工具类、国密 SM4 加密组件、通用常量。
|
||
|
||
---
|
||
|
||
## 3. 当前部署与运行时事实
|
||
|
||
- **共享试用地址**：[http://192.168.139.230:8082/](http://192.168.139.230:8082/)
|
||
- **网络访问路径**：
|
||
- 本地局域网内直接走 `DIRECT_LAN` 访问；
|
||
- 远程接入通过 Tailscale 走 `TAILSCALE_SUBNET_ROUTE`（经过 utun 虚拟网卡）；
|
||
- **数据库连接**：
|
||
- 实例：人大金仓 KingbaseES V9 (Port: 4321)
|
||
- 综合验收数据库：`railwaysystem_integrated_qa_20260916`
|
||
- 共享试用数据库：`training`
|
||
- **当前试用就绪度判定**：`READY_WITH_EXTERNAL_BLOCKERS`
|
||
- 核心教务管理主闭环稳定流畅；
|
||
- 教师与学员自服务工作台权限隔离生效；
|
||
- 住宿业务生命周期权限已闭环；
|
||
- 外部智能门锁接口受限（见已知阻塞）。
|
||
|
||
---
|
||
|
||
## 4. 活跃 Worktree 分布现状
|
||
|
||
当前在多任务并行环境下，系统存在以下 8 个活跃 Git Worktree，各司其职且相互隔离：
|
||
|
||
| 工作树路径 | 关联分支 | 当前主要任务与定位 |
|
||
| :--- | :--- | :--- |
|
||
| `主工程根目录 (RailwaySystem)` | `fix/phase0-product-defects-20260923` | **主工程代码工作区**，包含产品缺陷修复与住宿操作前端补丁 |
|
||
| `docs-cleanup-audit-20260923` | `chore/docs-cleanup-audit-20260923` | **文档信息架构治理专项区**，完成 Phase A/A.5/A.6/A.6.1 审计 |
|
||
| `client-reference-alignment-20260923` | `analysis/client-reference-alignment-20260923` | **甲方参考稿对齐专项区**，完成 14 项参考资料逐页比对 |
|
||
| `ex13-bed-overlap-error-contract-20260923` | `fix/ex13-bed-overlap-business-error-20260923` | **EX-13 床位冲突错误码专项区** |
|
||
| `fix-clear-defects-20260922` | `fix/preview-clear-defects-20260922` | 缺陷清理与 DMS 禁用态统一声明 |
|
||
| `integrate-abc-preview-candidate-20260921`| `fix/preview-attendance-signin-ui-20260921` | 考勤签到 UI 策略对齐与验证 |
|
||
| `release-preview-candidate-20260921` | `release/preview-candidate-20260921` | 预发布候选版本稳定性验证 |
|
||
| `dms-real-probe-20260916` | `integration/dms-real-probe-20260916` | DMS 局域网真实连通与只读契约探测凭据区 |
|
||
|
||
---
|
||
|
||
## 5. 当前阻断项判定与历史闭环记录
|
||
|
||
### 5.1 当前内部 P0 阻断项：`CURRENT_OPEN_P0_BLOCKERS = NONE (0 项)`
|
||
系统当前无未解决的内部 P0 级代码或业务阻断项。
|
||
|
||
### 5.2 历史阻断项闭环记录：`ACCOM-PERM-01 (RESOLVED_2026-09-23)`
|
||
- **事实状态**：`ACCOM_PERM_FIX = RESOLVED`，`SOURCE_MIGRATION_FIXED = YES`，`QA_DB_PERMISSION_FIXED = YES`，`TRAIN_ADMIN_UI_VERIFIED = YES`。
|
||
- **解决事实**：
|
||
- `015_dms_package_a_hardening.sql` 修正生效，`role_id=3` (train_admin) 正确获得 `menu_id=2263` (`train:accommodation:edit`)；
|
||
- `train_admin` 按最小权限原则不授予破坏性 `train:accommodation:remove`；
|
||
- 11 个相关权限契约测试 PASS；
|
||
- 真实 `qa_train_admin` 浏览器验证：预分配状态行“入住”Visible，“删除”Hidden；在住状态行“调房”Visible，“退宿”Visible。
|
||
- **正式移出当前阻断列表**。
|
||
|
||
### 5.3 外部客观环境阻塞项：`DMS_EXTERNAL_HARDWARE (BLOCKED_EXTERNAL)`
|
||
- 厂商可访问测试环境中挂载的房间与门锁数量为 0。
|
||
- 无法在运行时验证真实房间与门锁行级字段映射，物理下发操作禁止执行。
|
||
|
||
---
|
||
|
||
## 6. 演示、文档与需求状态定位
|
||
|
||
### 6.1 演示状态 (Demo Status)
|
||
- **旧 Demo 状态**：`OLD_DEMO_UNTRUSTWORTHY`。历史 reports 中包含的演示截图与账本存在固定数据污染、超管代跑掩盖权限缺陷等问题，不可作为系统当前可信状态依据。
|
||
- **新 Demo 状态**：`NEW_DEMO_NOT_YET_STARTED`。必须等待 `CLEAN_DEMO_DATABASE` 重建和确定性种子数据灌入后重新启动。
|
||
|
||
### 6.2 文档状态 (Docs Status)
|
||
- Phase A.6.1 完整性纠偏已在审计工作树中圆满收官（21 份物理产物、53 份争议资产物理绑定、0 路径碰撞）。
|
||
- 整体搬迁与删除（Phase B）处于阻断状态 (`READY_FOR_PHASE_B = NO`)，待演示彻底冻结后执行。
|
||
- 当前正在执行 `CURRENT TRUTH PASS`，保持唯一权威入口。
|
||
|
||
### 6.3 甲方需求状态 (Client Requirement Status)
|
||
- **材料定性**：`SOURCE_TYPE = CLIENT_REFERENCE`, `REQUIREMENT_STATUS = UNCONFIRMED`。
|
||
- **治理状态**：`CLIENT_REFERENCE_ACTIVE_WRITER = NO`, `CLIENT_REFERENCE_PACK_INTERNAL_FREEZE = YES`。
|
||
- 甲方参考资料作为外部参考依据，在甲方正式签署确认前，不作为法定合同变更与现行需求。
|