用途:在全栈项目中校验、实现和维护 Clean Architecture 模式,包括架构一致性检查、层边界强制与引导式重构。
主要能力:按四层组织代码。第 1 层实体(领域核心)为纯业务逻辑,无框架依赖;第 2 层用例(应用逻辑)编排业务流程,依赖实体并返回 Result 对象;第 3 层接口适配器在应用核心与外部关注点之间转换;第 4 层框架与驱动为外部工具配置,不针对其编码。
一致性校验清单覆盖依赖方向与结构健康:模型不得导入控制器、序列化器或任务;服务不得返回 HTTP 状态码或渲染响应,也不得导入控制器或序列化器;控制器只做授权、调用服务、序列化响应;序列化器不得查询数据库或含业务逻辑;Sidekiq 任务委托给服务对象;React Native 屏幕委托给 hooks,hooks 不得导入 UI 组件;领域类型为纯 TypeScript;Zustand 存储只含客户端状态。结构上要求每个服务对象只有一个公开 call 方法,控制器最多 5 个公开动作,值对象不可变,服务间无循环依赖,API 客户端在边界处把响应转换为领域类型。Vite SPA 要求页面调用 hooks 而非直接调用 API 客户端,路由全部懒加载。Next.js App Router 要求 server actions 用 zod 校验输入、不导入 React 组件或返回 JSX,页面用 Server Components 取数,客户端组件为叶子级交互部分。
常见重构模式:从控制器抽取服务、从屏幕抽取 hook、从页面抽取 hook、从 Server Component 抽取客户端组件、从模型抽取值对象、为外部服务抽取适配器。
限制:资料未提供安装命令、收费方式、平台支持范围与具体使用步骤;完整代码示例见 references/layer-examples.md。