GraphQL + ElasticSearch

[toastercup]

JIRA:

https://careerbuilder.atlassian.net/browse/CE-307 (GraphQL)
https://careerbuilder.atlassian.net/browse/CE-160 (ElasticSearch Infrastructure)
https://careerbuilder.atlassian.net/browse/CE-503 (ElasticSearch FieldType Mappings)

MVP Features:

• Queries for ContentItems, FieldItems, Fields, Users and Tenants, with basic arguments (find by ID)
• Embedded GraphQL IDE
• Batched + Preloaded queries to avoid N+1 Query issues
• Rudimentary self-documented ObjectTypes
• ActiveRecord backend, no ElasticSearch utilization yet. ElasticSearch required for release of Advice & Resources
• No Sorting/Filtering/Searching Filtering and searching required for release of Advice & Resources
• No Pagination Pagination required for release of Advice & Resources
• No Mutations
• No DevKey Authentication yet
• No Authorization yet

Helpful resources:

• https://blog.codeship.com/how-to-implement-a-graphql-api-in-rails/
• https://blog.codeship.com/graphql-and-performance-in-rails/
• https://github.com/ConsultingMD/graphql-preload For ActiveRecord only
• https://github.com/exAspArk/batch-loader
• https://engineering.universe.com/batching-a-powerful-way-to-solve-n-1-queries-every-rubyist-should-know-24e20c6e7b94
• https://github.com/Shopify/graphql-batch
• https://www.apollodata.com/optics/

[toastercup]

Client-side Resources:

• https://blog.manifold.co/graphql-fragments-are-the-best-match-for-ui-components-72b8f61c20fe

[toastercup]

Particularly relevant; an ElasticSearch query builder DSL: https://github.com/elastic/elasticsearch-ruby/tree/master/elasticsearch-dsl

[toastercup]

graphql-ruby also has its own JS client: http://graphql-ruby.org/javascript_client/overview.html
It also supports subscriptions with Apollo Client: http://graphql-ruby.org/javascript_client/apollo_subscriptions.html

[toastercup]

This is what I've been loosely following for dynamically generating the schema for FieldItems: http://graphql-ruby.org/schema/dynamic_schema.html

[toastercup]

We'll be using Rails's built-in API key functionality to authenticate API users: http://api.rubyonrails.org/classes/ActiveRecord/SecureToken/ClassMethods.html

[toastercup]

Good rundown of GraphQL Query core concepts with proper terminology: https://dev-blog.apollodata.com/the-anatomy-of-a-graphql-query-6dffa9e9e747

[toastercup]

This will yield a huge benefit over how I was doing things: http://graphql-ruby.org/types/abstract_types.html

We can now group together a bunch of disparate FieldType ObjectTypes under a FieldItem abstract type, vastly simplifying our implementation and querying interface

[toastercup]

And an invaluable explanation of Interfaces and Unions: https://medium.com/the-graphqlhub/graphql-tour-interfaces-and-unions-7dd5be35de0d

[toastercup]

The approach I'm taking tonight (which should hopefully work) is to dynamically define Fields for all ContentTypes in the entire system, then whitelist access per-user by following this guide's recommendations: http://graphql-ruby.org/schema/limiting_visibility.html