枚举总表

本文档汇总后端 foundry-definition-spec-api 模块 com.loambase.foundry.definition.spec.enums 包下的全部枚举，按语义分组整理。每个枚举列出所有常量取值及其含义。

资源与变更

枚举	取值	说明
`DefinitionResourceTypeEnum`	`OBJECT_TYPE`, `PROPERTY`, `LINK_TYPE`, `METRIC`, `ACTION`, `ACCESS_POLICY`, `PAGE_VIEW`, `APP`, `DATASET`, `DATASOURCE`, `PIPELINE`, `WORKFLOW`, `ANALYSIS_PLAN`	`OBJECT_TYPE`：对象类型；`PROPERTY`：属性；`LINK_TYPE`：关联类型；`METRIC`：指标；`ACTION`：动作；`ACCESS_POLICY`：访问策略；`PAGE_VIEW`：页面视图；`APP`：应用；`DATASET`：数据集；`DATASOURCE`：数据源；`PIPELINE`：管道；`WORKFLOW`：工作流；`ANALYSIS_PLAN`：分析计划
`DefinitionSourceTypeEnum`	`FE`, `CLI`, `BUNDLE`	`FE`：前端编辑生成；`CLI`：命令行工具生成；`BUNDLE`：资产包安装生成
`MutationActionEnum`	`CREATED`, `UPDATED`, `UNCHANGED`, `DELETED`, `BLOCKED`, `RESTORED`	`CREATED`：新建资源；`UPDATED`：更新已有资源；`UNCHANGED`：资源无变化；`DELETED`：删除资源；`BLOCKED`：变更被阻塞；`RESTORED`：恢复已下线资源
`OntologyMutationAction`	`CREATED`, `UPDATED`, `UNCHANGED`, `DELETED`	`CREATED`：新建资源；`UPDATED`：更新已有资源；`UNCHANGED`：资源无变化；`DELETED`：删除资源，仅出现在集合 sync 的 REPLACE 模式
`MutationResultStatusEnum`	`APPLIED`, `STAGED`, `MATERIALIZED`, `PUBLISHED`, `SKIPPED`, `SKIPPED_NOT_MATERIALIZED`, `FAILED`, `DELETED`, `SOFT_DELETED`, `SKIPPED_NOT_MANAGED`, `SKIPPED_HARD_DROP_DISABLED`	`APPLIED`：已应用；`STAGED`：已暂存；`MATERIALIZED`：已物化；`PUBLISHED`：已发布；`SKIPPED`：已跳过；`SKIPPED_NOT_MATERIALIZED`：因未物化而跳过；`FAILED`：失败；`DELETED`：资源已被从定义层删除；`SOFT_DELETED`：资源/列已逻辑下线，未执行物理删除；`SKIPPED_NOT_MANAGED`：因资源非本包管理而跳过删除；`SKIPPED_HARD_DROP_DISABLED`：因未启用 hard drop 而跳过物理删列
`DefinitionBundleSyncModeEnum`	`UPSERT`, `REPLACE`	`UPSERT`：仅对传入资源做 upsert，不删除未出现的资源；`REPLACE`：以请求中的资源集合作为目标状态，缺失且由本包管理的资源执行删除

定义生命周期

枚举	取值	说明
`DefinitionDraftStateEnum`	`NEW`, `MODIFIED`, `SYNCED`	`NEW`：只有草稿，从未发布过；`MODIFIED`：已发布过，但当前草稿存在未发布的变更；`SYNCED`：已发布，且当前草稿与已发布版本一致
`DefinitionProjectionStatusEnum`	`PENDING`, `PROJECTING`, `SUCCESS`, `FAILED`	`PENDING`：等待投影；`PROJECTING`：投影中；`SUCCESS`：投影成功；`FAILED`：投影失败
`DefinitionResourceStatusEnum`	`ACTIVE`, `DEPRECATED`, `DELETED`	`ACTIVE`：活跃可用；`DEPRECATED`：已弃用；`DELETED`：已删除
`AssetStatus`	`DRAFT_ONLY`, `PUBLISHED`, `MODIFIED`, `PUBLISHING`, `PUBLISH_FAILED`	`DRAFT_ONLY`：只有草稿，从未发布过；`PUBLISHED`：已发布且当前草稿与已发布版本一致；`MODIFIED`：已发布过，但当前草稿存在未发布的变更；`PUBLISHING`：正在发布中（投影异步执行）；`PUBLISH_FAILED`：最近一次发布失败
`RuntimeStatus`	`READY`, `MISSING`, `OUTDATED`, `ERROR`	`READY`：运行态已就绪，且与已发布定义一致；`MISSING`：尚未发布，或发布后未生成运行态实例；`OUTDATED`：运行态存在，但与已发布定义不一致（需要重新发布）；`ERROR`：运行态存在，但最近同步/投影失败
`DefinitionRiskLevelEnum`	`HIGH`, `MEDIUM`, `LOW`	`HIGH`：高风险；`MEDIUM`：中风险；`LOW`：低风险

