Methodical debate platform based on user empowerment
"Débattons" is a French word that means "Let's debate".
The aim of this debate platform is to trust users to level up the discussions quality, so that from collective knowledge would emerge best responses to every question put in debate. It is a sort of Wikipedia for debates.
For this to happen, users will be able to learn debate methods using the platform. They will also be given tools to filter out and go through discussions in their own ways.
The more they participate and are recognized by others, the more they will be granted power inside the platform.
The project is led by iORGA Group in the way we hope to be the most open (don't hesitate to participate, or send us your remarks or suggestions).
Here are some resources:
- Current development and organization status (currently only in French language)
- A more general presentation of the project and its ideas (currently only in French language)
Install & run development environment
On Ubuntu 16.04 without Docker installed
The following command will install Docker and Docker Compose, and finally will clone this project to
curl -L "https://raw.githubusercontent.com/iorga-group/debattons/master/setup/run-env-on-ubuntu-16.04.sh" > /tmp/setup-debattons-run-env-on-ubuntu-16.04.sh && bash /tmp/setup-debattons-run-env-on-ubuntu-16.04.sh
Now restart your session (in order for the group changes to take effects, your user has been added to
docker group in order to be able to execute Docker) or execute the following command:
su -lp $USER
On Linux box with Docker already installed
Clone the current project to
/opt/debattons or let the following command do that for you:
curl -L "https://raw.githubusercontent.com/iorga-group/debattons/master/setup/debattons-git-copy.sh" > /tmp/debattons-git-copy.sh && bash /tmp/debattons-git-copy.sh
Build and run
Now you are able to issue the following command that will create all the development environment into a Docker image and then will run this image as well as the required database.
You are now able to access Débattons at http://localhost:4200
You will be able to access OrientDB Studio at http://localhost:2480/studio/index.html (if you are on Windows < 10 and installed Docker Toolbox, replace
The following procedure will automatically create, setup and configure the development environment in a dedicated virtual machine:
- Install Vagrant 2.0+.
- Install VirtualBox 5.0+.
- Clone this project.
- Enter the Vagrant configuration directory:
- Create and provision the virtual machine:
- during this step, a new dedicated virtual machine will be created, setup and all the dependencies will be installed;
At your first run, Débattons will build and start automatically, at next run you will have to start the server manually.
vagrant ssh /opt/debattons/docker/cmd.sh build-and-run
Install the development environment automatically on your Ubuntu 16.04 (without using Docker nor Vagrant)
The following command will install all the dependencies of Débattons as well as itself on your system.
curl -L "https://raw.githubusercontent.com/iorga-group/debattons/master/setup/dev-env-on-ubuntu-16.04.sh" > /tmp/setup-debattons-dev-env-on-ubuntu-16.04.sh && bash /tmp/setup-debattons-dev-env-on-ubuntu-16.04.sh
Débattons will be installed in
/opt/debattons and OrientDB in
The following script will start OrientDB, create the required DB & user if needed, and start Débattons:
Manual installation of development environment
Débattons uses the following tools that you should install first:
- Java SE Development Kit 8 (JDK8)
- Maven 3+
- Node.js v6.11.3 LTS
- Yarn (that you can simply install with
npm install -g yarn)
Here are the steps to launch the environment (replace
$PATH_TO_ORIENTDB with the path to your OrientDB installation):
# First launch the OrientDB server $PATH_TO_ORIENTDB/bin/server.sh
The first time, you will have to configure the DB:
- Connect to http://localhost:2480/studio/index.html and click on "New DB" and create the Database named
debattonswith the user
rootand the password that you will find in the file
docker-data/conf/debattons.envin the project file tree.
- Then create a new User on that database named
api-serverwith the password
adminrole and the status
- Due to an issue in current version of OrientDB, go to "Browse" and execute the following request:
CREATE CLASS Root EXTENDS V
Now launch the Webservices part in another shell:
cd api-server mvn spring-boot:run
Now in another shell you can start the Angular UI:
cd ui yarn install ./node_modules/@angular/cli/bin/ng serve
Those 3 last steps (DB creation & launch the webservices & UI) can be done automatically with:
Access Débattons in your development environment
You can finally access to the platform at http://localhost:4200