Cahier des charges · v1.0 Suivi des agents

Cahier des charges
du projet Fidzo

La carte de fidélité sans carte. Approcher. Gagner. Revenir.

Spécification complète du produit : concept, fonctionnalités, règles métier, anti-triche, support physique, identité visuelle, architecture technique, conformité et plan de lancement.

Version 1.0 Date octobre 2026 Statut pré-MVP Porteur Chris Arbelbide
01

Vision et objectifs

Fidzo est une plateforme de fidélité destinée aux petits commerces indépendants. Elle remplace les cartes de fidélité papier par une page web que le client ouvre en approchant son téléphone d'une borne NFC posée près de la caisse. Sans application à installer, sans inscription, sans carte à perdre.

Pitch : « Fidzo : la fidélité simple pour les commerces de proximité. »

Objectifs

Principe directeur : toute fonctionnalité qui ajoute une action au client ou au commerçant doit justifier la friction qu'elle crée. En cas de doute, on ne l'ajoute pas.
02

Cibles

Les commerçants (clients payants)

Petits commerces indépendants de proximité. Premier segment visé : les boulangeries, puis cafés, snacks, fleuristes et coiffeurs. Commerces dont la fidélité repose aujourd'hui sur des cartes papier ou tampons, sans outil numérique.

Les clients des commerces (utilisateurs)

Clients réguliers du commerce, tout âge, tout smartphone récent (iPhone et Android). Ils ne créent aucun compte et ne téléchargent rien : ils approchent leur téléphone de la borne à chaque visite.

03

Concept et parcours

Une borne NFC passive est posée près de la caisse, avec un QR code de secours. Les deux pointent vers une adresse web propre au commerce (par exemple /m/boulangerie-demo).

Parcours client

1
Le client approche son téléphone de la borne (ou scanne le QR)
2
La page web du commerce s'ouvre, sans application ni compte
3
Un point est ajouté ; la progression vers la récompense s'affiche
4
Seuil atteint : le client montre son écran et reçoit sa récompense

Parcours commerçant

Le commerçant ne fait rien au quotidien. Il dispose d'un espace en ligne pour suivre l'activité (visites, clients), modifier sa récompense et imprimer ses supports. Fidzo installe et configure tout au départ.

Identifiant client

Le client est reconnu par un identifiant pseudonyme conservé sur son appareil (dans son navigateur). Aucune donnée nominative n'est demandée au MVP : pas de nom, pas d'e-mail, pas de téléphone.

04

Fonctionnalités

