diff --git a/platform-metadata/pom.xml b/platform-metadata/pom.xml
index e8f16d5..304ecaa 100644
--- a/platform-metadata/pom.xml
+++ b/platform-metadata/pom.xml
@@ -17,6 +17,8 @@
org.springframework.bootspring-boot-starter-web
org.springdocspringdoc-openapi-starter-webmvc-ui
com.networkntjson-schema-validator
+
+ com.github.ben-manes.caffeinecaffeine
com.fasterxml.jackson.datatypejackson-datatype-joda
org.springframework.bootspring-boot-starter-testtest
diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/perf/BacklogIndexScriptGenerator.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/perf/BacklogIndexScriptGenerator.java
new file mode 100644
index 0000000..93cb747
--- /dev/null
+++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/perf/BacklogIndexScriptGenerator.java
@@ -0,0 +1,95 @@
+package com.eip4.platform.metadata.perf;
+
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.time.LocalDate;
+import java.util.ArrayList;
+import java.util.List;
+
+import org.springframework.jdbc.core.JdbcTemplate;
+import org.springframework.stereotype.Component;
+
+/**
+ * 存量补索引脚本生成器(P1-5)。
+ *
+ *
扫描 {@code SYS_ENTITY} 全部已登记业务实体,按 {@link IndexEnhancer} 同一套规则
+ * (外键 uuid 列 + UPDATETIME,跳过 ISIDENTIFIER/ISCOMBIDENTIFIER)生成补索引 SQL,
+ * 只落盘成 .sql 文件,不对任何库执行——存量库(尤其客户库)的执行排进切流期
+ * 变更窗口,由 DBA 在维护窗口跑。脚本全部 {@code IF NOT EXISTS} 幂等。
+ *
+ *
过滤前缀可选:默认扫全部业务实体;可传前缀(如 {@code EIP4PT_})只生成本地实体脚本。
+ */
+@Component
+public class BacklogIndexScriptGenerator {
+
+ private final JdbcTemplate jdbcTemplate;
+ private final IndexEnhancer indexEnhancer;
+
+ public BacklogIndexScriptGenerator(JdbcTemplate jdbcTemplate, IndexEnhancer indexEnhancer) {
+ this.jdbcTemplate = jdbcTemplate;
+ this.indexEnhancer = indexEnhancer;
+ }
+
+ /**
+ * 生成存量补索引脚本文本。
+ * @param tablePrefix 表名前缀过滤(如 {@code EIP4PT_});为空则全部业务实体
+ * @return SQL 脚本全文(含头注释)
+ */
+ public String generateScript(String tablePrefix) {
+ List tables = listEntityTables(tablePrefix);
+ StringBuilder sb = new StringBuilder();
+ sb.append("-- ============================================================\n");
+ sb.append("-- 存量补索引脚本(P1-5 DDL 索引增强 / 现代层后置,不改引擎)\n");
+ sb.append("-- 生成日期: ").append(LocalDate.now()).append("\n");
+ sb.append("-- 规则: 外键(REFERENCEID=36位uuid)列 + UPDATETIME; 跳过 ISIDENTIFIER/ISCOMBIDENTIFIER(引擎已建unique)\n");
+ sb.append("-- 幂等: 全部 IF NOT EXISTS。⚠️ 客户库执行排切流期变更窗口,本文件只落盘不自动执行。\n");
+ sb.append("-- 实体数: ").append(tables.size()).append("\n");
+ sb.append("-- ============================================================\n\n");
+
+ int stmtCount = 0;
+ for (String table : tables) {
+ List sqls = indexEnhancer.generateIndexSql(table);
+ if (sqls.isEmpty()) {
+ continue;
+ }
+ sb.append("-- ").append(table).append(" (").append(sqls.size()).append(" 索引)\n");
+ for (String sql : sqls) {
+ sb.append(sql).append(";\n");
+ stmtCount++;
+ }
+ sb.append("\n");
+ }
+ sb.append("-- 合计 CREATE INDEX 语句: ").append(stmtCount).append("\n");
+ return sb.toString();
+ }
+
+ /**
+ * 生成脚本并写入磁盘文件。
+ * @return 写入的字节数
+ */
+ public long generateToFile(Path outputPath, String tablePrefix) {
+ try {
+ String script = generateScript(tablePrefix);
+ byte[] bytes = script.getBytes(StandardCharsets.UTF_8);
+ if (outputPath.getParent() != null) {
+ Files.createDirectories(outputPath.getParent());
+ }
+ Files.write(outputPath, bytes);
+ return bytes.length;
+ } catch (java.io.IOException e) {
+ throw new IllegalStateException("写补索引脚本失败: " + outputPath, e);
+ }
+ }
+
+ private List listEntityTables(String tablePrefix) {
+ String sql = "SELECT TABLENAME FROM SYS_ENTITY WHERE ISACTIVE = 1 AND ISVIEW = 0";
+ List