Système de carte-cadeau numérique pour une boutique en ligne

Je gère une boutique en ligne de taille moyenne et je souhaite ajouter un véritable système de carte-cadeau numérique, construit de zéro et intégré dans mon processus de paiement existant. Un client doit pouvoir acheter une carte pour n'importe quel montant dans les limites que je fixe, choisir un modèle de design, ajouter un message de vœux personnel, et envoyer le tout au destinataire par email. Le destinataire reçoit un email avec un code unique et un beau design de carte et peut commencer à l'utiliser pour payer immédiatement. C'est exactement un outil avec valeur stockée, donc chaque carte doit avoir son propre solde que le système suit précisément à chaque opération. Je n'ai pas besoin d'un générateur de coupons ou de codes promo, et ce n'est pas un programme de points de fidélité—ce sont des choses séparées. J'ai besoin d'un équivalent monétaire lié à un code que les gens achètent, offrent en cadeau et dépensent.

La chose la plus importante pour moi est la déduction partielle lors du paiement. Lorsque le client entre un code de carte dans le panier, le système doit appliquer le solde disponible au total de la commande, le couvrir partiellement ou entièrement, laisser le reste à payer par des méthodes normales, et préserver tout solde non dépensé sur la carte pour l'avenir. La possibilité d'utiliser plusieurs cartes dans une seule commande serait un plus. Chaque changement de solde doit être enregistré comme une entrée de journal immuable afin que je puisse toujours retracer l'historique : montant d'émission, chaque déduction, remboursements et ajustements manuels. Les codes doivent être générés de manière à être difficiles à deviner, émis une seule fois et envoyés de manière sécurisée par email. Les règles d'expiration doivent être configurables, et l'ensemble du processus doit gérer les double-clics et les conditions de concurrence en toute sécurité sans risquer qu'une carte soit facturée deux fois.

Le panneau d'administration doit permettre à mon équipe d'émettre des cartes manuellement, de trouver n'importe quelle carte par code ou client, de voir l'historique complet des soldes, de geler ou d'annuler une carte, de renvoyer un email, d'ajuster le solde avec une note de raison, et d'exporter des rapports. Je vous demande de respecter le style visuel et les conventions de code utilisées dans la boutique, d'écrire un code propre et documenté, et de couvrir la logique de solde et de déduction avec des tests avant la livraison.

— Achat : sélection du montant, choix du modèle, texte de vœux ; paiement via la passerelle existante
— Livraison au destinataire par email avec un code unique, difficile à deviner
— Solde par carte avec journal d'opérations immuable
— Déduction partielle lors du paiement, reste payé normalement ; montant non dépensé préservé
— Expiration et statuts configurables (actif, gelé, annulé, utilisé)
— Panneau d'administration : émission, recherche, ajustement, gel, renvoi d'email, exportation de rapport
— Protection contre les conditions de concurrence ; tests pour la logique de solde et de déduction