mathben/erplibre
1
0
Fork 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity
erplibre/README.fr.md
Mathieu Benoit 7a10f268df [FIX] démarrage : choisir un interpréteur capable de lire TODO 
install.sh et make lançaient todo.py par son hashbang, donc par le python3 du
PATH, sans rien garantir de sa version : une syntaxe plus récente l'arrête en
SyntaxError au chargement, et le poste hors d'âge perd tout moyen de lancer
l'installation qui l'en sortirait. L'ordre est désormais le venv d'outillage,
sinon le python3 du PATH s'il suffit, sinon l'installation. TODO lui-même se
relance dans le venv, vérifie version et modules avant ses imports, et propose
l'installation en terminal — ce que « make » sur un clone neuf promet depuis
toujours sans le tenir.
Vérifié : venv à jour, venv périmé, systèmes en 3.10, 3.14 et 3.15 vont chacun
où il faut ; un import du module ne relance rien et lève comme avant.

--- EN ---

install.sh and make ran todo.py through its hashbang, so through the python3 of
the PATH, with no guarantee about its version: a newer syntax stops it with a
SyntaxError at load, and the ageing machine loses every way to start the
install that would rescue it. The order is now the tools venv, else the python3
of the PATH when it suffices, else the install. TODO itself relaunches in the
venv, checks version and modules before its imports, and offers the install in
a terminal — what "make" on a fresh clone has always promised without
keeping.
Checked: fresh venv, stale venv, systems on 3.10, 3.14 and 3.15 each go where
they should; importing the module relaunches nothing and raises as before.

Assisted-by: Claude Opus 5
2026-09-24 13:56:57 -04:00

8.3 KiB
Raw Blame History

ERPLibre

ERPLibre est une plateforme CRM/ERP incluant l'installation, la maintenance et le développement automatisés de modules open source de la version communautaire d'Odoo. C'est un "soft-fork" de l'Odoo Community Edition (OCE), ce qui signifie qu'il vise à contribuer en amont. Il est basé sur un ensemble de modules prêts pour la production, supportés par l'Odoo Community Association (OCA) et un écosystème d'entreprises spécialisées. Cette solution assure la souveraineté numérique dans un environnement local tout en intégrant des Transformers Génératifs Pré-entraînés (GPT), apportant une dimension supplémentaire à la gestion des données et à l'automatisation.

Suivez-nous sur Mastodon : https://fosstodon.org/@erplibre

Fonctionnalités

  • Support multi-version Odoo : exécutez Odoo 12.0, 13.0, 14.0, 15.0, 16.0, 17.0 et 18.0 dans le même espace de travail, avec des environnements virtuels Python indépendants (.venv.erplibre et .venv.odooXX)
  • CLI interactif (TODO.py) : outil interactif guidé pour l'installation, l'exécution, la gestion de bases de données, le formatage de code, la compilation mobile, et plus encore. Lancez-le avec make
  • Générateur de code : générez des modules Odoo automatiquement avec support des vues, portail, snippets, héritage, i18n et JavaScript
  • Automatisation Selenium : tests web et automatisation avec Selenium Grid, enregistrement vidéo et automatisation de connexion
  • Application mobile : ERPLibre Home Mobile (Owl + Capacitor), compilée et déployée via TODO.py
  • Déploiement Docker : images Docker prêtes pour la production avec PostgreSQL 18 et PostGIS
  • Outils de déploiement : Nginx, Apache, Cloudflare DDNS, Certbot SSL, services systemd
  • Outils de base de données : sauvegarde, restauration, clonage, migration entre versions, migration production vers développement
  • Outils de performance : mesure de requêtes par seconde, exécution de tests en parallèle, analyse de couverture

Versions Odoo supportées

Odoo version Python Status
18.0 3.12.10 Active
17.0 3.10.18 Inactive
16.0 3.10.18 Inactive
15.0 3.8.20 Deprecated
14.0 3.8.20 Deprecated
13.0 3.7.17 Deprecated
12.0 3.7.17 Deprecated

Changez de version avec make switch_odoo_18, make switch_odoo_16, etc.

Le Python de ce tableau est celui de l'environnement virtuel Odoo. L'environnement virtuel d'outillage .venv.erplibre (TODO, repo, formateurs) tourne sur son propre interpréteur, 3.14.7, fixé par conf/python-erplibre-version. Là où une distribution ne le porte pas, pyenv le compile.

Plateformes supportées

  • Ubuntu : 24.04, 25.10, 26.04 — 20.04 et 22.04 sont retirées, pikepdf réclamant un qpdf 12.2 bâti en C++20
  • Linux Mint : 22.3
  • Debian : 12 (bookworm) et 13 (trixie)
  • Fedora : 41 et suivantes
  • AlmaLinux, Rocky Linux : 9 et 10 — RHEL et CentOS Stream empruntent le même chemin
  • openSUSE : Leap 16.0 et Tumbleweed
  • Arch Linux : rolling release
  • NixOS : 25.11 — les dépendances y sont DÉCLARÉES dans conf/nixos/erplibre.nix puis appliquées par nixos-rebuild, là où les quatre autres familles les installent commande par commande
  • macOS : par mise ou pyenv
  • Windows : par WSL ou Docker
  • Architectures : amd64, arm64 et s390x (mainframe IBM Z)

