Skip to content

All world's influence in a map. Ruby and Hanami open source project.

License

Notifications You must be signed in to change notification settings

rafaels88/pinfluence

Repository files navigation

Pinfluence

Build Status Code Climate

http://pinfluence.org - All world's influence in a map. Non-profit open source project.

This is an open source project for a study purpose in order to develop a real application using mainly Ruby and Hanami, and other technologies which could fit well, like GraphQL.

You can use it as a reference for building your own project, and of course, you are welcome to contribute on this one as well.

Requirements

Quick start

  1. Make a copy of .env.development.example to .env.development;
  2. Open .env.development and .env.test files and configure the DATABASE_URL with your local database informations

This is a Ruby project, so it is nice to have RVM or Rbenv installed.

$ gem install bundler
$ bundle # install all gems

After, you need to setup your database.

$ bundle exec hanami db prepare

Now, run the server:

$ bundle exec hanami server

Website will be available in http://localhost:2300

Development

The project has three apps:

  • WEB (/), which has all code to show public information, like Map;
  • API (/api), is a public GraphQL API which web app makes use;
  • ADMIN (/admin), is the dashboard. This is a restrict area.

When you run the server you run all these apps.

Creating admin user

To create an access to admin, just create an user using hanami console:

$ bundle exec hanami console

CreateUser.call name: "Your Name", email: "[email protected]", password: "your-plain-password"

And done. You now have access to local admin area.

Testing

  1. Since this project is using capybara-webkit, make sure you have all dependencies installed. Click here for instructions

  2. You need to prepare your test database

$ HANAMI_ENV=test bundle exec hanami db prepare

Now, run the tests. If everything is fine, all tests are going to pass.

$ bundle exec rspec

A Guardfile is also available if you want to bundle exec guard.

Deployment

$ cap production deploy

Contributing

Before it, see the code of conduct.

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :D

License

Copyright © 2017 Rafael Soares – Released under MIT License