SuperAPI AI 工具集

phase-6-ui-integration

前端与建站

查看项目

更新于 10-16 02:14

技能介绍

用途

本阶段用于实现实际的前端界面,并将其与后端 API 集成。具体包括:使用设计系统组件开发各个页面、管理客户端状态、调用后端 API、处理加载与错误状态。

主要能力

页面实现

开发每个屏幕页面,产出页面组件(pages)、功能组件(features)和 API 调用钩子(hooks)。

集中式 API 客户端架构

采用三层结构:

  • UI 组件层(pages、features、hooks)
  • Service 层(按领域划分的 API 调用函数,如 authService、productService、orderService)
  • API Client 层(通用设置、拦截器、错误处理,如 apiClient)

集中式客户端的优势:统一错误处理逻辑、自动注入认证令牌、标准化响应格式、端点变更时单点管理、便于测试与 mock 替换。

Service 层模式

按领域拆分服务文件,例如 auth.service.ts、product.service.ts、order.service.ts,每个服务仅使用 apiClient。

错误处理

提供全局错误处理器,按错误码分类处理:认证错误重定向、权限错误提示、网络错误提示、表单验证错误交由表单处理。同时提供 ApiError 类,包含 isValidationError、isAuthError、isForbiddenError、isNotFoundError 等判断方法。

客户端-服务端类型共享

提供三种方式:共享包(Monorepo)、从 API 规范自动生成类型、tRPC / GraphQL CodeGen 自动推断。

API 集成模式

支持基础 fetch 模式、React Query 模式、SWR 模式。

状态管理指南

  • 服务端状态(API 数据)→ React Query / SWR
  • 客户端状态(UI 状态)→ useState / useReducer
  • 全局状态(认证等)→ Context / Zustand
  • 表单状态 → React Hook Form

零脚本 QA

通过日志验证 UI 行为,例如登录流程的日志输出。

使用方式

本阶段遵循 PDCA 循环:

  • Plan:定义要实现的屏幕/功能
  • Design:组件结构、状态管理设计
  • Do:UI 实现 + API 集成
  • Check:零脚本 QA
  • Act:修复缺陷并进入 Phase 7

按级别应用:

  • Starter:仅静态 UI(无 API 集成)
  • Dynamic:完整集成
  • Enterprise:完整集成 + 优化

适用场景

适用于需要将前端界面与后端接口对接的开发项目,尤其是采用 React 生态、需要统一 API 调用规范和错误处理机制的前端工程。

限制

资料未提供具体的收费、价格、平台限制等信息。