BankingKata-MVC

API Bancaire en .NET 8 utilisant le pattern MVC (Model-View-Controller) avec AutoMapper et Injection de Dépendances.

Architecture

BankingKata-MVC/
├── Models/                    # Modèles de domaine
│   ├── AccountModels.cs       # BankAccount, SavingsAccount, Transaction
│   ├── Repositories.cs         # Implémentations des repositories
│   └── Interfaces/            # Interfaces des repositories
│       ├── IBankAccountRepository.cs
│       ├── ISavingsAccountRepository.cs
│       └── ITransactionRepository.cs
├── ViewModels/               # Modèles pour les réponses API
│   └── AccountViewModels.cs
├── Controllers/              # Contrôleurs API
│   ├── AccountsController.cs
│   └── SavingsController.cs
├── Mapping/                  # Profils AutoMapper
│   └── AccountMappingProfile.cs
├── Tests/                    # Tests unitaires
│   └── BankingKata-MVC.Tests/
└── Program.cs                # Configuration DI + point d'entrée

Pattern MVC

• Model : Models/AccountModels.cs - Logique métier (BankAccount, SavingsAccount, Transaction)
• View : ViewModels + réponses JSON de l'API
• Controller : Controllers/AccountsController.cs, SavingsController.cs - Gèrent les requêtes HTTP

Injection de Dépendances (Program.cs)

builder.Services.AddAutoMapper(cfg => cfg.AddProfile<AccountMappingProfile>(), typeof(AccountMappingProfile).Assembly);

builder.Services.AddScoped<IBankAccountRepository, BankAccountRepository>();
builder.Services.AddScoped<ISavingsAccountRepository, SavingsAccountRepository>();
builder.Services.AddScoped<ITransactionRepository, TransactionRepository>();

Schéma de l'Architecture

graph TD
    subgraph Client
        HTTP[HTTP Requests]
    end

    subgraph Controllers
        AC[AccountsController<br/>api/accounts]
        SC[SavingsController<br/>api/savings]
    end

    subgraph Mapping
        MP[AccountMappingProfile]
    end

    subgraph ViewModels
        AV[AccountViewModel]
        SV[SavingsAccountViewModel]
        OV[OperationViewModel]
        StV[StatementViewModel]
    end

    subgraph Models
        BA[BankAccount]
        SA[SavingsAccount]
        T[Transaction]
    end

    subgraph Repositories
        BR[BankAccountRepository]
        SR[SavingsAccountRepository]
        TR[TransactionRepository]
    end

    subgraph Interfaces
        IBR[IBankAccountRepository]
        ISR[ISavingsAccountRepository]
        ITR[ITransactionRepository]
    end

    HTTP --> AC
    HTTP --> SC

    AC --> MP
    SC --> MP

    MP --> AV
    MP --> SV
    MP --> OV

    AC --> BA
    SC --> SA
    AC --> T

    AC --> IBR
    SC --> ISR
    AC --> ITR

    IBR --> BR
    ISR --> SR
    ITR --> TR

    BR -.->|implémente| IBR
    SR -.->|implémente| ISR
    TR -.->|implémente| ITR

    style HTTP fill:#e8f4f8,stroke:#333,color:#000000
    style AC fill:#d4e8f4,stroke:#333,color:#000000
    style SC fill:#d4e8f4,stroke:#333,color:#000000
    style MP fill:#f4e4d4,stroke:#333,color:#000000
    style AV fill:#e4d4f4,stroke:#333,color:#000000
    style SV fill:#e4d4f4,stroke:#333,color:#000000
    style OV fill:#e4d4f4,stroke:#333,color:#000000
    style StV fill:#e4d4f4,stroke:#333,color:#000000
    style BA fill:#e8f4d4,stroke:#333,color:#000000
    style SA fill:#e8f4d4,stroke:#333,color:#000000
    style T fill:#e8f4d4,stroke:#333,color:#000000
    style IBR fill:#d4f4e8,stroke:#333,color:#000000
    style ISR fill:#d4f4e8,stroke:#333,color:#000000
    style ITR fill:#d4f4e8,stroke:#333,color:#000000

Loading

Flux de Données

sequenceDiagram
    participant Client
    participant Controller
    participant Mapper as AutoMapper
    participant ViewModel
    participant Model
    participant Repository

    Client->>Controller: HTTP Request
    Controller->>Model: Opération métier
    Model->>Repository: Sauvegarde données
    Repository-->>Model: Données sauvegardées
    Model-->>Controller: Résultat
    Controller->>Mapper: Map Model → ViewModel
    Mapper-->>Controller: ViewModel
    Controller-->>Client: JSON Response

Loading

Endpoints

Comptes Courants

Méthode	Endpoint	Description
GET	/api/accounts	Liste tous les comptes
GET	/api/accounts/{accountNumber}	Détails d'un compte
POST	/api/accounts	Créer un compte
POST	/api/accounts/{accountNumber}/deposit	Déposer de l'argent
POST	/api/accounts/{accountNumber}/withdraw	Retirer de l'argent
POST	/api/accounts/{accountNumber}/overdraft	Modifier le découvert
GET	/api/accounts/{accountNumber}/statement	Relevé de compte

Livrets Épargne

Méthode	Endpoint	Description
GET	/api/savings	Liste tous les livrets
GET	/api/savings/{accountNumber}	Détails d'un livret
POST	/api/savings	Créer un livret
POST	/api/savings/{accountNumber}/deposit	Déposer (plafond appliqué)
POST	/api/savings/{accountNumber}/withdraw	Retirer (fonds insuffisants si dépasse le solde)

Exemples de Requêtes

# Créer un compte
curl -X POST http://localhost:5000/api/accounts \
  -H "Content-Type: application/json" \
  -d '{"accountNumber": "ACC001", "initialBalance": 1000, "overdraftLimit": 500}'

# Déposer de l'argent
curl -X POST http://localhost:5000/api/accounts/ACC001/deposit \
  -H "Content-Type: application/json" \
  -d '{"amount": 500}'

# Obtenir le relevé
curl http://localhost:5000/api/accounts/ACC001/statement

Lancer le Projet

cd BankingKata-MVC
dotnet run

L'API sera disponible sur http://localhost:5000 Swagger disponible sur http://localhost:5000/swagger

Tests

cd BankingKata-MVC.Tests
dotnet test

Les tests couvrent :

• Logique métier des comptes (dépôt, retrait, découvert)
• Logique métier des livrets épargne (plafond de dépôt)
• Endpoints API (comptes et livrets)
• Mappage AutoMapper