Plateforme de récit collectif et de documentation de la Rive Droite
Clone or download
Permalink
Failed to load latest commit information.
app Ajout du support de la liste de chronologie dans l'admin Jan 26, 2016
bin Mise à jour de spork et ajout des binstubs rspec Apr 25, 2014
config Version bumped 1.2.0 Jan 26, 2016
db Intégration HTML / CSS Jul 8, 2014
lib Ajout de la validation des tailles de fichiers dans le model Image Jan 26, 2016
log Commit initial avec structure de l'application HLM Rails 4 et environ… Mar 31, 2014
provisioning * Correction du bug de duplication des marqueurs GPS. Sep 12, 2014
public Ajout du support des pages d'erreur designées. Sep 1, 2014
spec Ajout du support de la timeline de commentaires dans le back office a… May 15, 2014
vendor/assets Corrections diverses Aug 14, 2014
.env.development Ajout du support de docker-compose Jan 26, 2016
.gitignore Ajout du support de Unicorn et de Nginx dans Capistrano. Aug 22, 2014
.rspec Ajout du support du framework de test RSpec. Apr 1, 2014
.ruby-version Préparation à la mise en qualification. May 22, 2014
Capfile * Ajout du support du sitemap (gem sitemap_generator). Oct 6, 2014
Dockerfile Ajout du support de docker-compose Jan 26, 2016
Gemfile Correctif pour l'affichage sur smartphone et IE Oct 13, 2014
Gemfile.lock Correctif pour l'affichage sur smartphone et IE Oct 13, 2014
README.md Mise à jour du README pour présenter la plateforme et expliquer comme… Nov 6, 2014
Rakefile Commit initial avec structure de l'application HLM Rails 4 et environ… Mar 31, 2014
Vagrantfile * Correction du bug de duplication des marqueurs GPS. Sep 12, 2014
config.ru Commit initial avec structure de l'application HLM Rails 4 et environ… Mar 31, 2014
docker-compose.yml Ajout du support de docker-compose Jan 26, 2016

README.md

Habitants, Lieux, Mémoires

Habitants, Lieux, Mémoires est une plateforme ouvert de récit collectif de la Rive Droite de Bordeaux.

Ce site participatif a pour vocation de décrire la Rive Droite de l'agglomération bordelaise, son histoire, ses lieux et, surtout, ses habitants.

Présentation

Au même titre que le site en lui-même, le code source a pour but d'être ouvert à tous les contributeurs potentiels. Référez vous à la section Contribuer pour plus de détails.

Prérequis

Pour pouvoir contribuer et améliorer la plateforme, les prérequis suivants doivent être installés sur votre poste :

Vagrant

Vagrant est un gestionnaire de machines virtuelles permettant de créer, et configurer ces dernières de manière reproductible et portable. En utilisant Vagrant pour développer sur la plateforme Habitants Lieux Mémoires, vous êtes sûr d'avoir un environnement de développement identique et portable entre tous vos postes.

Les dépendances du projet seront ainsi installées sur la machine virtuelle et ne pollueront pas votre ordinateur. De plus, la plateforme étant optimisée pour un environnement Ubuntu Server, vous pouvez quand même développer sur un poste Windows, OSX ou toute autre distribution Linux.

Veuillez vous référer au site web de Vagrant pour plus de détails sur le fonctionnement de cet outil.

Ansible

Ansible est un outil de provisioning, de configuration et d'orchestration automatisé d'ordinateurs.

Il permet d'installer et de configurer les dépendances de vos projets sur de nombreux ordinateurs en parallèle, de faciliter le déploiement de vos applications et d'orchestrer l'exécution de tâches distantes. Ansible se base sur le protocol SSH et ne requiert aucune dépendance sur les ordinateurs à ciblés.

Vagrant est compatible en natif avec Ansible pour la configuration de machines virtuelles et c'est le choix que nous avons fait lors du développement de Habitants, Lieux, Mémoires.

Veuillez vous référer au site web de Ansible pour plus de détails sur le fonctionnement de cet outil.

Architecture

Habitants, Lieux, Mémoires est architecturé autour de 3 composants :

Rails

Rails est un framework web permettant de créer des applications orientées base de données suivant le pattern MVC (Model-View-Controller).