Installation en production

Installation facile sur Ubuntu ou Debian avec Docker

Ceci a été testé sur Debian 12 et Ubuntu 24.04 LTS.

Note : Ceci est prévu pour un environnement de test, sur un réseau local ou un environnement similaire non exposé directement à Internet.

  1. Assurez-vous que Docker et le serveur web nginx sont installés :
    sudo apt install docker.io docker-compose-v2 nginx

  2. Obtenez le dernier fichier Docker compose d'ERPLibre :
    wget https://raw.githubusercontent.com/ERPLibre/ERPLibre/master/docker-compose.yml

  3. Installez et lancez ERPLibre avec Docker en mode daemon (serveur web) :
    ``sudo docker compose up -d`

  4. Ouvrez l'étape finale d'installation à cette page web :
    http://[server IP]:8069/web/database/manager
    odoo_first_installation.png

  5. Terminez l'installation en fournissant un nom de base de données, un courriel et un mot de passe, puis cliquez sur Create Database. Selon les ressources de votre système, cela peut prendre plus de 2 minutes sans retour visuel ! Vérifiez l'indicateur de chargement de votre navigateur.

  6. Ensuite, la page web se rechargera automatiquement et vous devriez voir la liste des applications dans ERPLibre :
    odoo_application_list.png

    Vous pouvez maintenant personnaliser votre installation ERPLibre.

Pour plus d'informations, consultez le guide Docker.

Installation depuis le code source

Installation automatisée

Pour Debian/Ubuntu

sudo apt install make python3

Clonez le projet :

git clone https://github.com/ERPLibre/ERPLibre.git
cd ERPLibre

Suivez les instructions du script suivant, il essaiera de détecter votre environnement.

make

make et ./install.sh lancent TODO par l'interpréteur capable de le lire : .venv.erplibre quand il porte la bonne version, sinon le python3 du système s'il est assez récent, sinon l'installation elle-même — un système plus ancien que conf/python-erplibre-version ne sait pas analyser le code, donc on va droit à l'installation plutôt que de s'arrêter sur une erreur de syntaxe. Quand l'environnement manque mais que le Python du système suffit, TODO propose de lancer ./script/install/install_erplibre.sh (dans un terminal) ou affiche cette commande. L'installation bâtit l'environnement par EL_PYTHON_PROVIDER (mise ou pyenv) ; un .venv.erplibre existant sur une autre version de Python est SUPPRIMÉ puis rebâti, et ce qu'on y avait posé à la main part avec lui.

Manuellement

Sous Ubuntu, dépendance minimale :

sudo apt install make git curl

Sous Ubuntu, dépendance développeur :

sudo apt install make build-essential libssl-dev zlib1g-dev libreadline-dev libsqlite3-dev curl llvm libncurses5-dev libncursesw5-dev xz-utils tk-dev liblzma-dev libbz2-dev libldap2-dev libsasl2-dev

Clonez le projet :

git clone https://github.com/ERPLibre/ERPLibre.git
cd ERPLibre

make install_os détecte la distribution et choisit le bon script de dépendances : apt pour Ubuntu, Linux Mint et Debian, dnf pour Fedora et la famille RHEL, zypper pour openSUSE, pacman pour Arch, et un module déclaratif pour NixOS. Voir les plateformes supportées ci-dessus.

make install_os
make install_odoo_18

Installez une version spécifique d'Odoo :

make install_odoo_16
make install_odoo_17
make install_odoo_18

Mettez à jour votre configuration si vous devez exécuter depuis une autre interface que 127.0.0.1, fichier config.conf

xmlrpc_interface = 0.0.0.0

Afficher la version :

make version

Prêt à exécuter :

make run

Test

Exécutez les tests ERPLibre avec son générateur de code.

time make test_full_fast

Documentation

Guide Description
DISCOVER Découvrir et explorer ERPLibre
DEVELOPMENT Configuration de l'environnement de développement
PRODUCTION Déploiement du serveur de production
RUN Modes d'exécution et cas d'utilisation
CODE_GENERATOR Génération de code de modules Odoo
MIGRATION Migration de base de données entre versions
GIT_REPO Gestion des dépôts Git
POETRY Gestion des dépendances Python
FAQ Foire aux questions
HOWTO Guides pratiques
WINDOWS_INSTALLATION Installation sous Windows

Contribution

Consultez CONTRIBUTION.md pour les directives.

Licence

Ce projet est sous licence GNU Affero General Public License v3.0.