Étapes de Conception

Stratégie Git

Patterns de Conception Utilisés

Prérequis

Compilation

Pour générer un exécutable autonome (self-contained), utilisez la commande correspondant à votre plateforme :

dotnet publish EasySave/EasySave.csproj -c Release -r win-x64 --self-contained true -o ./publish/windows

dotnet publish EasySave/EasySave.csproj -c Release -r osx-arm64 --self-contained true -o ./publish/macos

dotnet publish EasySave/EasySave.csproj -c Release -r osx-x64 --self-contained true -o ./publish/macos_intel

dotnet publish EasySave/EasySave.csproj -c Release -r linux-x64 --self-contained true -o ./publish/linux

Lancement rapide (développement)

dotnet run --project EasySave

Menu Principal

Au lancement sans arguments, EasySave affiche un menu interactif avec 7 options :

========================================
         EasySave v1.0
========================================

[1] Lister les travaux
[2] Créer un travail
[3] Modifier un travail
[4] Supprimer un travail
[5] Exécuter un travail
[6] Changer la langue
[7] Quitter

Votre choix :

Les 7 Options du Menu

[1] Lister les Travaux

Affiche la liste de tous les travaux de sauvegarde configurés :

┌────┬─────────────────────┬───────────────────────┬───────────────────────┬──────────────┐
│ ID │ Nom                 │ Source                │ Destination           │ Type         │
├────┼─────────────────────┼───────────────────────┼───────────────────────┼──────────────┤
│  1 │ Sauvegarde Docs     │ C:\Users\Documents    │ D:\Backup\Docs        │ Complète     │
│  2 │ Sauvegarde Photos   │ C:\Users\Pictures     │ D:\Backup\Photos      │ Différentiel │
└────┴─────────────────────┴───────────────────────┴───────────────────────┴──────────────┘

[2] Créer un Travail

[3] Modifier un Travail

[4] Supprimer un Travail

[5] Exécuter un Travail

Cette option permet de lancer des sauvegardes avec plusieurs formats de sélection :

[6] Changer la Langue

[7] Quitter

Notes Importantes

Syntaxe

EasySave.exe <sélecteur_travaux>

Formats de sélection

Exemples d'utilisation

./EasySave.exe 2

./EasySave.exe 1-3

./EasySave.exe 1;3;5

Cas d'Utilisation

Diagramme de Classes

Diagramme d'Activité

Diagrammes de Séquence

Créer un travail

Modifier un travail

Supprimer un travail

Exécuter un travail

Lister les travaux

Changer la langue

Qu'est-ce que le Pattern MVC ?

Pourquoi ce choix architectural ?

Flux de Données dans EasySave

Voici comment les données circulent entre les différentes couches lors d'une action utilisateur :

Diagramme MVC Simplifié

EasySave implémente une variante du MVC adaptée aux applications console avec une couche Services supplémentaire :

Structure des fichiers

Rôle des Modèles dans l'Architecture

BackupJob

Représente un travail de sauvegarde configuré par l'utilisateur. Cette classe est persistée dans jobs.json et chargée au démarrage de l'application.

JobState

Représente l'état temps réel d'une sauvegarde en cours d'exécution. Cette classe est mise à jour à chaque fichier copié et persistée dans state.json pour permettre un suivi externe (ex: application de monitoring).

BackupType (Enum)

Définit le type de sauvegarde à effectuer. Le choix du type impacte directement le comportement de BackupExecutor lors de la copie des fichiers.

Emplacement des fichiers

Tous les fichiers de configuration sont stockés dans un dossier Data/ situé à côté de l'exécutable :

EasySave.exe
Data/
├── jobs.json        # Liste des travaux de sauvegarde
├── settings.json    # Paramètres de l'application
├── state.json       # État temps réel des sauvegardes
└── Logs/
    └── 2026-02-03.json   # Logs journaliers (un fichier par jour)

Fichier jobs.json

Contient la liste des travaux de sauvegarde configurés. Ce fichier est créé automatiquement au premier lancement.

[
  {
    "id": 1,
    "name": "Sauvegarde Documents",
    "sourceDirectory": "C:\\Users\\Documents",
    "targetDirectory": "D:\\Backup\\Documents",
    "type": 0
  },
  {
    "id": 2,
    "name": "Sauvegarde Photos",
    "sourceDirectory": "C:\\Users\\Pictures",
    "targetDirectory": "D:\\Backup\\Pictures",
    "type": 1
  }
]

