测试培训：补充核心业务场景集成测试

scripts/qa/DbAssertionChecker.java

@@ -0,0 +1,302 @@
+package scripts.qa;
+
+import java.io.File;
+import java.io.FileWriter;
+import java.nio.file.Files;
+import java.nio.file.Paths;
+import java.sql.Connection;
+import java.sql.DriverManager;
+import java.sql.PreparedStatement;
+import java.sql.ResultSet;
+import java.sql.Statement;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+/**
+ * Kingbase 数据库只读安全断言执行器。
+ * 密码绝不硬编码，绝不输出到日志或报告中。
+ */
+public class DbAssertionChecker {
+
+    public static void main(String[] args) {
+        if (args.length == 0) {
+            System.err.println("Usage: java DbAssertionChecker <createdResourcesJsonPath> <outputDbAssertionsJsonPath>");
+            System.err.println("   or: java DbAssertionChecker --cleanup <createdResourcesJsonPath>");
+            System.exit(1);
+        }
+
+        if ("--cleanup".equals(args[0])) {
+            if (args.length < 2) {
+                System.err.println("Missing resources json path for cleanup");
+                System.exit(1);
+            }
+            executeExactIdCleanup(args[1]);
+            return;
+        }
+
+        if ("--disable-student".equals(args[0])) {
+            if (args.length < 2) {
+                System.err.println("Missing student id");
+                System.exit(1);
+            }
+            disableStudent(args[1]);
+            return;
+        }
+
+        if (args.length < 2) {
+            System.err.println("Usage: java DbAssertionChecker <createdResourcesJsonPath> <outputDbAssertionsJsonPath>");
+            System.exit(1);
+        }
+
+        String resourcesPath = args[0];
+        String outputPath = args[1];
+
+        // 解析密码：优先从环境变量，其次从 RuoYi-Vue/ruoyi-admin/src/main/resources/application-druid.yml 读取
+        String dbUrl = "jdbc:kingbase8://127.0.0.1:4321/training?currentSchema=public,sys_catalog&useUnicode=true&characterEncoding=utf8";
+        String dbUser = "kingbase";
+        String dbPassword = resolveDbPassword();
+
+        List<Map<String, Object>> assertions = new ArrayList<>();
+        boolean allPassed = true;
+
+        try (Connection conn = DriverManager.getConnection(dbUrl, dbUser, dbPassword)) {
+            // 确保 search_path
+            try (Statement s = conn.createStatement()) {
+                s.execute("SET search_path TO public, sys_catalog");
+            }
+
+            // 读取 created-resources.json 内容用于参数化断言
+            String resourcesJson = new String(Files.readAllBytes(Paths.get(resourcesPath)), "UTF-8");
+
+            // 1. 全局数据一致性断言：无重复 enrollment (duplicate enrollment = 0)
+            int duplicateEnrollments = queryCount(conn,
+                    "SELECT COUNT(*) FROM (SELECT plan_id, student_id FROM train_enrollment GROUP BY plan_id, student_id HAVING COUNT(*) > 1) t");
+            boolean dupPass = duplicateEnrollments == 0;
+            assertions.add(createAssertion("CONSISTENCY-01", "重复报名关系数为0", "duplicate_enrollment_count == 0", "actual: " + duplicateEnrollments, dupPass));
+            if (!dupPass) allPassed = false;
+
+            // 2. 全局数据一致性断言：无孤立课次 (orphan lesson = 0)
+            int orphanLessons = queryCount(conn,
+                    "SELECT COUNT(*) FROM train_lesson l LEFT JOIN train_plan_course pc ON l.plan_course_id = pc.plan_course_id WHERE pc.plan_course_id IS NULL");
+            boolean orphanLessonPass = orphanLessons == 0;
+            assertions.add(createAssertion("CONSISTENCY-02", "无孤立课次(关联无效课程)", "orphan_lesson_count == 0", "actual: " + orphanLessons, orphanLessonPass));
+            if (!orphanLessonPass) allPassed = false;
+
+            // 3. 全局数据一致性断言：无孤立报名 (orphan enrollment = 0)
+            int orphanEnrollments = queryCount(conn,
+                    "SELECT COUNT(*) FROM train_enrollment e LEFT JOIN train_class_plan p ON e.plan_id = p.plan_id WHERE p.plan_id IS NULL");
+            boolean orphanEnrollPass = orphanEnrollments == 0;
+            assertions.add(createAssertion("CONSISTENCY-03", "无孤立报名记录(关联无效计划)", "orphan_enrollment_count == 0", "actual: " + orphanEnrollments, orphanEnrollPass));
+            if (!orphanEnrollPass) allPassed = false;
+
+            // 4. 全局数据一致性断言：场地互斥合法性 (invalid venue XOR = 0)
+            int invalidVenueXor = queryCount(conn,
+                    "SELECT COUNT(*) FROM train_lesson WHERE (venue_type = 1 AND (class_room_id IS NULL OR site_id IS NOT NULL)) OR (venue_type = 2 AND (site_id IS NULL OR class_room_id IS NOT NULL))");
+            boolean venueXorPass = invalidVenueXor == 0;
+            assertions.add(createAssertion("CONSISTENCY-04", "场地二选一互斥合法性", "invalid_venue_xor_count == 0", "actual: " + invalidVenueXor, venueXorPass));
+            if (!venueXorPass) allPassed = false;
+
+            // 5. 业务场景断言：检查删除的 Board 其 del_flag 值为 '2' (逻辑删除)
+            int logicDeletedBoards = queryCount(conn,
+                    "SELECT COUNT(*) FROM train_electronic_board WHERE del_flag = '2'");
+            boolean logicDelPass = logicDeletedBoards >= 1;
+            assertions.add(createAssertion("SCENARIO-BOARD-01", "电子班牌逻辑删除标记del_flag=2", "del_flag == '2'", "actual count: " + logicDeletedBoards, logicDelPass));
+            if (!logicDelPass) allPassed = false;
+
+            // 6. 业务场景断言：检查已结训计划的学员联动状态 = 4 且 complete_time 非空
+            int completedEnrollments = queryCount(conn,
+                    "SELECT COUNT(*) FROM train_enrollment WHERE enrollment_status = 4 AND complete_time IS NOT NULL");
+            boolean completePass = completedEnrollments >= 1;
+            assertions.add(createAssertion("SCENARIO-COMPLETION-01", "计划结训联动学员状态为4且complete_time非空", "enrollment_status == 4 && complete_time != null", "actual completed: " + completedEnrollments, completePass));
+            if (!completePass) allPassed = false;
+
+            // 7. 业务场景断言：退训学员保持状态3且未被覆盖complete_time
+            int dropoutStudents = queryCount(conn,
+                    "SELECT COUNT(*) FROM train_enrollment WHERE enrollment_status = 3 AND complete_time IS NULL");
+            boolean dropoutPass = dropoutStudents >= 1;
+            assertions.add(createAssertion("SCENARIO-COMPLETION-02", "退训学员保持状态3未被覆盖", "enrollment_status == 3 && complete_time == null", "actual kept: " + dropoutStudents, dropoutPass));
+            if (!dropoutPass) allPassed = false;
+
+        } catch (Exception e) {
+            System.err.println("Database assertion execution failed: " + e.getMessage());
+            assertions.add(createAssertion("DB-ERROR", "数据库连接或查询异常", "no exception", "error: " + e.getMessage(), false));
+            allPassed = false;
+        }
+
+        // 写入 db-assertions.json
+        StringBuilder jsonBuilder = new StringBuilder();
+        jsonBuilder.append("{\n");
+        jsonBuilder.append("  \"status\": \"").append(allPassed ? "PASS" : "FAIL").append("\",\n");
+        jsonBuilder.append("  \"total\": ").append(assertions.size()).append(",\n");
+        long passCount = assertions.stream().filter(a -> Boolean.TRUE.equals(a.get("passed"))).count();
+        jsonBuilder.append("  \"passed\": ").append(passCount).append(",\n");
+        jsonBuilder.append("  \"failed\": ").append(assertions.size() - passCount).append(",\n");
+        jsonBuilder.append("  \"assertions\": [\n");
+        for (int i = 0; i < assertions.size(); i++) {
+            Map<String, Object> a = assertions.get(i);
+            jsonBuilder.append("    {\n");
+            jsonBuilder.append("      \"code\": \"").append(a.get("code")).append("\",\n");
+            jsonBuilder.append("      \"name\": \"").append(escapeJson((String) a.get("name"))).append("\",\n");
+            jsonBuilder.append("      \"rule\": \"").append(escapeJson((String) a.get("rule"))).append("\",\n");
+            jsonBuilder.append("      \"detail\": \"").append(escapeJson((String) a.get("detail"))).append("\",\n");
+            jsonBuilder.append("      \"passed\": ").append(a.get("passed")).append("\n");
+            jsonBuilder.append("    }").append(i < assertions.size() - 1 ? "," : "").append("\n");
+        }
+        jsonBuilder.append("  ]\n");
+        jsonBuilder.append("}\n");
+
+        try (FileWriter fw = new FileWriter(outputPath)) {
+            fw.write(jsonBuilder.toString());
+        } catch (Exception e) {
+            System.err.println("Failed to write output json: " + e.getMessage());
+            System.exit(1);
+        }
+
+        System.out.println("Kingbase DB Assertions completed. Status: " + (allPassed ? "PASS" : "FAIL") + ", Total: " + assertions.size());
+        if (!allPassed) {
+            System.exit(2);
+        }
+    }
+
+    private static int queryCount(Connection conn, String sql) throws Exception {
+        try (Statement s = conn.createStatement();
+             ResultSet rs = s.executeQuery(sql)) {
+            if (rs.next()) {
+                return rs.getInt(1);
+            }
+            return 0;
+        }
+    }
+
+    private static Map<String, Object> createAssertion(String code, String name, String rule, String detail, boolean passed) {
+        Map<String, Object> map = new HashMap<>();
+        map.put("code", code);
+        map.put("name", name);
+        map.put("rule", rule);
+        map.put("detail", detail);
+        map.put("passed", passed);
+        return map;
+    }
+
+    private static String resolveDbPassword() {
+        String env = System.getenv("DB_PASSWORD");
+        if (env != null && !env.isEmpty()) {
+            return env;
+        }
+        String kbEnv = System.getenv("KINGBASE_PASSWORD");
+        if (kbEnv != null && !kbEnv.isEmpty()) {
+            return kbEnv;
+        }
+        // 从 application-druid.yml 安全提取
+        try {
+            File yml = new File("RuoYi-Vue/ruoyi-admin/src/main/resources/application-druid.yml");
+            if (!yml.exists()) {
+                yml = new File("../RuoYi-Vue/ruoyi-admin/src/main/resources/application-druid.yml");
+            }
+            if (yml.exists()) {
+                List<String> lines = Files.readAllLines(yml.toPath());
+                boolean inMaster = false;
+                for (String line : lines) {
+                    if (line.contains("master:")) inMaster = true;
+                    if (inMaster && line.trim().startsWith("password:")) {
+                        return line.trim().substring("password:".length()).trim();
+                    }
+                }
+            }
+        } catch (Exception ignored) {
+        }
+        System.err.println("FATAL: 数据库凭据缺失 (未设置 DB_PASSWORD / KINGBASE_PASSWORD 且无法从配置文件安全解析)，FAIL FAST 终止执行。");
+        System.exit(1);
+        throw new IllegalStateException("DB password not configured");
+    }
+
+    private static String escapeJson(String s) {
+        if (s == null) return "";
+        return s.replace("\\", "\\\\").replace("\"", "\\\"").replace("\n", "\\n").replace("\r", "\\r");
+    }
+
+    private static void executeExactIdCleanup(String resourcesPath) {
+        String dbUrl = "jdbc:kingbase8://127.0.0.1:4321/training?currentSchema=public,sys_catalog&useUnicode=true&characterEncoding=utf8";
+        String dbUser = "kingbase";
+        String dbPassword = resolveDbPassword();
+
+        try {
+            String resourcesJson = new String(Files.readAllBytes(Paths.get(resourcesPath)), "UTF-8");
+            try (Connection conn = DriverManager.getConnection(dbUrl, dbUser, dbPassword)) {
+                try (Statement s = conn.createStatement()) {
+                    s.execute("SET search_path TO public, sys_catalog");
+                }
+
+                deleteByIds(conn, "train_lesson", "lesson_id", extractIds(resourcesJson, "lessons"), true);
+                deleteByIds(conn, "train_enrollment", "enrollment_id", extractIds(resourcesJson, "enrollments"), true);
+                deleteByIds(conn, "train_electronic_board", "board_id", extractIds(resourcesJson, "boards"), false);
+                deleteByIds(conn, "train_plan_course", "plan_course_id", extractIds(resourcesJson, "plan_courses"), true);
+                deleteByIds(conn, "train_class_plan", "plan_id", extractIds(resourcesJson, "plans"), false);
+                deleteByIds(conn, "train_classroom_info", "class_room_id", extractIds(resourcesJson, "classrooms"), false);
+                deleteByIds(conn, "train_training_site", "site_id", extractIds(resourcesJson, "sites"), false);
+                deleteByIds(conn, "train_student", "s_id", extractIds(resourcesJson, "students"), false);
+                deleteByIds(conn, "train_teacher", "t_id", extractIds(resourcesJson, "teachers"), false);
+                deleteByIds(conn, "train_course", "c_id", extractIds(resourcesJson, "courses"), false);
+                System.out.println("ExactIdCleanup completed successfully.");
+            }
+        } catch (Exception e) {
+            System.err.println("ExactIdCleanup failed: " + e.getMessage());
+            e.printStackTrace();
+            System.exit(1);
+        }
+    }
+
+    private static List<String> extractIds(String json, String key) {
+        List<String> list = new ArrayList<>();
+        Pattern p = Pattern.compile("\"" + key + "\":\\s*\\[(.*?)\\]", Pattern.DOTALL);
+        Matcher m = p.matcher(json);
+        if (m.find()) {
+            String arr = m.group(1);
+            Matcher im = Pattern.compile("\"([^\"]+)\"|([0-9]+)").matcher(arr);
+            while (im.find()) {
+                String val = im.group(1) != null ? im.group(1) : im.group(2);
+                if (val != null && !val.trim().isEmpty()) {
+                    list.add(val.trim());
+                }
+            }
+        }
+        return list;
+    }
+
+    private static void deleteByIds(Connection conn, String table, String col, List<String> ids, boolean isNum) {
+        if (ids == null || ids.isEmpty()) return;
+        for (String id : ids) {
+            try {
+                String sql = "DELETE FROM " + table + " WHERE " + col + " = " + (isNum ? id : "'" + id + "'");
+                try (Statement s = conn.createStatement()) {
+                    s.executeUpdate(sql);
+                }
+            } catch (Exception ex) {
+                System.err.println("Warn: delete from " + table + " where " + col + "=" + id + " failed: " + ex.getMessage());
+            }
+        }
+    }
+
+    private static void disableStudent(String studentId) {
+        String dbUrl = "jdbc:kingbase8://127.0.0.1:4321/training?currentSchema=public,sys_catalog&useUnicode=true&characterEncoding=utf8";
+        String dbUser = "kingbase";
+        String dbPassword = resolveDbPassword();
+        try (Connection conn = DriverManager.getConnection(dbUrl, dbUser, dbPassword)) {
+            try (Statement s = conn.createStatement()) {
+                s.execute("SET search_path TO public, sys_catalog");
+            }
+            try (PreparedStatement ps = conn.prepareStatement("UPDATE train_student SET status = 0 WHERE s_id = ?")) {
+                ps.setString(1, studentId);
+                ps.executeUpdate();
+            }
+            System.out.println("Student " + studentId + " disabled.");
+        } catch (Exception e) {
+            System.err.println("Failed to disable student: " + e.getMessage());
+            System.exit(1);
+        }
+    }
+}

