0 Fork 0

Files

T

wangzhibiao fb00f67d3b docs(审计): 完成Phase 0工程与数据库基线核验

记录当前Git开发基线、Kingbase真实表结构、培训数据与权限状态。

补充数据库与代码差异、只读兼容性验证及PRD V1.0核心对象映射，未包含业务代码或数据库修改。

2026-09-14 00:36:53 +08:00

5.2 KiB

Raw Blame History

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。

5.2 KiB Raw Blame History