blp/railwaysystem
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
9030d797f42afadc14c1c3bba41cedf42e4db307
railwaysystem/docs/current/01-CURRENT-SYSTEM-STATE.md
T
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 步标准流。
2026-09-24 00:03:47 +08:00

8.4 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)

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