Page client (mobile d'abord)

Espace commerçant

Espace administrateur Fidzo

Hors périmètre du MVP : cartes Apple Wallet et Google Wallet, multi-commerce côté client (une carte regroupant plusieurs commerces), application mobile native, paiement, programme de parrainage. Ces pistes sont prévues pour plus tard.
05

Règles métier

RègleDéfinition
Gain de point1 visite validée en boutique = 1 point.
Plafond anti-abusMaximum 1 point par jour et par commerce (valeur de démonstration, à valider).
Seuil de récompenseNombre de points configurable par commerce (exemple : 10 passages = 1 pâtisserie offerte).
UtilisationSeuil atteint, le client présente son écran ; le compteur repart à zéro.
RécompenseTexte libre défini par le commerçant, affiché sur la borne et sur la page client, modifiable à tout moment.
06

Anti-triche

Exigence centrale du projet : un point ne peut être gagné qu'en étant physiquement dans la boutique. Garder le lien et le rafraîchir depuis chez soi ne doit pas fonctionner.

Niveau 1 Code secret dans l'adresse de la borne

Chaque borne pointe vers une adresse contenant un code secret (par exemple /m/commerce?c=…). Le serveur vérifie le code, accorde le point, puis le retire de la barre d'adresse : un simple rafraîchissement ne rapporte rien. Le commerçant peut régénérer le code s'il est diffusé. Combiné au plafond d'1 point par jour. Limite connue : une personne motivée peut recopier le lien.

Niveau 2 Puce NTAG 424 DNA

La puce génère une adresse chiffrée unique à chaque scan ; le serveur rejette toute adresse déjà utilisée. Fonctionne sans application sur iPhone XS et plus récent et sur Android récent. Nécessite une vérification côté serveur et une programmation unique de chaque puce. Recommandé dès le premier commerce réel. Surcoût estimé : environ 0,50 € à quelques euros par borne selon le support de puce.

07

Support physique : la borne

La borne est l'objet visible du service en boutique. Quatre exigences, dans l'ordre :

Solution retenue pour le pilote

Cadre acrylique magnétique A6 (16 mm) + carte NFC 424 glissée derrière une feuille A6 imprimée avec la récompense du commerce. Changer l'offre = réimprimer la feuille. Coût estimé : environ 9 € par commerce. Commande de 2 à 3 exemplaires de test avant toute série. La puce est placée contre la face avant pour une lecture fiable.

08

Identité visuelle

Direction artistique chaleureuse et ronde, issue de la charte validée. Boutons en pilule, ondes NFC en motif, photos d'ambiance de commerces.

Orange doux#E58A54
Crème#FFF2E8
Noir doux#1F1F1F
Gris#666B6B
ÉlémentDéfinition
LogotypeMot-symbole « fidzo » dont le o porte des ondes NFC concentriques. Police Fredoka Bold.
TypographieFredoka pour les titres et la marque ; police système lisible pour les textes courants.
BoutonsForme pilule, texte sombre sur orange (le texte blanc sur orange n'est pas assez contrasté).
TonChaleureux, direct, sans jargon. Phrases courtes.
09

Architecture technique

Stack retenue, alignée sur la méthode et les outils de référence du projet :

BriqueOutilRôle
Front-endReact + TypeScript + VitePages client, espace commerçant, espace admin
HébergementCloudflare PagesMise en ligne du site, déploiement continu depuis GitHub
APICloudflare WorkersLogique serveur : points, anti-triche, vérification des scans
Base de donnéesCloudflare D1Commerces, clients pseudonymes, points, récompenses
StockageCloudflare KV / R2Configuration rapide, fichiers (logos, affiches)
Code et versionsGitHub + GitHub ActionsDépôt, intégration et déploiement continus
Connexion commerçantGoogle OAuthAccès à l'espace commerçant sans mot de passe dédié
E-mailsBrevoE-mails transactionnels (alertes, récompenses, contact)

Exigences transverses : mobile d'abord, testé sur iPhone et Android réels ainsi que sur iPad (Safari), aucune information sensible dans le code, version publiée vérifiée avant de déclarer une étape terminée.

10

Données et RGPD

11

Modèle économique

ÉlémentHypothèse à valider
Abonnement25 à 40 € par mois et par commerce — prix à valider commercialement auprès d'environ 10 commerçants.
InstallationClé en main, offerte ou facturée séparément (à décider).
MatérielBorne environ 9 € par commerce (cadre + puce + impression).
Pilote2 à 3 commerces équipés gratuitement pour prouver la valeur avant facturation.
12

Concurrence et différenciation

Solutions existantes repérées : Lecy (concurrent direct le plus proche : NFC, sans application, client anonyme), LoyPass, Fidelopass, Fidaly, Zerosix, Pongo, WS Fidly, Fidelyte, Fidtap, TapFid, Loylo.

Différenciation visée

13

Limites connues et risques

Limite / risqueRéponse prévue
Sur iPhone, le NFC affiche une notification à toucher (pas d'ouverture directe)L'affichage sur la borne guide le geste ; acceptable au MVP
Identifiant perdu si le client efface ses données de navigation, navigue en mode privé ou change de téléphoneAccepté au MVP ; Wallet ou compte léger envisagés plus tard
Anti-triche niveau 1 contournable en recopiant le lienPassage au niveau 2 (puce 424 DNA) dès le premier commerce réel
Marque : la marque FIDZY (classes 9 et 41) est proche phonétiquementRecherche d'antériorité à terminer (classes 9, 35, 42 + TMview) avant impression et dépôt
Adoption par les commerçants non prouvéePilote gratuit et validation du prix avant tout investissement lourd
14

Jalons

ÉtapeContenuCritère de sortie
1. CadrageCe cahier des charges, identité visuelle, dépôt de codeSpécification validée
2. MVP en lignePage client, espace commerçant, espace admin sur la stack CloudflareDémo utilisable sur téléphone
3. Test réelScan NFC et QR sur iPhone et Android réels, anti-triche niveau 1 activéPoint gagné uniquement en boutique
4. Validation terrainÉcoute d'environ 10 commerçants sur le besoin et le prixPrix validé ou ajusté
5. Pilote gratuit2 à 3 commerces équipés, borne niveau 2 (puce 424 DNA)Points gagnés et récompenses distribuées en conditions réelles
6. LancementFacturation, supports imprimés, statut juridique, marquePremiers commerces payants
15

Critères d'acceptation

16

Points ouverts à décider

SujetDécision attendue
Plafond d'un point par jourValidation définitive de la règle anti-abus
Code administrateurÀ remplacer avant le lancement réel (l'actuel a circulé par message)
Nom de domaine fidzo.frAchat à confirmer
E-mail de marqueChoix entre adresse payante sur fidzo.fr, redirection gratuite ou adresse Gmail de projet
MarqueFinir les recherches « fidzo », « fidizy », « fidiz » (classes 9, 35, 42) et TMview
Bornes de testCommande de 2 à 3 cadres pour essai avant toute série
Migration techniqueLe MVP actuel (Netlify + Supabase) sera reconstruit sur la stack Cloudflare décrite ici