Mise en place

OdooAsso — Projet de modules Odoo pour la gestion associative 
 Contexte 
 Odoo présente une orientation naturelle vers l'entreprise et un niveau de complexité
d'usage trop important pour les utilisateurs d'associations. L'objectif de ce projet
est de regrouper tous les besoins en quelques modules cohérents pour simplifier au
maximum la gestion, et de produire un travail de qualité suffisante pour être partagé
avec d'autres associations. 
 Stack cible : Odoo 16 Community, déployé en Docker.
 Modules tiers utilisés : modules OCA (vertical association, membership, partner…),
modules Deodoo. 
 
 Architecture du dépôt 
 Structure monorepo inspirée du standard OCA : 
 OdooAsso/ # dépôt public GitHub/GitLab
├── README.md
├── projet.md
├── .pre-commit-config.yaml # linting OCA
├── setup.cfg
├── oca_dependencies.txt # versions des modules OCA requis
├── asso_base/ # socle — groupes, menus racine, mixins
├── asso_membership/ # gestion des membres et cotisations
├── asso_event/ # événements et activités
├── asso_accounting/ # comptabilité simplifiée (loi 1901)
├── asso_portal/ # portail adhérent
└── asso_website/ # front public
 
 Principe de séparation 
 asso_base déclare les groupes d'accès, les menus racine et les mixins réutilisables.
Tous les autres modules en dépendent. Les modules métier sont indépendants les uns des
autres autant que possible, pour permettre une adoption partielle. 
 
 Namespace 
 Le préfixe asso_ est choisi pour être neutre et réutilisable (pas de nom d'association
spécifique). Si le projet vise explicitement le contexte français (loi 1901, plan
comptable associatif), le préfixe fr_asso_ peut être envisagé. 
 
 Stratégie de simplification UX 
 C'est le cœur de la valeur ajoutée du projet. Odoo est simplifié à trois niveaux : 
 1. Groupes d'accès dédiés 
 Des groupes propres sont créés, sans réutiliser les groupes Odoo natifs : 
 
 group_asso_user — membre du bureau, usage courant 
 group_asso_manager — responsable, accès étendu 
 group_asso_admin — administrateur technique 
 
 Cela permet de masquer tout ce qui n'est pas pertinent pour une association. 
 2. Menus simplifiés 
 
 Les menus natifs Odoo sont désactivés ( active="False" ) pour les groupes asso_* 
 Une arborescence plate et orientée tâches les remplace :
 
 Membres → Activités → Finances → Communication 
 
 
 
 3. Vues allégées 
 
 Les vues natives sont héritées pour masquer les champs inutiles 
 L'attribut groups est utilisé sur les champs avancés (visibles admins seulement) 
 
 4. Wizards pour les actions courantes 
 Les opérations fréquentes sont regroupées en wizards pour éviter la navigation
multi-menus : inscription en masse, relances cotisations, exports, etc. 
 
 Qualité et partageabilité 
 Outils 
 
 
 
 Outil 
 Rôle 
 
 
 
 
 pre-commit (config OCA) 
 Linting XML, Python, manifest 
 
 
 Tests unitaires Odoo 
 Validation des modèles et flux métier 
 
 
 oca_dependencies.txt 
 Déclaration explicite des dépendances OCA 
 
 
 
 Lancer les tests 
 odoo-bin --test-enable --stop-after-init -i asso_membership
 
 Conventions 
 
 Chaque module déclare ses dépendances OCA explicitement dans son __manifest__.py 
 Les données de configuration ( data/ ) sont séparées des données de démonstration ( demo/ ) 
 Les champs custom sont préfixés avec le nom du module ( membership_date_end plutôt que x_date_end ) 
 
 
 Environnement de développement 
 Le projet tourne en Docker. Ajouter un docker-compose.override.yml pour monter le
dépôt directement dans le addons_path : 
 services:
 odoo:
 volumes:
 - ./OdooAsso:/mnt/extra-addons
 
 Travailler en mode --dev xml pour recharger les vues sans redémarrer le serveur. 
 
 Modules — périmètre fonctionnel 
 asso_base 
 
 Groupes d'accès et règles de sécurité 
 Menus racine et structure de navigation 
 Modèles abstraits et mixins partagés 
 Configuration générale de l'association 
 
 asso_membership 
 
 Gestion des adhérents (hérite res.partner ) 
 Types d'adhésion et tarifs 
 Suivi des cotisations et renouvellements 
 Relances automatiques 
 
 asso_event 
 
 Événements et activités de l'association 
 Inscriptions et présences 
 Lien avec les adhérents 
 
 asso_accounting 
 
 Simplification de la comptabilité pour le contexte associatif (loi 1901) 
 Plan comptable associatif 
 Suivi des subventions 
 
 asso_portal 
 
 Espace adhérent en ligne 
 Consultation et renouvellement d'adhésion 
 Inscription aux événements 
 
 asso_website 
 
 Pages publiques de l'association 
 Formulaire d'adhésion en ligne 
 Agenda public des événements 
 
 
 Étapes de démarrage 
 
 Initialiser le dépôt Git avec la structure monorepo 
 Configurer pre-commit avec la config OCA standard 
 Lister les fonctionnalités par module en partant des douleurs utilisateurs actuelles 
 Créer asso_base : groupes, menus racine, modèles abstraits 
 Migrer progressivement les développements existants dans cette structure