Recoco (Recommandations Collaboratives)

Mission

Le logiciel Recoco est un outil numérique permettant d'épauler une méthodologie de Recommandations Collaboratives se focalisant sur les problématiques complexes et nécessitant de multiples expertises sur des temps longs.

Historiquement, le logiciel Recoco est issu de la mission UrbanVitaliz (équipe-projet portée par le CEREMA), en partenariat avec Beta.gouv.fr et sponsorisé par le Ministère de la Transition Ecologique et l'Etablissement Public Foncier du Nord-Pas-de-Calais.

Nos sponsors: CEREMA, DGALN et ANCT.

Logiciel

Il est réalisé en python/django côté moteur et alpinejs/bootstrap/dsfr côté interface.

Il est par nature multi-portails, permettant ainsi d'héberger plusieurs thématiques disposant de leur propre espace tout en proposant une porosité entre celles-ci.

Son code est couvert par la licence AGPL v3.0.

En savoir plus sur https://recommandations-collaboratives.beta.gouv.fr/

Vous pouvez trouver notre carnet de route ici: https://github.com/orgs/betagouv/projects/89/views/9

Installation

Deux choix :

1. Via virtualenv et uv
2. Via Docker

Virtualenv

Commencez par installer uv sur votre machine avec pip ou votre gestionnaire de paquets. Si vous n'avez pas de moyen connu, référez vous à la page de uv ( https://github.com/astral-sh/uv ).

Créez et sourcez l'environnement:

uv venv
source .venv/bin/activate

uv pip install -r requirements.txt
uv pip install -r requirements-dev.txt

Configuration de l'applicatif

Copiez le fichier de variables d'environnement d'exemple :

cp .env.example .env

Puis compléter le fichier .env avec les informations de votre base de données.

DJANGO_DB_NAME=recoco
DJANGO_DB_TEST_NAME=test_recoco
DJANGO_DB_USER=recoco
DJANGO_DB_PASSWORD=
DJANGO_DB_HOST=localhost
DJANGO_DB_PORT=5432
DJANGO_VITE_TEST_SERVER_PORT=3001
DJANGO_VITE_DEV_SERVER_PORT=3000
GDAL_LIBRARY_PATH=
GEOS_LIBRARY_PATH=

Copiez le fichier de configuration d'exemple :

cp recoco/settings/development.py.example recoco/settings/development.py

Vous pouvez aussi renseigner les valeurs dans le fichier si vous préférez ne pas utiliser des variables d'environnement.

Docker

Un environnement Docker et fourni et orchestré avec le fichier `docker-compose.yml. Pour le lancer :

docker compose up

Une fois votre environnement installé, initialisez ou synchroniser la base de données depuis le conteneur du serveur :

docker compose run --rm server bash
python manage.py migrate

Lancement de l'applicatif

Les commandes suivantes ne sont pas nécessaire si vous êtes avec Docker.

Pour lancer l'applicatif en mode développement:

• compilez le module dsrc_ui:

cd recoco/frontend/modules/dsrc_ui
yarn install
yarn build

• installez les dépendances:

cd recoco/frontend
yarn install

• montez le serveur dev des static sur le port 3000:

cd recoco/frontend && yarn dev

(Laissez la commande ouverte)

Puis, exécutez le backend :

./manage.py runserver 0.0.0.0:8000

Vous devriez pouvoir vous connecter sur http://localhost:8000 !

Chargement des données de démo

./manage.py loaddata data/geomatics.json

Création du premier site

./manage.py shell

from recoco.apps.home import utils
site = utils.make_new_site("Example", "example.com", "[email protected]", "Sender")
site.aliases.create(domain="localhost", redirect_to_canonical=False)

Tests

Tests Front End

Unitaires

Pour lancer les tests unitaires front end, vous pouvez utiliser la commande suivante :

cd recoco/frontend
yarn test

Bout en bout

Merci de trouver la documentation de tests front end ici.

Tests Back End

Pour lancer les tests back end, vous pouvez utiliser la commande suivante :

pytest --create-db

En cas de difficultés

Dans le cas où vous rencontrez une difficulté, n'hésitez pas à ouvrir une issue sur GitHub, nous vous répondrons dans les plus brefs délais !