L'éco-clic est une solution de Pilotage de la sobriété numérique, distribuée en mode SaaS par l'association Déclic pour ses OPSN membres, ses partenaires, et pour les collectivités locales.
Retrouvez le guide utilisateur : https://asso-declic.gitbook.io/guide-utilisateur-leco-clic/presentation-generale/leco-clic
Retrouvez le code source : https://github.com/Asso-Declic/eco-clic
- PHP >= 8.2
- MySQL == 5.7
- git
- composer
L'éco-clic s'utilise directement sur nos serveurs. Vous pouvez contribuer au code ou juste apprendre comment il fonctionne. Si vous ne souhaitez pas utiliser le service SaaS proposé par Déclic, vous pouvez déployer votre propre instance indépendante.
Ces instructions d'installations sont destinées à la mise en production du projet.
L'éco-clic est développé avec Symfony et versionné avec git. Il faudra d'abord cloné le dépôt sur votre serveur :
# en HTTPS
git clone https://github.com/Asso-Declic/eco-clic.git
# en SSH
git@github.com:Asso-Declic/eco-clic.gitUne fois cloné, déplacez-vous dans le dossier du dépôt.
cd eco-clicIl vous faudra utiliser composer pour installer les dépendances PHP. S'il est bien installé sur votre système, téléchargez les dépendances :
composer install --no-devTous les fichiers PHP nécessaires au fonctionnement du projet sont là. Nous n'avons pas installé les dépendances de dev qui sont inutiles en production.
Il faut créer un fichier nommé .env.local à la racine du projet. Ajoutez la variable APP_ENV :
APP_ENV=prodIl est bien important que vous utilisiez le fichier .env.local et surtout pas le fichier .env
Il faudra également configurer l'accès au serveur de mails. Ajoutez cette variable dans .env.local :
MAILER_DSN=""Les informations sur la valeur à mettre se trouve sur la documentation de Symfony.
Installons la base de données. Le code utilise MySQL. Grâce à Symfony. Il y a peu de choses à faire. Il faut d'abord configurer l'accès à la base de données. Copiez la variable DATABASE_URL dans votre fichier .env.local et adaptez-la à votre serveur MySQL.
DATABASE_URL="mysql://bduser:bdpass@bdserver:3306/bdname?serverVersion=5.7&charset=utf8mb4"Il n'est pas nécessaire de créer la base de donnée vous même au préalable. Si vos identifiants le permettent et que vous souhaitez créer la base de donnée pour cette nouvelle instance, exécutez bin/console doctrine:database:create et la console de Symfony se chargera de créer la base de données pour vous sans devoir ouvrir PhpMyAdmin, Adminer ou mysql en ligne de commande.
Au début du projet, le code n'utilisait pas le framework Symfony. Le choix de passer à ce framework demande quelques adaptations. Des migrations ont été mises en place et il faudra les initialiser.
La connexion à la bdd fonctionne, on demande donc à Symfony de créer les tables. Il faut créer la structure des tables puis y mettre des données. La structure de la base de données est décrite dans les migrations. Les migrations sont une forme d'historique de la base de données, elle décrivent comment on passe d'une version à l'autre de nos tables. Elles permettent donc de revenir en arrière en cas de mise à jour hasardeuse. Nous y avons également mis certaines données de départ qui permettent de démarrer une instance. Pour les appliquer :
bin/console doctrine:migrations:migrateDéplacez-vous dans le dossier de votre instance de L'éco-clic avec cd et mettez le code à jour avec
git pullIl est possible que la commande soit à compléter si vous devez récupérer une certaine version. Bravo, votre code est à jour. Mais il faut encore quelques étapes pour terminer la mise à jour.
Il n'y a pas, pour le moment, de stratégie de versions qui utiliserait des tags. Un simple git pull sans plus d'option devrait suffire.
Peut-être que la mise à jour a modifié les dépendances. Pour les mettre à jour il faut exécuter :
composer installAttention à surtout utiliser la commande install et pas update . Si vous avez l'impression que rien ne se passe, c'est sûrement parce qu'il n'y a pas de modifications à faire.
En production, le cache de Symfony n'est pas régulièrement mis à jour, notamment le cache contenant les templates. Il faut le vider quand le code a été modifié :
bin/console cache:clearLa base de données a peut-être évoluée depuis votre dernière mise à jour. Pour la modifier il suffit d'exécuter les migrations. Elles renferment les requêtes SQL qui manipulent la structure de la base de données.
bin/console doctrine:migrations:migrateS'il n'y a pas de migrations à appliquer, la commande ne fera aucun changement.
La documentation utilisateur se trouve sur Gitbook : https://asso-declic.gitbook.io/guide-utilisateur-leco-clic/presentation-generale/leco-clic
La documentation pour les développeurs est ici-même dans le dossier docs.
Informations de connexion pour l'utilisateur enregistrer dans la bdd identifiant : demo.demo Mot de passe : #Demo@demo60#
Premier dépôt pour utilisation du GitLab par l'équipe R&D | 30/08/2023
Push du code concernant les modifications des fonctionnalités suivantes :
- Modification du TdB et du plan d'action : Ajout des mentions "Première notation et Dernière Modification" | 22/09/2023
- Le Niveau 2 : Recommandations dynamiques | 22/09/2023
- Rattachement OPSN | 22/09/2023
- Rattachement OPSN : affichage des OPSN | 26/09/2023
- MailHelper : Mailing de rattachement OPSN | 26/09/2023
- Categorie : Correction de l'affichage d'une question enfant | 26/09/2023
- Correction de l'affichage du score | 26/09/2023
- Admin : Affichage des questions de niveau 2 selon le niveau de la col | 26/09/2023
- Correction du probleme des reco de niveau 2 | 26/09/2023
- Maj des regex | 26/09/2023
- Bandeau "connecté en tant qu'OPSN" | 26/09/2023
- Message quand il n'y a pas de reco | 26/09/2023
- Design des reco dans le détail | 26/09/2023
- Cacher le bouton "s'enregistrer" après le clique | 28/09/2023
- ajout fonctionnalité pour annuler le rattachement OPSN coté admin | 28/09/2023
- Correction map de rattachement OPSN | 29/09/2023
- Correction des bug lors de la modif du profil utilisateur/admin | 29/09/2023
- doublon dans les questions en attente (coté admin) | 23/10/2023;
- retirer les recommandations pousser (coté admin) | 23/10/2023;
- nombre de question en attente (coté admin) | 23/10/2023;
- changement de couleur des reco activable (coté admin) | 23/10/2023;
- réduction du graph dans le Tdb | 23/10/2023;
- correction du scroll dans la gestion du profil | 23/10/2023;
- design du détail d'une recommandation | 23/10/2023;
- afficher les réponses déja remplie dans les champs libre | 23/10/2023;
- résolution du probleme lié aux questions enfant pour la complétion | 23/10/2023;
- bouton d'extraction des données | 23/10/2023;
- affichage de toute les reco dans le plan d'action | 23/10/2023;
- case d'une catégorie cliquable dans le Tdb | 23/10/2023;
- affichage des reco dynamique coté admin et col | 23/10/2023;
- correspondance des reco dispo entre le Tdb et le coté admin | 23/10/2023;
- dans mdp oublié remplacement de identifiant par adresse email | 23/10/2023;
- design des inputs sur la page de connexion | 23/10/2023;
- résolution du problème de score et avancée coté admin | 23/10/2023;
- bouton retour sur la page de reste du mdp | 23/10/2023;
- modification du système d'ajout d'utilisateur (envoi de mail pour crée son mdp) | 24/10/2023;
- rattachement du user a l'opsn selectionner lors de la création coté admin | 06/11/2023;
- modification du role pour activé/desactivé le niveau 2 | 07/11/2023;
- correction de l'avancée coté admin | 07/11/2023;
- correction du bug des filtres dans le plan d'action | 07/11/2023;
- affichage des logo OPSN | 07/11/2023;
- correction de la numerotation de la page des OPSN | 09/11/2023;
- correction des region la map des OPSN | 10/11/2023;
- la gestion du profil cote admin ne rammene plus cote questionnaire | 13/11/2023;
- correction du probleme de scroll dans les pages avec des tableaux | 13/11/2023;
- si l'OPSN est adico ou declic alors afficher toute les collectivités dans une nouvelle page | 15/11/2023;
- correction des problemes de filtre dans le plan d'action | 17/11/2023;
- fonctionnalite de patchnote | 20/11/2023;
- ajout d'un historique des patchnotes | 20/11/2023;
- ajout d'un html editor pour le body des patchnotes | 21/11/2023;
- correction du probleme de lien dans les mails de rattachement | 21/11/2023;
- ajout des log | 01/08/2024;
- correction de bug de doublon des recommandations | 11/10/2024;
- possibilité de désélectionner les boutons de réponse | 12/11/2024;
- possibilité de voir les OPSN inactive (en griser, mais pas la possibilité de s'y raccorder) | 2/12/2024;
- coté administration : Amélioration du système de recommandation personnalisé.| 24/02/2025;
- notification lorsqu'une recommandation est activée par l'opsn | 25/02/2025;
- modification de l'affichage des recommandations | 04/04/2025;
- ajout d'un champ de recommandation personaliser | 17/06/2025;
- affichage d'un alerte quand il n'y a pas de reco dans la partie admin | 06/11/2025;
Ce logiciel est édité par Déclic qui en détient la paternité. Copyright 2023 Le code de ce logiciel ainsi que les questions de niveau 1 sont distribués sous la licence AGPL v3.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/