diff --git a/platform-ai/src/main/java/com/eip4/platform/ai/service/AiAgentService.java b/platform-ai/src/main/java/com/eip4/platform/ai/service/AiAgentService.java
index 465a169..4180145 100644
--- a/platform-ai/src/main/java/com/eip4/platform/ai/service/AiAgentService.java
+++ b/platform-ai/src/main/java/com/eip4/platform/ai/service/AiAgentService.java
@@ -406,6 +406,16 @@ public class AiAgentService {
public AiApplyRun applyLocalRelease(String taskId, String changeSetId, String baseUrl) {
getTask(taskId);
+ // P0②(c) 安全门 enforced:把 AiToolRegistry 策略引擎织入真实写路径。此前 check() 仅挂在
+ // /api/ai/tools/check-access 咨询端点(只读返决策),写路径仅靠 requireAdmin + localhost 兜底,
+ // scope/localOnly/productionWrite 策略形同 advisory。这里以 local.apply 工具身份过门:
+ // targetEnv=baseUrl,非本机 / 越权 → 403,localReleaseExecutor.apply 不被触发。
+ AiToolAccessDecision gate = toolRegistry.check(new AiToolAccessRequest(
+ "agent-developer", "local.apply", List.of("ai:local:apply"), baseUrl, false));
+ if (gate == null || !gate.allowed()) {
+ throw new ResponseStatusException(HttpStatus.FORBIDDEN,
+ "本地应用被安全门拒绝: " + (gate == null ? "no-decision" : String.join("; ", gate.blockers())));
+ }
AiChangeSet changeSet = findChangeSet(taskId, changeSetId);
if (!"READY_FOR_REVIEW".equals(changeSet.status())) {
throw new ResponseStatusException(HttpStatus.CONFLICT, "变更包状态不可本地应用: " + changeSet.status());
diff --git a/platform-ai/src/test/java/com/eip4/platform/ai/service/AiAgentServiceTest.java b/platform-ai/src/test/java/com/eip4/platform/ai/service/AiAgentServiceTest.java
index a29c709..1669640 100644
--- a/platform-ai/src/test/java/com/eip4/platform/ai/service/AiAgentServiceTest.java
+++ b/platform-ai/src/test/java/com/eip4/platform/ai/service/AiAgentServiceTest.java
@@ -48,6 +48,17 @@ class AiAgentServiceTest {
assertEquals(3, service.listAudit(task.id()).size());
}
+ @Test
+ @DisplayName("P0②(c) 安全门 enforced:非本机 baseUrl 的本地应用被拒(FORBIDDEN),写路径不被触发")
+ void localApplyRejectedForNonLocalBaseUrl() {
+ AiAgentService service = newService();
+ var task = service.createTask("安全门测试");
+ // 非本机 targetEnv → AiToolRegistry.check 不通过(local-only + production-write 拦截)
+ var ex = assertThrows(ResponseStatusException.class,
+ () -> service.applyLocalRelease(task.id(), "any-change-set", "http://prod-host:9000"));
+ assertEquals(org.springframework.http.HttpStatus.FORBIDDEN, ex.getStatusCode());
+ }
+
@Test
@DisplayName("无效 schema 草稿会阻止生成变更包")
void invalidSchemaBlocksChangeSet() throws Exception {
diff --git a/platform-legacy-core/src/main/java/com/dsasp/server/common/dataDic/service/DataDicService.java b/platform-legacy-core/src/main/java/com/dsasp/server/common/dataDic/service/DataDicService.java
index 7629257..1462a4a 100644
--- a/platform-legacy-core/src/main/java/com/dsasp/server/common/dataDic/service/DataDicService.java
+++ b/platform-legacy-core/src/main/java/com/dsasp/server/common/dataDic/service/DataDicService.java
@@ -101,6 +101,13 @@ public interface DataDicService {
* @return
*/
public String executeCreateSql(String sql);
+
+ /**
+ * 受控变更实体表结构(只允许 加列 / 同族扩长 / 改可空,经 AlterTableSqlGuard 白名单校验)。
+ * @param sql ALTER 语句
+ * @return null=成功;非空=失败原因
+ */
+ public String executeAlterSql(String sql);
/**
* get entity by table name
diff --git a/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/AlterTableSqlGuard.java b/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/AlterTableSqlGuard.java
new file mode 100644
index 0000000..ac35de1
--- /dev/null
+++ b/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/AlterTableSqlGuard.java
@@ -0,0 +1,106 @@
+package com.dsasp.server.dataDic.service;
+
+import java.util.Locale;
+import java.util.regex.Pattern;
+
+/**
+ * P0② 引擎 ALTER 安全通道守卫(纯静态 / 无 Spring 依赖,便于单测)。
+ *
+ *
保真层(com.dsasp.*)的 DDL 此前只接受 CREATE({@code DataDicServiceImpl.executeCreateSql}),
+ * 完全不支持 ALTER。本守卫把 ALTER 从「完全不可达」收窄为「只允许 加列 / 同族扩长 / 改可空」
+ * 的最小安全集,显式拒绝一切破坏性 / 不可逆 DDL。
+ *
+ *
放在 legacy-core(而非 platform-metadata)以避免 legacy-core→metadata 的反向(循环)依赖:
+ * 引擎层 {@code executeAlterSql} 与控制层 {@code MetaController} 都引用本类,形成 defense-in-depth
+ * 双层校验。
+ *
+ *
受控形态(标识符大小写敏感,必须大写,匹配引擎建表正则;类型 token 小写,匹配
+ * {@code MetaController.appendColumnDdl} 的输出):
+ *
+ * - {@code ALTER TABLE ADD COLUMN } — 加列(可带 REFERENCES 引用)
+ * - {@code ALTER TABLE ALTER COLUMN TYPE } — 同族扩长
+ * - {@code ALTER TABLE ALTER COLUMN DROP NOT NULL} — 改可空
+ *
+ * 其余(DROP COLUMN / RENAME / SET NOT NULL / 跨族类型转换 / 多语句 / 子查询 / 注释 / 小写绕过)
+ * 一律抛 {@link IllegalArgumentException}。
+ */
+public final class AlterTableSqlGuard {
+
+ private AlterTableSqlGuard() {
+ }
+
+ /** 表名/列名规则与 MetaController 建表白名单一致(大写起头,大写数字下划线)。 */
+ private static final String TABLE = "[A-Z][A-Z0-9_]{2,40}";
+ private static final String COLUMN = "[A-Z][A-Z0-9_]{1,60}";
+
+ /** 加列允许的引擎类型(对齐 appendColumnDdl:字符串/数值/整型/时间戳/定长/引用列)。 */
+ private static final String ADD_TYPE =
+ "(?:character varying\\(\\d{1,4}\\)"
+ + "|numeric\\(\\d{1,2},\\d{1,2}\\)"
+ + "|integer"
+ + "|bigint"
+ + "|character\\(36\\)(?: REFERENCES " + TABLE + ")?)";
+
+ /** 扩长只允许同族(varchar 改宽 / numeric 改精度),不允许跨族(varchar→int 会丢数据)。 */
+ private static final String WIDEN_TYPE =
+ "(?:character varying\\(\\d{1,4}\\)|numeric\\(\\d{1,2},\\d{1,2}\\))";
+
+ private static final Pattern ADD_COLUMN = Pattern.compile(
+ "ALTER TABLE (" + TABLE + ") ADD COLUMN (" + COLUMN + ") " + ADD_TYPE);
+ private static final Pattern ALTER_TYPE = Pattern.compile(
+ "ALTER TABLE (" + TABLE + ") ALTER COLUMN (" + COLUMN + ") TYPE " + WIDEN_TYPE);
+ private static final Pattern DROP_NOT_NULL = Pattern.compile(
+ "ALTER TABLE (" + TABLE + ") ALTER COLUMN (" + COLUMN + ") DROP NOT NULL");
+
+ /**
+ * 注意:不含 " NOT NULL"(会误伤合法的 "DROP NOT NULL");ADD COLUMN ... NOT NULL 由
+ * 「不匹配任何受控形态」自然拒绝。"SET NOT NULL" 明确列出(不会误伤 DROP NOT NULL)。
+ */
+ private static final String[] DENY_TOKENS = {
+ "--", "/*", "*/", " USING ", "(SELECT", " SELECT ",
+ " DROP COLUMN", " RENAME ", " SET NOT NULL", " SET DEFAULT",
+ " DROP TABLE", " DROP CONSTRAINT", " ADD CONSTRAINT",
+ };
+
+ /**
+ * 校验并归一化一条 ALTER 语句。
+ *
+ * @param sql 原始 SQL
+ * @return 归一后的安全 SQL(折叠空白、去尾分号),可直接交给 jdbcTemplate.execute
+ * @throws IllegalArgumentException 非白名单 / 危险 / 非受控形态
+ */
+ public static String guard(String sql) {
+ if (sql == null) {
+ throw new IllegalArgumentException("ALTER 脚本为空");
+ }
+ String s = sql.strip();
+ if (s.endsWith(";")) {
+ s = s.substring(0, s.length() - 1).strip();
+ }
+ s = s.replaceAll("\\s+", " ");
+ if (s.isEmpty()) {
+ throw new IllegalArgumentException("ALTER 脚本为空");
+ }
+ // 单语句:折叠后不得再含分号(分号注入第二句)
+ if (s.indexOf(';') >= 0) {
+ throw new IllegalArgumentException("只允许单条 ALTER 语句: " + sql);
+ }
+ String upper = s.toUpperCase(Locale.ROOT);
+ if (!upper.startsWith("ALTER TABLE ")) {
+ throw new IllegalArgumentException("只允许 ALTER TABLE 语句: " + sql);
+ }
+ for (String bad : DENY_TOKENS) {
+ if (upper.contains(bad)) {
+ throw new IllegalArgumentException("ALTER 含禁止操作 [" + bad.trim() + "]: " + sql);
+ }
+ }
+ // 必须精确匹配三种受控形态之一(整串 matches,标识符大小写敏感)
+ if (ADD_COLUMN.matcher(s).matches()
+ || ALTER_TYPE.matcher(s).matches()
+ || DROP_NOT_NULL.matcher(s).matches()) {
+ return s;
+ }
+ throw new IllegalArgumentException(
+ "非受控的 ALTER 形态(只允许 加列 / 同族扩长 / 改可空): " + sql);
+ }
+}
diff --git a/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/DataDicServiceImpl.java b/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/DataDicServiceImpl.java
index 27e05ee..ad5a06f 100644
--- a/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/DataDicServiceImpl.java
+++ b/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/service/DataDicServiceImpl.java
@@ -204,6 +204,18 @@ public class DataDicServiceImpl implements DataDicService {
return "非合法的创建表脚本";
}
+ @Override
+ public String executeAlterSql(String sql) {
+ String safe;
+ try {
+ safe = AlterTableSqlGuard.guard(sql);
+ } catch (IllegalArgumentException e) {
+ return e.getMessage();
+ }
+ jdbcTemplate.execute(safe);
+ return null;
+ }
+
@OriginServiceMethod(name="新增实体的默认属性", type = "dataDic" , description = "新增实体,默认产生createby,updatby,createtime,updatetime,version,isactive,orgid,departid")
@Override
public GeneralPOJO getTableDefaultAttribute() {
diff --git a/platform-legacy-core/src/test/java/com/dsasp/server/dataDic/service/AlterTableSqlGuardTest.java b/platform-legacy-core/src/test/java/com/dsasp/server/dataDic/service/AlterTableSqlGuardTest.java
new file mode 100644
index 0000000..4f60d78
--- /dev/null
+++ b/platform-legacy-core/src/test/java/com/dsasp/server/dataDic/service/AlterTableSqlGuardTest.java
@@ -0,0 +1,151 @@
+package com.dsasp.server.dataDic.service;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+/**
+ * P0② 引擎 ALTER 安全通道守卫。保真层(com.dsasp.*)的 DDL 此前只接受 CREATE
+ * (DataDicServiceImpl.executeCreateSql),完全不支持 ALTER。本守卫把 ALTER 从
+ * 「完全不可达」收窄为「只允许 加列 / 同族扩长 / 改可空」的最小安全集,显式拒绝
+ * 一切破坏性/不可逆 DDL(DROP COLUMN / RENAME / SET NOT NULL / 多语句 / 跨族类型 /
+ * 小写绕过 / 子查询)。规则与 MetaController.appendColumnDdl 的类型映射对齐。
+ */
+class AlterTableSqlGuardTest {
+
+ // ---------- 允许:加列 ----------
+ @Test
+ @DisplayName("加列:numeric/varchar/integer/bigint/character(36) 五类引擎类型通过,返回归一 SQL")
+ void addColumnAllowedTypes() {
+ assertEquals("ALTER TABLE EIP4_X ADD COLUMN AMOUNT numeric(18,6)",
+ AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ADD COLUMN AMOUNT numeric(18,6)"));
+ assertEquals("ALTER TABLE EIP4_X ADD COLUMN NAME character varying(200)",
+ AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ADD COLUMN NAME character varying(200)"));
+ assertEquals("ALTER TABLE EIP4_X ADD COLUMN QTY integer",
+ AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ADD COLUMN QTY integer"));
+ assertEquals("ALTER TABLE EIP4_X ADD COLUMN WHEN_AT bigint",
+ AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ADD COLUMN WHEN_AT bigint"));
+ assertEquals("ALTER TABLE EIP4_X ADD COLUMN CODE character(36)",
+ AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ADD COLUMN CODE character(36)"));
+ }
+
+ @Test
+ @DisplayName("加引用列:character(36) REFERENCES 目标表 通过")
+ void addReferenceColumnAllowed() {
+ assertEquals("ALTER TABLE EIP4_ORDER ADD COLUMN CUSTOMERID character(36) REFERENCES EIP4_CUSTOMER",
+ AlterTableSqlGuard.guard(
+ "ALTER TABLE EIP4_ORDER ADD COLUMN CUSTOMERID character(36) REFERENCES EIP4_CUSTOMER"));
+ }
+
+ // ---------- 允许:同族扩长 ----------
+ @Test
+ @DisplayName("扩长:ALTER COLUMN ... TYPE varchar(n) / numeric(p,s) 通过")
+ void widenTypeAllowed() {
+ assertEquals("ALTER TABLE EIP4_X ALTER COLUMN NAME TYPE character varying(400)",
+ AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ALTER COLUMN NAME TYPE character varying(400)"));
+ assertEquals("ALTER TABLE EIP4_X ALTER COLUMN AMOUNT TYPE numeric(20,8)",
+ AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ALTER COLUMN AMOUNT TYPE numeric(20,8)"));
+ }
+
+ // ---------- 允许:改可空 ----------
+ @Test
+ @DisplayName("改可空:ALTER COLUMN ... DROP NOT NULL 通过")
+ void dropNotNullAllowed() {
+ assertEquals("ALTER TABLE EIP4_X ALTER COLUMN NAME DROP NOT NULL",
+ AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ALTER COLUMN NAME DROP NOT NULL"));
+ }
+
+ @Test
+ @DisplayName("空白容错:首尾空白 + 单个结尾分号 被归一掉,内部多空格折叠")
+ void whitespaceNormalized() {
+ assertEquals("ALTER TABLE EIP4_X ADD COLUMN AMOUNT numeric(18,6)",
+ AlterTableSqlGuard.guard(" ALTER TABLE EIP4_X ADD COLUMN AMOUNT numeric(18,6) ; "));
+ }
+
+ // ---------- 拒绝:破坏性/不可逆 ----------
+ @Test
+ @DisplayName("拒绝:DROP COLUMN(丢数据)")
+ void rejectDropColumn() {
+ assertThrows(IllegalArgumentException.class,
+ () -> AlterTableSqlGuard.guard("ALTER TABLE EIP4_X DROP COLUMN NAME"));
+ }
+
+ @Test
+ @DisplayName("拒绝:RENAME(破坏引用)")
+ void rejectRename() {
+ assertThrows(IllegalArgumentException.class,
+ () -> AlterTableSqlGuard.guard("ALTER TABLE EIP4_X RENAME COLUMN NAME TO NAME2"));
+ }
+
+ @Test
+ @DisplayName("拒绝:SET NOT NULL(收紧约束,对存量数据不可逆)")
+ void rejectSetNotNull() {
+ assertThrows(IllegalArgumentException.class,
+ () -> AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ALTER COLUMN NAME SET NOT NULL"));
+ }
+
+ @Test
+ @DisplayName("拒绝:ADD COLUMN ... NOT NULL(有数据的表加非空列会失败)")
+ void rejectAddColumnNotNull() {
+ assertThrows(IllegalArgumentException.class,
+ () -> AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ADD COLUMN NAME character varying(200) NOT NULL"));
+ }
+
+ @Test
+ @DisplayName("拒绝:跨族类型转换(varchar→int 会丢数据/报错)")
+ void rejectCrossFamilyTypeChange() {
+ assertThrows(IllegalArgumentException.class,
+ () -> AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ALTER COLUMN QTY TYPE integer"));
+ }
+
+ // ---------- 拒绝:注入/越权 ----------
+ @Test
+ @DisplayName("拒绝:多语句(分号注入第二句)")
+ void rejectMultiStatement() {
+ assertThrows(IllegalArgumentException.class,
+ () -> AlterTableSqlGuard.guard(
+ "ALTER TABLE EIP4_X ADD COLUMN NAME integer; DROP TABLE EIP4_X"));
+ }
+
+ @Test
+ @DisplayName("拒绝:DROP TABLE / CREATE 等非 ALTER 语句")
+ void rejectNonAlter() {
+ assertThrows(IllegalArgumentException.class,
+ () -> AlterTableSqlGuard.guard("DROP TABLE EIP4_X"));
+ assertThrows(IllegalArgumentException.class,
+ () -> AlterTableSqlGuard.guard("CREATE TABLE EIP4_X (EIP4_X_ID character(36))"));
+ }
+
+ @Test
+ @DisplayName("拒绝:小写绕过(标识符必须大写,匹配引擎建表规则)")
+ void rejectLowercaseBypass() {
+ assertThrows(IllegalArgumentException.class,
+ () -> AlterTableSqlGuard.guard("alter table eip4_x add column amount numeric(18,6)"));
+ // 表名小写
+ assertThrows(IllegalArgumentException.class,
+ () -> AlterTableSqlGuard.guard("ALTER TABLE eip4x ADD COLUMN AMOUNT integer"));
+ }
+
+ @Test
+ @DisplayName("拒绝:子查询 / USING 强转 / 注释")
+ void rejectSubqueryAndUsing() {
+ assertThrows(IllegalArgumentException.class,
+ () -> AlterTableSqlGuard.guard(
+ "ALTER TABLE EIP4_X ALTER COLUMN QTY TYPE integer USING (SELECT 1)"));
+ assertThrows(IllegalArgumentException.class,
+ () -> AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ADD COLUMN NAME integer -- drop"));
+ }
+
+ @Test
+ @DisplayName("拒绝:未知类型 / 空 / null")
+ void rejectUnknownTypeAndEmpty() {
+ assertThrows(IllegalArgumentException.class,
+ () -> AlterTableSqlGuard.guard("ALTER TABLE EIP4_X ADD COLUMN ID money(1)"));
+ assertThrows(IllegalArgumentException.class,
+ () -> AlterTableSqlGuard.guard(" "));
+ assertThrows(IllegalArgumentException.class,
+ () -> AlterTableSqlGuard.guard(null));
+ }
+}
diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/MetaController.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/MetaController.java
index b589542..ee6fd43 100644
--- a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/MetaController.java
+++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/MetaController.java
@@ -275,6 +275,89 @@ public class MetaController {
return resp;
}
+ @Operation(summary = "为已建实体加列(ALTER ADD COLUMN):写 SYS_ENTITYATTRIBUTE 元数据 + 受控 ALTER 物理表(只加列,恒可空)")
+ @PostMapping("/api/meta/entity/{table}/attributes")
+ public Map addAttributes(@PathVariable String table, @RequestBody Map req) {
+ Properties ctx = UserSession.getAdmin();
+ String t = table.toUpperCase();
+ if (!t.matches("[A-Z][A-Z0-9_]{2,40}")) {
+ return err("tablename 不合法: " + t);
+ }
+ Entity ent = (Entity) dataDicService.getSYSEntityByTableName(t);
+ if (ent == null) {
+ return err("实体不存在: " + t);
+ }
+ String entityId = idOf(ent);
+ @SuppressWarnings("unchecked")
+ List