用途:该技能用于约束业务逻辑入口(命令 Command 与查询 Query 类型)的输入字段,只允许使用基础类型,避免调用方被迫先构造领域对象。
主要能力:允许的字段类型包括字符串、数字、布尔值,以及它们的数组或列表,和仅由这些类型组成的嵌套普通数据结构(如 AddressInput、OrderLineDraft)。禁止领域实体、领域聚合、带行为的值对象、品牌或不透明基础类型(如 CustomerId、OrderId、RequesterId、Email)、日期与时间类型(应改用 ISO 8601 字符串)、枚举(应改用字符串)以及持久层类型。嵌套结构内部同样只能包含允许类型。入口负责在内部构造新领域实体或从仓储加载已有实体。
使用方式:先找出业务逻辑入口使用的 ...Command 与 ...Query 类型,逐个检查字段类型;对嵌套对象递归检查;追踪领域实体构造是否发生在入口内部。编写或修改输入类型时,从调用方实际持有的原始数据出发,用 string 表示 ID、邮箱、ISO 8601 日期、枚举值,用 number 表示数量与金额,用 boolean 表示标记;分组数据用仅含允许类型的普通输入结构,名称为输入用途(如 AddressInput、OrderLineDraft)。
适用场景:创建、修改、评审或解释命令与查询类型及其字段定义时;发现存在以领域实体或复杂对象作为输入字段的情况时。
限制:资料未提供该技能的具体安装命令、运行平台、依赖版本、收费方式与实际效果数据,这些信息暂未提供。资料中的示例涉及 TypeScript、Python 与 Kotlin,仅用于说明字段类型约束,具体落地方式需结合项目实际情况。