属性相关

枚举	取值	说明
`PropertyDataTypeEnum`	`STRING`, `INTEGER`, `LONG`, `NUMBER`, `DOUBLE`, `BOOLEAN`, `DATE`, `DATETIME`, `TIMESTAMP`, `ENUM`, `REFERENCE`, `COMPUTED`, `JSON`, `ARRAY`, `OBJECT`	`STRING`：字符串；`INTEGER`：整数；`LONG`：长整数；`NUMBER`：数字；`DOUBLE`：浮点数；`BOOLEAN`：布尔；`DATE`：日期；`DATETIME`：日期时间；`TIMESTAMP`：时间戳；`ENUM`：枚举；`REFERENCE`：引用；`COMPUTED`：计算；`JSON`：JSON；`ARRAY`：数组；`OBJECT`：对象
`PropertyKindEnum`	`STORED`, `DERIVED`, `AGGREGATED`, `DYNAMIC`	`STORED`：存储属性；`DERIVED`：派生属性；`AGGREGATED`：聚合属性；`DYNAMIC`：动态属性
`StabilityLevelEnum`	`DETERMINISTIC`, `CONTEXTUAL`, `VOLATILE`	`DETERMINISTIC`：确定性；`CONTEXTUAL`：上下文相关；`VOLATILE`：易变
`MaterializationStrategyEnum`	`NONE`, `CACHE`, `VIEW`, `COLUMN`	`NONE`：不物化；`CACHE`：缓存物化；`VIEW`：视图物化；`COLUMN`：列物化
`ReferenceTypeEnum`	`SINGLE`, `MULTI`	`SINGLE`：单值引用；`MULTI`：多值引用
`CascadeRuleEnum`	`NONE`, `RESTRICT`, `CASCADE`, `SET_NULL`	`NONE`：不做级联；`RESTRICT`：限制删除；`CASCADE`：级联变更；`SET_NULL`：置空
`LoadStrategyEnum`	`DEFAULT`, `EAGER`, `LAZY`, `ON_DEMAND`	`DEFAULT`：默认加载；`EAGER`：预加载；`LAZY`：懒加载；`ON_DEMAND`：按需加载
`PropertySyncMode`	`MERGE`, `REPLACE`	`MERGE`：仅对传入属性做 upsert，不删除未出现属性；`REPLACE`：以请求中的属性集合作为目标状态，缺失属性执行删除

关联与过滤

枚举	取值	说明
`CardinalityEnum`	`ONE_TO_ONE`, `ONE_TO_MANY`, `MANY_TO_MANY`	`ONE_TO_ONE`：一对一；`ONE_TO_MANY`：一对多；`MANY_TO_MANY`：多对多
`JoinTypeEnum`	`DIRECT`, `BRIDGE`	`DIRECT`：直接关联；`BRIDGE`：桥接关联
`FilterOperatorEnum`	`EQUALS`, `NOT_EQUALS`, `GREATER_THAN`, `GREATER_THAN_OR_EQUALS`, `LESS_THAN`, `LESS_THAN_OR_EQUALS`, `IN`, `NOT_IN`, `CONTAINS`, `STARTS_WITH`, `ENDS_WITH`, `BETWEEN`, `LIKE`, `IS_NULL`, `IS_NOT_NULL`	`EQUALS`：等于；`NOT_EQUALS`：不等于；`GREATER_THAN`：大于；`GREATER_THAN_OR_EQUALS`：大于等于；`LESS_THAN`：小于；`LESS_THAN_OR_EQUALS`：小于等于；`IN`：包含于；`NOT_IN`：不包含于；`CONTAINS`：包含；`STARTS_WITH`：前缀匹配；`ENDS_WITH`：后缀匹配；`BETWEEN`：区间；`LIKE`：模糊匹配；`IS_NULL`：为空；`IS_NOT_NULL`：非空
`FilterLogicOperatorEnum`	`AND`, `OR`	`AND`：且；`OR`：或

