Sviluppa un motore di coupon e codici promozionali con API per il checkout

Il mio negozio online lancia promozioni quasi ogni mese, e in questo momento ogni codice promozionale è un mal di testa: lo sviluppatore lo codifica nel codice e il marketing aspetta. Voglio sostituire questo caos con un normale motore di coupon che il team di marketing possa gestire da solo, senza un programmatore. Il compito principale è generare codici sconto (uno alla volta e in grandi lotti), memorizzarli nel database e verificarli nella stessa seconda in cui un cliente inserisce il codice al checkout. Ogni codice dovrebbe avere il proprio insieme di regole: sconto in percentuale, importo fisso, offerta "compra uno prendi uno" o sconto solo sul primo ordine. Abbiamo anche bisogno di limiti di utilizzo per codice e per cliente, date di inizio e fine, e una soglia di importo minimo del carrello opzionale affinché il codice sia valido.

Il cuore del progetto è una piccola API REST che la pagina di checkout chiamerà. Dato un codice e il totale attuale del carrello, dovrebbe rispondere rapidamente: il codice è valido, quale sconto applicare e perché è stato rifiutato (scaduto, limite esaurito, cliente sbagliato, carrello troppo piccolo). È importante che il sistema gestisca in modo sicuro i riscatti concorrenti in modo che un codice limitato non possa essere speso due volte in una condizione di gara, e ogni riscatto è registrato per la reportistica. Una bella aggiunta sarebbe un semplice pannello di amministrazione dove un dipendente non tecnico può creare un codice, scegliere una regola, impostare limiti e date, e mettere in pausa o disabilitare un codice al volo.

Ti chiedo di concentrarti specificamente sui codici sconto. Questo non è un programma di referral o un'app di fidelizzazione con punti, quindi non ho bisogno di inviti per amici, livelli e accumulo di saldi punti. La cosa più importante: matematica corretta degli sconti, validazione sicura sotto carico e un'API che il mio sviluppatore frontend possa facilmente integrare. Documentazione e alcune richieste di esempio sarebbero molto utili.

— Generazione di codici: singola e in batch, con prefissi arbitrari e formato leggibile
— Tipi di regole: percentuale, importo fisso, BOGO, solo primo ordine
— Limiti: utilizzi totali, per cliente, importo minimo del carrello, date di validità
— API di validazione: endpoint REST veloce che restituisce validità, importo dello sconto e motivo
— Riscatto concorrente sicuro con log completo per reportistica
— Pannello di amministrazione semplice per creazione, pausa e disabilitazione dei codici