À propos du projet
Une plateforme e-commerce trilingue construite une fois puis déclinée pour trois enseignes tunisiennes, avec paiement à la livraison, prix au millime près et timbre fiscal gérés nativement.
Mon rôle: Architecte produit et développeur full stack du template et de chaque déclinaison enseigne.
Je reconstruisais sans cesse la même boutique. Client différent, produits différents, mais le même catalogue trilingue, le même paiement à la livraison, les mêmes règles de facturation tunisiennes. J'ai donc cessé de traiter chaque projet comme un nouveau chantier et transformé le troisième en template marque blanche, puis je l'ai déclinée volontairement au lieu de recopier des fichiers.
Tout ce qu'un locataire peut changer tient au même endroit. Marque, coordonnées, thème et feature flags vivent dans un répertoire tenant unique, et tous les textes propres à l'enseigne sont regroupés dans des espaces de traduction dédiés. Décliner pour une nouvelle enseigne devient une checklist documentée plutôt qu'un travail d'archéologie. Ce template fait aujourd'hui tourner un revendeur d'électronique, une parapharmacie et un distributeur de courant faible et de vidéosurveillance, chacun avec son catalogue et son identité sur les mêmes fondations.
La stack est Next.js 16 avec l'App Router en TypeScript strict, Tailwind v4, et next-intl qui sert le français par défaut aux côtés de l'anglais et de l'arabe avec un support complet de la lecture de droite à gauche. Les données vivent dans PostgreSQL sur Cloud SQL via Drizzle, Firebase assurant authentification, stockage et hébergement. Les spécificités tunisiennes sont intégrées au domaine plutôt que rajoutées : la monnaie est modélisée en millimes pour qu'aucun arrondi ne dérive, le paiement à la livraison est le chemin principal et non une solution de repli, et le timbre fiscal s'applique à chaque commande comme la loi l'exige.
Fonctionnalités principales
- 🎨 Configuration tenant centralisée : Marque, coordonnées, thème et feature flags vivent au même endroit, si bien qu'une déclinaison est une checklist et non une enquête.
- 🌍 Trilingue avec vrai RTL : Français, anglais et arabe sont servis par next-intl, la mise en page de droite à gauche étant traitée comme un cas de premier plan.
- 💵 Paiement à la livraison en chemin principal : Le moyen de paiement dominant en Tunisie structure le tunnel de commande au lieu d'y être ajouté après coup.
- 🪙 Modèle monétaire au millime : Les montants sont stockés en millimes plutôt qu'en flottants, si bien que totaux et taxes ne dérivent jamais d'un arrondi.
- 🧾 Timbre fiscal sur chaque commande : Le timbre légal tunisien fait partie du domaine commande, si bien que les factures sont conformes sans intervention manuelle.
- 📱 Boutique pensée mobile d'abord : Les mises en page sont conçues pour le téléphone en priorité, d'où arrive la grande majorité des acheteurs tunisiens.
- 🗂️ Accès aux données typé : Drizzle sur PostgreSQL hébergé sur Cloud SQL garde schéma et requêtes vérifiés par le compilateur.
- 📘 Manuel de déclinaison documenté : Une checklist écrite couvre chaque étape du lancement d'une nouvelle enseigne, ce qui rend le template réellement réutilisable.
Problèmes et solutions
Problème: Les commerçants tunisiens de taille petite et moyenne ont tous les mêmes besoins : catalogue trilingue, paiement à la livraison, facturation conforme. Construire chaque boutique de zéro revient à payer trois fois le même travail, tandis qu'une plateforme internationale générique ne gère correctement ni le millime, ni le timbre fiscal, ni la mise en page arabe.
Solution: J'ai consolidé le troisième chantier en un template marque blanche où chaque valeur propre au locataire tient dans un répertoire de configuration et un jeu d'espaces de traduction. Une nouvelle enseigne devient une déclinaison documentée, et les règles tunisiennes que les plateformes génériques ratent font partie du modèle métier plutôt que de rustines locales.