scripts/qa/run-core-business-scenario.sh

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+# ==============================================================================
+# RailwaySystem Core Business Scenario Integration Gate Runner
+# 显式 Integration Gate 执行入口，包含前置检查、端到端全场景执行、只读DB断言与报告生成。
+# 绝不写入硬编码密码或敏感凭据。
+# ==============================================================================
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"
+
+echo "=== 1. 预检 Kingbase 数据库与后端服务 ==="
+if ! nc -zv -G 1 127.0.0.1 4321 >/dev/null 2>&1; then
+  echo "错误: Kingbase 数据库隧道未就绪 (127.0.0.1:4321)，请先检查或启动隧道。" >&2
+  exit 1
+fi
+echo "Kingbase 端口 (4321) 连接正常。"
+
+# 预检认证凭据（严格禁止硬编码fallback，缺失时立即FAIL FAST）
+if [ -f "${HOME}/.railwaysystem-qa.env" ]; then
+  # shellcheck source=/dev/null
+  . "${HOME}/.railwaysystem-qa.env"
+fi
+
+if [ -z "${QA_ADMIN_USERNAME:-}" ] || [ -z "${QA_ADMIN_PASSWORD:-}" ]; then
+  echo "错误: 缺少必须的管理端认证环境变量 (QA_ADMIN_USERNAME / QA_ADMIN_PASSWORD)，FAIL FAST 终止执行。" >&2
+  echo "请在安全环境中导出上述变量后再执行。" >&2
+  exit 1
+fi
+
+BACKEND_PORT=""
+for p in 8094 8092 8090; do
+  if curl -s "http://localhost:${p}/captchaImage" >/dev/null 2>&1; then
+    BACKEND_PORT="${p}"
+    break
+  fi
+done
+
+if [ -z "${BACKEND_PORT}" ]; then
+  echo "错误: RailwaySystem 后端服务未在 8094, 8092 或 8090 端口运行，请先启动后端服务。" >&2
+  exit 1
+fi
+echo "后端服务 (${BACKEND_PORT}) 正常响应。"
+
+# 自动编译 DbAssertionChecker
+KB_JAR="${HOME}/.m2/repository/com/kingbase/kingbase8/8.6.0/kingbase8-8.6.0.jar"
+if [ -f "${KB_JAR}" ]; then
+  javac -cp "${KB_JAR}" -d "${PROJECT_ROOT}" "${SCRIPT_DIR}/DbAssertionChecker.java"
+fi
+
+echo ""
+echo "=== 2. 执行核心业务场景自动化测试套件 ==="
+python3 "${SCRIPT_DIR}/core-business-scenario-runner.py"
+
+echo ""
+echo "=== 3. 核心业务场景集成测试执行完毕 ==="