Files
railwaysystem/docs/codebase-audit/12_baseline_classification.md
wangzhibiao fb00f67d3b docs(审计): 完成Phase 0工程与数据库基线核验
记录当前Git开发基线、Kingbase真实表结构、培训数据与权限状态。

补充数据库与代码差异、只读兼容性验证及PRD V1.0核心对象映射,未包含业务代码或数据库修改。
2026-09-14 00:36:53 +08:00

5.2 KiB

Phase 0:当前 Git 基线分类

核验时间:2026-09-14 业务判断最高依据:doc/RailwaySystem 智慧培训系统一期 PRD V1.0.md 本文件记录生成 Phase 0 报告前的工作树。未执行 stage、commit、reset、clean、restore 或 checkout。

1. 当前 HEAD 与分支

项目 值
HEAD e12eda059679b89eb5d09215ffe1ce7132f161f2
branch main
HEAD提交 docs(prd): 发布RailwaySystem智慧培训系统一期PRD V1.0正式业务基线
提交时间 2026-09-13 23:52:29 +0800

结论:后续业务判断应以当前 main@e12eda05 与 PRD V1.0 为起点。原 00—11 审计报告已经提交,但早于 PRD V1.0;涉及一期范围与模型优先级的旧结论由本轮 12—17 报告修正。

2. 已跟踪未提交文件

当前只有 3 个已跟踪删除:

D doc/elk.bundled.js
D doc/railwaysystem.html
D doc/智慧培训系统一期详细开发说明书.md

这些文件的同名内容出现在未跟踪目录 doc/wxy_doc/,其中 readme.md 明确写着“王杏月师姐生成的文档(暂不使用)”。当前状态表现为一次尚未提交的旧材料归档/移动,不是业务代码删除。

3. 未跟踪文件

doc/wxy_doc/智慧培训系统一期详细开发说明书.md
doc/wxy_doc/elk.bundled.js
doc/wxy_doc/railwaysystem.html
doc/wxy_doc/readme.md

没有未跟踪 Java、Mapper XML、Vue业务页面、前端API、SQL迁移或运行脚本。生成本轮报告后,docs/codebase-audit/12_*.md 至 17_*.md 会作为本任务授权的新文件出现在工作树中。

4. 工作树文件分类

分类 当前文件/状态 判断
正式培训功能 当前无未提交项;成绩、宿舍、教室适配已在 a03f4268 提交 属于当前 HEAD正式代码基线
本地运行适配 当前无未提交项;application.yml、logback.xml、login.vue、vue.config.js 已在 bd51fe1f 提交 已纳入正式基线,但仍是开发环境适配性质
Kingbase/Tailscale适配 application-druid.yml、start-local.sh 已在 92f0f030 提交 已纳入正式基线;datasource 通过本地 4321 隧道访问 Kingbase
临时文件 当前 git status 未发现 Office锁文件、.DS_Store、日志等 无未提交临时文件
遗留/实验页面 当前无改动;build_ui/src/views/train/person、character、analysis、weather 等仍被 Git跟踪 与PRD V1.0核心闭环无对应后端,应视为遗留/实验资产
旧业务材料 3个根目录旧文件被删除,并复制/移动到未跟踪 doc/wxy_doc/ PRD V1.0明确它们仅作参考;当前归档动作尚未提交
构建产物 当前状态中无新增构建产物 未发现未跟踪 JAR、target、dist或依赖目录

5. 指定文件逐项核对

5.1 成绩相关页面/API

以下文件已提交并且当前相对 HEAD 无修改:

  • build_ui/src/api/train/score.js
  • build_ui/src/views/train/score/index.vue
  • build_ui/src/views/train/course-score/index.vue
  • build_ui/src/views/train/student-score/index.vue
  • TrainScoreInfoController.java 的 /train/scoreinfo、/train/score 别名

它们是正式培训功能代码,但仍实现旧的固定三列成绩模型,与 PRD V1.0 的“成绩项目 + 权重 + 参训学员得分”冲突。

5.2 宿舍相关页面/API

build_ui/src/api/train/dormitory.js、build_ui/src/views/train/dormitory/index.vue 与 TrainDormitoryInfoController 别名已在 a03f4268 提交,当前干净。它们属于正式培训 CRUD,但只能表达房间汇总;住宿安排和门禁授权仍耦合在旧模型中。

5.3 教室 API 别名

TrainClassroomInfoController 当前同时支持:

/train/classroominfo
/train/classroom
/train/info

build_ui/src/api/train/info.js 和新增的 classroom.js 均已提交。别名修复属于正式接通代码,但多个入口并存需要在后续 API 契约阶段确定正式路径。

5.4 start-local.sh

已由提交 92f0f030 纳入 Git。脚本负责数据库 SSH隧道、Redis、后端 JAR与前端启动,属于本地开发基础设施,不是培训业务功能。

5.5 Node 22适配

build_ui/vue.config.js 中 MD4到 SHA-256的兼容补丁与前端端口 8080已在 bd51fe1f 提交,当前无本地修改。它属于本地工具链适配。

5.6 Kingbase相关修改

  • application-druid.yml 的 JDBC地址已改为 127.0.0.1:4321 隧道入口,并在 92f0f030 提交。
  • Kingbase驱动和 Maven依赖已在更早提交中存在。
  • 当前没有未提交的 Kingbase配置或代码改动。
  • 本轮只读核验发现的兼容问题未被自动修复。

6. 当前可作为正式开发基线的代码状态

代码版本以 main@e12eda05 为可识别基线,因为培训页面/API、本地运行适配、Kingbase隧道和 PRD V1.0 都已提交。工作树中的 3个删除与 doc/wxy_doc/ 只涉及旧参考材料,不改变编译产物。

不过该 HEAD还不能直接称为“可开始业务开发”的稳定运行基线:实时数据库的若依系统表存在 schema同名冲突和角色关系异常,详见 13_live_database_snapshot.md、15_live_permission_snapshot.md 和 16_kingbase_readonly_compatibility.md。