docs: 归档项目需求分析、一期开发说明书及Kingbase数据库审计报告

2026-09-13 23:16:37 +08:00
1 parent 83797f9286
commit 9d053bf41f
@@ -0,0 +1,103 @@
+# Git 状态（只读快照）
+
+> 审计开始时读取；没有执行 `reset`、`checkout`、`clean`、`restore`、stage、commit 或其他工作区修改命令。审计结束后会额外出现本目录下 12 个允许生成的 Markdown 文件。
+
+## 1. 当前分支
+
+```text
+main
+```
+
+## 2. 最近 5 个提交
+
+```text
+83797f92 2026-09-10 15:40:10 +0800 add RuoYi-Vue
+6d0feb95 2026-09-10 15:20:14 +0800 初始版本
+b2486c37 2026-09-10 14:14:00 +0800 上传新文件
+a1d771b7 2026-09-10 14:13:49 +0800 上传新文件
+9815093e 2026-09-10 14:13:00 +0800 上传新文件
+```
+
+## 3. 审计开始时的已跟踪未提交修改
+
+```text
+M RuoYi-Vue/ruoyi-admin/src/main/java/com/ruoyi/web/controller/train/TrainClassroomInfoController.java
+M RuoYi-Vue/ruoyi-admin/src/main/java/com/ruoyi/web/controller/train/TrainDormitoryInfoController.java
+M RuoYi-Vue/ruoyi-admin/src/main/java/com/ruoyi/web/controller/train/TrainScoreInfoController.java
+M RuoYi-Vue/ruoyi-admin/src/main/resources/application.yml
+M RuoYi-Vue/ruoyi-admin/src/main/resources/logback.xml
+M build_ui/src/api/train/info.js
+M build_ui/src/views/login.vue
+M build_ui/src/views/train/dormitory/index.vue
+M build_ui/vue.config.js
+```
+
+`git diff --stat`：9 个文件，102 行新增、132 行删除。主要内容是教室/宿舍/成绩 Controller 路径别名、本地上传和日志路径、教室 API 路径、登录页默认口令、宿舍页面以及 Node 22/前端端口适配。
+
+## 4. 审计开始时的未跟踪文件
+
+### 系统/临时文件
+
+```text
+.DS_Store
+RuoYi-Vue/.DS_Store
+doc/.~学员管理系统功能分析_20260831.docx
+doc/.~学员管理系统数据表设计_20260907_1_.docx
+doc/.~学员管理系统相关需求.docx
+```
+
+### 代码与运行文件
+
+```text
+RuoYi-Vue/ruoyi-admin/D:/maven_repository/com/kingbase/kingbase8/8.6.0/kingbase8-8.6.0.jar
+build_ui/src/api/train/classroom.js
+build_ui/src/api/train/dormitory.js
+build_ui/src/api/train/score.js
+build_ui/src/views/train/course-score/index.vue
+build_ui/src/views/train/equipment/index.vue
+build_ui/src/views/train/extra/index.vue
+build_ui/src/views/train/score/index.vue
+build_ui/src/views/train/student-score/index.vue
+start-local.sh
+```
+
+### 既有分析文档
+
+```text
+RuoYi-Vue/docs/kingbase_compatibility_audit.md
+RuoYi-Vue/docs/kingbase_fact_check.md
+doc/RailwaySystem 一期 P0 需求确认表 V0.1.md
+doc/RailwaySystem 一期需求分析与业务基线 V0.1.md
+doc/RailwaySystem 一期默认开发决策与需求假设 V0.1.md
+doc/RailwaySystem 智慧培训系统一期 PRD V0.9.md
+doc/学员管理系统功能分析_20260831.md
+doc/学员管理系统数据表设计_20260907_1_.md
+doc/学员管理系统相关需求.md
+doc/智慧培训系统一期详细开发说明书.md
+doc/elk.bundled.js
+doc/railwaysystem.html
+```
+
+## 5. 本次审计新增的允许文件
+
+```text
+docs/codebase-audit/00_project_overview.md
+docs/codebase-audit/01_project_tree.md
+docs/codebase-audit/02_training_modules_inventory.md
+docs/codebase-audit/03_database_current_state.md
+docs/codebase-audit/04_api_inventory.md
+docs/codebase-audit/05_frontend_inventory.md
+docs/codebase-audit/06_security_and_permissions.md
+docs/codebase-audit/07_runtime_and_environment.md
+docs/codebase-audit/08_git_status.md
+docs/codebase-audit/09_reusable_ruoyi_capabilities.md
+docs/codebase-audit/10_gap_and_conflict_analysis.md
+docs/codebase-audit/11_executive_summary.md
+```
+
+## 6. 仓库卫生观察
+
+- Git 已跟踪约 116,171 个 `node_modules*` 下的依赖文件；这使仓库体积、diff、跨平台复现和依赖更新成本显著上升。
+- POM 的 Windows 绝对输出路径 `D:\maven_repository\...` 在 macOS 工作区生成了字面 `D:` 目录和未跟踪 JAR。
+- Git remote 配置中包含内联认证信息；本报告将其记为 `[REDACTED_SECRET]`，不复述远端地址。应由仓库负责人单独处理凭据和远端配置。
+- 当前可见前端能力有一部分只存在于未跟踪文件；如果在其他机器从 `main` 克隆，将缺少这些页面/API。