用途:在规划 Python 后端项目布局、落地整洁架构时,帮助明确依赖方向、端口与适配器以及运行时边界。
主要能力与规则:让领域决策独立于 HTTP、数据库、环境变量和队列客户端;在调用方需要替换实现的地方定义端口,并在边缘实现适配器;在启动或装配模块中组合运行时依赖;把契约、策略和规范化辅助函数视为独立模块。
使用方式(Recipe):将纯契约与策略放在 domain/application 模块;保持适配器轻薄,如 DB、HTTP、bot、MCP、subprocess、storage;把工作流编排推入调用契约与端口的服务;将报告格式化与事实收集分离;在移动边界代码前补充聚焦的回归测试。
反模式:不要做虚假的整洁架构表演,文件夹必须对应真实归属;领域策略中不得导入 DB;不要把启动装配隐藏在模块全局变量中;不要写横跨解析、分发、校验和通知的单函数运行时大块代码。
限制:资料未提供具体安装命令、代码示例、收费或平台信息。