用途:该技能提供在 Remix/TypeScript 应用中实施 Clean Architecture 的实践指南,重点解决 loader 与 action 随应用增长而膨胀成“God Functions”的问题,强调关注点分离。
主要能力:将代码划分为三层。Web 层(Loaders/Actions)负责解析请求、输入校验(Zod)并返回 Response(JSON/Redirect),不放业务逻辑,仅做编排。Service 层承载业务逻辑,即“做什么”,包含规则、计算、错误处理与复杂流程,且与框架无关,不应感知 Request 或 Response 对象。Repository 层负责数据访问,即“怎么做”,与数据库(Prisma)、API(Shopify Admin)或文件系统交互,且只有该层可触碰数据库/API。
目录结构:app/routes 为 Web 层,app/services 为业务逻辑,app/repositories 为数据访问,app/models 为领域类型/接口,app/utils 为纯函数。
依赖注入:属于可选但推荐的做法,复杂应用可用 tsyringe 等容器管理依赖,尤其便于测试时模拟 Repository。
错误处理:建议创建自定义 Error 类,以区分“Bad Request”(用户错误)与“Server Error”(系统错误),并在 loader/action 中捕获这些错误后返回合适的 HTTP 状态码。
适用场景:适合需要保持可维护性与可测试性的 Remix/TypeScript 应用,尤其是涉及 Shopify 等平台集成、业务规则较复杂的项目。
限制:该资料未提供具体安装命令、包名、版本要求或完整配置步骤;示例中的路径与类名需按实际项目调整。dependency injection 被标注为可选但推荐,并未强制使用特定容器。