Exchange

Exchange aspires to be responsible for the various types of e-commerce interactions available on the Artsy platform. It's currently a prototype, with legacy e-commerce still handled by Gravity. It uses Ruby, Rails, Postgresql, and exposes a GraphQL API.

Meta

• State: development
• Production: https://exchange.artsy.net, Admin Dashboard | Sidekiq Dashboard
• Staging: https://exchange-staging.artsy.net, Admin Dashboard | Sidekiq Dashboard
• GitHub: https://github.com/artsy/exchange/
• Point People: @ashkan18, @williardx

Setup

• Fork the project to your GitHub account

• Clone your fork:

  $ git clone git@github.com:your-github-username/exchange.git
  

• Install bundles:

  $ bundle install
  

Tests

Once setup, you can run the tests like this:

$ bundle exec rspec

Starting Server

If this is your first time starting the app, make sure your database is setup first by running:

rails db:create
rails db:setup

$ rails s

Did You Change GraphQL Schema?

Metaphysics is the current consumer of Exchange GraphQL schema and keeps a copy of latest schema in https://github.com/artsy/metaphysics/tree/master/src/data, if you have changed Exchange GraphQL schema, make sure you also update the copy of this schema in Metaphysics. In order to do so follow these steps:

1. In exchange run

rake graphql:schema:idl

2. rename schema.graphql file generated ☝🏼 to exchange.graphql

mv schema.graphql exchange.graphql

3. copy file above to your local update Metaphysics under src/data and make a PR to Metaphysics with this change

Talking to Exchange 🤑

In order to talk to Exchange GraphQL endpoint:

• Copy .env.example to .env
• Update the REPLACE_ME values in the .env file. You can reference the values used on staging with hokusai staging env get.
• Install dotenv by gem install dotenv
• Start local server dotenv rails s
• If you work at Artsy, get proper Gravity User Token following these instructions (the client application name is "Exchange Staging").
• Install and run GraphiQL app brew cask install graphiql
• In GraphiQL app, go to http://localhost:300/api/graphql, you should ge unauthorized error
• Edit HTTP Headers and add Authorization header and set it to Bearer <token> where <token> is your Gravity token generated few steps above.

Working at Artsy?

We share our GraphQL sample queries using Insomnia shared workspace. You can import latest queries from environments_and_requests.json

Debugging

Something went wrong? Ideally in the JSON response returned from Exchange there will be enough info to describe what went wrong. In case that was not useful, you can:

1. Check Sentry (password in 1Pass) and look for Exchange (staging or production) and see the error.
2. Follow exchange logs by doing

hokusai staging logs -f

If you think there is something we could improve in this error case, feel free to open an issue with details about what you did and what went wrong.