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

103 lines
5.2 KiB
Markdown

# 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 个已跟踪删除:
```text
D doc/elk.bundled.js
D doc/railwaysystem.html
D doc/智慧培训系统一期详细开发说明书.md
```
这些文件的同名内容出现在未跟踪目录 `doc/wxy_doc/`,其中 `readme.md` 明确写着“王杏月师姐生成的文档(暂不使用)”。当前状态表现为一次尚未提交的旧材料归档/移动,不是业务代码删除。
## 3. 未跟踪文件
```text
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` 当前同时支持:
```text
/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`。