🏷️ LoyaltyProgram - API REST .NET Core + PostgreSQL

API de gestion d'un programme de fidélité client. Stack moderne : .NET 8, Docker, PostgreSQL.

Screenshots

📦 Fonctionnalités

• ✅ Gestion des clients et des boutiques
• ✅ Programme de fidélité (points, carte, transactions)
• ✅ Notifications ou alertes lors du franchissement de seuils de points
• ✅ Validité limitée dans le temps des récompenses
• ✅ Système de statuts (VIP, Silver, Gold...)
• ✅ Documentation Swagger intégrée
• ✅ Sécurisation par Authentification (JWT)
• ✅ Historique des transactions et points
• ✅ Gestion des récompenses (modèle + endpoints)

🚀 Prérequis

• .NET 8 SDK
• Docker

⚙️ Installation

Clone du projet :

git clone git@github.com:delitamakanda/LoyaltyProgram.git
cd LoyaltyProgram.Api

🐳 Lancer avec Docker Compose

docker-compose up --build

API accessible sur : http://localhost:5237/swagger/index.html

Base de données PostgreSQL dispo sur localhost:5432

🛠️ Migrations EF Core

Ajouter une migration :

dotnet ef migrations add NomMigration --project LoyaltyProgram.Api

Appliquer la migration :

dotnet ef database update --project LoyaltyProgram.Api

📁 Structure du Projet

src/
├─ LoyaltyProgram.Api/           --> Projet API principal
│    └─ appsettings.json         --> Configurations (connexions, logs)
├─ LoyaltyProgram.Domain/        --> Entitées
├─ LoyaltyProgram.Application/   --> Logique Métier
├─ LoyaltyProgram.Infrastructure/--> Gestion des migrations
tests/
└─ LoyaltyProgram.Tests/         --> Tests unitaires et d'intégration

🧪 Tests

dotnet test

📝 TODO Évolutions

• Support multilingue
• Optimisation multi-devices
• Export des données (transactions, points, récompenses) pour reporting ou analyses
• Développement d'un Dashboard