用途：在 Rails 项目中使用 graphql-ruby gem 构建 GraphQL API 时，提供可复用的模式与目录约定，适用于 schema 与类型设计、resolver 和 mutation 实现、查询优化、认证授权、实时订阅以及 app/graphql 结构组织。
主要能力与约定：类型定义放在 app/graphql/types/，查询入口在 app/graphql/types/query_type.rb，写入操作在 app/graphql/mutations/，查询逻辑在 app/graphql/resolvers/，DataLoader 批处理在 app/graphql/sources/。文档 patterns.md 提供带示例的完整模式。
用法要点：类型字段需显式声明类型与 null 约束；mutation 通过 argument 接收输入并返回结构化结果与 errors；使用 DataLoader 按 id 批量加载关联记录，避免 N+1；在字段级检查权限；以结构化错误返回而非抛出异常。示例中类型可定义 posts_count，并在方法内使用 object.posts.size 以配合计数器缓存；resolver 可通过 dataloader.with(Sources::RecordLoader, User).load(object.user_id) 加载数据。
适用场景：Rails 应用的 GraphQL schema 设计、查询与变更实现、关联数据批量加载、实时订阅、权限控制及目录结构规范。
限制：资料未提供安装命令、版本要求、具体配置、性能测试数据、平台或收费信息，暂未提供。