Caution

La branche V2 est un propotype en ALPHA : Ne pas utiliser en production

Utilisez la branche main.

TiBillet

Billetterie, caisse, cashless, adhésion, monnaie locale — fabriqués en commun.

Coopérative Code Commun · Documentation · Budget contributif · Discord · 🇬🇧 English

---

🇬🇧 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 →

---

TiBillet, c'est quoi ?

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 juridique, 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 dark pattern. 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.

---

Fonctionnalités

	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/

---

Documentation en cours d'écriture collaborative et disponible en français sur : https://tibillet.coop/

L'ancienne documentation EN/FR est toujours disponible ici : https://tibillet.github.io/documentation_v2/

---

En production, pour de vrai

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.

---

Démarrage rapide

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

# Lespass uniquement :
docker compose up -d
# Lespass + Laboutik
docker compose -f docker-compose-laboutik-V1.yml 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'

#idem pour Laboutik :
docker exec -ti laboutik_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
• https://laboutik.tibillet.localhost

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

---

Tests

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/ -v

Voir 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.

---

Architecture

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.

---

Plus qu'un logiciel libre

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

---

Contribuer

TiBillet ne fonctionne pas avec des "issues" et des "pull requests" dans le vide. On construit ensemble.

Le budget contributif

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.

Comment on travaille

• 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.

Par où commencer

1. Venez discuter sur Discord — on vous accueille, on vous oriente.
2. Consultez les chantiers sur le budget contributif — il y a des tâches de tous niveaux, de la documentation à l'architecture Django.
3. Lisez le GUIDELINES.md pour les conventions de code (FALC, HTMX, ViewSets, etc.).
4. 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.

---

Qui fabrique TiBillet

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.

Soutiens

• Lauréat France 2030 — Appel à projet "Billetterie innovante" du ministère de la Culture.
• JetBrains — Licences open source.

---

Licence

AGPLv3 — Libre, et ça le restera.

---

Contact

• Discord : discord.gg/ecb5jtP7vY
• Matrix : https://matrix.to/#/#tibillet:tiers-lieux.org
• Email : contact@tibillet.re
• Site : tibillet.coop
• Coopérative : codecommun.coop