Knowledge Graph API

This API allows one to store facts and relations between entities. The service is configured with a schema that describes the types of entities, which keys each type requires, and what type the value of each key has. Right now, the type of a key can either be a string or an id referencing another entity.

An example json schema is provided here.

You can find the API reference here. Please don't modify this reference as I have to pay for Postman Premium to lock it :)

The database schema is located here.

How to start the server

Ensure you have Ruby 2.7.5 installed

bundle install to install dependencies
rake db:migrate to run all db migrations
rails s to start the local server
The service is now exposed at localhost:3000

How to change the schema

Modify the config/schema.json as you see fit.
rake db:reset. Note that this will also delete any entities under the old schema.

Next Steps

Configure multi-stage builds so that we can automatically detect and account for schema changes.
Add more types, and split the values table into string_values, entity_values, other_type_values tables