Files
railwaysystem/docs/codebase-audit/01_project_tree.md
T

108 lines
6.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# RailwaySystem 简化项目树
已忽略 `.git`、`node_modules*`、`target`、`dist`、IDE 目录、日志、Office 临时锁文件和大型依赖目录。
```text
RailwaySystem/
├── RuoYi-Vue/ # Maven 后端父工程,同时保留一个旧/基础 Vue 工程
│ ├── pom.xml # 3.9.1 父 POM,聚合 7 个 Maven 模块
│ ├── README.md # RuoYi-Vue 3.9.1 说明
│ ├── ruoyi-admin/
│ │ └── src/main/
│ │ ├── java/com/ruoyi/
│ │ │ ├── RuoYiApplication.java
│ │ │ └── web/controller/
│ │ │ ├── common/ # 文件上传下载
│ │ │ ├── monitor/ # 监控、日志、在线用户等
│ │ │ ├── system/ # 用户、角色、菜单、字典、配置等
│ │ │ └── train/ # 14 个培训 Controller
│ │ └── resources/
│ │ ├── application.yml
│ │ ├── application-druid.yml
│ │ ├── logback.xml
│ │ └── mybatis/mybatis-config.xml
│ ├── ruoyi-common/
│ │ └── src/main/java/com/ruoyi/common/
│ │ ├── annotation/ # @Log、@DataScope、@Excel 等
│ │ ├── core/ # BaseEntity、AjaxResult、分页模型
│ │ ├── exception/ # 公共异常
│ │ └── utils/ # Excel、文件、分页、Security 等工具
│ ├── ruoyi-framework/
│ │ └── src/main/java/com/ruoyi/framework/
│ │ ├── aspectj/ # 操作日志、数据权限切面
│ │ ├── config/ # Security、Redis、Druid等配置
│ │ ├── security/filter/ # JWT 请求过滤器
│ │ └── web/ # Token/Login 服务、全局异常处理
│ ├── ruoyi-system/
│ │ └── src/main/
│ │ ├── java/com/ruoyi/system/ # sys_user/sys_role/sys_menu等领域与服务
│ │ └── resources/mapper/system/# 系统表 MyBatis XML
│ ├── ruoyi-quartz/ # Quartz 任务、任务日志、Controller/Mapper
│ ├── ruoyi-generator/ # 代码生成 Controller/Service/Mapper/模板
│ ├── ruoyi-train/
│ │ └── src/main/
│ │ ├── java/com/ruoyi/train/
│ │ │ ├── domain/ # 14 个 Train* Entity;均继承 BaseEntity
│ │ │ ├── mapper/ # 14 个 Mapper 接口
│ │ │ └── service/
│ │ │ └── impl/ # 14 个 ServiceImpl
│ │ └── resources/mapper/train/ # 14 个 Mapper XML
│ ├── ruoyi-ui/ # 历史/基础 Vue 2 前端,描述为知识图谱平台
│ │ └── src/{api,router,store,views}
│ └── sql/
│ ├── ry_20250522.sql # 若依系统表 MySQL 风格初始化脚本
│ └── quartz.sql # Quartz 表脚本
├── build_ui/ # 当前智慧培训管理平台 Vue 2 前端
│ ├── package.json
│ ├── vue.config.js # 当前开发端口 8080,代理后端 8090
│ ├── .env.development
│ ├── .env.staging
│ ├── .env.production
│ └── src/
│ ├── api/
│ │ ├── system/ # 用户、角色、菜单、字典等若依 API
│ │ ├── monitor/ # 监控 API
│ │ ├── tool/ # 代码生成 API
│ │ └── train/ # 培训 API 文件
│ ├── router/index.js # 常量路由;业务菜单由 /getRouters 动态加载
│ ├── store/modules/permission.js # 动态路由组装与权限过滤
│ └── views/
│ ├── system/ # 若依系统管理页面
│ ├── monitor/ # 若依监控页面
│ ├── tool/ # 若依代码生成/Swagger页面
│ ├── dashboard/ # 若依示例图表组件
│ └── train/
│ ├── teacher/ # 教师 CRUD
│ ├── student/ # 学员 CRUD
│ ├── course/ # 课程 CRUD
│ ├── plan/ # 开班计划 CRUD
│ ├── dormitory/ # 宿舍 CRUD(当前有未提交改动)
│ ├── auth/ # 宿舍权限 CRUD
│ ├── classroom/ # 教室 CRUD
│ ├── site/ # 实训场地 CRUD
│ ├── report/ # 开班报到 CRUD
│ ├── board/ # 电子班牌 CRUD
│ ├── checkin/ # 签到 CRUD
│ ├── score/ # 成绩 CRUD(未跟踪)
│ ├── duration/ # 学习时长 CRUD
│ ├── portrait/ # 画像记录 CRUD
│ ├── student-score/ # 成绩筛选视图(未跟踪)
│ ├── course-score/ # 课程成绩筛选视图(未跟踪)
│ ├── equipment/ # 规划提示页(未跟踪)
│ ├── extra/ # 规划提示页(未跟踪)
│ ├── person/ # 旧知识图谱人物页面
│ ├── character/ # 旧图谱/示例统计页面
│ ├── analysis/ # 旧分析页面
│ └── weather/ # 旧天气页面
├── doc/ # 需求、数据表设计、功能分析与补充材料
├── uploadPath/ # 文件上传目录
└── start-local.sh # 未跟踪的一键启动脚本
```
## 目录关系说明
- 培训 Controller 与业务实现分处两个 Maven 模块:Controller 在 `ruoyi-admin`,Entity/Mapper/Service/XML 在 `ruoyi-train`;`ruoyi-admin` 通过 POM 依赖 `ruoyi-train`。
- `build_ui/src/router/index.js` 只定义登录、首页、个人中心等常量路由。培训页面是否出现在菜单中取决于后端 `/getRouters` 返回的 `sys_menu` 数据。
- 仓库的 `RuoYi-Vue/sql/` 只有若依系统表和 Quartz 脚本,没有培训业务表 DDL。
- `RuoYi-Vue/ruoyi-admin/D:/...` 是 Maven POM 中 Windows 输出路径在 macOS 上形成的字面目录,属于构建产物/依赖副本,不是业务模块。