SuperAPI AI 工具集

business model builder

编程与开发

查看项目

更新于 10-16 18:00

技能介绍

用途:该技能面向 Python 业务模型架构,帮助创建和重构基于 dataclass 的业务模型及 mapper,遵循整洁架构与关注点分离。

主要能力:在 epistemix_platform/src/epistemix_platform/ 下,models/ 存放纯数据容器形式的业务/领域模型,mappers/ 负责业务模型与 ORM 模型之间的转换。模型负责自身业务规则与数据校验,可包含只读派生属性;用例逻辑放在 use_cases/,仓储在 repositories/ 中通过 mapper 持久化或读取模型,控制器在 controllers/ 中编排用例并暴露接口。

使用方式:创建模型时分析所需字段,设计清晰命名的 dataclass,为所有字段和属性添加类型提示,合理使用 field(default=...) 或 field(default_factory=...) 设置默认值,必要时使用 frozen=True;用 post_init 做字段校验;@property 仅用于基于现有字段的只读计算或格式转换。示例模式包含 Product dataclass,含 name、sku、price、category、inventory_count、tags、created_at、id 等字段,并在 post_init 中校验价格与库存非负,提供 is_in_stock 与 display_price 属性。

适用场景:需要按整洁架构组织 Python 业务模型、在 ORM 与领域模型之间做转换、并保持模型为纯数据容器的项目。

限制:不添加应用逻辑或编排(属于用例)、不依赖外部服务或仓储、不实现 dataclass 自动生成之外的比较方法、不添加可变状态管理或事件处理、不创建模型间循环依赖。输出为完整可运行的 Python 代码,包含必要导入、复杂设计的内联注释及全部类型提示。具体安装命令、收费与平台信息暂未提供。