# 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)
FRONTEND_SOURCE_OF_TRUTH      = RuoYi-Vue/ruoyi-ui (Vue 2.6 / Element UI)
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_KNOWN_BLOCKERS_COUNT  = 2 (ACCOM-PERM-01, DMS_EXTERNAL_HARDWARE)
================================================================================
```

---

## 2. 前后端源码与技术栈真实情况

### 2.1 前端工程事实 (`RuoYi-Vue/ruoyi-ui`)
- **技术栈**：Vue 2.6.12 + Vuex 3.6.0 + Vue Router 3.4.9 + Element UI 2.15.8 + Axios + ECharts 5.x。
- **业务视图根路径**：`ruoyi-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. 当前核心阻断项 (Current Known Blockers)

1. **`ACCOM-PERM-01` (产品级阻断)**：
   - 住宿生命周期操作（入住、退宿、调房）在 `sys_menu` 与角色授权中未授予 `train_admin` 角色。
   - 阻断 6 个业务验收场景（SM-10, SM-11, SM-12, SM-13, BR-11, EXT-02）。详见 [07-KNOWN-GAPS.md](07-KNOWN-GAPS.md)。
2. **DMS 外部物理硬件阻塞 (`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 BOOTSTRAP`，建立唯一权威入口。

### 6.3 甲方需求状态 (Client Requirement Status)
- **材料定性**：`SOURCE_TYPE = CLIENT_REFERENCE`, `REQUIREMENT_STATUS = UNCONFIRMED`。
- **治理状态**：`CLIENT_REFERENCE_ACTIVE_WRITER = NO`, `CLIENT_REFERENCE_PACK_INTERNAL_FREEZE = YES`。
- 甲方参考资料作为外部参考依据，在甲方正式签署确认前，不作为法定合同变更与现行需求。