Plateforme de Fidelite

1
type BadgeCriteria =
2
  | { type: 'purchase_count'; threshold: number }  // Nombre d'achats
3
  | { type: 'points_earned'; threshold: number }    // Points cumules
4
  | { type: 'streak_days'; threshold: number }      // Jours de streak
5
  | { type: 'tier_reached'; tier: string }           // Palier atteint
6
  | { type: 'cashback_earned'; threshold: number }   // Cashback cumule
7
  | { type: 'programs_joined'; threshold: number };  // Programmes rejoints

1
// 1. Calcul du multiplicateur de streak
2
calculateStreakMultiplier(currentStreak: number): number
3
4
// 2. Verifier si la streak continue, se reset ou est deja comptee
5
shouldContinueStreak(
6
  lastDate: string, now: Date, type: 'daily' | 'weekly'
7
): 'continue' | 'reset' | 'already_counted'
8
9
// 3. Creer/mettre a jour les donnees de streak
10
updateStreakData(existing: StreakData | null, now: Date): StreakData
11
12
// 4. Detecter les badges nouvellement debloques
13
checkBadgeUnlocks(
14
  context: BadgeUnlockContext,
15
  definitions: BadgeDefinitionDTO[],
16
  alreadyEarned: string[]
17
): BadgeDefinitionDTO[]
18
19
// 5. Calculer la progression vers le prochain badge
20
calculateNextBadgeProgress(
21
  context: BadgeUnlockContext,
22
  definitions: BadgeDefinitionDTO[],
23
  alreadyEarned: string[]
24
): NextBadgeProgress | null
25
26
// 6. Integration Prisma -- appele depuis awardLoyalty()
27
processGamificationOnAward(
28
  loyaltyCardId: string,
29
  purchaseCount: number
30
): Promise<{ newBadges: EarnedBadgeDTO[]; streakUpdated: boolean }>

1
// Telecharger le .pkpass pour une carte de fidelite
2
const response = await fetch('/api/wallet/passes/apple/lc_xyz789');
3
4
if (response.ok) {
5
  const blob = await response.blob();
6
  // Declencher le telechargement du fichier .pkpass
7
  const url = URL.createObjectURL(blob);
8
  window.open(url); // iOS detecte automatiquement le format
9
}
10
11
// Obtenir le lien Google Wallet
12
const googleRes = await fetch('/api/wallet/passes/google/lc_xyz789');
13
const { saveUrl } = await googleRes.json();
14
// Rediriger vers Google Wallet
15
window.location.href = saveUrl;

1
// Verifier quelles plateformes sont disponibles
2
const statusRes = await fetch('/api/wallet/passes/status/lc_xyz789');
3
const status = await statusRes.json();
4
5
// status.apple.isAvailable  — certificats configures ?
6
// status.apple.isAdded      — pass deja ajoute ?
7
// status.google.isAvailable — cle de service configuree ?
8
// status.google.isAdded     — pass deja ajoute ?
9
10
// Afficher les boutons conditionnellement
11
if (status.apple.isAvailable && !status.apple.isAdded) {
12
  // Afficher "Ajouter a Apple Wallet"
13
}
14
if (status.google.isAvailable && !status.google.isAdded) {
15
  // Afficher "Ajouter a Google Wallet"
16
}

1
interface SpendingPattern {
2
  programId: string;
3
  programName: string;
4
  storeName: string;
5
  avgSpend: number;           // Depense moyenne par transaction
6
  avgFrequencyDays: number;   // Jours entre les transactions
7
  transactionCount: number;   // Nombre total de transactions
8
  category: SpendingCategory; // 'food' | 'shopping' | 'health' | ...
9
  trend: 'increasing' | 'stable' | 'decreasing';
10
  lastActivity: string;       // ISO 8601
11
}

1
// GET /api/customer/loyalty-stats
2
// Retourne les statistiques de fidelite etendues avec patterns de depenses
3
const response = await fetch('/api/customer/loyalty-stats');
4
const data = await response.json();
5
6
// data.recommendations: RewardRecommendationDTO[]
7
// data.spendingPatterns: SpendingPattern[]
8
// data.generatedAt: string (ISO 8601)
9
10
// Chaque recommandation contient :
11
// - title, description, priority ('high' | 'medium' | 'low')
12
// - reason (l'un des 8 types)
13
// - programId, storeName, logoUrl
14
// - estimatedBenefit (texte libre)
15
// - action { type, url, label }

1
import { apiPost, apiDelete } from '@/lib/api/client';
2
3
const programId = 'prog_abc123'; // ID du programme dans l'URL
4
5
// S'inscrire au programme — aucun body requis
6
const result = await apiPost(`/api/v1/mobile/loyalty/enroll/${programId}`);
7
8
// result.success — true si inscription reussie
9
// result.card    — LoyaltyCard creee { id, points, tier, ... }
10
11
// Se desinscrire du programme
12
const unenrollResult = await apiDelete(`/api/v1/mobile/loyalty/enroll/${programId}`);
13
14
// Lister le catalogue (tous les programmes disponibles)
15
import { apiGet } from '@/lib/api/client';
16
const catalog = await apiGet('/api/v1/mobile/loyalty/catalog');
17
// catalog.programs — CatalogProgramDTO[]
18
19
// Lister ses programmes inscrits
20
const enrolled = await apiGet('/api/v1/mobile/loyalty/programs');
21
// enrolled.programs — LoyaltyCard[] avec details du programme

1
// POST /api/pro/programs
2
const response = await fetch('/api/pro/programs', {
3
  method: 'POST',
4
  headers: { 'Content-Type': 'application/json' },
5
  body: JSON.stringify({
6
    name: 'Club Premium',
7
    type: 'points',           // "points" | "cashback" | "hybrid"
8
    pointsPerEuro: 10,        // 10 points par euro depense
9
    tiers: [
10
      { name: 'Bronze', minPoints: 0, multiplier: 1 },
11
      { name: 'Silver', minPoints: 500, multiplier: 1.5 },
12
      { name: 'Gold', minPoints: 2000, multiplier: 2 },
13
    ],
14
    cardTemplate: {
15
      backgroundColor: '#1a1a2e',
16
      logoUrl: '/brands/my-store-logo.png',
17
      accentColor: '#e94560',
18
    },
19
  }),
20
});

1
sequenceDiagram
2
    participant App
3
    participant API
4
    App->>API: GET /loyalty/catalog
5
    API-->>App: { programs: [...] }
6
    App->>API: POST /loyalty/enroll/{id}
7
    API-->>App: { success: true, card: {...} }
8
    App->>API: GET /loyalty/status
9
    API-->>App: { tier, points, ... }