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

2026-09-13 23:16:37 +08:00
1 parent 83797f9286
commit 9d053bf41f
@@ -0,0 +1,107 @@
+# 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 上形成的字面目录，属于构建产物/依赖副本，不是业务模块。