Caution
ALPHA V2 RELEASE, NOT FOR PROD (check main for production)
Coopérative Code Commun · Documentation · Budget contributif · Discord · 🇬🇧 English
TiBillet est un ensemble d'outils libres pour les lieux culturels, les festivals, les associations et les tiers-lieux : billetterie en ligne, caisse enregistreuse, cashless par carte NFC, gestion d'adhésions, monnaie locale et monnaie temps.
Mais TiBillet n'est pas qu'un logiciel. C'est un commun numérique, construit par et pour les gens qui s'en servent. Plusieurs centaines de lieux et organisations, plus d'une vingtaine en contribution active, une coopérative pensé comme un commun juridiqu e, et l'idée simple que les outils qui font tourner nos lieux de vie ne devraient appartenir à personne d'autre qu'à ceux qui les utilisent.
Le principe : Un outil de création de fédération a travers des agendas et billetteries, une caisse enregistreuse et carte NFC unique, valable dans tout le réseau. Pas de frais d'activation, pas de date d'expiration, pas de case à décocher. Vous rechargez quand vous voulez, vous dépensez où vous voulez, vous vous faites rembourser quand vous voulez. Et la carte sert aussi de carte d'adhésion, de porte-monnaie local et/ou de monnaie temps.
Alternatives à : Weezevent, HelloAsso, Cyclos, L'Addition, Ulule, Caisses et POS JVC... Mais TiBillet va encore plus loin car pensé pour créer des fédérations : Une billetterie peut se fédérer à d'autres pour créer des agendas communs. Des caisses peuvent lire les mêmes cartes NFC pour faire des monnaies locales. Des collectifs peuvent fédérér des producteurs pour créer une caisse sociale alimentaire.
🇬🇧 English speakers: TiBillet is a federated, open-source toolkit for ticketing, POS, NFC cashless payments, memberships, and local currencies — built as a digital commons by the Code Commun Cooperative. Read more in English →
| Module | Description | Détails | |
|---|---|---|---|
| 🎫 | Billetterie & Agenda | Événements, tarifs, réservations en ligne, QR codes, scan à l'entrée | → BaseBillet/ |
| 🏪 | Caisse enregistreuse | Point de vente tactile, grille d'articles, multi-moyens de paiement, conforme LNE | → laboutik/ |
| 💳 | Cashless NFC | Carte sans contact, rechargement en ligne ou sur place, paiement fédéré multi-lieux : Cashless de festival. | → fedow_core/ |
| 🤝 | Adhésions | Cotisations en ligne ou sur place, vérification au scan, tarifs préférentiels | → BaseBillet/ |
| 🪙 | Monnaie locale & temps | Euros, monnaie cadeau, monnaie temps — plusieurs devises sur une seule carte | → fedow_core/ |
| 📊 | Rapports & comptabilité | Clôtures de caisse, export FEC, bilans billetterie, PDF et CSV | → laboutik/ |
| 📦 | Inventaire | Stock par produit, alertes, journal de mouvements, mise à jour temps réel | → inventaire/ |
| 🗳️ | Budget contributif | Initiatives, votes, financement participatif, co-rémunération transparente, suivi d'engagement bénévoles. | → crowds/ |
| 🖨️ | Impression thermique | Tickets, reçus, clôtures — Sunmi Cloud, LAN, imprimante interne, impréssion de commande en cuisine | → laboutik/ |
| 🌐 | API sémantique | Schema.org / JSON-LD, clé API, endpoints REST | → api_v2/ |
TiBillet n'est pas un prototype. C'est un outil en production depuis 2018, né au Manapany Festival à La Réunion, aujourd'hui déployé sur plusieurs dizaines de lieux — des cafés associatifs aux festivals de 15 000 personnes.
Quelques exemples de ce que TiBillet rend possible aujourd'hui :
- 4 festivals à Montpellier partagent la même carte NFC pour 15 000 festivaliers. Une carte, quatre lieux, zéro bracelet jetable.
- Un collectif citoyen en Normandie distribue 100 cartes pour de l'aide alimentaire solidaire (Sécurité Sociale de l'Alimentation). Chaque carte est créditée de 100 €, peu importe ce que la personne a payé. Pas de contrôle, pas de case "précaire" à cocher — juste de la dignité.
- La Raffinerie à La Réunion, une ancienne sucrière reconvertie en tiers-lieu, utilise une monnaie temps : les heures passées sur les chantiers participatifs du mercredi sont comptabilisées sur la carte, échangeables contre des services ou des boissons au bar associatif le soir.
- Des bars associatifs vérifient l'adhésion automatiquement au scan NFC — fini le fichier Excel que personne ne consultait.
TiBillet tourne dans Docker. Une seule commande pour lancer l'environnement de développement :
git clone https://github.com/TiBillet/TiBillet.git
cd TiBillet
cp env_example .env # Configurer les variables d'environnement
docker compose up -d
# pour les donnée de démo / dev
docker exec -ti lespass_django bash
./flush.sh # la première fois, ça installe toute les fixtures et lance le serveur
rsp # Si l'installation a déja été réalisé, lance le serveur de dev'L'application est accessible sur https://lespass.tibillet.localhost.
L'admin est sur https://lespass.tibillet.localhost/admin/ (auto-login en mode développement).
Prérequis : Docker, Docker Compose, et un reverse proxy Traefik (inclus dans le compose).
Pour les détails d'installation, de configuration et de déploiement en production : → Documentation complète
618 tests pytest + 117 tests E2E Playwright, 100% verts.
# Tests unitaires et integration (pytest DB-only, ~3 min)
docker exec lespass_django poetry run pytest tests/pytest/ -v
# Tests End-to-End (Playwright Python, ~12 min)
# Prerequis : serveur Django ASGI via Traefik (alias `rsp` dans le pane byobu,
# lance `manage.py runserver` en mode daphne pour le support WebSocket).
docker exec \
-e ADMIN_EMAIL=admin@admin.com \
-e E2E_TEST_TOKEN='<voir .env>' \
lespass_django poetry run pytest tests/e2e/ -vVoir tests/TESTS_README.md pour la documentation complete (architecture, pieges,
variables d'environnement).
Carte Stripe de test : 4242 4242 4242 4242, exp 12/42, CVC 424.
TiBillet est en cours d'unification en mono-repo. Les trois services historiques (Lespass, LaBoutik, Fedow) deviennent un seul projet Django multi-tenant :
TiBillet (mono-repo)
├── BaseBillet/ Billetterie, adhésions, événements
├── laboutik/ Caisse enregistreuse, POS
├── fedow_core/ Portefeuille fédéré, tokens, multi-devises
├── crowds/ Budget contributif, financement participatif
├── inventaire/ Gestion de stock POS
├── api_v2/ API sémantique schema.org
├── Administration/ Admin Django (Unfold)
├── AuthBillet/ Authentification, SSO
├── PaiementStripe/ Paiements, webhooks Stripe
└── ...
Stack : Django 4.2, Python 3.11, PostgreSQL 13 (multi-tenant via django-tenants), Redis, Celery, HTMX + Bootstrap 5, Django Channels (WebSocket).
Pas de SPA, pas de framework JavaScript lourd. Le rendu est côté serveur. Les interactions dynamiques passent par HTMX. Le JavaScript est minimal (toasts et petites interactions). C'est un choix délibéré : le code doit pouvoir être lu et modifié par des développeur·euses non-expert·es qui rejoignent la coopérative.
TiBillet est sous licence AGPLv3. Ça garantit que le code restera libre — personne ne peut le verrouiller, le fermer, le privatiser.
Mais on pense que le logiciel libre, aussi génial soit-il, ne suffit pas. Un dépôt Git avec une licence libre, c'est une ressource ouverte. Ce n'est pas encore un commun. Des tanks roulent sur Linux. Les plus grandes entreprises du monde construisent leur fortune sur du logiciel libre. La licence protège le code. Elle ne protège ni les usages, ni les gens.
Nous n'avons pas choisi de "faire un commun". On fabrique en commun, parce que TiBillet n'aurait jamais pu être construit autrement.
La monnaie temps de la Raffinerie, c'est une idée qui a émergé des chantiers du mercredi matin — pas d'un cahier des charges. La SSA en Normandie, c'est un collectif citoyen qui a dit "on a besoin de ça" et qu'on a accompagné sur place. Le mode festival, c'est le retour de dix ans de bénévoles derrière des tireuses à bière à 2h du matin. Aucun de ces usages n'aurait été inventé par une équipe de développeurs seuls dans un bureau, ni par un modèle d'IA entraîné sur du code — parce que ces solutions viennent des gens qui vivent les problèmes, pas de ceux qui imaginent les résoudre.
On s'appuie sur les travaux d'Elinor Ostrom pour penser ce qu'on fait. Un commun, c'est trois choses indissociables :
- Une ressource partagée — le logiciel, oui, mais surtout tout ce qu'il permet : l'agenda fédéré, la carte partagée, les données qui restent chez vous.
- Une communauté vivante — les lieux qui s'en servent, qui remontent des besoins, qui testent, qui documentent. C'est le point de départ, pas un bonus.
- Une gouvernance organisée — la coopérative Code Commun, structurée en SCIC avec trois collèges (animateur·ices, contributeur·ices, utilisateur·ices), où chaque voix compte pareil.
« Un logiciel libre qui dort au fond d'une forge Git ne change pas le monde. Un commun vivant, partagé, documenté et soutenu, si. » — Charte Code Commun
Pour aller plus loin : Qu'est-ce qu'un commun numérique ? · Charte et valeurs
TiBillet ne fonctionne pas avec des "issues" et des "pull requests" dans le vide. On construit ensemble.
On met les sous sur la table — littéralement. Sur codecommun.tibillet.coop/contrib, vous trouverez les chantiers en cours, les budgets associés et les contributions de chacun·e. Vous choisissez une tâche, vous décidez comment vous voulez être rémunéré·e (ou pas — le bénévolat est bienvenu aussi), et c'est validé collectivement.
C'est ce qu'on appelle le budget contributif : pas de manager qui attribue les tâches, pas de hiérarchie qui décide des salaires. Chacun·e évalue ses besoins en transparence.
- Sessions de pair à pair — Tous les jeudis et vendredis, en visio, on code ensemble. Pas besoin d'être expert·e.
- Déplacements sur le terrain — On ne construit pas depuis un bureau. On va dans les lieux, on installe, on forme, on écoute les retours. C'est comme ça qu'émergent les vraies fonctionnalités.
- Réunions mensuelles ouvertes — Le premier lundi de chaque mois, tout le monde est invité. On parle de ce qui marche, de ce qui coince, de ce qu'on veut construire ensuite.
- Discord & Matrix — Pour le quotidien, les questions, les coups de main.
- Venez discuter sur Discord — on vous accueille, on vous oriente.
- Consultez les chantiers sur le budget contributif — il y a des tâches de tous niveaux, de la documentation à l'architecture Django.
- Lisez le GUIDELINES.md pour les conventions de code (FALC, HTMX, ViewSets, etc.).
- Proposez une idée — si un besoin revient dans 3-4 lieux, on s'y colle.
Le code suit le principe FALC (Facile À Lire et Comprendre) : noms de variables explicites, commentaires bilingues FR/EN, logique lisible de haut en bas, pas de magie. Parce qu'un commun numérique, ça implique que le code soit accessible à celles et ceux qui veulent s'en emparer.
TiBillet est porté par la Coopérative Code Commun, une SCIC (Société Coopérative d'Intérêt Collectif) basée à La Réunion.
L'équipe permanente :
- Jonas Turbeaux — Backend, DevOps, mainteneur. Ancien régisseur de festival et ingé son, bricoleur depuis toujours.
- Mike Caron — Hardware, systèmes embarqués, NFC.
- Nicolas Dijoux — Frontend senior.
- Axel Chabran — Administration, gestion de projet.
Et une vingtaine de contributeur·ices : développeur·euses, documentalistes, testeur·euses, bénévoles de lieux qui remontent des bugs et des idées.
La Raffinerie · Le Bisik · Le Manapany Festival · La Réunion des Tiers-Lieux · Communecter · CoopCircuit · et tous les lieux qui utilisent, testent et transforment TiBillet au quotidien.
- Lauréat France 2030 — Appel à projet "Billetterie innovante" du ministère de la Culture.
- JetBrains — Licences open source.
AGPLv3 — Libre, et ça le restera.
- Discord : discord.gg/ecb5jtP7vY
- Matrix : bientôt
- Email : contact@tibillet.re
- Site : tibillet.org
- Coopérative : codecommun.coop