QueryJane | Companies rating system

Repository

https://github.com/roadhousestudio/queryjane_app

QueryJane is a web application developed with Django that allows to connect with companies and experts in different sectors of the cannabis industry. Beta version is available here.

New Features

This new feature is a rating system that allows users to leave a feedback about registered companies. This is a typical "five stars" bases feedback. Only users that are not administrators of a company can score it. Take a look to the new model:

source

When a user scores a company, a new instance of this model is created.

I have created a custom permission to allow only some users to score companies:

source

As you can see, non-authenticated users and company administrators can't add a score to a company, and if a user has added a feedback previously about a company, he can't add a new feedback to the same company.

I have integrated rateyo, a jQuery star rating plugin. When an authenticated user visits a company detail page, he will see given rating by the users, and the new button "Rate this company":

By clicking the "Rate this company" button, a modal with the starts plugin form will be displayed:

Here, user can add his rating score for the company and it will be submitted using ajax to the following view:

_source

Here, a new instance of the CompanyScore model is created, and a response with a custom message and the new company score rating is sent back.

The new total company rating is immediately updated once the user has submitted the stars form.

If our user scores the company with 5 stars, the score rating below the company picture is updated:

If other user rate the same company with 1 star, the new score average is updated in the ajax response:

Code changed related to this feature can be found in this PULL REQUEST

Proof of Work Done

Github account: https://github.com/aaquirogal

---

---

How to contribute?

QueryJane has been developed using the Django framework. You can fork the project, and run it locally is very easy. Follow the steps described in the open source repository installation guide. The project has been configured using Docker. you only need to install Docker and follow these steps.

Future work.

Take a look to our public trello board. This is the easiest way to know our roadmap.

The project needs some Front end adjustments as priority work now, I have been talking with @cunigarro about it. He will work in some specific sections: Gulp optimization, static files compression and minor adjustments in the front end.

I'll be a bit inactive on the development side now. There is only some backend pending features, that I will include in one new pull request next days and I will be sharing with you. I will focus in some legal requirements next days, and, after that I will create a new task request in the graphics category, to integrate a new member to the project from the Utopian community. These final requirements will allow us make the jump from the beta version to the official version.

If you want to contribute, please join my Discord.

---

Have happy days ✌