blp/railwaysystem
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
8ad0f5172e46e51a2ca802ed390d56ce729c2163
railwaysystem/docs/current/01-CURRENT-SYSTEM-STATE.md
T
wangzhibiao 8ad0f5172e 文档架构：建立唯一现行系统真理文档门户 (Current Truth Bootstrap) 
docs: bootstrap canonical current truth portal (00-START-HERE through 08-NEXT-ACTIONS)
2026-09-23 23:50:37 +08:00

6.9 KiB
Raw Blame History

01 - 系统当前运行基线与真实状态 (Current System State)

更新时间：2026-09-23 数据核验基准：底层源码、真实 Kingbase 迁移脚本与当前 Git HEAD 状态。

1. 核心事实核验基线总览

================================================================================
                    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/
  • 网络访问路径：
    • 本地局域网内直接走 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。
  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。
  • 甲方参考资料作为外部参考依据，在甲方正式签署确认前，不作为法定合同变更与现行需求。
Reference in new issue View Git Blame Copy Permalink