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

RuoYi-Vue/docs/kingbase_compatibility_audit.md

@@ -0,0 +1,128 @@
+# RuoYi-Vue KingbaseES (人大金仓) 适配审计报告
+
+> **审计说明**：本轮审计仅对代码与配置文件进行静态分析与兼容性评估，未修改任何工程代码文件，未执行任何 DDL/DML 操作，所有凭据敏感信息已脱敏。
+
+---
+
+## A. 已确认适配
+
+1. **JDBC 驱动类已切换**
+   - 在 `ruoyi-admin/src/main/resources/application-druid.yml` 中，主库驱动已正确指定为人大金仓驱动：
+     ```yaml
+     driverClassName: com.kingbase8.Driver
+     ```
+
+2. **JDBC 连接串协议与 Schema 参数已配置**
+   - 连接串已适配为 `jdbc:kingbase8` 协议，并显式指定了 `currentSchema=public`：
+     ```yaml
+     url: jdbc:kingbase8://192.168.139.218:4321/training?currentSchema=public&useUnicode=true&characterEncoding=utf8
+     ```
+   - 经网络探测，Mac 宿主机到目标数据库 `192.168.139.218:4321` 的网络端口畅通可达。
+
+3. **依赖声明已添加**
+   - 根模块 `pom.xml` 的 `<dependencyManagement>` 与 `ruoyi-admin/pom.xml` 中已添加 Kingbase 驱动坐标：
+     ```xml
+     <groupId>com.kingbase</groupId>
+     <artifactId>kingbase8</artifactId>
+     <version>8.6.0</version>
+     ```
+
+4. **业务模块 SQL 规范度较好**
+   - 核心业务模块 `ruoyi-train` 下的 14 个业务表 Mapper（如 `TrainStudentMapper.xml` 等）均为标准单表 CRUD 语句，未使用复杂的 MySQL 专有方言函数。
+
+---
+
+## B. 明确存在的问题
+
+### 1. 本地仓库缺失 Kingbase JDBC Jar 包
+- 本地 `~/.m2/repository/com/kingbase/kingbase8/8.6.0/` 目录不存在。
+- 人大金仓官方商业驱动未公开发布至 Maven 中央仓库或阿里云公共镜像，导致命令行执行 Maven 命令时依赖无法解析，构建失败。
+
+### 2. PageHelper 分页插件方言被硬编码为 MySQL
+- 在 `ruoyi-admin/src/main/resources/application.yml` 中明确配置了：
+  ```yaml
+  pagehelper:
+    helperDialect: mysql
+  ```
+- 强制指定 `mysql` 方言会导致 PageHelper 加载 `MySqlDialect`，而非 Kingbase/PostgreSQL 专属分页与 Count 优化器，埋下深层分页与嵌套查询隐患。
+
+### 3. Mapper XML 中存在反引号（`）转义
+- PostgreSQL/Kingbase 识别双引号 `"` 作为标识符定界符，**反引号属于非法语法**。
+- `ruoyi-system/src/main/resources/mapper/system/SysMenuMapper.xml` 中共有 6 处使用了反引号字段 `` `query` ``（如第 32、53、59、78、149、173 行），执行对应菜单查询/更新 SQL 时将直接抛出语法错误。
+
+### 4. Mapper XML 中包含 MySQL 专属函数
+- **`date_format(...)`（共 14 处）**：
+  - 涉及：`SysUserMapper.xml`、`SysJobLogMapper.xml`、`SysOperLogMapper.xml`、`SysLogininforMapper.xml`、`GenTableMapper.xml`。
+  - 典型语法：`AND date_format(create_time,'%Y%m%d') >= date_format(#{params.beginTime},'%Y%m%d')`。
+  - Kingbase 中无原生 `date_format`，标准函数为 `TO_CHAR(...)`。带时间范围检索的列表查询将直接报错。
+- **`find_in_set(...)`（共 3 处）**：
+  - 涉及：`SysUserMapper.xml`（部门权限关联）与 `SysDeptMapper.xml`（部门树父子过滤）。
+  - Kingbase/PG 无原生 `find_in_set` 函数，涉及组织架构层级查询时将抛出异常。
+- **`ifnull(...)`（共 4 处）**：
+  - 涉及：`SysMenuMapper.xml` 中的 `ifnull(perms, '')`。
+  - PG 标准函数为 `COALESCE`。若 Kingbase 处于非兼容模式，会提示函数不存在。
+
+### 5. 若依代码生成器（ruoyi-generator）完全无法使用
+- **表元数据查询失败** (`GenTableMapper.xml`)：
+  - 查询语句：`from information_schema.tables where table_schema = (select current_database())`。
+  - Kingbase 的 `current_database()` 返回数据库名（如 `training`），与 schema 名（如 `public`）不一致，无法检索出任何表。
+  - 查询列中的 `table_comment`、`create_time`、`update_time` 在 Kingbase 的 `information_schema.tables` 视图中并不存在，直接报列不存在异常。
+- **字段元数据查询失败** (`GenTableColumnMapper.xml`)：
+  - 包含非标准操作符 `&&`（PG 中必须用 `AND`）。
+  - 使用了 MySQL 专有的 `column_key`、`extra`、`column_comment`、`column_type` 字段，在 Kingbase 中不可用。
+- **代码生成模板中的 MySQL 专有语法** (`vm/sql/sql.vm`)：
+  - 包含了 `SELECT @parentId := LAST_INSERT_ID();` 及 `@parentId` 变量，Kingbase 无法解析执行。
+
+### 6. 初始化 SQL 脚本完全未做 Kingbase 迁移
+- `sql/ry_20250522.sql` 和 `sql/quartz.sql` 均为纯 MySQL 语法。
+- 包含 `engine=innodb`、`auto_increment`、`bigint(20)`、`datetime`、`sysdate()`、`blob` 等 MySQL 专有 DDL 与函数，且未创建任何序列（Sequence），在 Kingbase 中无法直接执行初始化。
+
+---
+
+## C. 潜在风险
+
+1. **Druid 连接保活查询配置风险**
+   - `application-druid.yml` 中配置了 `validationQuery: SELECT 1 FROM DUAL`。
+   - Kingbase 在默认或 PG 模式下并无 `DUAL` 虚拟表（仅 Oracle 兼容模式或手工建视图才有），通用保活语句应为 `SELECT 1`。
+2. **Druid WallFilter（SQL 防火墙）误拦截**
+   - `application-druid.yml` 启用了 `filter.wall`，但未配置 Kingbase/PostgreSQL 专属的 WallFilter 白名单规则。Druid 内置 SQL 解析器在解析国产库特有语法时极易抛出 `SQLSyntaxErrorException: druid wall filter sql error`。
+3. **pom.xml 构建插件硬编码 Windows 路径**
+   - `pom.xml` 和 `ruoyi-admin/pom.xml` 中的 `maven-dependency-plugin` 包含了写死的路径：
+     `<outputDirectory>D:\maven_repository\com\kingbase\kingbase8\8.6.0</outputDirectory>`。
+   - 在 macOS 或 Linux 打包部署时将导致构建阶段报错或路径异常。
+4. **MySQL JDBC 驱动残留**
+   - `ruoyi-admin/pom.xml` 中仍声明有 `mysql-connector-java`，易引起类加载冗余或驱动加载冲突。
+5. **Schema 硬编码不一致**
+   - `SysUserMapper.xml` 与 `SysConfigMapper.xml` 中部分 SQL 被硬编码加入了 `public.` 前缀，而其余所有 Mapper 均未带前缀。一旦未来生产环境数据库 schema 迁移或变更，将导致部分 SQL 跨 schema 访问失效。
+6. **标识符大小写与 LIKE 模糊匹配规则差异**
+   - MySQL 对表名、列名以及 `LIKE` 匹配默认不区分大小写，而 Kingbase/PG 默认区分大小写（`LIKE` 严格匹配大小写，需用 `ILIKE` 或 `lower()` 处理）。若数据库中存在大小写敏感数据，前端模糊搜索可能出现遗漏。
+
+---
+
+## D. 后续建议
+
+1. **建立本地/私服 Kingbase 依赖规范**
+   - 通过 `mvn install:install-file` 将 `kingbase8-8.6.0.jar` 安装至本地仓库，或上传至团队私有 Nexus 镜像库。
+   - 清理 `pom.xml` 中残留的 `mysql-connector-java` 与硬编码的 `D:\` 路径插件。
+2. **修正数据源与连接池配置**
+   - 将 `validationQuery` 修改为标准跨库通用的 `SELECT 1`。
+   - 将 PageHelper 的 `helperDialect` 修正为自动识别或 `kingbase` / `postgresql`。
+   - 如果遇到 Druid 报防火墙拦截错误，调整 WallFilter 配置或针对 Kingbase 禁用 WallFilter。
+3. **统一定义或兼容 SQL 函数**
+   - 方式一（推荐）：修改 Mapper XML，将 `date_format` 替换为 `to_char`，反引号替换为双引号，`find_in_set` 替换为数组/字符串函数或子查询。
+   - 方式二：在 Kingbase 数据库的 public schema 下自定义创建 `date_format`、`find_in_set`、`ifnull` 兼容函数，降低改动范围。
+4. **改造代码生成器元数据查询**
+   - 重构 `GenTableMapper.xml` 与 `GenTableColumnMapper.xml`，使用 `information_schema.tables` 配合 PostgreSQL 系统目录 `pg_class`、`pg_description`、`pg_attribute` 读取表及字段元数据。
+
+---
+
+## E. 开始业务开发前必须解决的问题（阻断级 Checklist）
+
+| 序号 | 优先级 | 类别 | 阻断问题与解决要点 |
+| :--- | :--- | :--- | :--- |
+| **1** | 🔴 P0 | 依赖构建 | **安装 Kingbase JDBC Jar**：在开发机执行 `mvn install:install-file` 导入 `kingbase8-8.6.0.jar`，确保编译构建通过。 |
+| **2** | 🔴 P0 | 配置项 | **纠正 PageHelper 方言**：移除 `application.yml` 中的 `helperDialect: mysql`，避免分页 SQL 生成异常。 |
+| **3** | 🔴 P0 | SQL 语法 | **消除 Mapper XML 中的反引号**：修改 `SysMenuMapper.xml` 中的 `` `query` ``，避免系统菜单相关接口直接崩溃。 |
+| **4** | 🔴 P0 | SQL 函数 | **解决 `find_in_set` 与 `date_format`**：在数据库端创建兼容函数，或在 `SysUserMapper.xml`、`SysDeptMapper.xml` 等核心 XML 中重写对应 SQL，否则用户管理、部门管理、时间检索必定报错。 |
+| **5** | 🔴 P0 | 初始化数据 | **准备 Kingbase 版基础 DDL 脚本**：当前项目中的 `sql/ry_*.sql` 无法在 Kingbase 跑通，需提供适配 Kingbase 语法的主键序列及数据初始化脚本。 |
+| **6** | 🟡 P1 | 代码生成 | **修复代码生成器元数据 SQL**：若业务开发需要使用若依代码生成器，必须先重写 `ruoyi-generator` 的元数据查询 SQL。 |

RuoYi-Vue/docs/kingbase_fact_check.md

@@ -0,0 +1,168 @@
+# RuoYi-Vue KingbaseES (人大金仓) 事实核验报告
+
+> **核验原则**：本轮核验基于 POM 静态解析、本地环境探测与语法特征比对，未修改任何工程文件与配置，未执行任何 DDL/DML，未输出任何密码凭据。
+
+---
+
+## 一、PageHelper 版本与配置核验
+
+### 1. 精确版本
+- **`pagehelper-spring-boot-starter`**: **`1.4.7`**
+- 其默认传递依赖的 core **`pagehelper`**: **`5.3.3`**
+
+### 2. 继承与依赖链路
+- **属性定义**：父工程 [pom.xml](file:///Users/wzb/Desktop/%E9%A1%B9%E7%9B%AE/RailwaySystem/RuoYi-Vue/pom.xml#L27) 中定义：
+  ```xml
+  <pagehelper.boot.version>1.4.7</pagehelper.boot.version>
+  ```
+- **依赖管控**：父工程 [pom.xml](file:///Users/wzb/Desktop/%E9%A1%B9%E7%9B%AE/RailwaySystem/RuoYi-Vue/pom.xml#L119-L123) 的 `<dependencyManagement>` 声明：
+  ```xml
+  <dependency>
+      <groupId>com.github.pagehelper</groupId>
+      <artifactId>pagehelper-spring-boot-starter</artifactId>
+      <version>${pagehelper.boot.version}</version>
+  </dependency>
+  ```
+- **模块引入**：子模块 [ruoyi-common/pom.xml](file:///Users/wzb/Desktop/%E9%A1%B9%E7%9B%AE/RailwaySystem/RuoYi-Vue/ruoyi-common/pom.xml#L39-L42) 显式引入（省略版本，继承自父 POM）：
+  ```xml
+  <dependency>
+      <groupId>com.github.pagehelper</groupId>
+      <artifactId>pagehelper-spring-boot-starter</artifactId>
+  </dependency>
+  ```
+- `ruoyi-framework` 和 `ruoyi-admin` 通过依赖 `ruoyi-common` 间接获得该 starter。
+
+### 3. application.yml 当前完整 PageHelper 配置
+在 [ruoyi-admin/src/main/resources/application.yml](file:///Users/wzb/Desktop/%E9%A1%B9%E7%9B%AE/RailwaySystem/RuoYi-Vue/ruoyi-admin/src/main/resources/application.yml#L109-L114) 中：
+```yaml
+# PageHelper分页插件
+pagehelper:
+  helperDialect: mysql
+  supportMethodsArguments: true
+  params: count=countSql
+```
+
+---
+
+## 二、Kingbase Maven 依赖设计与仓库核验
+
+### 1. 所有 POM 中的 Kingbase 坐标
+- 父工程 [pom.xml](file:///Users/wzb/Desktop/%E9%A1%B9%E7%9B%AE/RailwaySystem/RuoYi-Vue/pom.xml#L191-L195)（`<dependencyManagement>`）：
+  ```xml
+  <dependency>
+      <groupId>com.kingbase</groupId>
+      <artifactId>kingbase8</artifactId>
+      <version>8.6.0</version>
+  </dependency>
+  ```
+- 子模块 [ruoyi-admin/pom.xml](file:///Users/wzb/Desktop/%E9%A1%B9%E7%9B%AE/RailwaySystem/RuoYi-Vue/ruoyi-admin/pom.xml#L40-L44)：
+  ```xml
+  <dependency>
+      <groupId>com.kingbase</groupId>
+      <artifactId>kingbase8</artifactId>
+      <version>8.6.0</version>
+  </dependency>
+  ```
+
+### 2. 仓库配置（Repositories & PluginRepositories）
+全项目所有 POM 中仅在根 [pom.xml](file:///Users/wzb/Desktop/%E9%A1%B9%E7%9B%AE/RailwaySystem/RuoYi-Vue/pom.xml#L331-L354) 配置了阿里云公共镜像：
+- `<repository>`: `https://maven.aliyun.com/repository/public` (ID: `public`)
+- `<pluginRepository>`: `https://maven.aliyun.com/repository/public` (ID: `public`)
+
+### 3. ~/.m2/settings.xml 与私有仓库
+- `~/.m2/settings.xml` 文件：**不存在**。
+- 项目中 **未配置任何 Nexus、Artifactory 或企业私有 Maven 仓库**。
+
+### 4. maven-dependency-plugin 完整 Execution 节点
+在父工程 [pom.xml](file:///Users/wzb/Desktop/%E9%A1%B9%E7%9B%AE/RailwaySystem/RuoYi-Vue/pom.xml#L280-L304) 与 [ruoyi-admin/pom.xml](file:///Users/wzb/Desktop/%E9%A1%B9%E7%9B%AE/RailwaySystem/RuoYi-Vue/ruoyi-admin/pom.xml#L104-L129) 中均存在如下完整配置：
+```xml
+<plugin>
+    <groupId>org.apache.maven.plugins</groupId>
+    <artifactId>maven-dependency-plugin</artifactId>
+    <executions>
+        <execution>
+            <id>copy-dependencies</id>
+            <phase>package</phase>
+            <goals>
+                <goal>copy-dependencies</goal>
+            </goals>
+            <configuration>
+                <!-- 输出目录 -->
+                <outputDirectory>D:\maven_repository\com\kingbase\kingbase8\8.6.0</outputDirectory>
+                <!-- 包含运行时依赖 -->
+                <includeScope>runtime</includeScope>
+                <!-- 包含编译时依赖 -->
+                <includeScope>compile</includeScope>
+                <!-- 可选：包含指定的 groupId -->
+                <includeGroupIds>com.kingbase</includeGroupIds>
+                <!-- 可选：包含指定的 artifactId -->
+                <includeArtifactIds>kingbase8</includeArtifactIds>
+            </configuration>
+        </execution>
+    </executions>
+</plugin>
+```
+
+### 5. 为何使用 `com.kingbase:kingbase8:8.6.0`
+- **交付与部署习惯**：人大金仓商业安装包自带的驱动文件通常命名为 `kingbase8-8.6.0.jar`。在国企信创标准交付中，官方推荐通过命令行将其安装至本地 Maven 仓库：
+  `mvn install:install-file -Dfile=kingbase8-8.6.0.jar -DgroupId=com.kingbase -DartifactId=kingbase8 -Dversion=8.6.0 -Dpackaging=jar`
+- **开发者环境痕迹**：原工程作者在 Windows 环境（`D:\maven_repository`）下开发，采用离线介质手动安装，未通过企业 Nexus 私服托管。因此代码中固定约定了该标准坐标。
+
+---
+
+## 三、数据库客户端工具与模式查询获取条件
+
+### 1. 本机客户端工具排查
+- **`ksql`**：未安装（`which ksql` 返回 not found）。
+- **`psql`**：未安装（`which psql` 返回 not found）。
+- **`DataGrip CLI`**：未安装（系统无相关命令行软链接）。
+- **其他连接工具**：Python 未安装 `psycopg2` / `asyncpg`，且无任何直接可用的数据库 CLI 工具。
+
+### 2. 是否能直接执行 `SHOW database_mode;`
+- **结论：目前无法直接执行**。
+- **原因**：本机缺少连接 KingbaseES 所需的交互式 CLI 客户端工具；在未配置工具且不修改环境的前提下，无法向远程数据库发送查询指令。
+
+---
+
+## 四、审计项重新分类（基于数据库兼容模式视角）
+
+> KingbaseES V8R6 具备 **Oracle**、**PostgreSQL (PG)**、**MySQL** 三种兼容器模式。不同模式下的内置函数、引号解析规则存在显著差异。
+
+### 1. CONFIRMED（不依赖 database_mode 也确定存在的问题）
+- **本地缺失 Kingbase 驱动 Jar**：本地 Maven 仓库确实不存在对应 jar 包，公网仓库无此包，阻断 Maven 编译构建。
+- **构建插件硬编码 Windows 绝对路径**：`D:\maven_repository\...` 写死在 `pom.xml` 中，在 macOS/Linux 打包时必然引发异常。
+- **代码生成器表名过滤逻辑缺陷 (`GenTableMapper.xml`)**：
+  `where table_schema = (select current_database())`。在 Kingbase 所有模式下，`current_database()` 返回的均为数据库名（如 `training`），而 `information_schema.tables.table_schema` 记录的是 schema 名（如 `public`），必然导致查不到任何表。
+- **代码生成器字段元数据语法与视图缺陷 (`GenTableColumnMapper.xml`)**：
+  使用了非标逻辑符 `&&`；且 `column_key`、`extra`、`column_comment` 在 Kingbase 的 `information_schema.columns` 中不作为标准列存在。
+
+### 2. MODE_DEPENDENT（是否有问题取决于 database_mode）
+- **反引号（`）**（`SysMenuMapper.xml` 中的 `` `query` ``）：
+  - 若为 **MySQL 模式**：原生支持反引号，**无问题**。
+  - 若为 **PG / Oracle 模式**：反引号为非法字符，**直接报错**（必须双引号 `"`）。
+- **`date_format`**（14 处）：
+  - 若为 **MySQL 模式**：支持 MySQL 日期格式化函数，**无问题**。
+  - 若为 **PG / Oracle 模式**：无原生 `date_format` 函数，**直接报错**（除非库内自建了兼容函数）。
+- **`find_in_set`**（3 处）：
+  - 若为 **MySQL 模式**：内置支持，**无问题**。
+  - 若为 **PG / Oracle 模式**：无原生函数，**直接报错**。
+- **`ifnull`**（4 处）：
+  - 若为 **MySQL 模式**：内置支持，**无问题**。
+  - 若为 **Oracle 模式**（主推 `nvl`）或 **PG 模式**（主推 `coalesce`）：可能报错。
+- **`helperDialect=mysql`**：
+  - 若为 **MySQL 模式**：MySQL 分页语法与机制高度吻合，**影响较小**。
+  - 若为 **Oracle 模式**：MySQL 分页语法（`LIMIT ? OFFSET ?`）与 Oracle 模式不兼容，**必定报错**。
+- **`SELECT 1 FROM DUAL`**：
+  - 若为 **Oracle / MySQL 模式**：支持 `DUAL` 虚表，**完全合法可用**。
+  - 若为 **纯 PG 模式**：若未建 DUAL 视图则报错。
+
+### 3. RUNTIME_TEST_REQUIRED（必须连库执行只读 SQL 才能确定）
+- **实际 `database_mode` 的值**：需连库执行 `SHOW database_mode;` 才能确认到底处于何种模式。
+- **远端 training 库的表是否已建好**：如果库中已有全量业务与系统表，则项目自带的初始化 SQL 无需再次执行；若为空库，则必须确认 DDL。
+- **库中是否已预装兼容函数**：某些企业现场会在 public 下预建 `date_format`、`find_in_set` 标量函数。
+
+### 4. LOW_PRIORITY（不阻塞目前业务开发的问题）
+- **`GROUP_CONCAT`**：全局 Mapper XML 扫描结果为 **0 处**，实际未被使用，不构成障碍。
+- **MySQL JDBC 驱动残留**：`mysql-connector-java` 虽声明但未被主数据源激活，仅有依赖冗余，不阻塞开发。
+- **`public.` schema 前缀零星硬编码**：当前 JDBC URL 已配置 `currentSchema=public`，写与不写均能正确定位到 public 下的表，不影响当前运行。
+- **初始化脚本为 MySQL 语法 (`sql/ry_*.sql`, `sql/quartz.sql`)**：仅影响从零全新建库，若远程开发数据库已就绪，则不影响本地业务开发。

doc/RailwaySystem 一期 P0 需求确认表 V0.1.md

@@ -0,0 +1,976 @@
+# RailwaySystem 一期 P0 需求确认表 V0.1
+
+> **用途：** 内部评审 / 与老师或甲方进行需求确认
+> **适用阶段：** 需求分析完成后、PRD 和数据库正式设计前
+> **确认原则：**
+>
+> * 当前已有明确要求的，不重复推翻；
+> * 原需求没有明确的，不由开发人员自行决定；
+> * 每个问题先给出当前情况，再给出推荐方案；
+> * “推荐方案”属于项目组设计建议，不代表甲方已经确认；
+> * P0 问题确认完成后，再冻结业务基线 V1.0。
+
+---
+
+# 一、P0 问题总览
+
+| 编号    | 核心问题                | 是否影响数据库结构 | 优先级    |
+| ----- | ------------------- | --------: | ------ |
+| P0-01 | 一个开班计划是一门课程还是多门课程？  |        极高 | 必须首先确认 |
+| P0-02 | 学员如何进入一个培训班？        |        极高 | 必须确认   |
+| P0-03 | 课程表如何形成，是否存在“课次”？   |        极高 | 必须确认   |
+| P0-04 | 宿舍什么时候、通过什么方式分配？    |         高 | 必须确认   |
+| P0-05 | 开班后 X 日未报到中的 X 是多少？ |         中 | 必须确认规则 |
+| P0-06 | 综合成绩如何计算？           |         高 | 必须确认   |
+| P0-07 | 什么条件算“完成培训 / 结业”？   |         高 | 必须确认   |
+
+建议确认顺序：
+
+```mermaid
+flowchart LR
+    A[P0-01 开班与课程关系]
+    --> B[P0-02 参训名单形成]
+    --> C[P0-03 课程表与课次]
+    --> D[P0-04 宿舍分配]
+    --> E[P0-05 报到时限]
+    --> F[P0-06 成绩规则]
+    --> G[P0-07 结业规则]
+```
+
+其中前三项会直接决定后续核心数据模型。
+
+---
+
+# 二、P0-01 一个开班计划究竟是一门课程还是多门课程？
+
+## 1. 当前需求情况
+
+现有需求表述为：
+
+> 创建开班计划时设置“所属课程”。
+
+当前数据表中，一个 `train_class_plan` 也只保存一个 `c_id`。
+
+因此现有材料实际上更接近：
+
+```mermaid
+flowchart LR
+    A[课程：钢结构检测]
+    --> B[钢结构检测第一期]
+
+    A --> C[钢结构检测第二期]
+```
+
+也就是：
+
+> **一个开班计划对应一门课程。**
+
+---
+
+## 2. 但现实业务可能存在另一种模式
+
+例如一次铁路综合培训：
+
+```mermaid
+flowchart TD
+    A[铁路综合培训第一期]
+
+    A --> B[安全理论]
+    A --> C[钢结构检测]
+    A --> D[VR巡检]
+    A --> E[实操考核]
+```
+
+这种情况下：
+
+> 一个培训班包含多门课程。
+
+---
+
+## 3. 两种方案差异
+
+| 对比项     | 方案A：一班一课   | 方案B：一班多课    |
+| ------- | ---------- | ----------- |
+| 业务简单度   | 简单         | 更符合综合培训     |
+| 当前文档匹配度 | 高          | 当前文档未明确     |
+| 数据库复杂度  | 低          | 高           |
+| 课表设计    | 相对简单       | 必须设计班级-课程关系 |
+| 成绩      | 一期对应一门课程成绩 | 一期会有多门课程成绩  |
+| 签到      | 围绕该课程      | 需要区分不同课程    |
+| 后续扩展性   | 一般         | 更强          |
+
+---
+
+## 4. 项目组推荐
+
+### 推荐优先确认真实业务，再决定
+
+如果培训基地现实中通常是：
+
+> “开一个培训班，里面安排若干课程。”
+
+则建议采用：
+
+> **一个培训班包含多门课程。**
+
+如果真实业务实际上就是：
+
+> “某一门课程开一期培训。”
+
+则保持当前：
+
+> **一班一课。**
+
+### 当前建议倾向
+
+从“报到后查看课程表”“不同教师、不同场地、实训”等需求来看，**多课程培训班在业务上更自然**。
+
+但这一点不能直接由开发组拍板。
+
+---
+
+## 5. 需要老师 / 甲方确认
+
+请明确：
+
+> **一个开班计划是否允许配置多门课程？**
+
+确认项：
+
+* [ ] 只能关联一门课程
+* [ ] 可以关联多门课程
+* [ ] 当前一期先一门课程，后续再支持多门课程
+
+### 最终确认结果
+
+> 待填写：
+
+---
+
+# 三、P0-02 学员如何进入一个培训班？
+
+## 1. 当前需求情况
+
+现有需求中已经出现：
+
+```text
+招生人数
+报名条件
+报名人数
+开班报到
+```
+
+但没有明确：
+
+> 一个学员是通过什么业务动作成为“本期参训人员”的。
+
+---
+
+## 2. 可能存在的方式
+
+```mermaid
+flowchart TD
+    A[学员进入某一期培训]
+
+    A --> B[管理员手动添加]
+    A --> C[Excel批量导入]
+    A --> D[学员自行报名]
+    A --> E[报名后管理员审核]
+    A --> F[外部系统下发名单]
+```
+
+---
+
+## 3. 为什么这是核心问题
+
+如果不解决这一点，系统只能知道：
+
+> 张三这个人存在。
+
+却无法明确知道：
+
+> 张三是否属于钢结构检测第一期。
+
+而后续：
+
+```mermaid
+flowchart LR
+    A[参训资格]
+    --> B[报到]
+    --> C[住宿]
+    --> D[签到]
+    --> E[成绩]
+```
+
+全部依赖这层关系。
+
+---
+
+## 4. 项目组推荐
+
+一期建议至少支持：
+
+> **管理员手动加入 + Excel 批量导入。**
+
+理由：
+
+* 实现简单；
+* 适合培训基地集中组织人员；
+* 不需要先开发复杂报名门户；
+* 后续可以扩展学员自主报名或外部系统同步。
+
+推荐一期流程：
+
+```mermaid
+flowchart LR
+    A[学员库]
+    --> B[管理员选择 / Excel导入]
+    --> C[形成参训名单]
+    --> D[等待报到]
+```
+
+---
+
+## 5. 需要老师 / 甲方确认
+
+请确认参训名单来源：
+
+* [ ] 管理员手动添加
+* [ ] Excel 批量导入
+* [ ] 学员自行报名
+* [ ] 学员报名 + 管理员审核
+* [ ] 外部系统同步
+* [ ] 多种方式同时支持
+
+另外确认：
+
+> 是否存在“报名审核”这个业务步骤？
+
+* [ ] 有
+* [ ] 无
+
+### 最终确认结果
+
+> 待填写：
+
+---
+
+# 四、P0-03 课程表到底如何形成？
+
+## 1. 当前需求情况
+
+需求明确要求：
+
+> 学员报到后能够查看课程表。
+
+当前签到表中也存在：
+
+```text
+本节课程开始时间
+本节课程结束时间
+```
+
+说明业务实际上已经存在：
+
+> 某个具体时间真正发生的一次教学活动。
+
+---
+
+## 2. 建议定义“课次”
+
+例如：
+
+```text
+9月20日 09:00-11:00
+钢结构检测理论
+王老师
+201教室
+```
+
+这一条就可以称为：
+
+> 一次课次 / Lesson。
+
+---
+
+## 3. 推荐业务关系
+
+```mermaid
+flowchart TD
+    A[开班计划]
+    --> B[课次1]
+    A --> C[课次2]
+    A --> D[课次3]
+
+    B --> B1[课程]
+    B --> B2[教师]
+    B --> B3[时间]
+    B --> B4[教室 / 场地]
+```
+
+签到也因此变成：
+
+```mermaid
+flowchart LR
+    A[学员]
+    --> B[某次课次]
+    --> C[签到记录]
+```
+
+而不是只记录：
+
+> 张三签到过“钢结构检测”。
+
+---
+
+## 4. 项目组推荐
+
+建议正式引入：
+
+> **课次 / 教学安排 Lesson**
+
+每条课次至少包含：
+
+```text
+所属培训班
+所属课程
+授课教师
+开始时间
+结束时间
+教室 / 实训场地
+```
+
+这样：
+
+* 课程表可以生成；
+* 签到有准确对象；
+* 教师冲突可以判断；
+* 教室冲突可以判断；
+* 后续课程统计也更加清晰。
+
+---
+
+## 5. 需要老师 / 甲方确认
+
+请确认：
+
+### 一个培训班是否会多次上课？
+
+* [ ] 是
+* [ ] 否
+
+### 每次教学是否需要独立配置：
+
+* [ ] 日期
+* [ ] 开始时间
+* [ ] 结束时间
+* [ ] 课程
+* [ ] 教师
+* [ ] 教室
+* [ ] 实训场地
+
+### 是否同意以“课次”作为课程表基本单位？
+
+* [ ] 同意
+* [ ] 不同意
+* [ ] 需要其他形式
+
+### 最终确认结果
+
+> 待填写：
+
+---
+
+# 五、P0-04 宿舍什么时候分配？
+
+## 1. 当前需求情况
+
+需求确定：
+
+> 报到后可以获取所分配宿舍。
+
+但是没有明确宿舍到底什么时候被分好。
+
+---
+
+## 2. 可能的三种流程
+
+### 方案A：报到前预分配
+
+```mermaid
+flowchart LR
+    A[确定参训名单]
+    --> B[提前分配宿舍]
+    --> C[学员到场]
+    --> D[报到]
+    --> E[直接展示宿舍]
+```
+
+### 方案B：报到时自动分配
+
+```mermaid
+flowchart LR
+    A[学员报到]
+    --> B[系统检查可用床位]
+    --> C[自动匹配]
+    --> D[分配成功]
+    --> E[下发门禁]
+```
+
+### 方案C：管理员现场分配
+
+```mermaid
+flowchart LR
+    A[学员报到]
+    --> B[管理员选择宿舍]
+    --> C[确认入住]
+    --> D[下发门禁]
+```
+
+---
+
+## 3. 项目组推荐
+
+一期建议采用：
+
+> **报到前可预分配 + 管理员可调整。**
+
+系统可以根据：
+
+```text
+性别
+培训班
+剩余床位
+```
+
+提供自动推荐。
+
+但是一期不一定必须做到完全无人值守自动分床。
+
+推荐流程：
+
+```mermaid
+flowchart LR
+    A[参训名单]
+    --> B[系统推荐宿舍]
+    --> C[管理员确认 / 调整]
+    --> D[形成住宿安排]
+    --> E[报到展示]
+    --> F[下发门禁]
+```
+
+这样风险最低。
+
+---
+
+## 4. 另外必须确认
+
+> 是否所有培训学员都需要住宿？
+
+可能存在：
+
+```text
+住宿学员
+不住宿学员
+```
+
+因此住宿不能默认是所有人强制产生。
+
+---
+
+## 5. 需要老师 / 甲方确认
+
+宿舍分配方式：
+
+* [ ] 报到前预分配
+* [ ] 报到时自动分配
+* [ ] 报到时管理员分配
+* [ ] 支持预分配，同时允许现场调整
+
+是否所有人必须住宿：
+
+* [ ] 是
+* [ ] 否
+
+如果不住宿：
+
+> 是否仍然允许正常报到和参加培训？
+
+* [ ] 是
+* [ ] 否
+
+### 最终确认结果
+
+> 待填写：
+
+---
+
+# 六、P0-05 开班后 X 日未报到中的 X 是多少？
+
+## 1. 当前需求情况
+
+当前功能分析明确提出：
+
+```text
+开班后 X 日内未报到
+→ 自动取消资格
+→ 释放宿舍资源
+```
+
+但 X 没有确定。
+
+---
+
+## 2. 需要注意的问题
+
+这其实不只是一个数字。
+
+还需要确定：
+
+```mermaid
+flowchart TD
+    A[超过报到期限]
+
+    A --> B{是否请假?}
+
+    B -->|否| C[取消参训资格]
+    C --> D[释放宿舍]
+
+    B -->|是| E[是否允许延期报到?]
+```
+
+---
+
+## 3. 项目组推荐
+
+不建议把“X天”直接写死在程序中。
+
+建议做成：
+
+> **开班计划可配置的报到截止时间 / 报到有效期。**
+
+例如：
+
+```text
+开班时间：
+9月20日 09:00
+
+报到截止：
+9月21日 18:00
+```
+
+比固定：
+
+> 开班后 1 天
+
+更灵活。
+
+---
+
+## 4. 需要老师 / 甲方确认
+
+规则采用：
+
+* [ ] 固定 X 天
+* [ ] 每个开班计划独立设置报到截止时间
+
+如果固定：
+
+> X = ______ 天
+
+另外确认：
+
+### 请假学员超过期限是否取消资格？
+
+* [ ] 是
+* [ ] 否
+* [ ] 管理员人工决定
+
+### 超期取消以后是否自动释放宿舍？
+
+* [ ] 是
+* [ ] 否
+
+### 最终确认结果
+
+> 待填写：
+
+---
+
+# 七、P0-06 综合成绩如何计算？
+
+## 1. 当前需求情况
+
+现有成绩包括：
+
+```text
+课程成绩
+实训成绩
+考核成绩
+```
+
+同时需求要求：
+
+> 支持按权重自动计算综合成绩。
+
+但是没有说明权重。
+
+---
+
+## 2. 可能的计算方式
+
+例如：
+
+```mermaid
+flowchart TD
+    A[课程成绩 30%] --> D[综合成绩]
+    B[实训成绩 40%] --> D
+    C[考核成绩 30%] --> D
+```
+
+则：
+
+```text
+综合成绩
+=
+课程成绩 × 30%
++
+实训成绩 × 40%
++
+考核成绩 × 30%
+```
+
+---
+
+## 3. 关键问题
+
+不仅要确认比例，还要确认：
+
+> 所有课程是否使用同一套比例？
+
+例如：
+
+### 理论课程
+
+```text
+课程成绩 60%
+考试成绩 40%
+```
+
+### 实训课程
+
+```text
+理论 20%
+实训 60%
+考核 20%
+```
+
+显然可能不同。
+
+---
+
+## 4. 项目组推荐
+
+建议：
+
+> **权重可配置，不在代码中固定。**
+
+推荐层级：
+
+```mermaid
+flowchart LR
+    A[课程]
+    --> B[成绩规则]
+
+    B --> C[理论权重]
+    B --> D[实训权重]
+    B --> E[考核权重]
+```
+
+一期至少支持课程级配置。
+
+---
+
+## 5. 需要老师 / 甲方确认
+
+综合成绩：
+
+* [ ] 所有课程统一权重
+* [ ] 每门课程独立配置权重
+
+若统一：
+
+```text
+课程成绩：____ %
+实训成绩：____ %
+考核成绩：____ %
+```
+
+总计必须为：
+
+> 100%
+
+另外：
+
+### 缺少某一类成绩时怎么办？
+
+例如某课程没有实训。
+
+* [ ] 权重重新计算
+* [ ] 该项按 0 分
+* [ ] 每门课程自己配置成绩组成
+
+### 最终确认结果
+
+> 待填写：
+
+---
+
+# 八、P0-07 什么叫“培训完成 / 结业”？
+
+## 1. 当前需求情况
+
+当前需求已经出现：
+
+> 结业后宿舍门禁权限自动失效。
+
+但是没有定义：
+
+> 什么条件才叫结业。
+
+---
+
+## 2. 可能的规则
+
+```mermaid
+flowchart TD
+    A[培训结束]
+
+    A --> B{是否满足结业条件}
+
+    B -->|是| C[结业]
+    B -->|否| D[未结业 / 待处理]
+
+    C --> E[保存培训历史]
+    C --> F[失效宿舍门禁]
+    C --> G[形成最终统计]
+```
+
+结业条件可能涉及：
+
+```text
+签到率
+成绩
+学习时长
+必修课程完成情况
+管理员确认
+```
+
+---
+
+## 3. 几种典型方案
+
+### 方案A：时间结束即结业
+
+```text
+开班结束
+=
+所有学员自动结业
+```
+
+优点：
+
+> 简单。
+
+缺点：
+
+> 即使长期缺勤或者没成绩，也会结业。
+
+---
+
+### 方案B：满足条件自动结业
+
+例如：
+
+```text
+签到率 ≥ 80%
+综合成绩 ≥ 60
+```
+
+满足后系统自动结业。
+
+---
+
+### 方案C：系统判断 + 管理员确认
+
+系统给出：
+
+```text
+建议结业
+不满足条件
+```
+
+最后管理员确认。
+
+---
+
+## 4. 项目组推荐
+
+一期推荐：
+
+> **系统计算是否满足条件 + 管理员最终确认结业。**
+
+这样既可以自动化，又能处理特殊情况。
+
+推荐流程：
+
+```mermaid
+flowchart LR
+    A[培训结束]
+    --> B[系统统计]
+    --> C[判断结业条件]
+    --> D[管理员确认]
+    --> E[正式结业]
+    --> F[失效对应培训权限]
+```
+
+---
+
+## 5. 特别需要注意
+
+结业应该针对：
+
+> **某一次参训**
+
+而不是直接把：
+
+> 张三这个人的全局状态改成“结业”。
+
+因为张三未来还可能参加其他培训。
+
+---
+
+## 6. 需要老师 / 甲方确认
+
+结业方式：
+
+* [ ] 开班结束自动结业
+* [ ] 满足条件自动结业
+* [ ] 系统判断 + 管理员确认
+
+如果需要条件，请确认：
+
+### 签到率要求
+
+> ≥ ______ %
+
+### 综合成绩要求
+
+> ≥ ______ 分
+
+### 学习时长是否有要求
+
+* [ ] 有：________
+* [ ] 无
+
+### 是否允许管理员特殊处理
+
+* [ ] 是
+* [ ] 否
+
+### 最终确认结果
+
+> 待填写：
+
+---
+
+# 九、推荐的一期默认方案
+
+如果当前必须先做一版原型，而甲方暂时无法全部确认，项目组可以暂时按下面方案设计。
+
+> **注意：以下全部属于项目组推荐默认值，不代表已确认需求。**
+
+| 问题     | 推荐默认方案                      |
+| ------ | --------------------------- |
+| 开班与课程  | 暂按一个开班对应一门课程，确认后再决定是否升级一班多课 |
+| 学员进入培训 | 管理员添加 + Excel批量导入           |
+| 课程表    | 引入独立课次 Lesson               |
+| 宿舍分配   | 提前预分配 + 管理员可调整              |
+| 报到截止   | 每期开班单独配置截止时间                |
+| 综合成绩   | 课程级可配置权重                    |
+| 结业     | 系统判断 + 管理员最终确认              |
+
+---
+
+# 十、7 个 P0 问题之间的关系
+
+这七个问题不是互相独立的。
+
+```mermaid
+flowchart TD
+    A[P0-01 开班与课程关系]
+    --> B[P0-03 课程表 / 课次]
+
+    A --> C[P0-02 参训名单]
+
+    C --> D[P0-04 宿舍分配]
+    C --> E[P0-05 报到时限]
+
+    B --> F[P0-06 成绩规则]
+
+    D --> G[P0-07 结业规则]
+    E --> G
+    F --> G
+```
+
+因此建议会议不要随机讨论。
+
+应该按：
+
+> **P0-01 → P0-02 → P0-03 → P0-04 → P0-05 → P0-06 → P0-07**
+
+依次确认。
+
+---
+
+# 十一、确认完成后的输出
+
+当 7 个 P0 问题确认完以后，需要把结果回填到：
+
+> 《RailwaySystem 一期需求分析与业务基线》
+
+并升级为：
+
+> **V1.0 业务基线**
+
+随后才能正式进入：
+
+```mermaid
+flowchart LR
+    A[P0确认完成]
+    --> B[业务基线V1.0]
+    --> C[PRD]
+    --> D[业务模型]
+    --> E[数据库V2]
+    --> F[API / 页面]
+    --> G[Epic / Issue]
+    --> H[开发]
+```
+
+---
+
+# 十二、会议最终确认记录
+
+| 编号    | 最终结论 | 确认人 | 日期 |
+| ----- | ---- | --- | -- |
+| P0-01 |      |     |    |
+| P0-02 |      |     |    |
+| P0-03 |      |     |    |
+| P0-04 |      |     |    |
+| P0-05 |      |     |    |
+| P0-06 |      |     |    |
+| P0-07 |      |     |    |
+
+当以上七项全部填写后：
+
+> **一期核心业务模型才可以视为基本冻结。**

doc/学员管理系统功能分析_20260831.md

@@ -0,0 +1,185 @@
+学员管理系统功能分析
+
+**一、人员管理**
+
+1、教师信息管理
+
+提供对教师信息的查看、编辑等功能。教师信息包括：个人基本情<span class="mark">况信息、授课信息等；</span>
+
+<span class="mark">（1）支持教师授课履历的时间轴展示（按学期/年份筛选）；</span>
+
+<span class="mark">（2）支持设置教师资质证书有效期预警（到期前系统自动提醒）；</span>
+
+<span class="mark">（3）支持逻辑删除（离职教师账号冻结但保留历史数据）；</span>
+
+<span class="mark">（4）操作日志记录所有编辑行为。</span>
+
+2、学员信息管理
+
+提供对学员信息的查看、编辑等功能。学员信息包括：个人基本情况信息<span class="mark">、人脸数据、课程信息、学习信息等。</span>
+
+<span class="mark">（1）人脸数据支持多底库照片采集（支持1:N识别精度提升）；</span>
+
+<span class="mark">（2）支持批量导入学员基础信息（Excel模板下载）；</span>
+
+<span class="mark">（3）学员状态支持在读/休学/结业/退学等状态流转，状态变更自动触发关联权限冻结（如宿舍门禁、电子班牌签到权限）；</span>
+
+<span class="mark">（4）敏感字段（身份证号）加密存储；</span>
+
+<span class="mark">（5）支持查看学员的全生命周期学习轨迹时间线。</span>
+
+**二、课程管理**
+
+1、课程信息管理
+
+提供对课程的创建、编辑、删除、查看功能。课程信息包括：课程编码（全局唯一业务编码）、课程名称、课程类型、课程时长、教学目标、课程内容、配套资料（如关联3D设备拆解模型、实训场景等文档、视频、链接形式的教学资源）等。
+
+<span class="mark">（1）支持课程版本管理；</span>
+
+<span class="mark">（2）课程状态支持草稿/待审核/已发布/已归档；</span>
+
+<span class="mark">（3）配套资料支持预览与格式校验（限制视频/文档大小及格式）；</span>
+
+<span class="mark">（4）支持设置课程标签（如#热门、#初级、#进阶）。</span>
+
+2、课程签到管理
+
+提供对课程签到信息的创建、编辑、删除、查看功能。
+
+**三、学习班管理**
+
+1、开班计划管理
+
+提供对开班计划的创建、编辑、删除、查看功能。开班计划信息包括：开班名称、所属课程、开班时间、结束时间、培训地点、授课教师、招生人数、报名条件等。
+
+<span class="mark">（1）开班计划状态（未开始/报名中/进行中/已结束/已取消）；报名人数实时计数器，并支持超额预警（达到招生人数90%时提醒教师）；</span>
+
+<span class="mark">（2）支持复制开班计划（快捷生成下期班次）；</span>
+
+<span class="mark">（3）开班时间与授课教师自动进行冲突校验（同一时段同一教师冲突告警）。</span>
+
+2、开班报到管理
+
+支持信息查询一体机通过身份证、人脸识别方式进行开班报到，报到后可自动获取所分配宿舍、教室、实训场地、课程表等信息。
+
+（系统同时将人脸识别的<span class="mark">人脸数据同步至学员信息管理模块，宿舍分配结果同步至宿舍管理模块，</span>用于触发人脸权限自动下发。）
+
+<span class="mark">（1）支持报到状态机（未报到/已报到/请假/放弃）；</span>
+
+<span class="mark">（2）设置报到时效规则（开班后X日内未报到自动取消资格并释放宿舍资源）；</span>
+
+<span class="mark">（3）人脸识别失败时采用人工核验通道（一体机转接至管理员后台确认）。</span>
+
+**四、宿舍管理**
+
+1、宿舍信息管理
+
+（1）提供对宿舍信息的查看、编辑等功能。
+
+<span class="mark">（2）宿舍信息可细化为：楼栋+楼层+房间号+床位号四级编码；</span>
+
+<span class="mark">（3）宿舍状态支持空置/部分入住/已满/维修中；</span>
+
+<span class="mark">（4）支持按性别/培训班维度进行宿舍分配的自动匹配规则配置（优先同班同寝）。</span>
+
+2、宿舍开门权限管理
+
+（1）提供对宿舍开门权限的查看、编辑等功能。
+
+<span class="mark">（2）系统根据宿舍分配结果设定对应宿舍开门权限，并自动下发人脸数据至智能锁；下发记录需包含下发时间、下发结果（成功/失败）及失败重试次数。</span>
+
+<span class="mark">（3）权限时效管理（权限与开班计划结束时间联动，结业后自动过期失效）。</span>
+
+<span class="mark">（4）支持临时授权（允许管理员下发短期开门密码）。</span>
+
+<span class="mark">（5）支持权限审计日志。</span>
+
+**五、成绩管理**
+
+1、成绩信息管理
+
+提供成绩信息的查看、编辑等功能。成绩信息包括：课程成绩、实训成绩、考核成绩等多类型成绩。
+
+<span class="mark">（1）成绩状态（草稿/已提交/已发布）；</span>
+
+<span class="mark">（2）成绩发布后自动锁定不可编辑（如需修改需走审批流程）；</span>
+
+<span class="mark">（3）支持按权重占比自动计算综合成绩；</span>
+
+<span class="mark">（4）记录每次成绩修改的历史版本（比对修改前后的差值）。</span>
+
+2、成绩信息导入与导出
+
+支持成绩的批量导入与导出（Excel格式）。<span class="mark">导入时支持模板校验（表头、字段格式、学号合法性自动验证，错误数据生成下载反馈报告）。</span>
+
+**六、数据接入**
+
+实现各数据源明细数据的采集与存储。
+
+1、签到数据采集与管理
+
+（1）支持通过电子班牌系统对接，实现人脸识别或二维码签到。提供学员课程签到数据的自动采集与存储。
+
+<span class="mark">（2）自动过滤重复签到流水（同一学员同一课程在1分钟内重复记录只取第一条）；</span>
+
+<span class="mark">（3）提供手动补采（对接失败时支持管理员手动拉取最近1小时数据）。</span>
+
+注：本模块负责电子班牌系统的自动化签到数据采集，与“二、课程管理”中的人工录入/编辑功能互为补充，共同构成完整的学员课程签到数据源。
+
+2、学习系统使用数据采集与管理
+
+提供第三方学习系统（电子阅览室一体机、桌面听书机、VR实训、3D拆解、3D巡检等）使用记录的原始数据采集与存储，记录每次使用开始时间、结束时间及关联学员。
+
+3、成绩数据采集与管理
+
+（1）支持VR实训、3D巡检等、实操实训等系统的成绩自动采集，可采用数据汇缴模式，也可以采用数据实时获取的模式。
+
+<span class="mark">（2）异常数据告警（如单次学习时长超过课程总时长2倍时标记“异常”并通知管理员审核）。</span>
+
+注：本模块负责第三方系统的自动化成绩采集，与“五、成绩管理”中的人工录入/编辑功能互为补充，共同构成完整的学员成绩数据源。
+
+**七、学习情况统计分析**
+
+1、基于 “六、数据接入” 模块采集的原始数据，自动统计分析每位学员在各系统中的总学习时长，并支持可视化展示。
+
+2、学员各课程签到情况的自动统计。
+
+3、学员各课程成绩情况的自动统计分析。
+
+4、各课程学员成绩情况的自动统计分析。
+
+<span class="mark">5、所有统计报表支持时间范围筛选（日/周/月/自定义区间）及 “一键导出”；</span>
+
+<span class="mark">6、统计图表支持钻取下钻（点击总时长数字可跳转至明细列表）；新增同比环比分析（例如：本月签到率较上月提升/下降百分比）；</span>
+
+<span class="mark">7、支持统计任务异步生成（大数据量统计后台执行，完成后消息提醒下载）。</span>
+
+**八、学员画像**
+
+支持学生画像功能，根据学习情况进行学员画像管理等。
+
+<span class="mark">（1）支持动态标签规则引擎（管理员可自定义配置标签规则，如“签到率 \> 90%”自动标记为“勤勉学员”）；</span>
+
+<span class="mark">（2）画像支持雷达图可视化展示（多维度：考勤、理论成绩、实操能力、学习时长）；</span>
+
+<span class="mark">（3）支持画像定期快照（每月1日自动保存学员画像历史，便于对比成长轨迹）；</span>
+
+<span class="mark">（4）支持按画像标签精准筛选推送（如向“待提升学员”生成定向补习资料推荐清单）。</span>
+
+**九、系统权限管理**
+
+<span class="mark">（1）RBAC权限模型</span>
+
+<span class="mark">采用“用户、角色、权限”三层模型，支持创建自定义角色，系统预置管理员、教师、学员三种基础角色。</span>
+
+<span class="mark">（2）细粒度数据权限</span>
+
+<span class="mark">支持数据行权限（例如：授课教师仅能查看所带班级的学员成绩）。</span>
+
+<span class="mark">（3）操作审计日志</span>
+
+<span class="mark">所有核心模块的“增、删、改、导出”操作均需记录详细的审计日志（操作人、操作时间、IP地址、操作内容变更前后的JSON快照）。</span>
+
+<span class="mark">（4）登录安全策略</span>
+
+<span class="mark">支持设置密码复杂度策略、登录失败锁定机制及超时自动登出。</span>

doc/学员管理系统数据表设计_20260907_1_.md

@@ -0,0 +1,228 @@
+表 1：train_teacher 教师信息表
+
+| **字段名** | **数据类型** | **约束** | **注释说明** |
+|:---|:---|:---|:---|
+| t_id | VARCHAR(20) | 主键 PRIMARY KEY | 教师工号 |
+| t_name | VARCHAR(30) | NOT NULL | 教师姓名 |
+| t_gender | CHAR(2) |  | 性别：男 / 女 |
+| t_birth | DATE |  | 出生日期 |
+| t_department | VARCHAR(50) | NOT NULL | 所属院系 |
+| t_title | VARCHAR(30) |  | 职称：讲师 / 副教授 / 教授 |
+| t_phone | VARCHAR(20) |  | 联系电话 |
+| t_email | VARCHAR(50) |  | 邮箱 |
+| create_user | VARCHAR(32) | NOT NULL | 创建人 (管理员 / 教师) |
+| create_time | DATETIME | DEFAULT CURRENT_TIMESTAMP | 创建时间 |
+| update_time | DATETIME | DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP | 更新时间 |
+| remark | VARCHAR(200) |  | 备注 |
+
+表 2：train_student 学生信息表
+
+| **字段名** | **数据类型** | **约束** | **注释说明** |
+|:---|:---|:---|:---|
+| s_id | VARCHAR(20) | 主键 PRIMARY KEY | 学生学号 |
+| s_name | VARCHAR(30) | NOT NULL | 学生姓名 |
+| s_gender | CHAR(2) |  | 性别：男 / 女 |
+| s_birth | DATE |  | 出生日期 |
+| s_department | VARCHAR(50) | NOT NULL | 所属院系 |
+| s_major | VARCHAR(50) | NOT NULL | 专业 |
+| s_class | VARCHAR(30) |  | 班级 |
+| s_phone | VARCHAR(20) |  | 联系电话 |
+| create_user | VARCHAR(32) | NOT NULL | 创建人 (管理员 / 教师) |
+| create_time | DATETIME | DEFAULT CURRENT_TIMESTAMP | 创建时间 |
+| update_time | DATETIME | DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP | 更新时间 |
+| remark | VARCHAR(200) |  | 备注 |
+
+## 
+
+## Sheet1：train_course_课程信息
+
+| **字段名** | **数据类型** | **约束** | **注释说明** |
+|:---|:---|:---|:---|
+| c_id | VARCHAR(32) | 主键 PRIMARY KEY | 课程编号主键 |
+| c_name | VARCHAR(100) | NOT NULL | 课程名称 |
+| c_type | VARCHAR(30) |  | 课程类型 |
+| c_duration | INT |  | 课程时长 (分钟) |
+| teaching_objective | TEXT |  | 教学目标 |
+| course_content | TEXT |  | 课程内容 |
+| attach_doc | TEXT |  | 配套文档，多个逗号分隔 |
+| attach_video | TEXT |  | 配套视频地址 |
+| attach_model_link | TEXT |  | 配套模型链接 |
+| model_resource_ids | TEXT |  | 关联 3D 设备拆解模型、实训场景资源 ID，多 ID 逗号分隔 |
+| create_user | VARCHAR(32) | NOT NULL | 创建人 (管理员 / 教师) |
+| create_time | DATETIME | DEFAULT CURRENT_TIMESTAMP | 创建时间 |
+| update_time | DATETIME | DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP | 更新时间 |
+| remark | VARCHAR(200) |  | 备注 |
+
+## Sheet2：train_class_plan_开班计划表
+
+| **字段名** | **数据类型** | **约束** | **注释说明** |
+|:---|:---|:---|:---|
+| plan_id | VARCHAR(32) | 主键 PRIMARY KEY | 开班计划 ID 主键 |
+| plan_name | VARCHAR(100) | NOT NULL | 开班名称 |
+| c_id | VARCHAR(32) | NOT NULL，外键 | 所属课程编号，关联 course.c_id |
+| start_time | DATETIME | NOT NULL | 开班时间 |
+| end_time | DATETIME | NOT NULL | 结束时间 |
+| train_address | VARCHAR(100) |  | 培训地点 |
+| t_id | VARCHAR(32) | NOT NULL，外键 | 授课教师工号，关联 teacher.t_id |
+| recruit_num | INT |  | 招生人数 |
+| apply_condition | TEXT |  | 报名条件 |
+| plan_status | TINYINT | DEFAULT 0 | 0 未开始 1 进行中 2 已结束 3 已取消 |
+| create_user | VARCHAR(32) | NOT NULL | 创建管理员账号 |
+| create_time | DATETIME | DEFAULT CURRENT_TIMESTAMP | 创建时间 |
+| update_time | DATETIME | DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP | 更新时间 |
+| remark | VARCHAR(200) |  | 备注 |
+
+## Sheet3：train_dormitory_info_宿舍信息表
+
+| **字段名** | **数据类型** | **约束** | **注释说明** |
+|:---|:---|:---|:---|
+| dorm_id | VARCHAR(32) | 主键 PRIMARY KEY | 宿舍 ID 主键 |
+| dorm_building | VARCHAR(50) |  | 宿舍楼栋 |
+| dorm_room | VARCHAR(30) | NOT NULL | 宿舍房间号 |
+| bed_total | INT |  | 宿舍总床位 |
+| bed_used | INT | DEFAULT 0 | 已占用床位 |
+| lock_device_sn | VARCHAR(64) |  | 宿舍人脸智能锁设备序列号，对接智能锁 |
+| dorm_status | TINYINT | DEFAULT 1 | 0 禁用 1 可用 |
+| create_user | VARCHAR(32) | NOT NULL | 创建管理员账号 |
+| create_time | DATETIME | DEFAULT CURRENT_TIMESTAMP | 创建时间 |
+| update_time | DATETIME | DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP | 更新时间 |
+| remark | VARCHAR(200) |  | 备注 |
+
+## Sheet4：train_dorm_auth_宿舍权限分配表
+
+| **字段名** | **数据类型** | **约束** | **注释说明** |
+|:---|:---|:---|:---|
+| auth_id | INT | 主键、自增 AUTO_INCREMENT | 权限分配 ID |
+| student_id | VARCHAR(32) | NOT NULL，外键 | 学员学号，关联 student.s_id |
+| plan_id | VARCHAR(32) | NOT NULL，外键 | 所属开班计划 ID，class_plan.plan_id |
+| dorm_id | VARCHAR(32) | NOT NULL，外键 | 分配宿舍 ID，dormitory_info.dorm_id |
+| bed_no | VARCHAR(20) |  | 床位号 |
+| face_sync_status | TINYINT | DEFAULT 0 | 0 未下发人脸 1 已下发人脸至智能锁 2 下发失败 |
+| auth_start | DATETIME |  | 权限生效时间 |
+| auth_end | DATETIME |  | 权限失效时间 (开班结束自动失效) |
+| create_user | VARCHAR(32) | NOT NULL | 创建管理员账号 |
+| create_time | DATETIME | DEFAULT CURRENT_TIMESTAMP | 创建时间 |
+| update_time | DATETIME | DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP | 更新时间 |
+| remark | VARCHAR(200) |  | 备注 |
+
+## Sheet5：train_classroom_info_教室信息表
+
+| **字段名** | **数据类型** | **约束** | **注释说明** |
+|:---|:---|:---|:---|
+| class_room_id | VARCHAR(32) | 主键 PRIMARY KEY | 教室 ID 主键 |
+| room_name | VARCHAR(60) | NOT NULL | 教室名称 |
+| room_location | VARCHAR(100) |  | 教室位置 |
+| capacity | INT |  | 容纳人数 |
+| room_status | TINYINT | DEFAULT 1 | 0 正在使用 1 可用，空闲 2 其他 |
+| create_user | VARCHAR(32) | NOT NULL | 创建管理员账号 |
+| create_time | DATETIME | DEFAULT CURRENT_TIMESTAMP | 创建时间 |
+| update_time | DATETIME | DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP | 更新时间 |
+| remark | VARCHAR(200) |  | 备注 |
+
+## Sheet6：train_training_site_实训场地表
+
+| **字段名** | **数据类型** | **约束** | **注释说明** |
+|:---|:---|:---|:---|
+| site_id | VARCHAR(32) | 主键 PRIMARY KEY | 实训场地 ID 主键 |
+| site_name | VARCHAR(80) | NOT NULL | 实训场地名称 |
+| site_location | VARCHAR(100) |  | 场地位置 |
+| capacity | INT |  | 最大容纳人数 |
+| site_device | TEXT |  | 场地配套设备：VR、3D 拆解、3D 巡检设备 |
+| site_status | TINYINT | DEFAULT 1 | 0 停用 1 可用 |
+| create_user | VARCHAR(32) | NOT NULL | 创建管理员账号 |
+| create_time | DATETIME | DEFAULT CURRENT_TIMESTAMP | 创建时间 |
+| update_time | DATETIME | DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP | 更新时间 |
+| remark | VARCHAR(200) |  | 备注 |
+
+## Sheet7：train_class_report_开班报到表
+
+| **字段名** | **数据类型** | **约束** | **注释说明** |
+|:---|:---|:---|:---|
+| report_id | INT | 主键、自增 AUTO_INCREMENT | 报到主键 ID |
+| plan_id | VARCHAR(32) | NOT NULL，外键 | 开班计划 ID class_plan.plan_id |
+| student_id | VARCHAR(32) | NOT NULL，外键 | 学员学号 student.s_id |
+| report_way | TINYINT |  | 报到方式：1 身份证刷卡 2 人脸识别 |
+| report_device_sn | VARCHAR(64) |  | 报到一体机设备编号 |
+| report_time | DATETIME |  | 实际报到时间 |
+| report_status | TINYINT | DEFAULT 0 | 0 未报到 1 已报到 2 请假未到 |
+| alloc_dorm_id | VARCHAR(32) | 外键 | 分配宿舍 ID dormitory_info.dorm_id |
+| alloc_classroom_id | VARCHAR(32) | 外键 | 分配教室 ID classroom_info.class_room_id |
+| alloc_site_id | VARCHAR(32) | 外键 | 分配实训场地 ID training_site.site_id |
+| create_time | DATETIME | DEFAULT CURRENT_TIMESTAMP | 创建时间 |
+
+## Sheet8：train_electronic_board_电子班牌设备表
+
+| **字段名** | **数据类型** | **约束** | **注释说明** |
+|:---|:---|:---|:---|
+| board_id | VARCHAR(32) | 主键 PRIMARY KEY | 电子班牌设备 ID |
+| board_sn | VARCHAR(64) | NOT NULL | 设备硬件序列号 |
+| bind_classroom_id | VARCHAR(32) | 外键 | 绑定教室 ID classroom_info.class_room_id |
+| bind_plan_id | VARCHAR(32) | 外键 | 绑定开班计划 class_plan.plan_id |
+| board_ip | VARCHAR(50) |  | 设备 IP 地址 |
+| board_content | VARCHAR(500) |  | 电子班牌显示内容 |
+| board_playmode | TINYINT | DEFAULT 1 | 0 离线 1 在线正常 |
+| support_checkin_type | VARCHAR(30) |  | 支持签到：人脸，二维码 |
+| board_status | TINYINT | DEFAULT 1 | 0 离线 1 在线正常 |
+| last_heartbeat | DATETIME |  | 最后心跳时间 |
+| create_user | VARCHAR(32) | NOT NULL | 创建管理员账号 |
+| create_time | DATETIME | DEFAULT CURRENT_TIMESTAMP | 创建时间 |
+| update_time | DATETIME | DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP | 更新时间 |
+| remark | VARCHAR(200) |  | 备注 |
+
+## Sheet9：train_student_checkin_学生签到表
+
+| **字段名** | **数据类型** | **约束** | **注释说明** |
+|:---|:---|:---|:---|
+| checkin_id | INT | 主键、自增 AUTO_INCREMENT | 签到记录 ID |
+| plan_id | VARCHAR(32) | NOT NULL，外键 | 开班计划 ID |
+| c_id | VARCHAR(32) | NOT NULL，外键 | 课程 ID |
+| student_id | VARCHAR(32) | NOT NULL，外键 | 学员学号 |
+| board_id | VARCHAR(32) | 外键 | 签到电子班牌设备 ID electronic_board.board_id |
+| checkin_way | TINYINT |  | 1 人脸签到 2 二维码签到 3 后台手动补签 |
+| checkin_time | DATETIME |  | 签到时间 |
+| checkin_status | TINYINT |  | 1 正常签到 2 迟到 3 早退 4 缺勤 |
+| lesson_start_time | DATETIME |  | 本节课程上课时间 |
+| lesson_end_time | DATETIME |  | 本节课程下课时间 |
+
+## Sheet10：train_score_info_多类型成绩表(是否需要分开？按什么统计算归为一期，加权规则是什么)
+
+| **字段名** | **数据类型** | **约束** | **注释说明** |
+|:---|:---|:---|:---|
+| score_id | INT | 主键、自增 AUTO_INCREMENT | 成绩 ID |
+| plan_id | VARCHAR(32) | 外键 | 开班计划 ID |
+| c_id | VARCHAR(32) | 外键 | 课程 ID |
+| student_id | VARCHAR(32) | 外键 | 学员学号 |
+| course_score | DECIMAL(5,2) |  | 课程成绩 |
+| train_score | DECIMAL(5,2) |  | 实训成绩 |
+| exam_score | DECIMAL(5,2) |  | 考核成绩 |
+| source_type | TINYINT |  | 1 后台手动录入 2Excel 批量导入 3 外部接口自动采集 |
+| source_system | VARCHAR(50) |  | 来源系统名称，VR/3D 巡检 / 实操系统 |
+| import_time | DATETIME | DEFAULT CURRENT_TIMESTAMP | 导入时间 |
+
+## Sheet11：train_study_duration_学习时长统计表
+
+| **字段名** | **数据类型** | **约束** | **注释说明** |
+|:---|:---|:---|:---|
+| dur_id | INT | 主键、自增 AUTO_INCREMENT | 记录 ID |
+| student_id | VARCHAR(32) | 外键 | 学员学号 |
+| plan_id | VARCHAR(32) | 外键 | 开班计划 ID |
+| c_id | VARCHAR(32) | 外键 | 课程 ID |
+| device_type | VARCHAR(50) |  | 设备类型：阅览室一体机 / 听书机 / VR 实训 / 3D 拆解 / 3D 巡检 |
+| start_time | DATETIME |  | 开始学习时间 |
+| end_time | DATETIME |  | 结束学习时间 |
+| study_seconds | INT |  | 学习时长，单位秒 |
+| sync_time | DATETIME | DEFAULT CURRENT_TIMESTAMP | 数据同步入库时间 |
+
+## Sheet12：train_student_portrait_学员画像表
+
+| **字段名** | **数据类型** | **约束** | **注释说明** |
+|:---|:---|:---|:---|
+| portrait_id | INT | 主键、自增 AUTO_INCREMENT | 画像 ID |
+| student_id | VARCHAR(32) | NOT NULL，外键 | 学员学号 |
+| plan_id | VARCHAR(32) | NOT NULL，外键 | 开班计划 ID |
+| total_study_hour | DECIMAL(8,2) |  | 累计学习总时长 |
+| avg_score | DECIMAL(5,2) |  | 平均成绩 |
+| checkin_rate | DECIMAL(5,2) |  | 签到率 |
+| label_tag | TEXT |  | 画像标签，逗号分割，例如：动手能力强，理论薄弱 |
+| portrait_content | TEXT |  | 画像综合描述 |
+| update_time | DATETIME | DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP | 更新时间 |

doc/学员管理系统相关需求.md

@@ -0,0 +1,51 @@
+**培训基地软件平台一期内容**
+
+（1）支持管理员/教师创建、编辑、删除课程，可设置课程名称、课程类型、课程时长、教学目标、课程内容、配套资料（文档、视频、模型链接）等信息;
+
+（2）课程可关联3D设备拆解模型、实训场景等教学资源，支持课程与开班计划绑定，实现课程与学员学习的精准匹配;
+
+（3）支持管理员创建开班计划，可设置开班名称、所属课程、开班时间、结束时间、培训地点、授课教师、招生人数、报名条件等参数；
+
+（4）支持信息查询一体机通过身份证、人脸识别等方式进行开班报到，报到后可自动获取所分配宿舍、教室、实训场地、课程表等信息；
+
+（5）可根据宿舍安排，自动下发人脸数据到宿舍房间人脸识别智能锁，自动获取对应宿舍开门权限;
+
+（6）支持通过电子班牌系统对接，实现让开的人脸识别或二维码签到，自动统计学员各课程的签到情况;
+
+（7）支持管理员/教师手动录入学员成绩、批量导入成绩（Excel格式），可录入课程成绩、实训成绩、考核成绩等多类型成绩，提供数据对接接口，实现VR实训、3D巡检等、实操实训等系统的成绩自动采集;
+
+（8）可对接电子阅览室内一体机触控显示屏、桌面听书机、VR实训、3D拆解、3D巡检等系统自动统计记录学习时长
+
+（9）支持学生画像功能，根据学习情况进行学员画像管理等。
+
+**培训基地软件平台二期内容**
+
+1.基于平板电脑开发基地控制系统，后台和平板电脑交互实现如下内容：
+
+（1）学员可以通过平板电脑进行人脸识别签到
+
+（2）教师可以在平板电脑上选择学员、分配实训工位、录入成绩
+
+（3）平板可以对接一期内容进行各类信息查询
+
+（4）对接帽石系统实现对帽石考核的设置，成绩录入
+
+（5）对接铁科院钢结构监测系统数据，并能在数字孪生模型展示监测数据
+
+（6）控制基地智慧照明，对各个照明区进行控制
+
+（7）对接智能工具箱系统，获取取送工具数据，实现自动考评
+
+（8）对接钢结构教学模型，实现对模型物理量的设置，模拟钢结构故障，并能在数字孪生模型上展示
+
+（9）对接电工实训箱智能设备，可设置开始自动考评，并获取逻辑考评结果、工艺考评结果，和绝缘考评结果。
+
+2.基于大屏的基地驾驶舱开发，根据一期二期内容，实现如下功能：
+
+（1）根据一期二期内容，设计数据统计和分析页面，包括培训数据汇总、课程体系、教学数据、成绩数据、学员画像
+
+（2）提供平板控制大屏驾驶舱，实现虚实结合的实训区实训教学观摩，可按实训室实训科目分类调阅
+
+（3）帽石和钢结构模型数字孪生的实时展示
+
+（4）各个实训区摄像机的调取和预览

docs/codebase-audit/00_project_overview.md

@@ -0,0 +1,79 @@
+# RailwaySystem 代码基线审计：项目概览
+
+> 审计日期：2026-09-11  
+> 审计对象：当前 Git 工作树（包含已跟踪、未提交及未跟踪代码）  
+> 审计方式：静态只读检查；未连接数据库，未执行迁移，未编译、未启动、未修改业务代码。文中“存在”表示仓库中有相应代码，“可运行/已接通”只有在存在直接证据时才成立。
+
+## 1. 工程定位与版本
+
+- 当前仓库分支为 `main`。
+- 后端是经典版 **RuoYi-Vue 前后端分离项目**，若依版本 **3.9.1**。依据：`RuoYi-Vue/README.md`、`RuoYi-Vue/pom.xml`、`RuoYi-Vue/ruoyi-admin/src/main/resources/application.yml`。
+- 无法仅凭当前仓库证明最初从若依上游的哪个 Git 分支拉取；能确认的是当前代码属于经典 Vue 2 / Spring Boot 2 的 RuoYi-Vue 3.9.1 技术线，而当前仓库自己的分支是 `main`。
+- 项目中有两个 Vue 工程：
+  - `build_ui/`：标题和描述均为“智慧培训管理平台”，含完整 `src/views/train` 与 `src/api/train`，是当前培训业务前端。
+  - `RuoYi-Vue/ruoyi-ui/`：描述为“知识图谱构建平台”，没有本次 14 组培训 CRUD 对应页面，应视为历史/基础前端副本，不能与 `build_ui/` 混为一个运行入口。
+
+## 2. 后端技术栈
+
+| 项目 | 当前代码证据 | 结论 |
+| --- | --- | --- |
+| Java | `RuoYi-Vue/pom.xml` 的 `java.version=1.8` | 源码/字节码目标 Java 8 |
+| 当前机器 Java | `java -version` 为 OpenJDK 21.0.2 | 本机实际 Maven 运行时是 Java 21，与项目目标版本不同 |
+| Spring Boot | `RuoYi-Vue/pom.xml` 的 `spring-boot.version=2.5.15` | Spring Boot 2.5.15 |
+| Spring Framework | 同文件 `spring-framework.version=5.3.39` | 5.3.39 |
+| Spring Security | 同文件 `spring-security.version=5.7.14` | 5.7.14，方法级鉴权 |
+| 持久层 | `pagehelper-spring-boot-starter=1.4.7`、`mapper/**/*.xml` | 原生 MyBatis XML + PageHelper；未发现 MyBatis-Plus/baomidou |
+| 数据源 | `application-druid.yml` | Druid 1.2.27，当前主库配置为 KingbaseES |
+| JDBC 驱动 | 根 POM 与 `ruoyi-admin/pom.xml` | `com.kingbase:kingbase8:8.6.0`；MySQL 驱动也仍保留 |
+| Excel | `ruoyi-common/.../ExcelUtil.java`、POI 4.1.2 | 若依 Excel 导入导出基础能力保留；培训 Controller 仅接了导出 |
+| Token/JWT | `TokenService.java`、`JwtAuthenticationTokenFilter.java` | JWT 携带会话键，登录态主体保存在 Redis |
+
+## 3. Maven 模块关系
+
+父工程 `RuoYi-Vue/pom.xml` 聚合 7 个模块：
+
+| 模块 | 作用 | 主要依赖关系 |
+| --- | --- | --- |
+| `ruoyi-admin` | Spring Boot 启动入口、Web Controller、配置 | 依赖 `framework`、`quartz`、`generator`、`train` |
+| `ruoyi-framework` | Security、Token、AOP、数据源、Web 框架 | 依赖 `ruoyi-system` |
+| `ruoyi-system` | 用户、角色、菜单、部门、字典、日志、配置、公告 | 依赖 `ruoyi-common` |
+| `ruoyi-quartz` | Quartz 定时任务与任务日志 | 依赖 `ruoyi-common` |
+| `ruoyi-generator` | 代码生成器 | 依赖 `ruoyi-common`、Druid |
+| `ruoyi-common` | 通用返回、分页、异常、Excel、文件、安全工具 | 公共基础层 |
+| `ruoyi-train` | 14 个培训领域对象、Mapper、Service | 依赖 `ruoyi-common`；Controller 放在 `ruoyi-admin` |
+
+依据：`RuoYi-Vue/pom.xml:257`、各模块 `pom.xml`、`RuoYi-Vue/ruoyi-admin/pom.xml`。
+
+## 4. 前端技术栈
+
+`build_ui/package.json` 显示：Vue 2.6.12、Vue Router 3.4.9、Vuex 3.6.0、Element UI 2.15.12、Axios 0.24.0、ECharts 5.4.0、Vue CLI Service 4.4.6。`engines` 只声明 Node `>=8.9`、npm `>=3.0.0`，范围过宽，不能代表在当前 Node 22 上已被官方验证。
+
+当前机器为 Node 22.23.2、npm 10.9.8。`build_ui/node_modules/.bin/vue-cli-service` 存在；本次没有执行 `npm run dev` 或构建。`build_ui/vue.config.js` 中存在尚未提交的 Node 22/MD4 兼容处理，并将开发端口从 80 改为 8080。
+
+## 5. 数据库、Redis与环境
+
+- 当前激活的 Spring profile 是 `druid`，配置位置：`RuoYi-Vue/ruoyi-admin/src/main/resources/application.yml`。
+- 实际 datasource 配置位置：`RuoYi-Vue/ruoyi-admin/src/main/resources/application-druid.yml`。
+- 当前配置使用 KingbaseES JDBC URL、`com.kingbase8.Driver` 与 `kingbase8:8.6.0`；账号口令以明文存在配置文件中，本报告不复述。
+- `application.yml` 同时将 PageHelper 方言固定为 `mysql`；若依系统 Mapper 和代码生成器还存在 `date_format`、`find_in_set`、反引号、`ifnull` 等 MySQL 语法。
+- Redis 配置为本机 `localhost:6379`、database 0。Token 会话、验证码/密码错误计数、缓存和在线用户依赖 Redis，因此正常登录运行时 Redis 是实际依赖。
+- `ruoyi-quartz`、Quartz Controller/Service/Mapper、`sql/quartz.sql` 均存在；这只能证明定时任务框架保留，不能证明已配置培训业务任务。
+
+## 6. 已保留的若依能力
+
+代码层已保留：登录、JWT/Redis 登录态、RBAC、动态菜单、按钮权限、操作日志、数据权限框架、字典、定时任务、文件上传下载、Excel 工具、分页、统一返回、全局异常处理、代码生成、系统配置、通知公告。
+
+“正常保留”不等于“已在 Kingbase 环境验证正常”。其中系统 SQL、代码生成元数据查询、PageHelper 方言和训练权限配置仍存在明确的接通风险，详见 `03_database_current_state.md`、`06_security_and_permissions.md` 和 `09_reusable_ruoyi_capabilities.md`。
+
+## 7. 培训业务总体成熟度
+
+- 后端存在 14 组标准生成式 CRUD，每组均有 Entity、Mapper、XML、Service、ServiceImpl、Controller。
+- 前端当前工作树存在 14 组对应 CRUD 页面/API；其中成绩页面/API以及部分适配文件仍未跟踪，教室、宿舍、成绩 Controller 的别名也未提交。
+- 14 组 Controller 共形成 84 个映射：每组 6 个，分别为分页列表、导出、详情、新增、修改、批量删除。
+- 未发现培训导入接口、统计接口、设备回调/外部接入接口、流程动作接口、领域事务或专用 DTO/VO。
+- 仓库没有 14 张 `train_` 表的 DDL、培训菜单/权限初始化 SQL、培训种子数据或迁移文件，也没有培训自动化测试。
+- 因此当前基线应描述为：**14 组数据模型和 CRUD 脚手架基本齐全，但端到端可运行状态、数据库对象、菜单权限和业务闭环尚未由仓库证据证明。**
+
+## 8. 审计边界
+
+本次没有查询实时数据库。因此以下事项仍属“未验证”：14 张业务表是否已真实创建、表字段/约束是否与设计一致、当前 `sys_menu` 是否另由人工配置、当前 Kingbase 实例是否开启兼容模式、现有账号是否拥有培训权限、外部设备或系统是否另有未入库服务。

docs/codebase-audit/01_project_tree.md

@@ -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 上形成的字面目录，属于构建产物/依赖副本，不是业务模块。

docs/codebase-audit/02_training_modules_inventory.md

@@ -0,0 +1,510 @@
+# 培训业务模块与 14 组 CRUD 盘点
+
+## 1. 审计口径
+
+本文件来自对以下实际目录的逐项比对：
+
+- Controller：`RuoYi-Vue/ruoyi-admin/src/main/java/com/ruoyi/web/controller/train/`
+- Domain：`RuoYi-Vue/ruoyi-train/src/main/java/com/ruoyi/train/domain/`
+- Mapper：`RuoYi-Vue/ruoyi-train/src/main/java/com/ruoyi/train/mapper/`
+- Service：`RuoYi-Vue/ruoyi-train/src/main/java/com/ruoyi/train/service/`
+- XML：`RuoYi-Vue/ruoyi-train/src/main/resources/mapper/train/`
+- 前端：`build_ui/src/views/train/`、`build_ui/src/api/train/`
+- 表设计：`doc/学员管理系统数据表设计_20260907_1_.docx`
+
+14 组后端均为同一生成式结构：分页列表、Excel 导出、详情、新增、修改、物理批量删除。未发现培训专用 DTO/VO；Controller 直接接收并返回 Domain。ServiceImpl 基本为 Mapper 委托，没有领域校验、跨表编排、事务流程或外部系统调用。
+
+## 2. 模块逐项盘点
+
+### 2.1 教师信息
+
+**模块名称：** 教师信息（`train_teacher`）
+
+**后端：**
+
+- Controller：`TrainTeacherController`
+- Service：`ITrainTeacherService`
+- ServiceImpl：`TrainTeacherServiceImpl`
+- Mapper：`TrainTeacherMapper`
+- XML：`TrainTeacherMapper.xml`
+- Domain / Entity：`TrainTeacher`
+- DTO / VO：无
+
+**前端：**
+
+- views：`build_ui/src/views/train/teacher/index.vue`
+- api：`build_ui/src/api/train/teacher.js`
+
+**数据库：** 涉及表 `train_teacher`
+
+**当前已有功能：**
+
+1. 教师条件列表、详情、新增、修改、批量删除。
+2. 基于 `@Excel` 字段注解的导出。
+3. 字段覆盖工号、姓名、性别、出生日期、院系、职称、电话、邮箱及公共审计字段。
+
+**明显缺失：**
+
+1. 没有教师与 `sys_user` 的账号关联。
+2. 没有资质/证书、状态、可授课程、授课范围及教师数据权限。
+3. 删除为物理删除；无导入接口、查重与跨表引用校验。
+
+### 2.2 学员信息
+
+**模块名称：** 学员信息（`train_student`）
+
+**后端：**
+
+- Controller：`TrainStudentController`
+- Service：`ITrainStudentService`
+- ServiceImpl：`TrainStudentServiceImpl`
+- Mapper：`TrainStudentMapper`
+- XML：`TrainStudentMapper.xml`
+- Domain / Entity：`TrainStudent`
+- DTO / VO：无
+
+**前端：**
+
+- views：`build_ui/src/views/train/student/index.vue`
+- api：`build_ui/src/api/train/student.js`
+
+**数据库：** 涉及表 `train_student`
+
+**当前已有功能：**
+
+1. 学员条件列表、详情、新增、修改、批量删除。
+2. Excel 导出。
+3. 保存学号、姓名、性别、出生日期、院系、专业、班级、电话。
+
+**明显缺失：**
+
+1. 没有学员与 `sys_user` 的账号关联，也没有身份证/人脸等报到和门禁所需身份数据。
+2. 没有参训/报名关系、学员在某期培训中的状态。
+3. 删除为物理删除；无培训学员导入接口和重复校验。
+
+### 2.3 课程信息
+
+**模块名称：** 课程信息（`train_course`）
+
+**后端：**
+
+- Controller：`TrainCourseController`
+- Service：`ITrainCourseService`
+- ServiceImpl：`TrainCourseServiceImpl`
+- Mapper：`TrainCourseMapper`
+- XML：`TrainCourseMapper.xml`
+- Domain / Entity：`TrainCourse`
+- DTO / VO：无
+
+**前端：**
+
+- views：`build_ui/src/views/train/course/index.vue`
+- api：`build_ui/src/api/train/course.js`
+
+**数据库：** 涉及表 `train_course`
+
+**当前已有功能：**
+
+1. 课程条件列表、详情、新增、修改、批量删除。
+2. Excel 导出。
+3. 文档、视频、模型链接和模型资源 ID 以文本字段保存。
+
+**明显缺失：**
+
+1. 没有课程版本、章节、课次、课表、资源实体及资源关系。
+2. 附件和多资源使用逗号分隔/文本 URL，没有与已有上传能力形成业务关系。
+3. 无课程发布、审核、上下架等动作。
+
+### 2.4 开班计划
+
+**模块名称：** 开班计划（`train_class_plan`）
+
+**后端：**
+
+- Controller：`TrainClassPlanController`
+- Service：`ITrainClassPlanService`
+- ServiceImpl：`TrainClassPlanServiceImpl`
+- Mapper：`TrainClassPlanMapper`
+- XML：`TrainClassPlanMapper.xml`
+- Domain / Entity：`TrainClassPlan`
+- DTO / VO：无
+
+**前端：**
+
+- views：`build_ui/src/views/train/plan/index.vue`
+- api：`build_ui/src/api/train/plan.js`
+
+**数据库：** 涉及表 `train_class_plan`
+
+**当前已有功能：**
+
+1. 计划条件列表、详情、新增、修改、批量删除。
+2. Excel 导出。
+3. 保存单个 `c_id`、单个 `t_id`、起止时间、地点、招生人数、报名条件、状态。
+
+**明显缺失：**
+
+1. 一个计划只有一个课程与一个教师，不能表达一班多课、多教师、逐课次安排。
+2. 没有参训名单、报名审核、开班/结班等状态动作。
+3. 没有教室、实训场地、课程时间冲突校验。
+
+### 2.5 宿舍信息
+
+**模块名称：** 宿舍信息（`train_dormitory_info`）
+
+**后端：**
+
+- Controller：`TrainDormitoryInfoController`
+- Service：`ITrainDormitoryInfoService`
+- ServiceImpl：`TrainDormitoryInfoServiceImpl`
+- Mapper：`TrainDormitoryInfoMapper`
+- XML：`TrainDormitoryInfoMapper.xml`
+- Domain / Entity：`TrainDormitoryInfo`
+- DTO / VO：无
+
+**前端：**
+
+- views：`build_ui/src/views/train/dormitory/index.vue`（有未提交修改）
+- api：`build_ui/src/api/train/dormitory.js`（未跟踪）
+
+**数据库：** 涉及表 `train_dormitory_info`
+
+**当前已有功能：**
+
+1. 当前工作树页面与 API 支持宿舍列表、详情、新增、修改、删除。
+2. 保存楼栋、房间号、床位总数/已用数、门锁序列号、状态。
+3. Controller 同时接受 `/train/dorminfo` 与 `/train/dormitory`，该别名改动尚未提交。
+
+**明显缺失：**
+
+1. 当前页面没有导出按钮和 `v-hasPermi` 按钮权限控制；后端仍有导出接口。
+2. 没有独立床位实体、床位占用唯一性或容量一致性校验。
+3. 无楼栋/楼层层级和住宿状态流转。
+
+### 2.6 宿舍权限分配
+
+**模块名称：** 宿舍权限分配（`train_dorm_auth`）
+
+**后端：**
+
+- Controller：`TrainDormAuthController`
+- Service：`ITrainDormAuthService`
+- ServiceImpl：`TrainDormAuthServiceImpl`
+- Mapper：`TrainDormAuthMapper`
+- XML：`TrainDormAuthMapper.xml`
+- Domain / Entity：`TrainDormAuth`
+- DTO / VO：无
+
+**前端：**
+
+- views：`build_ui/src/views/train/auth/index.vue`
+- api：`build_ui/src/api/train/auth.js`
+
+**数据库：** 涉及表 `train_dorm_auth`
+
+**当前已有功能：**
+
+1. 权限记录条件列表、详情、新增、修改、批量删除。
+2. Excel 导出。
+3. 保存学员、计划、宿舍、床号、授权起止时间和人脸下发状态。
+
+**明显缺失：**
+
+1. 没有实际门锁下发接口、回调、重试、错误详情或操作流水。
+2. 住宿分配与设备授权耦合在一张表，没有独立住宿分配状态。
+3. 没有床位冲突、时段重叠、人员/计划/房间存在性校验。
+
+### 2.7 教室信息
+
+**模块名称：** 教室信息（`train_classroom_info`）
+
+**后端：**
+
+- Controller：`TrainClassroomInfoController`
+- Service：`ITrainClassroomInfoService`
+- ServiceImpl：`TrainClassroomInfoServiceImpl`
+- Mapper：`TrainClassroomInfoMapper`
+- XML：`TrainClassroomInfoMapper.xml`
+- Domain / Entity：`TrainClassroomInfo`
+- DTO / VO：无
+
+**前端：**
+
+- views：`build_ui/src/views/train/classroom/index.vue`
+- api：页面实际导入 `build_ui/src/api/train/info.js`；另有未跟踪的 `classroom.js`
+
+**数据库：** 涉及表 `train_classroom_info`
+
+**当前已有功能：**
+
+1. 教室列表、详情、新增、修改、删除与导出。
+2. 保存名称、位置、容量、状态。
+3. 当前 Controller 接受 `/train/classroominfo`、`/train/classroom`、`/train/info` 三个前缀，属于未提交兼容改动。
+
+**明显缺失：**
+
+1. 前后端权限分别为 `train:info:*` 和 `system:info:*`，不一致。
+2. 多个 API 文件/别名并存，规范入口尚未收敛。
+3. 无排课占用、时间冲突与容量校验。
+
+### 2.8 实训场地
+
+**模块名称：** 实训场地（`train_training_site`）
+
+**后端：**
+
+- Controller：`TrainTrainingSiteController`
+- Service：`ITrainTrainingSiteService`
+- ServiceImpl：`TrainTrainingSiteServiceImpl`
+- Mapper：`TrainTrainingSiteMapper`
+- XML：`TrainTrainingSiteMapper.xml`
+- Domain / Entity：`TrainTrainingSite`
+- DTO / VO：无
+
+**前端：**
+
+- views：`build_ui/src/views/train/site/index.vue`
+- api：`build_ui/src/api/train/site.js`
+
+**数据库：** 涉及表 `train_training_site`
+
+**当前已有功能：**
+
+1. 场地条件列表、详情、新增、修改、批量删除。
+2. Excel 导出。
+3. 保存名称、位置、容量、配套设备文本、状态。
+
+**明显缺失：**
+
+1. 配套设备仅为文本字段，没有设备资产关系。
+2. 无场地排期、占用、冲突和容量校验。
+3. 无场地类型、设备可用状态的独立管理。
+
+### 2.9 开班报到
+
+**模块名称：** 开班报到（`train_class_report`）
+
+**后端：**
+
+- Controller：`TrainClassReportController`
+- Service：`ITrainClassReportService`
+- ServiceImpl：`TrainClassReportServiceImpl`
+- Mapper：`TrainClassReportMapper`
+- XML：`TrainClassReportMapper.xml`
+- Domain / Entity：`TrainClassReport`
+- DTO / VO：无
+
+**前端：**
+
+- views：`build_ui/src/views/train/report/index.vue`
+- api：`build_ui/src/api/train/report.js`
+
+**数据库：** 涉及表 `train_class_report`
+
+**当前已有功能：**
+
+1. 报到记录条件列表、详情、新增、修改、批量删除。
+2. Excel 导出。
+3. 保存报到方式、设备号、时间、状态，以及宿舍/教室/场地分配 ID。
+
+**明显缺失：**
+
+1. 页面是人工维护 CRUD，没有身份证/人脸设备接入或回调接口。
+2. 没有参训名单作为报到资格来源，也没有防重复报到与状态流转。
+3. 报到事件与三类资源分配耦合，未见原子事务和容量/冲突校验。
+
+### 2.10 电子班牌
+
+**模块名称：** 电子班牌设备（`train_electronic_board`）
+
+**后端：**
+
+- Controller：`TrainElectronicBoardController`
+- Service：`ITrainElectronicBoardService`
+- ServiceImpl：`TrainElectronicBoardServiceImpl`
+- Mapper：`TrainElectronicBoardMapper`
+- XML：`TrainElectronicBoardMapper.xml`
+- Domain / Entity：`TrainElectronicBoard`
+- DTO / VO：无
+
+**前端：**
+
+- views：`build_ui/src/views/train/board/index.vue`
+- api：`build_ui/src/api/train/board.js`
+
+**数据库：** 涉及表 `train_electronic_board`
+
+**当前已有功能：**
+
+1. 班牌设备条件列表、详情、新增、修改、批量删除。
+2. Excel 导出。
+3. 保存序列号、绑定教室/计划、IP、显示内容、播放模式、签到类型、在线状态、最后心跳。
+
+**明显缺失：**
+
+1. 没有心跳上报、内容发布、设备命令、签到回调等外部接入接口。
+2. 没有设备认证、签名、幂等和离线判定任务。
+3. `board_playmode` 的设计注释与 `board_status` 都使用“离线/在线”语义，字段边界不清。
+
+### 2.11 学员签到
+
+**模块名称：** 学员签到（`train_student_checkin`）
+
+**后端：**
+
+- Controller：`TrainStudentCheckinController`
+- Service：`ITrainStudentCheckinService`
+- ServiceImpl：`TrainStudentCheckinServiceImpl`
+- Mapper：`TrainStudentCheckinMapper`
+- XML：`TrainStudentCheckinMapper.xml`
+- Domain / Entity：`TrainStudentCheckin`
+- DTO / VO：无
+
+**前端：**
+
+- views：`build_ui/src/views/train/checkin/index.vue`
+- api：`build_ui/src/api/train/checkin.js`
+
+**数据库：** 涉及表 `train_student_checkin`
+
+**当前已有功能：**
+
+1. 签到记录条件列表、详情、新增、修改、批量删除。
+2. Excel 导出。
+3. 保存计划、课程、学员、班牌、签到方式/状态，以及课次起止时间。
+
+**明显缺失：**
+
+1. 没有 `lesson_id`/课次实体；每条签到重复保存课程起止时间。
+2. 没有设备签到接入、二维码生成/核验、迟到早退计算或补签审批。
+3. 没有同一学员同一课次的唯一约束/幂等证据。
+
+### 2.12 多类型成绩
+
+**模块名称：** 多类型成绩（`train_score_info`）
+
+**后端：**
+
+- Controller：`TrainScoreInfoController`
+- Service：`ITrainScoreInfoService`
+- ServiceImpl：`TrainScoreInfoServiceImpl`
+- Mapper：`TrainScoreInfoMapper`
+- XML：`TrainScoreInfoMapper.xml`
+- Domain / Entity：`TrainScoreInfo`
+- DTO / VO：无
+
+**前端：**
+
+- views：`build_ui/src/views/train/score/index.vue`（未跟踪）
+- api：`build_ui/src/api/train/score.js`（未跟踪）
+- 只读衍生视图：`student-score/index.vue`、`course-score/index.vue`（均未跟踪）
+
+**数据库：** 涉及表 `train_score_info`
+
+**当前已有功能：**
+
+1. 当前工作树有成绩列表、详情、新增、修改、删除页面/API；后端有导出接口。
+2. 保存课程成绩、实训成绩、考核成绩、来源类型/系统、导入时间。
+3. 学员成绩和课程成绩页面只是调用同一列表接口做筛选；课程成绩页以 `examScore` 在前端计算显示评级。
+
+**明显缺失：**
+
+1. 成绩页面没有按钮权限指令和导出入口，文件仍未纳入 Git。
+2. 没有 Excel 导入接口、外部采集接口、错误反馈、审核/发布/锁定。
+3. 没有权重、综合分公式及版本；代码未计算真正综合成绩。
+
+### 2.13 学习时长
+
+**模块名称：** 学习时长统计（`train_study_duration`）
+
+**后端：**
+
+- Controller：`TrainStudyDurationController`
+- Service：`ITrainStudyDurationService`
+- ServiceImpl：`TrainStudyDurationServiceImpl`
+- Mapper：`TrainStudyDurationMapper`
+- XML：`TrainStudyDurationMapper.xml`
+- Domain / Entity：`TrainStudyDuration`
+- DTO / VO：无
+
+**前端：**
+
+- views：`build_ui/src/views/train/duration/index.vue`
+- api：`build_ui/src/api/train/duration.js`
+
+**数据库：** 涉及表 `train_study_duration`
+
+**当前已有功能：**
+
+1. 时长记录条件列表、详情、新增、修改、批量删除。
+2. Excel 导出。
+3. 保存设备类型、起止时间、时长秒数和同步时间。
+
+**明显缺失：**
+
+1. 没有设备/外部系统上报接口、外部事件 ID、幂等与异常记录。
+2. 没有由起止时间校验或计算 `study_seconds` 的业务逻辑。
+3. 无汇总统计接口；所谓“统计”当前仍是明细 CRUD。
+
+### 2.14 学员画像
+
+**模块名称：** 学员画像（`train_student_portrait`）
+
+**后端：**
+
+- Controller：`TrainStudentPortraitController`
+- Service：`ITrainStudentPortraitService`
+- ServiceImpl：`TrainStudentPortraitServiceImpl`
+- Mapper：`TrainStudentPortraitMapper`
+- XML：`TrainStudentPortraitMapper.xml`
+- Domain / Entity：`TrainStudentPortrait`
+- DTO / VO：无
+
+**前端：**
+
+- views：`build_ui/src/views/train/portrait/index.vue`
+- api：`build_ui/src/api/train/portrait.js`
+
+**数据库：** 涉及表 `train_student_portrait`
+
+**当前已有功能：**
+
+1. 画像记录条件列表、详情、新增、修改、批量删除。
+2. Excel 导出。
+3. 保存总学习时长、平均成绩、签到率、标签和综合描述。
+
+**明显缺失：**
+
+1. 没有从签到、成绩、学习时长聚合生成画像的服务。
+2. 没有指标/标签规则、版本、快照历史或生成时间。
+3. 前端只是表格 CRUD，没有雷达图、趋势或画像工作台。
+
+## 3. 14 组 CRUD 完整度
+
+| 模块 | 数据表 | Entity | Mapper | Service | Controller | 前端 API | 前端页面 | CRUD 完整度 |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| 教师 | `train_teacher` | `TrainTeacher` | 接口+XML | 接口+Impl | `TrainTeacherController` | `teacher.js` | `teacher/index.vue` | 疑似生成但未接通 |
+| 学员 | `train_student` | `TrainStudent` | 接口+XML | 接口+Impl | `TrainStudentController` | `student.js` | `student/index.vue` | 疑似生成但未接通 |
+| 课程 | `train_course` | `TrainCourse` | 接口+XML | 接口+Impl | `TrainCourseController` | `course.js` | `course/index.vue` | 疑似生成但未接通 |
+| 开班计划 | `train_class_plan` | `TrainClassPlan` | 接口+XML | 接口+Impl | `TrainClassPlanController` | `plan.js` | `plan/index.vue` | 疑似生成但未接通 |
+| 宿舍 | `train_dormitory_info` | `TrainDormitoryInfo` | 接口+XML | 接口+Impl | `TrainDormitoryInfoController` | `dormitory.js`（未跟踪） | `dormitory/index.vue`（已修改） | 疑似生成但未接通 |
+| 宿舍权限 | `train_dorm_auth` | `TrainDormAuth` | 接口+XML | 接口+Impl | `TrainDormAuthController` | `auth.js` | `auth/index.vue` | 疑似生成但未接通 |
+| 教室 | `train_classroom_info` | `TrainClassroomInfo` | 接口+XML | 接口+Impl | `TrainClassroomInfoController`（已修改） | `info.js`（已修改） | `classroom/index.vue` | 疑似生成但未接通 |
+| 实训场地 | `train_training_site` | `TrainTrainingSite` | 接口+XML | 接口+Impl | `TrainTrainingSiteController` | `site.js` | `site/index.vue` | 疑似生成但未接通 |
+| 开班报到 | `train_class_report` | `TrainClassReport` | 接口+XML | 接口+Impl | `TrainClassReportController` | `report.js` | `report/index.vue` | 疑似生成但未接通 |
+| 电子班牌 | `train_electronic_board` | `TrainElectronicBoard` | 接口+XML | 接口+Impl | `TrainElectronicBoardController` | `board.js` | `board/index.vue` | 疑似生成但未接通 |
+| 学员签到 | `train_student_checkin` | `TrainStudentCheckin` | 接口+XML | 接口+Impl | `TrainStudentCheckinController` | `checkin.js` | `checkin/index.vue` | 疑似生成但未接通 |
+| 多类型成绩 | `train_score_info` | `TrainScoreInfo` | 接口+XML | 接口+Impl | `TrainScoreInfoController`（已修改） | `score.js`（未跟踪） | `score/index.vue`（未跟踪） | 疑似生成但未接通 |
+| 学习时长 | `train_study_duration` | `TrainStudyDuration` | 接口+XML | 接口+Impl | `TrainStudyDurationController` | `duration.js` | `duration/index.vue` | 疑似生成但未接通 |
+| 学员画像 | `train_student_portrait` | `TrainStudentPortrait` | 接口+XML | 接口+Impl | `TrainStudentPortraitController` | `portrait.js` | `portrait/index.vue` | 疑似生成但未接通 |
+
+### 判断说明
+
+这里的“疑似生成但未接通”不是说缺少 CRUD 文件。相反，14 组的六类后端构件和对应前端页面/API在当前工作树都存在。采用该结论是因为：
+
+1. 仓库没有培训表 DDL或迁移，无法证明运行数据库有表。
+2. 仓库没有培训 `sys_menu`/权限初始化 SQL，前后端权限字符串还普遍不一致。
+3. 成绩、宿舍 API及部分页面/Controller适配尚未提交。
+4. 没有端到端测试、接口测试或当前启动验证证据。
+
+若只按“是否具有生成器产出的 CRUD 文件”衡量，14 组均为代码层齐全；若按“用户可从菜单登录并完成 CRUD”衡量，目前没有一组可以由仓库证据确认“完整”。

docs/codebase-audit/03_database_current_state.md

@@ -0,0 +1,147 @@
+# 数据库当前状态
+
+## 1. 审计边界与结论
+
+本次只检查代码、Mapper XML、配置、SQL 文件和数据表设计文档，没有连接或查询实时数据库。因此本文件区分三种事实：
+
+- **代码引用**：Mapper 明确执行某张表。
+- **设计存在**：`doc/学员管理系统数据表设计_20260907_1_.docx` 描述了该表。
+- **数据库实存**：本次未验证，不能由 Entity 或 Mapper 的存在推导。
+
+代码正配置为 KingbaseES，但仓库中的唯一系统初始化脚本和多处 Mapper 仍为 MySQL 方言；培训业务又完全没有可执行 DDL/迁移。这是继续开发前必须先确认的数据库基线问题。
+
+## 2. 数据源与驱动
+
+| 项目 | 当前状态 | 代码依据 |
+| --- | --- | --- |
+| 数据库 | KingbaseES | `RuoYi-Vue/ruoyi-admin/src/main/resources/application-druid.yml` 使用 `jdbc:kingbase8:` |
+| 驱动类 | `com.kingbase8.Driver` | 同上 |
+| Maven 驱动 | `com.kingbase:kingbase8:8.6.0` | `RuoYi-Vue/pom.xml`、`ruoyi-admin/pom.xml` |
+| 连接池 | Druid 1.2.27 | 根 POM、`application-druid.yml` |
+| 当前库/schema | 配置指向 `training` / `public` | `application-druid.yml`；主机、用户名和口令不在报告中复述 |
+| 其他驱动 | MySQL Connector 仍在 `ruoyi-admin` 依赖中 | `RuoYi-Vue/ruoyi-admin/pom.xml:46` |
+| PageHelper 方言 | 固定为 `mysql` | `application.yml:109` |
+
+## 3. 表分类
+
+### A. 若依系统表，不建议修改
+
+`RuoYi-Vue/sql/ry_20250522.sql` 定义并由 `ruoyi-system`、`ruoyi-framework`、`ruoyi-quartz`、`ruoyi-generator` 使用的主要表包括：
+
+- 账号与组织：`sys_user`、`sys_dept`、`sys_post`、`sys_role`。
+- 权限关系：`sys_menu`、`sys_user_role`、`sys_role_menu`、`sys_role_dept`、`sys_user_post`。
+- 基础配置：`sys_config`、`sys_dict_type`、`sys_dict_data`、`sys_notice`。
+- 日志：`sys_oper_log`、`sys_logininfor`。
+- 定时任务：`sys_job`、`sys_job_log`，以及 `quartz.sql` 中的 `qrtz_*` 表。
+- 代码生成：`gen_table`、`gen_table_column`。
+
+这些表支撑若依登录、RBAC、菜单、数据权限、字典、配置、公告、日志、任务和代码生成。培训业务应通过新增菜单、角色关系和业务关联复用它们，不应改造其结构来代替培训领域表。本次未修改任何 `sys_*` 表。
+
+### B. 当前培训业务表
+
+以下 14 张表同时出现在设计文档和 Mapper XML 中：
+
+| 表 | Entity | 主键 | Mapper SQL | 设计字段与 Entity/Mapper |
+| --- | --- | --- | --- | --- |
+| `train_teacher` | `TrainTeacher` | `t_id` / `String` | 查、增、改、物理删 | 显式业务字段一致；另继承 BaseEntity 属性 |
+| `train_student` | `TrainStudent` | `s_id` / `String` | 查、增、改、物理删 | 显式业务字段一致；另继承 BaseEntity 属性 |
+| `train_course` | `TrainCourse` | `c_id` / `String` | 查、增、改、物理删 | 显式业务字段一致；另继承 BaseEntity 属性 |
+| `train_class_plan` | `TrainClassPlan` | `plan_id` / `String` | 查、增、改、物理删 | 显式业务字段一致；另继承 BaseEntity 属性 |
+| `train_dormitory_info` | `TrainDormitoryInfo` | `dorm_id` / `String` | 查、增、改、物理删 | 显式业务字段一致；另继承 BaseEntity 属性 |
+| `train_dorm_auth` | `TrainDormAuth` | `auth_id` / `Long` | 查、增、改、物理删；generated keys | 显式业务字段一致；另继承 BaseEntity 属性 |
+| `train_classroom_info` | `TrainClassroomInfo` | `class_room_id` / `String` | 查、增、改、物理删 | 显式业务字段一致；另继承 BaseEntity 属性 |
+| `train_training_site` | `TrainTrainingSite` | `site_id` / `String` | 查、增、改、物理删 | 显式业务字段一致；另继承 BaseEntity 属性 |
+| `train_class_report` | `TrainClassReport` | `report_id` / `Long` | 查、增、改、物理删；generated keys | 显式业务字段一致；另继承 BaseEntity 属性 |
+| `train_electronic_board` | `TrainElectronicBoard` | `board_id` / `String` | 查、增、改、物理删 | 显式业务字段一致；另继承 BaseEntity 属性 |
+| `train_student_checkin` | `TrainStudentCheckin` | `checkin_id` / `Long` | 查、增、改、物理删；generated keys | 显式业务字段一致；另继承 BaseEntity 属性 |
+| `train_score_info` | `TrainScoreInfo` | `score_id` / `Long` | 查、增、改、物理删；generated keys | 显式业务字段一致；另继承 BaseEntity 属性 |
+| `train_study_duration` | `TrainStudyDuration` | `dur_id` / `Long` | 查、增、改、物理删；generated keys | 显式业务字段一致；另继承 BaseEntity 属性 |
+| `train_student_portrait` | `TrainStudentPortrait` | `portrait_id` / `Long` | 查、增、改、物理删；generated keys | 显式业务字段一致；另继承 BaseEntity 属性 |
+
+“一致”仅指设计文档字段名与 Entity/Mapper 显式映射的静态比对，未验证真实 Kingbase 表结构、长度、默认值、约束和类型。
+
+### C. 代码中引用但设计文档没有的培训表
+
+在 `ruoyi-train/src/main/resources/mapper/train` 的当前 14 个 XML 中未发现此类表。旧知识图谱/天气前端页面调用的接口没有相应当前培训后端 Controller，不能据此认定存在业务表。
+
+### D. 设计文档存在但代码尚未实现的表
+
+以《学员管理系统数据表设计》列出的 14 张具体表为范围，未发现只在设计文档存在而完全没有 Entity/Mapper 的表。
+
+需要区分：需求与功能分析材料提出或暗示了参训关系、课次/课表、床位、设备同步流水等概念，但这些并不是该数据表设计文档中已经命名的表，因此不计入本节 D 类；它们作为领域缺口列在 `10_gap_and_conflict_analysis.md`。
+
+## 4. 字段与公共字段
+
+14 个 `Train*` Domain 全部 `extends BaseEntity`。`BaseEntity` 提供：`searchValue`、`createBy`、`createTime`、`updateBy`、`updateTime`、`remark`、`params`。
+
+当前培训设计和 Mapper 的实际使用方式并不完全统一：
+
+- 教师、学员、课程、计划、宿舍、宿舍权限、教室、场地、班牌显式定义 `createUser`，映射数据库 `create_user`；同时从 BaseEntity 继承 `createTime`、`updateTime`、`remark`。
+- 报到表只显式映射 `create_time`，没有 `create_user`、`update_time`、`remark`。
+- 签到表没有通用审计字段。
+- 成绩表使用 `import_time`，学习时长表使用 `sync_time`，画像表使用 `update_time`。
+- 培训表 Mapper 未使用 BaseEntity 的 `createBy`/`updateBy` 写入 `create_by`/`update_by`；业务表设计使用的是 `create_user`。
+- 部分 ServiceImpl 会设置 `createTime` 或 `updateTime`，但没有统一填充器；这不是 MyBatis-Plus 项目。
+
+因此，虽然所有实体继承 BaseEntity，不能据此认为所有培训表都具备完整一致的若依公共字段。
+
+## 5. 主键生成
+
+- 字符串业务主键：`t_id`、`s_id`、`c_id`、`plan_id`、`dorm_id`、`class_room_id`、`site_id`、`board_id`。Mapper 仅在属性非空时插入，没有 UUID/雪花算法等 Java 侧生成逻辑；前端表单需提供或数据库必须有另行默认值。
+- 数字主键：`auth_id`、`report_id`、`checkin_id`、`score_id`、`dur_id`、`portrait_id`。相应 XML 使用 `useGeneratedKeys="true"` 与 `keyProperty`。
+- 设计文档将数字主键写为 `INT AUTO_INCREMENT`。这属于 MySQL 表述；在 Kingbase 应由实际 identity/sequence 定义与驱动回填能力共同保证。本次未连接数据库，未验证生成键行为。
+
+## 6. 删除方式
+
+- 14 个培训 Mapper 的删除语句均为 `delete from train_*`，包括批量 `IN` 删除。
+- 培训 Domain 未发现 `delFlag`，设计文档也未为这些表定义 `del_flag`。
+- 因此当前培训 CRUD 是物理删除，不是若依系统表常用的逻辑删除。
+
+## 7. 外键与完整性
+
+设计文档在描述列中标注多处“外键”，但仓库没有培训 DDL，也没有 `FOREIGN KEY` 约束脚本。Mapper 采用单表 SQL，ServiceImpl 未见关联对象存在性检查、级联策略或事务编排。
+
+所以当前只能确认“字段表达了引用意图”，不能确认数据库中已创建外键、唯一索引或级联规则。
+
+## 8. SQL 初始化与迁移
+
+仓库中可见：
+
+- `RuoYi-Vue/sql/ry_20250522.sql`：若依系统表初始化，整体为 MySQL DDL/DML 风格。
+- `RuoYi-Vue/sql/quartz.sql`：Quartz 表脚本。
+
+未发现：
+
+- 14 张 `train_*` 表的可执行 DDL或种子数据。
+- 培训 `sys_menu`、角色和权限初始化 SQL。
+- Flyway、Liquibase 或其他版本化迁移目录/配置。
+
+设计 DOCX 只是表结构说明，不是可执行迁移。
+
+## 9. Kingbase 兼容性事实
+
+当前配置与代码同时存在以下待验证点：
+
+1. `application.yml` 固定 `pagehelper.helperDialect: mysql`。
+2. `ry_20250522.sql` 大量使用 `AUTO_INCREMENT`、`ENGINE=InnoDB`、反引号、MySQL 类型宽度和 `sysdate()`。
+3. 系统 Mapper 使用 `date_format(...)`、`find_in_set(...)`、`ifnull(...)` 和反引号列名，例如 `SysUserMapper.xml`、`SysDeptMapper.xml`、`SysMenuMapper.xml`。
+4. `DataScopeAspect` 动态拼接 `find_in_set`。
+5. 代码生成器读取 `information_schema` 时同时依赖 `current_database()` 以及 MySQL 的 `column_key`、`column_comment`、`extra='auto_increment'`、`column_type` 语义。
+6. 培训设计文档采用 `DATETIME`、`TINYINT`、`AUTO_INCREMENT` 和 `ON UPDATE CURRENT_TIMESTAMP`。
+7. 培训数字主键依赖 JDBC generated keys。
+8. Druid 校验 SQL 为 `SELECT 1 FROM DUAL`。
+
+这不等于所有语句在 Kingbase 必然失败，因为 Kingbase 可能启用兼容模式；但仓库没有记录目标兼容模式，也没有验证脚本/测试结果。不能把“已换驱动和 URL”视为完成数据库适配。
+
+## 10. `sys_*` 表当前如何被使用
+
+- `sys_user`：登录主体、个人资料、用户管理、角色/岗位关系。
+- `sys_role`：角色定义与数据范围类型。
+- `sys_menu`：菜单树、路由组件、权限字符串；`/getRouters` 动态返回前端路由。
+- `sys_role_menu`、`sys_user_role`：RBAC 关系。
+- `sys_dept`、`sys_role_dept`：部门树与数据权限。
+- `sys_oper_log`、`sys_logininfor`：操作与登录日志。
+- `sys_dict_*`、`sys_config`、`sys_notice`：字典、参数、公告。
+- `sys_job`、`sys_job_log`：Quartz 任务定义与执行日志。
+
+培训表当前未与 `sys_user` 建立代码层关系，培训 Service 也未应用若依数据权限切面。后续应在现有权限体系上增加培训关系和权限配置，不应修改系统表结构来复制一套登录/RBAC。

docs/codebase-audit/04_api_inventory.md

@@ -0,0 +1,112 @@
+# 培训接口盘点
+
+## 1. 总体结论
+
+在 `RuoYi-Vue/ruoyi-admin/src/main/java/com/ruoyi/web/controller/train/` 找到 14 个 Controller、84 个映射。每个模块严格重复 6 个端点：列表、导出、详情、新增、修改、删除。
+
+未发现培训业务动作接口、统计聚合接口、Excel 导入接口、外部设备/系统接入接口。`report`、`checkin`、`board`、`auth`、`duration`、`score` 的名称具有业务含义，但其 Controller 实现仍只是通用 CRUD。
+
+## 2. 实际接口
+
+| 模块 | Method | URL | Controller 方法 | 权限码 | 当前用途 |
+| --- | --- | --- | --- | --- | --- |
+| 教师 | GET | `/train/teacher/list` | `TrainTeacherController.list` | `system:teacher:list` | 纯CRUD：分页列表 |
+| 教师 | POST | `/train/teacher/export` | `export` | `system:teacher:export` | 纯CRUD：Excel导出 |
+| 教师 | GET | `/train/teacher/{tId}` | `getInfo` | `system:teacher:query` | 纯CRUD：详情 |
+| 教师 | POST | `/train/teacher` | `add` | `system:teacher:add` | 纯CRUD：新增 |
+| 教师 | PUT | `/train/teacher` | `edit` | `system:teacher:edit` | 纯CRUD：修改 |
+| 教师 | DELETE | `/train/teacher/{tIds}` | `remove` | `system:teacher:remove` | 纯CRUD：批量物理删除 |
+| 学员 | GET | `/train/student/list` | `TrainStudentController.list` | `system:student:list` | 纯CRUD：分页列表 |
+| 学员 | POST | `/train/student/export` | `export` | `system:student:export` | 纯CRUD：Excel导出 |
+| 学员 | GET | `/train/student/{sId}` | `getInfo` | `system:student:query` | 纯CRUD：详情 |
+| 学员 | POST | `/train/student` | `add` | `system:student:add` | 纯CRUD：新增 |
+| 学员 | PUT | `/train/student` | `edit` | `system:student:edit` | 纯CRUD：修改 |
+| 学员 | DELETE | `/train/student/{sIds}` | `remove` | `system:student:remove` | 纯CRUD：批量物理删除 |
+| 课程 | GET | `/train/course/list` | `TrainCourseController.list` | `system:course:list` | 纯CRUD：分页列表 |
+| 课程 | POST | `/train/course/export` | `export` | `system:course:export` | 纯CRUD：Excel导出 |
+| 课程 | GET | `/train/course/{cId}` | `getInfo` | `system:course:query` | 纯CRUD：详情 |
+| 课程 | POST | `/train/course` | `add` | `system:course:add` | 纯CRUD：新增 |
+| 课程 | PUT | `/train/course` | `edit` | `system:course:edit` | 纯CRUD：修改 |
+| 课程 | DELETE | `/train/course/{cIds}` | `remove` | `system:course:remove` | 纯CRUD：批量物理删除 |
+| 开班计划 | GET | `/train/plan/list` | `TrainClassPlanController.list` | `system:plan:list` | 纯CRUD：分页列表 |
+| 开班计划 | POST | `/train/plan/export` | `export` | `system:plan:export` | 纯CRUD：Excel导出 |
+| 开班计划 | GET | `/train/plan/{planId}` | `getInfo` | `system:plan:query` | 纯CRUD：详情 |
+| 开班计划 | POST | `/train/plan` | `add` | `system:plan:add` | 纯CRUD：新增 |
+| 开班计划 | PUT | `/train/plan` | `edit` | `system:plan:edit` | 纯CRUD：修改 |
+| 开班计划 | DELETE | `/train/plan/{planIds}` | `remove` | `system:plan:remove` | 纯CRUD：批量物理删除 |
+| 宿舍 | GET | `/train/dorminfo/list`；别名 `/train/dormitory/list` | `TrainDormitoryInfoController.list` | `system:info:list` | 纯CRUD：分页列表 |
+| 宿舍 | POST | `/train/dorminfo/export`；别名 `/train/dormitory/export` | `export` | `system:info:export` | 纯CRUD：Excel导出 |
+| 宿舍 | GET | `/train/dorminfo/{dormId}`；别名 `/train/dormitory/{dormId}` | `getInfo` | `system:info:query` | 纯CRUD：详情 |
+| 宿舍 | POST | `/train/dorminfo`；别名 `/train/dormitory` | `add` | `system:info:add` | 纯CRUD：新增 |
+| 宿舍 | PUT | `/train/dorminfo`；别名 `/train/dormitory` | `edit` | `system:info:edit` | 纯CRUD：修改 |
+| 宿舍 | DELETE | `/train/dorminfo/{dormIds}`；别名 `/train/dormitory/{dormIds}` | `remove` | `system:info:remove` | 纯CRUD：批量物理删除 |
+| 宿舍权限 | GET | `/train/auth/list` | `TrainDormAuthController.list` | `system:auth:list` | 纯CRUD：分页列表 |
+| 宿舍权限 | POST | `/train/auth/export` | `export` | `system:auth:export` | 纯CRUD：Excel导出 |
+| 宿舍权限 | GET | `/train/auth/{authId}` | `getInfo` | `system:auth:query` | 纯CRUD：详情 |
+| 宿舍权限 | POST | `/train/auth` | `add` | `system:auth:add` | 纯CRUD：新增授权记录；不下发设备 |
+| 宿舍权限 | PUT | `/train/auth` | `edit` | `system:auth:edit` | 纯CRUD：修改授权记录 |
+| 宿舍权限 | DELETE | `/train/auth/{authIds}` | `remove` | `system:auth:remove` | 纯CRUD：批量物理删除 |
+| 教室 | GET | `/train/classroominfo/list`；别名 `/train/classroom/list`、`/train/info/list` | `TrainClassroomInfoController.list` | `system:info:list` | 纯CRUD：分页列表 |
+| 教室 | POST | `/train/classroominfo/export`；同前缀别名 | `export` | `system:info:export` | 纯CRUD：Excel导出 |
+| 教室 | GET | `/train/classroominfo/{classRoomId}`；同前缀别名 | `getInfo` | `system:info:query` | 纯CRUD：详情 |
+| 教室 | POST | `/train/classroominfo`；同前缀别名 | `add` | `system:info:add` | 纯CRUD：新增 |
+| 教室 | PUT | `/train/classroominfo`；同前缀别名 | `edit` | `system:info:edit` | 纯CRUD：修改 |
+| 教室 | DELETE | `/train/classroominfo/{classRoomIds}`；同前缀别名 | `remove` | `system:info:remove` | 纯CRUD：批量物理删除 |
+| 实训场地 | GET | `/train/site/list` | `TrainTrainingSiteController.list` | `system:site:list` | 纯CRUD：分页列表 |
+| 实训场地 | POST | `/train/site/export` | `export` | `system:site:export` | 纯CRUD：Excel导出 |
+| 实训场地 | GET | `/train/site/{siteId}` | `getInfo` | `system:site:query` | 纯CRUD：详情 |
+| 实训场地 | POST | `/train/site` | `add` | `system:site:add` | 纯CRUD：新增 |
+| 实训场地 | PUT | `/train/site` | `edit` | `system:site:edit` | 纯CRUD：修改 |
+| 实训场地 | DELETE | `/train/site/{siteIds}` | `remove` | `system:site:remove` | 纯CRUD：批量物理删除 |
+| 开班报到 | GET | `/train/report/list` | `TrainClassReportController.list` | `system:report:list` | 纯CRUD：分页列表 |
+| 开班报到 | POST | `/train/report/export` | `export` | `system:report:export` | 纯CRUD：Excel导出 |
+| 开班报到 | GET | `/train/report/{reportId}` | `getInfo` | `system:report:query` | 纯CRUD：详情 |
+| 开班报到 | POST | `/train/report` | `add` | `system:report:add` | 纯CRUD：新增报到记录；非设备报到动作 |
+| 开班报到 | PUT | `/train/report` | `edit` | `system:report:edit` | 纯CRUD：修改记录 |
+| 开班报到 | DELETE | `/train/report/{reportIds}` | `remove` | `system:report:remove` | 纯CRUD：批量物理删除 |
+| 电子班牌 | GET | `/train/board/list` | `TrainElectronicBoardController.list` | `system:board:list` | 纯CRUD：分页列表 |
+| 电子班牌 | POST | `/train/board/export` | `export` | `system:board:export` | 纯CRUD：Excel导出 |
+| 电子班牌 | GET | `/train/board/{boardId}` | `getInfo` | `system:board:query` | 纯CRUD：详情 |
+| 电子班牌 | POST | `/train/board` | `add` | `system:board:add` | 纯CRUD：登记设备；非接入接口 |
+| 电子班牌 | PUT | `/train/board` | `edit` | `system:board:edit` | 纯CRUD：修改设备记录 |
+| 电子班牌 | DELETE | `/train/board/{boardIds}` | `remove` | `system:board:remove` | 纯CRUD：批量物理删除 |
+| 学员签到 | GET | `/train/checkin/list` | `TrainStudentCheckinController.list` | `system:checkin:list` | 纯CRUD：分页列表 |
+| 学员签到 | POST | `/train/checkin/export` | `export` | `system:checkin:export` | 纯CRUD：Excel导出 |
+| 学员签到 | GET | `/train/checkin/{checkinId}` | `getInfo` | `system:checkin:query` | 纯CRUD：详情 |
+| 学员签到 | POST | `/train/checkin` | `add` | `system:checkin:add` | 纯CRUD：新增记录；非设备签到协议 |
+| 学员签到 | PUT | `/train/checkin` | `edit` | `system:checkin:edit` | 纯CRUD：修改记录 |
+| 学员签到 | DELETE | `/train/checkin/{checkinIds}` | `remove` | `system:checkin:remove` | 纯CRUD：批量物理删除 |
+| 成绩 | GET | `/train/scoreinfo/list`；别名 `/train/score/list` | `TrainScoreInfoController.list` | `system:info:list` | 纯CRUD：分页列表 |
+| 成绩 | POST | `/train/scoreinfo/export`；别名 `/train/score/export` | `export` | `system:info:export` | 纯CRUD：Excel导出 |
+| 成绩 | GET | `/train/scoreinfo/{scoreId}`；别名 `/train/score/{scoreId}` | `getInfo` | `system:info:query` | 纯CRUD：详情 |
+| 成绩 | POST | `/train/scoreinfo`；别名 `/train/score` | `add` | `system:info:add` | 纯CRUD：新增；非批量导入/外部采集 |
+| 成绩 | PUT | `/train/scoreinfo`；别名 `/train/score` | `edit` | `system:info:edit` | 纯CRUD：修改 |
+| 成绩 | DELETE | `/train/scoreinfo/{scoreIds}`；别名 `/train/score/{scoreIds}` | `remove` | `system:info:remove` | 纯CRUD：批量物理删除 |
+| 学习时长 | GET | `/train/duration/list` | `TrainStudyDurationController.list` | `system:duration:list` | 纯CRUD：分页明细，不是统计聚合 |
+| 学习时长 | POST | `/train/duration/export` | `export` | `system:duration:export` | 纯CRUD：Excel导出 |
+| 学习时长 | GET | `/train/duration/{durId}` | `getInfo` | `system:duration:query` | 纯CRUD：详情 |
+| 学习时长 | POST | `/train/duration` | `add` | `system:duration:add` | 纯CRUD：新增；非外部上报接口 |
+| 学习时长 | PUT | `/train/duration` | `edit` | `system:duration:edit` | 纯CRUD：修改 |
+| 学习时长 | DELETE | `/train/duration/{durIds}` | `remove` | `system:duration:remove` | 纯CRUD：批量物理删除 |
+| 学员画像 | GET | `/train/portrait/list` | `TrainStudentPortraitController.list` | `system:portrait:list` | 纯CRUD：分页列表，不生成画像 |
+| 学员画像 | POST | `/train/portrait/export` | `export` | `system:portrait:export` | 纯CRUD：Excel导出 |
+| 学员画像 | GET | `/train/portrait/{portraitId}` | `getInfo` | `system:portrait:query` | 纯CRUD：详情 |
+| 学员画像 | POST | `/train/portrait` | `add` | `system:portrait:add` | 纯CRUD：手工新增画像记录 |
+| 学员画像 | PUT | `/train/portrait` | `edit` | `system:portrait:edit` | 纯CRUD：修改记录 |
+| 学员画像 | DELETE | `/train/portrait/{portraitIds}` | `remove` | `system:portrait:remove` | 纯CRUD：批量物理删除 |
+
+## 3. 接口类型统计
+
+| 类型 | 数量 | 结论 |
+| --- | ---: | --- |
+| 纯 CRUD/导出接口 | 84 | 14 组 × 6 个 |
+| 业务动作接口 | 0 | 未发现开班、报到确认、补签审批、成绩发布、画像生成等动作 |
+| 外部系统接入接口 | 0 | 未发现设备心跳、签到回调、门锁下发回执、学习记录/成绩采集 |
+| 统计接口 | 0 | 前端成绩视图仍调用普通列表；学习时长 Controller 也只返回明细分页 |
+| 培训导入接口 | 0 | 只有若依 `SysUserController` 有系统用户导入 |
+
+## 4. 需要注意的映射现状
+
+- 教室、宿舍、成绩 Controller 的多前缀别名属于当前未提交改动。
+- 教室页面当前使用 `api/train/info.js`；另有未跟踪 `classroom.js`，形成两个 API 命名入口。
+- 前端多数按钮权限使用 `train:*`，后端使用 `system:*`；宿舍、教室、成绩后端甚至共享 `system:info:*`。这会直接影响非超级管理员访问。

docs/codebase-audit/05_frontend_inventory.md

@@ -0,0 +1,72 @@
+# 培训前端现状
+
+## 1. 前端入口与路由机制
+
+当前培训业务前端是 `build_ui/`：`package.json` 的 description 为“智慧培训管理平台”，`src/views/train` 和 `src/api/train` 均位于此处。
+
+`build_ui/src/router/index.js` 没有静态培训菜单，只包含登录、首页、个人中心和若依少量隐藏动态路由。登录后，`build_ui/src/store/modules/permission.js` 调用 `build_ui/src/api/menu.js` 的 `GET /getRouters`，按后端 `sys_menu` 数据加载组件。
+
+因此：
+
+- 仓库代码可以确认“页面文件存在”。
+- 仓库不能确认“当前数据库菜单存在且角色已授权”。
+- `RuoYi-Vue/sql/ry_20250522.sql` 未发现任何 `train` 菜单/权限数据，精确菜单名称和路径只能通过实时 `sys_menu` 再核验。
+
+## 2. 页面与 API 对照
+
+表中的“菜单”表示该页面预期承载的功能名称，不表示已在实时 `sys_menu` 中确认。
+
+| 菜单/功能 | 页面路径 | API | 当前完成度 | 备注 |
+| --- | --- | --- | --- | --- |
+| 教师信息 | `views/train/teacher/index.vue` | `api/train/teacher.js` → `/train/teacher` | CRUD页面存在，接通未证实 | 有列表/详情/增改删/导出；按钮用 `train:teacher:*`，后端用 `system:teacher:*` |
+| 学员信息 | `views/train/student/index.vue` | `api/train/student.js` → `/train/student` | CRUD页面存在，接通未证实 | 同类权限不一致；无培训学员导入 |
+| 课程信息 | `views/train/course/index.vue` | `api/train/course.js` → `/train/course` | CRUD页面存在，接通未证实 | 附件/资源仍为文本输入 |
+| 开班计划 | `views/train/plan/index.vue` | `api/train/plan.js` → `/train/plan` | CRUD页面存在，接通未证实 | 不是课表或班级工作台 |
+| 宿舍信息 | `views/train/dormitory/index.vue` | `api/train/dormitory.js` → `/train/dorminfo` | 部分存在 | 页面已修改、API未跟踪；无按钮权限与导出按钮 |
+| 宿舍权限 | `views/train/auth/index.vue` | `api/train/auth.js` → `/train/auth` | CRUD页面存在，接通未证实 | 仅维护授权记录，不调用门锁系统 |
+| 教室信息 | `views/train/classroom/index.vue` | 实际用 `api/train/info.js` → `/train/classroominfo` | CRUD页面存在，接通未证实 | `info.js`已修改；另有未跟踪`classroom.js`；别名未提交 |
+| 实训场地 | `views/train/site/index.vue` | `api/train/site.js` → `/train/site` | CRUD页面存在，接通未证实 | 配套设备为文本字段 |
+| 开班报到 | `views/train/report/index.vue` | `api/train/report.js` → `/train/report` | CRUD页面存在，接通未证实 | 表单手工录入，不是现场报到工作台 |
+| 电子班牌 | `views/train/board/index.vue` | `api/train/board.js` → `/train/board` | CRUD页面存在，接通未证实 | 设备登记，不含心跳/内容发布/签到回调 |
+| 学员签到 | `views/train/checkin/index.vue` | `api/train/checkin.js` → `/train/checkin` | CRUD页面存在，接通未证实 | 手工维护签到记录，无课次和设备流程 |
+| 成绩信息 | `views/train/score/index.vue` | `api/train/score.js` → `/train/scoreinfo` | 部分存在 | 页面/API未跟踪；无权限指令与导出入口 |
+| 学习时长 | `views/train/duration/index.vue` | `api/train/duration.js` → `/train/duration` | CRUD页面存在，接通未证实 | 是明细 CRUD，不是聚合统计工作台 |
+| 学员画像 | `views/train/portrait/index.vue` | `api/train/portrait.js` → `/train/portrait` | CRUD页面存在，接通未证实 | 编辑指标/文本的表格，无画像计算和可视化 |
+| 学员成绩档案 | `views/train/student-score/index.vue` | `api/train/score.js` 的列表 | 只读筛选页，未跟踪 | 按学号过滤同一 CRUD 列表，无专用统计接口 |
+| 课程成绩总览 | `views/train/course-score/index.vue` | `api/train/score.js` 的列表 | 只读筛选页，未跟踪 | “综合评级”仅按 `examScore` 前端判断，不是三类成绩综合算法 |
+| 自主学习设备 | `views/train/equipment/index.vue` | 无 | 占位页，未跟踪 | 文案宣称部分能力“已就绪”，代码没有相应设备接入 |
+| 设备物联管理 | `views/train/extra/index.vue` | 无 | 占位页，未跟踪 | 仅 `el-result` 与跳转按钮 |
+| 人物/人员页面 | `views/train/person/index.vue` | 使用旧角色/图谱相关逻辑 | 遗留页面 | 权限为 `train:role:*`，无对应当前培训 Controller |
+| 图谱页面 | `views/train/character/graph.vue` | `api/train/character.js` | 遗留/未接通 | 当前后端未找到对应培训 Controller |
+| 图表示例 | `views/train/character/charts.vue` | 旧接口/本地数据 | 演示性质 | 含 ECharts、随机数和历史地址，不能视为培训统计已实现 |
+| 时间地点分析 | `views/train/analysis/timeAndAddress.vue` | 旧逻辑 | 遗留/未接通 | 无当前培训统计 Controller 对应 |
+| 天气 | `views/train/weather/index.vue` | 旧逻辑 | 遗留/未接通 | 与 14 张培训表无对应关系 |
+
+所有路径相对于 `build_ui/src/`。
+
+## 3. 用户要求的页面能力确认
+
+| 能力 | 结论 | 依据 |
+| --- | --- | --- |
+| 已有哪些菜单 | 无法从仓库确认实时菜单；路由由 `/getRouters` + `sys_menu` 动态生成 | `router/index.js`、`store/modules/permission.js`、`api/menu.js`；系统 SQL无train菜单 |
+| 页面调用哪个 API | 14个主要页面都有对应API文件；教室实际使用`info.js` | 页面 import 与 `src/api/train/*.js` |
+| 页面是否只是 CRUD | 14个核心业务页本质均为 CRUD；两个成绩衍生页只是列表筛选 | 页面 methods 与后端 Controller |
+| 业务工作台 | 不存在 | 首页 `views/index.vue` 仅展示平台名称、版本和图片 |
+| 统计图 | 培训业务统计图未实现 | `dashboard/*Chart.vue` 是若依示例；`character/charts.vue` 含随机/旧数据且无培训统计API |
+| 画像 | 只有画像记录 CRUD | `views/train/portrait/index.vue` |
+| 模拟设备页面 | 没有可运行模拟设备；只有设备管理 CRUD、遗留图表和两个占位页 | `board`、`equipment`、`extra` |
+| 报到页面 | 有，但只是报到记录 CRUD | `views/train/report/index.vue` |
+| 课程表页面 | 未发现 | `views/train`、router 与 API 搜索无 timetable/schedule/课程表实现 |
+
+## 4. 权限与前端接通风险
+
+大多数生成页面的按钮写成 `v-hasPermi="['train:<module>:<action>']"`，而对应 Controller 使用 `system:<module>:<action>`。教室页面用 `train:info:*`，宿舍/教室/成绩后端共用 `system:info:*`；宿舍与成绩当前页面又没有按钮权限指令。
+
+超级管理员因若依通配权限可能掩盖此问题，但普通角色可能出现：菜单能见而按钮隐藏、按钮可见而请求被 403、三个模块共享过宽权限等现象。实际结果还取决于实时 `sys_menu.perms`，本次没有查询数据库。
+
+## 5. 当前工作树状态对前端基线的影响
+
+- `score.js`、成绩 CRUD 页面、学生成绩页、课程成绩页、两个占位页均未跟踪。
+- `dormitory/index.vue` 已修改，`dormitory.js` 未跟踪。
+- `info.js` 与 `vue.config.js` 已修改未提交。
+- 因此当前文件系统能看到的页面能力高于最近一次提交 `83797f92` 中可复现的能力；在提交或交接前应先明确哪些文件属于正式基线。

docs/codebase-audit/06_security_and_permissions.md

@@ -0,0 +1,107 @@
+# 权限与账号体系
+
+## 1. 登录机制
+
+当前使用若依标准的 Spring Security + JWT + Redis 登录链路：
+
+1. `SysLoginController.login` 接收 `LoginBody`，调用 `SysLoginService.login`。
+2. `SysLoginService` 通过 `AuthenticationManager` 完成用户名/密码认证，底层使用 `UserDetailsServiceImpl` 加载 `sys_user`。
+3. 密码使用 `BCryptPasswordEncoder`；密码重试与锁定由 `SysPasswordService` 配合 Redis 缓存处理。
+4. `TokenService.createToken` 生成 UUID，将完整 `LoginUser` 存入 Redis，并用 JJWT 生成 token。
+5. 客户端在 `Authorization` 请求头携带 token；`JwtAuthenticationTokenFilter` 解析后把认证对象放入 Spring SecurityContext。
+6. `SecurityConfig` 配置无状态会话，除白名单外的请求都需认证，并启用方法级权限。
+
+代码依据：
+
+- `RuoYi-Vue/ruoyi-admin/src/main/java/com/ruoyi/web/controller/system/SysLoginController.java`
+- `RuoYi-Vue/ruoyi-framework/src/main/java/com/ruoyi/framework/web/service/SysLoginService.java`
+- `RuoYi-Vue/ruoyi-framework/src/main/java/com/ruoyi/framework/web/service/TokenService.java`
+- `RuoYi-Vue/ruoyi-framework/src/main/java/com/ruoyi/framework/security/filter/JwtAuthenticationTokenFilter.java`
+- `RuoYi-Vue/ruoyi-framework/src/main/java/com/ruoyi/framework/config/SecurityConfig.java`
+
+当前 `SysLoginService.login` 中验证码校验调用被注释掉；虽然 `/captchaImage`、配置项和缓存代码仍存在，实际登录服务当前不执行 `validateCaptcha`。这应在继续开发前作为当前事实确认，而不能只看登录页面是否显示验证码。
+
+## 2. `sys_user`、`sys_role`、`sys_menu`
+
+- `sys_user` 是认证主体，关联部门、岗位与角色；`SysUserMapper.xml`、`SysUserServiceImpl` 和 `SysUserController` 保留完整管理能力。
+- `sys_role` 定义角色键、状态、菜单权限及 `data_scope`；通过 `sys_user_role` 关联用户，通过 `sys_role_menu` 关联菜单。
+- `sys_menu` 同时承载目录/菜单/按钮、前端路由组件和 `perms` 权限字符串。`SysLoginController.getRouters` 调用 `SysMenuService.buildMenus` 返回动态路由。
+- 初始化 SQL 只有若依内置 admin/common 角色及系统菜单；没有仓库内培训菜单 SQL。
+
+## 3. 权限字符串如何定义和校验
+
+后端 Controller 通过：
+
+```java
+@PreAuthorize("@ss.hasPermi('system:teacher:list')")
+```
+
+调用 Spring Bean `ss` 的 `PermissionService.hasPermi`。当前登录用户的权限集合由 `SysPermissionService.getMenuPermission` 从角色/菜单关系加载，管理员获得通配权限。前端 `v-hasPermi` 指令按相同字符串决定按钮显示。
+
+问题在于培训权限没有统一：
+
+- 后端 14 组使用 `system:teacher:*`、`system:student:*` 等 `system:*` 前缀。
+- 前端生成页面普遍使用 `train:teacher:*`、`train:student:*` 等 `train:*` 前缀。
+- 宿舍、教室、成绩三个后端 Controller 共用 `system:info:*`，权限粒度互相重叠。
+- 宿舍和成绩当前页面没有按钮权限指令。
+- 仓库没有培训 `sys_menu.perms` 数据可用于裁决哪一侧才是既定规范。
+
+因此培训权限对超级管理员可能表面可用，对普通角色则很可能不能按预期工作。
+
+## 4. 数据权限
+
+若依数据权限框架存在：
+
+- `@DataScope` 注解。
+- `DataScopeAspect` 根据角色的 `data_scope` 拼接部门/本人范围 SQL。
+- `SysRole` 保存数据范围配置。
+
+当前 `@DataScope` 只在若依系统域的 `SysUserServiceImpl`、`SysRoleServiceImpl`、`SysDeptServiceImpl` 等位置使用；`ruoyi-train` 未发现 `@DataScope`，培训 Mapper SQL也没有部门、教师或班级范围条件。
+
+所以“数据权限能力可复用”成立，“培训数据已经受数据权限保护”不成立。
+
+## 5. 教师、学员与账号关联
+
+- `TrainTeacher` 没有 `userId`/用户名字段，Mapper 不查询 `sys_user`。
+- `TrainStudent` 同样没有 `userId`/用户名字段。
+- `train_class_plan` 只有 `t_id`，表示计划中的授课教师工号；没有将当前登录 `sys_user` 映射到 `t_id` 的关系。
+- 培训 Service/Mapper 没有基于当前登录人过滤计划、学员、成绩或签到。
+
+结论：当前没有“教师只能查看自己所带班级”的实现，也没有学员只能查看本人数据的实现。
+
+## 6. 操作日志
+
+若依 `@Log` + `LogAspect` + 异步日志组件保留。培训 Controller 对以下动作加了日志：
+
+- Excel 导出：`BusinessType.EXPORT`
+- 新增：`INSERT`
+- 修改：`UPDATE`
+- 删除：`DELETE`
+
+可记录的主要内容包括业务标题、业务类型、HTTP 方法、请求 URI、操作者、部门、IP、请求参数、返回结果、成功/失败状态、错误消息和耗时，并写入 `sys_oper_log`。
+
+培训列表/详情读取通常没有 `@Log`。现有日志是接口操作记录，不是领域审计轨迹；没有修改前快照、字段级差异、报到/设备下发状态机流水或外部请求/回执详情。
+
+代码依据：`LogAspect.java`、`SysOperLog.java`、`AsyncFactory.java` 及 14 个培训 Controller。
+
+## 7. 导入导出权限
+
+- 若依系统用户模块支持 `system:user:import`、`system:user:export`，并提供导入模板。
+- `ExcelUtil` 是通用能力，可被培训模块复用。
+- 14 个培训 Controller 都有后端 Excel 导出接口与 `*:export` 权限；多数前端页面也有导出按钮。
+- 培训模块没有任何导入接口、导入模板接口或 `*:import` 权限。成绩的 `source_type=2 Excel批量导入` 只是字段枚举含义，不代表导入功能存在。
+
+## 8. 是否需要重造权限系统
+
+不需要。现有若依登录、用户、角色、菜单、按钮权限、数据权限与日志框架应直接复用。
+
+继续开发需要在现有体系内补齐培训权限：统一权限命名；向 `sys_menu` 增加培训目录、页面和按钮权限；建立 `sys_user` 与教师/学员业务身份关系；明确教师、学员和管理员的数据范围规则；在培训查询入口应用数据权限或业务范围过滤。以上是后续设计方向，本次未修改任何系统表或代码。
+
+## 9. 需要进一步确认的安全运行配置
+
+- JWT secret、数据库账号口令和 Druid 控制台口令目前以明文配置存在；本报告不复述具体值。
+- 登录页当前有未提交的默认口令改动。
+- 验证码校验在登录服务中被注释。
+- `SecurityConfig` 对上传资源路径存在匿名 GET 配置，需与实际公开文件范围共同评审。
+
+这些事实会影响上线基线，但本次审计没有自动修复。

docs/codebase-audit/07_runtime_and_environment.md

@@ -0,0 +1,103 @@
+# 启动方式与运行环境
+
+> 本次只整理配置和现有脚本，没有启动 Redis、后端、前端或数据库，没有执行 Maven/npm 构建。
+
+## 1. 后端启动
+
+### 现有方式
+
+- Spring Boot 入口：`RuoYi-Vue/ruoyi-admin/src/main/java/com/ruoyi/RuoYiApplication.java`。
+- Maven 父工程：`RuoYi-Vue/pom.xml`；可按 Maven 多模块方式构建 `ruoyi-admin`，但本次没有执行，因为会产生/更新 `target`。
+- 当前工作树已有 `RuoYi-Vue/ruoyi-admin/target/ruoyi-admin.jar`。
+- 未跟踪脚本 `start-local.sh` 会用以下方式启动现有 JAR：
+
+```text
+java --add-opens ... -jar RuoYi-Vue/ruoyi-admin/target/ruoyi-admin.jar
+```
+
+脚本将日志写到 `RuoYi-Vue/ruoyi-admin/backend.log`，并检查 `http://localhost:8090/captchaImage`。
+
+### 默认端口与上下文
+
+- 后端 HTTP 端口：`8090`。
+- context path：`/`。
+- 配置文件：`RuoYi-Vue/ruoyi-admin/src/main/resources/application.yml`。
+
+## 2. 前端启动
+
+当前培训前端目录：`build_ui/`。
+
+`build_ui/package.json` 定义：
+
+```text
+npm run dev         # vue-cli-service serve
+npm run build:prod  # 生产构建
+npm run build:stage # staging 构建
+npm run lint        # ESLint；配置含 --fix，会修改文件，本次未执行
+```
+
+当前 `build_ui/node_modules/.bin/vue-cli-service` 存在。`build_ui/vue.config.js` 当前开发端口为 `8080`，代理 `/dev-api` 到 `http://localhost:8090` 并移除前缀。
+
+`start-local.sh` 会先探测 8080；若未启动则在 `build_ui` 执行 `npm run dev`。该脚本会启动服务、创建目录并写日志，因此本次没有执行。
+
+## 3. 数据库连接
+
+| 项目 | 当前配置 |
+| --- | --- |
+| 配置文件 | `RuoYi-Vue/ruoyi-admin/src/main/resources/application-druid.yml` |
+| 数据库 | KingbaseES |
+| 驱动 | `com.kingbase8.Driver` / Maven `com.kingbase:kingbase8:8.6.0` |
+| 数据库与 schema | `training` / `public` |
+| 连接池 | Druid |
+| 校验 SQL | `SELECT 1 FROM DUAL` |
+
+主机、端口、用户名和口令直接写在配置文件中，没有通过环境变量注入；本报告不复述凭据。文件中还保留多组已注释的 MySQL/Kingbase历史连接信息。
+
+## 4. Redis 要求
+
+- 配置文件：`application.yml`。
+- 当前地址：`localhost:6379`，database 0，无密码配置。
+- 本机检测到 `/opt/homebrew/bin/redis-server`。
+- Redis 用于 token 会话、登录状态续期、验证码缓存、密码错误计数、系统缓存和在线用户，因此正常登录链路需要 Redis。
+- `start-local.sh` 会通过 `redis-cli ping` 探测并在需要时以 daemon 方式启动 Redis；本次未执行。
+
+## 5. Profile 与环境文件
+
+### 后端
+
+- `spring.profiles.active: druid`。
+- 存在 `application.yml` 与 `application-druid.yml`。
+- 未发现独立的 `application-dev.yml`、`application-test.yml`、`application-prod.yml`。
+- `application-druid.yml` 内通过注释区分开发/生产连接，并非可切换的 Spring profile。
+
+### 前端
+
+| 模式 | 文件 | API 前缀 |
+| --- | --- | --- |
+| development | `build_ui/.env.development` | `/dev-api` |
+| staging | `build_ui/.env.staging` | `/stage-api` |
+| production | `build_ui/.env.production` | `/prod-api` |
+
+开发代理只对当前 `VUE_APP_BASE_API` 生效；生产/测试部署需要由外部 Web 服务器或网关将相应前缀转发到后端，仓库中未见完整部署配置。
+
+## 6. 环境变量
+
+- 后端 datasource、Redis、JWT secret 等均来自 YAML 固定值；未发现必须由操作系统提供的业务环境变量。
+- 前端通过 `.env.*` 注入 `VUE_APP_TITLE`、`VUE_APP_BASE_API`、`ENV`，开发模式还设置 `VUE_CLI_BABEL_TRANSPILE_MODULES`。
+- `vue.config.js` 可通过 `port` 或 `npm_config_port` 覆盖前端端口。
+
+## 7. 当前机器工具链
+
+| 工具 | 当前机器版本 | 项目目标/声明 | 说明 |
+| --- | --- | --- | --- |
+| Java | OpenJDK 21.0.2 | POM target/source 1.8 | 版本跨度较大；现有脚本加了若干 `--add-opens` |
+| Maven | 3.9.2 | 未单独锁定 wrapper | 来自 IntelliJ 内置 Maven 路径 |
+| Node | 22.23.2 | `>=8.9` | `vue.config.js` 有未提交 MD4 兼容补丁 |
+| npm | 10.9.8 | `>=3.0.0` | 依赖目录存在，本次未安装/更新 |
+| Redis Server | Homebrew 路径存在 | localhost:6379 | 本次未探测运行状态 |
+
+## 8. 当前启动可验证程度
+
+仓库内有后端 JAR和前端依赖，但不能据此确认它们与当前未提交源码一致。尤其当前源码有 Controller 路径、前端 API、端口和配置改动；现有 JAR可能早于这些修改。
+
+本次未执行启动、健康检查、登录、API 调用或数据库查询，所以运行状态标记为“未验证”。

docs/codebase-audit/08_git_status.md

@@ -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。

docs/codebase-audit/09_reusable_ruoyi_capabilities.md

@@ -0,0 +1,57 @@
+# 可复用的若依能力
+
+## 1. 分类结果
+
+| 能力 | 分类 | 当前代码依据 | 培训业务现状 |
+| --- | --- | --- | --- |
+| 登录 | 可以直接复用 | `SysLoginController`、`SysLoginService`、`UserDetailsServiceImpl` | 登录链路完整；验证码校验当前被注释，运行仍需核验 |
+| RBAC | 可以直接复用 | `sys_user`、`sys_role`、用户角色/角色菜单 Mapper与Service | 无需另建账号角色系统 |
+| 菜单权限 | 需要扩展 | `SysMenuController`、`SysMenuServiceImpl`、`GET /getRouters` | 框架可复用；仓库无培训菜单初始化数据 |
+| 按钮权限 | 需要扩展 | 后端 `@PreAuthorize("@ss.hasPermi(...)")`、前端 `v-hasPermi` | 训练前后端权限前缀不一致，三个模块共用`system:info:*` |
+| 操作日志 | 可以直接复用 | `@Log`、`LogAspect`、`SysOperLog`、异步日志管理 | 培训增改删/导出已标注；业务状态轨迹仍需扩展 |
+| 数据权限 | 需要扩展 | `@DataScope`、`DataScopeAspect`、角色`data_scope` | 培训 Service/Mapper 尚未接入，教师/学员范围不存在 |
+| 字典 | 可以直接复用 | `SysDictTypeController`、`SysDictDataController`、前端字典组件 | 培训状态字段目前多为数字输入/注释，未见业务字典SQL |
+| 定时任务 | 需要扩展 | `ruoyi-quartz`、`SysJobController`、`sys_job`、`quartz.sql` | 框架保留；未见培训任务，如授权失效/设备离线/画像刷新 |
+| 文件上传 | 可以直接复用 | `CommonController` 的 `/common/upload`、`/common/uploads`、下载接口；前端上传组件 | 课程附件字段尚未与上传结果建立结构化业务关系 |
+| Excel 导入 | 需要扩展 | `ExcelUtil`、`SysUserController.importData/importTemplate` | 通用能力存在；培训无导入 Controller/权限/错误处理 |
+| Excel 导出 | 可以直接复用 | `ExcelUtil`、培训14个Controller的`/export` | 后端全部存在；宿舍/成绩当前页面无导出入口 |
+| 分页 | 可以直接复用 | `BaseController.startPage`、PageHelper、`TableDataInfo` | 14个列表全部使用；Kingbase方言配置仍需确认 |
+| 统一返回格式 | 可以直接复用 | `AjaxResult`、`TableDataInfo`、`BaseController.toAjax` | 培训 Controller 已使用 |
+| 异常处理 | 可以直接复用 | `GlobalExceptionHandler`、认证/业务异常体系 | 通用能力存在；培训尚少领域校验，因此领域错误语义不足 |
+| 代码生成 | 需要进一步确认 | `ruoyi-generator`、`GenController`、Velocity模板 | 模块完整，但元数据查询含 MySQL 语义，Kingbase可用性未验证 |
+| 系统配置 | 可以直接复用 | `SysConfigController/Service/Mapper`、`sys_config` | 可保存培训参数；不应代替领域表 |
+| 通知 | 需要扩展 | `SysNoticeController`、`sys_notice` | 当前是通知公告 CRUD，不是站内信/短信/设备推送工作流 |
+
+## 2. 直接复用时的边界
+
+### 登录与账号
+
+复用 `sys_user`、`sys_role`、`sys_menu` 和现有 token，不再建设第二套用户名密码、角色菜单或登录页面。培训身份需要新增业务关联，而不是复制系统账号表。
+
+### 权限
+
+若依权限机制本身完整，但培训权限数据和命名尚未形成可复现基线。应先确认统一的 `train:<resource>:<action>` 或既有命名，再配置菜单/按钮；当前 `system:*` 与 `train:*` 并存不能视为已接通。
+
+### 日志
+
+现有 `@Log` 足以覆盖管理端接口操作。设备下发、回调、报到、成绩发布等需要可追溯状态时，应在领域内扩展业务流水；不要把 `sys_oper_log` 当作所有业务状态历史。
+
+### 数据权限
+
+现有框架适合部门/本人范围，但“教师只能看所带班级”“学员只能看本人”依赖教师/学员与 `sys_user` 的映射及参训/授课关系。当前模型没有这些关系，不能只加一个 `@DataScope` 就完成。
+
+### Excel
+
+培训实体已有 `@Excel` 注解，导出接口已生成。导入还需要模板、字段校验、错误行反馈、重复策略、事务边界和权限；成绩/学员字段中的“可导入”描述不是实现。
+
+### 文件
+
+通用上传下载已经具备。课程的文档/视频/模型字段目前只是字符串，应先决定复用上传后的相对路径、资源 ID或专门资源表，然后再接业务流程。
+
+### 定时任务
+
+Quartz 管理和日志可直接承载未来任务，但仓库尚无培训 Job。后续若需要授权到期、设备离线检测、画像周期计算或同步重试，可以扩展现有 `ruoyi-quartz`，无需新增调度平台。
+
+## 3. 静态存在与运行正常的区别
+
+上述分类说明代码层是否可复用，不代表已在当前 Kingbase实例和当前未提交前端上运行验证。尤其 PageHelper方言、系统 Mapper SQL、代码生成器元数据 SQL、培训菜单权限和业务表实存状态都需要先验证。

docs/codebase-audit/10_gap_and_conflict_analysis.md

@@ -0,0 +1,303 @@
+# 当前实现与未来业务设计的冲突点
+
+> 本文件只报告基于当前代码能确认的模型/接通冲突，不提供重构代码，也不假定未入库系统的行为。
+
+## 1. 开班计划只能直接挂一个课程和一个教师
+
+**当前实现**  
+`TrainClassPlan`/`train_class_plan` 只有一个 `c_id` 和一个 `t_id`，Mapper 为单表 CRUD。
+
+↓
+
+**潜在问题**  
+一个培训班无法表达多门课程、多名教师、课程顺序和每次上课的时间地点。
+
+↓
+
+**可能影响哪些业务**  
+课程表、教师排课、教室/场地冲突检查、按课次签到、课程成绩和班级统计。
+
+## 2. 没有参训/报名关系
+
+**当前实现**  
+学员是独立主数据；报到、签到、成绩、时长、画像各自直接保存 `student_id + plan_id`。代码与表设计中没有 enrollment/plan_student/班级学员关系。
+
+↓
+
+**潜在问题**  
+无法明确某学员是否被录取、退训、结业或属于哪一期培训，也无法以一份稳定名单约束后续记录。
+
+↓
+
+**可能影响哪些业务**  
+报名审核、班级花名册、报到资格、住宿分配、签到名单、成绩发布、结业证书与教师数据权限。
+
+## 3. 签到没有课次实体
+
+**当前实现**  
+`train_student_checkin` 有 `plan_id`、`c_id`、`lesson_start_time`、`lesson_end_time`，但没有 `lesson_id`；每条学生签到重复保存课次时间。
+
+↓
+
+**潜在问题**  
+无法稳定标识一次上课，课程时间调整会产生历史不一致，也难以建立“一人一课次一次有效签到”的唯一规则。
+
+↓
+
+**可能影响哪些业务**  
+课程表、二维码签到、设备签到幂等、迟到/早退判断、补签、按课次出勤统计。
+
+## 4. 学员模型偏高校学籍，缺少培训账号和身份信息
+
+**当前实现**  
+`TrainStudent` 主要字段是院系、专业、班级、学号；没有 `sys_user` 关联、身份证、人脸特征/资源、人员状态或来源单位等代码字段。
+
+↓
+
+**潜在问题**  
+业务身份与登录身份无法对应，现场报到和门锁人脸授权的数据来源不完整；非高校培训场景也难以表达。
+
+↓
+
+**可能影响哪些业务**  
+学员登录、自助查询、现场报到、门禁授权、教师查看班级、跨单位培训。
+
+## 5. 教师模型不能支撑账号、资质和授课范围
+
+**当前实现**  
+`TrainTeacher` 只有工号、姓名、院系、职称、联系方式等基础字段；没有 `sys_user` 关联、启停状态、资质证书、可授课程关系。计划只保存一个 `t_id`。
+
+↓
+
+**潜在问题**  
+无法从当前登录用户确定教师身份，也无法约束其可查看班级或可教授课程。
+
+↓
+
+**可能影响哪些业务**  
+教师工作台、教师数据权限、排课、资质审查、课程授权。
+
+## 6. 宿舍只有房间聚合，没有独立床位
+
+**当前实现**  
+`train_dormitory_info` 保存 `bed_total` 和 `bed_used`；`bed_no` 只作为 `train_dorm_auth` 的自由文本字段存在。
+
+↓
+
+**潜在问题**  
+无法可靠管理每张床的状态、性别/房间约束、占用唯一性、维修与预留；`bed_used` 容易与授权记录不一致。
+
+↓
+
+**可能影响哪些业务**  
+自动分房、床位冲突、容量统计、换房、退宿、住宿看板。
+
+## 7. 住宿分配与门锁人脸授权耦合
+
+**当前实现**  
+`train_dorm_auth` 同时保存学员住宿位置、床位号、授权起止时间和 `face_sync_status`。
+
+↓
+
+**潜在问题**  
+业务住宿事实与设备同步状态无法独立演进；没有下发流水、重试次数、失败原因、设备回执和撤权记录。
+
+↓
+
+**可能影响哪些业务**  
+分房、换房、门禁下发、失败补偿、到期撤权、审计追踪。
+
+## 8. 报到记录同时承担资源分配
+
+**当前实现**  
+`train_class_report` 同一行保存报到事件及 `alloc_dorm_id`、`alloc_classroom_id`、`alloc_site_id`。Service 只是单表新增/修改，没有事务编排。
+
+↓
+
+**潜在问题**  
+一次报到被迫绑定三类资源，无法记录多次尝试、资源调整或单独失败，也没有容量和冲突校验。
+
+↓
+
+**可能影响哪些业务**  
+现场报到、住宿分配、教室/场地调度、设备异常恢复、操作审计。
+
+## 9. 成绩固定三列且没有计算/发布规则
+
+**当前实现**  
+`train_score_info` 固定为 `course_score`、`train_score`、`exam_score`；没有权重、规则版本、综合分、发布状态或审批字段。未跟踪的课程成绩页只按 `examScore` 显示“综合评级”。
+
+↓
+
+**潜在问题**  
+无法解释综合结果，课程差异化考核和规则变更会直接影响历史成绩可追溯性；页面名称可能造成错误理解。
+
+↓
+
+**可能影响哪些业务**  
+成绩导入、综合成绩、排名、补考、结业判定、画像和报表。
+
+## 10. “成绩可导入/外部采集”目前只是字段枚举
+
+**当前实现**  
+`source_type` 注释包含手工、Excel、外部接口，但培训 Controller 只有单条 CRUD和导出，没有导入、回调或批处理接口。
+
+↓
+
+**潜在问题**  
+数据来源字段会被人工填写，却没有与真实采集渠道、批次、错误行和幂等键绑定。
+
+↓
+
+**可能影响哪些业务**  
+Excel 批量导入、VR/3D/实操系统对接、数据追溯、重复数据处理。
+
+## 11. 学习时长“统计”仍是人工可编辑明细
+
+**当前实现**  
+`train_study_duration` 同时存起止时间和 `study_seconds`；Controller 可手工增改删，未见计算校验、外部事件 ID、同步状态或汇总 SQL。
+
+↓
+
+**潜在问题**  
+同一记录的时间差与秒数可能不一致，外部重传可能重复入库，汇总结果缺少可信来源。
+
+↓
+
+**可能影响哪些业务**  
+学习达标、时长报表、设备对接、学员画像、考核结果。
+
+## 12. 画像是手工 CRUD 快照，没有生成链路
+
+**当前实现**  
+`train_student_portrait` 直接保存总时长、平均成绩、签到率、标签和文本；Service 不读取签到、成绩、时长表，前端只提供编辑表格。
+
+↓
+
+**潜在问题**  
+画像指标可能与来源明细不一致，无法说明何时、按何规则生成，也不能回溯历史版本。
+
+↓
+
+**可能影响哪些业务**  
+学员评价、推荐、教学改进、结业报告、管理驾驶舱。
+
+## 13. 设备表有状态字段，但没有设备协议接口
+
+**当前实现**  
+电子班牌保存最后心跳和在线状态，宿舍授权保存人脸同步状态；后端只有管理 CRUD。设备相关前端另有两个无 API 的占位页。
+
+↓
+
+**潜在问题**  
+页面可编辑“在线/已下发”等结果字段，却没有系统生成这些状态的接入、认证、回执和超时逻辑。
+
+↓
+
+**可能影响哪些业务**  
+班牌内容发布、签到、人脸门锁、设备在线监控、故障告警。
+
+## 14. 培训权限前后端不一致
+
+**当前实现**  
+前端多数使用 `train:*`，后端使用 `system:*`；宿舍、教室、成绩后端共用 `system:info:*`；仓库没有培训菜单 SQL。
+
+↓
+
+**潜在问题**  
+普通角色的按钮显示与后端授权可能不一致，三个资源也无法独立授权；管理员通配权限会隐藏问题。
+
+↓
+
+**可能影响哪些业务**  
+所有培训菜单、增改删、导入导出和角色验收。
+
+## 15. 培训查询没有数据范围
+
+**当前实现**  
+`ruoyi-train` 无 `@DataScope`，教师/学员也未关联 `sys_user`，Mapper 列表是单表条件查询。
+
+↓
+
+**潜在问题**  
+拥有列表权限的普通账号可能看到所有培训数据，无法实现“教师只看所带班级”或“学员只看本人”。
+
+↓
+
+**可能影响哪些业务**  
+教师门户、学员门户、成绩与画像隐私、组织隔离。
+
+## 16. 培训表没有可执行数据库基线
+
+**当前实现**  
+14 张表只有 DOCX 设计和 Mapper引用；仓库只有若依系统/Quartz SQL，没有培训 DDL、迁移、索引、外键或菜单脚本。
+
+↓
+
+**潜在问题**  
+不同环境可能靠人工建表而漂移，代码中字段对齐不代表真实数据库一致，也无法在新环境复现。
+
+↓
+
+**可能影响哪些业务**  
+所有培训 CRUD、联调、测试、部署、回滚和交接。
+
+## 17. Kingbase 配置与 MySQL 方言并存
+
+**当前实现**  
+Datasource 使用 Kingbase 8.6.0，但 PageHelper 为 mysql；若依 Mapper/生成器和系统 SQL使用 MySQL 特有语法，设计文档也含 `AUTO_INCREMENT`、`ON UPDATE CURRENT_TIMESTAMP`。
+
+↓
+
+**潜在问题**  
+是否可运行取决于 Kingbase兼容模式和具体版本；部分系统能力可能启动正常但在特定查询/生成/数据权限路径失败。
+
+↓
+
+**可能影响哪些业务**  
+分页、用户/角色/菜单查询、数据权限、Quartz、代码生成、初始化部署和数字主键回填。
+
+## 18. DATETIME 在接口展示中被格式化为日期
+
+**当前实现**  
+开班起止、报到、签到、课次、授权、学习起止/同步、导入、心跳等 Java `Date` 字段普遍使用 `@JsonFormat(pattern="yyyy-MM-dd")`，Excel也只导出日期。
+
+↓
+
+**潜在问题**  
+时分秒在 JSON/Excel 表示中丢失，时间型业务无法准确展示和回传，前端日期选择器也多按日处理。
+
+↓
+
+**可能影响哪些业务**  
+课表、报到时间、迟到早退、门禁授权时段、设备心跳、学习时长和数据同步审计。
+
+## 19. 字符串主键没有代码生成策略
+
+**当前实现**  
+8 个字符串主键只在非空时由 Mapper插入，没有 UUID/雪花/业务编号生成服务；生成页面让用户填写主键。
+
+↓
+
+**潜在问题**  
+空值是否可插入取决于数据库默认值，手工编号又可能冲突；不同入口难以统一编号规则。
+
+↓
+
+**可能影响哪些业务**  
+教师、学员、课程、计划、宿舍、教室、场地、班牌的新建和外部同步。
+
+## 20. 当前工作树不是稳定可复现基线
+
+**当前实现**  
+存在 9 个已跟踪修改文件、多项未跟踪业务页面/API、未跟踪启动脚本，以及大量已跟踪依赖文件。现有 JAR也不保证与当前源码一致。
+
+↓
+
+**潜在问题**  
+高级负责人、测试和部署人员从 `main` 获取的代码与本机可见能力不同，难以判断哪个状态应作为后续开发起点。
+
+↓
+
+**可能影响哪些业务**  
+所有开发任务拆分、缺陷复现、联调、发布和责任边界。

docs/codebase-audit/11_executive_summary.md

@@ -0,0 +1,138 @@
+# RailwaySystem 代码基线审计 Executive Summary
+
+## 1. 当前工程一句话描述
+
+RailwaySystem 是基于 RuoYi-Vue 3.9.1、Spring Boot 2.5.15、Vue 2 与 KingbaseES 配置的前后端分离培训管理项目；当前已形成 14 组培训数据 CRUD 脚手架，但数据库对象、菜单权限、Kingbase兼容和业务闭环尚无仓库证据证明已经端到端跑通。
+
+## 2. 当前技术栈
+
+- 后端：Java 8 编译目标、Spring Boot 2.5.15、Spring Framework 5.3.39、Spring Security 5.7.14、MyBatis XML、PageHelper 1.4.7、Druid 1.2.27、JJWT 0.9.1、Redis、Quartz、Apache POI。
+- 数据库：当前 datasource 指向 KingbaseES，驱动 `com.kingbase:kingbase8:8.6.0`；MySQL驱动和多处 MySQL方言仍保留。
+- 前端：Vue 2.6.12、Vue Router 3.4.9、Vuex 3.6.0、Element UI 2.15.12、Axios 0.24.0、ECharts 5.4.0、Vue CLI 4.4.6。
+- 模块：`ruoyi-admin`、`ruoyi-framework`、`ruoyi-system`、`ruoyi-quartz`、`ruoyi-generator`、`ruoyi-common`、`ruoyi-train`，以及培训前端 `build_ui`。
+- 当前机器：Java 21.0.2、Maven 3.9.2、Node 22.23.2、npm 10.9.8；源码目标与本机工具链有明显年代跨度。
+
+## 3. 已经存在的培训模块
+
+共 14 组：
+
+1. 教师 `train_teacher`
+2. 学员 `train_student`
+3. 课程 `train_course`
+4. 开班计划 `train_class_plan`
+5. 宿舍 `train_dormitory_info`
+6. 宿舍权限/门锁授权 `train_dorm_auth`
+7. 教室 `train_classroom_info`
+8. 实训场地 `train_training_site`
+9. 开班报到 `train_class_report`
+10. 电子班牌 `train_electronic_board`
+11. 学员签到 `train_student_checkin`
+12. 多类型成绩 `train_score_info`
+13. 学习时长 `train_study_duration`
+14. 学员画像 `train_student_portrait`
+
+每组都有 Entity、Mapper接口、Mapper XML、Service接口、ServiceImpl和 Controller。当前工作树也有对应前端 CRUD页面和 API，但成绩、宿舍等部分文件尚未跟踪。
+
+## 4. 已经真正跑通的功能
+
+本次审计没有启动服务或连接数据库，因此**不能确认任何培训模块已经端到端跑通**。
+
+能够确认的只是代码能力：
+
+- 若依登录、RBAC、动态菜单、日志、分页、统一返回、异常处理、Excel、上传、Quartz和代码生成框架都在仓库中。
+- 14 组培训后端静态 CRUD调用链完整。
+- 当前文件系统中 14 组前端页面/API可找到。
+- 当前存在后端 JAR和前端依赖目录，但它们不保证与未提交源码一致，也不能替代运行验证。
+
+## 5. 目前只是 CRUD、尚未形成业务闭环的部分
+
+14 个培训 Controller 合计 84 个映射，全部属于列表、导出、详情、新增、修改、删除。没有发现：
+
+- 开班/结班、报名审核、参训名单等业务动作。
+- 课次、排课、课程表和资源冲突校验。
+- 现场身份证/人脸报到流程。
+- 电子班牌心跳、内容发布、签到回调。
+- 门锁人脸下发、回执、重试、撤权。
+- Excel成绩/学员导入、外部成绩与学习记录采集。
+- 综合成绩计算、发布、锁定和追溯。
+- 画像计算规则与生成任务。
+- 培训统计聚合接口或真正业务工作台。
+
+## 6. 当前数据库现状
+
+- 代码和设计文档一致指向 14 张 `train_*` 业务表，但仓库没有这些表的可执行 DDL、迁移或种子数据。
+- 本次未查询实时数据库，不能确认表是否存在、字段/索引/外键/默认值是否一致。
+- 14 个 Entity 都继承 BaseEntity，但表的公共字段不统一；业务表主要用 `create_user`，并未统一使用若依 `create_by/update_by`。
+- 所有培训删除都是物理删除，没有 `del_flag` 逻辑删除。
+- 数字主键依赖 JDBC generated keys，设计写为 MySQL `AUTO_INCREMENT`；字符串主键没有代码生成策略。
+- `sys_*` 表继续支撑若依系统功能，不应修改结构或复制一套权限系统。
+- 当前 Kingbase驱动配置与 MySQL方言并存，是上线/联调前的关键验证项。
+
+## 7. 当前前端现状
+
+- `build_ui` 是培训前端，14 个核心模块页面本质都是 CRUD。
+- 首页只是“基地学员管理平台 V1.0”信息卡，不是业务工作台。
+- 报到、签到、画像、学习时长、电子班牌均只有数据维护页，没有对应业务流程。
+- 两个未跟踪成绩页只是对同一成绩列表做筛选；课程成绩页把 `examScore` 单列当作评级依据。
+- `equipment`、`extra` 是未跟踪占位页；旧 `character`/`analysis` 页面含随机或遗留接口，不能算培训统计已实现。
+- 未发现课程表页面。
+- 培训路由依赖实时 `sys_menu` 动态加载，仓库没有培训菜单 SQL，所以现有菜单无法由代码仓库确认。
+
+## 8. 当前权限体系
+
+- 登录主体是 `sys_user`，角色为 `sys_role`，菜单/按钮权限来自 `sys_menu.perms`。
+- Controller 用 `@PreAuthorize("@ss.hasPermi(...)")`，前端用 `v-hasPermi`。
+- 培训前端多数使用 `train:*`，后端使用 `system:*`，权限码不一致。
+- 宿舍、教室、成绩三个 Controller共用 `system:info:*`，授权粒度冲突。
+- 教师和学员均未关联 `sys_user`。
+- 培训模块未使用 `@DataScope`，不存在“教师只能看所带班级”或“学员只能看本人”的代码。
+- 培训增改删和导出已使用若依操作日志；列表/详情和领域状态变化没有专门审计轨迹。
+
+## 9. 可以直接复用的若依能力
+
+可以直接复用：登录、用户/角色基础 RBAC、操作日志、字典框架、文件上传下载、Excel工具、分页、统一返回、异常处理、系统配置。
+
+需要在现有框架上扩展：培训菜单/按钮权限、培训数据权限、培训 Excel导入、培训 Quartz任务、业务操作流水、公告之外的消息/设备通知。
+
+需要进一步确认：代码生成器、若依系统 Mapper、PageHelper、Quartz和初始化 SQL在目标 Kingbase模式下的完整兼容性。
+
+## 10. 当前最重要的10个代码/业务冲突
+
+1. **没有可执行培训数据库基线**：14 张表只有设计文档与 Mapper，无 DDL/迁移，实际数据库状态不可复现。
+2. **Kingbase与MySQL方言混用**：Kingbase驱动已启用，但 PageHelper、系统 Mapper、生成器和 SQL仍含 MySQL语法。
+3. **培训权限未接通**：前端 `train:*` 与后端 `system:*` 不一致，三个模块共用 `system:info:*`，也没有菜单初始化 SQL。
+4. **无账号业务身份和数据范围**：教师/学员不关联 `sys_user`，没有教师班级范围和学员本人范围。
+5. **无参训关系**：学员与培训计划之间没有正式 enrollment/花名册实体，后续业务各自直接引用两个 ID。
+6. **无课次/课表**：计划只能关联一个课程与一个教师，签到以重复的起止时间代替课次 ID。
+7. **报到只是 CRUD且混合资源分配**：没有设备报到流程，报到、宿舍、教室、场地绑定在同一记录。
+8. **住宿和门锁授权耦合**：没有独立床位、分配状态、设备下发流水和失败补偿。
+9. **成绩/时长/画像没有计算与采集闭环**：字段存在，但导入、外部采集、综合算法、画像生成均不存在。
+10. **工作树不是稳定基线**：关键路径适配和多个页面/API未提交，当前 JAR与源码也未证明一致。
+
+## 11. 如果继续开发，建议首先确认的代码层问题
+
+1. 确定以当前工作树还是提交 `83797f92` 为开发基线，逐项归属现有未提交/未跟踪文件。
+2. 获取只读数据库结构快照，核验 14 张业务表、系统表、主键、索引、外键、默认值和 Kingbase兼容模式。
+3. 建立可版本管理的培训 DDL/迁移与菜单权限 SQL基线；不要修改 `sys_*` 表结构。
+4. 统一培训 API前缀与权限字符串，取消 `system:info:*` 的跨模块复用，并验证普通角色。
+5. 明确教师/学员与 `sys_user` 的关联，以及教师、学员、管理员的数据可见范围。
+6. 在扩展页面前确认参训关系、课次/课表、独立床位等基础领域关系；这些关系决定报到、签到、住宿、成绩和画像的可实现性。
+7. 在目标 Kingbase环境逐项验证 PageHelper、若依系统查询、数据权限、代码生成、Quartz和 generated keys。
+8. 统一 DATETIME 的 JSON/Excel格式；当前多个时间字段只输出 `yyyy-MM-dd`。
+9. 明确字符串主键生成规则与物理删除/逻辑删除策略。
+10. 区分管理端 CRUD、业务动作、外部接入和统计接口，避免继续用可编辑状态字段代替真实流程。
+
+## 12. 需要高级技术负责人进一步评审的文件路径
+
+优先级从高到低：
+
+1. `docs/codebase-audit/10_gap_and_conflict_analysis.md`：决定后续领域模型和开发顺序。
+2. `docs/codebase-audit/03_database_current_state.md`：确认 Kingbase、DDL、主键、公共字段、物理删除和系统表边界。
+3. `docs/codebase-audit/06_security_and_permissions.md`：确认权限命名、账号关联和数据范围。
+4. `docs/codebase-audit/02_training_modules_inventory.md`：掌握14组 CRUD的实际代码边界。
+5. `docs/codebase-audit/08_git_status.md`：确定可复现基线和未提交文件归属。
+6. `RuoYi-Vue/ruoyi-admin/src/main/resources/application-druid.yml`：数据库连接与兼容配置；含敏感信息，评审时注意脱敏。
+7. `RuoYi-Vue/ruoyi-admin/src/main/resources/application.yml`：端口、Redis、JWT、MyBatis和 PageHelper配置。
+8. `RuoYi-Vue/ruoyi-system/src/main/resources/mapper/system/` 与 `RuoYi-Vue/ruoyi-generator/src/main/resources/mapper/generator/`：Kingbase兼容重点。
+9. `RuoYi-Vue/ruoyi-train/src/main/resources/mapper/train/`：14张表的当前实际 SQL契约。
+10. `doc/学员管理系统数据表设计_20260907_1_.docx`：当前14表设计来源。