_ _ __ __ _
/\ | | | \ \ / / | |
/ \ | | |_ ___ _ __ ___ ___ _ __ ___ ___ \ \ /\ / /__| |__ __ _ _ __ _ __
/ /\ \ | | __/ _ \ '__/ __/ _ \| '_ \/ __|/ _ \ \ \/ \/ / _ \ '_ \ / _` | '_ \| '_ \
/ ____ \| | || __/ | | (_| (_) | | | \__ \ (_) | \ /\ / __/ |_) | (_| | |_) | |_) |
/_/ \_\_|\__\___|_| \___\___/|_| |_|___/\___/ \/ \/ \___|_.__/ \__,_| .__/| .__/
| | | |
|_| |_|
Alterconso propose une façon simple pour des producteurs en agriculture biologique de mettre à disposition leurs produits à des consomnateurs locaux. .
Sommaire • Installation • Utilisation • Import • Aide • Contribuer • Contact
Alterconso 💻 est une web application, développée en reactJs (frontend) et en haxe (backend), permettant à des groupements d'achats de se constituer. Les producteurs peuvent proposer leurs produits à la vente, et les consomnateurs peuvent auto-organiser des temps de rencontres afin de récupérer leurs commandes.
Cette version de l'application est et restera toujours gratuite et open-source, en accord avec l'entreprise l'ayant conçue. L'objectif de ce repository est de rendre fonctionnelle la dernière version libre de cagette, renommée et modifiée de façon à ne pas utiliser la marque cagette, qui est protégée. Il manquait quelques fonctionnalités à cette version, qui était difficilement exploitable telle quelle. De plus, l'installation était relativement complexe ; grâce à docker, à la réalisation d'une recette ansible, et même d'un package helm, vous avez désormais de multiples façon de déployer alterconso sur vos instances ou vos clusters kubernetes.
dockerdocker-compose
Téléchargez le repository depuis github:
git clone https://github.com/gpenaud/alterconso-webapp.git
Configurez l'application en copiant config.env.sample, puis en remplissant les champs manquants:
cp config.env.sample config.env
N'oubliez pas, enfin de créer les certificats nécessaires afin de pouvoir activer avec TLS en local. La target certificates-install-mkcert installera l'outil vous permettant de créer ces certificats ainsi que l'autorité de certification, et surtout de configurer chromium, firefox et tous les autres navigateurs installés sur votre PC pour qu'ils reconnaissent le-dit certificat.
make certificates-install-mkcert
La target certificates-generate, elle, vous permettra de générer le certificat et sa clef
make certificates-generate
NOTE: Ceci générera le certificat et sa clef dans les dossiers suivants:
certificat: services/apache2/certificates/cert.pemclef: services/apache2/certificates/key.pem
Allez dans le répertoire du repository:
make up
Cette action va déployer 3 conteneurs sur votre poste:
alterconso-webapp: l'application alterconsoalterconso-mailer: le micro-service gérant l'envoi de mailsmysql: la base de données utilisée par alterconso-webapp
Ca y est ! Votre instance locale de alterconso est déployée par défaut sur https://alterconso.localhost
Pour arrêter alterconso-webapp:
make down
Note: Pour déployer alterconso avec cette méthode sur un environnement de production, sachez tout d'abord que ça n'est pas secure ; ensuite, l'objectif de ce repository n'est pas de permettre une installation en deux clics pour néophyte, mais de permettre à quelqu'un de technique, ou de non-technique mais très curieux, de déployer facilement sa propre instance d'alterconso. voici les étapes à suivre pour un déploiement sur un serveur avec docker-compose:
modification du FQDN dans le vhost: remplacez toutes les valeurs "alterconso.localhost" par votre propre nom de domaine dans services/apache2/vhosts/https.conf. Votre nom de domaine doit être enregitsré sur un registrar DNS et correspondre à une adresse IP. Exemple: alterconso.votreassociation.orgMettre votre propre certificat, et sa clef: vous devez générer votre propre certificat TLS (avec Let's encrypt, par exemple), et les insérer dans services/apache2/certificates/cert.pem et services/apache2/certificates/key.pem.
Grâce à ces deux opérations, en lançant make up, docker-compose devrait exposer les ports 80 et 443, et votre serveur devrait répondre à l'adresse https://alterconso.votreorganisation.org (l'adresse dépend évidemment du nom de domaine que vous aurez configuré ^^)
Il existe désormais un role ansible pour déployer alterconso sur un serveur bare-metal (type ovh dedibox). Vous pouvez trouver la documentation de ce role sur ce repository github.
Vous pouvez également déployer alterconso sur Kubernetes (k8s ou k3s), grâce à un rôle helm spécialement développé pour ça. La documentation relative au déploiement via helm se trouve sur le repository consacré à la question
Alterconso s'utilise comme n'importe quelle application web ; à votre première utilisation, vous devrez entrer le nom de votre groupe, ainsi que le nom & prénom du référent. Ensuite, vous devrez:
créer les catalogues produits: Ajouter un producteur et définir l'ensemble des produits de son / ses catalogue(s).créer une distribution, ou un cycle de distributions: définir quand et ou la distribution des produits s'opérera.configurer les producteurs de façon à ce qu'ils participent aux distributions: vous pouvez configurer ça dans l'onglet catalogues du site.
Pour toute question relative à l'utilisation et à l'administration du site, je peux également vous accompagner et vous former ; mais comme pour les autres services que je propose, je demanderai une compensation financière pour le temps et l'énergie passée. Contactez moi pour que nous en discutions.
La fonctionnalité d'import des produits depuis l'actuel cagette (alterconso.leportail.org) vers votre instance d'alterconso ne fonctionne pas depuis l'interface d'administration du site. Les bases de données n'étant pas structurées de la même façon, je n'ai pas pu rendre cette fonctionnalité disponible.
Néanmoins, si vous êtes producteur et que ne souhaitez pas recréer à la main l'ensemble de vos catalogues produits, je peux utiliser une petit programme que j'ai conçu, qui demande un peu de travail de mon côté ; mais qui automatise néanmoins certaines étapes.
En cas de difficultés, sachez que je peux tout à fait m'occuper de mettre en ligne votre instance d'alterconso, mais cela vous coûtera un peu de sous (ou du troc). je ne peux pas me permettre un bénévolat total. Voici les tarifs qui me paraissent ajustés en fonction du temps nécessaire à chaque opération:
- sur un serveur dédié: 300€
- sur le cluster kubernetes de l'écolieu du Portail: 250€ (+ frais d'hébergement d'environ 10€ par mois)
Par catalogue:
- de 1 à 50 produits: 30€
- à partir de 50 produits: 50€
Ce projet a pour objectif de rendre disponible alterconso de façon totalement transparente, libre et gratuite, à quiconque dispose des compétences techniques standard de déploiement d'une application web. J'eus aimé avoir les moyens financiers d'aider tout le mondre totalement gratuitement, mais ne touchant ni retraite, ni rente, ni revenu spontanné, je suis forcé de demander une compensation pour les services non-essentiels liés à cette version gratuite d'alterconso.
Sachez également que si vous souhaitez honorer l'énergie que j'ai mis dans ce projet, vous pouvez procéder à un don, cela m'encouragera à mener d'autres projets bénévoles, et m'aidera à concacrer mon énergie à de l'informatique pour le bien commun.
Mais si les moyens vous manquent, vous pouvez également, à travers un petit mot d'encouragement, contribuer à nourrir mon envie de contribuer au monde à travers des projets éthiques et joyeux.
Guillaume Penaud
Développeur & Devops
- Adresse: 9 Rue de Cretey 71270 Torpes
- Email: guillaume.penaud@gmail.com