Fichier settings.json

Contient les paramètres globaux de l'application, notamment la langue sélectionnée.

{
  "language": "fr-FR"
}

Structure du Projet

EasySave/
├── EasySave/           # Application principale
│   └── EasySave.csproj # Référence EasyLog
│
├── EasyLog/            # Projet DLL
│   ├── EasyLog.csproj  # Compile en DLL
│   └── Logger.cs       # Classe principale
│
└── EasySave.sln        # Solution regroupant les 2 projets

API de la Classe Logger

Structure d'une Entrée de Log

Conversion UNC

Tous les chemins sont automatiquement convertis au format UNC (Universal Naming Convention) pour compatibilité avec les serveurs et lecteurs réseaux :

Chemin local    : C:\Users\Documents\file.txt
Chemin UNC      : \\?\C:\Users\Documents\file.txt

Chemin réseau   : \\server\share\file.txt
Chemin UNC      : \\server\share\file.txt (inchangé)

Fichier Log Journalier

Les logs sont enregistrés dans des fichiers journaliers au format YYYY-MM-DD.json :

[
  {
    "Name": "Sauvegarde Documents",
    "Timestamp": "2026-02-05T14:30:45",
    "SourcePath": "\\\\?\\C:\\Users\\Documents\\rapport.docx",
    "DestinationPath": "\\\\?\\D:\\Backup\\Documents\\rapport.docx",
    "FileSize": 245760,
    "TransferTimeMs": 45
  },
  {
    "Name": "Sauvegarde Documents",
    "Timestamp": "2026-02-05T14:30:46",
    "SourcePath": "\\\\?\\C:\\Users\\Documents\\image.png",
    "DestinationPath": "\\\\?\\D:\\Backup\\Documents\\image.png",
    "FileSize": 1048576,
    "TransferTimeMs": 120
  },
  {
    "Name": "[CREATED] Sauvegarde Photos",
    "Timestamp": "2026-02-05T15:00:00",
    "SourcePath": "",
    "DestinationPath": "",
    "FileSize": 0,
    "TransferTimeMs": 0
  }
]

Fichiers de log journaliers

Chaque transfert de fichier est enregistré dans un fichier JSON par jour (YYYY-MM-DD.json), dans le dossier Data/Logs/.

{
  "timestamp": "2026-02-03T15:30:45",
  "jobName": "Sauvegarde Documents",
  "sourceFile": "C:\\Users\\Documents\\rapport.docx",
  "targetFile": "D:\\Backup\\Documents\\rapport.docx",
  "fileSize": 245760,
  "transferTimeMs": 45
}

Fichier d'État (state.json)

L'état temps réel des sauvegardes est maintenu dans un fichier JSON actualisé en continu.

{
  "jobName": "Sauvegarde Documents",
  "timestamp": "2026-02-03T15:30:50",
  "state": "Active",
  "totalFiles": 150,
  "totalSize": 52428800,
  "filesRemaining": 75,
  "sizeRemaining": 26214400,
  "currentSourceFile": "C:\\Users\\Documents\\images\\photo.jpg",
  "currentTargetFile": "D:\\Backup\\Documents\\images\\photo.jpg",
  "progression": 50.0
}

États possibles

Bibliothèque EasyLog

Le module EasyLog est une DLL séparée qui gère l'écriture des logs. Elle offre les fonctionnalités suivantes :

Langues supportées

EasySave supporte actuellement deux langues :

Changement de langue

La langue peut être modifiée via l'option 6 du menu principal. Le changement est immédiat et la préférence est sauvegardée dans settings.json.

Fichiers de traduction

Les traductions sont stockées dans des fichiers JSON situés dans le dossier Resources/ :

{
  "MenuOption1": "1. Lister les travaux",
  "MenuOption2": "2. Créer un travail",
  "MenuOption3": "3. Modifier un travail",
  "JobCreated": "Travail créé avec succès !",
  "JobDeleted": "Travail supprimé avec succès !",
  "MaxJobsReached": "Erreur : Limite de 5 travaux atteinte."
}

Architecture du LanguageManager

Le gestionnaire de langues utilise le pattern Singleton pour garantir une instance unique dans toute l'application.

Exigences Fonctionnelles

Exigences Techniques - Stockage

Exigences Techniques - Logging & État