La documentation de Rails est un moyen de simple de comprendre le fonctionnement de ce dernier et de le mettre en application. Si vous êtes novices, n'hésitez pas à suivre le cours gratuit fourni par Codeschool disponible à cette adresse.

MongoDB

MongoDB est une base de données orientée documents. Sa principale force est d'être scalable (faculté de pouvoir monter en charge et à maintenir les performances lors de pics d'utilisation).

Dans le cadre du projet Habitants, Lieux, Mémoires c'est sa capacité à stocker des données sans schéma prédéfini (indispensable pour un gestionnaire de contenu collaboratif) qui a été jugée primordiale.

Pour les novices, un shell interactif a été créé pour faciliter la compréhension du fonctionnement de MongoDB. N'hésitez pas à y faire un tour pour en savoir plus.

ElasticSearch

ElasticSearch est un moteur de recherche basé sur Lucene.

Il est par nature distribué, scalable et accessible via une interface HTTP REST. Son gros avantage est de bénéficier de la puissance d'indexation et de recherche de Lucene.

Il est utilisé par le projet Habitants, Lieux, Mémoires dans l'optique de fournir un moteur de recherche d'articles réactif, performant et évolutif.

Développer

Dans le but de pouvoir commencer à contribuer à HLM, il est nécessaire d'initialiser l'environnement de développement sur Vagrant, de configurer Rails sur la machine virtuelle et enfin de lancer le serveur.

Le provisioning de la machine virtuelle via Ansible nécessite l'installation de roles hébergés sur le site communautaire Ansible Galaxy. Ces derniers permettent de bénéficier du travail de nombreux contributeurs concernant l'installation et la configuration des logiciels/librairies les plus connus.

Pour ce faire, lancez un interpréteur de commandes (Terminal pour UNIX, Cmd our Powershell sur Windows), déplacez-vous à la racine du projet et exécutez la commande :

ansible-galaxy -r provisioning/dependencies.ini

Pour lancer la machine virtuelle Vagrant :

vagrant up

**La première exécution de cette commande peut être longue. En effet, elle initialise la machine virtuelle depuis une image de base téléchargée depuis le site de Vagrant puis la configure en utilisant Ansible qui va télécharger et configurer toutes les dépendances du projet (compilation de Ruby, installation de MongoDB et ElasticSearch...) **

Une fois votre machine virtuelle configurée et lancée, vous pouvez vous y connecter en exécutant la commande :

vagrant ssh

Vous êtes maintenant connecté(e) via SSH à votre machine virtuelle. Vous pouvez exécuter toutes les commandes que vous voulez puis vous déconnecter en tapant exit.

Il est maintenant nécessaire d'installer Rails pour pouvoir lancer le serveur web. Pour ce faire, exécutez les commandes suivantes. Si vous rencontrez une erreur, n'hésitez pas à créer une Issue (via le menu situé à votre droite).

cd /vagrant
gem install bundler
rbenv rehash
bundle install
rbenv rehash

Rbenv est un gestionnaire de versions de Ruby permettant de fixer une version pour un projet et de garantir que cette dernière sera la même une fois en production.

Une fois ces commandes exécutées, Rails est installé, les services MongoDB et ElasticSearch sont démarrés.

Pour lancer le serveur web, executez la commande bin/rails server. Vous pouvez maintenant accèder au site web d'Habitants, Lieux, Mémoires en tapant l'addresse http://0.0.0.0:3000 dans votre navigateur.

Par défault, le site est vide et donc inutilisable. Pour créer des utilisateurs, articles et commentaires, exécutez les commandes suivantes :

bin/rake db:reset
bin/rake searchkick:reindex:all

Et voilà, vous être prêt à contribuer à la plateforme Habitants, Lieux, Mémoires.

Toutes ces commandes ne sont à exécuter qu'une fois par poste pour initialiser l'environnement de dévéloppement. Les prochaines fois, assurez-vous que la machine virtuelle n'est pas éteinte (vagrant up) puis lancez le serveur.

Contribuer

Pour contribuer au projet, merci de passer par le méchanisme natif de Pull Requests de GitHub.

Nous essaierons de fusionner vos modifications dans les plus brefs délais si elles sont jugées satisfaisantes et qu'elles apportent une plus-value au projet.

Licence

Habitants, Lieux, Mémoires utilise la licence Creative Commons 3.0