SuperAPI AI 工具集

business-logic-typical-domain-entity-entry-points

智能体与模型

查看项目

更新于 10-15 20:13

技能介绍

用途:当需要决定围绕某个领域实体类型实现哪些业务逻辑入口点时,优先采用一套标准入口点,而不是临时发明操作。以领域实体为组织中心,先确定实体类型,再按业务操作种类选择入口点。

主要能力与标准入口点:create(创建实体);update(仅更新取值空间近乎无限的字段,如 string、int、decimal、url、date、datetime、text、名称、描述、备注、计数、限额等);find by id(按标识返回实体,不存在时返回 null、undefined、None、Optional<T> 等该技术栈惯用的缺失值,缺失是有效结果而非失败);search(返回集合,支持任意字段或组合过滤、分页与排序);delete by id(按 id 删除);check whether ... can ...(返回布尔值,表示某业务操作当前是否被允许)。

按操作种类选择:有限状态变更(枚举状态、表示状态的布尔值、有业务含义的生命周期标志)应使用显式 mark as 入口点,如 markUserAsEnabled、markCourseAsCancelled,不要藏在 update 里。实体关联变更(一对多、多对多)应使用显式 assign/add 入口点,如 assignPermissionToRole、addUserToCourse、removeUserFromCourse、unassignPermissionFromRole,按业务含义选择 assign、add、remove、unassign 中最贴切的动词。可行性检查使用显式 check whether 入口点返回布尔值,如 checkWhetherPostCanBePublished、checkWhetherRoleCanBeDeleted,仅用于判断是否允许,不执行动作本身。

CQS 对齐:遵循命令查询分离时,create、update、delete by id、mark as、assign、add 属于命令;find by id、search、check whether can 属于查询。若其他技能已规定 CQS 返回形状、签名或载荷类型,仍应遵守。

使用方式(检测流程):从领域实体出发,识别操作作用的主要实体类型与真实业务操作,判断是创建、编辑开放字段、按 id 获取、搜索、删除、有限状态变更、关联还是可行性检查;先选标准入口点种类,再考虑自定义;拒绝语义更具体时仍被重载的 update。

限制与注意:update 应严格限制在近乎无界的字段,不得吸收业务状态转换或关联操作;find by id 的底层仓储操作在未找到时不应抛异常;search 应保持宽泛且结构化,避免默认创建大量狭窄的列表式入口点。资料未提供具体安装命令、收费、平台或效果信息。