faasjs-react-ant-design

FaasJS React 与 Ant Design

默认工作流

1. 从 features/<feature>/ 下的功能本地文件开始。
2. 在 Ant Design 应用中使用 @faasjs/ant-design 的请求导出项，以保持请求错误和反馈的一致性。
3. 对于由组件发起的请求，使用 useFaas；对于事件处理程序，使用 faas；对于 Form 提交，使用 faas；对于流式传输，使用 useFaasStream。
4. 默认避免使用原生 useEffect；使用 FaasJS React 生命周期辅助工具处理副作用和非原始类型依赖项。
5. 对于数据变化需要在独立组件或组件树之间传播的共享状态，使用 createProxyStates。
6. 对于 CRUD，应基于共享功能元数据组合列表、详情、创建/更新和删除，而不是为每种操作单独编写一次性流程。

加载这些参考资料

• 组件和 Hook 规则：references/guidelines/react.md。
• 请求流程选择和生命周期控制：references/guidelines/react-data-fetching.md。
• @faasjs/ant-design 页面、路由、CRUD 和反馈模式：references/guidelines/ant-design.md。
• React 请求流程和组件测试：references/guidelines/react-testing.md。
• 完整的 CRUD 垂直切片组合：references/guidelines/crud-patterns.md。

注意事项

• 在 Ant Design 应用中，从 @faasjs/ant-design 导入 faas、useFaas、useFaasStream、FaasReactClient、FaasDataWrapper 和 withFaasData。
• 从 @faasjs/react 导入 createProxyStates；创建稳定的功能本地状态通道，并导出生成的 useXxx、setXxx 和 xxxRef 辅助项。
• 在调用位置解构 Hook 返回值；不要保留宽泛的 result 或 states 对象。
• 默认将 React 事件处理程序内联编写；仅在需要复用或存在实际边界时才提取出来。
• 对于对象或数组依赖项，使用相等性记忆化/副作用辅助工具，而不是原生依赖项数组。
• 使用 hidden 控制字段可见性，使用 if(values) 根据值控制可见性；当 props 或相关值发生变化时，再次测试可见性。
• 组件本地状态优先使用 useStates 或 useStatesRef，Provider 作用域内的共享状态使用 createSplittingContext；当数据变化通知需要跨组件传播时，无论 setter 在何处调用，都应使用 createProxyStates。

验证

• 使用 vp test <pattern> 运行受影响的组件、Hook 或请求流程测试。
• 在请求层 React 测试中使用 setMock。
• UI 文件发生更改后，交接前运行 vp check --fix。