pomuzeme.si

An open-source platform which aims to simplify and streamline the coordination of volunteers. Through the platform, local organizations can reach volunteers in the area where assistance is needed. This project originated as a voluntary initiative in connection with the COVID-19 infection.

Getting Started

The application is an MVC monolith written in the RubyOnRails framework. On Frontend we are using common "bootstrap" based frameworks such as Bulma or Materialize design.

Local development environment

Required software

1. Ruby 2.6.3
2. NodeJS
3. yarn (sudo npm install -g yarn)
4. PostgreSQL
5. PostGIS
6. Redis

Steps to get it running

1. git clone git@github.com:Applifting/pomuzeme.si.git && cd pomuzeme.si
2. bundle install
3. setup RGeo
4. rake db:create Note: avoid db:setup as there is an db:create hook that is required, in order to have postgres extension.
5. psql pomuzeme_si_development -c "CREATE EXTENSION postgis;"
6. rake db:migrate
7. yarn install
8. rails server

Contribution

In case you decide to contribute to this project, we will be very happy and we appreciate your help. Feel free to:

1. Check out open issues. Ideally, choose from the ones that are labeled as ready for dev. If you are going to contribute code, read our contribution guide.
2. Assign your self to the selected issue
3. Write estimate delivery time into issue comment (preferably with ping to @snopedom)
4. Create a new branch from master where work will be done
5. After work is done please create new pull request into master
6. Wait for review and PR approval (PR should be approved by 2 other developers, at least one from Applifting)
7. After merge work is DONE! Thank you! ❤️

If you have any questions about development or issue description, feel free to ask the author of the issue in comments.

Deployment

At this moment application is deployed on Heroku cloud service. We have two environments, staging and production.

Deployment to staging - staging.pomuzemesi.cz

Staging deployment is realised by automatic deploy hook which is triggered when code into master is merged (pushed).

Deployment to production - www.pomuzemesi.cz

Production deployment is done by authorized developers from Applifting. Deploys are made regularly, each time new functionality is created. If you need to put something into production contact:

Dominik Snopek - Development coordinator - dominik.snopek@applifting.cz

Martin Hanzík - DevOps - martin.hanzik@applifting.cz

License

This project is licensed under the MIT License - see the LICENSE file for details

Authors

Authors of this platform are awesome guys and girls from Applifting. We could not do it without our Contributors that are listed below. Thanks from the bottom of our hearts! ❤️

Contributors

Dominik Snopek 💻	landovsky 🤔 📆 💼	Kamil Hanus 💻 👀	Martin Hanzík 🚇 💻 👀	pavelc 💻 👀	vnevyhosteny 💻	klaravytiskova 🐛
davidvobecky 🎨	Vaclav Pavlicek 💻	Jakub Pavlík 💻 🐛	Adela Homolova 🖋	Jan Zikan 💻 🐛	Cuong Nguyen 💻 🌍	Jarka košanová 💻
Daniel Senff 💻 ⚠️	kirscfil 🖋	Petr Malak 💻	Pavel Chlad 🚇