README

Project Credo is a tool for curating, commenting on, and sharing lists of research papers.

If you've ever done research on how coffee affects your body, interventions or preventative measures for cancers, or how to build muscle mass most effectively, you're not alone...and now you can work together to research the questions that vex humanity.

It is a humble first step on what is hopefully a path towards greater scientific consensus among both academics and laypersons.

Project Credo is open-source by design, under a GPLv3 license.

Development

Requirements:

• docker
• docker-compose
• Internet connection

Installation

1. Install docker: https://docs.docker.com/engine/installation/
2. git clone https://github.com/projectcredo/projectcredo.git (or your favorite protocol)
3. cd into the directory
4. Create a .env file in the root directory
5. docker-compose build whenever you add a gem - in this case, you'll be installing all of them
6. docker-compose run --rm app yarn to install all node dependencies, required for Webpacker
7. docker-compose run --rm app rails db:create db:schema:load db:migrate db:seed - to create the database, load the schema, migrate any lingering migrations, and then seed with test data
8. docker-compose up to run the rails server

.env file

Your .env file will be used for supplying your docker instances with environment variables, and docker won't start without it. You can cp .env.example .env to start. One of the important ones is DOCKER_HOST_IP, which will tell Rails which IP addresses are allowed to see console and debug output.

On Unix-like environments, you can use docker inspect projectcredo_postgres_1 -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' $@ to figure out your IP Address. Note: you may need to change the app name from projectcredo_postgres_1 to match your postgres docker name.

This often results in DOCKER_HOST_IP=172.18.0.1/16.

Visiting the site locally

The site's address unfortunately depends on what system you're on. Linux and Mac OS seem to be fine mounting it at localhost:3000, but on Windows, we've needed to find the docker container's IP address in order to actually see the site. You may need to figure out what your docker container's IP address is.

Troubleshooting

If you have some issues with Webpacker, try to reinstall all node dependencies with docker-compose run app yarn install --force

Working with rails inside Docker container

The development the project is setup to run in a Docker container, so instead of running commands locally like bundle or rails <command> you need to prepend them with docker-compose run app. For example, to add new gems without rebuilding the container you can run docker-compose run app bundle and then commit changes with docker commit <container ID, like projectcredo_app_run_1> projectcredo_app, to list all containers run docker ps --all.

In case you need to log in into container shell you can run docker-compose run app bash.

Contributing

Submit a pull request against the develop branch and fill out the Pull Request template.

Testing

1. docker-compose run --rm app rails db:environment:set RAILS_ENV=test
2. docker-compose run --rm app rails webpacker:compile - if assets were not compiled previously (remove public/packs if command is not compiling assets)
3. docker-compose run --rm app rspec

Helpful commands

Backup database pg_dump -h <host> -U <user> <database> > credo-prod.bak

Restore database from dump psql -h localhost -d projectcredo_development -U postgres -f credo-prod.bak

Reporting issues

Start a new issue and fill out the issues template as well as you can.