用途:端到端构建或修改 Docyrus 支持的 React TypeScript 应用,覆盖应用架构、认证、数据访问、查询模式与生产级 UI。
主要能力:集成 @docyrus/signin 认证(自动从 /v1/users/me 获取用户,提供 useDocyrusAuth 的 user、hasRole、hasPermission);用 @docyrus/app-utils 的 createInventoryClient 在登录后预热租户级内存缓存,并共享给各 app-utils 客户端;通过生成的集合钩子或 @docyrus/api-client 读写数据;用 AppConfig、UserAppConfig、DataViews 持久化应用级、用户级配置与保存的表格视图;用 @docyrus/devtools 提供开发面板(网络、错误、控制台、iframe 消息、OpenAPI 请求浏览器等)。
使用方式:推荐 React 19 + TypeScript + Vite、TanStack Router/Query/Form、Tailwind CSS v4、shadcn/ui。根节点用 DocyrusAuthProvider 包裹 QueryClientProvider 与 RouterProvider;登录后创建单个 InventoryClient 并 load(),将其传入每个 app-utils 客户端;开发构建中用 enabled={import.meta.env.DEV} 挂载 DocyrusDevtools,并用 useRegisterDocyrusClient(useDocyrusClient()) 注册客户端。
限制与规则:.list()/.get() 必须传 columns,否则只返回 id;集合是 React 钩子,需在组件内调用;数据源端点取决于租户 OpenAPI 规范;子查询键与公式键必须出现在 columns 中;不要自行调用 /v1/users/me;格式化不要硬编码区域设置;ACL 相关端点通常需直接用 useDocyrusClient();数据视图创建需 name 与 tenant_data_source_id;软删除用 archived: true,硬删除用 remove。资料未提供收费、价格与平台信息。