SuperAPI AI 工具集

The Standard Architecture

编程与开发

查看项目

更新于 10-15 22:12

技能介绍

用途:该技能将 The Standard 的架构章节落地为可执行的规则,指导系统按目的、依赖与暴露进行分解,适用于系统设计、架构评审、拆分、重构、API 设计、UI 架构与依赖流设计。

主要能力:明确覆盖建模(数据载体模型、主/次/关系/混合模型,以及集成、处理、暴露、配置等运维模型)、Broker、服务、聚合(The Knot)、Exposer、通信协议、REST API 与用户界面。

核心规则:低层含义为 Broker=依赖、Service=目的、Exposer=暴露;数据流只能向前:Exposer -> Service -> Broker -> 外部资源,不得反向、不得模糊层级、不得用魔法抽象隐藏架构。Broker 实现本地接口、不含任何业务逻辑或分支与迭代(无 if、三元、switch、循环或 LINQ),不处理异常,不调用其他 Broker 或服务,一个资源一个 Broker,并拥有自己的配置。服务承担业务逻辑,分为验证器、编排器、聚合器;要么做要么委托,不能同时;同层服务之间、同层公共 API 之间不得互相调用;必须前置验证并按结构、逻辑、外部顺序进行。Foundation 服务贴近 Broker,保持纯原始类型、单实体集成,把技术语言翻译为业务语言(Insert->Add、Select->Retrieve 等)。公共接口方法统一返回 ValueTask 或 ValueTask<T>,不得使用 ValueTask.FromResult,无实际等待时也应标为 async 并直接返回值;Catch 块需使用 throw await。

用法:在识别出具体架构模式时激活相应技能,如 CulDeSac 事件相关使用 the-standard-events,版本化与弃用使用 the-standard-versioning,不要等实现开始后才激活。

适用场景:系统设计、架构评审、职责归属判断、依赖流设计、API 与 UI 架构以及重构。

限制:本技能只定义结构规则,具体模式的详细实现由专门技能负责;事件代理、发布订阅、DI 注册与启动激活不在本技能范围;版本化、弃用同样由延伸技能治理。资料未提供安装命令、价格、平台或效果信息。