SuperAPI AI 工具集

react frontend architecture

前端与建站

查看项目

更新于 10-15 21:10

技能介绍

用途:为 React 项目提供架构基础规范,保证可维护性、可扩展性与严格的关注点分离。

主要能力:

  1. 项目结构:采用 Features-First(领域驱动)组织 src 目录,包含 app、assets、components(ui/layout)、features/[feature](components、hooks、api、types)、hooks、lib、services、store、utils、types。
  2. 组件架构:采用类 MVC 的 ViewModel 模式,UI 组件不含业务逻辑。每个组件为目录,含 MyComponent.tsx(视图)、MyComponent.hook.ts(逻辑)、MyComponent.type.ts(类型)、MyComponent.css、index.ts,可选 components 子目录。视图只渲染 JSX 与绑定事件,禁止 useEffect(纯 UI 动画除外)与复杂计算;hook 负责本地状态、副作用、数据获取与派生计算,返回 Use[Name]Result 接口;type 文件集中定义 Props、State、Actions、API 类型;api/*.ts 为服务层,只处理 HTTP 细节并返回类型化 Promise。
  3. 命名约定:目录中组件/页面用 PascalCase,工具/钩子/库用 camelCase;文件组件用 PascalCase.tsx,钩子用 use 前缀 camelCase.ts,逻辑用 [Component].hook.ts,类型用 [Component].type.ts,样式用 [Component].module.css;布尔变量用 is/has/should 前缀,处理函数用 handle 前缀,传递的处理函数用 on 前缀。
  4. Next.js 指南:*.hook.ts 模式仅用于客户端组件('use client');服务端组件用于初始数据获取以减少客户端 JS 体积,边界保持在页面层级并向下传递数据。
  5. 样式架构:避免全局 CSS,globals.css 仅用于重置与根变量;z-index 通过全局变量或 CSS 变量管理;设计系统值必须来自 CSS 变量或 Tailwind 工具类,禁止魔法色值。

使用方式:按上述目录与文件结构组织代码,遵循命名与职责划分,将业务逻辑放入 hook,视图保持声明式。

适用场景:需要长期维护、多人协作、规模增长的 React 前端项目。

限制:资料未提供具体安装命令、依赖版本、收费信息或平台要求;规范为约定性指南,需团队自行落地执行。