diff --git a/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessModelController.java b/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessModelController.java
index 6636dc3..a9613c4 100644
--- a/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessModelController.java
+++ b/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessModelController.java
@@ -38,11 +38,18 @@ import io.swagger.v3.oas.annotations.tags.Tag;
* 不进部署库;发布(T3.1)时才 restore 中文原 key + 校验门 + deploy。act_re_model 表已有 143 行存量、schema 已在,
* {@code databaseSchemaUpdate=false} 不涉 DDL。
*
- * 写入前 XML 一律过 {@link BpmnXMLConverter} 解析守卫(validateSchema=true):坏 XML 返 422 且绝不落库。
+ *
存量隔离:本控制器建的草稿一律 {@code setCategory("eip4")},{@link #list()} 只查该分类,
+ * 库里 143 条老 shape act_re_model(旧 metaInfo + 可能悬空 editorSource)不进 Modeler 列表、避免打不开。
+ *
+ * 写入前 XML 一律过 {@link BpmnXMLConverter} 解析守卫(validateSchema=true + enableSafeBpmnXml=true,
+ * 后者关外部 DTD/实体解析,防 XXE/SSRF):坏 XML 返 422 且绝不落库;422 只回通用文案,原始解析原因仅进日志。
* 守卫异常在本控制器就地 catch 转 422,不逸出到 {@code FlowExceptionHandler}(那里 FlowableException→400,语义不符)。
* {@code from-procdef} 复用「按 procDefId 读部署 BPMN」逻辑(本控制器自带 {@link #readProcessModel} 小方法,
* 零改动 ProcessDiagramController)→ {@link BpmnIdSanitizer#sanitize} 净化中文 id → 建草稿,
* 原→净化映射连同源 procDefId/原 key 写进 metaInfo,供发布逆向还原。
+ *
+ * 鉴权:本控制器随 flowable-service 跑在裸 8089,进程本身无鉴权栈;所有写端点
+ * (POST/PUT/from-procdef)必须经 platform-flow-gateway 的超管门访问(T2.2),生产环境 8089 不对外暴露。
*/
@RestController
@RequestMapping("/api/flow")
@@ -51,6 +58,9 @@ public class ProcessModelController {
private static final Logger log = LoggerFactory.getLogger(ProcessModelController.class);
+ /** EIP4 草稿分类:建草稿时打此标,list() 只查此分类,隔离库里 143 条老 shape 存量 act_re_model。 */
+ static final String EIP4_CATEGORY = "eip4";
+
private final RepositoryService repositoryService;
private final ObjectMapper objectMapper = new ObjectMapper();
@@ -60,9 +70,11 @@ public class ProcessModelController {
@GetMapping("/models")
@Operation(summary = "草稿列表",
- description = "createModelQuery().orderByLastUpdateTime().desc() → {models:[{id,name,key,lastUpdateTime(ISO)}]}。")
+ description = "createModelQuery().modelCategory(\"eip4\").orderByLastUpdateTime().desc() → "
+ + "{models:[{id,name,key,lastUpdateTime(ISO)}]}。只列 EIP4 建的草稿,隔离存量 act_re_model。")
public ResponseEntity