railwaysystem/docs/current/01-CURRENT-SYSTEM-STATE.md

# 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`。
- 甲方参考资料作为外部参考依据，在甲方正式签署确认前，不作为法定合同变更与现行需求。