动作与指标

枚举	取值	说明
`ActionTypeEnum`	`UPDATE_FIELD`, `CREATE_OBJECT`, `DELETE_OBJECT`, `UPSERT_OBJECT`, `LINK_OBJECT`, `UNLINK_OBJECT`, `FUNCTION_BACKED`	`UPDATE_FIELD`：更新字段；`CREATE_OBJECT`：创建对象；`DELETE_OBJECT`：删除对象；`UPSERT_OBJECT`：创建或更新对象；`LINK_OBJECT`：关联对象；`UNLINK_OBJECT`：取消关联对象；`FUNCTION_BACKED`：函数 backed 动作
`BindingTypeEnum`	`SINGLE_INSTANCE`, `TRANSITION`, `SIDE_EFFECT`, `QUERY`, `VALIDATION`	`SINGLE_INSTANCE`：单对象动作；`TRANSITION`：状态迁移动作；`SIDE_EFFECT`：副作用动作；`QUERY`：查询动作；`VALIDATION`：校验动作
`ExecutionTypeEnum`	`IMMEDIATE`, `SCHEDULED`, `WORKFLOW`, `FUNCTION`	`IMMEDIATE`：立即执行；`SCHEDULED`：计划执行；`WORKFLOW`：工作流执行；`FUNCTION`：函数执行
`VisibilityRuleTypeEnum`	`ALWAYS`, `CONDITIONAL`, `ROLE_BASED`	`ALWAYS`：始终可见；`CONDITIONAL`：条件可见；`ROLE_BASED`：基于角色可见
`MetricTypeEnum`	`BASE`, `AGGREGATE`, `DERIVED`, `COMPOSITE`	`BASE`：基础指标；`AGGREGATE`：聚合指标；`DERIVED`：派生指标；`COMPOSITE`：组合指标
`AggregateTypeEnum`	`COUNT`, `SUM`, `AVG`, `MIN`, `MAX`, `COUNT_DISTINCT`	`COUNT`：计数；`SUM`：求和；`AVG`：平均值；`MIN`：最小值；`MAX`：最大值；`COUNT_DISTINCT`：去重计数
`ComputeTypeEnum`	`DERIVED`, `AGGREGATED`, `DYNAMIC`	`DERIVED`：表达式派生；`AGGREGATED`：关系聚合；`DYNAMIC`：运行时动态计算

数据集与物化

枚举	取值	说明
`DatasetBindingModeEnum`	`EXTERNAL`, `MANAGED`	`EXTERNAL`：外部数据集，对象语义映射到已有物理表，物理 schema 由外部系统控制；`MANAGED`：平台托管，由 Foundry 自动生成 dataset/table/schema 并负责增量演进
`MaterializationModeEnum`	`INITIAL_CREATE`, `ALTER_SCHEMA`, `NONE`	`INITIAL_CREATE`：首次创建 dataset/table/columns；`ALTER_SCHEMA`：增量修改 schema（加列/改列/约束）；`NONE`：不需要物化操作

发布与版本

枚举	取值	说明
`DefinitionVersionIntentEnum`	`DRAFT_SNAPSHOT`, `APPLIED`, `ROLLBACK_DRAFT`, `ROLLBACK_APPLIED`, `ROLLBACK_PUBLISHED`, `IMPORTED`	`DRAFT_SNAPSHOT`：用户显式保存当前草稿生成的草稿快照；`APPLIED`：通过 apply/publish 等标准写入流程生成的版本；`ROLLBACK_DRAFT`：从历史版本恢复为当前草稿时生成的版本；`ROLLBACK_APPLIED`：回滚到历史版本并直接固化为最新 applied 版本时生成的版本（`:rollback` 端点）；`ROLLBACK_PUBLISHED`：回滚已发布版本到 runtime 时生成的版本；`IMPORTED`：通过 import/bundle apply 等批量导入流程生成的版本
`DefinitionReleaseKindEnum`	`PUBLISH`, `ROLLBACK`, `RESTORE`	`PUBLISH`：正常发布；`ROLLBACK`：回滚后重新发布；`RESTORE`：从草稿恢复后发布
`DefinitionHistoryLineEnum`	`ALL`, `DRAFT`, `PUBLISHED`	`ALL`：全部历史版本；`DRAFT`：草稿版本线，由 DRAFT_SNAPSHOT 或 ROLLBACK_DRAFT 意图产生；`PUBLISHED`：已发布版本线，published = true 的版本