Installer un système de signalement

Premiers pas

Ce guide vous accompagne dans la mise en place d'un projet Mark-a-Spot local à des fins de développement et de test.

Prérequis

Pour commencer l'installation, vous aurez besoin de :

• Docker : Une plateforme de conteneurisation d'applications.
• Docker Compose : Un outil pour définir et exécuter des applications Docker multi-conteneurs.

Étapes d'installation

1. Cloner le dépôt : La première étape consiste à cloner le dépôt et à naviguer dans le répertoire :

   git clone https://github.com/markaspot/mark-a-spot.git
   cd mark-a-spot
   

2. Démarrer les conteneurs Docker : La commande suivante initialise les conteneurs Docker et les démarre en arrière-plan :

   docker-compose up -d
   

3. Exécuter le script de démarrage : Le script start.sh initialise l'application. En cas de problèmes de permissions, le script doit être rendu exécutable avec la commande chmod a+x ./scripts/start.sh.

   docker exec -it markaspot ./scripts/start.sh
   

   
   Le script offre deux options en plus du choix de la localité et du pays :
   • -y : Installation automatique avec des valeurs prédéfinies (New York, USA)
   • -t : Importe les fichiers de traduction et active la traduction des termes.

Après l'exécution du script, l'application est accessible à http://localhost. Notez que le script réinitialise la base de données et initialise Mark-a-Spot depuis zéro. Familiarisez-vous donc avec le processus de développement Drupal.

Services Docker

La configuration Docker Compose comprend :

• web : Le serveur web Nginx.
• markaspot : L'application Drupal Mark-a-Spot.
• db : La base de données MariaDB.
• phpmyadmin : PHPMyAdmin pour la gestion de la base de données.
• ui : L'interface Nuxt

Configuration

La configuration des services Docker peut être ajustée dans le fichier docker-compose.yml.

Utilisation

L'application Drupal est accessible à http://localhost.

PHPMyAdmin pour la gestion de la base de données se trouve à http://localhost:8080.

Développement avec Docksal

Pour le développement local, Docksal, un environnement de développement basé sur Docker, est recommandé.

Prérequis

• Docksal
• Docker
• Docker Compose

Licence

Mark-a-Spot est sous la GNU General Public License, version 2 ou toute version ultérieure.

Sujets liés :

• Tarifs Mark-a-Spot : GPL auto-hébergé ou Cloud géré
• Gestion des demandes Open311 sur la plateforme
• Suivi municipal des incidents avec workflows et SLA