Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/airesis/airesis

The Social Network for eDemocracy
https://github.com/airesis/airesis

airesis citizens discussion edemocracy forum proposal social-network

Last synced: about 1 month ago
JSON representation

The Social Network for eDemocracy

Lists

README

        

# Airesis - The Social Network for E-Democracy

[![Build Status](https://semaphoreci.com/api/v1/coorasse/airesis/branches/develop/badge.svg)](https://semaphoreci.com/coorasse/airesis)

The first open source web application for eDemocracy

## Summary

This innovative tool for participatory democracy puts the citizens at the center, as the main actors,
and finally allows them to be active in the decisions of their territory.

Users can view their own territory and listen to the voices and messages that come directly
from other citizens or groups present.

The groups will be able to get in touch with the citizens, support the proposals and create events
in the area.

Everything fully integrated with all major social networks and the ability to communicate through e-mail
the proposals.

Users who wish to participate in the activities of groups can also sign up and follow the discussions
on the forums.

But what really makes Airesis a platform for edemocracy?
The first thing is a totally innovative mechanism for the construction of proposals, where finally
the contributions and the minds of the users will be able to merge and make it possible to write
proposals in a shared way.

Airesis allows users to have a better ranking on the basis of how they work and contribute to the proposals but at the same time allows a true comparison on the topics and content while maintaining the anonymity of users during the construction of the proposals.

Each time a user participates in a proposal will be overshadowed his real name, so as to ensure that the discussions will focus on the texts and the value of what is written rather than who wrote it.

A system for evaluating the contributions and proposals totally new will automatically identify the users who write better and those who write worse by allowing them to write and evaluate better within the system.

Finally, an implementation of the method schulze will always hold genuine elections within groups or to choose the best among the proposals.

Absolutely simple and intuitive interface will allow everyone in a short time, to find all the information they want.

## Reference website

* [www.airesis.eu](https://www.airesis.eu)
* [www.airesis.it](https://www.airesis.it)

## Installation and Setup

You can install Airesis to run locally on your machine,
or if you prefer using [Docker containers](#Docker) for a quick and easy setup.

#### Requirements
* PostgreSQL >= 9 with the hstore extension enabled.
* Redis in order to execute Sidekiq and all background jobs.

### Local installation

1. Download the project
```
git clone https://github.com/airesis/airesis.git
cd airesis
```
2. Install the libraries
```
bundle
```
3. Configure environment variables (such as PayPal, Google Maps API, etc.), run
```
cp config/application.example.yml config/application.yml
```
then edit the `.yml` file and set your custom values
4. Bootstrap the database, populating it with initial data (be advised: it needs ~ 5 minutes)
```
bundle exec rake db:setup
```
5. Run Airesis
```
bundle exec rails s
```
7. run Sidekiq
```
bundle exec sidekiq
```

Done! You have now a working version of Airesis!

#### Foreman
If you want to run all processes in a single command you can use Foreman
```
bundle exec foreman start
```
and it will take care of running everything for you.

#### Mailman
Users can reply in the forum by email. Run
```
ruby script/mailman_server.rb
```
in background to receive emails and create forum posts from them.

## Docker

See [Docker README](DOCKER_README.md)

## Seeding more data

You'll probably need some fake data in your development environment to test stuff.
These scripts are available:

bundle exec rake airesis:seed:more:public_proposals[number]

Will generate `number` fake proposals in public open space and `number` new users (one for each proposal)

bundle exec rake airesis:seed:more:votable_proposals[number]

Will generate `number` fake proposals in public open space in vote for the next three days and `number` new users (one for each proposal)

bundle exec rake airesis:seed:more:clear_proposals

Destroy all the proposals in the database

To generate other fake data look at `spec/factories` folder.

## Environment variables

Look at `application.example.yml` for a detailed explanation of each environment variable.

## I18n

I18n is managed in a separate gem.
See https://github.com/airesis/airesis_i18n to contribute.
Contribute on Crowdin to the Translation of the project

## What else should I know? What are we working on right now?

We want to take out everything which is related to our installation and make it easier to install.

Our main goal is to make it even more simple and usable for everybody!

## The author

![Alessandro Rodi](http://www.gravatar.com/avatar/32d80da41830a6e6c1bb3eb977537e3e)

Alessandro Rodi ([email protected])

## License

This software is released under AGPL .

For the terms of the license can be found in the LICENSE file available within the project.

Anyone which installs the application and is required to comply with the terms of the license and to incorporate
in the footer of the website the following statement:

`Powered by Airesis - The Social Network for eDemocracy `