Concepts

Remizo est un moteur de promotion et de fidélité temps réel. Il reçoit un ticket, applique les offres actives de l’enseigne et renvoie ce que la caisse doit faire : remises, points, coupons, messages. Cette page présente le vocabulaire utilisé dans tout le studio et dans l’API.

Hub et workspaces

• Le hub est le plan de contrôle central : studio (pour les marketeurs), console (pour l’équipe éditeur), API de gestion, connexion unique, sauvegardes, tâches planifiées et supervision.
• Un workspace correspond à un client (une enseigne). Il possède sa propre grappe — un ou plusieurs moteurs, sa base PostgreSQL (répliquée en production) et son cache Valkey. Son identifiant court, le slug (par exemple acme), est figé à la création.
• Chaque workspace peut avoir une sandbox (acme-sbx) : un environnement de test isolé, avec ses propres clés d’API test.

Le moteur d’un workspace calcule seul : il a en mémoire les offres publiées et vérifie lui-même les clés d’API. Si le hub est arrêté, les caisses continuent d’être servies.

Une offre

Une offre se lit comme une phrase : quand (déclencheur) si (critères) alors (actions).

Élément	Rôle	Exemples
Déclencheur	Ce qui provoque l’évaluation	un ticket (transaction), un événement client (event : inscription, anniversaire…), un coupon présenté (coupon)
Critères	Les conditions, combinées en groupes ET / OU / NON	montant du ticket, jour et heure, magasin, canal, statut de fidélité, segment, article, moyen de paiement, solde d’un compteur
Actions	Ce qui se passe quand les critères sont remplis	remise en € ou en %, prix barré, produit offert, points, coupon, message ticket
Cumul	Comment l’offre cohabite avec les autres	niveau d’exécution, mode cumulative / best_offer / best_line, priorité, exclusions
Limites	Le budget	nombre d’utilisations, montant total, limite par client, par magasin, par ticket
Validité	La fenêtre d’activation	du 1er au 30 novembre, ou sans fin

Une offre a un code lisible (WELCOME10), unique dans le workspace et immuable : c’est lui qui apparaît sur les tickets et dans les réponses WsOne (offerNumber).

Versions et statuts

Chaque modification crée une version. Une offre a au plus une version de travail et une version publiée à la fois. Les statuts suivent le circuit suivant :

brouillon → à valider → approuvée → publiée ⇄ suspendue → expirée / archivée

• La publication est immédiate, offre par offre : les moteurs la chargent en moins de deux secondes.
• L’arrêt d’urgence (suspendre) retire l’offre des moteurs immédiatement, sans la supprimer.
• Le retour arrière republie une version précédente en un clic (une nouvelle version est créée, copie de l’ancienne).
• Si le circuit de validation est désactivé pour le workspace, un brouillon peut être publié directement.

Montants et unités

• Tous les montants sont en centimes entiers : 5490 signifie 54,90 €. Aucun nombre à virgule n’est utilisé pour l’argent.
• Les pourcentages sont en points de base : 1000 = 10 %, 10000 = 100 %. Un multiplicateur de points ×2 s’écrit 20000.
• La caisse est maître des montants. Remizo applique les offres sur les montants reçus et renvoie les ajustements. Si la somme des lignes ne correspond pas au total, le moteur émet un simple avertissement (coherence_lines_vs_total), jamais un refus.

Clients, cartes et compteurs

• Le référentiel client est hiérarchique : compte → client → carte. Un client peut être identifié par sa carte, son compte web, son wallet mobile, son e-mail ou une référence externe.
• Les compteurs portent les soldes : points, cashback en centimes, nombre de visites, compteurs techniques. Chaque mouvement est enregistré dans un registre qui n’efface jamais rien ; les soldes sont disponibles en temps réel.
• Les coupons ont un cycle de vie : disponible → réservé → utilisé, ou expiré / annulé.

Niveaux et cumul

Les offres sont évaluées par niveaux croissants (0, 1, 2…). Le niveau 1 travaille sur le ticket après les remises du niveau 0. Au sein d’un niveau, le mode de cumul décide qui s’applique. Voir Cumul des offres.

Explication

Pour chaque ticket, le moteur renvoie la liste des offres appliquées et des offres refusées avec leur raison (criteria_not_met, lost_best_offer, customer_limit_reached…). Le simulateur du studio affiche en plus la trace de chaque critère.

Drapeaux de fonctionnalités

Certaines fonctions s’activent par workspace : tests A/B, segments, critères à l’article, rendu des coupons en image ou PDF, webhooks, connecteurs de synchronisation, adaptateur WsOne, paiement en points, outils RGPD, imports en masse, expressions CEL personnalisées. L’assistant IA est présent dans l’interface mais pas encore opérationnel (features.ai, désactivé par défaut).