SuperAPI AI 工具集

react-nextjs-frontend-architecture

前端与建站

查看项目

更新于 10-16 06:43

技能介绍

用途:在 React 与 Next.js 中构建特性页面、仪表盘或流程,重构前端目录结构、状态策略与渲染模式,并提升前端可靠性与运行时性能。

工作流:按页面选择路由与渲染模型(SSR、SSG、ISR、客户端水合);定义目录与组件边界(特性模块、共享原语、hooks);实现类型化服务客户端访问 API 并做显式错误归一化;按生命周期管理状态(服务端状态、URL 状态、本地 UI 状态、表单状态);用 suspense 边界、骨架屏与重试交互保证韧性;合并前校验无障碍、包体积与 Core Web Vitals。

架构规则:数据获取靠近路由边界;当 URL 或服务端状态足够时避免全局状态;展示组件与数据编排组件分离;用类型化 DTO 映射避免后端内部结构泄漏到 UI;把加载与错误状态当作一等行为。

必要检查:模态与路由切换下键盘导航与焦点恢复可用;顶层路由树有错误边界;关键用户旅程在慢网络下可接受;客户端包体积新增经审查与论证;高流量页面有视觉回归覆盖。

决策框架:静态或可缓存内容优先服务端组件,仅交互部分用客户端组件;可分享筛选与分页优先 URL 状态;团队归属清晰时优先就近特性模块而非集中式大目录;路由延迟超标时先评估流式渲染、预取与缓存再验证,而非引入新库。

常见误区:单一全局 store 往往增加耦合,应选最小状态范围;无障碍后补成本高,应在构建期包含语义与焦点行为;引入大型 UI 依赖前先验证包体积与维护成本。

证据包:按路由的渲染策略表;变更前后性能快照(LCP、INP、CLS 或等价指标);变更面的无障碍检查;加载/错误/空/成功状态的测试证据。

退出标准:特性与现有设计系统原语集成;状态与 API 边界明确可维护;无障碍与性能回归已处理或记录。

限制:资料未提供具体安装命令、依赖版本、代码示例与支持平台信息。