La décadanse

📅 Agenda culturel local

[!WARNING] En raison d'une grande partie de code legacy, et pour des raisons de sécurité, ne déployez pas cette application sur des serveurs publics. La modernisation est en cours, vous pouvez contribuer

La décadanse est un site web qui présente aux visiteurs une sélection d'événements culturels locaux et accessibles. Il est actuellement déployé pour Genève et les environs

Les organisateurs d'événements ont la possibilité de s'inscrire puis annoncer leurs événements et enfin se présenter.

Les principales sections du site sont :

• 📅 un agenda d'événements, chacun de ceux-ci ayant sa fiche détaillée accompagnée de quelques petits services (signaler une erreur, partager...)
• 📍 un répertoire des Lieux où se déroulent des événements, avec détails, présentation, photos
• 🎤 un répertoire des Organisateurs d'événements, similaire aux Lieux
• 🛠️ un back-office permettant de gérer les diverses entités du site : utilisateurs, événements, lieux, organisateurs, etc.

Installation locale

Ces instructions vous permettront de mettre en place une copie du projet sur votre machine locale à des fins de développement et de test. Voir déploiement pour des notes sur la façon de déployer le projet sur un système actif.

Installation sans Docker

Prérequis

• Apache 2.4
• PHP 8.4, avec les extensions exigées par composer.json et ses dépendances : composer check-platform-reqs les liste et signale celles qui manquent (--no-dev pour s'en tenir à ce que le site demande en production). composer install refuse de toute façon de s'exécuter tant qu'il en manque une
• Composer
• Node.js 20.19+, 22.13+ ou 24+, avec npm — pour les bibliothèques front-end, le lint et les tests JavaScript
• MariaDB 10.11, avec innodb_ft_min_token_size à sa valeur par défaut, 3 : la recherche d'événements trouve ainsi les mots de trois lettres

[!NOTE] Facultatif : imagick et Ghostscript, pour convertir en image les PDF collés en URL dans le formulaire d'événement. Sans eux le site fonctionne normalement, et les PDF envoyés en fichier sont convertis de toute façon — c'est le navigateur qui s'en charge. L'ensemble est désactivé par défaut : voir Accepter les PDF dans les champs image.

Étapes

1. cloner la branche master
2. composer install
3. npm ci, qui installe les bibliothèques front-end et les copie dans web/libs/ — voir Bibliothèques front-end
4. base de données
   1. créer une base de données avec COLLATE 'utf8mb4_unicode_ci' par ex.

      CREATE DATABASE `ladecadanse` /*!40100 COLLATE 'utf8mb4_unicode_ci' */;
      

   2. créer un utilisateur avec les droits suffisants sur cette base de données, par ex.

      CREATE USER 'ladecadanse'@'localhost' IDENTIFIED BY 'my-password';
      GRANT USAGE ON *.* TO 'ladecadanse'@'localhost';
      GRANT SELECT, INSERT, DELETE, UPDATE  ON `ladecadanse`.* TO 'ladecadanse'@'localhost';
      

   3. dans la base de données, exécuter resources/database/ladecadanse.sql, qui crée la structure et remplit la table localite. Ce dump est figé à la 3.13.0 : les changements de schéma postérieurs s'appliquent à l'étape composer db:migrate ci-dessous
   4. ajouter un 1er utilisateur, l'admin (groupe 1) qui vous servira à gérer le site (mot de passe : admin_dev) :

      INSERT INTO `personne` (`idPersonne`, `pseudo`, `mot_de_passe`, `cookie`, `groupe`, `statut`, `affiliation`, `region`, `email`,  `signature`, `avec_affiliation`, `gds`, `actif`, `dateAjout`, `date_derniere_modif`) VALUES (NULL, 'admin', '$2y$10$34Z0QxaycAgPFQGtiVzPbeoZFN1kwLEdWDEBI1kEOJGK4A3xRJtMa', '', '1', 'actif', '', 'ge', '[email protected]', 'pseudo', 'non', '', '1', '0000-00-00 00:00:00.000000', '0000-00-00 00:00:00.000000');
      

5. créer vos fichiers de configuration en faisant cp app/env_model.php app/env.php ainsi que cp app/db.config_model.php app/db.config.php et y saisir les valeurs de votre environnement (davantage d'explications et exemples se trouvent dans les fichiers même), avec au minimum les informations de connexion à la base de données
6. composer db:migrate applique à la base les migrations que le dump ne porte pas encore, et enregistre les autres — voir resources/database/README.md. Il se connecte avec l'entrée default de app/db.config.php ; si son compte n'a pas les droits ALTER, CREATE, INDEX et DROP, lui en substituer un autre par et

Installation avec Docker

Une configuration Docker est fournie pour exécuter le site en environnement local ou en production. Seul Docker est requis sur l'hôte, avec Compose v2 (docker compose) : ni PHP, ni Composer, ni Node.

docker compose --profile dev up -d --build     # Construire si besoin et démarrer (localhost:7777)
docker compose --profile dev logs -f web-dev   # Logs d'Apache et de PHP
docker compose --profile dev down              # Arrêter

Pour la production, remplacer dev par prod et web-dev par web-prod (localhost:8080). Le mot de passe par défaut de l'utilisateur admin est admin_dev.

This is the beginning of the README. Read the rest at the original. Read the full README ↗