lionsdev/unionflow-mobile-apps
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Clean project: remove test files, debug logs, and add documentation

Browse Source
This commit is contained in:
dahoud
2025-10-05 13:41:33 +00:00
parent 96a17eadbd
commit 291847924c
438 changed files with 65754 additions and 32713 deletions
Download Patch File Download Diff File Expand all files Collapse all files

466
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/analytics/AnalyticsDataDTO.java
View File

@@ -2,31 +2,30 @@ package dev.lions.unionflow.server.api.dto.analytics;
import com.fasterxml.jackson.annotation.JsonFormat;
import dev.lions.unionflow.server.api.dto.base.BaseDTO;
import dev.lions.unionflow.server.api.enums.analytics.TypeMetrique;
import dev.lions.unionflow.server.api.enums.analytics.PeriodeAnalyse;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.DecimalMin;
import dev.lions.unionflow.server.api.enums.analytics.TypeMetrique;
import jakarta.validation.constraints.DecimalMax;
import jakarta.validation.constraints.DecimalMin;
import jakarta.validation.constraints.Digits;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Size;
import lombok.Getter;
import lombok.Setter;
import lombok.Builder;
import lombok.NoArgsConstructor;
import lombok.AllArgsConstructor;
import java.math.BigDecimal;
import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;
import java.util.UUID;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
/**
* DTO pour les données analytics UnionFlow
*
* Représente une donnée analytique avec sa valeur, sa métrique associée,
* sa période d'analyse et ses métadonnées.
*
*
* <p>Représente une donnée analytique avec sa valeur, sa métrique associée, sa période d'analyse et
* ses métadonnées.
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
@@ -37,225 +36,224 @@ import java.util.UUID;
@NoArgsConstructor
@AllArgsConstructor
public class AnalyticsDataDTO extends BaseDTO {
private static final long serialVersionUID = 1L;
/** Type de métrique analysée */
@NotNull(message = "Le type de métrique est obligatoire")
private TypeMetrique typeMetrique;
/** Période d'analyse */
@NotNull(message = "La période d'analyse est obligatoire")
private PeriodeAnalyse periodeAnalyse;
/** Valeur numérique de la métrique */
@NotNull(message = "La valeur est obligatoire")
@DecimalMin(value = "0.0", message = "La valeur doit être positive ou nulle")
@Digits(integer = 15, fraction = 4, message = "Format de valeur invalide")
private BigDecimal valeur;
/** Valeur précédente pour comparaison */
@DecimalMin(value = "0.0", message = "La valeur précédente doit être positive ou nulle")
@Digits(integer = 15, fraction = 4, message = "Format de valeur précédente invalide")
private BigDecimal valeurPrecedente;
/** Pourcentage d'évolution par rapport à la période précédente */
@Digits(integer = 6, fraction = 2, message = "Format de pourcentage d'évolution invalide")
private BigDecimal pourcentageEvolution;
/** Date de début de la période analysée */
@NotNull(message = "La date de début est obligatoire")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateDebut;
/** Date de fin de la période analysée */
@NotNull(message = "La date de fin est obligatoire")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateFin;
/** Date de calcul de la métrique */
@NotNull(message = "La date de calcul est obligatoire")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateCalcul;
/** Identifiant de l'organisation (optionnel pour filtrage) */
private UUID organisationId;
/** Nom de l'organisation */
@Size(max = 200, message = "Le nom de l'organisation ne peut pas dépasser 200 caractères")
private String nomOrganisation;
/** Identifiant de l'utilisateur qui a demandé le calcul */
private UUID utilisateurId;
/** Nom de l'utilisateur qui a demandé le calcul */
@Size(max = 200, message = "Le nom de l'utilisateur ne peut pas dépasser 200 caractères")
private String nomUtilisateur;
/** Libellé personnalisé de la métrique */
@Size(max = 300, message = "Le libellé personnalisé ne peut pas dépasser 300 caractères")
private String libellePersonnalise;
/** Description ou commentaire sur la métrique */
@Size(max = 1000, message = "La description ne peut pas dépasser 1000 caractères")
private String description;
/** Données détaillées pour les graphiques (format JSON) */
@Size(max = 10000, message = "Les données détaillées ne peuvent pas dépasser 10000 caractères")
private String donneesDetaillees;
/** Configuration du graphique (couleurs, type, etc.) */
@Size(max = 2000, message = "La configuration graphique ne peut pas dépasser 2000 caractères")
private String configurationGraphique;
/** Métadonnées additionnelles */
private Map<String, Object> metadonnees;
/** Indicateur de fiabilité des données (0-100) */
@DecimalMin(value = "0.0", message = "L'indicateur de fiabilité doit être positif")
@DecimalMax(value = "100.0", message = "L'indicateur de fiabilité ne peut pas dépasser 100")
@Digits(integer = 3, fraction = 1, message = "Format d'indicateur de fiabilité invalide")
private BigDecimal indicateurFiabilite;
/** Nombre d'éléments analysés pour calculer cette métrique */
@DecimalMin(value = "0", message = "Le nombre d'éléments doit être positif")
private Integer nombreElementsAnalyses;
/** Temps de calcul en millisecondes */
@DecimalMin(value = "0", message = "Le temps de calcul doit être positif")
private Long tempsCalculMs;
/** Indicateur si la métrique est en temps réel */
@Builder.Default
private Boolean tempsReel = false;
/** Indicateur si la métrique nécessite une mise à jour */
@Builder.Default
private Boolean necessiteMiseAJour = false;
/** Niveau de priorité de la métrique (1=faible, 5=critique) */
@DecimalMin(value = "1", message = "Le niveau de priorité minimum est 1")
@DecimalMax(value = "5", message = "Le niveau de priorité maximum est 5")
private Integer niveauPriorite;
/** Tags pour catégoriser la métrique */
private List<String> tags;
// === MÉTHODES UTILITAIRES ===
/**
* Retourne le libellé à afficher (personnalisé ou par défaut)
*
* @return Le libellé à afficher
*/
public String getLibelleAffichage() {
return libellePersonnalise != null && !libellePersonnalise.trim().isEmpty()
? libellePersonnalise
: typeMetrique.getLibelle();
}
/**
* Retourne l'unité de mesure de la métrique
*
* @return L'unité de mesure
*/
public String getUnite() {
return typeMetrique.getUnite();
}
/**
* Retourne l'icône de la métrique
*
* @return L'icône Material Design
*/
public String getIcone() {
return typeMetrique.getIcone();
}
/**
* Retourne la couleur de la métrique
*
* @return Le code couleur hexadécimal
*/
public String getCouleur() {
return typeMetrique.getCouleur();
}
/**
* Vérifie si la métrique a évolué positivement
*
* @return true si l'évolution est positive
*/
public boolean hasEvolutionPositive() {
return pourcentageEvolution != null && pourcentageEvolution.compareTo(BigDecimal.ZERO) > 0;
}
/**
* Vérifie si la métrique a évolué négativement
*
* @return true si l'évolution est négative
*/
public boolean hasEvolutionNegative() {
return pourcentageEvolution != null && pourcentageEvolution.compareTo(BigDecimal.ZERO) < 0;
}
/**
* Vérifie si la métrique est stable (pas d'évolution)
*
* @return true si l'évolution est nulle
*/
public boolean isStable() {
return pourcentageEvolution != null && pourcentageEvolution.compareTo(BigDecimal.ZERO) == 0;
}
/**
* Retourne la tendance sous forme de texte
*
* @return "hausse", "baisse" ou "stable"
*/
public String getTendance() {
if (hasEvolutionPositive()) return "hausse";
if (hasEvolutionNegative()) return "baisse";
return "stable";
}
/**
* Vérifie si les données sont fiables (indicateur > 80)
*
* @return true si les données sont considérées comme fiables
*/
public boolean isDonneesFiables() {
return indicateurFiabilite != null &&
indicateurFiabilite.compareTo(new BigDecimal("80.0")) >= 0;
}
/**
* Vérifie si la métrique est critique (priorité >= 4)
*
* @return true si la métrique est critique
*/
public boolean isCritique() {
return niveauPriorite != null && niveauPriorite >= 4;
}
/**
* Constructeur avec les champs essentiels
*
* @param typeMetrique Le type de métrique
* @param periodeAnalyse La période d'analyse
* @param valeur La valeur de la métrique
*/
public AnalyticsDataDTO(TypeMetrique typeMetrique, PeriodeAnalyse periodeAnalyse, BigDecimal valeur) {
super();
this.typeMetrique = typeMetrique;
this.periodeAnalyse = periodeAnalyse;
this.valeur = valeur;
this.dateCalcul = LocalDateTime.now();
this.dateDebut = periodeAnalyse.getDateDebut();
this.dateFin = periodeAnalyse.getDateFin();
this.tempsReel = false;
this.necessiteMiseAJour = false;
this.niveauPriorite = 3; // Priorité normale par défaut
this.indicateurFiabilite = new BigDecimal("95.0"); // Fiabilité élevée par défaut
}
private static final long serialVersionUID = 1L;
/** Type de métrique analysée */
@NotNull(message = "Le type de métrique est obligatoire")
private TypeMetrique typeMetrique;
/** Période d'analyse */
@NotNull(message = "La période d'analyse est obligatoire")
private PeriodeAnalyse periodeAnalyse;
/** Valeur numérique de la métrique */
@NotNull(message = "La valeur est obligatoire")
@DecimalMin(value = "0.0", message = "La valeur doit être positive ou nulle")
@Digits(integer = 15, fraction = 4, message = "Format de valeur invalide")
private BigDecimal valeur;
/** Valeur précédente pour comparaison */
@DecimalMin(value = "0.0", message = "La valeur précédente doit être positive ou nulle")
@Digits(integer = 15, fraction = 4, message = "Format de valeur précédente invalide")
private BigDecimal valeurPrecedente;
/** Pourcentage d'évolution par rapport à la période précédente */
@Digits(integer = 6, fraction = 2, message = "Format de pourcentage d'évolution invalide")
private BigDecimal pourcentageEvolution;
/** Date de début de la période analysée */
@NotNull(message = "La date de début est obligatoire")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateDebut;
/** Date de fin de la période analysée */
@NotNull(message = "La date de fin est obligatoire")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateFin;
/** Date de calcul de la métrique */
@NotNull(message = "La date de calcul est obligatoire")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateCalcul;
/** Identifiant de l'organisation (optionnel pour filtrage) */
private UUID organisationId;
/** Nom de l'organisation */
@Size(max = 200, message = "Le nom de l'organisation ne peut pas dépasser 200 caractères")
private String nomOrganisation;
/** Identifiant de l'utilisateur qui a demandé le calcul */
private UUID utilisateurId;
/** Nom de l'utilisateur qui a demandé le calcul */
@Size(max = 200, message = "Le nom de l'utilisateur ne peut pas dépasser 200 caractères")
private String nomUtilisateur;
/** Libellé personnalisé de la métrique */
@Size(max = 300, message = "Le libellé personnalisé ne peut pas dépasser 300 caractères")
private String libellePersonnalise;
/** Description ou commentaire sur la métrique */
@Size(max = 1000, message = "La description ne peut pas dépasser 1000 caractères")
private String description;
/** Données détaillées pour les graphiques (format JSON) */
@Size(max = 10000, message = "Les données détaillées ne peuvent pas dépasser 10000 caractères")
private String donneesDetaillees;
/** Configuration du graphique (couleurs, type, etc.) */
@Size(max = 2000, message = "La configuration graphique ne peut pas dépasser 2000 caractères")
private String configurationGraphique;
/** Métadonnées additionnelles */
private Map<String, Object> metadonnees;
/** Indicateur de fiabilité des données (0-100) */
@DecimalMin(value = "0.0", message = "L'indicateur de fiabilité doit être positif")
@DecimalMax(value = "100.0", message = "L'indicateur de fiabilité ne peut pas dépasser 100")
@Digits(integer = 3, fraction = 1, message = "Format d'indicateur de fiabilité invalide")
private BigDecimal indicateurFiabilite;
/** Nombre d'éléments analysés pour calculer cette métrique */
@DecimalMin(value = "0", message = "Le nombre d'éléments doit être positif")
private Integer nombreElementsAnalyses;
/** Temps de calcul en millisecondes */
@DecimalMin(value = "0", message = "Le temps de calcul doit être positif")
private Long tempsCalculMs;
/** Indicateur si la métrique est en temps réel */
@Builder.Default private Boolean tempsReel = false;
/** Indicateur si la métrique nécessite une mise à jour */
@Builder.Default private Boolean necessiteMiseAJour = false;
/** Niveau de priorité de la métrique (1=faible, 5=critique) */
@DecimalMin(value = "1", message = "Le niveau de priorité minimum est 1")
@DecimalMax(value = "5", message = "Le niveau de priorité maximum est 5")
private Integer niveauPriorite;
/** Tags pour catégoriser la métrique */
private List<String> tags;
// === MÉTHODES UTILITAIRES ===
/**
* Retourne le libellé à afficher (personnalisé ou par défaut)
*
* @return Le libellé à afficher
*/
public String getLibelleAffichage() {
return libellePersonnalise != null && !libellePersonnalise.trim().isEmpty()
? libellePersonnalise
: typeMetrique.getLibelle();
}
/**
* Retourne l'unité de mesure de la métrique
*
* @return L'unité de mesure
*/
public String getUnite() {
return typeMetrique.getUnite();
}
/**
* Retourne l'icône de la métrique
*
* @return L'icône Material Design
*/
public String getIcone() {
return typeMetrique.getIcone();
}
/**
* Retourne la couleur de la métrique
*
* @return Le code couleur hexadécimal
*/
public String getCouleur() {
return typeMetrique.getCouleur();
}
/**
* Vérifie si la métrique a évolué positivement
*
* @return true si l'évolution est positive
*/
public boolean hasEvolutionPositive() {
return pourcentageEvolution != null && pourcentageEvolution.compareTo(BigDecimal.ZERO) > 0;
}
/**
* Vérifie si la métrique a évolué négativement
*
* @return true si l'évolution est négative
*/
public boolean hasEvolutionNegative() {
return pourcentageEvolution != null && pourcentageEvolution.compareTo(BigDecimal.ZERO) < 0;
}
/**
* Vérifie si la métrique est stable (pas d'évolution)
*
* @return true si l'évolution est nulle
*/
public boolean isStable() {
return pourcentageEvolution != null && pourcentageEvolution.compareTo(BigDecimal.ZERO) == 0;
}
/**
* Retourne la tendance sous forme de texte
*
* @return "hausse", "baisse" ou "stable"
*/
public String getTendance() {
if (hasEvolutionPositive()) return "hausse";
if (hasEvolutionNegative()) return "baisse";
return "stable";
}
/**
* Vérifie si les données sont fiables (indicateur > 80)
*
* @return true si les données sont considérées comme fiables
*/
public boolean isDonneesFiables() {
return indicateurFiabilite != null
&& indicateurFiabilite.compareTo(new BigDecimal("80.0")) >= 0;
}
/**
* Vérifie si la métrique est critique (priorité >= 4)
*
* @return true si la métrique est critique
*/
public boolean isCritique() {
return niveauPriorite != null && niveauPriorite >= 4;
}
/**
* Constructeur avec les champs essentiels
*
* @param typeMetrique Le type de métrique
* @param periodeAnalyse La période d'analyse
* @param valeur La valeur de la métrique
*/
public AnalyticsDataDTO(
TypeMetrique typeMetrique, PeriodeAnalyse periodeAnalyse, BigDecimal valeur) {
super();
this.typeMetrique = typeMetrique;
this.periodeAnalyse = periodeAnalyse;
this.valeur = valeur;
this.dateCalcul = LocalDateTime.now();
this.dateDebut = periodeAnalyse.getDateDebut();
this.dateFin = periodeAnalyse.getDateFin();
this.tempsReel = false;
this.necessiteMiseAJour = false;
this.niveauPriorite = 3; // Priorité normale par défaut
this.indicateurFiabilite = new BigDecimal("95.0"); // Fiabilité élevée par défaut
}
}

629
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/analytics/DashboardWidgetDTO.java
View File

@@ -2,29 +2,28 @@ package dev.lions.unionflow.server.api.dto.analytics;
import com.fasterxml.jackson.annotation.JsonFormat;
import dev.lions.unionflow.server.api.dto.base.BaseDTO;
import dev.lions.unionflow.server.api.enums.analytics.TypeMetrique;
import dev.lions.unionflow.server.api.enums.analytics.PeriodeAnalyse;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.DecimalMin;
import dev.lions.unionflow.server.api.enums.analytics.TypeMetrique;
import jakarta.validation.constraints.DecimalMax;
import jakarta.validation.constraints.DecimalMin;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Size;
import lombok.Getter;
import lombok.Setter;
import lombok.Builder;
import lombok.NoArgsConstructor;
import lombok.AllArgsConstructor;
import java.time.LocalDateTime;
import java.util.Map;
import java.util.UUID;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
/**
* DTO pour les widgets de tableau de bord analytics UnionFlow
*
* Représente un widget personnalisable affiché sur le tableau de bord
* avec sa configuration, sa position et ses données.
*
*
* <p>Représente un widget personnalisable affiché sur le tableau de bord avec sa configuration, sa
* position et ses données.
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
@@ -35,309 +34,305 @@ import java.util.UUID;
@NoArgsConstructor
@AllArgsConstructor
public class DashboardWidgetDTO extends BaseDTO {
private static final long serialVersionUID = 1L;
/** Titre du widget */
@NotBlank(message = "Le titre du widget est obligatoire")
@Size(min = 3, max = 200, message = "Le titre du widget doit contenir entre 3 et 200 caractères")
private String titre;
/** Description du widget */
@Size(max = 500, message = "La description ne peut pas dépasser 500 caractères")
private String description;
/** Type de widget (kpi, chart, table, gauge, progress, text) */
@NotBlank(message = "Le type de widget est obligatoire")
@Size(max = 50, message = "Le type de widget ne peut pas dépasser 50 caractères")
private String typeWidget;
/** Type de métrique affiché */
private TypeMetrique typeMetrique;
/** Période d'analyse */
private PeriodeAnalyse periodeAnalyse;
/** Identifiant de l'organisation (optionnel pour filtrage) */
private UUID organisationId;
/** Nom de l'organisation */
@Size(max = 200, message = "Le nom de l'organisation ne peut pas dépasser 200 caractères")
private String nomOrganisation;
/** Identifiant de l'utilisateur propriétaire */
@NotNull(message = "L'identifiant de l'utilisateur propriétaire est obligatoire")
private UUID utilisateurProprietaireId;
/** Nom de l'utilisateur propriétaire */
@Size(max = 200, message = "Le nom de l'utilisateur propriétaire ne peut pas dépasser 200 caractères")
private String nomUtilisateurProprietaire;
/** Position X du widget sur la grille */
@NotNull(message = "La position X est obligatoire")
@DecimalMin(value = "0", message = "La position X doit être positive ou nulle")
private Integer positionX;
/** Position Y du widget sur la grille */
@NotNull(message = "La position Y est obligatoire")
@DecimalMin(value = "0", message = "La position Y doit être positive ou nulle")
private Integer positionY;
/** Largeur du widget (en unités de grille) */
@NotNull(message = "La largeur est obligatoire")
@DecimalMin(value = "1", message = "La largeur minimum est 1")
@DecimalMax(value = "12", message = "La largeur maximum est 12")
private Integer largeur;
/** Hauteur du widget (en unités de grille) */
@NotNull(message = "La hauteur est obligatoire")
@DecimalMin(value = "1", message = "La hauteur minimum est 1")
@DecimalMax(value = "12", message = "La hauteur maximum est 12")
private Integer hauteur;
/** Ordre d'affichage (z-index) */
@DecimalMin(value = "0", message = "L'ordre d'affichage doit être positif ou nul")
@Builder.Default
private Integer ordreAffichage = 0;
/** Configuration visuelle du widget */
@Size(max = 5000, message = "La configuration visuelle ne peut pas dépasser 5000 caractères")
private String configurationVisuelle;
/** Couleur principale du widget */
@Size(max = 7, message = "La couleur doit être au format #RRGGBB")
private String couleurPrincipale;
/** Couleur secondaire du widget */
@Size(max = 7, message = "La couleur secondaire doit être au format #RRGGBB")
private String couleurSecondaire;
/** Icône du widget */
@Size(max = 50, message = "L'icône ne peut pas dépasser 50 caractères")
private String icone;
/** Indicateur si le widget est visible */
@Builder.Default
private Boolean visible = true;
/** Indicateur si le widget est redimensionnable */
@Builder.Default
private Boolean redimensionnable = true;
/** Indicateur si le widget est déplaçable */
@Builder.Default
private Boolean deplacable = true;
/** Indicateur si le widget peut être supprimé */
@Builder.Default
private Boolean supprimable = true;
/** Indicateur si le widget se met à jour automatiquement */
@Builder.Default
private Boolean miseAJourAutomatique = true;
/** Fréquence de mise à jour en secondes */
@DecimalMin(value = "30", message = "La fréquence minimum est 30 secondes")
@Builder.Default
private Integer frequenceMiseAJourSecondes = 300; // 5 minutes par défaut
/** Date de dernière mise à jour des données */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateDerniereMiseAJour;
/** Prochaine mise à jour programmée */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime prochaineMiseAJour;
/** Données du widget (format JSON) */
@Size(max = 50000, message = "Les données du widget ne peuvent pas dépasser 50000 caractères")
private String donneesWidget;
/** Configuration des filtres */
private Map<String, Object> configurationFiltres;
/** Configuration des alertes */
private Map<String, Object> configurationAlertes;
/** Seuil d'alerte bas */
private Double seuilAlerteBas;
/** Seuil d'alerte haut */
private Double seuilAlerteHaut;
/** Indicateur si une alerte est active */
@Builder.Default
private Boolean alerteActive = false;
/** Message d'alerte actuel */
@Size(max = 500, message = "Le message d'alerte ne peut pas dépasser 500 caractères")
private String messageAlerte;
/** Type d'alerte (info, warning, error, success) */
@Size(max = 20, message = "Le type d'alerte ne peut pas dépasser 20 caractères")
private String typeAlerte;
/** Permissions d'accès au widget */
@Size(max = 1000, message = "Les permissions ne peuvent pas dépasser 1000 caractères")
private String permissions;
/** Rôles autorisés à voir le widget */
@Size(max = 500, message = "Les rôles autorisés ne peuvent pas dépasser 500 caractères")
private String rolesAutorises;
/** Template personnalisé du widget */
@Size(max = 10000, message = "Le template personnalisé ne peut pas dépasser 10000 caractères")
private String templatePersonnalise;
/** CSS personnalisé du widget */
@Size(max = 5000, message = "Le CSS personnalisé ne peut pas dépasser 5000 caractères")
private String cssPersonnalise;
/** JavaScript personnalisé du widget */
@Size(max = 10000, message = "Le JavaScript personnalisé ne peut pas dépasser 10000 caractères")
private String javascriptPersonnalise;
/** Métadonnées additionnelles */
private Map<String, Object> metadonnees;
/** Nombre de vues du widget */
@DecimalMin(value = "0", message = "Le nombre de vues doit être positif")
@Builder.Default
private Long nombreVues = 0L;
/** Nombre d'interactions avec le widget */
@DecimalMin(value = "0", message = "Le nombre d'interactions doit être positif")
@Builder.Default
private Long nombreInteractions = 0L;
/** Temps moyen passé sur le widget (en secondes) */
@DecimalMin(value = "0", message = "Le temps moyen doit être positif")
private Integer tempsMoyenSecondes;
/** Taux d'erreur du widget (en pourcentage) */
@DecimalMin(value = "0.0", message = "Le taux d'erreur doit être positif")
@DecimalMax(value = "100.0", message = "Le taux d'erreur ne peut pas dépasser 100%")
@Builder.Default
private Double tauxErreur = 0.0;
/** Date de dernière erreur */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateDerniereErreur;
/** Message de dernière erreur */
@Size(max = 1000, message = "Le message d'erreur ne peut pas dépasser 1000 caractères")
private String messageDerniereErreur;
// === MÉTHODES UTILITAIRES ===
/**
* Retourne le libellé de la métrique si définie
*
* @return Le libellé de la métrique ou null
*/
public String getLibelleMetrique() {
return typeMetrique != null ? typeMetrique.getLibelle() : null;
private static final long serialVersionUID = 1L;
/** Titre du widget */
@NotBlank(message = "Le titre du widget est obligatoire")
@Size(min = 3, max = 200, message = "Le titre du widget doit contenir entre 3 et 200 caractères")
private String titre;
/** Description du widget */
@Size(max = 500, message = "La description ne peut pas dépasser 500 caractères")
private String description;
/** Type de widget (kpi, chart, table, gauge, progress, text) */
@NotBlank(message = "Le type de widget est obligatoire")
@Size(max = 50, message = "Le type de widget ne peut pas dépasser 50 caractères")
private String typeWidget;
/** Type de métrique affiché */
private TypeMetrique typeMetrique;
/** Période d'analyse */
private PeriodeAnalyse periodeAnalyse;
/** Identifiant de l'organisation (optionnel pour filtrage) */
private UUID organisationId;
/** Nom de l'organisation */
@Size(max = 200, message = "Le nom de l'organisation ne peut pas dépasser 200 caractères")
private String nomOrganisation;
/** Identifiant de l'utilisateur propriétaire */
@NotNull(message = "L'identifiant de l'utilisateur propriétaire est obligatoire")
private UUID utilisateurProprietaireId;
/** Nom de l'utilisateur propriétaire */
@Size(
max = 200,
message = "Le nom de l'utilisateur propriétaire ne peut pas dépasser 200 caractères")
private String nomUtilisateurProprietaire;
/** Position X du widget sur la grille */
@NotNull(message = "La position X est obligatoire")
@DecimalMin(value = "0", message = "La position X doit être positive ou nulle")
private Integer positionX;
/** Position Y du widget sur la grille */
@NotNull(message = "La position Y est obligatoire")
@DecimalMin(value = "0", message = "La position Y doit être positive ou nulle")
private Integer positionY;
/** Largeur du widget (en unités de grille) */
@NotNull(message = "La largeur est obligatoire")
@DecimalMin(value = "1", message = "La largeur minimum est 1")
@DecimalMax(value = "12", message = "La largeur maximum est 12")
private Integer largeur;
/** Hauteur du widget (en unités de grille) */
@NotNull(message = "La hauteur est obligatoire")
@DecimalMin(value = "1", message = "La hauteur minimum est 1")
@DecimalMax(value = "12", message = "La hauteur maximum est 12")
private Integer hauteur;
/** Ordre d'affichage (z-index) */
@DecimalMin(value = "0", message = "L'ordre d'affichage doit être positif ou nul")
@Builder.Default
private Integer ordreAffichage = 0;
/** Configuration visuelle du widget */
@Size(max = 5000, message = "La configuration visuelle ne peut pas dépasser 5000 caractères")
private String configurationVisuelle;
/** Couleur principale du widget */
@Size(max = 7, message = "La couleur doit être au format #RRGGBB")
private String couleurPrincipale;
/** Couleur secondaire du widget */
@Size(max = 7, message = "La couleur secondaire doit être au format #RRGGBB")
private String couleurSecondaire;
/** Icône du widget */
@Size(max = 50, message = "L'icône ne peut pas dépasser 50 caractères")
private String icone;
/** Indicateur si le widget est visible */
@Builder.Default private Boolean visible = true;
/** Indicateur si le widget est redimensionnable */
@Builder.Default private Boolean redimensionnable = true;
/** Indicateur si le widget est déplaçable */
@Builder.Default private Boolean deplacable = true;
/** Indicateur si le widget peut être supprimé */
@Builder.Default private Boolean supprimable = true;
/** Indicateur si le widget se met à jour automatiquement */
@Builder.Default private Boolean miseAJourAutomatique = true;
/** Fréquence de mise à jour en secondes */
@DecimalMin(value = "30", message = "La fréquence minimum est 30 secondes")
@Builder.Default
private Integer frequenceMiseAJourSecondes = 300; // 5 minutes par défaut
/** Date de dernière mise à jour des données */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateDerniereMiseAJour;
/** Prochaine mise à jour programmée */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime prochaineMiseAJour;
/** Données du widget (format JSON) */
@Size(max = 50000, message = "Les données du widget ne peuvent pas dépasser 50000 caractères")
private String donneesWidget;
/** Configuration des filtres */
private Map<String, Object> configurationFiltres;
/** Configuration des alertes */
private Map<String, Object> configurationAlertes;
/** Seuil d'alerte bas */
private Double seuilAlerteBas;
/** Seuil d'alerte haut */
private Double seuilAlerteHaut;
/** Indicateur si une alerte est active */
@Builder.Default private Boolean alerteActive = false;
/** Message d'alerte actuel */
@Size(max = 500, message = "Le message d'alerte ne peut pas dépasser 500 caractères")
private String messageAlerte;
/** Type d'alerte (info, warning, error, success) */
@Size(max = 20, message = "Le type d'alerte ne peut pas dépasser 20 caractères")
private String typeAlerte;
/** Permissions d'accès au widget */
@Size(max = 1000, message = "Les permissions ne peuvent pas dépasser 1000 caractères")
private String permissions;
/** Rôles autorisés à voir le widget */
@Size(max = 500, message = "Les rôles autorisés ne peuvent pas dépasser 500 caractères")
private String rolesAutorises;
/** Template personnalisé du widget */
@Size(max = 10000, message = "Le template personnalisé ne peut pas dépasser 10000 caractères")
private String templatePersonnalise;
/** CSS personnalisé du widget */
@Size(max = 5000, message = "Le CSS personnalisé ne peut pas dépasser 5000 caractères")
private String cssPersonnalise;
/** JavaScript personnalisé du widget */
@Size(max = 10000, message = "Le JavaScript personnalisé ne peut pas dépasser 10000 caractères")
private String javascriptPersonnalise;
/** Métadonnées additionnelles */
private Map<String, Object> metadonnees;
/** Nombre de vues du widget */
@DecimalMin(value = "0", message = "Le nombre de vues doit être positif")
@Builder.Default
private Long nombreVues = 0L;
/** Nombre d'interactions avec le widget */
@DecimalMin(value = "0", message = "Le nombre d'interactions doit être positif")
@Builder.Default
private Long nombreInteractions = 0L;
/** Temps moyen passé sur le widget (en secondes) */
@DecimalMin(value = "0", message = "Le temps moyen doit être positif")
private Integer tempsMoyenSecondes;
/** Taux d'erreur du widget (en pourcentage) */
@DecimalMin(value = "0.0", message = "Le taux d'erreur doit être positif")
@DecimalMax(value = "100.0", message = "Le taux d'erreur ne peut pas dépasser 100%")
@Builder.Default
private Double tauxErreur = 0.0;
/** Date de dernière erreur */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateDerniereErreur;
/** Message de dernière erreur */
@Size(max = 1000, message = "Le message d'erreur ne peut pas dépasser 1000 caractères")
private String messageDerniereErreur;
// === MÉTHODES UTILITAIRES ===
/**
* Retourne le libellé de la métrique si définie
*
* @return Le libellé de la métrique ou null
*/
public String getLibelleMetrique() {
return typeMetrique != null ? typeMetrique.getLibelle() : null;
}
/**
* Retourne l'unité de mesure si métrique définie
*
* @return L'unité de mesure ou chaîne vide
*/
public String getUnite() {
return typeMetrique != null ? typeMetrique.getUnite() : "";
}
/**
* Retourne l'icône de la métrique ou l'icône personnalisée
*
* @return L'icône à afficher
*/
public String getIconeAffichage() {
if (icone != null && !icone.trim().isEmpty()) {
return icone;
}
/**
* Retourne l'unité de mesure si métrique définie
*
* @return L'unité de mesure ou chaîne vide
*/
public String getUnite() {
return typeMetrique != null ? typeMetrique.getUnite() : "";
}
/**
* Retourne l'icône de la métrique ou l'icône personnalisée
*
* @return L'icône à afficher
*/
public String getIconeAffichage() {
if (icone != null && !icone.trim().isEmpty()) {
return icone;
}
return typeMetrique != null ? typeMetrique.getIcone() : "dashboard";
}
/**
* Retourne la couleur de la métrique ou la couleur personnalisée
*
* @return La couleur à utiliser
*/
public String getCouleurAffichage() {
if (couleurPrincipale != null && !couleurPrincipale.trim().isEmpty()) {
return couleurPrincipale;
}
return typeMetrique != null ? typeMetrique.getCouleur() : "#757575";
}
/**
* Vérifie si le widget nécessite une mise à jour
*
* @return true si une mise à jour est nécessaire
*/
public boolean necessiteMiseAJour() {
return miseAJourAutomatique && prochaineMiseAJour != null &&
prochaineMiseAJour.isBefore(LocalDateTime.now());
}
/**
* Vérifie si le widget est interactif
*
* @return true si le widget permet des interactions
*/
public boolean isInteractif() {
return "chart".equals(typeWidget) || "table".equals(typeWidget) ||
"gauge".equals(typeWidget);
}
/**
* Vérifie si le widget affiche des données temps réel
*
* @return true si le widget est en temps réel
*/
public boolean isTempsReel() {
return frequenceMiseAJourSecondes != null && frequenceMiseAJourSecondes <= 60;
}
/**
* Retourne la taille du widget (surface occupée)
*
* @return La surface en unités de grille
*/
public int getTailleWidget() {
return largeur * hauteur;
}
/**
* Vérifie si le widget est grand (surface > 6)
*
* @return true si le widget est considéré comme grand
*/
public boolean isWidgetGrand() {
return getTailleWidget() > 6;
}
/**
* Vérifie si le widget a des erreurs récentes (< 24h)
*
* @return true si des erreurs récentes sont détectées
*/
public boolean hasErreursRecentes() {
return dateDerniereErreur != null &&
dateDerniereErreur.isAfter(LocalDateTime.now().minusHours(24));
}
/**
* Retourne le statut du widget
*
* @return "actif", "erreur", "inactif" ou "maintenance"
*/
public String getStatutWidget() {
if (hasErreursRecentes()) return "erreur";
if (!visible) return "inactif";
if (tauxErreur > 10.0) return "maintenance";
return "actif";
return typeMetrique != null ? typeMetrique.getIcone() : "dashboard";
}
/**
* Retourne la couleur de la métrique ou la couleur personnalisée
*
* @return La couleur à utiliser
*/
public String getCouleurAffichage() {
if (couleurPrincipale != null && !couleurPrincipale.trim().isEmpty()) {
return couleurPrincipale;
}
return typeMetrique != null ? typeMetrique.getCouleur() : "#757575";
}
/**
* Vérifie si le widget nécessite une mise à jour
*
* @return true si une mise à jour est nécessaire
*/
public boolean necessiteMiseAJour() {
return miseAJourAutomatique
&& prochaineMiseAJour != null
&& prochaineMiseAJour.isBefore(LocalDateTime.now());
}
/**
* Vérifie si le widget est interactif
*
* @return true si le widget permet des interactions
*/
public boolean isInteractif() {
return "chart".equals(typeWidget) || "table".equals(typeWidget) || "gauge".equals(typeWidget);
}
/**
* Vérifie si le widget affiche des données temps réel
*
* @return true si le widget est en temps réel
*/
public boolean isTempsReel() {
return frequenceMiseAJourSecondes != null && frequenceMiseAJourSecondes <= 60;
}
/**
* Retourne la taille du widget (surface occupée)
*
* @return La surface en unités de grille
*/
public int getTailleWidget() {
return largeur * hauteur;
}
/**
* Vérifie si le widget est grand (surface > 6)
*
* @return true si le widget est considéré comme grand
*/
public boolean isWidgetGrand() {
return getTailleWidget() > 6;
}
/**
* Vérifie si le widget a des erreurs récentes (< 24h)
*
* @return true si des erreurs récentes sont détectées
*/
public boolean hasErreursRecentes() {
return dateDerniereErreur != null
&& dateDerniereErreur.isAfter(LocalDateTime.now().minusHours(24));
}
/**
* Retourne le statut du widget
*
* @return "actif", "erreur", "inactif" ou "maintenance"
*/
public String getStatutWidget() {
if (hasErreursRecentes()) return "erreur";
if (!visible) return "inactif";
if (tauxErreur > 10.0) return "maintenance";
return "actif";
}
}

570
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/analytics/KPITrendDTO.java
View File

@@ -2,30 +2,29 @@ package dev.lions.unionflow.server.api.dto.analytics;
import com.fasterxml.jackson.annotation.JsonFormat;
import dev.lions.unionflow.server.api.dto.base.BaseDTO;
import dev.lions.unionflow.server.api.enums.analytics.TypeMetrique;
import dev.lions.unionflow.server.api.enums.analytics.PeriodeAnalyse;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.DecimalMin;
import dev.lions.unionflow.server.api.enums.analytics.TypeMetrique;
import jakarta.validation.constraints.DecimalMax;
import jakarta.validation.constraints.DecimalMin;
import jakarta.validation.constraints.Digits;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Size;
import lombok.Getter;
import lombok.Setter;
import lombok.Builder;
import lombok.NoArgsConstructor;
import lombok.AllArgsConstructor;
import java.math.BigDecimal;
import java.time.LocalDateTime;
import java.util.List;
import java.util.UUID;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
/**
* DTO pour les tendances et évolutions des KPI UnionFlow
*
* Représente l'évolution d'un KPI dans le temps avec les points de données
* historiques pour générer des graphiques de tendance.
*
*
* <p>Représente l'évolution d'un KPI dans le temps avec les points de données historiques pour
* générer des graphiques de tendance.
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
@@ -36,280 +35,275 @@ import java.util.UUID;
@NoArgsConstructor
@AllArgsConstructor
public class KPITrendDTO extends BaseDTO {
private static final long serialVersionUID = 1L;
/** Type de métrique pour cette tendance */
@NotNull(message = "Le type de métrique est obligatoire")
private TypeMetrique typeMetrique;
/** Période d'analyse globale */
@NotNull(message = "La période d'analyse est obligatoire")
private PeriodeAnalyse periodeAnalyse;
/** Identifiant de l'organisation (optionnel) */
private UUID organisationId;
/** Nom de l'organisation */
@Size(max = 200, message = "Le nom de l'organisation ne peut pas dépasser 200 caractères")
private String nomOrganisation;
/** Date de début de la période analysée */
@NotNull(message = "La date de début est obligatoire")
private static final long serialVersionUID = 1L;
/** Type de métrique pour cette tendance */
@NotNull(message = "Le type de métrique est obligatoire")
private TypeMetrique typeMetrique;
/** Période d'analyse globale */
@NotNull(message = "La période d'analyse est obligatoire")
private PeriodeAnalyse periodeAnalyse;
/** Identifiant de l'organisation (optionnel) */
private UUID organisationId;
/** Nom de l'organisation */
@Size(max = 200, message = "Le nom de l'organisation ne peut pas dépasser 200 caractères")
private String nomOrganisation;
/** Date de début de la période analysée */
@NotNull(message = "La date de début est obligatoire")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateDebut;
/** Date de fin de la période analysée */
@NotNull(message = "La date de fin est obligatoire")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateFin;
/** Points de données pour la tendance */
@NotNull(message = "Les points de données sont obligatoires")
private List<PointDonneeDTO> pointsDonnees;
/** Valeur actuelle du KPI */
@NotNull(message = "La valeur actuelle est obligatoire")
@DecimalMin(value = "0.0", message = "La valeur actuelle doit être positive ou nulle")
@Digits(integer = 15, fraction = 4, message = "Format de valeur actuelle invalide")
private BigDecimal valeurActuelle;
/** Valeur minimale sur la période */
@DecimalMin(value = "0.0", message = "La valeur minimale doit être positive ou nulle")
@Digits(integer = 15, fraction = 4, message = "Format de valeur minimale invalide")
private BigDecimal valeurMinimale;
/** Valeur maximale sur la période */
@DecimalMin(value = "0.0", message = "La valeur maximale doit être positive ou nulle")
@Digits(integer = 15, fraction = 4, message = "Format de valeur maximale invalide")
private BigDecimal valeurMaximale;
/** Valeur moyenne sur la période */
@DecimalMin(value = "0.0", message = "La valeur moyenne doit être positive ou nulle")
@Digits(integer = 15, fraction = 4, message = "Format de valeur moyenne invalide")
private BigDecimal valeurMoyenne;
/** Écart-type des valeurs */
@DecimalMin(value = "0.0", message = "L'écart-type doit être positif ou nul")
@Digits(integer = 15, fraction = 4, message = "Format d'écart-type invalide")
private BigDecimal ecartType;
/** Coefficient de variation (écart-type / moyenne) */
@DecimalMin(value = "0.0", message = "Le coefficient de variation doit être positif ou nul")
@Digits(integer = 6, fraction = 4, message = "Format de coefficient de variation invalide")
private BigDecimal coefficientVariation;
/** Tendance générale (pente de la régression linéaire) */
@Digits(integer = 10, fraction = 6, message = "Format de tendance invalide")
private BigDecimal tendanceGenerale;
/** Coefficient de corrélation R² */
@DecimalMin(value = "0.0", message = "Le coefficient de corrélation doit être positif ou nul")
@DecimalMax(value = "1.0", message = "Le coefficient de corrélation ne peut pas dépasser 1")
@Digits(integer = 1, fraction = 6, message = "Format de coefficient de corrélation invalide")
private BigDecimal coefficientCorrelation;
/** Pourcentage d'évolution depuis le début de la période */
@Digits(integer = 6, fraction = 2, message = "Format de pourcentage d'évolution invalide")
private BigDecimal pourcentageEvolutionGlobale;
/** Prédiction pour la prochaine période */
@DecimalMin(value = "0.0", message = "La prédiction doit être positive ou nulle")
@Digits(integer = 15, fraction = 4, message = "Format de prédiction invalide")
private BigDecimal predictionProchainePeriode;
/** Marge d'erreur de la prédiction (en pourcentage) */
@DecimalMin(value = "0.0", message = "La marge d'erreur doit être positive ou nulle")
@DecimalMax(value = "100.0", message = "La marge d'erreur ne peut pas dépasser 100%")
@Digits(integer = 3, fraction = 2, message = "Format de marge d'erreur invalide")
private BigDecimal margeErreurPrediction;
/** Seuil d'alerte bas */
@DecimalMin(value = "0.0", message = "Le seuil d'alerte bas doit être positif ou nul")
@Digits(integer = 15, fraction = 4, message = "Format de seuil d'alerte bas invalide")
private BigDecimal seuilAlerteBas;
/** Seuil d'alerte haut */
@DecimalMin(value = "0.0", message = "Le seuil d'alerte haut doit être positif ou nul")
@Digits(integer = 15, fraction = 4, message = "Format de seuil d'alerte haut invalide")
private BigDecimal seuilAlerteHaut;
/** Indicateur si une alerte est active */
@Builder.Default private Boolean alerteActive = false;
/** Type d'alerte (bas, haut, anomalie) */
@Size(max = 50, message = "Le type d'alerte ne peut pas dépasser 50 caractères")
private String typeAlerte;
/** Message d'alerte */
@Size(max = 500, message = "Le message d'alerte ne peut pas dépasser 500 caractères")
private String messageAlerte;
/** Configuration du graphique (couleurs, style, etc.) */
@Size(max = 2000, message = "La configuration graphique ne peut pas dépasser 2000 caractères")
private String configurationGraphique;
/** Intervalle de regroupement des données */
@Size(max = 20, message = "L'intervalle de regroupement ne peut pas dépasser 20 caractères")
private String intervalleRegroupement;
/** Format d'affichage des dates */
@Size(max = 20, message = "Le format de date ne peut pas dépasser 20 caractères")
private String formatDate;
/** Date de dernière mise à jour */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateDerniereMiseAJour;
/** Fréquence de mise à jour en minutes */
@DecimalMin(value = "1", message = "La fréquence de mise à jour minimum est 1 minute")
private Integer frequenceMiseAJourMinutes;
// === CLASSES INTERNES ===
/** Classe interne représentant un point de données dans la tendance */
@Getter
@Setter
@Builder
@NoArgsConstructor
@AllArgsConstructor
public static class PointDonneeDTO {
/** Date du point de données */
@NotNull(message = "La date du point de données est obligatoire")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateDebut;
/** Date de fin de la période analysée */
@NotNull(message = "La date de fin est obligatoire")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateFin;
/** Points de données pour la tendance */
@NotNull(message = "Les points de données sont obligatoires")
private List<PointDonneeDTO> pointsDonnees;
/** Valeur actuelle du KPI */
@NotNull(message = "La valeur actuelle est obligatoire")
@DecimalMin(value = "0.0", message = "La valeur actuelle doit être positive ou nulle")
@Digits(integer = 15, fraction = 4, message = "Format de valeur actuelle invalide")
private BigDecimal valeurActuelle;
/** Valeur minimale sur la période */
@DecimalMin(value = "0.0", message = "La valeur minimale doit être positive ou nulle")
@Digits(integer = 15, fraction = 4, message = "Format de valeur minimale invalide")
private BigDecimal valeurMinimale;
/** Valeur maximale sur la période */
@DecimalMin(value = "0.0", message = "La valeur maximale doit être positive ou nulle")
@Digits(integer = 15, fraction = 4, message = "Format de valeur maximale invalide")
private BigDecimal valeurMaximale;
/** Valeur moyenne sur la période */
@DecimalMin(value = "0.0", message = "La valeur moyenne doit être positive ou nulle")
@Digits(integer = 15, fraction = 4, message = "Format de valeur moyenne invalide")
private BigDecimal valeurMoyenne;
/** Écart-type des valeurs */
@DecimalMin(value = "0.0", message = "L'écart-type doit être positif ou nul")
@Digits(integer = 15, fraction = 4, message = "Format d'écart-type invalide")
private BigDecimal ecartType;
/** Coefficient de variation (écart-type / moyenne) */
@DecimalMin(value = "0.0", message = "Le coefficient de variation doit être positif ou nul")
@Digits(integer = 6, fraction = 4, message = "Format de coefficient de variation invalide")
private BigDecimal coefficientVariation;
/** Tendance générale (pente de la régression linéaire) */
@Digits(integer = 10, fraction = 6, message = "Format de tendance invalide")
private BigDecimal tendanceGenerale;
/** Coefficient de corrélation R² */
@DecimalMin(value = "0.0", message = "Le coefficient de corrélation doit être positif ou nul")
@DecimalMax(value = "1.0", message = "Le coefficient de corrélation ne peut pas dépasser 1")
@Digits(integer = 1, fraction = 6, message = "Format de coefficient de corrélation invalide")
private BigDecimal coefficientCorrelation;
/** Pourcentage d'évolution depuis le début de la période */
@Digits(integer = 6, fraction = 2, message = "Format de pourcentage d'évolution invalide")
private BigDecimal pourcentageEvolutionGlobale;
/** Prédiction pour la prochaine période */
@DecimalMin(value = "0.0", message = "La prédiction doit être positive ou nulle")
@Digits(integer = 15, fraction = 4, message = "Format de prédiction invalide")
private BigDecimal predictionProchainePeriode;
/** Marge d'erreur de la prédiction (en pourcentage) */
@DecimalMin(value = "0.0", message = "La marge d'erreur doit être positive ou nulle")
@DecimalMax(value = "100.0", message = "La marge d'erreur ne peut pas dépasser 100%")
@Digits(integer = 3, fraction = 2, message = "Format de marge d'erreur invalide")
private BigDecimal margeErreurPrediction;
/** Seuil d'alerte bas */
@DecimalMin(value = "0.0", message = "Le seuil d'alerte bas doit être positif ou nul")
@Digits(integer = 15, fraction = 4, message = "Format de seuil d'alerte bas invalide")
private BigDecimal seuilAlerteBas;
/** Seuil d'alerte haut */
@DecimalMin(value = "0.0", message = "Le seuil d'alerte haut doit être positif ou nul")
@Digits(integer = 15, fraction = 4, message = "Format de seuil d'alerte haut invalide")
private BigDecimal seuilAlerteHaut;
/** Indicateur si une alerte est active */
@Builder.Default
private Boolean alerteActive = false;
/** Type d'alerte (bas, haut, anomalie) */
@Size(max = 50, message = "Le type d'alerte ne peut pas dépasser 50 caractères")
private String typeAlerte;
/** Message d'alerte */
@Size(max = 500, message = "Le message d'alerte ne peut pas dépasser 500 caractères")
private String messageAlerte;
/** Configuration du graphique (couleurs, style, etc.) */
@Size(max = 2000, message = "La configuration graphique ne peut pas dépasser 2000 caractères")
private String configurationGraphique;
/** Intervalle de regroupement des données */
@Size(max = 20, message = "L'intervalle de regroupement ne peut pas dépasser 20 caractères")
private String intervalleRegroupement;
/** Format d'affichage des dates */
@Size(max = 20, message = "Le format de date ne peut pas dépasser 20 caractères")
private String formatDate;
/** Date de dernière mise à jour */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateDerniereMiseAJour;
/** Fréquence de mise à jour en minutes */
@DecimalMin(value = "1", message = "La fréquence de mise à jour minimum est 1 minute")
private Integer frequenceMiseAJourMinutes;
// === CLASSES INTERNES ===
/**
* Classe interne représentant un point de données dans la tendance
*/
@Getter
@Setter
@Builder
@NoArgsConstructor
@AllArgsConstructor
public static class PointDonneeDTO {
/** Date du point de données */
@NotNull(message = "La date du point de données est obligatoire")
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime date;
/** Valeur du point de données */
@NotNull(message = "La valeur du point de données est obligatoire")
@DecimalMin(value = "0.0", message = "La valeur du point doit être positive ou nulle")
@Digits(integer = 15, fraction = 4, message = "Format de valeur du point invalide")
private BigDecimal valeur;
/** Libellé du point (optionnel) */
@Size(max = 100, message = "Le libellé du point ne peut pas dépasser 100 caractères")
private String libelle;
/** Indicateur si le point est une anomalie */
@Builder.Default
private Boolean anomalie = false;
/** Indicateur si le point est une prédiction */
@Builder.Default
private Boolean prediction = false;
/** Métadonnées additionnelles du point */
private String metadonnees;
}
// === MÉTHODES UTILITAIRES ===
/**
* Retourne le libellé de la métrique
*
* @return Le libellé de la métrique
*/
public String getLibelleMetrique() {
return typeMetrique.getLibelle();
}
/**
* Retourne l'unité de mesure
*
* @return L'unité de mesure
*/
public String getUnite() {
return typeMetrique.getUnite();
}
/**
* Retourne l'icône de la métrique
*
* @return L'icône Material Design
*/
public String getIcone() {
return typeMetrique.getIcone();
}
/**
* Retourne la couleur de la métrique
*
* @return Le code couleur hexadécimal
*/
public String getCouleur() {
return typeMetrique.getCouleur();
}
/**
* Vérifie si la tendance est positive
*
* @return true si la tendance générale est positive
*/
public boolean isTendancePositive() {
return tendanceGenerale != null && tendanceGenerale.compareTo(BigDecimal.ZERO) > 0;
}
/**
* Vérifie si la tendance est négative
*
* @return true si la tendance générale est négative
*/
public boolean isTendanceNegative() {
return tendanceGenerale != null && tendanceGenerale.compareTo(BigDecimal.ZERO) < 0;
}
/**
* Vérifie si la tendance est stable
*
* @return true si la tendance générale est stable
*/
public boolean isTendanceStable() {
return tendanceGenerale != null && tendanceGenerale.compareTo(BigDecimal.ZERO) == 0;
}
/**
* Retourne la volatilité du KPI (basée sur le coefficient de variation)
*
* @return "faible", "moyenne" ou "élevée"
*/
public String getVolatilite() {
if (coefficientVariation == null) return "inconnue";
BigDecimal cv = coefficientVariation;
if (cv.compareTo(new BigDecimal("0.1")) <= 0) return "faible";
if (cv.compareTo(new BigDecimal("0.3")) <= 0) return "moyenne";
return "élevée";
}
/**
* Vérifie si la prédiction est fiable (R² > 0.7)
*
* @return true si la prédiction est considérée comme fiable
*/
public boolean isPredictionFiable() {
return coefficientCorrelation != null &&
coefficientCorrelation.compareTo(new BigDecimal("0.7")) >= 0;
}
/**
* Retourne le nombre de points de données
*
* @return Le nombre de points de données
*/
public int getNombrePointsDonnees() {
return pointsDonnees != null ? pointsDonnees.size() : 0;
}
/**
* Vérifie si des anomalies ont été détectées
*
* @return true si au moins un point est marqué comme anomalie
*/
public boolean hasAnomalies() {
return pointsDonnees != null &&
pointsDonnees.stream().anyMatch(PointDonneeDTO::getAnomalie);
}
private LocalDateTime date;
/** Valeur du point de données */
@NotNull(message = "La valeur du point de données est obligatoire")
@DecimalMin(value = "0.0", message = "La valeur du point doit être positive ou nulle")
@Digits(integer = 15, fraction = 4, message = "Format de valeur du point invalide")
private BigDecimal valeur;
/** Libellé du point (optionnel) */
@Size(max = 100, message = "Le libellé du point ne peut pas dépasser 100 caractères")
private String libelle;
/** Indicateur si le point est une anomalie */
@Builder.Default private Boolean anomalie = false;
/** Indicateur si le point est une prédiction */
@Builder.Default private Boolean prediction = false;
/** Métadonnées additionnelles du point */
private String metadonnees;
}
// === MÉTHODES UTILITAIRES ===
/**
* Retourne le libellé de la métrique
*
* @return Le libellé de la métrique
*/
public String getLibelleMetrique() {
return typeMetrique.getLibelle();
}
/**
* Retourne l'unité de mesure
*
* @return L'unité de mesure
*/
public String getUnite() {
return typeMetrique.getUnite();
}
/**
* Retourne l'icône de la métrique
*
* @return L'icône Material Design
*/
public String getIcone() {
return typeMetrique.getIcone();
}
/**
* Retourne la couleur de la métrique
*
* @return Le code couleur hexadécimal
*/
public String getCouleur() {
return typeMetrique.getCouleur();
}
/**
* Vérifie si la tendance est positive
*
* @return true si la tendance générale est positive
*/
public boolean isTendancePositive() {
return tendanceGenerale != null && tendanceGenerale.compareTo(BigDecimal.ZERO) > 0;
}
/**
* Vérifie si la tendance est négative
*
* @return true si la tendance générale est négative
*/
public boolean isTendanceNegative() {
return tendanceGenerale != null && tendanceGenerale.compareTo(BigDecimal.ZERO) < 0;
}
/**
* Vérifie si la tendance est stable
*
* @return true si la tendance générale est stable
*/
public boolean isTendanceStable() {
return tendanceGenerale != null && tendanceGenerale.compareTo(BigDecimal.ZERO) == 0;
}
/**
* Retourne la volatilité du KPI (basée sur le coefficient de variation)
*
* @return "faible", "moyenne" ou "élevée"
*/
public String getVolatilite() {
if (coefficientVariation == null) return "inconnue";
BigDecimal cv = coefficientVariation;
if (cv.compareTo(new BigDecimal("0.1")) <= 0) return "faible";
if (cv.compareTo(new BigDecimal("0.3")) <= 0) return "moyenne";
return "élevée";
}
/**
* Vérifie si la prédiction est fiable (R² > 0.7)
*
* @return true si la prédiction est considérée comme fiable
*/
public boolean isPredictionFiable() {
return coefficientCorrelation != null
&& coefficientCorrelation.compareTo(new BigDecimal("0.7")) >= 0;
}
/**
* Retourne le nombre de points de données
*
* @return Le nombre de points de données
*/
public int getNombrePointsDonnees() {
return pointsDonnees != null ? pointsDonnees.size() : 0;
}
/**
* Vérifie si des anomalies ont été détectées
*
* @return true si au moins un point est marqué comme anomalie
*/
public boolean hasAnomalies() {
return pointsDonnees != null
&& pointsDonnees.stream().anyMatch(point -> Boolean.TRUE.equals(point.getAnomalie()));
}
}

612
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/analytics/ReportConfigDTO.java
View File

@@ -2,32 +2,31 @@ package dev.lions.unionflow.server.api.dto.analytics;
import com.fasterxml.jackson.annotation.JsonFormat;
import dev.lions.unionflow.server.api.dto.base.BaseDTO;
import dev.lions.unionflow.server.api.enums.analytics.TypeMetrique;
import dev.lions.unionflow.server.api.enums.analytics.PeriodeAnalyse;
import dev.lions.unionflow.server.api.enums.analytics.FormatExport;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.DecimalMin;
import jakarta.validation.constraints.DecimalMax;
import jakarta.validation.constraints.Size;
import dev.lions.unionflow.server.api.enums.analytics.PeriodeAnalyse;
import dev.lions.unionflow.server.api.enums.analytics.TypeMetrique;
import jakarta.validation.Valid;
import lombok.Getter;
import lombok.Setter;
import lombok.Builder;
import lombok.NoArgsConstructor;
import lombok.AllArgsConstructor;
import jakarta.validation.constraints.DecimalMax;
import jakarta.validation.constraints.DecimalMin;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Size;
import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;
import java.util.UUID;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
/**
* DTO pour la configuration des rapports analytics UnionFlow
*
* Représente la configuration d'un rapport personnalisé avec ses métriques,
* sa mise en forme et ses paramètres d'export.
*
*
* <p>Représente la configuration d'un rapport personnalisé avec ses métriques, sa mise en forme et
* ses paramètres d'export.
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
@@ -38,300 +37,291 @@ import java.util.UUID;
@NoArgsConstructor
@AllArgsConstructor
public class ReportConfigDTO extends BaseDTO {
private static final long serialVersionUID = 1L;
/** Nom du rapport */
@NotBlank(message = "Le nom du rapport est obligatoire")
@Size(min = 3, max = 200, message = "Le nom du rapport doit contenir entre 3 et 200 caractères")
private static final long serialVersionUID = 1L;
/** Nom du rapport */
@NotBlank(message = "Le nom du rapport est obligatoire")
@Size(min = 3, max = 200, message = "Le nom du rapport doit contenir entre 3 et 200 caractères")
private String nom;
/** Description du rapport */
@Size(max = 1000, message = "La description ne peut pas dépasser 1000 caractères")
private String description;
/** Type de rapport (executif, analytique, technique, operationnel) */
@NotBlank(message = "Le type de rapport est obligatoire")
@Size(max = 50, message = "Le type de rapport ne peut pas dépasser 50 caractères")
private String typeRapport;
/** Période d'analyse par défaut */
@NotNull(message = "La période d'analyse est obligatoire")
private PeriodeAnalyse periodeAnalyse;
/** Date de début personnalisée (si période personnalisée) */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateDebutPersonnalisee;
/** Date de fin personnalisée (si période personnalisée) */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateFinPersonnalisee;
/** Identifiant de l'organisation (optionnel pour filtrage) */
private UUID organisationId;
/** Nom de l'organisation */
@Size(max = 200, message = "Le nom de l'organisation ne peut pas dépasser 200 caractères")
private String nomOrganisation;
/** Identifiant de l'utilisateur créateur */
@NotNull(message = "L'identifiant de l'utilisateur créateur est obligatoire")
private UUID utilisateurCreateurId;
/** Nom de l'utilisateur créateur */
@Size(max = 200, message = "Le nom de l'utilisateur créateur ne peut pas dépasser 200 caractères")
private String nomUtilisateurCreateur;
/** Métriques incluses dans le rapport */
@NotNull(message = "Les métriques sont obligatoires")
@Valid
private List<MetriqueConfigDTO> metriques;
/** Sections du rapport */
@Valid private List<SectionRapportDTO> sections;
/** Format d'export par défaut */
@NotNull(message = "Le format d'export est obligatoire")
private FormatExport formatExport;
/** Formats d'export autorisés */
private List<FormatExport> formatsExportAutorises;
/** Modèle de rapport à utiliser */
@Size(max = 100, message = "Le modèle de rapport ne peut pas dépasser 100 caractères")
private String modeleRapport;
/** Configuration de la mise en page */
@Size(
max = 2000,
message = "La configuration de mise en page ne peut pas dépasser 2000 caractères")
private String configurationMiseEnPage;
/** Logo personnalisé (URL ou base64) */
@Size(max = 5000, message = "Le logo personnalisé ne peut pas dépasser 5000 caractères")
private String logoPersonnalise;
/** Couleurs personnalisées du rapport */
private Map<String, String> couleursPersonnalisees;
/** Indicateur si le rapport est public */
@Builder.Default private Boolean rapportPublic = false;
/** Indicateur si le rapport est automatique */
@Builder.Default private Boolean rapportAutomatique = false;
/** Fréquence de génération automatique (en heures) */
@DecimalMin(value = "1", message = "La fréquence minimum est 1 heure")
private Integer frequenceGenerationHeures;
/** Prochaine génération automatique */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime prochaineGeneration;
/** Liste des destinataires pour l'envoi automatique */
private List<String> destinatairesEmail;
/** Objet de l'email pour l'envoi automatique */
@Size(max = 200, message = "L'objet de l'email ne peut pas dépasser 200 caractères")
private String objetEmail;
/** Corps de l'email pour l'envoi automatique */
@Size(max = 2000, message = "Le corps de l'email ne peut pas dépasser 2000 caractères")
private String corpsEmail;
/** Paramètres de filtrage avancé */
private Map<String, Object> parametresFiltrage;
/** Tags pour catégoriser le rapport */
private List<String> tags;
/** Niveau de confidentialité (1=public, 5=confidentiel) */
@DecimalMin(value = "1", message = "Le niveau de confidentialité minimum est 1")
@DecimalMax(value = "5", message = "Le niveau de confidentialité maximum est 5")
@Builder.Default
private Integer niveauConfidentialite = 1;
/** Date de dernière génération */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateDerniereGeneration;
/** Nombre de générations effectuées */
@DecimalMin(value = "0", message = "Le nombre de générations doit être positif")
@Builder.Default
private Integer nombreGenerations = 0;
/** Taille moyenne des rapports générés (en KB) */
@DecimalMin(value = "0", message = "La taille moyenne doit être positive")
private Long tailleMoyenneKB;
/** Temps moyen de génération (en secondes) */
@DecimalMin(value = "0", message = "Le temps moyen de génération doit être positif")
private Integer tempsMoyenGenerationSecondes;
// === CLASSES INTERNES ===
/** Configuration d'une métrique dans le rapport */
@Getter
@Setter
@Builder
@NoArgsConstructor
@AllArgsConstructor
public static class MetriqueConfigDTO {
/** Type de métrique */
@NotNull(message = "Le type de métrique est obligatoire")
private TypeMetrique typeMetrique;
/** Libellé personnalisé */
@Size(max = 200, message = "Le libellé personnalisé ne peut pas dépasser 200 caractères")
private String libellePersonnalise;
/** Position dans le rapport (ordre d'affichage) */
@DecimalMin(value = "1", message = "La position minimum est 1")
private Integer position;
/** Taille d'affichage (1=petit, 2=moyen, 3=grand) */
@DecimalMin(value = "1", message = "La taille minimum est 1")
@DecimalMax(value = "3", message = "La taille maximum est 3")
@Builder.Default
private Integer tailleAffichage = 2;
/** Couleur personnalisée */
@Size(max = 7, message = "La couleur doit être au format #RRGGBB")
private String couleurPersonnalisee;
/** Indicateur si la métrique inclut un graphique */
@Builder.Default private Boolean inclureGraphique = true;
/** Type de graphique (line, bar, pie, area) */
@Size(max = 20, message = "Le type de graphique ne peut pas dépasser 20 caractères")
@Builder.Default
private String typeGraphique = "line";
/** Indicateur si la métrique inclut la tendance */
@Builder.Default private Boolean inclureTendance = true;
/** Indicateur si la métrique inclut la comparaison */
@Builder.Default private Boolean inclureComparaison = true;
/** Seuils d'alerte personnalisés */
private Map<String, Object> seuilsAlerte;
/** Filtres spécifiques à cette métrique */
private Map<String, Object> filtresSpecifiques;
}
/** Configuration d'une section du rapport */
@Getter
@Setter
@Builder
@NoArgsConstructor
@AllArgsConstructor
public static class SectionRapportDTO {
/** Nom de la section */
@NotBlank(message = "Le nom de la section est obligatoire")
@Size(max = 200, message = "Le nom de la section ne peut pas dépasser 200 caractères")
private String nom;
/** Description du rapport */
@Size(max = 1000, message = "La description ne peut pas dépasser 1000 caractères")
/** Description de la section */
@Size(max = 500, message = "La description de la section ne peut pas dépasser 500 caractères")
private String description;
/** Type de rapport (executif, analytique, technique, operationnel) */
@NotBlank(message = "Le type de rapport est obligatoire")
@Size(max = 50, message = "Le type de rapport ne peut pas dépasser 50 caractères")
private String typeRapport;
/** Période d'analyse par défaut */
@NotNull(message = "La période d'analyse est obligatoire")
private PeriodeAnalyse periodeAnalyse;
/** Date de début personnalisée (si période personnalisée) */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateDebutPersonnalisee;
/** Date de fin personnalisée (si période personnalisée) */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateFinPersonnalisee;
/** Identifiant de l'organisation (optionnel pour filtrage) */
private UUID organisationId;
/** Nom de l'organisation */
@Size(max = 200, message = "Le nom de l'organisation ne peut pas dépasser 200 caractères")
private String nomOrganisation;
/** Identifiant de l'utilisateur créateur */
@NotNull(message = "L'identifiant de l'utilisateur créateur est obligatoire")
private UUID utilisateurCreateurId;
/** Nom de l'utilisateur créateur */
@Size(max = 200, message = "Le nom de l'utilisateur créateur ne peut pas dépasser 200 caractères")
private String nomUtilisateurCreateur;
/** Métriques incluses dans le rapport */
@NotNull(message = "Les métriques sont obligatoires")
@Valid
private List<MetriqueConfigDTO> metriques;
/** Sections du rapport */
@Valid
private List<SectionRapportDTO> sections;
/** Format d'export par défaut */
@NotNull(message = "Le format d'export est obligatoire")
private FormatExport formatExport;
/** Formats d'export autorisés */
private List<FormatExport> formatsExportAutorises;
/** Modèle de rapport à utiliser */
@Size(max = 100, message = "Le modèle de rapport ne peut pas dépasser 100 caractères")
private String modeleRapport;
/** Configuration de la mise en page */
@Size(max = 2000, message = "La configuration de mise en page ne peut pas dépasser 2000 caractères")
private String configurationMiseEnPage;
/** Logo personnalisé (URL ou base64) */
@Size(max = 5000, message = "Le logo personnalisé ne peut pas dépasser 5000 caractères")
private String logoPersonnalise;
/** Couleurs personnalisées du rapport */
private Map<String, String> couleursPersonnalisees;
/** Indicateur si le rapport est public */
@Builder.Default
private Boolean rapportPublic = false;
/** Indicateur si le rapport est automatique */
@Builder.Default
private Boolean rapportAutomatique = false;
/** Fréquence de génération automatique (en heures) */
@DecimalMin(value = "1", message = "La fréquence minimum est 1 heure")
private Integer frequenceGenerationHeures;
/** Prochaine génération automatique */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime prochaineGeneration;
/** Liste des destinataires pour l'envoi automatique */
private List<String> destinatairesEmail;
/** Objet de l'email pour l'envoi automatique */
@Size(max = 200, message = "L'objet de l'email ne peut pas dépasser 200 caractères")
private String objetEmail;
/** Corps de l'email pour l'envoi automatique */
@Size(max = 2000, message = "Le corps de l'email ne peut pas dépasser 2000 caractères")
private String corpsEmail;
/** Paramètres de filtrage avancé */
private Map<String, Object> parametresFiltrage;
/** Tags pour catégoriser le rapport */
private List<String> tags;
/** Niveau de confidentialité (1=public, 5=confidentiel) */
@DecimalMin(value = "1", message = "Le niveau de confidentialité minimum est 1")
@DecimalMax(value = "5", message = "Le niveau de confidentialité maximum est 5")
@Builder.Default
private Integer niveauConfidentialite = 1;
/** Date de dernière génération */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateDerniereGeneration;
/** Nombre de générations effectuées */
@DecimalMin(value = "0", message = "Le nombre de générations doit être positif")
@Builder.Default
private Integer nombreGenerations = 0;
/** Taille moyenne des rapports générés (en KB) */
@DecimalMin(value = "0", message = "La taille moyenne doit être positive")
private Long tailleMoyenneKB;
/** Temps moyen de génération (en secondes) */
@DecimalMin(value = "0", message = "Le temps moyen de génération doit être positif")
private Integer tempsMoyenGenerationSecondes;
// === CLASSES INTERNES ===
/**
* Configuration d'une métrique dans le rapport
*/
@Getter
@Setter
@Builder
@NoArgsConstructor
@AllArgsConstructor
public static class MetriqueConfigDTO {
/** Type de métrique */
@NotNull(message = "Le type de métrique est obligatoire")
private TypeMetrique typeMetrique;
/** Libellé personnalisé */
@Size(max = 200, message = "Le libellé personnalisé ne peut pas dépasser 200 caractères")
private String libellePersonnalise;
/** Position dans le rapport (ordre d'affichage) */
@DecimalMin(value = "1", message = "La position minimum est 1")
private Integer position;
/** Taille d'affichage (1=petit, 2=moyen, 3=grand) */
@DecimalMin(value = "1", message = "La taille minimum est 1")
@DecimalMax(value = "3", message = "La taille maximum est 3")
@Builder.Default
private Integer tailleAffichage = 2;
/** Couleur personnalisée */
@Size(max = 7, message = "La couleur doit être au format #RRGGBB")
private String couleurPersonnalisee;
/** Indicateur si la métrique inclut un graphique */
@Builder.Default
private Boolean inclureGraphique = true;
/** Type de graphique (line, bar, pie, area) */
@Size(max = 20, message = "Le type de graphique ne peut pas dépasser 20 caractères")
@Builder.Default
private String typeGraphique = "line";
/** Indicateur si la métrique inclut la tendance */
@Builder.Default
private Boolean inclureTendance = true;
/** Indicateur si la métrique inclut la comparaison */
@Builder.Default
private Boolean inclureComparaison = true;
/** Seuils d'alerte personnalisés */
private Map<String, Object> seuilsAlerte;
/** Filtres spécifiques à cette métrique */
private Map<String, Object> filtresSpecifiques;
}
/**
* Configuration d'une section du rapport
*/
@Getter
@Setter
@Builder
@NoArgsConstructor
@AllArgsConstructor
public static class SectionRapportDTO {
/** Nom de la section */
@NotBlank(message = "Le nom de la section est obligatoire")
@Size(max = 200, message = "Le nom de la section ne peut pas dépasser 200 caractères")
private String nom;
/** Description de la section */
@Size(max = 500, message = "La description de la section ne peut pas dépasser 500 caractères")
private String description;
/** Position de la section dans le rapport */
@DecimalMin(value = "1", message = "La position minimum est 1")
private Integer position;
/** Type de section (resume, metriques, graphiques, tableaux, analyse) */
@NotBlank(message = "Le type de section est obligatoire")
@Size(max = 50, message = "Le type de section ne peut pas dépasser 50 caractères")
private String typeSection;
/** Métriques incluses dans cette section */
private List<TypeMetrique> metriquesIncluses;
/** Configuration spécifique de la section */
private Map<String, Object> configurationSection;
/** Indicateur si la section est visible */
@Builder.Default
private Boolean visible = true;
/** Indicateur si la section peut être réduite */
@Builder.Default
private Boolean pliable = false;
}
// === MÉTHODES UTILITAIRES ===
/**
* Retourne le nombre de métriques configurées
*
* @return Le nombre de métriques
*/
public int getNombreMetriques() {
return metriques != null ? metriques.size() : 0;
}
/**
* Retourne le nombre de sections configurées
*
* @return Le nombre de sections
*/
public int getNombreSections() {
return sections != null ? sections.size() : 0;
}
/**
* Vérifie si le rapport utilise une période personnalisée
*
* @return true si la période est personnalisée
*/
public boolean isPeriodePersonnalisee() {
return periodeAnalyse == PeriodeAnalyse.PERIODE_PERSONNALISEE;
}
/**
* Vérifie si le rapport est confidentiel (niveau >= 4)
*
* @return true si le rapport est confidentiel
*/
public boolean isConfidentiel() {
return niveauConfidentialite != null && niveauConfidentialite >= 4;
}
/**
* Vérifie si le rapport nécessite une génération
*
* @return true si la prochaine génération est due
*/
public boolean necessiteGeneration() {
return rapportAutomatique && prochaineGeneration != null &&
prochaineGeneration.isBefore(LocalDateTime.now());
}
/**
* Retourne la fréquence de génération en texte
*
* @return La fréquence sous forme de texte
*/
public String getFrequenceTexte() {
if (frequenceGenerationHeures == null) return "Manuelle";
return switch (frequenceGenerationHeures) {
case 1 -> "Toutes les heures";
case 24 -> "Quotidienne";
case 168 -> "Hebdomadaire"; // 24 * 7
case 720 -> "Mensuelle"; // 24 * 30
default -> "Toutes les " + frequenceGenerationHeures + " heures";
};
}
/** Position de la section dans le rapport */
@DecimalMin(value = "1", message = "La position minimum est 1")
private Integer position;
/** Type de section (resume, metriques, graphiques, tableaux, analyse) */
@NotBlank(message = "Le type de section est obligatoire")
@Size(max = 50, message = "Le type de section ne peut pas dépasser 50 caractères")
private String typeSection;
/** Métriques incluses dans cette section */
private List<TypeMetrique> metriquesIncluses;
/** Configuration spécifique de la section */
private Map<String, Object> configurationSection;
/** Indicateur si la section est visible */
@Builder.Default private Boolean visible = true;
/** Indicateur si la section peut être réduite */
@Builder.Default private Boolean pliable = false;
}
// === MÉTHODES UTILITAIRES ===
/**
* Retourne le nombre de métriques configurées
*
* @return Le nombre de métriques
*/
public int getNombreMetriques() {
return metriques != null ? metriques.size() : 0;
}
/**
* Retourne le nombre de sections configurées
*
* @return Le nombre de sections
*/
public int getNombreSections() {
return sections != null ? sections.size() : 0;
}
/**
* Vérifie si le rapport utilise une période personnalisée
*
* @return true si la période est personnalisée
*/
public boolean isPeriodePersonnalisee() {
return periodeAnalyse == PeriodeAnalyse.PERIODE_PERSONNALISEE;
}
/**
* Vérifie si le rapport est confidentiel (niveau >= 4)
*
* @return true si le rapport est confidentiel
*/
public boolean isConfidentiel() {
return niveauConfidentialite != null && niveauConfidentialite >= 4;
}
/**
* Vérifie si le rapport nécessite une génération
*
* @return true si la prochaine génération est due
*/
public boolean necessiteGeneration() {
return rapportAutomatique
&& prochaineGeneration != null
&& prochaineGeneration.isBefore(LocalDateTime.now());
}
/**
* Retourne la fréquence de génération en texte
*
* @return La fréquence sous forme de texte
*/
public String getFrequenceTexte() {
if (frequenceGenerationHeures == null) return "Manuelle";
return switch (frequenceGenerationHeures) {
case 1 -> "Toutes les heures";
case 24 -> "Quotidienne";
case 168 -> "Hebdomadaire"; // 24 * 7
case 720 -> "Mensuelle"; // 24 * 30
default -> "Toutes les " + frequenceGenerationHeures + " heures";
};
}
}

7
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/base/BaseDTO.java
View File

@@ -1,6 +1,7 @@
package dev.lions.unionflow.server.api.dto.base;
import com.fasterxml.jackson.annotation.JsonFormat;
import java.io.Serial;
import java.io.Serializable;
import java.time.LocalDateTime;
import java.util.UUID;
@@ -18,18 +19,18 @@ import lombok.Setter;
@Setter
public abstract class BaseDTO implements Serializable {
private static final long serialVersionUID = 1L;
@Serial private static final long serialVersionUID = 1L;
/** Identifiant unique UUID */
private UUID id;
/** Date de création de l'enregistrement */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateCreation;
public LocalDateTime dateCreation;
/** Date de dernière modification */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateModification;
public LocalDateTime dateModification;
/** Utilisateur qui a créé l'enregistrement */
private String creePar;

128
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/evenement/EvenementDTO.java
View File

@@ -2,6 +2,10 @@ package dev.lions.unionflow.server.api.dto.evenement;
import com.fasterxml.jackson.annotation.JsonFormat;
import dev.lions.unionflow.server.api.dto.base.BaseDTO;
import dev.lions.unionflow.server.api.enums.evenement.PrioriteEvenement;
import dev.lions.unionflow.server.api.enums.evenement.StatutEvenement;
import dev.lions.unionflow.server.api.enums.evenement.TypeEvenementMetier;
import dev.lions.unionflow.server.api.validation.ValidationConstants;
import jakarta.validation.constraints.DecimalMax;
import jakarta.validation.constraints.DecimalMin;
import jakarta.validation.constraints.Digits;
@@ -36,30 +40,29 @@ public class EvenementDTO extends BaseDTO {
private static final long serialVersionUID = 1L;
/** Titre de l'événement */
@NotBlank(message = "Le titre est obligatoire")
@Size(min = 3, max = 100, message = "Le titre doit contenir entre 3 et 100 caractères")
@NotBlank(message = "Le titre" + ValidationConstants.OBLIGATOIRE_MESSAGE)
@Size(
min = ValidationConstants.TITRE_MIN_LENGTH,
max = ValidationConstants.TITRE_MAX_LENGTH,
message = ValidationConstants.TITRE_SIZE_MESSAGE)
private String titre;
/** Description détaillée de l'événement */
@Size(max = 1000, message = "La description ne peut pas dépasser 1000 caractères")
@Size(
max = ValidationConstants.DESCRIPTION_COURTE_MAX_LENGTH,
message = ValidationConstants.DESCRIPTION_COURTE_SIZE_MESSAGE)
private String description;
/** Type d'événement */
@NotNull(message = "Le type d'événement est obligatoire")
@Pattern(
regexp =
"^(ASSEMBLEE_GENERALE|FORMATION|ACTIVITE_SOCIALE|ACTION_CARITATIVE|REUNION_BUREAU|CONFERENCE|ATELIER|CEREMONIE|AUTRE)$",
message = "Type d'événement invalide")
private String typeEvenement;
private TypeEvenementMetier typeEvenement;
/** Statut de l'événement */
@NotNull(message = "Le statut est obligatoire")
@Pattern(regexp = "^(PLANIFIE|EN_COURS|TERMINE|ANNULE|REPORTE)$", message = "Statut invalide")
private String statut;
private StatutEvenement statut;
/** Priorité de l'événement */
@Pattern(regexp = "^(BASSE|NORMALE|HAUTE|CRITIQUE)$", message = "Priorité invalide")
private String priorite;
private PrioriteEvenement priorite;
/** Date de début de l'événement */
@JsonFormat(pattern = "yyyy-MM-dd")
@@ -140,17 +143,29 @@ public class EvenementDTO extends BaseDTO {
private Integer participantsPresents;
/** Budget prévu pour l'événement */
@DecimalMin(value = "0.0", message = "Le budget ne peut pas être négatif")
@Digits(integer = 10, fraction = 2, message = "Format de budget invalide")
@DecimalMin(
value = ValidationConstants.MONTANT_MIN_VALUE,
message = ValidationConstants.MONTANT_POSITIF_MESSAGE)
@Digits(
integer = ValidationConstants.MONTANT_INTEGER_DIGITS,
fraction = ValidationConstants.MONTANT_FRACTION_DIGITS,
message = ValidationConstants.MONTANT_DIGITS_MESSAGE)
private BigDecimal budget;
/** Coût réel de l'événement */
@DecimalMin(value = "0.0", message = "Le coût ne peut pas être négatif")
@Digits(integer = 10, fraction = 2, message = "Format de coût invalide")
@DecimalMin(
value = ValidationConstants.MONTANT_MIN_VALUE,
message = ValidationConstants.MONTANT_POSITIF_MESSAGE)
@Digits(
integer = ValidationConstants.MONTANT_INTEGER_DIGITS,
fraction = ValidationConstants.MONTANT_FRACTION_DIGITS,
message = ValidationConstants.MONTANT_DIGITS_MESSAGE)
private BigDecimal coutReel;
/** Code de la devise */
@Size(min = 3, max = 3, message = "Le code devise doit faire exactement 3 caractères")
@Pattern(
regexp = ValidationConstants.DEVISE_PATTERN,
message = ValidationConstants.DEVISE_MESSAGE)
private String codeDevise;
/** Indique si l'inscription est obligatoire */
@@ -209,8 +224,8 @@ public class EvenementDTO extends BaseDTO {
// Constructeurs
public EvenementDTO() {
super();
this.statut = "PLANIFIE";
this.priorite = "NORMALE";
this.statut = StatutEvenement.PLANIFIE;
this.priorite = PrioriteEvenement.NORMALE;
this.participantsInscrits = 0;
this.participantsPresents = 0;
this.inscriptionObligatoire = false;
@@ -219,7 +234,8 @@ public class EvenementDTO extends BaseDTO {
this.codeDevise = "XOF"; // Franc CFA par défaut
}
public EvenementDTO(String titre, String typeEvenement, LocalDate dateDebut, String lieu) {
public EvenementDTO(
String titre, TypeEvenementMetier typeEvenement, LocalDate dateDebut, String lieu) {
this();
this.titre = titre;
this.typeEvenement = typeEvenement;
@@ -244,27 +260,27 @@ public class EvenementDTO extends BaseDTO {
this.description = description;
}
public String getTypeEvenement() {
public TypeEvenementMetier getTypeEvenement() {
return typeEvenement;
}
public void setTypeEvenement(String typeEvenement) {
public void setTypeEvenement(TypeEvenementMetier typeEvenement) {
this.typeEvenement = typeEvenement;
}
public String getStatut() {
public StatutEvenement getStatut() {
return statut;
}
public void setStatut(String statut) {
public void setStatut(StatutEvenement statut) {
this.statut = statut;
}
public String getPriorite() {
public PrioriteEvenement getPriorite() {
return priorite;
}
public void setPriorite(String priorite) {
public void setPriorite(PrioriteEvenement priorite) {
this.priorite = priorite;
}
@@ -555,8 +571,8 @@ public class EvenementDTO extends BaseDTO {
*
* @return true si l'événement est actuellement en cours
*/
public boolean isEnCours() {
return "EN_COURS".equals(statut);
public boolean estEnCours() {
return StatutEvenement.EN_COURS.equals(statut);
}
/**
@@ -564,8 +580,8 @@ public class EvenementDTO extends BaseDTO {
*
* @return true si l'événement est terminé
*/
public boolean isTermine() {
return "TERMINE".equals(statut);
public boolean estTermine() {
return StatutEvenement.TERMINE.equals(statut);
}
/**
@@ -573,8 +589,8 @@ public class EvenementDTO extends BaseDTO {
*
* @return true si l'événement est annulé
*/
public boolean isAnnule() {
return "ANNULE".equals(statut);
public boolean estAnnule() {
return StatutEvenement.ANNULE.equals(statut);
}
/**
@@ -582,7 +598,7 @@ public class EvenementDTO extends BaseDTO {
*
* @return true si le nombre d'inscrits atteint la capacité maximale
*/
public boolean isComplet() {
public boolean estComplet() {
return capaciteMax != null
&& participantsInscrits != null
&& participantsInscrits >= capaciteMax;
@@ -629,8 +645,8 @@ public class EvenementDTO extends BaseDTO {
*
* @return true si les inscriptions sont ouvertes
*/
public boolean isInscriptionsOuvertes() {
if (isAnnule() || isTermine()) {
public boolean sontInscriptionsOuvertes() {
if (estAnnule() || estTermine()) {
return false;
}
@@ -638,7 +654,7 @@ public class EvenementDTO extends BaseDTO {
return false;
}
return !isComplet();
return !estComplet();
}
/**
@@ -659,7 +675,7 @@ public class EvenementDTO extends BaseDTO {
*
* @return true si l'événement s'étend sur plusieurs jours
*/
public boolean isEvenementMultiJours() {
public boolean estEvenementMultiJours() {
return dateFin != null && !dateDebut.equals(dateFin);
}
@@ -669,20 +685,7 @@ public class EvenementDTO extends BaseDTO {
* @return Le libellé du type
*/
public String getTypeEvenementLibelle() {
if (typeEvenement == null) return "Non défini";
return switch (typeEvenement) {
case "ASSEMBLEE_GENERALE" -> "Assemblée Générale";
case "FORMATION" -> "Formation";
case "ACTIVITE_SOCIALE" -> "Activité Sociale";
case "ACTION_CARITATIVE" -> "Action Caritative";
case "REUNION_BUREAU" -> "Réunion de Bureau";
case "CONFERENCE" -> "Conférence";
case "ATELIER" -> "Atelier";
case "CEREMONIE" -> "Cérémonie";
case "AUTRE" -> "Autre";
default -> typeEvenement;
};
return typeEvenement != null ? typeEvenement.getLibelle() : "Non défini";
}
/**
@@ -691,16 +694,7 @@ public class EvenementDTO extends BaseDTO {
* @return Le libellé du statut
*/
public String getStatutLibelle() {
if (statut == null) return "Non défini";
return switch (statut) {
case "PLANIFIE" -> "Planifié";
case "EN_COURS" -> "En cours";
case "TERMINE" -> "Terminé";
case "ANNULE" -> "Annulé";
case "REPORTE" -> "Reporté";
default -> statut;
};
return statut != null ? statut.getLibelle() : "Non défini";
}
/**
@@ -709,15 +703,7 @@ public class EvenementDTO extends BaseDTO {
* @return Le libellé de la priorité
*/
public String getPrioriteLibelle() {
if (priorite == null) return "Normale";
return switch (priorite) {
case "BASSE" -> "Basse";
case "NORMALE" -> "Normale";
case "HAUTE" -> "Haute";
case "CRITIQUE" -> "Critique";
default -> priorite;
};
return priorite != null ? priorite.getLibelle() : "Normale";
}
/**
@@ -776,7 +762,7 @@ public class EvenementDTO extends BaseDTO {
*
* @return true si le coût réel dépasse le budget
*/
public boolean isBudgetDepasse() {
public boolean estBudgetDepasse() {
return getEcartBudgetaire().compareTo(BigDecimal.ZERO) < 0;
}

3
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/finance/CotisationDTO.java
View File

@@ -13,6 +13,7 @@ import jakarta.validation.constraints.Size;
import java.math.BigDecimal;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.temporal.ChronoUnit;
import java.util.UUID;
import lombok.Getter;
import lombok.Setter;
@@ -449,7 +450,7 @@ public class CotisationDTO extends BaseDTO {
if (dateEcheance == null || !isEnRetard()) {
return 0;
}
return dateEcheance.until(LocalDate.now()).getDays();
return ChronoUnit.DAYS.between(dateEcheance, LocalDate.now());
}
/**

58
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/membre/MembreDTO.java
View File

@@ -2,6 +2,8 @@ package dev.lions.unionflow.server.api.dto.membre;
import com.fasterxml.jackson.annotation.JsonFormat;
import dev.lions.unionflow.server.api.dto.base.BaseDTO;
import dev.lions.unionflow.server.api.enums.membre.StatutMembre;
import dev.lions.unionflow.server.api.validation.ValidationConstants;
import jakarta.validation.constraints.Email;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
@@ -27,31 +29,39 @@ public class MembreDTO extends BaseDTO {
private static final long serialVersionUID = 1L;
/** Numéro unique du membre (format: UF-YYYY-XXXXXXXX) */
@NotBlank(message = "Le numéro de membre est obligatoire")
@NotBlank(message = "Le numéro de membre" + ValidationConstants.OBLIGATOIRE_MESSAGE)
@Pattern(
regexp = "^UF-\\d{4}-[A-Z0-9]{8}$",
message = "Format de numéro de membre invalide (UF-YYYY-XXXXXXXX)")
regexp = ValidationConstants.NUMERO_MEMBRE_PATTERN,
message = ValidationConstants.NUMERO_MEMBRE_MESSAGE)
private String numeroMembre;
/** Nom de famille du membre */
@NotBlank(message = "Le nom est obligatoire")
@Size(min = 2, max = 50, message = "Le nom doit contenir entre 2 et 50 caractères")
@NotBlank(message = "Le nom" + ValidationConstants.OBLIGATOIRE_MESSAGE)
@Size(
min = ValidationConstants.NOM_PRENOM_MIN_LENGTH,
max = ValidationConstants.NOM_PRENOM_MAX_LENGTH,
message = ValidationConstants.NOM_SIZE_MESSAGE)
@Pattern(
regexp = "^[a-zA-ZÀ-ÿ\\s\\-']+$",
message = "Le nom ne peut contenir que des lettres, espaces, tirets et apostrophes")
private String nom;
/** Prénom du membre */
@NotBlank(message = "Le prénom est obligatoire")
@Size(min = 2, max = 50, message = "Le prénom doit contenir entre 2 et 50 caractères")
@NotBlank(message = "Le prénom" + ValidationConstants.OBLIGATOIRE_MESSAGE)
@Size(
min = ValidationConstants.NOM_PRENOM_MIN_LENGTH,
max = ValidationConstants.NOM_PRENOM_MAX_LENGTH,
message = ValidationConstants.PRENOM_SIZE_MESSAGE)
@Pattern(
regexp = "^[a-zA-ZÀ-ÿ\\s\\-']+$",
message = "Le prénom ne peut contenir que des lettres, espaces, tirets et apostrophes")
private String prenom;
/** Adresse email du membre */
@Email(message = "Format d'email invalide")
@Size(max = 100, message = "L'email ne peut pas dépasser 100 caractères")
@Email(message = ValidationConstants.EMAIL_FORMAT_MESSAGE)
@Size(
max = ValidationConstants.EMAIL_MAX_LENGTH,
message = ValidationConstants.EMAIL_SIZE_MESSAGE)
private String email;
/** Numéro de téléphone du membre */
@@ -87,10 +97,9 @@ public class MembreDTO extends BaseDTO {
@Size(max = 20, message = "Le type d'identité ne peut pas dépasser 20 caractères")
private String typeIdentite;
/** Statut du membre (ACTIF, INACTIF, SUSPENDU, RADIE) */
/** Statut du membre */
@NotNull(message = "Le statut est obligatoire")
@Pattern(regexp = "^(ACTIF|INACTIF|SUSPENDU|RADIE)$", message = "Statut invalide")
private String statut;
private StatutMembre statut;
/** Identifiant de l'association à laquelle appartient le membre */
@NotNull(message = "L'association est obligatoire")
@@ -132,7 +141,7 @@ public class MembreDTO extends BaseDTO {
// Constructeurs
public MembreDTO() {
super();
this.statut = "ACTIF";
this.statut = StatutMembre.ACTIF;
this.dateAdhesion = LocalDate.now();
this.membreBureau = false;
this.responsable = false;
@@ -243,11 +252,11 @@ public class MembreDTO extends BaseDTO {
this.typeIdentite = typeIdentite;
}
public String getStatut() {
public StatutMembre getStatut() {
return statut;
}
public void setStatut(String statut) {
public void setStatut(StatutMembre statut) {
this.statut = statut;
}
@@ -354,7 +363,7 @@ public class MembreDTO extends BaseDTO {
*
* @return true si le membre est majeur, false sinon
*/
public boolean isMajeur() {
public boolean estMajeur() {
if (dateNaissance == null) {
return false;
}
@@ -379,8 +388,8 @@ public class MembreDTO extends BaseDTO {
*
* @return true si le statut est ACTIF
*/
public boolean isActif() {
return "ACTIF".equals(statut);
public boolean estActif() {
return StatutMembre.ACTIF.equals(statut);
}
/**
@@ -398,15 +407,7 @@ public class MembreDTO extends BaseDTO {
* @return Le libellé du statut
*/
public String getStatutLibelle() {
if (statut == null) return "Non défini";
return switch (statut) {
case "ACTIF" -> "Actif";
case "INACTIF" -> "Inactif";
case "SUSPENDU" -> "Suspendu";
case "RADIE" -> "Radié";
default -> statut;
};
return statut != null ? statut.getLibelle() : "Non défini";
}
/**
@@ -414,7 +415,7 @@ public class MembreDTO extends BaseDTO {
*
* @return true si les données sont valides
*/
public boolean isDataValid() {
public boolean sontDonneesValides() {
return numeroMembre != null
&& !numeroMembre.trim().isEmpty()
&& nom != null
@@ -422,7 +423,6 @@ public class MembreDTO extends BaseDTO {
&& prenom != null
&& !prenom.trim().isEmpty()
&& statut != null
&& !statut.trim().isEmpty()
&& associationId != null;
}

351
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/membre/MembreSearchCriteria.java
View File

@@ -5,20 +5,19 @@ import jakarta.validation.constraints.Max;
import jakarta.validation.constraints.Min;
import jakarta.validation.constraints.Pattern;
import jakarta.validation.constraints.Size;
import java.time.LocalDate;
import java.util.List;
import java.util.UUID;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.eclipse.microprofile.openapi.annotations.media.Schema;
import java.time.LocalDate;
import java.util.List;
import java.util.UUID;
/**
* DTO pour les critères de recherche avancée des membres
* Permet de filtrer les membres selon de multiples critères
*
* DTO pour les critères de recherche avancée des membres Permet de filtrer les membres selon de
* multiples critères
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-19
@@ -30,200 +29,198 @@ import java.util.UUID;
@Schema(description = "Critères de recherche avancée pour les membres")
public class MembreSearchCriteria {
/** Terme de recherche général (nom, prénom, email) */
@Schema(description = "Terme de recherche général dans nom, prénom ou email", example = "marie")
@Size(max = 100, message = "Le terme de recherche ne peut pas dépasser 100 caractères")
private String query;
/** Terme de recherche général (nom, prénom, email) */
@Schema(description = "Terme de recherche général dans nom, prénom ou email", example = "marie")
@Size(max = 100, message = "Le terme de recherche ne peut pas dépasser 100 caractères")
private String query;
/** Recherche par nom exact ou partiel */
@Schema(description = "Filtre par nom (recherche partielle)", example = "Dupont")
@Size(max = 50, message = "Le nom ne peut pas dépasser 50 caractères")
private String nom;
/** Recherche par nom exact ou partiel */
@Schema(description = "Filtre par nom (recherche partielle)", example = "Dupont")
@Size(max = 50, message = "Le nom ne peut pas dépasser 50 caractères")
private String nom;
/** Recherche par prénom exact ou partiel */
@Schema(description = "Filtre par prénom (recherche partielle)", example = "Marie")
@Size(max = 50, message = "Le prénom ne peut pas dépasser 50 caractères")
private String prenom;
/** Recherche par prénom exact ou partiel */
@Schema(description = "Filtre par prénom (recherche partielle)", example = "Marie")
@Size(max = 50, message = "Le prénom ne peut pas dépasser 50 caractères")
private String prenom;
/** Recherche par email exact ou partiel */
@Schema(description = "Filtre par email (recherche partielle)", example = "@unionflow.com")
@Size(max = 100, message = "L'email ne peut pas dépasser 100 caractères")
private String email;
/** Recherche par email exact ou partiel */
@Schema(description = "Filtre par email (recherche partielle)", example = "@unionflow.com")
@Size(max = 100, message = "L'email ne peut pas dépasser 100 caractères")
private String email;
/** Filtre par numéro de téléphone */
@Schema(description = "Filtre par numéro de téléphone", example = "+221")
@Size(max = 20, message = "Le téléphone ne peut pas dépasser 20 caractères")
private String telephone;
/** Filtre par numéro de téléphone */
@Schema(description = "Filtre par numéro de téléphone", example = "+221")
@Size(max = 20, message = "Le téléphone ne peut pas dépasser 20 caractères")
private String telephone;
/** Liste des IDs d'organisations */
@Schema(description = "Liste des IDs d'organisations à inclure")
private List<UUID> organisationIds;
/** Liste des IDs d'organisations */
@Schema(description = "Liste des IDs d'organisations à inclure")
private List<UUID> organisationIds;
/** Liste des rôles à rechercher */
@Schema(description = "Liste des rôles à rechercher", example = "[\"PRESIDENT\", \"SECRETAIRE\"]")
private List<String> roles;
/** Liste des rôles à rechercher */
@Schema(description = "Liste des rôles à rechercher", example = "[\"PRESIDENT\", \"SECRETAIRE\"]")
private List<String> roles;
/** Filtre par statut d'activité */
@Schema(description = "Filtre par statut d'activité", example = "ACTIF")
@Pattern(regexp = "^(ACTIF|INACTIF|SUSPENDU|RADIE)$", message = "Statut invalide")
private String statut;
/** Filtre par statut d'activité */
@Schema(description = "Filtre par statut d'activité", example = "ACTIF")
@Pattern(regexp = "^(ACTIF|INACTIF|SUSPENDU|RADIE)$", message = "Statut invalide")
private String statut;
/** Date d'adhésion minimum */
@Schema(description = "Date d'adhésion minimum", example = "2020-01-01")
@JsonFormat(pattern = "yyyy-MM-dd")
private LocalDate dateAdhesionMin;
/** Date d'adhésion minimum */
@Schema(description = "Date d'adhésion minimum", example = "2020-01-01")
@JsonFormat(pattern = "yyyy-MM-dd")
private LocalDate dateAdhesionMin;
/** Date d'adhésion maximum */
@Schema(description = "Date d'adhésion maximum", example = "2025-12-31")
@JsonFormat(pattern = "yyyy-MM-dd")
private LocalDate dateAdhesionMax;
/** Date d'adhésion maximum */
@Schema(description = "Date d'adhésion maximum", example = "2025-12-31")
@JsonFormat(pattern = "yyyy-MM-dd")
private LocalDate dateAdhesionMax;
/** Âge minimum */
@Schema(description = "Âge minimum", example = "18")
@Min(value = 0, message = "L'âge minimum doit être positif")
@Max(value = 120, message = "L'âge minimum ne peut pas dépasser 120 ans")
private Integer ageMin;
/** Âge minimum */
@Schema(description = "Âge minimum", example = "18")
@Min(value = 0, message = "L'âge minimum doit être positif")
@Max(value = 120, message = "L'âge minimum ne peut pas dépasser 120 ans")
private Integer ageMin;
/** Âge maximum */
@Schema(description = "Âge maximum", example = "65")
@Min(value = 0, message = "L'âge maximum doit être positif")
@Max(value = 120, message = "L'âge maximum ne peut pas dépasser 120 ans")
private Integer ageMax;
/** Âge maximum */
@Schema(description = "Âge maximum", example = "65")
@Min(value = 0, message = "L'âge maximum doit être positif")
@Max(value = 120, message = "L'âge maximum ne peut pas dépasser 120 ans")
private Integer ageMax;
/** Filtre par région */
@Schema(description = "Filtre par région", example = "Dakar")
@Size(max = 50, message = "La région ne peut pas dépasser 50 caractères")
private String region;
/** Filtre par région */
@Schema(description = "Filtre par région", example = "Dakar")
@Size(max = 50, message = "La région ne peut pas dépasser 50 caractères")
private String region;
/** Filtre par ville */
@Schema(description = "Filtre par ville", example = "Dakar")
@Size(max = 50, message = "La ville ne peut pas dépasser 50 caractères")
private String ville;
/** Filtre par ville */
@Schema(description = "Filtre par ville", example = "Dakar")
@Size(max = 50, message = "La ville ne peut pas dépasser 50 caractères")
private String ville;
/** Filtre par profession */
@Schema(description = "Filtre par profession", example = "Ingénieur")
@Size(max = 100, message = "La profession ne peut pas dépasser 100 caractères")
private String profession;
/** Filtre par profession */
@Schema(description = "Filtre par profession", example = "Ingénieur")
@Size(max = 100, message = "La profession ne peut pas dépasser 100 caractères")
private String profession;
/** Filtre par nationalité */
@Schema(description = "Filtre par nationalité", example = "Sénégalaise")
@Size(max = 50, message = "La nationalité ne peut pas dépasser 50 caractères")
private String nationalite;
/** Filtre par nationalité */
@Schema(description = "Filtre par nationalité", example = "Sénégalaise")
@Size(max = 50, message = "La nationalité ne peut pas dépasser 50 caractères")
private String nationalite;
/** Filtre membres du bureau uniquement */
@Schema(description = "Filtre pour les membres du bureau uniquement")
private Boolean membreBureau;
/** Filtre membres du bureau uniquement */
@Schema(description = "Filtre pour les membres du bureau uniquement")
private Boolean membreBureau;
/** Filtre responsables uniquement */
@Schema(description = "Filtre pour les responsables uniquement")
private Boolean responsable;
/** Filtre responsables uniquement */
@Schema(description = "Filtre pour les responsables uniquement")
private Boolean responsable;
/** Inclure les membres inactifs dans la recherche */
@Schema(description = "Inclure les membres inactifs", defaultValue = "false")
@Builder.Default
private Boolean includeInactifs = false;
/** Inclure les membres inactifs dans la recherche */
@Schema(description = "Inclure les membres inactifs", defaultValue = "false")
@Builder.Default
private Boolean includeInactifs = false;
/**
* Vérifie si au moins un critère de recherche est défini
*
* @return true si au moins un critère est défini
*/
public boolean hasAnyCriteria() {
return query != null && !query.trim().isEmpty() ||
nom != null && !nom.trim().isEmpty() ||
prenom != null && !prenom.trim().isEmpty() ||
email != null && !email.trim().isEmpty() ||
telephone != null && !telephone.trim().isEmpty() ||
organisationIds != null && !organisationIds.isEmpty() ||
roles != null && !roles.isEmpty() ||
statut != null && !statut.trim().isEmpty() ||
dateAdhesionMin != null ||
dateAdhesionMax != null ||
ageMin != null ||
ageMax != null ||
region != null && !region.trim().isEmpty() ||
ville != null && !ville.trim().isEmpty() ||
profession != null && !profession.trim().isEmpty() ||
nationalite != null && !nationalite.trim().isEmpty() ||
membreBureau != null ||
responsable != null;
/**
* Vérifie si au moins un critère de recherche est défini
*
* @return true si au moins un critère est défini
*/
public boolean hasAnyCriteria() {
return query != null && !query.trim().isEmpty()
|| nom != null && !nom.trim().isEmpty()
|| prenom != null && !prenom.trim().isEmpty()
|| email != null && !email.trim().isEmpty()
|| telephone != null && !telephone.trim().isEmpty()
|| organisationIds != null && !organisationIds.isEmpty()
|| roles != null && !roles.isEmpty()
|| statut != null && !statut.trim().isEmpty()
|| dateAdhesionMin != null
|| dateAdhesionMax != null
|| ageMin != null
|| ageMax != null
|| region != null && !region.trim().isEmpty()
|| ville != null && !ville.trim().isEmpty()
|| profession != null && !profession.trim().isEmpty()
|| nationalite != null && !nationalite.trim().isEmpty()
|| membreBureau != null
|| responsable != null;
}
/**
* Valide la cohérence des critères de recherche
*
* @return true si les critères sont cohérents
*/
public boolean isValid() {
// Validation des dates
if (dateAdhesionMin != null && dateAdhesionMax != null) {
if (dateAdhesionMin.isAfter(dateAdhesionMax)) {
return false;
}
}
/**
* Valide la cohérence des critères de recherche
*
* @return true si les critères sont cohérents
*/
public boolean isValid() {
// Validation des dates
if (dateAdhesionMin != null && dateAdhesionMax != null) {
if (dateAdhesionMin.isAfter(dateAdhesionMax)) {
return false;
}
}
// Validation des âges
if (ageMin != null && ageMax != null) {
if (ageMin > ageMax) {
return false;
}
}
return true;
// Validation des âges
if (ageMin != null && ageMax != null) {
if (ageMin > ageMax) {
return false;
}
}
/**
* Nettoie les chaînes de caractères (trim et null si vide)
*/
public void sanitize() {
query = sanitizeString(query);
nom = sanitizeString(nom);
prenom = sanitizeString(prenom);
email = sanitizeString(email);
telephone = sanitizeString(telephone);
statut = sanitizeString(statut);
region = sanitizeString(region);
ville = sanitizeString(ville);
profession = sanitizeString(profession);
nationalite = sanitizeString(nationalite);
}
return true;
}
private String sanitizeString(String str) {
if (str == null) return null;
str = str.trim();
return str.isEmpty() ? null : str;
}
/** Nettoie les chaînes de caractères (trim et null si vide) */
public void sanitize() {
query = sanitizeString(query);
nom = sanitizeString(nom);
prenom = sanitizeString(prenom);
email = sanitizeString(email);
telephone = sanitizeString(telephone);
statut = sanitizeString(statut);
region = sanitizeString(region);
ville = sanitizeString(ville);
profession = sanitizeString(profession);
nationalite = sanitizeString(nationalite);
}
/**
* Retourne une description textuelle des critères actifs
*
* @return Description des critères
*/
public String getDescription() {
StringBuilder sb = new StringBuilder();
if (query != null) sb.append("Recherche: '").append(query).append("' ");
if (nom != null) sb.append("Nom: '").append(nom).append("' ");
if (prenom != null) sb.append("Prénom: '").append(prenom).append("' ");
if (email != null) sb.append("Email: '").append(email).append("' ");
if (statut != null) sb.append("Statut: ").append(statut).append(" ");
if (organisationIds != null && !organisationIds.isEmpty()) {
sb.append("Organisations: ").append(organisationIds.size()).append(" ");
}
if (roles != null && !roles.isEmpty()) {
sb.append("Rôles: ").append(String.join(", ", roles)).append(" ");
}
if (dateAdhesionMin != null) sb.append("Adhésion >= ").append(dateAdhesionMin).append(" ");
if (dateAdhesionMax != null) sb.append("Adhésion <= ").append(dateAdhesionMax).append(" ");
if (ageMin != null) sb.append("Âge >= ").append(ageMin).append(" ");
if (ageMax != null) sb.append("Âge <= ").append(ageMax).append(" ");
if (region != null) sb.append("Région: '").append(region).append("' ");
if (ville != null) sb.append("Ville: '").append(ville).append("' ");
if (profession != null) sb.append("Profession: '").append(profession).append("' ");
if (nationalite != null) sb.append("Nationalité: '").append(nationalite).append("' ");
if (Boolean.TRUE.equals(membreBureau)) sb.append("Membre bureau ");
if (Boolean.TRUE.equals(responsable)) sb.append("Responsable ");
return sb.toString().trim();
private String sanitizeString(String str) {
if (str == null) return null;
str = str.trim();
return str.isEmpty() ? null : str;
}
/**
* Retourne une description textuelle des critères actifs
*
* @return Description des critères
*/
public String getDescription() {
StringBuilder sb = new StringBuilder();
if (query != null) sb.append("Recherche: '").append(query).append("' ");
if (nom != null) sb.append("Nom: '").append(nom).append("' ");
if (prenom != null) sb.append("Prénom: '").append(prenom).append("' ");
if (email != null) sb.append("Email: '").append(email).append("' ");
if (statut != null) sb.append("Statut: ").append(statut).append(" ");
if (organisationIds != null && !organisationIds.isEmpty()) {
sb.append("Organisations: ").append(organisationIds.size()).append(" ");
}
if (roles != null && !roles.isEmpty()) {
sb.append("Rôles: ").append(String.join(", ", roles)).append(" ");
}
if (dateAdhesionMin != null) sb.append("Adhésion >= ").append(dateAdhesionMin).append(" ");
if (dateAdhesionMax != null) sb.append("Adhésion <= ").append(dateAdhesionMax).append(" ");
if (ageMin != null) sb.append("Âge >= ").append(ageMin).append(" ");
if (ageMax != null) sb.append("Âge <= ").append(ageMax).append(" ");
if (region != null) sb.append("Région: '").append(region).append("' ");
if (ville != null) sb.append("Ville: '").append(ville).append("' ");
if (profession != null) sb.append("Profession: '").append(profession).append("' ");
if (nationalite != null) sb.append("Nationalité: '").append(nationalite).append("' ");
if (Boolean.TRUE.equals(membreBureau)) sb.append("Membre bureau ");
if (Boolean.TRUE.equals(responsable)) sb.append("Responsable ");
return sb.toString().trim();
}
}

319
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/membre/MembreSearchResultDTO.java
View File

@@ -1,17 +1,16 @@
package dev.lions.unionflow.server.api.dto.membre;
import java.util.List;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.eclipse.microprofile.openapi.annotations.media.Schema;
import java.util.List;
/**
* DTO pour les résultats de recherche avancée des membres
* Contient les résultats paginés et les métadonnées de recherche
*
* DTO pour les résultats de recherche avancée des membres Contient les résultats paginés et les
* métadonnées de recherche
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-19
@@ -23,182 +22,178 @@ import java.util.List;
@Schema(description = "Résultats de recherche avancée des membres avec pagination")
public class MembreSearchResultDTO {
/** Liste des membres trouvés */
@Schema(description = "Liste des membres correspondant aux critères")
private List<MembreDTO> membres;
/** Liste des membres trouvés */
@Schema(description = "Liste des membres correspondant aux critères")
private List<MembreDTO> membres;
/** Nombre total de résultats (toutes pages confondues) */
@Schema(description = "Nombre total de résultats trouvés", example = "247")
private long totalElements;
/** Nombre total de résultats (toutes pages confondues) */
@Schema(description = "Nombre total de résultats trouvés", example = "247")
private long totalElements;
/** Nombre total de pages */
@Schema(description = "Nombre total de pages", example = "13")
private int totalPages;
/** Nombre total de pages */
@Schema(description = "Nombre total de pages", example = "13")
private int totalPages;
/** Numéro de la page actuelle (0-based) */
@Schema(description = "Numéro de la page actuelle", example = "0")
private int currentPage;
/** Numéro de la page actuelle (0-based) */
@Schema(description = "Numéro de la page actuelle", example = "0")
private int currentPage;
/** Taille de la page */
@Schema(description = "Nombre d'éléments par page", example = "20")
private int pageSize;
/** Taille de la page */
@Schema(description = "Nombre d'éléments par page", example = "20")
private int pageSize;
/** Nombre d'éléments sur la page actuelle */
@Schema(description = "Nombre d'éléments sur cette page", example = "20")
private int numberOfElements;
/** Nombre d'éléments sur la page actuelle */
@Schema(description = "Nombre d'éléments sur cette page", example = "20")
private int numberOfElements;
/** Indique s'il y a une page suivante */
@Schema(description = "Indique s'il y a une page suivante")
private boolean hasNext;
/** Indique s'il y a une page suivante */
@Schema(description = "Indique s'il y a une page suivante")
private boolean hasNext;
/** Indique s'il y a une page précédente */
@Schema(description = "Indique s'il y a une page précédente")
private boolean hasPrevious;
/** Indique s'il y a une page précédente */
@Schema(description = "Indique s'il y a une page précédente")
private boolean hasPrevious;
/** Indique si c'est la première page */
@Schema(description = "Indique si c'est la première page")
private boolean isFirst;
/** Indique si c'est la première page */
@Schema(description = "Indique si c'est la première page")
private boolean isFirst;
/** Indique si c'est la dernière page */
@Schema(description = "Indique si c'est la dernière page")
private boolean isLast;
/** Indique si c'est la dernière page */
@Schema(description = "Indique si c'est la dernière page")
private boolean isLast;
/** Critères de recherche utilisés */
@Schema(description = "Critères de recherche qui ont été appliqués")
private MembreSearchCriteria criteria;
/** Critères de recherche utilisés */
@Schema(description = "Critères de recherche qui ont été appliqués")
private MembreSearchCriteria criteria;
/** Temps d'exécution de la recherche en millisecondes */
@Schema(description = "Temps d'exécution de la recherche en ms", example = "45")
private long executionTimeMs;
/** Temps d'exécution de la recherche en millisecondes */
@Schema(description = "Temps d'exécution de la recherche en ms", example = "45")
private long executionTimeMs;
/** Statistiques de recherche */
@Schema(description = "Statistiques sur les résultats de recherche")
private SearchStatistics statistics;
/** Statistiques de recherche */
@Schema(description = "Statistiques sur les résultats de recherche")
private SearchStatistics statistics;
/**
* Statistiques sur les résultats de recherche
*/
@Data
@NoArgsConstructor
@AllArgsConstructor
@Builder
@Schema(description = "Statistiques sur les résultats de recherche")
public static class SearchStatistics {
/** Répartition par statut */
@Schema(description = "Nombre de membres actifs dans les résultats")
private long membresActifs;
@Schema(description = "Nombre de membres inactifs dans les résultats")
private long membresInactifs;
/** Répartition par âge */
@Schema(description = "Âge moyen des membres trouvés")
private double ageMoyen;
@Schema(description = "Âge minimum des membres trouvés")
private int ageMin;
@Schema(description = "Âge maximum des membres trouvés")
private int ageMax;
/** Répartition par organisation */
@Schema(description = "Nombre d'organisations représentées")
private long nombreOrganisations;
/** Répartition par région */
@Schema(description = "Nombre de régions représentées")
private long nombreRegions;
/** Ancienneté moyenne */
@Schema(description = "Ancienneté moyenne en années")
private double ancienneteMoyenne;
/** Statistiques sur les résultats de recherche */
@Data
@NoArgsConstructor
@AllArgsConstructor
@Builder
@Schema(description = "Statistiques sur les résultats de recherche")
public static class SearchStatistics {
/** Répartition par statut */
@Schema(description = "Nombre de membres actifs dans les résultats")
private long membresActifs;
@Schema(description = "Nombre de membres inactifs dans les résultats")
private long membresInactifs;
/** Répartition par âge */
@Schema(description = "Âge moyen des membres trouvés")
private double ageMoyen;
@Schema(description = "Âge minimum des membres trouvés")
private int ageMin;
@Schema(description = "Âge maximum des membres trouvés")
private int ageMax;
/** Répartition par organisation */
@Schema(description = "Nombre d'organisations représentées")
private long nombreOrganisations;
/** Répartition par région */
@Schema(description = "Nombre de régions représentées")
private long nombreRegions;
/** Ancienneté moyenne */
@Schema(description = "Ancienneté moyenne en années")
private double ancienneteMoyenne;
}
/** Calcule et met à jour les indicateurs de pagination */
public void calculatePaginationFlags() {
this.isFirst = currentPage == 0;
this.isLast = currentPage >= totalPages - 1;
this.hasPrevious = currentPage > 0;
this.hasNext = currentPage < totalPages - 1;
this.numberOfElements = membres != null ? membres.size() : 0;
}
/**
* Vérifie si les résultats sont vides
*
* @return true si aucun résultat
*/
public boolean isEmpty() {
return membres == null || membres.isEmpty();
}
/**
* Retourne le numéro de la page suivante (1-based pour affichage)
*
* @return Numéro de page suivante ou -1 si pas de page suivante
*/
public int getNextPageNumber() {
return hasNext ? currentPage + 2 : -1;
}
/**
* Retourne le numéro de la page précédente (1-based pour affichage)
*
* @return Numéro de page précédente ou -1 si pas de page précédente
*/
public int getPreviousPageNumber() {
return hasPrevious ? currentPage : -1;
}
/**
* Retourne une description textuelle des résultats
*
* @return Description des résultats
*/
public String getResultDescription() {
if (isEmpty()) {
return "Aucun membre trouvé";
}
/**
* Calcule et met à jour les indicateurs de pagination
*/
public void calculatePaginationFlags() {
this.isFirst = currentPage == 0;
this.isLast = currentPage >= totalPages - 1;
this.hasPrevious = currentPage > 0;
this.hasNext = currentPage < totalPages - 1;
this.numberOfElements = membres != null ? membres.size() : 0;
if (totalElements == 1) {
return "1 membre trouvé";
}
/**
* Vérifie si les résultats sont vides
*
* @return true si aucun résultat
*/
public boolean isEmpty() {
return membres == null || membres.isEmpty();
if (totalPages == 1) {
return String.format("%d membres trouvés", totalElements);
}
/**
* Retourne le numéro de la page suivante (1-based pour affichage)
*
* @return Numéro de page suivante ou -1 si pas de page suivante
*/
public int getNextPageNumber() {
return hasNext ? currentPage + 2 : -1;
}
int startElement = currentPage * pageSize + 1;
int endElement = Math.min(startElement + numberOfElements - 1, (int) totalElements);
/**
* Retourne le numéro de la page précédente (1-based pour affichage)
*
* @return Numéro de page précédente ou -1 si pas de page précédente
*/
public int getPreviousPageNumber() {
return hasPrevious ? currentPage : -1;
}
return String.format(
"Membres %d-%d sur %d (page %d/%d)",
startElement, endElement, totalElements, currentPage + 1, totalPages);
}
/**
* Retourne une description textuelle des résultats
*
* @return Description des résultats
*/
public String getResultDescription() {
if (isEmpty()) {
return "Aucun membre trouvé";
}
if (totalElements == 1) {
return "1 membre trouvé";
}
if (totalPages == 1) {
return String.format("%d membres trouvés", totalElements);
}
int startElement = currentPage * pageSize + 1;
int endElement = Math.min(startElement + numberOfElements - 1, (int) totalElements);
return String.format("Membres %d-%d sur %d (page %d/%d)",
startElement, endElement, totalElements,
currentPage + 1, totalPages);
}
/**
* Factory method pour créer un résultat vide
*
* @param criteria Critères de recherche
* @return Résultat vide
*/
public static MembreSearchResultDTO empty(MembreSearchCriteria criteria) {
return MembreSearchResultDTO.builder()
.membres(List.of())
.totalElements(0)
.totalPages(0)
.currentPage(0)
.pageSize(20)
.numberOfElements(0)
.hasNext(false)
.hasPrevious(false)
.isFirst(true)
.isLast(true)
.criteria(criteria)
.executionTimeMs(0)
.build();
}
/**
* Factory method pour créer un résultat vide
*
* @param criteria Critères de recherche
* @return Résultat vide
*/
public static MembreSearchResultDTO empty(MembreSearchCriteria criteria) {
MembreSearchResultDTO result = new MembreSearchResultDTO();
result.setMembres(List.of());
result.setTotalElements(0L);
result.setTotalPages(0);
result.setCurrentPage(0);
result.setPageSize(20);
result.setNumberOfElements(0);
result.setHasNext(false);
result.setHasPrevious(false);
result.setFirst(true);
result.setLast(true);
result.setCriteria(criteria);
result.setExecutionTimeMs(0L);
return result;
}
}

865
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/notification/ActionNotificationDTO.java
View File

@@ -1,426 +1,477 @@
package dev.lions.unionflow.server.api.dto.notification;
import jakarta.validation.constraints.*;
import com.fasterxml.jackson.annotation.JsonInclude;
import jakarta.validation.constraints.*;
import java.util.Map;
/**
* DTO pour les actions rapides des notifications UnionFlow
*
* Ce DTO représente une action que l'utilisateur peut exécuter directement
* depuis la notification sans ouvrir l'application.
*
*
* <p>Ce DTO représente une action que l'utilisateur peut exécuter directement depuis la
* notification sans ouvrir l'application.
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
*/
@JsonInclude(JsonInclude.Include.NON_NULL)
public class ActionNotificationDTO {
/**
* Identifiant unique de l'action
*/
@NotBlank(message = "L'identifiant de l'action est obligatoire")
private String id;
/**
* Libellé affiché sur le bouton d'action
*/
@NotBlank(message = "Le libellé de l'action est obligatoire")
@Size(max = 30, message = "Le libellé ne peut pas dépasser 30 caractères")
private String libelle;
/**
* Description de l'action (tooltip)
*/
@Size(max = 100, message = "La description ne peut pas dépasser 100 caractères")
private String description;
/**
* Type d'action à exécuter
*/
@NotBlank(message = "Le type d'action est obligatoire")
private String typeAction;
/**
* Icône de l'action (Material Design)
*/
private String icone;
/**
* Couleur de l'action (hexadécimal)
*/
private String couleur;
/**
* URL à ouvrir (pour les actions de type "url")
*/
private String url;
/**
* Route de l'application à ouvrir (pour les actions de type "route")
*/
private String route;
/**
* Paramètres de l'action
*/
private Map<String, String> parametres;
/**
* Indique si l'action ferme la notification
*/
private Boolean fermeNotification;
/**
* Indique si l'action nécessite une confirmation
*/
private Boolean necessiteConfirmation;
/**
* Message de confirmation à afficher
*/
private String messageConfirmation;
/**
* Indique si l'action est destructive (suppression, etc.)
*/
private Boolean estDestructive;
/**
* Ordre d'affichage de l'action
*/
private Integer ordre;
/**
* Indique si l'action est activée
*/
private Boolean estActivee;
/**
* Condition d'affichage de l'action (expression)
*/
private String conditionAffichage;
/**
* Rôles autorisés à exécuter cette action
*/
private String[] rolesAutorises;
/**
* Permissions requises pour exécuter cette action
*/
private String[] permissionsRequises;
/**
* Délai d'expiration de l'action en minutes
*/
private Integer delaiExpirationMinutes;
/**
* Nombre maximum d'exécutions autorisées
*/
private Integer maxExecutions;
/**
* Nombre d'exécutions actuelles
*/
private Integer nombreExecutions;
/**
* Indique si l'action peut être exécutée plusieurs fois
*/
private Boolean peutEtreRepetee;
/**
* Style du bouton (primary, secondary, outline, text)
*/
private String styleBouton;
/**
* Taille du bouton (small, medium, large)
*/
private String tailleBouton;
/**
* Position du bouton (left, center, right)
*/
private String positionBouton;
/**
* Données personnalisées de l'action
*/
private Map<String, Object> donneesPersonnalisees;
// === CONSTRUCTEURS ===
/**
* Constructeur par défaut
*/
public ActionNotificationDTO() {
this.fermeNotification = true;
this.necessiteConfirmation = false;
this.estDestructive = false;
this.ordre = 0;
this.estActivee = true;
this.maxExecutions = 1;
this.nombreExecutions = 0;
this.peutEtreRepetee = false;
this.styleBouton = "primary";
this.tailleBouton = "medium";
this.positionBouton = "right";
/** Identifiant unique de l'action */
@NotBlank(message = "L'identifiant de l'action est obligatoire")
private String id;
/** Libellé affiché sur le bouton d'action */
@NotBlank(message = "Le libellé de l'action est obligatoire")
@Size(max = 30, message = "Le libellé ne peut pas dépasser 30 caractères")
private String libelle;
/** Description de l'action (tooltip) */
@Size(max = 100, message = "La description ne peut pas dépasser 100 caractères")
private String description;
/** Type d'action à exécuter */
@NotBlank(message = "Le type d'action est obligatoire")
private String typeAction;
/** Icône de l'action (Material Design) */
private String icone;
/** Couleur de l'action (hexadécimal) */
private String couleur;
/** URL à ouvrir (pour les actions de type "url") */
private String url;
/** Route de l'application à ouvrir (pour les actions de type "route") */
private String route;
/** Paramètres de l'action */
private Map<String, String> parametres;
/** Indique si l'action ferme la notification */
private Boolean fermeNotification;
/** Indique si l'action nécessite une confirmation */
private Boolean necessiteConfirmation;
/** Message de confirmation à afficher */
private String messageConfirmation;
/** Indique si l'action est destructive (suppression, etc.) */
private Boolean estDestructive;
/** Ordre d'affichage de l'action */
private Integer ordre;
/** Indique si l'action est activée */
private Boolean estActivee;
/** Condition d'affichage de l'action (expression) */
private String conditionAffichage;
/** Rôles autorisés à exécuter cette action */
private String[] rolesAutorises;
/** Permissions requises pour exécuter cette action */
private String[] permissionsRequises;
/** Délai d'expiration de l'action en minutes */
private Integer delaiExpirationMinutes;
/** Nombre maximum d'exécutions autorisées */
private Integer maxExecutions;
/** Nombre d'exécutions actuelles */
private Integer nombreExecutions;
/** Indique si l'action peut être exécutée plusieurs fois */
private Boolean peutEtreRepetee;
/** Style du bouton (primary, secondary, outline, text) */
private String styleBouton;
/** Taille du bouton (small, medium, large) */
private String tailleBouton;
/** Position du bouton (left, center, right) */
private String positionBouton;
/** Données personnalisées de l'action */
private Map<String, Object> donneesPersonnalisees;
// === CONSTRUCTEURS ===
/** Constructeur par défaut */
public ActionNotificationDTO() {
this.fermeNotification = true;
this.necessiteConfirmation = false;
this.estDestructive = false;
this.ordre = 0;
this.estActivee = true;
this.maxExecutions = 1;
this.nombreExecutions = 0;
this.peutEtreRepetee = false;
this.styleBouton = "primary";
this.tailleBouton = "medium";
this.positionBouton = "right";
}
/** Constructeur avec paramètres essentiels */
public ActionNotificationDTO(String id, String libelle, String typeAction) {
this();
this.id = id;
this.libelle = libelle;
this.typeAction = typeAction;
}
/** Constructeur pour action URL */
public ActionNotificationDTO(String id, String libelle, String url, String icone) {
this(id, libelle, "url");
this.url = url;
this.icone = icone;
}
/** Constructeur pour action de route */
public ActionNotificationDTO(
String id, String libelle, String route, String icone, Map<String, String> parametres) {
this(id, libelle, "route");
this.route = route;
this.icone = icone;
this.parametres = parametres;
}
// === GETTERS ET SETTERS ===
public String getId() {
return id;
}
public void setId(String id) {
this.id = id;
}
public String getLibelle() {
return libelle;
}
public void setLibelle(String libelle) {
this.libelle = libelle;
}
public String getDescription() {
return description;
}
public void setDescription(String description) {
this.description = description;
}
public String getTypeAction() {
return typeAction;
}
public void setTypeAction(String typeAction) {
this.typeAction = typeAction;
}
public String getIcone() {
return icone;
}
public void setIcone(String icone) {
this.icone = icone;
}
public String getCouleur() {
return couleur;
}
public void setCouleur(String couleur) {
this.couleur = couleur;
}
public String getUrl() {
return url;
}
public void setUrl(String url) {
this.url = url;
}
public String getRoute() {
return route;
}
public void setRoute(String route) {
this.route = route;
}
public Map<String, String> getParametres() {
return parametres;
}
public void setParametres(Map<String, String> parametres) {
this.parametres = parametres;
}
public Boolean getFermeNotification() {
return fermeNotification;
}
public void setFermeNotification(Boolean fermeNotification) {
this.fermeNotification = fermeNotification;
}
public Boolean getNecessiteConfirmation() {
return necessiteConfirmation;
}
public void setNecessiteConfirmation(Boolean necessiteConfirmation) {
this.necessiteConfirmation = necessiteConfirmation;
}
public String getMessageConfirmation() {
return messageConfirmation;
}
public void setMessageConfirmation(String messageConfirmation) {
this.messageConfirmation = messageConfirmation;
}
public Boolean getEstDestructive() {
return estDestructive;
}
public void setEstDestructive(Boolean estDestructive) {
this.estDestructive = estDestructive;
}
public Integer getOrdre() {
return ordre;
}
public void setOrdre(Integer ordre) {
this.ordre = ordre;
}
public Boolean getEstActivee() {
return estActivee;
}
public void setEstActivee(Boolean estActivee) {
this.estActivee = estActivee;
}
public String getConditionAffichage() {
return conditionAffichage;
}
public void setConditionAffichage(String conditionAffichage) {
this.conditionAffichage = conditionAffichage;
}
public String[] getRolesAutorises() {
return rolesAutorises;
}
public void setRolesAutorises(String[] rolesAutorises) {
this.rolesAutorises = rolesAutorises;
}
public String[] getPermissionsRequises() {
return permissionsRequises;
}
public void setPermissionsRequises(String[] permissionsRequises) {
this.permissionsRequises = permissionsRequises;
}
public Integer getDelaiExpirationMinutes() {
return delaiExpirationMinutes;
}
public void setDelaiExpirationMinutes(Integer delaiExpirationMinutes) {
this.delaiExpirationMinutes = delaiExpirationMinutes;
}
public Integer getMaxExecutions() {
return maxExecutions;
}
public void setMaxExecutions(Integer maxExecutions) {
this.maxExecutions = maxExecutions;
}
public Integer getNombreExecutions() {
return nombreExecutions;
}
public void setNombreExecutions(Integer nombreExecutions) {
this.nombreExecutions = nombreExecutions;
}
public Boolean getPeutEtreRepetee() {
return peutEtreRepetee;
}
public void setPeutEtreRepetee(Boolean peutEtreRepetee) {
this.peutEtreRepetee = peutEtreRepetee;
}
public String getStyleBouton() {
return styleBouton;
}
public void setStyleBouton(String styleBouton) {
this.styleBouton = styleBouton;
}
public String getTailleBouton() {
return tailleBouton;
}
public void setTailleBouton(String tailleBouton) {
this.tailleBouton = tailleBouton;
}
public String getPositionBouton() {
return positionBouton;
}
public void setPositionBouton(String positionBouton) {
this.positionBouton = positionBouton;
}
public Map<String, Object> getDonneesPersonnalisees() {
return donneesPersonnalisees;
}
public void setDonneesPersonnalisees(Map<String, Object> donneesPersonnalisees) {
this.donneesPersonnalisees = donneesPersonnalisees;
}
// === MÉTHODES UTILITAIRES ===
/** Vérifie si l'action peut être exécutée */
public boolean peutEtreExecutee() {
return estActivee && (nombreExecutions < maxExecutions || peutEtreRepetee);
}
/** Vérifie si l'action est expirée */
public boolean isExpiree() {
// Implémentation basée sur delaiExpirationMinutes et date de création de la notification
return false; // À implémenter selon la logique métier
}
/** Incrémente le nombre d'exécutions */
public void incrementerExecutions() {
if (nombreExecutions == null) {
nombreExecutions = 0;
}
/**
* Constructeur avec paramètres essentiels
*/
public ActionNotificationDTO(String id, String libelle, String typeAction) {
this();
this.id = id;
this.libelle = libelle;
this.typeAction = typeAction;
}
/**
* Constructeur pour action URL
*/
public ActionNotificationDTO(String id, String libelle, String url, String icone) {
this(id, libelle, "url");
this.url = url;
this.icone = icone;
}
/**
* Constructeur pour action de route
*/
public ActionNotificationDTO(String id, String libelle, String route, String icone, Map<String, String> parametres) {
this(id, libelle, "route");
this.route = route;
this.icone = icone;
this.parametres = parametres;
}
// === GETTERS ET SETTERS ===
public String getId() { return id; }
public void setId(String id) { this.id = id; }
public String getLibelle() { return libelle; }
public void setLibelle(String libelle) { this.libelle = libelle; }
public String getDescription() { return description; }
public void setDescription(String description) { this.description = description; }
public String getTypeAction() { return typeAction; }
public void setTypeAction(String typeAction) { this.typeAction = typeAction; }
public String getIcone() { return icone; }
public void setIcone(String icone) { this.icone = icone; }
public String getCouleur() { return couleur; }
public void setCouleur(String couleur) { this.couleur = couleur; }
public String getUrl() { return url; }
public void setUrl(String url) { this.url = url; }
public String getRoute() { return route; }
public void setRoute(String route) { this.route = route; }
public Map<String, String> getParametres() { return parametres; }
public void setParametres(Map<String, String> parametres) { this.parametres = parametres; }
public Boolean getFermeNotification() { return fermeNotification; }
public void setFermeNotification(Boolean fermeNotification) { this.fermeNotification = fermeNotification; }
public Boolean getNecessiteConfirmation() { return necessiteConfirmation; }
public void setNecessiteConfirmation(Boolean necessiteConfirmation) { this.necessiteConfirmation = necessiteConfirmation; }
public String getMessageConfirmation() { return messageConfirmation; }
public void setMessageConfirmation(String messageConfirmation) { this.messageConfirmation = messageConfirmation; }
public Boolean getEstDestructive() { return estDestructive; }
public void setEstDestructive(Boolean estDestructive) { this.estDestructive = estDestructive; }
public Integer getOrdre() { return ordre; }
public void setOrdre(Integer ordre) { this.ordre = ordre; }
public Boolean getEstActivee() { return estActivee; }
public void setEstActivee(Boolean estActivee) { this.estActivee = estActivee; }
public String getConditionAffichage() { return conditionAffichage; }
public void setConditionAffichage(String conditionAffichage) { this.conditionAffichage = conditionAffichage; }
public String[] getRolesAutorises() { return rolesAutorises; }
public void setRolesAutorises(String[] rolesAutorises) { this.rolesAutorises = rolesAutorises; }
public String[] getPermissionsRequises() { return permissionsRequises; }
public void setPermissionsRequises(String[] permissionsRequises) { this.permissionsRequises = permissionsRequises; }
public Integer getDelaiExpirationMinutes() { return delaiExpirationMinutes; }
public void setDelaiExpirationMinutes(Integer delaiExpirationMinutes) { this.delaiExpirationMinutes = delaiExpirationMinutes; }
public Integer getMaxExecutions() { return maxExecutions; }
public void setMaxExecutions(Integer maxExecutions) { this.maxExecutions = maxExecutions; }
public Integer getNombreExecutions() { return nombreExecutions; }
public void setNombreExecutions(Integer nombreExecutions) { this.nombreExecutions = nombreExecutions; }
public Boolean getPeutEtreRepetee() { return peutEtreRepetee; }
public void setPeutEtreRepetee(Boolean peutEtreRepetee) { this.peutEtreRepetee = peutEtreRepetee; }
public String getStyleBouton() { return styleBouton; }
public void setStyleBouton(String styleBouton) { this.styleBouton = styleBouton; }
public String getTailleBouton() { return tailleBouton; }
public void setTailleBouton(String tailleBouton) { this.tailleBouton = tailleBouton; }
public String getPositionBouton() { return positionBouton; }
public void setPositionBouton(String positionBouton) { this.positionBouton = positionBouton; }
public Map<String, Object> getDonneesPersonnalisees() { return donneesPersonnalisees; }
public void setDonneesPersonnalisees(Map<String, Object> donneesPersonnalisees) {
this.donneesPersonnalisees = donneesPersonnalisees;
}
// === MÉTHODES UTILITAIRES ===
/**
* Vérifie si l'action peut être exécutée
*/
public boolean peutEtreExecutee() {
return estActivee && (nombreExecutions < maxExecutions || peutEtreRepetee);
}
/**
* Vérifie si l'action est expirée
*/
public boolean isExpiree() {
// Implémentation basée sur delaiExpirationMinutes et date de création de la notification
return false; // À implémenter selon la logique métier
}
/**
* Incrémente le nombre d'exécutions
*/
public void incrementerExecutions() {
if (nombreExecutions == null) {
nombreExecutions = 0;
nombreExecutions++;
}
/** Vérifie si l'utilisateur a les permissions requises */
public boolean utilisateurAutorise(String[] rolesUtilisateur, String[] permissionsUtilisateur) {
// Vérification des rôles
if (rolesAutorises != null && rolesAutorises.length > 0) {
boolean roleAutorise = false;
for (String roleRequis : rolesAutorises) {
for (String roleUtilisateur : rolesUtilisateur) {
if (roleRequis.equals(roleUtilisateur)) {
roleAutorise = true;
break;
}
}
nombreExecutions++;
if (roleAutorise) break;
}
if (!roleAutorise) return false;
}
/**
* Vérifie si l'utilisateur a les permissions requises
*/
public boolean utilisateurAutorise(String[] rolesUtilisateur, String[] permissionsUtilisateur) {
// Vérification des rôles
if (rolesAutorises != null && rolesAutorises.length > 0) {
boolean roleAutorise = false;
for (String roleRequis : rolesAutorises) {
for (String roleUtilisateur : rolesUtilisateur) {
if (roleRequis.equals(roleUtilisateur)) {
roleAutorise = true;
break;
}
}
if (roleAutorise) break;
}
if (!roleAutorise) return false;
// Vérification des permissions
if (permissionsRequises != null && permissionsRequises.length > 0) {
boolean permissionAutorisee = false;
for (String permissionRequise : permissionsRequises) {
for (String permissionUtilisateur : permissionsUtilisateur) {
if (permissionRequise.equals(permissionUtilisateur)) {
permissionAutorisee = true;
break;
}
}
// Vérification des permissions
if (permissionsRequises != null && permissionsRequises.length > 0) {
boolean permissionAutorisee = false;
for (String permissionRequise : permissionsRequises) {
for (String permissionUtilisateur : permissionsUtilisateur) {
if (permissionRequise.equals(permissionUtilisateur)) {
permissionAutorisee = true;
break;
}
}
if (permissionAutorisee) break;
}
if (!permissionAutorisee) return false;
}
return true;
}
/**
* Retourne la couleur par défaut selon le type d'action
*/
public String getCouleurParDefaut() {
if (couleur != null) return couleur;
return switch (typeAction) {
case "confirm" -> "#4CAF50"; // Vert pour confirmation
case "cancel" -> "#F44336"; // Rouge pour annulation
case "info" -> "#2196F3"; // Bleu pour information
case "warning" -> "#FF9800"; // Orange pour avertissement
case "url", "route" -> "#2196F3"; // Bleu pour navigation
default -> "#9E9E9E"; // Gris par défaut
};
}
/**
* Retourne l'icône par défaut selon le type d'action
*/
public String getIconeParDefaut() {
if (icone != null) return icone;
return switch (typeAction) {
case "confirm" -> "check";
case "cancel" -> "close";
case "info" -> "info";
case "warning" -> "warning";
case "url" -> "open_in_new";
case "route" -> "arrow_forward";
case "call" -> "phone";
case "message" -> "message";
case "email" -> "email";
case "share" -> "share";
default -> "touch_app";
};
}
/**
* Crée une action de confirmation
*/
public static ActionNotificationDTO creerActionConfirmation(String id, String libelle) {
ActionNotificationDTO action = new ActionNotificationDTO(id, libelle, "confirm");
action.setCouleur("#4CAF50");
action.setIcone("check");
action.setStyleBouton("primary");
return action;
}
/**
* Crée une action d'annulation
*/
public static ActionNotificationDTO creerActionAnnulation(String id, String libelle) {
ActionNotificationDTO action = new ActionNotificationDTO(id, libelle, "cancel");
action.setCouleur("#F44336");
action.setIcone("close");
action.setStyleBouton("outline");
action.setEstDestructive(true);
return action;
}
/**
* Crée une action de navigation
*/
public static ActionNotificationDTO creerActionNavigation(String id, String libelle, String route) {
ActionNotificationDTO action = new ActionNotificationDTO(id, libelle, "route");
action.setRoute(route);
action.setCouleur("#2196F3");
action.setIcone("arrow_forward");
return action;
}
@Override
public String toString() {
return String.format("ActionNotificationDTO{id='%s', libelle='%s', type='%s'}",
id, libelle, typeAction);
if (permissionAutorisee) break;
}
if (!permissionAutorisee) return false;
}
return true;
}
/** Retourne la couleur par défaut selon le type d'action */
public String getCouleurParDefaut() {
if (couleur != null) return couleur;
return switch (typeAction) {
case "confirm" -> "#4CAF50"; // Vert pour confirmation
case "cancel" -> "#F44336"; // Rouge pour annulation
case "info" -> "#2196F3"; // Bleu pour information
case "warning" -> "#FF9800"; // Orange pour avertissement
case "url", "route" -> "#2196F3"; // Bleu pour navigation
default -> "#9E9E9E"; // Gris par défaut
};
}
/** Retourne l'icône par défaut selon le type d'action */
public String getIconeParDefaut() {
if (icone != null) return icone;
return switch (typeAction) {
case "confirm" -> "check";
case "cancel" -> "close";
case "info" -> "info";
case "warning" -> "warning";
case "url" -> "open_in_new";
case "route" -> "arrow_forward";
case "call" -> "phone";
case "message" -> "message";
case "email" -> "email";
case "share" -> "share";
default -> "touch_app";
};
}
/** Crée une action de confirmation */
public static ActionNotificationDTO creerActionConfirmation(String id, String libelle) {
ActionNotificationDTO action = new ActionNotificationDTO(id, libelle, "confirm");
action.setCouleur("#4CAF50");
action.setIcone("check");
action.setStyleBouton("primary");
return action;
}
/** Crée une action d'annulation */
public static ActionNotificationDTO creerActionAnnulation(String id, String libelle) {
ActionNotificationDTO action = new ActionNotificationDTO(id, libelle, "cancel");
action.setCouleur("#F44336");
action.setIcone("close");
action.setStyleBouton("outline");
action.setEstDestructive(true);
return action;
}
/** Crée une action de navigation */
public static ActionNotificationDTO creerActionNavigation(
String id, String libelle, String route) {
ActionNotificationDTO action = new ActionNotificationDTO(id, libelle, "route");
action.setRoute(route);
action.setCouleur("#2196F3");
action.setIcone("arrow_forward");
return action;
}
@Override
public String toString() {
return String.format(
"ActionNotificationDTO{id='%s', libelle='%s', type='%s'}", id, libelle, typeAction);
}
}

1150
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/notification/NotificationDTO.java
View File

File diff suppressed because it is too large Load Diff

183
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/notification/PreferenceCanalNotificationDTO.java
View File

@@ -5,88 +5,115 @@ import jakarta.validation.constraints.*;
/**
* DTO pour les préférences spécifiques à un canal de notification
*
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
*/
@JsonInclude(JsonInclude.Include.NON_NULL)
public class PreferenceCanalNotificationDTO {
/**
* Indique si ce canal est activé
*/
private Boolean active;
/**
* Niveau d'importance personnalisé (1-5)
*/
@Min(value = 1, message = "L'importance doit être comprise entre 1 et 5")
@Max(value = 5, message = "L'importance doit être comprise entre 1 et 5")
private Integer importance;
/**
* Son personnalisé pour ce canal
*/
private String sonPersonnalise;
/**
* Pattern de vibration personnalisé
*/
private long[] patternVibration;
/**
* Couleur LED personnalisée
*/
private String couleurLED;
/**
* Indique si le son est activé pour ce canal
*/
private Boolean sonActive;
/**
* Indique si la vibration est activée pour ce canal
*/
private Boolean vibrationActive;
/**
* Indique si la LED est activée pour ce canal
*/
private Boolean ledActive;
/**
* Indique si ce canal peut être désactivé par l'utilisateur
*/
private Boolean peutEtreDesactive;
// Constructeurs, getters et setters
public PreferenceCanalNotificationDTO() {}
public Boolean getActive() { return active; }
public void setActive(Boolean active) { this.active = active; }
public Integer getImportance() { return importance; }
public void setImportance(Integer importance) { this.importance = importance; }
public String getSonPersonnalise() { return sonPersonnalise; }
public void setSonPersonnalise(String sonPersonnalise) { this.sonPersonnalise = sonPersonnalise; }
public long[] getPatternVibration() { return patternVibration; }
public void setPatternVibration(long[] patternVibration) { this.patternVibration = patternVibration; }
public String getCouleurLED() { return couleurLED; }
public void setCouleurLED(String couleurLED) { this.couleurLED = couleurLED; }
public Boolean getSonActive() { return sonActive; }
public void setSonActive(Boolean sonActive) { this.sonActive = sonActive; }
public Boolean getVibrationActive() { return vibrationActive; }
public void setVibrationActive(Boolean vibrationActive) { this.vibrationActive = vibrationActive; }
public Boolean getLedActive() { return ledActive; }
public void setLedActive(Boolean ledActive) { this.ledActive = ledActive; }
public Boolean getPeutEtreDesactive() { return peutEtreDesactive; }
public void setPeutEtreDesactive(Boolean peutEtreDesactive) { this.peutEtreDesactive = peutEtreDesactive; }
/** Indique si ce canal est activé */
private Boolean active;
/** Niveau d'importance personnalisé (1-5) */
@Min(value = 1, message = "L'importance doit être comprise entre 1 et 5")
@Max(value = 5, message = "L'importance doit être comprise entre 1 et 5")
private Integer importance;
/** Son personnalisé pour ce canal */
private String sonPersonnalise;
/** Pattern de vibration personnalisé */
private long[] patternVibration;
/** Couleur LED personnalisée */
private String couleurLED;
/** Indique si le son est activé pour ce canal */
private Boolean sonActive;
/** Indique si la vibration est activée pour ce canal */
private Boolean vibrationActive;
/** Indique si la LED est activée pour ce canal */
private Boolean ledActive;
/** Indique si ce canal peut être désactivé par l'utilisateur */
private Boolean peutEtreDesactive;
// Constructeurs, getters et setters
public PreferenceCanalNotificationDTO() {}
public Boolean getActive() {
return active;
}
public void setActive(Boolean active) {
this.active = active;
}
public Integer getImportance() {
return importance;
}
public void setImportance(Integer importance) {
this.importance = importance;
}
public String getSonPersonnalise() {
return sonPersonnalise;
}
public void setSonPersonnalise(String sonPersonnalise) {
this.sonPersonnalise = sonPersonnalise;
}
public long[] getPatternVibration() {
return patternVibration;
}
public void setPatternVibration(long[] patternVibration) {
this.patternVibration = patternVibration;
}
public String getCouleurLED() {
return couleurLED;
}
public void setCouleurLED(String couleurLED) {
this.couleurLED = couleurLED;
}
public Boolean getSonActive() {
return sonActive;
}
public void setSonActive(Boolean sonActive) {
this.sonActive = sonActive;
}
public Boolean getVibrationActive() {
return vibrationActive;
}
public void setVibrationActive(Boolean vibrationActive) {
this.vibrationActive = vibrationActive;
}
public Boolean getLedActive() {
return ledActive;
}
public void setLedActive(Boolean ledActive) {
this.ledActive = ledActive;
}
public Boolean getPeutEtreDesactive() {
return peutEtreDesactive;
}
public void setPeutEtreDesactive(Boolean peutEtreDesactive) {
this.peutEtreDesactive = peutEtreDesactive;
}
}

206
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/notification/PreferenceTypeNotificationDTO.java
View File

@@ -5,98 +5,128 @@ import jakarta.validation.constraints.*;
/**
* DTO pour les préférences spécifiques à un type de notification
*
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
*/
@JsonInclude(JsonInclude.Include.NON_NULL)
public class PreferenceTypeNotificationDTO {
/**
* Indique si ce type de notification est activé
*/
private Boolean active;
/**
* Priorité personnalisée (1-5)
*/
@Min(value = 1, message = "La priorité doit être comprise entre 1 et 5")
@Max(value = 5, message = "La priorité doit être comprise entre 1 et 5")
private Integer priorite;
/**
* Son personnalisé pour ce type
*/
private String sonPersonnalise;
/**
* Pattern de vibration personnalisé
*/
private long[] patternVibration;
/**
* Couleur LED personnalisée
*/
private String couleurLED;
/**
* Durée d'affichage personnalisée (secondes)
*/
@Min(value = 1, message = "La durée d'affichage doit être au moins 1 seconde")
@Max(value = 300, message = "La durée d'affichage ne peut pas dépasser 5 minutes")
private Integer dureeAffichageSecondes;
/**
* Indique si les notifications de ce type doivent vibrer
*/
private Boolean doitVibrer;
/**
* Indique si les notifications de ce type doivent émettre un son
*/
private Boolean doitEmettreSon;
/**
* Indique si les notifications de ce type doivent allumer la LED
*/
private Boolean doitAllumerLED;
/**
* Indique si ce type ignore le mode silencieux
*/
private Boolean ignoreModesilencieux;
// Constructeurs, getters et setters
public PreferenceTypeNotificationDTO() {}
public Boolean getActive() { return active; }
public void setActive(Boolean active) { this.active = active; }
public Integer getPriorite() { return priorite; }
public void setPriorite(Integer priorite) { this.priorite = priorite; }
public String getSonPersonnalise() { return sonPersonnalise; }
public void setSonPersonnalise(String sonPersonnalise) { this.sonPersonnalise = sonPersonnalise; }
public long[] getPatternVibration() { return patternVibration; }
public void setPatternVibration(long[] patternVibration) { this.patternVibration = patternVibration; }
public String getCouleurLED() { return couleurLED; }
public void setCouleurLED(String couleurLED) { this.couleurLED = couleurLED; }
public Integer getDureeAffichageSecondes() { return dureeAffichageSecondes; }
public void setDureeAffichageSecondes(Integer dureeAffichageSecondes) { this.dureeAffichageSecondes = dureeAffichageSecondes; }
public Boolean getDoitVibrer() { return doitVibrer; }
public void setDoitVibrer(Boolean doitVibrer) { this.doitVibrer = doitVibrer; }
public Boolean getDoitEmettreSon() { return doitEmettreSon; }
public void setDoitEmettreSon(Boolean doitEmettreSon) { this.doitEmettreSon = doitEmettreSon; }
public Boolean getDoitAllumerLED() { return doitAllumerLED; }
public void setDoitAllumerLED(Boolean doitAllumerLED) { this.doitAllumerLED = doitAllumerLED; }
public Boolean getIgnoreModeSilencieux() { return ignoreModesilencieux; }
public void setIgnoreModeSilencieux(Boolean ignoreModesilencieux) { this.ignoreModesilencieux = ignoreModesilencieux; }
/** Indique si ce type de notification est activé */
private Boolean active;
/** Priorité personnalisée (1-5) */
@Min(value = 1, message = "La priorité doit être comprise entre 1 et 5")
@Max(value = 5, message = "La priorité doit être comprise entre 1 et 5")
private Integer priorite;
/** Son personnalisé pour ce type */
private String sonPersonnalise;
/** Pattern de vibration personnalisé */
private long[] patternVibration;
/** Couleur LED personnalisée */
private String couleurLED;
/** Durée d'affichage personnalisée (secondes) */
@Min(value = 1, message = "La durée d'affichage doit être au moins 1 seconde")
@Max(value = 300, message = "La durée d'affichage ne peut pas dépasser 5 minutes")
private Integer dureeAffichageSecondes;
/** Indique si les notifications de ce type doivent vibrer */
private Boolean doitVibrer;
/** Indique si les notifications de ce type doivent émettre un son */
private Boolean doitEmettreSon;
/** Indique si les notifications de ce type doivent allumer la LED */
private Boolean doitAllumerLED;
/** Indique si ce type ignore le mode silencieux */
private Boolean ignoreModesilencieux;
// Constructeurs, getters et setters
public PreferenceTypeNotificationDTO() {}
public Boolean getActive() {
return active;
}
public void setActive(Boolean active) {
this.active = active;
}
public Integer getPriorite() {
return priorite;
}
public void setPriorite(Integer priorite) {
this.priorite = priorite;
}
public String getSonPersonnalise() {
return sonPersonnalise;
}
public void setSonPersonnalise(String sonPersonnalise) {
this.sonPersonnalise = sonPersonnalise;
}
public long[] getPatternVibration() {
return patternVibration;
}
public void setPatternVibration(long[] patternVibration) {
this.patternVibration = patternVibration;
}
public String getCouleurLED() {
return couleurLED;
}
public void setCouleurLED(String couleurLED) {
this.couleurLED = couleurLED;
}
public Integer getDureeAffichageSecondes() {
return dureeAffichageSecondes;
}
public void setDureeAffichageSecondes(Integer dureeAffichageSecondes) {
this.dureeAffichageSecondes = dureeAffichageSecondes;
}
public Boolean getDoitVibrer() {
return doitVibrer;
}
public void setDoitVibrer(Boolean doitVibrer) {
this.doitVibrer = doitVibrer;
}
public Boolean getDoitEmettreSon() {
return doitEmettreSon;
}
public void setDoitEmettreSon(Boolean doitEmettreSon) {
this.doitEmettreSon = doitEmettreSon;
}
public Boolean getDoitAllumerLED() {
return doitAllumerLED;
}
public void setDoitAllumerLED(Boolean doitAllumerLED) {
this.doitAllumerLED = doitAllumerLED;
}
public Boolean getIgnoreModeSilencieux() {
return ignoreModesilencieux;
}
public void setIgnoreModeSilencieux(Boolean ignoreModesilencieux) {
this.ignoreModesilencieux = ignoreModesilencieux;
}
}

1117
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/notification/PreferencesNotificationDTO.java
View File

File diff suppressed because it is too large Load Diff

70
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/organisation/OrganisationDTO.java
View File

@@ -4,6 +4,7 @@ import com.fasterxml.jackson.annotation.JsonFormat;
import dev.lions.unionflow.server.api.dto.base.BaseDTO;
import dev.lions.unionflow.server.api.enums.organisation.StatutOrganisation;
import dev.lions.unionflow.server.api.enums.organisation.TypeOrganisation;
import dev.lions.unionflow.server.api.validation.ValidationConstants;
import jakarta.validation.constraints.DecimalMax;
import jakarta.validation.constraints.DecimalMin;
import jakarta.validation.constraints.Digits;
@@ -34,12 +35,17 @@ public class OrganisationDTO extends BaseDTO {
private static final long serialVersionUID = 1L;
/** Nom de l'organisation */
@NotBlank(message = "Le nom de l'organisation est obligatoire")
@Size(min = 2, max = 200, message = "Le nom doit contenir entre 2 et 200 caractères")
@NotBlank(message = "Le nom de l'organisation" + ValidationConstants.OBLIGATOIRE_MESSAGE)
@Size(
min = ValidationConstants.NOM_ORGANISATION_MIN_LENGTH,
max = ValidationConstants.NOM_ORGANISATION_MAX_LENGTH,
message = ValidationConstants.NOM_ORGANISATION_SIZE_MESSAGE)
private String nom;
/** Nom court ou sigle */
@Size(max = 50, message = "Le nom court ne peut pas dépasser 50 caractères")
@Size(
max = ValidationConstants.NOM_COURT_MAX_LENGTH,
message = ValidationConstants.NOM_COURT_SIZE_MESSAGE)
private String nomCourt;
/** Type d'organisation */
@@ -51,7 +57,9 @@ public class OrganisationDTO extends BaseDTO {
private StatutOrganisation statut;
/** Description de l'organisation */
@Size(max = 2000, message = "La description ne peut pas dépasser 2000 caractères")
@Size(
max = ValidationConstants.DESCRIPTION_MAX_LENGTH,
message = ValidationConstants.DESCRIPTION_SIZE_MESSAGE)
private String description;
/** Date de fondation */
@@ -225,7 +233,7 @@ public class OrganisationDTO extends BaseDTO {
*
* @return true si l'organisation est active
*/
public boolean isActive() {
public boolean estActive() {
return StatutOrganisation.ACTIVE.equals(statut);
}
@@ -234,7 +242,7 @@ public class OrganisationDTO extends BaseDTO {
*
* @return true si l'organisation est inactive
*/
public boolean isInactive() {
public boolean estInactive() {
return StatutOrganisation.INACTIVE.equals(statut);
}
@@ -243,7 +251,7 @@ public class OrganisationDTO extends BaseDTO {
*
* @return true si l'organisation est suspendue
*/
public boolean isSuspendue() {
public boolean estSuspendue() {
return StatutOrganisation.SUSPENDUE.equals(statut);
}
@@ -252,7 +260,7 @@ public class OrganisationDTO extends BaseDTO {
*
* @return true si l'organisation est en création
*/
public boolean isEnCreation() {
public boolean estEnCreation() {
return StatutOrganisation.EN_CREATION.equals(statut);
}
@@ -261,7 +269,7 @@ public class OrganisationDTO extends BaseDTO {
*
* @return true si l'organisation est dissoute
*/
public boolean isDissoute() {
public boolean estDissoute() {
return StatutOrganisation.DISSOUTE.equals(statut);
}
@@ -291,7 +299,7 @@ public class OrganisationDTO extends BaseDTO {
*
* @return true si latitude et longitude sont définies
*/
public boolean hasGeolocalisation() {
public boolean possedGeolocalisation() {
return latitude != null && longitude != null;
}
@@ -300,7 +308,7 @@ public class OrganisationDTO extends BaseDTO {
*
* @return true si l'organisation n'a pas de parent
*/
public boolean isOrganisationRacine() {
public boolean estOrganisationRacine() {
return organisationParenteId == null;
}
@@ -309,7 +317,7 @@ public class OrganisationDTO extends BaseDTO {
*
* @return true si le niveau hiérarchique est supérieur à 0
*/
public boolean hasSousOrganisations() {
public boolean possedeSousOrganisations() {
return niveauHierarchique != null && niveauHierarchique > 0;
}
@@ -408,6 +416,17 @@ public class OrganisationDTO extends BaseDTO {
marquerCommeModifie(utilisateur);
}
/**
* Désactive l'organisation
*
* @param utilisateur L'utilisateur qui désactive l'organisation
*/
public void desactiver(String utilisateur) {
this.statut = StatutOrganisation.INACTIVE;
this.accepteNouveauxMembres = false;
marquerCommeModifie(utilisateur);
}
/**
* Met à jour le nombre de membres
*
@@ -469,4 +488,31 @@ public class OrganisationDTO extends BaseDTO {
+ "} "
+ super.toString();
}
// === MÉTHODES UTILITAIRES ===
/** Retourne le libellé du statut */
public String getStatutLibelle() {
return statut != null ? statut.getLibelle() : "Non défini";
}
/** Retourne le libellé du type d'organisation */
public String getTypeLibelle() {
return typeOrganisation != null ? typeOrganisation.getLibelle() : "Non défini";
}
/** Ajoute un administrateur */
public void ajouterAdministrateur(String utilisateur) {
if (nombreAdministrateurs == null) nombreAdministrateurs = 0;
nombreAdministrateurs++;
marquerCommeModifie(utilisateur);
}
/** Retire un administrateur */
public void retirerAdministrateur(String utilisateur) {
if (nombreAdministrateurs != null && nombreAdministrateurs > 0) {
nombreAdministrateurs--;
marquerCommeModifie(utilisateur);
}
}
}

134
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/solidarite/BeneficiaireAideDTO.java
View File

@@ -1,16 +1,15 @@
package dev.lions.unionflow.server.api.dto.solidarite;
import jakarta.validation.constraints.*;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.time.LocalDate;
import lombok.AllArgsConstructor;
import lombok.Builder;
import java.time.LocalDate;
import lombok.Data;
import lombok.NoArgsConstructor;
/**
* DTO pour les bénéficiaires d'une aide
*
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
@@ -20,80 +19,53 @@ import java.time.LocalDate;
@AllArgsConstructor
@Builder
public class BeneficiaireAideDTO {
/**
* Identifiant unique du bénéficiaire
*/
private String id;
/**
* Nom complet du bénéficiaire
*/
@NotBlank(message = "Le nom du bénéficiaire est obligatoire")
@Size(max = 100, message = "Le nom ne peut pas dépasser 100 caractères")
private String nomComplet;
/**
* Relation avec le demandeur
*/
@NotBlank(message = "La relation avec le demandeur est obligatoire")
private String relationDemandeur;
/**
* Date de naissance
*/
private LocalDate dateNaissance;
/**
* Âge calculé
*/
private Integer age;
/**
* Genre
*/
private String genre;
/**
* Numéro de téléphone
*/
@Pattern(regexp = "^\\+?[0-9]{8,15}$", message = "Le numéro de téléphone n'est pas valide")
private String telephone;
/**
* Adresse email
*/
@Email(message = "L'adresse email n'est pas valide")
private String email;
/**
* Adresse physique
*/
@Size(max = 200, message = "L'adresse ne peut pas dépasser 200 caractères")
private String adresse;
/**
* Situation particulière (handicap, maladie, etc.)
*/
@Size(max = 500, message = "La situation particulière ne peut pas dépasser 500 caractères")
private String situationParticuliere;
/**
* Indique si le bénéficiaire est le demandeur principal
*/
@Builder.Default
private Boolean estDemandeurPrincipal = false;
/**
* Pourcentage de l'aide destiné à ce bénéficiaire
*/
@DecimalMin(value = "0.0", message = "Le pourcentage doit être positif")
@DecimalMax(value = "100.0", message = "Le pourcentage ne peut pas dépasser 100%")
private Double pourcentageAide;
/**
* Montant spécifique pour ce bénéficiaire
*/
@DecimalMin(value = "0.0", message = "Le montant doit être positif")
private Double montantSpecifique;
/** Identifiant unique du bénéficiaire */
private String id;
/** Nom complet du bénéficiaire */
@NotBlank(message = "Le nom du bénéficiaire est obligatoire")
@Size(max = 100, message = "Le nom ne peut pas dépasser 100 caractères")
private String nomComplet;
/** Relation avec le demandeur */
@NotBlank(message = "La relation avec le demandeur est obligatoire")
private String relationDemandeur;
/** Date de naissance */
private LocalDate dateNaissance;
/** Âge calculé */
private Integer age;
/** Genre */
private String genre;
/** Numéro de téléphone */
@Pattern(regexp = "^\\+?[0-9]{8,15}$", message = "Le numéro de téléphone n'est pas valide")
private String telephone;
/** Adresse email */
@Email(message = "L'adresse email n'est pas valide")
private String email;
/** Adresse physique */
@Size(max = 200, message = "L'adresse ne peut pas dépasser 200 caractères")
private String adresse;
/** Situation particulière (handicap, maladie, etc.) */
@Size(max = 500, message = "La situation particulière ne peut pas dépasser 500 caractères")
private String situationParticuliere;
/** Indique si le bénéficiaire est le demandeur principal */
@Builder.Default private Boolean estDemandeurPrincipal = false;
/** Pourcentage de l'aide destiné à ce bénéficiaire */
@DecimalMin(value = "0.0", message = "Le pourcentage doit être positif")
@DecimalMax(value = "100.0", message = "Le pourcentage ne peut pas dépasser 100%")
private Double pourcentageAide;
/** Montant spécifique pour ce bénéficiaire */
@DecimalMin(value = "0.0", message = "Le montant doit être positif")
private Double montantSpecifique;
}

180
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/solidarite/CommentaireAideDTO.java
View File

@@ -1,17 +1,16 @@
package dev.lions.unionflow.server.api.dto.solidarite;
import jakarta.validation.constraints.*;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.AllArgsConstructor;
import lombok.Builder;
import java.time.LocalDateTime;
import java.util.List;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
/**
* DTO pour les commentaires sur une demande d'aide
*
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
@@ -21,110 +20,67 @@ import java.util.List;
@AllArgsConstructor
@Builder
public class CommentaireAideDTO {
/**
* Identifiant unique du commentaire
*/
private String id;
/**
* Contenu du commentaire
*/
@NotBlank(message = "Le contenu du commentaire est obligatoire")
@Size(min = 5, max = 2000, message = "Le commentaire doit contenir entre 5 et 2000 caractères")
private String contenu;
/**
* Type de commentaire
*/
@NotBlank(message = "Le type de commentaire est obligatoire")
private String typeCommentaire;
/**
* Date de création du commentaire
*/
@NotNull(message = "La date de création est obligatoire")
@Builder.Default
private LocalDateTime dateCreation = LocalDateTime.now();
/**
* Date de dernière modification
*/
private LocalDateTime dateModification;
/**
* Identifiant de l'auteur du commentaire
*/
@NotBlank(message = "L'identifiant de l'auteur est obligatoire")
private String auteurId;
/**
* Nom de l'auteur du commentaire
*/
private String auteurNom;
/**
* Rôle de l'auteur
*/
private String auteurRole;
/**
* Indique si le commentaire est privé (visible seulement aux évaluateurs)
*/
@Builder.Default
private Boolean estPrive = false;
/**
* Indique si le commentaire est important
*/
@Builder.Default
private Boolean estImportant = false;
/**
* Identifiant du commentaire parent (pour les réponses)
*/
private String commentaireParentId;
/**
* Réponses à ce commentaire
*/
private List<CommentaireAideDTO> reponses;
/**
* Pièces jointes au commentaire
*/
private List<PieceJustificativeDTO> piecesJointes;
/**
* Mentions d'utilisateurs dans le commentaire
*/
private List<String> mentionsUtilisateurs;
/**
* Indique si le commentaire a été modifié
*/
@Builder.Default
private Boolean estModifie = false;
/**
* Nombre de likes/réactions
*/
@Builder.Default
private Integer nombreReactions = 0;
/**
* Indique si le commentaire est résolu (pour les questions)
*/
@Builder.Default
private Boolean estResolu = false;
/**
* Date de résolution
*/
private LocalDateTime dateResolution;
/**
* Identifiant de la personne qui a marqué comme résolu
*/
private String resoluteurId;
/** Identifiant unique du commentaire */
private String id;
/** Contenu du commentaire */
@NotBlank(message = "Le contenu du commentaire est obligatoire")
@Size(min = 5, max = 2000, message = "Le commentaire doit contenir entre 5 et 2000 caractères")
private String contenu;
/** Type de commentaire */
@NotBlank(message = "Le type de commentaire est obligatoire")
private String typeCommentaire;
/** Date de création du commentaire */
@NotNull(message = "La date de création est obligatoire")
@Builder.Default
private LocalDateTime dateCreation = LocalDateTime.now();
/** Date de dernière modification */
private LocalDateTime dateModification;
/** Identifiant de l'auteur du commentaire */
@NotBlank(message = "L'identifiant de l'auteur est obligatoire")
private String auteurId;
/** Nom de l'auteur du commentaire */
private String auteurNom;
/** Rôle de l'auteur */
private String auteurRole;
/** Indique si le commentaire est privé (visible seulement aux évaluateurs) */
@Builder.Default private Boolean estPrive = false;
/** Indique si le commentaire est important */
@Builder.Default private Boolean estImportant = false;
/** Identifiant du commentaire parent (pour les réponses) */
private String commentaireParentId;
/** Réponses à ce commentaire */
private List<CommentaireAideDTO> reponses;
/** Pièces jointes au commentaire */
private List<PieceJustificativeDTO> piecesJointes;
/** Mentions d'utilisateurs dans le commentaire */
private List<String> mentionsUtilisateurs;
/** Indique si le commentaire a été modifié */
@Builder.Default private Boolean estModifie = false;
/** Nombre de likes/réactions */
@Builder.Default private Integer nombreReactions = 0;
/** Indique si le commentaire est résolu (pour les questions) */
@Builder.Default private Boolean estResolu = false;
/** Date de résolution */
private LocalDateTime dateResolution;
/** Identifiant de la personne qui a marqué comme résolu */
private String resoluteurId;
}

150
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/solidarite/ContactProposantDTO.java
View File

@@ -1,14 +1,14 @@
package dev.lions.unionflow.server.api.dto.solidarite;
import jakarta.validation.constraints.*;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
/**
* DTO pour les informations de contact du proposant d'aide
*
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
@@ -18,92 +18,60 @@ import lombok.Builder;
@AllArgsConstructor
@Builder
public class ContactProposantDTO {
/**
* Numéro de téléphone principal
*/
@Pattern(regexp = "^\\+?[0-9]{8,15}$", message = "Le numéro de téléphone n'est pas valide")
private String telephonePrincipal;
/**
* Numéro de téléphone secondaire
*/
@Pattern(regexp = "^\\+?[0-9]{8,15}$", message = "Le numéro de téléphone secondaire n'est pas valide")
private String telephoneSecondaire;
/**
* Adresse email
*/
@Email(message = "L'adresse email n'est pas valide")
private String email;
/**
* Adresse email secondaire
*/
@Email(message = "L'adresse email secondaire n'est pas valide")
private String emailSecondaire;
/**
* Identifiant WhatsApp
*/
@Pattern(regexp = "^\\+?[0-9]{8,15}$", message = "Le numéro WhatsApp n'est pas valide")
private String whatsapp;
/**
* Identifiant Telegram
*/
@Size(max = 50, message = "L'identifiant Telegram ne peut pas dépasser 50 caractères")
private String telegram;
/**
* Autres moyens de contact (réseaux sociaux, etc.)
*/
private java.util.Map<String, String> autresContacts;
/**
* Adresse physique pour rencontres
*/
@Size(max = 200, message = "L'adresse ne peut pas dépasser 200 caractères")
private String adressePhysique;
/**
* Indique si les rencontres physiques sont possibles
*/
@Builder.Default
private Boolean rencontresPhysiquesPossibles = false;
/**
* Indique si les appels téléphoniques sont acceptés
*/
@Builder.Default
private Boolean appelsAcceptes = true;
/**
* Indique si les SMS sont acceptés
*/
@Builder.Default
private Boolean smsAcceptes = true;
/**
* Indique si les emails sont acceptés
*/
@Builder.Default
private Boolean emailsAcceptes = true;
/**
* Horaires de disponibilité pour contact
*/
@Size(max = 200, message = "Les horaires ne peuvent pas dépasser 200 caractères")
private String horairesDisponibilite;
/**
* Langue(s) de communication préférée(s)
*/
private java.util.List<String> languesPreferees;
/**
* Instructions spéciales pour le contact
*/
@Size(max = 300, message = "Les instructions ne peuvent pas dépasser 300 caractères")
private String instructionsSpeciales;
/** Numéro de téléphone principal */
@Pattern(regexp = "^\\+?[0-9]{8,15}$", message = "Le numéro de téléphone n'est pas valide")
private String telephonePrincipal;
/** Numéro de téléphone secondaire */
@Pattern(
regexp = "^\\+?[0-9]{8,15}$",
message = "Le numéro de téléphone secondaire n'est pas valide")
private String telephoneSecondaire;
/** Adresse email */
@Email(message = "L'adresse email n'est pas valide")
private String email;
/** Adresse email secondaire */
@Email(message = "L'adresse email secondaire n'est pas valide")
private String emailSecondaire;
/** Identifiant WhatsApp */
@Pattern(regexp = "^\\+?[0-9]{8,15}$", message = "Le numéro WhatsApp n'est pas valide")
private String whatsapp;
/** Identifiant Telegram */
@Size(max = 50, message = "L'identifiant Telegram ne peut pas dépasser 50 caractères")
private String telegram;
/** Autres moyens de contact (réseaux sociaux, etc.) */
private java.util.Map<String, String> autresContacts;
/** Adresse physique pour rencontres */
@Size(max = 200, message = "L'adresse ne peut pas dépasser 200 caractères")
private String adressePhysique;
/** Indique si les rencontres physiques sont possibles */
@Builder.Default private Boolean rencontresPhysiquesPossibles = false;
/** Indique si les appels téléphoniques sont acceptés */
@Builder.Default private Boolean appelsAcceptes = true;
/** Indique si les SMS sont acceptés */
@Builder.Default private Boolean smsAcceptes = true;
/** Indique si les emails sont acceptés */
@Builder.Default private Boolean emailsAcceptes = true;
/** Horaires de disponibilité pour contact */
@Size(max = 200, message = "Les horaires ne peuvent pas dépasser 200 caractères")
private String horairesDisponibilite;
/** Langue(s) de communication préférée(s) */
private java.util.List<String> languesPreferees;
/** Instructions spéciales pour le contact */
@Size(max = 300, message = "Les instructions ne peuvent pas dépasser 300 caractères")
private String instructionsSpeciales;
}

112
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/solidarite/ContactUrgenceDTO.java
View File

@@ -1,14 +1,14 @@
package dev.lions.unionflow.server.api.dto.solidarite;
import jakarta.validation.constraints.*;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
/**
* DTO pour les informations de contact d'urgence
*
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
@@ -18,67 +18,47 @@ import lombok.Builder;
@AllArgsConstructor
@Builder
public class ContactUrgenceDTO {
/**
* Nom complet du contact d'urgence
*/
@NotBlank(message = "Le nom du contact d'urgence est obligatoire")
@Size(max = 100, message = "Le nom ne peut pas dépasser 100 caractères")
private String nomComplet;
/**
* Relation avec le demandeur
*/
@NotBlank(message = "La relation avec le demandeur est obligatoire")
@Size(max = 50, message = "La relation ne peut pas dépasser 50 caractères")
private String relation;
/**
* Numéro de téléphone principal
*/
@NotBlank(message = "Le numéro de téléphone est obligatoire")
@Pattern(regexp = "^\\+?[0-9]{8,15}$", message = "Le numéro de téléphone n'est pas valide")
private String telephonePrincipal;
/**
* Numéro de téléphone secondaire
*/
@Pattern(regexp = "^\\+?[0-9]{8,15}$", message = "Le numéro de téléphone secondaire n'est pas valide")
private String telephoneSecondaire;
/**
* Adresse email
*/
@Email(message = "L'adresse email n'est pas valide")
private String email;
/**
* Adresse physique
*/
@Size(max = 200, message = "L'adresse ne peut pas dépasser 200 caractères")
private String adresse;
/**
* Disponibilité (horaires)
*/
@Size(max = 100, message = "La disponibilité ne peut pas dépasser 100 caractères")
private String disponibilite;
/**
* Indique si ce contact peut prendre des décisions pour le demandeur
*/
@Builder.Default
private Boolean peutPrendreDecisions = false;
/**
* Indique si ce contact doit être notifié automatiquement
*/
@Builder.Default
private Boolean notificationAutomatique = true;
/**
* Commentaires additionnels
*/
@Size(max = 300, message = "Les commentaires ne peuvent pas dépasser 300 caractères")
private String commentaires;
/** Nom complet du contact d'urgence */
@NotBlank(message = "Le nom du contact d'urgence est obligatoire")
@Size(max = 100, message = "Le nom ne peut pas dépasser 100 caractères")
private String nomComplet;
/** Relation avec le demandeur */
@NotBlank(message = "La relation avec le demandeur est obligatoire")
@Size(max = 50, message = "La relation ne peut pas dépasser 50 caractères")
private String relation;
/** Numéro de téléphone principal */
@NotBlank(message = "Le numéro de téléphone est obligatoire")
@Pattern(regexp = "^\\+?[0-9]{8,15}$", message = "Le numéro de téléphone n'est pas valide")
private String telephonePrincipal;
/** Numéro de téléphone secondaire */
@Pattern(
regexp = "^\\+?[0-9]{8,15}$",
message = "Le numéro de téléphone secondaire n'est pas valide")
private String telephoneSecondaire;
/** Adresse email */
@Email(message = "L'adresse email n'est pas valide")
private String email;
/** Adresse physique */
@Size(max = 200, message = "L'adresse ne peut pas dépasser 200 caractères")
private String adresse;
/** Disponibilité (horaires) */
@Size(max = 100, message = "La disponibilité ne peut pas dépasser 100 caractères")
private String disponibilite;
/** Indique si ce contact peut prendre des décisions pour le demandeur */
@Builder.Default private Boolean peutPrendreDecisions = false;
/** Indique si ce contact doit être notifié automatiquement */
@Builder.Default private Boolean notificationAutomatique = true;
/** Commentaires additionnels */
@Size(max = 300, message = "Les commentaires ne peuvent pas dépasser 300 caractères")
private String commentaires;
}

274
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/solidarite/CreneauDisponibiliteDTO.java
View File

@@ -1,18 +1,17 @@
package dev.lions.unionflow.server.api.dto.solidarite;
import jakarta.validation.constraints.*;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.time.DayOfWeek;
import java.time.LocalDate;
import java.time.LocalTime;
import lombok.AllArgsConstructor;
import lombok.Builder;
import java.time.DayOfWeek;
import java.time.LocalTime;
import java.time.LocalDate;
import lombok.Data;
import lombok.NoArgsConstructor;
/**
* DTO pour les créneaux de disponibilité du proposant
*
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
@@ -22,158 +21,117 @@ import java.time.LocalDate;
@AllArgsConstructor
@Builder
public class CreneauDisponibiliteDTO {
/**
* Identifiant unique du créneau
*/
private String id;
/**
* Jour de la semaine (pour créneaux récurrents)
*/
private DayOfWeek jourSemaine;
/**
* Date spécifique (pour créneaux ponctuels)
*/
private LocalDate dateSpecifique;
/**
* Heure de début
*/
@NotNull(message = "L'heure de début est obligatoire")
private LocalTime heureDebut;
/**
* Heure de fin
*/
@NotNull(message = "L'heure de fin est obligatoire")
private LocalTime heureFin;
/**
* Type de créneau
*/
@NotNull(message = "Le type de créneau est obligatoire")
@Builder.Default
private TypeCreneau type = TypeCreneau.RECURRENT;
/**
* Indique si le créneau est actif
*/
@Builder.Default
private Boolean estActif = true;
/**
* Fuseau horaire
*/
@Builder.Default
private String fuseauHoraire = "Africa/Abidjan";
/**
* Commentaires sur le créneau
*/
@Size(max = 200, message = "Les commentaires ne peuvent pas dépasser 200 caractères")
private String commentaires;
/**
* Priorité du créneau (1 = haute, 5 = basse)
*/
@Min(value = 1, message = "La priorité doit être au moins 1")
@Max(value = 5, message = "La priorité ne peut pas dépasser 5")
@Builder.Default
private Integer priorite = 3;
/**
* Durée maximale d'intervention en minutes
*/
@Min(value = 15, message = "La durée doit être au moins 15 minutes")
@Max(value = 480, message = "La durée ne peut pas dépasser 8 heures")
private Integer dureeMaxMinutes;
/**
* Indique si des pauses sont nécessaires
*/
@Builder.Default
private Boolean pausesNecessaires = false;
/**
* Durée des pauses en minutes
*/
@Min(value = 5, message = "La durée de pause doit être au moins 5 minutes")
private Integer dureePauseMinutes;
/**
* Énumération des types de créneaux
*/
public enum TypeCreneau {
RECURRENT("Récurrent"),
PONCTUEL("Ponctuel"),
URGENCE("Urgence"),
FLEXIBLE("Flexible");
private final String libelle;
TypeCreneau(String libelle) {
this.libelle = libelle;
}
public String getLibelle() {
return libelle;
}
/** Identifiant unique du créneau */
private String id;
/** Jour de la semaine (pour créneaux récurrents) */
private DayOfWeek jourSemaine;
/** Date spécifique (pour créneaux ponctuels) */
private LocalDate dateSpecifique;
/** Heure de début */
@NotNull(message = "L'heure de début est obligatoire")
private LocalTime heureDebut;
/** Heure de fin */
@NotNull(message = "L'heure de fin est obligatoire")
private LocalTime heureFin;
/** Type de créneau */
@NotNull(message = "Le type de créneau est obligatoire")
@Builder.Default
private TypeCreneau type = TypeCreneau.RECURRENT;
/** Indique si le créneau est actif */
@Builder.Default private Boolean estActif = true;
/** Fuseau horaire */
@Builder.Default private String fuseauHoraire = "Africa/Abidjan";
/** Commentaires sur le créneau */
@Size(max = 200, message = "Les commentaires ne peuvent pas dépasser 200 caractères")
private String commentaires;
/** Priorité du créneau (1 = haute, 5 = basse) */
@Min(value = 1, message = "La priorité doit être au moins 1")
@Max(value = 5, message = "La priorité ne peut pas dépasser 5")
@Builder.Default
private Integer priorite = 3;
/** Durée maximale d'intervention en minutes */
@Min(value = 15, message = "La durée doit être au moins 15 minutes")
@Max(value = 480, message = "La durée ne peut pas dépasser 8 heures")
private Integer dureeMaxMinutes;
/** Indique si des pauses sont nécessaires */
@Builder.Default private Boolean pausesNecessaires = false;
/** Durée des pauses en minutes */
@Min(value = 5, message = "La durée de pause doit être au moins 5 minutes")
private Integer dureePauseMinutes;
/** Énumération des types de créneaux */
public enum TypeCreneau {
RECURRENT("Récurrent"),
PONCTUEL("Ponctuel"),
URGENCE("Urgence"),
FLEXIBLE("Flexible");
private final String libelle;
TypeCreneau(String libelle) {
this.libelle = libelle;
}
// === MÉTHODES UTILITAIRES ===
/**
* Vérifie si le créneau est valide (heure fin > heure début)
*/
public boolean isValide() {
return heureDebut != null && heureFin != null && heureFin.isAfter(heureDebut);
}
/**
* Calcule la durée du créneau en minutes
*/
public long getDureeMinutes() {
if (!isValide()) return 0;
return java.time.Duration.between(heureDebut, heureFin).toMinutes();
}
/**
* Vérifie si le créneau est disponible à une date donnée
*/
public boolean isDisponibleLe(LocalDate date) {
if (!estActif) return false;
return switch (type) {
case PONCTUEL -> dateSpecifique != null && dateSpecifique.equals(date);
case RECURRENT -> jourSemaine != null && date.getDayOfWeek() == jourSemaine;
case URGENCE, FLEXIBLE -> true;
};
}
/**
* Vérifie si une heure est dans le créneau
*/
public boolean contientHeure(LocalTime heure) {
if (!isValide()) return false;
return !heure.isBefore(heureDebut) && !heure.isAfter(heureFin);
}
/**
* Retourne le libellé du créneau
*/
public String getLibelle() {
StringBuilder sb = new StringBuilder();
if (type == TypeCreneau.RECURRENT && jourSemaine != null) {
sb.append(jourSemaine.name()).append(" ");
} else if (type == TypeCreneau.PONCTUEL && dateSpecifique != null) {
sb.append(dateSpecifique.toString()).append(" ");
}
sb.append(heureDebut.toString()).append(" - ").append(heureFin.toString());
return sb.toString();
return libelle;
}
}
// === MÉTHODES UTILITAIRES ===
/** Vérifie si le créneau est valide (heure fin > heure début) */
public boolean isValide() {
return heureDebut != null && heureFin != null && heureFin.isAfter(heureDebut);
}
/** Calcule la durée du créneau en minutes */
public long getDureeMinutes() {
if (!isValide()) return 0;
return java.time.Duration.between(heureDebut, heureFin).toMinutes();
}
/** Vérifie si le créneau est disponible à une date donnée */
public boolean isDisponibleLe(LocalDate date) {
if (!estActif) return false;
return switch (type) {
case PONCTUEL -> dateSpecifique != null && dateSpecifique.equals(date);
case RECURRENT -> jourSemaine != null && date.getDayOfWeek() == jourSemaine;
case URGENCE, FLEXIBLE -> true;
};
}
/** Vérifie si une heure est dans le créneau */
public boolean contientHeure(LocalTime heure) {
if (!isValide()) return false;
return !heure.isBefore(heureDebut) && !heure.isAfter(heureFin);
}
/** Retourne le libellé du créneau */
public String getLibelle() {
StringBuilder sb = new StringBuilder();
if (type == TypeCreneau.RECURRENT && jourSemaine != null) {
sb.append(jourSemaine.name()).append(" ");
} else if (type == TypeCreneau.PONCTUEL && dateSpecifique != null) {
sb.append(dateSpecifique.toString()).append(" ");
}
sb.append(heureDebut.toString()).append(" - ").append(heureFin.toString());
return sb.toString();
}
}

89
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/solidarite/CritereSelectionDTO.java
View File

@@ -1,14 +1,14 @@
package dev.lions.unionflow.server.api.dto.solidarite;
import jakarta.validation.constraints.*;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
/**
* DTO pour les critères de sélection des bénéficiaires
*
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
@@ -18,54 +18,37 @@ import lombok.Builder;
@AllArgsConstructor
@Builder
public class CritereSelectionDTO {
/**
* Nom du critère
*/
@NotBlank(message = "Le nom du critère est obligatoire")
@Size(max = 100, message = "Le nom ne peut pas dépasser 100 caractères")
private String nom;
/**
* Type de critère (age, situation, localisation, etc.)
*/
@NotBlank(message = "Le type de critère est obligatoire")
private String type;
/**
* Opérateur de comparaison (equals, greater_than, less_than, contains, etc.)
*/
@NotBlank(message = "L'opérateur est obligatoire")
private String operateur;
/**
* Valeur de référence pour la comparaison
*/
@NotBlank(message = "La valeur est obligatoire")
private String valeur;
/**
* Valeur maximale (pour les plages)
*/
private String valeurMax;
/**
* Indique si le critère est obligatoire
*/
@Builder.Default
private Boolean estObligatoire = false;
/**
* Poids du critère dans la sélection (1-10)
*/
@Min(value = 1, message = "Le poids doit être au moins 1")
@Max(value = 10, message = "Le poids ne peut pas dépasser 10")
@Builder.Default
private Integer poids = 5;
/**
* Description du critère
*/
@Size(max = 200, message = "La description ne peut pas dépasser 200 caractères")
private String description;
/** Nom du critère */
@NotBlank(message = "Le nom du critère est obligatoire")
@Size(max = 100, message = "Le nom ne peut pas dépasser 100 caractères")
private String nom;
/** Type de critère (age, situation, localisation, etc.) */
@NotBlank(message = "Le type de critère est obligatoire")
private String type;
/** Opérateur de comparaison (equals, greater_than, less_than, contains, etc.) */
@NotBlank(message = "L'opérateur est obligatoire")
private String operateur;
/** Valeur de référence pour la comparaison */
@NotBlank(message = "La valeur est obligatoire")
private String valeur;
/** Valeur maximale (pour les plages) */
private String valeurMax;
/** Indique si le critère est obligatoire */
@Builder.Default private Boolean estObligatoire = false;
/** Poids du critère dans la sélection (1-10) */
@Min(value = 1, message = "Le poids doit être au moins 1")
@Max(value = 10, message = "Le poids ne peut pas dépasser 10")
@Builder.Default
private Integer poids = 5;
/** Description du critère */
@Size(max = 200, message = "La description ne peut pas dépasser 200 caractères")
private String description;
}

808
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/solidarite/DemandeAideDTO.java
View File

@@ -1,374 +1,468 @@
package dev.lions.unionflow.server.api.dto.solidarite;
import dev.lions.unionflow.server.api.enums.solidarite.TypeAide;
import dev.lions.unionflow.server.api.enums.solidarite.StatutAide;
import com.fasterxml.jackson.annotation.JsonFormat;
import dev.lions.unionflow.server.api.dto.base.BaseDTO;
import dev.lions.unionflow.server.api.enums.solidarite.PrioriteAide;
import jakarta.validation.constraints.*;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.AllArgsConstructor;
import lombok.Builder;
import dev.lions.unionflow.server.api.enums.solidarite.StatutAide;
import dev.lions.unionflow.server.api.enums.solidarite.TypeAide;
import dev.lions.unionflow.server.api.validation.ValidationConstants;
import jakarta.validation.constraints.DecimalMin;
import jakarta.validation.constraints.Digits;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Pattern;
import jakarta.validation.constraints.Size;
import java.math.BigDecimal;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;
import java.util.UUID;
import lombok.EqualsAndHashCode;
import lombok.Getter;
import lombok.Setter;
/**
* DTO pour les demandes d'aide dans le système de solidarité
*
* Ce DTO représente une demande d'aide complète avec toutes les informations
* nécessaires pour le traitement, l'évaluation et le suivi.
*
* DTO unifié pour les demandes d'aide dans le système de solidarité
*
* <p>Ce DTO représente une demande d'aide complète avec toutes les informations nécessaires pour le
* traitement, l'évaluation et le suivi. Remplace l'ancien AideDTO pour une approche unifiée.
*
* @author UnionFlow Team
* @version 1.0
* @version 2.0
* @since 2025-01-16
*/
@Data
@NoArgsConstructor
@AllArgsConstructor
@Builder
public class DemandeAideDTO {
// === IDENTIFICATION ===
/**
* Identifiant unique de la demande d'aide
*/
private String id;
/**
* Numéro de référence de la demande (généré automatiquement)
*/
@Pattern(regexp = "^DA-\\d{4}-\\d{6}$", message = "Le numéro de référence doit suivre le format DA-YYYY-NNNNNN")
private String numeroReference;
// === INFORMATIONS DE BASE ===
/**
* Type d'aide demandée
*/
@NotNull(message = "Le type d'aide est obligatoire")
private TypeAide typeAide;
/**
* Titre court de la demande
*/
@NotBlank(message = "Le titre est obligatoire")
@Size(min = 10, max = 100, message = "Le titre doit contenir entre 10 et 100 caractères")
private String titre;
/**
* Description détaillée de la demande
*/
@NotBlank(message = "La description est obligatoire")
@Size(min = 50, max = 2000, message = "La description doit contenir entre 50 et 2000 caractères")
private String description;
/**
* Justification de la demande
*/
@Size(max = 1000, message = "La justification ne peut pas dépasser 1000 caractères")
private String justification;
// === MONTANT ET FINANCES ===
/**
* Montant demandé (si applicable)
*/
@DecimalMin(value = "0.0", inclusive = false, message = "Le montant doit être positif")
@DecimalMax(value = "1000000.0", message = "Le montant ne peut pas dépasser 1 000 000 FCFA")
private Double montantDemande;
/**
* Montant approuvé (si différent du montant demandé)
*/
@DecimalMin(value = "0.0", inclusive = false, message = "Le montant approuvé doit être positif")
private Double montantApprouve;
/**
* Montant versé effectivement
*/
@DecimalMin(value = "0.0", inclusive = false, message = "Le montant versé doit être positif")
private Double montantVerse;
/**
* Devise du montant
*/
@Builder.Default
private String devise = "FCFA";
// === ACTEURS ===
/**
* Identifiant du demandeur
*/
@NotBlank(message = "L'identifiant du demandeur est obligatoire")
private String demandeurId;
/**
* Nom complet du demandeur
*/
private String demandeurNom;
/**
* Identifiant de l'évaluateur assigné
*/
private String evaluateurId;
/**
* Nom de l'évaluateur
*/
private String evaluateurNom;
/**
* Identifiant de l'approbateur
*/
private String approvateurId;
/**
* Nom de l'approbateur
*/
private String approvateurNom;
/**
* Identifiant de l'organisation
*/
@NotBlank(message = "L'identifiant de l'organisation est obligatoire")
private String organisationId;
// === STATUT ET PRIORITÉ ===
/**
* Statut actuel de la demande
*/
@NotNull(message = "Le statut est obligatoire")
@Builder.Default
private StatutAide statut = StatutAide.BROUILLON;
/**
* Priorité de la demande
*/
@NotNull(message = "La priorité est obligatoire")
@Builder.Default
private PrioriteAide priorite = PrioriteAide.NORMALE;
/**
* Motif de rejet (si applicable)
*/
@Size(max = 500, message = "Le motif de rejet ne peut pas dépasser 500 caractères")
private String motifRejet;
/**
* Commentaires de l'évaluateur
*/
@Size(max = 1000, message = "Les commentaires ne peuvent pas dépasser 1000 caractères")
private String commentairesEvaluateur;
// === DATES ===
/**
* Date de création de la demande
*/
@NotNull(message = "La date de création est obligatoire")
@Builder.Default
private LocalDateTime dateCreation = LocalDateTime.now();
/**
* Date de soumission de la demande
*/
private LocalDateTime dateSoumission;
/**
* Date limite de traitement
*/
private LocalDateTime dateLimiteTraitement;
/**
* Date d'évaluation
*/
private LocalDateTime dateEvaluation;
/**
* Date d'approbation
*/
private LocalDateTime dateApprobation;
/**
* Date de versement
*/
private LocalDateTime dateVersement;
/**
* Date de clôture
*/
private LocalDateTime dateCloture;
/**
* Date de dernière modification
*/
@Builder.Default
private LocalDateTime dateModification = LocalDateTime.now();
// === INFORMATIONS COMPLÉMENTAIRES ===
/**
* Pièces justificatives attachées
*/
private List<PieceJustificativeDTO> piecesJustificatives;
/**
* Bénéficiaires de l'aide (si différents du demandeur)
*/
private List<BeneficiaireAideDTO> beneficiaires;
/**
* Historique des changements de statut
*/
private List<HistoriqueStatutDTO> historiqueStatuts;
/**
* Commentaires et échanges
*/
private List<CommentaireAideDTO> commentaires;
/**
* Données personnalisées spécifiques au type d'aide
*/
private Map<String, Object> donneesPersonnalisees;
/**
* Tags pour catégorisation
*/
private List<String> tags;
// === MÉTADONNÉES ===
/**
* Indique si la demande est confidentielle
*/
@Builder.Default
private Boolean estConfidentielle = false;
/**
* Indique si la demande nécessite un suivi
*/
@Builder.Default
private Boolean necessiteSuivi = false;
/**
* Score de priorité calculé automatiquement
*/
private Double scorePriorite;
/**
* Nombre de vues de la demande
*/
@Builder.Default
private Integer nombreVues = 0;
/**
* Version du document (pour gestion des conflits)
*/
@Builder.Default
private Integer version = 1;
/**
* Informations de géolocalisation (si pertinent)
*/
private LocalisationDTO localisation;
/**
* Informations de contact d'urgence
*/
private ContactUrgenceDTO contactUrgence;
// === MÉTHODES UTILITAIRES ===
/**
* Vérifie si la demande est modifiable
*/
public boolean isModifiable() {
return statut != null && statut.permetModification();
@Getter
@Setter
@EqualsAndHashCode(callSuper = true)
public class DemandeAideDTO extends BaseDTO {
private static final long serialVersionUID = 1L;
// === IDENTIFICATION ===
// ID hérité de BaseDTO
/** Numéro de référence de la demande (généré automatiquement) */
@Pattern(
regexp = ValidationConstants.REFERENCE_AIDE_PATTERN,
message = ValidationConstants.REFERENCE_AIDE_MESSAGE)
private String numeroReference;
// === INFORMATIONS DE BASE ===
/** Type d'aide demandée */
@NotNull(message = "Le type d'aide est obligatoire.")
private TypeAide typeAide;
/** Titre court de la demande */
@NotBlank(message = "Le titre" + ValidationConstants.OBLIGATOIRE_MESSAGE)
@Size(
min = ValidationConstants.TITRE_MIN_LENGTH,
max = ValidationConstants.TITRE_MAX_LENGTH,
message = ValidationConstants.TITRE_SIZE_MESSAGE)
private String titre;
/** Description détaillée de la demande */
@NotBlank(message = "La description" + ValidationConstants.OBLIGATOIRE_MESSAGE)
@Size(
min = ValidationConstants.DESCRIPTION_MIN_LENGTH,
max = ValidationConstants.DESCRIPTION_MAX_LENGTH,
message = ValidationConstants.DESCRIPTION_SIZE_MESSAGE)
private String description;
/** Justification de la demande */
@Size(
max = ValidationConstants.JUSTIFICATION_MAX_LENGTH,
message = ValidationConstants.JUSTIFICATION_SIZE_MESSAGE)
private String justification;
// === MONTANT ET FINANCES ===
/** Montant demandé (si applicable) */
@DecimalMin(
value = ValidationConstants.MONTANT_MIN_VALUE,
inclusive = false,
message = ValidationConstants.MONTANT_POSITIF_MESSAGE)
@Digits(
integer = ValidationConstants.MONTANT_INTEGER_DIGITS,
fraction = ValidationConstants.MONTANT_FRACTION_DIGITS,
message = ValidationConstants.MONTANT_DIGITS_MESSAGE)
private BigDecimal montantDemande;
/** Montant approuvé (si différent du montant demandé) */
@DecimalMin(
value = ValidationConstants.MONTANT_MIN_VALUE,
inclusive = false,
message = ValidationConstants.MONTANT_POSITIF_MESSAGE)
@Digits(
integer = ValidationConstants.MONTANT_INTEGER_DIGITS,
fraction = ValidationConstants.MONTANT_FRACTION_DIGITS,
message = ValidationConstants.MONTANT_DIGITS_MESSAGE)
private BigDecimal montantApprouve;
/** Montant versé effectivement */
@DecimalMin(
value = ValidationConstants.MONTANT_MIN_VALUE,
inclusive = false,
message = ValidationConstants.MONTANT_POSITIF_MESSAGE)
@Digits(
integer = ValidationConstants.MONTANT_INTEGER_DIGITS,
fraction = ValidationConstants.MONTANT_FRACTION_DIGITS,
message = ValidationConstants.MONTANT_DIGITS_MESSAGE)
private BigDecimal montantVerse;
/** Devise du montant (code ISO 3 lettres) */
@Pattern(
regexp = ValidationConstants.DEVISE_PATTERN,
message = ValidationConstants.DEVISE_MESSAGE)
private String devise = "XOF";
// === ACTEURS ===
/** Identifiant du demandeur (UUID) */
@NotNull(message = "L'identifiant du demandeur est obligatoire")
private UUID membreDemandeurId;
/** Nom complet du demandeur */
private String nomDemandeur;
/** Numéro de membre du demandeur */
private String numeroMembreDemandeur;
/** Identifiant de l'évaluateur assigné */
private String evaluateurId;
/** Nom de l'évaluateur */
private String evaluateurNom;
/** Identifiant de l'approbateur */
private String approvateurId;
/** Nom de l'approbateur */
private String approvateurNom;
/** Identifiant de l'organisation (UUID) */
@NotNull(message = "L'identifiant de l'organisation est obligatoire")
private UUID associationId;
/** Nom de l'association */
private String nomAssociation;
// === STATUT ET PRIORITÉ ===
/** Statut actuel de la demande */
@NotNull(message = "Le statut est obligatoire")
private StatutAide statut = StatutAide.BROUILLON;
/** Priorité de la demande */
@NotNull(message = "La priorité est obligatoire")
private PrioriteAide priorite = PrioriteAide.NORMALE;
/** Motif de rejet (si applicable) */
@Size(max = 500, message = "Le motif de rejet ne peut pas dépasser 500 caractères")
private String motifRejet;
/** Commentaires de l'évaluateur */
@Size(max = 1000, message = "Les commentaires ne peuvent pas dépasser 1000 caractères")
private String commentairesEvaluateur;
// === DATES ===
// Date de création héritée de BaseDTO
/** Date de soumission de la demande */
private LocalDateTime dateSoumission;
/** Date limite de traitement */
private LocalDateTime dateLimiteTraitement;
/** Date d'évaluation */
private LocalDateTime dateEvaluation;
/** Date d'approbation */
private LocalDateTime dateApprobation;
/** Date de versement */
private LocalDateTime dateVersement;
/** Date de clôture */
private LocalDateTime dateCloture;
// Date de modification héritée de BaseDTO
// === INFORMATIONS COMPLÉMENTAIRES ===
/** Pièces justificatives attachées */
private List<PieceJustificativeDTO> piecesJustificatives;
/** Bénéficiaires de l'aide (si différents du demandeur) */
private List<BeneficiaireAideDTO> beneficiaires;
/** Historique des changements de statut */
private List<HistoriqueStatutDTO> historiqueStatuts;
/** Commentaires et échanges */
private List<CommentaireAideDTO> commentaires;
/** Données personnalisées spécifiques au type d'aide */
private Map<String, Object> donneesPersonnalisees;
/** Tags pour catégorisation */
private List<String> tags;
// === MÉTADONNÉES ===
/** Indique si la demande est confidentielle */
private Boolean estConfidentielle = false;
/** Indique si la demande nécessite un suivi */
private Boolean necessiteSuivi = false;
/** Score de priorité calculé automatiquement */
private Double scorePriorite;
/** Nombre de vues de la demande */
private Integer nombreVues = 0;
// Version héritée de BaseDTO
/** Informations de géolocalisation (si pertinent) */
private LocalisationDTO localisation;
/** Informations de contact d'urgence */
private ContactUrgenceDTO contactUrgence;
// === CHAMPS ADDITIONNELS D'AIDE ===
/** Date limite pour l'aide */
@JsonFormat(pattern = "yyyy-MM-dd")
private LocalDate dateLimite;
/** Justificatifs fournis */
private Boolean justificatifsFournis = false;
/** Liste des documents joints (noms de fichiers) */
@Size(max = 1000, message = "La liste des documents ne peut pas dépasser 1000 caractères")
private String documentsJoints;
/** Date de début de l'aide */
@JsonFormat(pattern = "yyyy-MM-dd")
private LocalDate dateDebutAide;
/** Date de fin de l'aide */
@JsonFormat(pattern = "yyyy-MM-dd")
private LocalDate dateFinAide;
/** Identifiant du membre aidant */
private UUID membreAidantId;
/** Nom du membre aidant */
private String nomAidant;
/** Mode de versement */
@Size(max = 50, message = "Le mode de versement ne peut pas dépasser 50 caractères")
private String modeVersement;
/** Numéro de transaction */
@Size(max = 100, message = "Le numéro de transaction ne peut pas dépasser 100 caractères")
private String numeroTransaction;
/** Identifiant de celui qui a rejeté */
private UUID rejeteParId;
/** Nom de celui qui a rejeté */
private String rejetePar;
/** Date de rejet */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateRejet;
/** Raison du rejet (si applicable) */
@Size(max = 500, message = "La raison du rejet ne peut pas dépasser 500 caractères")
private String raisonRejet;
// === CONSTRUCTEURS ===
/** Constructeur par défaut */
public DemandeAideDTO() {
super(); // Appelle le constructeur de BaseDTO qui génère l'UUID
this.statut = StatutAide.EN_ATTENTE;
this.priorite = PrioriteAide.NORMALE;
this.devise = "XOF";
this.nombreVues = 0;
this.numeroReference = genererNumeroReference();
}
// === MÉTHODES UTILITAIRES ===
/** Vérifie si la demande est modifiable */
public boolean estModifiable() {
return statut != null && statut.permetModification();
}
/** Vérifie si la demande peut être annulée */
public boolean peutEtreAnnulee() {
return statut != null && statut.permetAnnulation();
}
/** Vérifie si la demande est urgente */
public boolean estUrgente() {
return priorite != null && priorite.isUrgente();
}
/** Vérifie si la demande est terminée */
public boolean estTerminee() {
return statut != null && statut.isEstFinal();
}
/** Vérifie si la demande est en succès */
public boolean estEnSucces() {
return statut != null && statut.isSucces();
}
/** Calcule le pourcentage d'avancement */
public double getPourcentageAvancement() {
if (statut == null) {
return 0.0;
}
/**
* Vérifie si la demande peut être annulée
*/
public boolean peutEtreAnnulee() {
return statut != null && statut.permetAnnulation();
return switch (statut) {
case BROUILLON -> 5.0;
case SOUMISE -> 10.0;
case EN_ATTENTE -> 20.0;
case EN_COURS_EVALUATION -> 40.0;
case INFORMATIONS_REQUISES -> 35.0;
case APPROUVEE, APPROUVEE_PARTIELLEMENT -> 60.0;
case EN_COURS_TRAITEMENT -> 70.0;
case EN_COURS_VERSEMENT -> 85.0;
case VERSEE, LIVREE, TERMINEE -> 100.0;
case REJETEE, ANNULEE, EXPIREE -> 100.0;
case SUSPENDUE -> 50.0;
case EN_SUIVI -> 95.0;
case CLOTUREE -> 100.0;
};
}
/** Retourne le délai restant en heures */
public long getDelaiRestantHeures() {
if (dateLimiteTraitement == null) {
return -1;
}
/**
* Vérifie si la demande est urgente
*/
public boolean isUrgente() {
return priorite != null && priorite.isUrgente();
LocalDateTime maintenant = LocalDateTime.now();
if (maintenant.isAfter(dateLimiteTraitement)) {
return 0;
}
/**
* Vérifie si la demande est terminée
*/
public boolean isTerminee() {
return statut != null && statut.isEstFinal();
return java.time.Duration.between(maintenant, dateLimiteTraitement).toHours();
}
/** Vérifie si le délai est dépassé */
public boolean estDelaiDepasse() {
return getDelaiRestantHeures() == 0;
}
/** Retourne la durée de traitement en jours */
public long getDureeTraitementJours() {
if (dateCreation == null) {
return 0;
}
/**
* Vérifie si la demande est en succès
*/
public boolean isEnSucces() {
return statut != null && statut.isSucces();
}
/**
* Calcule le pourcentage d'avancement
*/
public double getPourcentageAvancement() {
if (statut == null) return 0.0;
return switch (statut) {
case BROUILLON -> 5.0;
case SOUMISE -> 10.0;
case EN_ATTENTE -> 20.0;
case EN_COURS_EVALUATION -> 40.0;
case INFORMATIONS_REQUISES -> 35.0;
case APPROUVEE, APPROUVEE_PARTIELLEMENT -> 60.0;
case EN_COURS_TRAITEMENT -> 70.0;
case EN_COURS_VERSEMENT -> 85.0;
case VERSEE, LIVREE, TERMINEE -> 100.0;
case REJETEE, ANNULEE, EXPIREE -> 100.0;
case SUSPENDUE -> 50.0;
case EN_SUIVI -> 95.0;
case CLOTUREE -> 100.0;
};
}
/**
* Retourne le délai restant en heures
*/
public long getDelaiRestantHeures() {
if (dateLimiteTraitement == null) return -1;
LocalDateTime maintenant = LocalDateTime.now();
if (maintenant.isAfter(dateLimiteTraitement)) return 0;
return java.time.Duration.between(maintenant, dateLimiteTraitement).toHours();
}
/**
* Vérifie si le délai est dépassé
*/
public boolean isDelaiDepasse() {
return getDelaiRestantHeures() == 0;
}
/**
* Retourne la durée de traitement en jours
*/
public long getDureeTraitementJours() {
if (dateCreation == null) return 0;
LocalDateTime dateFin = dateCloture != null ? dateCloture : LocalDateTime.now();
return java.time.Duration.between(dateCreation, dateFin).toDays();
LocalDateTime dateFin = dateCloture != null ? dateCloture : LocalDateTime.now();
return java.time.Duration.between(dateCreation, dateFin).toDays();
}
// === MÉTHODES MÉTIER D'AIDE ===
/** Retourne le libellé du statut */
public String getStatutLibelle() {
return statut != null ? statut.getLibelle() : "Non défini";
}
/** Retourne le libellé de la priorité */
public String getPrioriteLibelle() {
return priorite != null ? priorite.getLibelle() : "Normale";
}
/** Approuve la demande d'aide */
public void approuver(
UUID evaluateurId, String nomEvaluateur, BigDecimal montantApprouve, String commentaires) {
this.statut = StatutAide.APPROUVEE;
this.evaluateurId = evaluateurId.toString();
this.evaluateurNom = nomEvaluateur;
this.montantApprouve = montantApprouve;
this.commentairesEvaluateur = commentaires;
this.dateEvaluation = LocalDateTime.now();
this.dateApprobation = LocalDateTime.now();
marquerCommeModifie(nomEvaluateur);
}
/** Rejette la demande d'aide */
public void rejeter(UUID evaluateurId, String nomEvaluateur, String raison) {
this.statut = StatutAide.REJETEE;
this.rejeteParId = evaluateurId;
this.rejetePar = nomEvaluateur;
this.raisonRejet = raison;
this.dateRejet = LocalDateTime.now();
this.dateEvaluation = LocalDateTime.now();
marquerCommeModifie(nomEvaluateur);
}
/** Démarre l'aide */
public void demarrerAide(UUID aidantId, String nomAidant) {
this.statut = StatutAide.EN_COURS_TRAITEMENT;
this.membreAidantId = aidantId;
this.nomAidant = nomAidant;
this.dateDebutAide = LocalDate.now();
marquerCommeModifie(nomAidant);
}
/** Termine l'aide avec versement */
public void terminerAvecVersement(
BigDecimal montantVerse, String modeVersement, String numeroTransaction) {
this.statut = StatutAide.TERMINEE;
this.montantVerse = montantVerse;
this.modeVersement = modeVersement;
this.numeroTransaction = numeroTransaction;
this.dateVersement = LocalDateTime.now();
this.dateFinAide = LocalDate.now();
marquerCommeModifie("SYSTEM");
}
/** Incrémente le nombre de vues */
public void incrementerVues() {
if (nombreVues == null) {
nombreVues = 1;
} else {
nombreVues++;
}
}
/** Génère un numéro de référence unique */
public static String genererNumeroReference() {
return "DA-"
+ LocalDate.now().getYear()
+ "-"
+ String.format("%06d", (int) (Math.random() * 1000000));
}
// === GETTERS EXPLICITES POUR COMPATIBILITÉ ===
/** Retourne le type d'aide demandée */
public TypeAide getTypeAide() {
return typeAide;
}
/** Retourne le montant demandé */
public BigDecimal getMontantDemande() {
return montantDemande;
}
/** Marque comme modifié */
public void marquerCommeModifie(String utilisateur) {
LocalDateTime maintenant = LocalDateTime.now();
this.dateModification = maintenant;
super.marquerCommeModifie(utilisateur);
}
}

555
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/solidarite/EvaluationAideDTO.java
View File

@@ -1,18 +1,17 @@
package dev.lions.unionflow.server.api.dto.solidarite;
import jakarta.validation.constraints.*;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.AllArgsConstructor;
import lombok.Builder;
import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
/**
* DTO pour l'évaluation d'une aide reçue ou fournie
*
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
@@ -22,326 +21,236 @@ import java.util.Map;
@AllArgsConstructor
@Builder
public class EvaluationAideDTO {
/**
* Identifiant unique de l'évaluation
*/
private String id;
/**
* Identifiant de la demande d'aide évaluée
*/
@NotBlank(message = "L'identifiant de la demande d'aide est obligatoire")
private String demandeAideId;
/**
* Identifiant de la proposition d'aide évaluée (si applicable)
*/
private String propositionAideId;
/**
* Identifiant de l'évaluateur
*/
@NotBlank(message = "L'identifiant de l'évaluateur est obligatoire")
private String evaluateurId;
/**
* Nom de l'évaluateur
*/
private String evaluateurNom;
/**
* Rôle de l'évaluateur (beneficiaire, proposant, evaluateur_externe)
*/
@NotBlank(message = "Le rôle de l'évaluateur est obligatoire")
private String roleEvaluateur;
/**
* Type d'évaluation
*/
@NotNull(message = "Le type d'évaluation est obligatoire")
@Builder.Default
private TypeEvaluation typeEvaluation = TypeEvaluation.SATISFACTION_BENEFICIAIRE;
/**
* Note globale (1-5)
*/
@NotNull(message = "La note globale est obligatoire")
@DecimalMin(value = "1.0", message = "La note doit être au moins 1")
@DecimalMax(value = "5.0", message = "La note ne peut pas dépasser 5")
private Double noteGlobale;
/**
* Notes détaillées par critère
*/
private Map<String, Double> notesDetaillees;
/**
* Commentaire principal
*/
@Size(min = 10, max = 1000, message = "Le commentaire doit contenir entre 10 et 1000 caractères")
private String commentairePrincipal;
/**
* Points positifs
*/
@Size(max = 500, message = "Les points positifs ne peuvent pas dépasser 500 caractères")
private String pointsPositifs;
/**
* Points d'amélioration
*/
@Size(max = 500, message = "Les points d'amélioration ne peuvent pas dépasser 500 caractères")
private String pointsAmelioration;
/**
* Recommandations
*/
@Size(max = 500, message = "Les recommandations ne peuvent pas dépasser 500 caractères")
private String recommandations;
/**
* Indique si l'évaluateur recommande cette aide/proposant
*/
@Builder.Default
private Boolean recommande = true;
/**
* Indique si l'aide a été utile
*/
@Builder.Default
private Boolean aideUtile = true;
/**
* Indique si l'aide a résolu le problème
*/
@Builder.Default
private Boolean problemeResolu = true;
/**
* Délai de réponse perçu (1=très lent, 5=très rapide)
*/
@DecimalMin(value = "1.0", message = "La note délai doit être au moins 1")
@DecimalMax(value = "5.0", message = "La note délai ne peut pas dépasser 5")
private Double noteDelaiReponse;
/**
* Qualité de la communication (1=très mauvaise, 5=excellente)
*/
@DecimalMin(value = "1.0", message = "La note communication doit être au moins 1")
@DecimalMax(value = "5.0", message = "La note communication ne peut pas dépasser 5")
private Double noteCommunication;
/**
* Professionnalisme (1=très mauvais, 5=excellent)
*/
@DecimalMin(value = "1.0", message = "La note professionnalisme doit être au moins 1")
@DecimalMax(value = "5.0", message = "La note professionnalisme ne peut pas dépasser 5")
private Double noteProfessionnalisme;
/**
* Respect des engagements (1=très mauvais, 5=excellent)
*/
@DecimalMin(value = "1.0", message = "La note engagement doit être au moins 1")
@DecimalMax(value = "5.0", message = "La note engagement ne peut pas dépasser 5")
private Double noteRespectEngagements;
/**
* Date de création de l'évaluation
*/
@NotNull(message = "La date de création est obligatoire")
@Builder.Default
private LocalDateTime dateCreation = LocalDateTime.now();
/**
* Date de dernière modification
*/
@Builder.Default
private LocalDateTime dateModification = LocalDateTime.now();
/**
* Indique si l'évaluation est publique
*/
@Builder.Default
private Boolean estPublique = true;
/**
* Indique si l'évaluation est anonyme
*/
@Builder.Default
private Boolean estAnonyme = false;
/**
* Indique si l'évaluation a été vérifiée
*/
@Builder.Default
private Boolean estVerifiee = false;
/**
* Date de vérification
*/
private LocalDateTime dateVerification;
/**
* Identifiant du vérificateur
*/
private String verificateurId;
/**
* Pièces jointes à l'évaluation (photos, documents)
*/
private List<PieceJustificativeDTO> piecesJointes;
/**
* Tags associés à l'évaluation
*/
private List<String> tags;
/**
* Données additionnelles
*/
private Map<String, Object> donneesAdditionnelles;
/**
* Nombre de personnes qui ont trouvé cette évaluation utile
*/
@Builder.Default
private Integer nombreUtile = 0;
/**
* Nombre de signalements de cette évaluation
*/
@Builder.Default
private Integer nombreSignalements = 0;
/**
* Statut de l'évaluation
*/
@NotNull(message = "Le statut est obligatoire")
@Builder.Default
private StatutEvaluation statut = StatutEvaluation.ACTIVE;
/**
* Énumération des types d'évaluation
*/
public enum TypeEvaluation {
SATISFACTION_BENEFICIAIRE("Satisfaction du bénéficiaire"),
EVALUATION_PROPOSANT("Évaluation du proposant"),
EVALUATION_PROCESSUS("Évaluation du processus"),
SUIVI_POST_AIDE("Suivi post-aide"),
EVALUATION_IMPACT("Évaluation d'impact"),
RETOUR_EXPERIENCE("Retour d'expérience");
private final String libelle;
TypeEvaluation(String libelle) {
this.libelle = libelle;
}
public String getLibelle() {
return libelle;
}
/** Identifiant unique de l'évaluation */
private String id;
/** Identifiant de la demande d'aide évaluée */
@NotBlank(message = "L'identifiant de la demande d'aide est obligatoire")
private String demandeAideId;
/** Identifiant de la proposition d'aide évaluée (si applicable) */
private String propositionAideId;
/** Identifiant de l'évaluateur */
@NotBlank(message = "L'identifiant de l'évaluateur est obligatoire")
private String evaluateurId;
/** Nom de l'évaluateur */
private String evaluateurNom;
/** Rôle de l'évaluateur (beneficiaire, proposant, evaluateur_externe) */
@NotBlank(message = "Le rôle de l'évaluateur est obligatoire")
private String roleEvaluateur;
/** Type d'évaluation */
@NotNull(message = "Le type d'évaluation est obligatoire")
@Builder.Default
private TypeEvaluation typeEvaluation = TypeEvaluation.SATISFACTION_BENEFICIAIRE;
/** Note globale (1-5) */
@NotNull(message = "La note globale est obligatoire")
@DecimalMin(value = "1.0", message = "La note doit être au moins 1")
@DecimalMax(value = "5.0", message = "La note ne peut pas dépasser 5")
private Double noteGlobale;
/** Notes détaillées par critère */
private Map<String, Double> notesDetaillees;
/** Commentaire principal */
@Size(min = 10, max = 1000, message = "Le commentaire doit contenir entre 10 et 1000 caractères")
private String commentairePrincipal;
/** Points positifs */
@Size(max = 500, message = "Les points positifs ne peuvent pas dépasser 500 caractères")
private String pointsPositifs;
/** Points d'amélioration */
@Size(max = 500, message = "Les points d'amélioration ne peuvent pas dépasser 500 caractères")
private String pointsAmelioration;
/** Recommandations */
@Size(max = 500, message = "Les recommandations ne peuvent pas dépasser 500 caractères")
private String recommandations;
/** Indique si l'évaluateur recommande cette aide/proposant */
@Builder.Default private Boolean recommande = true;
/** Indique si l'aide a été utile */
@Builder.Default private Boolean aideUtile = true;
/** Indique si l'aide a résolu le problème */
@Builder.Default private Boolean problemeResolu = true;
/** Délai de réponse perçu (1=très lent, 5=très rapide) */
@DecimalMin(value = "1.0", message = "La note délai doit être au moins 1")
@DecimalMax(value = "5.0", message = "La note délai ne peut pas dépasser 5")
private Double noteDelaiReponse;
/** Qualité de la communication (1=très mauvaise, 5=excellente) */
@DecimalMin(value = "1.0", message = "La note communication doit être au moins 1")
@DecimalMax(value = "5.0", message = "La note communication ne peut pas dépasser 5")
private Double noteCommunication;
/** Professionnalisme (1=très mauvais, 5=excellent) */
@DecimalMin(value = "1.0", message = "La note professionnalisme doit être au moins 1")
@DecimalMax(value = "5.0", message = "La note professionnalisme ne peut pas dépasser 5")
private Double noteProfessionnalisme;
/** Respect des engagements (1=très mauvais, 5=excellent) */
@DecimalMin(value = "1.0", message = "La note engagement doit être au moins 1")
@DecimalMax(value = "5.0", message = "La note engagement ne peut pas dépasser 5")
private Double noteRespectEngagements;
/** Date de création de l'évaluation */
@NotNull(message = "La date de création est obligatoire")
@Builder.Default
private LocalDateTime dateCreation = LocalDateTime.now();
/** Date de dernière modification */
@Builder.Default private LocalDateTime dateModification = LocalDateTime.now();
/** Indique si l'évaluation est publique */
@Builder.Default private Boolean estPublique = true;
/** Indique si l'évaluation est anonyme */
@Builder.Default private Boolean estAnonyme = false;
/** Indique si l'évaluation a été vérifiée */
@Builder.Default private Boolean estVerifiee = false;
/** Date de vérification */
private LocalDateTime dateVerification;
/** Identifiant du vérificateur */
private String verificateurId;
/** Pièces jointes à l'évaluation (photos, documents) */
private List<PieceJustificativeDTO> piecesJointes;
/** Tags associés à l'évaluation */
private List<String> tags;
/** Données additionnelles */
private Map<String, Object> donneesAdditionnelles;
/** Nombre de personnes qui ont trouvé cette évaluation utile */
@Builder.Default private Integer nombreUtile = 0;
/** Nombre de signalements de cette évaluation */
@Builder.Default private Integer nombreSignalements = 0;
/** Statut de l'évaluation */
@NotNull(message = "Le statut est obligatoire")
@Builder.Default
private StatutEvaluation statut = StatutEvaluation.ACTIVE;
/** Énumération des types d'évaluation */
public enum TypeEvaluation {
SATISFACTION_BENEFICIAIRE("Satisfaction du bénéficiaire"),
EVALUATION_PROPOSANT("Évaluation du proposant"),
EVALUATION_PROCESSUS("Évaluation du processus"),
SUIVI_POST_AIDE("Suivi post-aide"),
EVALUATION_IMPACT("Évaluation d'impact"),
RETOUR_EXPERIENCE("Retour d'expérience");
private final String libelle;
TypeEvaluation(String libelle) {
this.libelle = libelle;
}
/**
* Énumération des statuts d'évaluation
*/
public enum StatutEvaluation {
BROUILLON("Brouillon"),
ACTIVE("Active"),
MASQUEE("Masquée"),
SIGNALEE("Signalée"),
SUPPRIMEE("Supprimée");
private final String libelle;
StatutEvaluation(String libelle) {
this.libelle = libelle;
}
public String getLibelle() {
return libelle;
}
public String getLibelle() {
return libelle;
}
// === MÉTHODES UTILITAIRES ===
/**
* Calcule la note moyenne des critères détaillés
*/
public Double getNoteMoyenneDetaillees() {
if (notesDetaillees == null || notesDetaillees.isEmpty()) {
return noteGlobale;
}
return notesDetaillees.values().stream()
.mapToDouble(Double::doubleValue)
.average()
.orElse(noteGlobale);
}
/** Énumération des statuts d'évaluation */
public enum StatutEvaluation {
BROUILLON("Brouillon"),
ACTIVE("Active"),
MASQUEE("Masquée"),
SIGNALEE("Signalée"),
SUPPRIMEE("Supprimée");
private final String libelle;
StatutEvaluation(String libelle) {
this.libelle = libelle;
}
/**
* Vérifie si l'évaluation est positive (note >= 4)
*/
public boolean isPositive() {
return noteGlobale != null && noteGlobale >= 4.0;
public String getLibelle() {
return libelle;
}
/**
* Vérifie si l'évaluation est négative (note <= 2)
*/
public boolean isNegative() {
return noteGlobale != null && noteGlobale <= 2.0;
}
/**
* Calcule un score de qualité global
*/
public double getScoreQualite() {
double score = noteGlobale != null ? noteGlobale : 0.0;
// Bonus pour les notes détaillées
if (noteDelaiReponse != null) score += noteDelaiReponse * 0.1;
if (noteCommunication != null) score += noteCommunication * 0.1;
if (noteProfessionnalisme != null) score += noteProfessionnalisme * 0.1;
if (noteRespectEngagements != null) score += noteRespectEngagements * 0.1;
// Bonus pour recommandation
if (recommande != null && recommande) score += 0.2;
// Bonus pour résolution du problème
if (problemeResolu != null && problemeResolu) score += 0.3;
// Malus pour signalements
if (nombreSignalements > 0) score -= nombreSignalements * 0.1;
return Math.min(5.0, Math.max(0.0, score));
}
/**
* Vérifie si l'évaluation est complète
*/
public boolean isComplete() {
return noteGlobale != null &&
commentairePrincipal != null && !commentairePrincipal.trim().isEmpty() &&
recommande != null &&
aideUtile != null &&
problemeResolu != null;
}
/**
* Retourne le niveau de satisfaction
*/
public String getNiveauSatisfaction() {
if (noteGlobale == null) return "Non évalué";
return switch (noteGlobale.intValue()) {
case 5 -> "Excellent";
case 4 -> "Très bien";
case 3 -> "Bien";
case 2 -> "Passable";
case 1 -> "Insuffisant";
default -> "Non évalué";
};
}
// === MÉTHODES UTILITAIRES ===
/** Calcule la note moyenne des critères détaillés */
public Double getNoteMoyenneDetaillees() {
if (notesDetaillees == null || notesDetaillees.isEmpty()) {
return noteGlobale;
}
return notesDetaillees.values().stream()
.mapToDouble(Double::doubleValue)
.average()
.orElse(noteGlobale);
}
/** Vérifie si l'évaluation est positive (note >= 4) */
public boolean isPositive() {
return noteGlobale != null && noteGlobale >= 4.0;
}
/** Vérifie si l'évaluation est négative (note <= 2) */
public boolean isNegative() {
return noteGlobale != null && noteGlobale <= 2.0;
}
/** Calcule un score de qualité global */
public double getScoreQualite() {
double score = noteGlobale != null ? noteGlobale : 0.0;
// Bonus pour les notes détaillées
if (noteDelaiReponse != null) score += noteDelaiReponse * 0.1;
if (noteCommunication != null) score += noteCommunication * 0.1;
if (noteProfessionnalisme != null) score += noteProfessionnalisme * 0.1;
if (noteRespectEngagements != null) score += noteRespectEngagements * 0.1;
// Bonus pour recommandation
if (recommande != null && recommande) score += 0.2;
// Bonus pour résolution du problème
if (problemeResolu != null && problemeResolu) score += 0.3;
// Malus pour signalements
if (nombreSignalements > 0) score -= nombreSignalements * 0.1;
return Math.min(5.0, Math.max(0.0, score));
}
/** Vérifie si l'évaluation est complète */
public boolean isComplete() {
return noteGlobale != null
&& commentairePrincipal != null
&& !commentairePrincipal.trim().isEmpty()
&& recommande != null
&& aideUtile != null
&& problemeResolu != null;
}
/** Retourne le niveau de satisfaction */
public String getNiveauSatisfaction() {
if (noteGlobale == null) return "Non évalué";
return switch (noteGlobale.intValue()) {
case 5 -> "Excellent";
case 4 -> "Très bien";
case 3 -> "Bien";
case 2 -> "Passable";
case 1 -> "Insuffisant";
default -> "Non évalué";
};
}
}

111
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/solidarite/HistoriqueStatutDTO.java
View File

@@ -1,18 +1,16 @@
package dev.lions.unionflow.server.api.dto.solidarite;
import dev.lions.unionflow.server.api.enums.solidarite.StatutAide;
import jakarta.validation.constraints.*;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.time.LocalDateTime;
import lombok.AllArgsConstructor;
import lombok.Builder;
import java.time.LocalDateTime;
import lombok.Data;
import lombok.NoArgsConstructor;
/**
* DTO pour l'historique des changements de statut d'une demande d'aide
*
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
@@ -22,66 +20,43 @@ import java.time.LocalDateTime;
@AllArgsConstructor
@Builder
public class HistoriqueStatutDTO {
/**
* Identifiant unique de l'entrée d'historique
*/
private String id;
/**
* Ancien statut
*/
private StatutAide ancienStatut;
/**
* Nouveau statut
*/
@NotNull(message = "Le nouveau statut est obligatoire")
private StatutAide nouveauStatut;
/**
* Date du changement de statut
*/
@NotNull(message = "La date de changement est obligatoire")
@Builder.Default
private LocalDateTime dateChangement = LocalDateTime.now();
/**
* Identifiant de la personne qui a effectué le changement
*/
@NotBlank(message = "L'identifiant de l'auteur est obligatoire")
private String auteurId;
/**
* Nom de la personne qui a effectué le changement
*/
private String auteurNom;
/**
* Motif du changement de statut
*/
@Size(max = 500, message = "Le motif ne peut pas dépasser 500 caractères")
private String motif;
/**
* Commentaires additionnels
*/
@Size(max = 1000, message = "Les commentaires ne peuvent pas dépasser 1000 caractères")
private String commentaires;
/**
* Indique si le changement est automatique (système)
*/
@Builder.Default
private Boolean estAutomatique = false;
/**
* Durée en minutes depuis le statut précédent
*/
private Long dureeDepuisPrecedent;
/**
* Données additionnelles liées au changement
*/
private java.util.Map<String, Object> donneesAdditionnelles;
/** Identifiant unique de l'entrée d'historique */
private String id;
/** Ancien statut */
private StatutAide ancienStatut;
/** Nouveau statut */
@NotNull(message = "Le nouveau statut est obligatoire")
private StatutAide nouveauStatut;
/** Date du changement de statut */
@NotNull(message = "La date de changement est obligatoire")
@Builder.Default
private LocalDateTime dateChangement = LocalDateTime.now();
/** Identifiant de la personne qui a effectué le changement */
@NotBlank(message = "L'identifiant de l'auteur est obligatoire")
private String auteurId;
/** Nom de la personne qui a effectué le changement */
private String auteurNom;
/** Motif du changement de statut */
@Size(max = 500, message = "Le motif ne peut pas dépasser 500 caractères")
private String motif;
/** Commentaires additionnels */
@Size(max = 1000, message = "Les commentaires ne peuvent pas dépasser 1000 caractères")
private String commentaires;
/** Indique si le changement est automatique (système) */
@Builder.Default private Boolean estAutomatique = false;
/** Durée en minutes depuis le statut précédent */
private Long dureeDepuisPrecedent;
/** Données additionnelles liées au changement */
private java.util.Map<String, Object> donneesAdditionnelles;
}

99
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/solidarite/LocalisationDTO.java
View File

@@ -1,14 +1,14 @@
package dev.lions.unionflow.server.api.dto.solidarite;
import jakarta.validation.constraints.*;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
/**
* DTO pour les informations de géolocalisation
*
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
@@ -18,60 +18,41 @@ import lombok.Builder;
@AllArgsConstructor
@Builder
public class LocalisationDTO {
/**
* Latitude
*/
@DecimalMin(value = "-90.0", message = "La latitude doit être comprise entre -90 et 90")
@DecimalMax(value = "90.0", message = "La latitude doit être comprise entre -90 et 90")
private Double latitude;
/**
* Longitude
*/
@DecimalMin(value = "-180.0", message = "La longitude doit être comprise entre -180 et 180")
@DecimalMax(value = "180.0", message = "La longitude doit être comprise entre -180 et 180")
private Double longitude;
/**
* Adresse complète
*/
@Size(max = 300, message = "L'adresse ne peut pas dépasser 300 caractères")
private String adresseComplete;
/**
* Ville
*/
@Size(max = 100, message = "La ville ne peut pas dépasser 100 caractères")
private String ville;
/**
* Région/Province
*/
@Size(max = 100, message = "La région ne peut pas dépasser 100 caractères")
private String region;
/**
* Pays
*/
@Size(max = 100, message = "Le pays ne peut pas dépasser 100 caractères")
private String pays;
/**
* Code postal
*/
@Size(max = 20, message = "Le code postal ne peut pas dépasser 20 caractères")
private String codePostal;
/**
* Précision de la localisation en mètres
*/
@Min(value = 0, message = "La précision doit être positive")
private Double precision;
/**
* Indique si la localisation est approximative
*/
@Builder.Default
private Boolean estApproximative = false;
/** Latitude */
@DecimalMin(value = "-90.0", message = "La latitude doit être comprise entre -90 et 90")
@DecimalMax(value = "90.0", message = "La latitude doit être comprise entre -90 et 90")
private Double latitude;
/** Longitude */
@DecimalMin(value = "-180.0", message = "La longitude doit être comprise entre -180 et 180")
@DecimalMax(value = "180.0", message = "La longitude doit être comprise entre -180 et 180")
private Double longitude;
/** Adresse complète */
@Size(max = 300, message = "L'adresse ne peut pas dépasser 300 caractères")
private String adresseComplete;
/** Ville */
@Size(max = 100, message = "La ville ne peut pas dépasser 100 caractères")
private String ville;
/** Région/Province */
@Size(max = 100, message = "La région ne peut pas dépasser 100 caractères")
private String region;
/** Pays */
@Size(max = 100, message = "Le pays ne peut pas dépasser 100 caractères")
private String pays;
/** Code postal */
@Size(max = 20, message = "Le code postal ne peut pas dépasser 20 caractères")
private String codePostal;
/** Précision de la localisation en mètres */
@Min(value = 0, message = "La précision doit être positive")
private Double precision;
/** Indique si la localisation est approximative */
@Builder.Default private Boolean estApproximative = false;
}

130
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/solidarite/PieceJustificativeDTO.java
View File

@@ -1,16 +1,15 @@
package dev.lions.unionflow.server.api.dto.solidarite;
import jakarta.validation.constraints.*;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.time.LocalDateTime;
import lombok.AllArgsConstructor;
import lombok.Builder;
import java.time.LocalDateTime;
import lombok.Data;
import lombok.NoArgsConstructor;
/**
* DTO pour les pièces justificatives d'une demande d'aide
*
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
@@ -20,79 +19,50 @@ import java.time.LocalDateTime;
@AllArgsConstructor
@Builder
public class PieceJustificativeDTO {
/**
* Identifiant unique de la pièce justificative
*/
private String id;
/**
* Nom du fichier
*/
@NotBlank(message = "Le nom du fichier est obligatoire")
@Size(max = 255, message = "Le nom du fichier ne peut pas dépasser 255 caractères")
private String nomFichier;
/**
* Type de pièce justificative
*/
@NotBlank(message = "Le type de pièce est obligatoire")
private String typePiece;
/**
* Description de la pièce
*/
@Size(max = 500, message = "La description ne peut pas dépasser 500 caractères")
private String description;
/**
* URL ou chemin d'accès au fichier
*/
@NotBlank(message = "L'URL du fichier est obligatoire")
private String urlFichier;
/**
* Type MIME du fichier
*/
private String typeMime;
/**
* Taille du fichier en octets
*/
@Min(value = 1, message = "La taille du fichier doit être positive")
private Long tailleFichier;
/**
* Indique si la pièce est obligatoire
*/
@Builder.Default
private Boolean estObligatoire = false;
/**
* Indique si la pièce a été vérifiée
*/
@Builder.Default
private Boolean estVerifiee = false;
/**
* Date d'ajout de la pièce
*/
@Builder.Default
private LocalDateTime dateAjout = LocalDateTime.now();
/**
* Date de vérification
*/
private LocalDateTime dateVerification;
/**
* Identifiant de la personne qui a vérifié
*/
private String verificateurId;
/**
* Commentaires sur la vérification
*/
@Size(max = 500, message = "Les commentaires ne peuvent pas dépasser 500 caractères")
private String commentairesVerification;
/** Identifiant unique de la pièce justificative */
private String id;
/** Nom du fichier */
@NotBlank(message = "Le nom du fichier est obligatoire")
@Size(max = 255, message = "Le nom du fichier ne peut pas dépasser 255 caractères")
private String nomFichier;
/** Type de pièce justificative */
@NotBlank(message = "Le type de pièce est obligatoire")
private String typePiece;
/** Description de la pièce */
@Size(max = 500, message = "La description ne peut pas dépasser 500 caractères")
private String description;
/** URL ou chemin d'accès au fichier */
@NotBlank(message = "L'URL du fichier est obligatoire")
private String urlFichier;
/** Type MIME du fichier */
private String typeMime;
/** Taille du fichier en octets */
@Min(value = 1, message = "La taille du fichier doit être positive")
private Long tailleFichier;
/** Indique si la pièce est obligatoire */
@Builder.Default private Boolean estObligatoire = false;
/** Indique si la pièce a été vérifiée */
@Builder.Default private Boolean estVerifiee = false;
/** Date d'ajout de la pièce */
@Builder.Default private LocalDateTime dateAjout = LocalDateTime.now();
/** Date de vérification */
private LocalDateTime dateVerification;
/** Identifiant de la personne qui a vérifié */
private String verificateurId;
/** Commentaires sur la vérification */
@Size(max = 500, message = "Les commentaires ne peuvent pas dépasser 500 caractères")
private String commentairesVerification;
}

624
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/solidarite/PropositionAideDTO.java
View File

@@ -1,23 +1,23 @@
package dev.lions.unionflow.server.api.dto.solidarite;
import dev.lions.unionflow.server.api.enums.solidarite.TypeAide;
import dev.lions.unionflow.server.api.validation.ValidationConstants;
import jakarta.validation.constraints.*;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.AllArgsConstructor;
import lombok.Builder;
import java.math.BigDecimal;
import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
/**
* DTO pour les propositions d'aide dans le système de solidarité
*
* Ce DTO représente une proposition d'aide faite par un membre pour aider
* soit une demande spécifique, soit de manière générale.
*
*
* <p>Ce DTO représente une proposition d'aide faite par un membre pour aider soit une demande
* spécifique, soit de manière générale.
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
@@ -27,362 +27,264 @@ import java.util.Map;
@AllArgsConstructor
@Builder
public class PropositionAideDTO {
// === IDENTIFICATION ===
/**
* Identifiant unique de la proposition d'aide
*/
private String id;
/**
* Numéro de référence de la proposition (généré automatiquement)
*/
@Pattern(regexp = "^PA-\\d{4}-\\d{6}$", message = "Le numéro de référence doit suivre le format PA-YYYY-NNNNNN")
private String numeroReference;
// === INFORMATIONS DE BASE ===
/**
* Type d'aide proposée
*/
@NotNull(message = "Le type d'aide proposée est obligatoire")
private TypeAide typeAide;
/**
* Titre de la proposition
*/
@NotBlank(message = "Le titre est obligatoire")
@Size(min = 10, max = 100, message = "Le titre doit contenir entre 10 et 100 caractères")
private String titre;
/**
* Description détaillée de l'aide proposée
*/
@NotBlank(message = "La description est obligatoire")
@Size(min = 20, max = 1000, message = "La description doit contenir entre 20 et 1000 caractères")
private String description;
/**
* Conditions ou critères pour bénéficier de l'aide
*/
@Size(max = 500, message = "Les conditions ne peuvent pas dépasser 500 caractères")
private String conditions;
// === MONTANT ET CAPACITÉ ===
/**
* Montant maximum que le proposant peut offrir (si applicable)
*/
@DecimalMin(value = "0.0", inclusive = false, message = "Le montant doit être positif")
@DecimalMax(value = "1000000.0", message = "Le montant ne peut pas dépasser 1 000 000 FCFA")
private Double montantMaximum;
/**
* Nombre maximum de bénéficiaires
*/
@Min(value = 1, message = "Le nombre de bénéficiaires doit être au moins 1")
@Max(value = 100, message = "Le nombre de bénéficiaires ne peut pas dépasser 100")
@Builder.Default
private Integer nombreMaxBeneficiaires = 1;
/**
* Devise du montant
*/
@Builder.Default
private String devise = "FCFA";
// === ACTEURS ===
/**
* Identifiant du proposant
*/
@NotBlank(message = "L'identifiant du proposant est obligatoire")
private String proposantId;
/**
* Nom complet du proposant
*/
private String proposantNom;
/**
* Identifiant de l'organisation du proposant
*/
@NotBlank(message = "L'identifiant de l'organisation est obligatoire")
private String organisationId;
/**
* Identifiant de la demande d'aide liée (si proposition spécifique)
*/
private String demandeAideId;
// === STATUT ET DISPONIBILITÉ ===
/**
* Statut de la proposition
*/
@NotNull(message = "Le statut est obligatoire")
@Builder.Default
private StatutProposition statut = StatutProposition.ACTIVE;
/**
* Indique si la proposition est disponible
*/
@Builder.Default
private Boolean estDisponible = true;
/**
* Indique si la proposition est récurrente
*/
@Builder.Default
private Boolean estRecurrente = false;
/**
* Fréquence de récurrence (si applicable)
*/
private String frequenceRecurrence;
// === DATES ET DÉLAIS ===
/**
* Date de création de la proposition
*/
@NotNull(message = "La date de création est obligatoire")
@Builder.Default
private LocalDateTime dateCreation = LocalDateTime.now();
/**
* Date d'expiration de la proposition
*/
private LocalDateTime dateExpiration;
/**
* Date de dernière modification
*/
@Builder.Default
private LocalDateTime dateModification = LocalDateTime.now();
/**
* Délai de réponse souhaité en heures
*/
@Min(value = 1, message = "Le délai de réponse doit être au moins 1 heure")
@Max(value = 8760, message = "Le délai de réponse ne peut pas dépasser 1 an")
@Builder.Default
private Integer delaiReponseHeures = 72;
// === CRITÈRES ET PRÉFÉRENCES ===
/**
* Critères de sélection des bénéficiaires
*/
private List<CritereSelectionDTO> criteresSelection;
/**
* Zones géographiques couvertes
*/
private List<String> zonesGeographiques;
/**
* Groupes cibles (âge, situation, etc.)
*/
private List<String> groupesCibles;
/**
* Compétences ou ressources disponibles
*/
private List<String> competencesRessources;
// === CONTACT ET DISPONIBILITÉ ===
/**
* Informations de contact préférées
*/
private ContactProposantDTO contactProposant;
/**
* Créneaux de disponibilité
*/
private List<CreneauDisponibiliteDTO> creneauxDisponibilite;
/**
* Mode de contact préféré
*/
private String modeContactPrefere;
// === HISTORIQUE ET SUIVI ===
/**
* Nombre de demandes traitées avec cette proposition
*/
@Builder.Default
private Integer nombreDemandesTraitees = 0;
/**
* Nombre de bénéficiaires aidés
*/
@Builder.Default
private Integer nombreBeneficiairesAides = 0;
/**
* Montant total versé
*/
@Builder.Default
private Double montantTotalVerse = 0.0;
/**
* Note moyenne des bénéficiaires
*/
@DecimalMin(value = "0.0", message = "La note doit être positive")
@DecimalMax(value = "5.0", message = "La note ne peut pas dépasser 5")
private Double noteMoyenne;
/**
* Nombre d'évaluations reçues
*/
@Builder.Default
private Integer nombreEvaluations = 0;
// === MÉTADONNÉES ===
/**
* Tags pour catégorisation
*/
private List<String> tags;
/**
* Données personnalisées
*/
private Map<String, Object> donneesPersonnalisees;
/**
* Indique si la proposition est mise en avant
*/
@Builder.Default
private Boolean estMiseEnAvant = false;
/**
* Score de pertinence calculé automatiquement
*/
private Double scorePertinence;
/**
* Nombre de vues de la proposition
*/
@Builder.Default
private Integer nombreVues = 0;
/**
* Nombre de candidatures reçues
*/
@Builder.Default
private Integer nombreCandidatures = 0;
// === MÉTHODES UTILITAIRES ===
/**
* Vérifie si la proposition est active et disponible
*/
public boolean isActiveEtDisponible() {
return statut == StatutProposition.ACTIVE && estDisponible && !isExpiree();
// === IDENTIFICATION ===
/** Identifiant unique de la proposition d'aide */
private String id;
/** Numéro de référence de la proposition (généré automatiquement) */
@Pattern(
regexp = "^PA-\\d{4}-\\d{6}$",
message = "Le numéro de référence doit suivre le format PA-YYYY-NNNNNN")
private String numeroReference;
// === INFORMATIONS DE BASE ===
/** Type d'aide proposée */
@NotNull(message = "Le type d'aide proposée est obligatoire")
private TypeAide typeAide;
/** Titre de la proposition */
@NotBlank(message = "Le titre est obligatoire")
@Size(min = 10, max = 100, message = "Le titre doit contenir entre 10 et 100 caractères")
private String titre;
/** Description détaillée de l'aide proposée */
@NotBlank(message = "La description est obligatoire")
@Size(min = 20, max = 1000, message = "La description doit contenir entre 20 et 1000 caractères")
private String description;
/** Conditions ou critères pour bénéficier de l'aide */
@Size(max = 500, message = "Les conditions ne peuvent pas dépasser 500 caractères")
private String conditions;
// === MONTANT ET CAPACITÉ ===
/** Montant maximum que le proposant peut offrir (si applicable) */
@DecimalMin(value = "0.0", inclusive = false, message = "Le montant doit être positif")
@DecimalMax(value = "1000000.0", message = "Le montant ne peut pas dépasser 1 000 000 FCFA")
@Digits(
integer = ValidationConstants.MONTANT_INTEGER_DIGITS,
fraction = ValidationConstants.MONTANT_FRACTION_DIGITS,
message = ValidationConstants.MONTANT_DIGITS_MESSAGE)
private BigDecimal montantMaximum;
/** Nombre maximum de bénéficiaires */
@Min(value = 1, message = "Le nombre de bénéficiaires doit être au moins 1")
@Max(value = 100, message = "Le nombre de bénéficiaires ne peut pas dépasser 100")
@Builder.Default
private Integer nombreMaxBeneficiaires = 1;
/** Devise du montant */
@Builder.Default private String devise = "FCFA";
// === ACTEURS ===
/** Identifiant du proposant */
@NotBlank(message = "L'identifiant du proposant est obligatoire")
private String proposantId;
/** Nom complet du proposant */
private String proposantNom;
/** Identifiant de l'organisation du proposant */
@NotBlank(message = "L'identifiant de l'organisation est obligatoire")
private String organisationId;
/** Identifiant de la demande d'aide liée (si proposition spécifique) */
private String demandeAideId;
// === STATUT ET DISPONIBILITÉ ===
/** Statut de la proposition */
@NotNull(message = "Le statut est obligatoire")
@Builder.Default
private StatutProposition statut = StatutProposition.ACTIVE;
/** Indique si la proposition est disponible */
@Builder.Default private Boolean estDisponible = true;
/** Indique si la proposition est récurrente */
@Builder.Default private Boolean estRecurrente = false;
/** Fréquence de récurrence (si applicable) */
private String frequenceRecurrence;
// === DATES ET DÉLAIS ===
/** Date de création de la proposition */
@NotNull(message = "La date de création est obligatoire")
@Builder.Default
private LocalDateTime dateCreation = LocalDateTime.now();
/** Date d'expiration de la proposition */
private LocalDateTime dateExpiration;
/** Date de dernière modification */
@Builder.Default private LocalDateTime dateModification = LocalDateTime.now();
/** Délai de réponse souhaité en heures */
@Min(value = 1, message = "Le délai de réponse doit être au moins 1 heure")
@Max(value = 8760, message = "Le délai de réponse ne peut pas dépasser 1 an")
@Builder.Default
private Integer delaiReponseHeures = 72;
// === CRITÈRES ET PRÉFÉRENCES ===
/** Critères de sélection des bénéficiaires */
private List<CritereSelectionDTO> criteresSelection;
/** Zones géographiques couvertes */
private List<String> zonesGeographiques;
/** Groupes cibles (âge, situation, etc.) */
private List<String> groupesCibles;
/** Compétences ou ressources disponibles */
private List<String> competencesRessources;
// === CONTACT ET DISPONIBILITÉ ===
/** Informations de contact préférées */
private ContactProposantDTO contactProposant;
/** Créneaux de disponibilité */
private List<CreneauDisponibiliteDTO> creneauxDisponibilite;
/** Mode de contact préféré */
private String modeContactPrefere;
// === HISTORIQUE ET SUIVI ===
/** Nombre de demandes traitées avec cette proposition */
@Builder.Default private Integer nombreDemandesTraitees = 0;
/** Nombre de bénéficiaires aidés */
@Builder.Default private Integer nombreBeneficiairesAides = 0;
/** Montant total versé */
@Builder.Default private Double montantTotalVerse = 0.0;
/** Note moyenne des bénéficiaires */
@DecimalMin(value = "0.0", message = "La note doit être positive")
@DecimalMax(value = "5.0", message = "La note ne peut pas dépasser 5")
private Double noteMoyenne;
/** Nombre d'évaluations reçues */
@Builder.Default private Integer nombreEvaluations = 0;
// === MÉTADONNÉES ===
/** Tags pour catégorisation */
private List<String> tags;
/** Données personnalisées */
private Map<String, Object> donneesPersonnalisees;
/** Indique si la proposition est mise en avant */
@Builder.Default private Boolean estMiseEnAvant = false;
/** Score de pertinence calculé automatiquement */
private Double scorePertinence;
/** Nombre de vues de la proposition */
@Builder.Default private Integer nombreVues = 0;
/** Nombre de candidatures reçues */
@Builder.Default private Integer nombreCandidatures = 0;
// === MÉTHODES UTILITAIRES ===
/** Vérifie si la proposition est active et disponible */
public boolean isActiveEtDisponible() {
return statut == StatutProposition.ACTIVE && estDisponible && !isExpiree();
}
/** Vérifie si la proposition est expirée */
public boolean isExpiree() {
return dateExpiration != null && LocalDateTime.now().isAfter(dateExpiration);
}
/** Vérifie si la proposition peut encore accepter des bénéficiaires */
public boolean peutAccepterBeneficiaires() {
return isActiveEtDisponible() && nombreBeneficiairesAides < nombreMaxBeneficiaires;
}
/** Calcule le pourcentage de capacité utilisée */
public double getPourcentageCapaciteUtilisee() {
if (nombreMaxBeneficiaires == 0) return 100.0;
return (nombreBeneficiairesAides * 100.0) / nombreMaxBeneficiaires;
}
/** Retourne le nombre de places restantes */
public int getPlacesRestantes() {
return Math.max(0, nombreMaxBeneficiaires - nombreBeneficiairesAides);
}
/** Vérifie si la proposition correspond à un type d'aide */
public boolean correspondAuType(TypeAide type) {
return typeAide == type
|| (typeAide.getCategorie().equals(type.getCategorie()) && typeAide != TypeAide.AUTRE);
}
/** Calcule le score de compatibilité avec une demande */
public double getScoreCompatibilite(DemandeAideDTO demande) {
double score = 0.0;
// Correspondance exacte du type
if (typeAide == demande.getTypeAide()) {
score += 50.0;
} else if (typeAide.getCategorie().equals(demande.getTypeAide().getCategorie())) {
score += 30.0;
}
/**
* Vérifie si la proposition est expirée
*/
public boolean isExpiree() {
return dateExpiration != null && LocalDateTime.now().isAfter(dateExpiration);
// Montant compatible
if (montantMaximum != null && demande.getMontantDemande() != null) {
if (demande.getMontantDemande().compareTo(montantMaximum) <= 0) {
score += 20.0;
} else {
score -= 10.0;
}
}
/**
* Vérifie si la proposition peut encore accepter des bénéficiaires
*/
public boolean peutAccepterBeneficiaires() {
return isActiveEtDisponible() && nombreBeneficiairesAides < nombreMaxBeneficiaires;
// Disponibilité
if (peutAccepterBeneficiaires()) {
score += 15.0;
}
/**
* Calcule le pourcentage de capacité utilisée
*/
public double getPourcentageCapaciteUtilisee() {
if (nombreMaxBeneficiaires == 0) return 100.0;
return (nombreBeneficiairesAides * 100.0) / nombreMaxBeneficiaires;
// Réputation
if (noteMoyenne != null && noteMoyenne >= 4.0) {
score += 10.0;
}
/**
* Retourne le nombre de places restantes
*/
public int getPlacesRestantes() {
return Math.max(0, nombreMaxBeneficiaires - nombreBeneficiairesAides);
// Récence
long joursDepuisCreation =
java.time.Duration.between(dateCreation, LocalDateTime.now()).toDays();
if (joursDepuisCreation <= 30) {
score += 5.0;
}
/**
* Vérifie si la proposition correspond à un type d'aide
*/
public boolean correspondAuType(TypeAide type) {
return typeAide == type ||
(typeAide.getCategorie().equals(type.getCategorie()) && typeAide != TypeAide.AUTRE);
return Math.min(100.0, Math.max(0.0, score));
}
/** Énumération des statuts de proposition */
public enum StatutProposition {
BROUILLON("Brouillon"),
ACTIVE("Active"),
SUSPENDUE("Suspendue"),
EXPIREE("Expirée"),
TERMINEE("Terminée"),
ANNULEE("Annulée");
private final String libelle;
StatutProposition(String libelle) {
this.libelle = libelle;
}
/**
* Calcule le score de compatibilité avec une demande
*/
public double getScoreCompatibilite(DemandeAideDTO demande) {
double score = 0.0;
// Correspondance exacte du type
if (typeAide == demande.getTypeAide()) {
score += 50.0;
} else if (typeAide.getCategorie().equals(demande.getTypeAide().getCategorie())) {
score += 30.0;
}
// Montant compatible
if (montantMaximum != null && demande.getMontantDemande() != null) {
if (demande.getMontantDemande() <= montantMaximum) {
score += 20.0;
} else {
score -= 10.0;
}
}
// Disponibilité
if (peutAccepterBeneficiaires()) {
score += 15.0;
}
// Réputation
if (noteMoyenne != null && noteMoyenne >= 4.0) {
score += 10.0;
}
// Récence
long joursDepuisCreation = java.time.Duration.between(dateCreation, LocalDateTime.now()).toDays();
if (joursDepuisCreation <= 30) {
score += 5.0;
}
return Math.min(100.0, Math.max(0.0, score));
}
/**
* Énumération des statuts de proposition
*/
public enum StatutProposition {
BROUILLON("Brouillon"),
ACTIVE("Active"),
SUSPENDUE("Suspendue"),
EXPIREE("Expirée"),
TERMINEE("Terminée"),
ANNULEE("Annulée");
private final String libelle;
StatutProposition(String libelle) {
this.libelle = libelle;
}
public String getLibelle() {
return libelle;
}
public String getLibelle() {
return libelle;
}
}
}

849
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/dto/solidarite/aide/AideDTO.java
View File

@@ -1,849 +0,0 @@
package dev.lions.unionflow.server.api.dto.solidarite.aide;
import com.fasterxml.jackson.annotation.JsonFormat;
import dev.lions.unionflow.server.api.dto.base.BaseDTO;
import jakarta.validation.constraints.DecimalMin;
import jakarta.validation.constraints.Digits;
import jakarta.validation.constraints.Future;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Pattern;
import jakarta.validation.constraints.Size;
import java.math.BigDecimal;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.util.UUID;
/**
* DTO pour la gestion des demandes d'aide et de solidarité Représente les demandes d'assistance
* mutuelle entre membres
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-10
*/
public class AideDTO extends BaseDTO {
private static final long serialVersionUID = 1L;
/** Numéro de référence unique de la demande */
@NotBlank(message = "Le numéro de référence est obligatoire")
@Pattern(
regexp = "^AIDE-\\d{4}-[A-Z0-9]{6}$",
message = "Format de référence invalide (AIDE-YYYY-XXXXXX)")
private String numeroReference;
/** Identifiant du membre demandeur */
@NotNull(message = "L'identifiant du demandeur est obligatoire")
private UUID membreDemandeurId;
/** Nom complet du membre demandeur */
private String nomDemandeur;
/** Numéro de membre du demandeur */
private String numeroMembreDemandeur;
/** Identifiant de l'association */
@NotNull(message = "L'identifiant de l'association est obligatoire")
private UUID associationId;
/** Nom de l'association */
private String nomAssociation;
/**
* Type d'aide demandée FINANCIERE, MATERIELLE, MEDICALE, JURIDIQUE, LOGEMENT, EDUCATION, AUTRE
*/
@NotBlank(message = "Le type d'aide est obligatoire")
@Pattern(
regexp = "^(FINANCIERE|MATERIELLE|MEDICALE|JURIDIQUE|LOGEMENT|EDUCATION|AUTRE)$",
message =
"Le type d'aide doit être FINANCIERE, MATERIELLE, MEDICALE, JURIDIQUE, LOGEMENT,"
+ " EDUCATION ou AUTRE")
private String typeAide;
/** Titre de la demande d'aide */
@NotBlank(message = "Le titre est obligatoire")
@Size(min = 5, max = 200, message = "Le titre doit contenir entre 5 et 200 caractères")
private String titre;
/** Description détaillée de la demande */
@NotBlank(message = "La description est obligatoire")
@Size(min = 20, max = 2000, message = "La description doit contenir entre 20 et 2000 caractères")
private String description;
/** Montant demandé (pour les aides financières) */
@DecimalMin(value = "0.0", inclusive = false, message = "Le montant demandé doit être positif")
@Digits(
integer = 10,
fraction = 2,
message = "Le montant ne peut avoir plus de 10 chiffres entiers et 2 décimales")
private BigDecimal montantDemande;
/** Devise du montant */
@Pattern(regexp = "^[A-Z]{3}$", message = "La devise doit être un code ISO à 3 lettres")
private String devise = "XOF";
/**
* Statut de la demande EN_ATTENTE, EN_COURS_EVALUATION, APPROUVEE, REJETEE, EN_COURS_AIDE,
* TERMINEE, ANNULEE
*/
@NotBlank(message = "Le statut est obligatoire")
@Pattern(
regexp =
"^(EN_ATTENTE|EN_COURS_EVALUATION|APPROUVEE|REJETEE|EN_COURS_AIDE|TERMINEE|ANNULEE)$",
message = "Statut invalide")
private String statut;
/** Priorité de la demande BASSE, NORMALE, HAUTE, URGENTE */
@Pattern(
regexp = "^(BASSE|NORMALE|HAUTE|URGENTE)$",
message = "La priorité doit être BASSE, NORMALE, HAUTE ou URGENTE")
private String priorite;
/** Date limite pour l'aide */
@Future(message = "La date limite doit être dans le futur")
@JsonFormat(pattern = "yyyy-MM-dd")
private LocalDate dateLimite;
/** Justificatifs fournis */
private Boolean justificatifsFournis;
/** Liste des documents joints (noms de fichiers) */
@Size(max = 1000, message = "La liste des documents ne peut pas dépasser 1000 caractères")
private String documentsJoints;
/** Identifiant du membre évaluateur */
private UUID membreEvaluateurId;
/** Nom de l'évaluateur */
private String nomEvaluateur;
/** Date d'évaluation */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateEvaluation;
/** Commentaires de l'évaluateur */
@Size(max = 1000, message = "Les commentaires ne peuvent pas dépasser 1000 caractères")
private String commentairesEvaluateur;
/** Montant approuvé (peut être différent du montant demandé) */
@DecimalMin(value = "0.0", message = "Le montant approuvé doit être positif")
@Digits(
integer = 10,
fraction = 2,
message = "Le montant ne peut avoir plus de 10 chiffres entiers et 2 décimales")
private BigDecimal montantApprouve;
/** Date d'approbation */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateApprobation;
/** Identifiant du membre qui fournit l'aide */
private UUID membreAidantId;
/** Nom du membre aidant */
private String nomAidant;
/** Date de début de l'aide */
@JsonFormat(pattern = "yyyy-MM-dd")
private LocalDate dateDebutAide;
/** Date de fin de l'aide */
@JsonFormat(pattern = "yyyy-MM-dd")
private LocalDate dateFinAide;
/** Montant effectivement versé */
@DecimalMin(value = "0.0", message = "Le montant versé doit être positif")
@Digits(
integer = 10,
fraction = 2,
message = "Le montant ne peut avoir plus de 10 chiffres entiers et 2 décimales")
private BigDecimal montantVerse;
/** Mode de versement */
@Pattern(
regexp = "^(WAVE_MONEY|ORANGE_MONEY|FREE_MONEY|VIREMENT|CHEQUE|ESPECES|NATURE)$",
message = "Mode de versement invalide")
private String modeVersement;
/** Numéro de transaction (pour les paiements mobiles) */
@Size(max = 50, message = "Le numéro de transaction ne peut pas dépasser 50 caractères")
private String numeroTransaction;
/** Date de versement */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateVersement;
/** Commentaires du bénéficiaire */
@Size(max = 1000, message = "Les commentaires ne peuvent pas dépasser 1000 caractères")
private String commentairesBeneficiaire;
/** Note de satisfaction (1-5) */
private Integer noteSatisfaction;
/** Aide publique (visible par tous les membres) */
private Boolean aidePublique;
/** Aide anonyme (demandeur anonyme) */
private Boolean aideAnonyme;
/** Nombre de vues de la demande */
private Integer nombreVues;
/** Raison du rejet (si applicable) */
@Size(max = 500, message = "La raison du rejet ne peut pas dépasser 500 caractères")
private String raisonRejet;
/** Date de rejet */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime dateRejet;
/** Identifiant de celui qui a rejeté */
private UUID rejeteParId;
/** Nom de celui qui a rejeté */
private String rejetePar;
// Constructeurs
public AideDTO() {
super();
this.statut = "EN_ATTENTE";
this.priorite = "NORMALE";
this.devise = "XOF";
this.justificatifsFournis = false;
this.aidePublique = true;
this.aideAnonyme = false;
this.nombreVues = 0;
this.numeroReference = genererNumeroReference();
}
public AideDTO(UUID membreDemandeurId, UUID associationId, String typeAide, String titre) {
this();
this.membreDemandeurId = membreDemandeurId;
this.associationId = associationId;
this.typeAide = typeAide;
this.titre = titre;
}
// Getters et Setters
public String getNumeroReference() {
return numeroReference;
}
public void setNumeroReference(String numeroReference) {
this.numeroReference = numeroReference;
}
public UUID getMembreDemandeurId() {
return membreDemandeurId;
}
public void setMembreDemandeurId(UUID membreDemandeurId) {
this.membreDemandeurId = membreDemandeurId;
}
public String getNomDemandeur() {
return nomDemandeur;
}
public void setNomDemandeur(String nomDemandeur) {
this.nomDemandeur = nomDemandeur;
}
public String getNumeroMembreDemandeur() {
return numeroMembreDemandeur;
}
public void setNumeroMembreDemandeur(String numeroMembreDemandeur) {
this.numeroMembreDemandeur = numeroMembreDemandeur;
}
public UUID getAssociationId() {
return associationId;
}
public void setAssociationId(UUID associationId) {
this.associationId = associationId;
}
public String getNomAssociation() {
return nomAssociation;
}
public void setNomAssociation(String nomAssociation) {
this.nomAssociation = nomAssociation;
}
public String getTypeAide() {
return typeAide;
}
public void setTypeAide(String typeAide) {
this.typeAide = typeAide;
}
public String getTitre() {
return titre;
}
public void setTitre(String titre) {
this.titre = titre;
}
public String getDescription() {
return description;
}
public void setDescription(String description) {
this.description = description;
}
public BigDecimal getMontantDemande() {
return montantDemande;
}
public void setMontantDemande(BigDecimal montantDemande) {
this.montantDemande = montantDemande;
}
public String getDevise() {
return devise;
}
public void setDevise(String devise) {
this.devise = devise;
}
public String getStatut() {
return statut;
}
public void setStatut(String statut) {
this.statut = statut;
}
public String getPriorite() {
return priorite;
}
public void setPriorite(String priorite) {
this.priorite = priorite;
}
public LocalDate getDateLimite() {
return dateLimite;
}
public void setDateLimite(LocalDate dateLimite) {
this.dateLimite = dateLimite;
}
public Boolean getJustificatifsFournis() {
return justificatifsFournis;
}
public void setJustificatifsFournis(Boolean justificatifsFournis) {
this.justificatifsFournis = justificatifsFournis;
}
public String getDocumentsJoints() {
return documentsJoints;
}
public void setDocumentsJoints(String documentsJoints) {
this.documentsJoints = documentsJoints;
}
// Getters et setters restants (suite)
public UUID getMembreEvaluateurId() {
return membreEvaluateurId;
}
public void setMembreEvaluateurId(UUID membreEvaluateurId) {
this.membreEvaluateurId = membreEvaluateurId;
}
public String getNomEvaluateur() {
return nomEvaluateur;
}
public void setNomEvaluateur(String nomEvaluateur) {
this.nomEvaluateur = nomEvaluateur;
}
public LocalDateTime getDateEvaluation() {
return dateEvaluation;
}
public void setDateEvaluation(LocalDateTime dateEvaluation) {
this.dateEvaluation = dateEvaluation;
}
public String getCommentairesEvaluateur() {
return commentairesEvaluateur;
}
public void setCommentairesEvaluateur(String commentairesEvaluateur) {
this.commentairesEvaluateur = commentairesEvaluateur;
}
public BigDecimal getMontantApprouve() {
return montantApprouve;
}
public void setMontantApprouve(BigDecimal montantApprouve) {
this.montantApprouve = montantApprouve;
}
public LocalDateTime getDateApprobation() {
return dateApprobation;
}
public void setDateApprobation(LocalDateTime dateApprobation) {
this.dateApprobation = dateApprobation;
}
public UUID getMembreAidantId() {
return membreAidantId;
}
public void setMembreAidantId(UUID membreAidantId) {
this.membreAidantId = membreAidantId;
}
public String getNomAidant() {
return nomAidant;
}
public void setNomAidant(String nomAidant) {
this.nomAidant = nomAidant;
}
public LocalDate getDateDebutAide() {
return dateDebutAide;
}
public void setDateDebutAide(LocalDate dateDebutAide) {
this.dateDebutAide = dateDebutAide;
}
public LocalDate getDateFinAide() {
return dateFinAide;
}
public void setDateFinAide(LocalDate dateFinAide) {
this.dateFinAide = dateFinAide;
}
public BigDecimal getMontantVerse() {
return montantVerse;
}
public void setMontantVerse(BigDecimal montantVerse) {
this.montantVerse = montantVerse;
}
public String getModeVersement() {
return modeVersement;
}
public void setModeVersement(String modeVersement) {
this.modeVersement = modeVersement;
}
public String getNumeroTransaction() {
return numeroTransaction;
}
public void setNumeroTransaction(String numeroTransaction) {
this.numeroTransaction = numeroTransaction;
}
public LocalDateTime getDateVersement() {
return dateVersement;
}
public void setDateVersement(LocalDateTime dateVersement) {
this.dateVersement = dateVersement;
}
public String getCommentairesBeneficiaire() {
return commentairesBeneficiaire;
}
public void setCommentairesBeneficiaire(String commentairesBeneficiaire) {
this.commentairesBeneficiaire = commentairesBeneficiaire;
}
public Integer getNoteSatisfaction() {
return noteSatisfaction;
}
public void setNoteSatisfaction(Integer noteSatisfaction) {
this.noteSatisfaction = noteSatisfaction;
}
public Boolean getAidePublique() {
return aidePublique;
}
public void setAidePublique(Boolean aidePublique) {
this.aidePublique = aidePublique;
}
public Boolean getAideAnonyme() {
return aideAnonyme;
}
public void setAideAnonyme(Boolean aideAnonyme) {
this.aideAnonyme = aideAnonyme;
}
public Integer getNombreVues() {
return nombreVues;
}
public void setNombreVues(Integer nombreVues) {
this.nombreVues = nombreVues;
}
public String getRaisonRejet() {
return raisonRejet;
}
public void setRaisonRejet(String raisonRejet) {
this.raisonRejet = raisonRejet;
}
public LocalDateTime getDateRejet() {
return dateRejet;
}
public void setDateRejet(LocalDateTime dateRejet) {
this.dateRejet = dateRejet;
}
public UUID getRejeteParId() {
return rejeteParId;
}
public void setRejeteParId(UUID rejeteParId) {
this.rejeteParId = rejeteParId;
}
public String getRejetePar() {
return rejetePar;
}
public void setRejetePar(String rejetePar) {
this.rejetePar = rejetePar;
}
// Méthodes utilitaires
/**
* Vérifie si la demande est en attente
*
* @return true si la demande est en attente
*/
public boolean isEnAttente() {
return "EN_ATTENTE".equals(statut);
}
/**
* Vérifie si la demande est en cours d'évaluation
*
* @return true si la demande est en cours d'évaluation
*/
public boolean isEnCoursEvaluation() {
return "EN_COURS_EVALUATION".equals(statut);
}
/**
* Vérifie si la demande est approuvée
*
* @return true si la demande est approuvée
*/
public boolean isApprouvee() {
return "APPROUVEE".equals(statut);
}
/**
* Vérifie si la demande est rejetée
*
* @return true si la demande est rejetée
*/
public boolean isRejetee() {
return "REJETEE".equals(statut);
}
/**
* Vérifie si l'aide est en cours
*
* @return true si l'aide est en cours
*/
public boolean isEnCoursAide() {
return "EN_COURS_AIDE".equals(statut);
}
/**
* Vérifie si l'aide est terminée
*
* @return true si l'aide est terminée
*/
public boolean isTerminee() {
return "TERMINEE".equals(statut);
}
/**
* Vérifie si la demande est annulée
*
* @return true si la demande est annulée
*/
public boolean isAnnulee() {
return "ANNULEE".equals(statut);
}
/**
* Vérifie si la demande est urgente
*
* @return true si la priorité est urgente
*/
public boolean isUrgente() {
return "URGENTE".equals(priorite);
}
/**
* Vérifie si la date limite est dépassée
*
* @return true si la date limite est dépassée
*/
public boolean isDateLimiteDepassee() {
return dateLimite != null && LocalDate.now().isAfter(dateLimite);
}
/**
* Calcule le nombre de jours restants avant la date limite
*
* @return Le nombre de jours restants, ou 0 si dépassé
*/
public long getJoursRestants() {
if (dateLimite == null) return 0;
LocalDate aujourd = LocalDate.now();
return aujourd.isBefore(dateLimite) ? aujourd.until(dateLimite).getDays() : 0;
}
/**
* Vérifie si l'aide concerne un montant financier
*
* @return true si c'est une aide financière
*/
public boolean isAideFinanciere() {
return "FINANCIERE".equals(typeAide) && montantDemande != null;
}
/**
* Calcule l'écart entre le montant demandé et approuvé
*
* @return La différence (positif = réduction, négatif = augmentation)
*/
public BigDecimal getEcartMontant() {
if (montantDemande == null || montantApprouve == null) {
return BigDecimal.ZERO;
}
return montantDemande.subtract(montantApprouve);
}
/**
* Calcule le pourcentage d'approbation du montant
*
* @return Le pourcentage du montant approuvé par rapport au demandé
*/
public int getPourcentageApprobation() {
if (montantDemande == null
|| montantApprouve == null
|| montantDemande.compareTo(BigDecimal.ZERO) == 0) {
return 0;
}
return montantApprouve
.multiply(BigDecimal.valueOf(100))
.divide(montantDemande, 0, java.math.RoundingMode.HALF_UP)
.intValue();
}
/**
* Retourne le libellé du type d'aide
*
* @return Le libellé du type d'aide
*/
public String getTypeAideLibelle() {
if (typeAide == null) return "Non défini";
return switch (typeAide) {
case "FINANCIERE" -> "Aide Financière";
case "MATERIELLE" -> "Aide Matérielle";
case "MEDICALE" -> "Aide Médicale";
case "JURIDIQUE" -> "Aide Juridique";
case "LOGEMENT" -> "Aide au Logement";
case "EDUCATION" -> "Aide à l'Éducation";
case "AUTRE" -> "Autre";
default -> typeAide;
};
}
/**
* Retourne le libellé du statut
*
* @return Le libellé du statut
*/
public String getStatutLibelle() {
if (statut == null) return "Non défini";
return switch (statut) {
case "EN_ATTENTE" -> "En Attente";
case "EN_COURS_EVALUATION" -> "En Cours d'Évaluation";
case "APPROUVEE" -> "Approuvée";
case "REJETEE" -> "Rejetée";
case "EN_COURS_AIDE" -> "En Cours d'Aide";
case "TERMINEE" -> "Terminée";
case "ANNULEE" -> "Annulée";
default -> statut;
};
}
/**
* Retourne le libellé de la priorité
*
* @return Le libellé de la priorité
*/
public String getPrioriteLibelle() {
if (priorite == null) return "Normale";
return switch (priorite) {
case "BASSE" -> "Basse";
case "NORMALE" -> "Normale";
case "HAUTE" -> "Haute";
case "URGENTE" -> "Urgente";
default -> priorite;
};
}
/**
* Approuve la demande d'aide
*
* @param evaluateurId ID de l'évaluateur
* @param nomEvaluateur Nom de l'évaluateur
* @param montantApprouve Montant approuvé
* @param commentaires Commentaires de l'évaluateur
*/
public void approuver(
UUID evaluateurId, String nomEvaluateur, BigDecimal montantApprouve, String commentaires) {
this.statut = "APPROUVEE";
this.membreEvaluateurId = evaluateurId;
this.nomEvaluateur = nomEvaluateur;
this.montantApprouve = montantApprouve;
this.commentairesEvaluateur = commentaires;
this.dateEvaluation = LocalDateTime.now();
this.dateApprobation = LocalDateTime.now();
marquerCommeModifie(nomEvaluateur);
}
/**
* Rejette la demande d'aide
*
* @param evaluateurId ID de l'évaluateur
* @param nomEvaluateur Nom de l'évaluateur
* @param raison Raison du rejet
*/
public void rejeter(UUID evaluateurId, String nomEvaluateur, String raison) {
this.statut = "REJETEE";
this.rejeteParId = evaluateurId;
this.rejetePar = nomEvaluateur;
this.raisonRejet = raison;
this.dateRejet = LocalDateTime.now();
this.dateEvaluation = LocalDateTime.now();
marquerCommeModifie(nomEvaluateur);
}
/**
* Démarre l'aide
*
* @param aidantId ID du membre aidant
* @param nomAidant Nom du membre aidant
*/
public void demarrerAide(UUID aidantId, String nomAidant) {
this.statut = "EN_COURS_AIDE";
this.membreAidantId = aidantId;
this.nomAidant = nomAidant;
this.dateDebutAide = LocalDate.now();
marquerCommeModifie(nomAidant);
}
/**
* Termine l'aide avec versement
*
* @param montantVerse Montant effectivement versé
* @param modeVersement Mode de versement
* @param numeroTransaction Numéro de transaction
*/
public void terminerAvecVersement(
BigDecimal montantVerse, String modeVersement, String numeroTransaction) {
this.statut = "TERMINEE";
this.montantVerse = montantVerse;
this.modeVersement = modeVersement;
this.numeroTransaction = numeroTransaction;
this.dateVersement = LocalDateTime.now();
this.dateFinAide = LocalDate.now();
marquerCommeModifie("SYSTEM");
}
/** Incrémente le nombre de vues */
public void incrementerVues() {
if (nombreVues == null) {
nombreVues = 1;
} else {
nombreVues++;
}
}
/**
* Génère un numéro de référence unique
*
* @return Le numéro de référence généré
*/
private String genererNumeroReference() {
return "AIDE-"
+ LocalDate.now().getYear()
+ "-"
+ String.format("%06d", (int) (Math.random() * 1000000));
}
@Override
public String toString() {
return "AideDTO{"
+ "numeroReference='"
+ numeroReference
+ '\''
+ ", typeAide='"
+ typeAide
+ '\''
+ ", titre='"
+ titre
+ '\''
+ ", statut='"
+ statut
+ '\''
+ ", priorite='"
+ priorite
+ '\''
+ ", montantDemande="
+ montantDemande
+ ", montantApprouve="
+ montantApprouve
+ ", devise='"
+ devise
+ '\''
+ "} "
+ super.toString();
}
}

470
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/enums/analytics/FormatExport.java
View File

@@ -2,232 +2,256 @@ package dev.lions.unionflow.server.api.enums.analytics;
/**
* Énumération des formats d'export disponibles pour les rapports et données analytics
*
* Cette énumération définit les différents formats dans lesquels les données
* peuvent être exportées depuis l'application UnionFlow.
*
*
* <p>Cette énumération définit les différents formats dans lesquels les données peuvent être
* exportées depuis l'application UnionFlow.
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
*/
public enum FormatExport {
// === FORMATS DOCUMENTS ===
PDF("PDF", "pdf", "application/pdf", "Portable Document Format", true, true),
WORD("Word", "docx", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "Microsoft Word", true, false),
// === FORMATS TABLEURS ===
EXCEL("Excel", "xlsx", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "Microsoft Excel", true, true),
CSV("CSV", "csv", "text/csv", "Comma Separated Values", false, true),
// === FORMATS DONNÉES ===
JSON("JSON", "json", "application/json", "JavaScript Object Notation", false, true),
XML("XML", "xml", "application/xml", "eXtensible Markup Language", false, false),
// === FORMATS IMAGES ===
PNG("PNG", "png", "image/png", "Portable Network Graphics", true, false),
JPEG("JPEG", "jpg", "image/jpeg", "Joint Photographic Experts Group", true, false),
SVG("SVG", "svg", "image/svg+xml", "Scalable Vector Graphics", true, false),
// === FORMATS SPÉCIALISÉS ===
POWERPOINT("PowerPoint", "pptx", "application/vnd.openxmlformats-officedocument.presentationml.presentation", "Microsoft PowerPoint", true, false),
HTML("HTML", "html", "text/html", "HyperText Markup Language", true, false);
private final String libelle;
private final String extension;
private final String mimeType;
private final String description;
private final boolean supporteGraphiques;
private final boolean supporteGrandesQuantitesDonnees;
/**
* Constructeur de l'énumération FormatExport
*
* @param libelle Le libellé affiché à l'utilisateur
* @param extension L'extension de fichier
* @param mimeType Le type MIME du format
* @param description La description du format
* @param supporteGraphiques true si le format supporte les graphiques
* @param supporteGrandesQuantitesDonnees true si le format supporte de grandes quantités de données
*/
FormatExport(String libelle, String extension, String mimeType, String description,
boolean supporteGraphiques, boolean supporteGrandesQuantitesDonnees) {
this.libelle = libelle;
this.extension = extension;
this.mimeType = mimeType;
this.description = description;
this.supporteGraphiques = supporteGraphiques;
this.supporteGrandesQuantitesDonnees = supporteGrandesQuantitesDonnees;
}
/**
* Retourne le libellé du format
*
* @return Le libellé affiché à l'utilisateur
*/
public String getLibelle() {
return libelle;
}
/**
* Retourne l'extension de fichier
*
* @return L'extension sans le point (ex: "pdf", "xlsx")
*/
public String getExtension() {
return extension;
}
/**
* Retourne le type MIME du format
*
* @return Le type MIME complet
*/
public String getMimeType() {
return mimeType;
}
/**
* Retourne la description du format
*
* @return La description complète du format
*/
public String getDescription() {
return description;
}
/**
* Vérifie si le format supporte les graphiques
*
* @return true si le format peut inclure des graphiques
*/
public boolean supporteGraphiques() {
return supporteGraphiques;
}
/**
* Vérifie si le format supporte de grandes quantités de données
*
* @return true si le format peut gérer de gros volumes de données
*/
public boolean supporteGrandesQuantitesDonnees() {
return supporteGrandesQuantitesDonnees;
}
/**
* Vérifie si le format est adapté aux rapports exécutifs
*
* @return true si le format convient aux rapports de direction
*/
public boolean isFormatExecutif() {
return this == PDF || this == POWERPOINT || this == WORD;
}
/**
* Vérifie si le format est adapté à l'analyse de données
*
* @return true si le format convient à l'analyse de données
*/
public boolean isFormatAnalyse() {
return this == EXCEL || this == CSV || this == JSON;
}
/**
* Vérifie si le format est adapté au partage web
*
* @return true si le format convient au partage sur le web
*/
public boolean isFormatWeb() {
return this == HTML || this == PNG || this == SVG || this == JSON;
}
/**
* Retourne l'icône appropriée pour le format
*
* @return L'icône Material Design
*/
public String getIcone() {
return switch (this) {
case PDF -> "picture_as_pdf";
case WORD -> "description";
case EXCEL -> "table_chart";
case CSV -> "grid_on";
case JSON -> "code";
case XML -> "code";
case PNG, JPEG -> "image";
case SVG -> "vector_image";
case POWERPOINT -> "slideshow";
case HTML -> "web";
};
}
/**
* Retourne la couleur appropriée pour le format
*
* @return Le code couleur hexadécimal
*/
public String getCouleur() {
return switch (this) {
case PDF -> "#FF5722"; // Rouge-orange
case WORD -> "#2196F3"; // Bleu
case EXCEL -> "#4CAF50"; // Vert
case CSV -> "#607D8B"; // Bleu gris
case JSON -> "#FF9800"; // Orange
case XML -> "#795548"; // Marron
case PNG, JPEG -> "#E91E63"; // Rose
case SVG -> "#9C27B0"; // Violet
case POWERPOINT -> "#FF5722"; // Rouge-orange
case HTML -> "#00BCD4"; // Cyan
};
}
/**
* Génère un nom de fichier avec l'extension appropriée
*
* @param nomBase Le nom de base du fichier
* @return Le nom de fichier complet avec extension
*/
public String genererNomFichier(String nomBase) {
return nomBase + "." + extension;
}
/**
* Retourne la taille maximale recommandée pour ce format (en MB)
*
* @return La taille maximale en mégaoctets
*/
public int getTailleMaximaleRecommandee() {
return switch (this) {
case PDF, WORD, POWERPOINT -> 50; // 50 MB pour les documents
case EXCEL -> 100; // 100 MB pour Excel
case CSV, JSON, XML -> 200; // 200 MB pour les données
case PNG, JPEG -> 10; // 10 MB pour les images
case SVG, HTML -> 5; // 5 MB pour les formats légers
};
}
/**
* Vérifie si le format nécessite un traitement spécial
*
* @return true si le format nécessite un traitement particulier
*/
public boolean necessiteTraitementSpecial() {
return this == PDF || this == EXCEL || this == POWERPOINT || this == WORD;
}
/**
* Retourne les formats recommandés pour un type de rapport donné
*
* @param typeRapport Le type de rapport (executif, analytique, technique)
* @return Un tableau des formats recommandés
*/
public static FormatExport[] getFormatsRecommandes(String typeRapport) {
return switch (typeRapport.toLowerCase()) {
case "executif" -> new FormatExport[]{PDF, POWERPOINT, WORD};
case "analytique" -> new FormatExport[]{EXCEL, CSV, JSON, PDF};
case "technique" -> new FormatExport[]{JSON, XML, CSV, HTML};
case "partage" -> new FormatExport[]{PDF, PNG, HTML};
default -> new FormatExport[]{PDF, EXCEL, CSV};
};
}
// === FORMATS DOCUMENTS ===
PDF("PDF", "pdf", "application/pdf", "Portable Document Format", true, true),
WORD(
"Word",
"docx",
"application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"Microsoft Word",
true,
false),
// === FORMATS TABLEURS ===
EXCEL(
"Excel",
"xlsx",
"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"Microsoft Excel",
true,
true),
CSV("CSV", "csv", "text/csv", "Comma Separated Values", false, true),
// === FORMATS DONNÉES ===
JSON("JSON", "json", "application/json", "JavaScript Object Notation", false, true),
XML("XML", "xml", "application/xml", "eXtensible Markup Language", false, false),
// === FORMATS IMAGES ===
PNG("PNG", "png", "image/png", "Portable Network Graphics", true, false),
JPEG("JPEG", "jpg", "image/jpeg", "Joint Photographic Experts Group", true, false),
SVG("SVG", "svg", "image/svg+xml", "Scalable Vector Graphics", true, false),
// === FORMATS SPÉCIALISÉS ===
POWERPOINT(
"PowerPoint",
"pptx",
"application/vnd.openxmlformats-officedocument.presentationml.presentation",
"Microsoft PowerPoint",
true,
false),
HTML("HTML", "html", "text/html", "HyperText Markup Language", true, false);
private final String libelle;
private final String extension;
private final String mimeType;
private final String description;
private final boolean supporteGraphiques;
private final boolean supporteGrandesQuantitesDonnees;
/**
* Constructeur de l'énumération FormatExport
*
* @param libelle Le libellé affiché à l'utilisateur
* @param extension L'extension de fichier
* @param mimeType Le type MIME du format
* @param description La description du format
* @param supporteGraphiques true si le format supporte les graphiques
* @param supporteGrandesQuantitesDonnees true si le format supporte de grandes quantités de
* données
*/
FormatExport(
String libelle,
String extension,
String mimeType,
String description,
boolean supporteGraphiques,
boolean supporteGrandesQuantitesDonnees) {
this.libelle = libelle;
this.extension = extension;
this.mimeType = mimeType;
this.description = description;
this.supporteGraphiques = supporteGraphiques;
this.supporteGrandesQuantitesDonnees = supporteGrandesQuantitesDonnees;
}
/**
* Retourne le libellé du format
*
* @return Le libellé affiché à l'utilisateur
*/
public String getLibelle() {
return libelle;
}
/**
* Retourne l'extension de fichier
*
* @return L'extension sans le point (ex: "pdf", "xlsx")
*/
public String getExtension() {
return extension;
}
/**
* Retourne le type MIME du format
*
* @return Le type MIME complet
*/
public String getMimeType() {
return mimeType;
}
/**
* Retourne la description du format
*
* @return La description complète du format
*/
public String getDescription() {
return description;
}
/**
* Vérifie si le format supporte les graphiques
*
* @return true si le format peut inclure des graphiques
*/
public boolean supporteGraphiques() {
return supporteGraphiques;
}
/**
* Vérifie si le format supporte de grandes quantités de données
*
* @return true si le format peut gérer de gros volumes de données
*/
public boolean supporteGrandesQuantitesDonnees() {
return supporteGrandesQuantitesDonnees;
}
/**
* Vérifie si le format est adapté aux rapports exécutifs
*
* @return true si le format convient aux rapports de direction
*/
public boolean isFormatExecutif() {
return this == PDF || this == POWERPOINT || this == WORD;
}
/**
* Vérifie si le format est adapté à l'analyse de données
*
* @return true si le format convient à l'analyse de données
*/
public boolean isFormatAnalyse() {
return this == EXCEL || this == CSV || this == JSON;
}
/**
* Vérifie si le format est adapté au partage web
*
* @return true si le format convient au partage sur le web
*/
public boolean isFormatWeb() {
return this == HTML || this == PNG || this == SVG || this == JSON;
}
/**
* Retourne l'icône appropriée pour le format
*
* @return L'icône Material Design
*/
public String getIcone() {
return switch (this) {
case PDF -> "picture_as_pdf";
case WORD -> "description";
case EXCEL -> "table_chart";
case CSV -> "grid_on";
case JSON -> "code";
case XML -> "code";
case PNG, JPEG -> "image";
case SVG -> "vector_image";
case POWERPOINT -> "slideshow";
case HTML -> "web";
};
}
/**
* Retourne la couleur appropriée pour le format
*
* @return Le code couleur hexadécimal
*/
public String getCouleur() {
return switch (this) {
case PDF -> "#FF5722"; // Rouge-orange
case WORD -> "#2196F3"; // Bleu
case EXCEL -> "#4CAF50"; // Vert
case CSV -> "#607D8B"; // Bleu gris
case JSON -> "#FF9800"; // Orange
case XML -> "#795548"; // Marron
case PNG, JPEG -> "#E91E63"; // Rose
case SVG -> "#9C27B0"; // Violet
case POWERPOINT -> "#FF5722"; // Rouge-orange
case HTML -> "#00BCD4"; // Cyan
};
}
/**
* Génère un nom de fichier avec l'extension appropriée
*
* @param nomBase Le nom de base du fichier
* @return Le nom de fichier complet avec extension
*/
public String genererNomFichier(String nomBase) {
return nomBase + "." + extension;
}
/**
* Retourne la taille maximale recommandée pour ce format (en MB)
*
* @return La taille maximale en mégaoctets
*/
public int getTailleMaximaleRecommandee() {
return switch (this) {
case PDF, WORD, POWERPOINT -> 50; // 50 MB pour les documents
case EXCEL -> 100; // 100 MB pour Excel
case CSV, JSON, XML -> 200; // 200 MB pour les données
case PNG, JPEG -> 10; // 10 MB pour les images
case SVG, HTML -> 5; // 5 MB pour les formats légers
};
}
/**
* Vérifie si le format nécessite un traitement spécial
*
* @return true si le format nécessite un traitement particulier
*/
public boolean necessiteTraitementSpecial() {
return this == PDF || this == EXCEL || this == POWERPOINT || this == WORD;
}
/**
* Retourne les formats recommandés pour un type de rapport donné
*
* @param typeRapport Le type de rapport (executif, analytique, technique)
* @return Un tableau des formats recommandés
*/
public static FormatExport[] getFormatsRecommandes(String typeRapport) {
return switch (typeRapport.toLowerCase()) {
case "executif" -> new FormatExport[] {PDF, POWERPOINT, WORD};
case "analytique" -> new FormatExport[] {EXCEL, CSV, JSON, PDF};
case "technique" -> new FormatExport[] {JSON, XML, CSV, HTML};
case "partage" -> new FormatExport[] {PDF, PNG, HTML};
default -> new FormatExport[] {PDF, EXCEL, CSV};
};
}
}

407
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/enums/analytics/PeriodeAnalyse.java
View File

@@ -5,203 +5,222 @@ import java.time.temporal.ChronoUnit;
/**
* Énumération des périodes d'analyse disponibles pour les métriques et rapports
*
* Cette énumération définit les différentes périodes temporelles qui peuvent être
* utilisées pour analyser les données et générer des rapports.
*
*
* <p>Cette énumération définit les différentes périodes temporelles qui peuvent être utilisées pour
* analyser les données et générer des rapports.
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
*/
public enum PeriodeAnalyse {
// === PÉRIODES COURTES ===
AUJOURD_HUI("Aujourd'hui", "today", 1, ChronoUnit.DAYS),
HIER("Hier", "yesterday", 1, ChronoUnit.DAYS),
CETTE_SEMAINE("Cette semaine", "this_week", 7, ChronoUnit.DAYS),
SEMAINE_DERNIERE("Semaine dernière", "last_week", 7, ChronoUnit.DAYS),
// === PÉRIODES MENSUELLES ===
CE_MOIS("Ce mois", "this_month", 1, ChronoUnit.MONTHS),
MOIS_DERNIER("Mois dernier", "last_month", 1, ChronoUnit.MONTHS),
TROIS_DERNIERS_MOIS("3 derniers mois", "last_3_months", 3, ChronoUnit.MONTHS),
SIX_DERNIERS_MOIS("6 derniers mois", "last_6_months", 6, ChronoUnit.MONTHS),
// === PÉRIODES ANNUELLES ===
CETTE_ANNEE("Cette année", "this_year", 1, ChronoUnit.YEARS),
ANNEE_DERNIERE("Année dernière", "last_year", 1, ChronoUnit.YEARS),
DEUX_DERNIERES_ANNEES("2 dernières années", "last_2_years", 2, ChronoUnit.YEARS),
// === PÉRIODES PERSONNALISÉES ===
SEPT_DERNIERS_JOURS("7 derniers jours", "last_7_days", 7, ChronoUnit.DAYS),
TRENTE_DERNIERS_JOURS("30 derniers jours", "last_30_days", 30, ChronoUnit.DAYS),
QUATRE_VINGT_DIX_DERNIERS_JOURS("90 derniers jours", "last_90_days", 90, ChronoUnit.DAYS),
// === PÉRIODES SPÉCIALES ===
DEPUIS_CREATION("Depuis la création", "since_creation", 0, ChronoUnit.FOREVER),
PERIODE_PERSONNALISEE("Période personnalisée", "custom", 0, ChronoUnit.DAYS);
private final String libelle;
private final String code;
private final int duree;
private final ChronoUnit unite;
/**
* Constructeur de l'énumération PeriodeAnalyse
*
* @param libelle Le libellé affiché à l'utilisateur
* @param code Le code technique de la période
* @param duree La durée de la période
* @param unite L'unité de temps (jours, mois, années)
*/
PeriodeAnalyse(String libelle, String code, int duree, ChronoUnit unite) {
this.libelle = libelle;
this.code = code;
this.duree = duree;
this.unite = unite;
}
/**
* Retourne le libellé de la période
*
* @return Le libellé affiché à l'utilisateur
*/
public String getLibelle() {
return libelle;
}
/**
* Retourne le code technique de la période
*
* @return Le code technique
*/
public String getCode() {
return code;
}
/**
* Retourne la durée de la période
*
* @return La durée numérique
*/
public int getDuree() {
return duree;
}
/**
* Retourne l'unité de temps de la période
*
* @return L'unité de temps (ChronoUnit)
*/
public ChronoUnit getUnite() {
return unite;
}
/**
* Calcule la date de début pour cette période
*
* @return La date de début de la période
*/
public LocalDateTime getDateDebut() {
LocalDateTime maintenant = LocalDateTime.now();
return switch (this) {
case AUJOURD_HUI -> maintenant.toLocalDate().atStartOfDay();
case HIER -> maintenant.minusDays(1).toLocalDate().atStartOfDay();
case CETTE_SEMAINE -> maintenant.minusDays(maintenant.getDayOfWeek().getValue() - 1).toLocalDate().atStartOfDay();
case SEMAINE_DERNIERE -> maintenant.minusDays(maintenant.getDayOfWeek().getValue() + 6).toLocalDate().atStartOfDay();
case CE_MOIS -> maintenant.withDayOfMonth(1).toLocalDate().atStartOfDay();
case MOIS_DERNIER -> maintenant.minusMonths(1).withDayOfMonth(1).toLocalDate().atStartOfDay();
case CETTE_ANNEE -> maintenant.withDayOfYear(1).toLocalDate().atStartOfDay();
case ANNEE_DERNIERE -> maintenant.minusYears(1).withDayOfYear(1).toLocalDate().atStartOfDay();
case DEPUIS_CREATION -> LocalDateTime.of(2020, 1, 1, 0, 0); // Date de création d'UnionFlow
case PERIODE_PERSONNALISEE -> maintenant; // À définir par l'utilisateur
default -> maintenant.minus(duree, unite).toLocalDate().atStartOfDay();
};
}
/**
* Calcule la date de fin pour cette période
*
* @return La date de fin de la période
*/
public LocalDateTime getDateFin() {
LocalDateTime maintenant = LocalDateTime.now();
return switch (this) {
case AUJOURD_HUI -> maintenant.toLocalDate().atTime(23, 59, 59);
case HIER -> maintenant.minusDays(1).toLocalDate().atTime(23, 59, 59);
case CETTE_SEMAINE -> maintenant.toLocalDate().atTime(23, 59, 59);
case SEMAINE_DERNIERE -> maintenant.minusDays(maintenant.getDayOfWeek().getValue()).toLocalDate().atTime(23, 59, 59);
case CE_MOIS -> maintenant.toLocalDate().atTime(23, 59, 59);
case MOIS_DERNIER -> maintenant.withDayOfMonth(1).minusDays(1).toLocalDate().atTime(23, 59, 59);
case CETTE_ANNEE -> maintenant.toLocalDate().atTime(23, 59, 59);
case ANNEE_DERNIERE -> maintenant.withDayOfYear(1).minusDays(1).toLocalDate().atTime(23, 59, 59);
case DEPUIS_CREATION, PERIODE_PERSONNALISEE -> maintenant;
default -> maintenant.toLocalDate().atTime(23, 59, 59);
};
}
/**
* Vérifie si la période est une période courte (moins d'un mois)
*
* @return true si la période est courte
*/
public boolean isPeriodeCourte() {
return this == AUJOURD_HUI || this == HIER || this == CETTE_SEMAINE ||
this == SEMAINE_DERNIERE || this == SEPT_DERNIERS_JOURS;
}
/**
* Vérifie si la période est une période longue (plus d'un an)
*
* @return true si la période est longue
*/
public boolean isPeriodeLongue() {
return this == CETTE_ANNEE || this == ANNEE_DERNIERE ||
this == DEUX_DERNIERES_ANNEES || this == DEPUIS_CREATION;
}
/**
* Vérifie si la période est personnalisable
*
* @return true si la période peut être personnalisée
*/
public boolean isPersonnalisable() {
return this == PERIODE_PERSONNALISEE;
}
/**
* Retourne l'intervalle de regroupement recommandé pour cette période
*
* @return L'intervalle de regroupement (jour, semaine, mois)
*/
public String getIntervalleRegroupement() {
return switch (this) {
case AUJOURD_HUI, HIER -> "heure";
case CETTE_SEMAINE, SEMAINE_DERNIERE, SEPT_DERNIERS_JOURS -> "jour";
case CE_MOIS, MOIS_DERNIER, TRENTE_DERNIERS_JOURS -> "jour";
case TROIS_DERNIERS_MOIS, SIX_DERNIERS_MOIS, QUATRE_VINGT_DIX_DERNIERS_JOURS -> "semaine";
case CETTE_ANNEE, ANNEE_DERNIERE, DEUX_DERNIERES_ANNEES -> "mois";
case DEPUIS_CREATION -> "annee";
default -> "jour";
};
}
/**
* Retourne le format de date approprié pour cette période
*
* @return Le format de date (dd/MM, MM/yyyy, etc.)
*/
public String getFormatDate() {
return switch (this) {
case AUJOURD_HUI, HIER -> "HH:mm";
case CETTE_SEMAINE, SEMAINE_DERNIERE, SEPT_DERNIERS_JOURS -> "dd/MM";
case CE_MOIS, MOIS_DERNIER, TRENTE_DERNIERS_JOURS -> "dd/MM";
case TROIS_DERNIERS_MOIS, SIX_DERNIERS_MOIS, QUATRE_VINGT_DIX_DERNIERS_JOURS -> "dd/MM";
case CETTE_ANNEE, ANNEE_DERNIERE -> "MM/yyyy";
case DEUX_DERNIERES_ANNEES, DEPUIS_CREATION -> "yyyy";
default -> "dd/MM/yyyy";
};
}
// === PÉRIODES COURTES ===
AUJOURD_HUI("Aujourd'hui", "today", 1, ChronoUnit.DAYS),
HIER("Hier", "yesterday", 1, ChronoUnit.DAYS),
CETTE_SEMAINE("Cette semaine", "this_week", 7, ChronoUnit.DAYS),
SEMAINE_DERNIERE("Semaine dernière", "last_week", 7, ChronoUnit.DAYS),
// === PÉRIODES MENSUELLES ===
CE_MOIS("Ce mois", "this_month", 1, ChronoUnit.MONTHS),
MOIS_DERNIER("Mois dernier", "last_month", 1, ChronoUnit.MONTHS),
TROIS_DERNIERS_MOIS("3 derniers mois", "last_3_months", 3, ChronoUnit.MONTHS),
SIX_DERNIERS_MOIS("6 derniers mois", "last_6_months", 6, ChronoUnit.MONTHS),
// === PÉRIODES ANNUELLES ===
CETTE_ANNEE("Cette année", "this_year", 1, ChronoUnit.YEARS),
ANNEE_DERNIERE("Année dernière", "last_year", 1, ChronoUnit.YEARS),
DEUX_DERNIERES_ANNEES("2 dernières années", "last_2_years", 2, ChronoUnit.YEARS),
// === PÉRIODES PERSONNALISÉES ===
SEPT_DERNIERS_JOURS("7 derniers jours", "last_7_days", 7, ChronoUnit.DAYS),
TRENTE_DERNIERS_JOURS("30 derniers jours", "last_30_days", 30, ChronoUnit.DAYS),
QUATRE_VINGT_DIX_DERNIERS_JOURS("90 derniers jours", "last_90_days", 90, ChronoUnit.DAYS),
// === PÉRIODES SPÉCIALES ===
DEPUIS_CREATION("Depuis la création", "since_creation", 0, ChronoUnit.FOREVER),
PERIODE_PERSONNALISEE("Période personnalisée", "custom", 0, ChronoUnit.DAYS);
private final String libelle;
private final String code;
private final int duree;
private final ChronoUnit unite;
/**
* Constructeur de l'énumération PeriodeAnalyse
*
* @param libelle Le libellé affiché à l'utilisateur
* @param code Le code technique de la période
* @param duree La durée de la période
* @param unite L'unité de temps (jours, mois, années)
*/
PeriodeAnalyse(String libelle, String code, int duree, ChronoUnit unite) {
this.libelle = libelle;
this.code = code;
this.duree = duree;
this.unite = unite;
}
/**
* Retourne le libellé de la période
*
* @return Le libellé affiché à l'utilisateur
*/
public String getLibelle() {
return libelle;
}
/**
* Retourne le code technique de la période
*
* @return Le code technique
*/
public String getCode() {
return code;
}
/**
* Retourne la durée de la période
*
* @return La durée numérique
*/
public int getDuree() {
return duree;
}
/**
* Retourne l'unité de temps de la période
*
* @return L'unité de temps (ChronoUnit)
*/
public ChronoUnit getUnite() {
return unite;
}
/**
* Calcule la date de début pour cette période
*
* @return La date de début de la période
*/
public LocalDateTime getDateDebut() {
LocalDateTime maintenant = LocalDateTime.now();
return switch (this) {
case AUJOURD_HUI -> maintenant.toLocalDate().atStartOfDay();
case HIER -> maintenant.minusDays(1).toLocalDate().atStartOfDay();
case CETTE_SEMAINE ->
maintenant
.minusDays(maintenant.getDayOfWeek().getValue() - 1)
.toLocalDate()
.atStartOfDay();
case SEMAINE_DERNIERE ->
maintenant
.minusDays(maintenant.getDayOfWeek().getValue() + 6)
.toLocalDate()
.atStartOfDay();
case CE_MOIS -> maintenant.withDayOfMonth(1).toLocalDate().atStartOfDay();
case MOIS_DERNIER -> maintenant.minusMonths(1).withDayOfMonth(1).toLocalDate().atStartOfDay();
case CETTE_ANNEE -> maintenant.withDayOfYear(1).toLocalDate().atStartOfDay();
case ANNEE_DERNIERE -> maintenant.minusYears(1).withDayOfYear(1).toLocalDate().atStartOfDay();
case DEPUIS_CREATION -> LocalDateTime.of(2020, 1, 1, 0, 0); // Date de création d'UnionFlow
case PERIODE_PERSONNALISEE -> maintenant; // À définir par l'utilisateur
default -> maintenant.minus(duree, unite).toLocalDate().atStartOfDay();
};
}
/**
* Calcule la date de fin pour cette période
*
* @return La date de fin de la période
*/
public LocalDateTime getDateFin() {
LocalDateTime maintenant = LocalDateTime.now();
return switch (this) {
case AUJOURD_HUI -> maintenant.toLocalDate().atTime(23, 59, 59);
case HIER -> maintenant.minusDays(1).toLocalDate().atTime(23, 59, 59);
case CETTE_SEMAINE -> maintenant.toLocalDate().atTime(23, 59, 59);
case SEMAINE_DERNIERE ->
maintenant
.minusDays(maintenant.getDayOfWeek().getValue())
.toLocalDate()
.atTime(23, 59, 59);
case CE_MOIS -> maintenant.toLocalDate().atTime(23, 59, 59);
case MOIS_DERNIER ->
maintenant.withDayOfMonth(1).minusDays(1).toLocalDate().atTime(23, 59, 59);
case CETTE_ANNEE -> maintenant.toLocalDate().atTime(23, 59, 59);
case ANNEE_DERNIERE ->
maintenant.withDayOfYear(1).minusDays(1).toLocalDate().atTime(23, 59, 59);
case DEPUIS_CREATION, PERIODE_PERSONNALISEE -> maintenant;
default -> maintenant.toLocalDate().atTime(23, 59, 59);
};
}
/**
* Vérifie si la période est une période courte (moins d'un mois)
*
* @return true si la période est courte
*/
public boolean isPeriodeCourte() {
return this == AUJOURD_HUI
|| this == HIER
|| this == CETTE_SEMAINE
|| this == SEMAINE_DERNIERE
|| this == SEPT_DERNIERS_JOURS;
}
/**
* Vérifie si la période est une période longue (plus d'un an)
*
* @return true si la période est longue
*/
public boolean isPeriodeLongue() {
return this == CETTE_ANNEE
|| this == ANNEE_DERNIERE
|| this == DEUX_DERNIERES_ANNEES
|| this == DEPUIS_CREATION;
}
/**
* Vérifie si la période est personnalisable
*
* @return true si la période peut être personnalisée
*/
public boolean isPersonnalisable() {
return this == PERIODE_PERSONNALISEE;
}
/**
* Retourne l'intervalle de regroupement recommandé pour cette période
*
* @return L'intervalle de regroupement (jour, semaine, mois)
*/
public String getIntervalleRegroupement() {
return switch (this) {
case AUJOURD_HUI, HIER -> "heure";
case CETTE_SEMAINE, SEMAINE_DERNIERE, SEPT_DERNIERS_JOURS -> "jour";
case CE_MOIS, MOIS_DERNIER, TRENTE_DERNIERS_JOURS -> "jour";
case TROIS_DERNIERS_MOIS, SIX_DERNIERS_MOIS, QUATRE_VINGT_DIX_DERNIERS_JOURS -> "semaine";
case CETTE_ANNEE, ANNEE_DERNIERE, DEUX_DERNIERES_ANNEES -> "mois";
case DEPUIS_CREATION -> "annee";
default -> "jour";
};
}
/**
* Retourne le format de date approprié pour cette période
*
* @return Le format de date (dd/MM, MM/yyyy, etc.)
*/
public String getFormatDate() {
return switch (this) {
case AUJOURD_HUI, HIER -> "HH:mm";
case CETTE_SEMAINE, SEMAINE_DERNIERE, SEPT_DERNIERS_JOURS -> "dd/MM";
case CE_MOIS, MOIS_DERNIER, TRENTE_DERNIERS_JOURS -> "dd/MM";
case TROIS_DERNIERS_MOIS, SIX_DERNIERS_MOIS, QUATRE_VINGT_DIX_DERNIERS_JOURS -> "dd/MM";
case CETTE_ANNEE, ANNEE_DERNIERE -> "MM/yyyy";
case DEUX_DERNIERES_ANNEES, DEPUIS_CREATION -> "yyyy";
default -> "dd/MM/yyyy";
};
}
}

354
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/enums/analytics/TypeMetrique.java
View File

@@ -2,186 +2,186 @@ package dev.lions.unionflow.server.api.enums.analytics;
/**
* Énumération des types de métriques disponibles dans le système analytics UnionFlow
*
* Cette énumération définit les différents types de métriques qui peuvent être
* calculées et affichées dans les tableaux de bord et rapports.
*
*
* <p>Cette énumération définit les différents types de métriques qui peuvent être calculées et
* affichées dans les tableaux de bord et rapports.
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
*/
public enum TypeMetrique {
// === MÉTRIQUES MEMBRES ===
NOMBRE_MEMBRES_ACTIFS("Nombre de membres actifs", "membres", "count"),
NOMBRE_MEMBRES_INACTIFS("Nombre de membres inactifs", "membres", "count"),
TAUX_CROISSANCE_MEMBRES("Taux de croissance des membres", "membres", "percentage"),
MOYENNE_AGE_MEMBRES("Âge moyen des membres", "membres", "average"),
REPARTITION_GENRE_MEMBRES("Répartition par genre", "membres", "distribution"),
// === MÉTRIQUES FINANCIÈRES ===
TOTAL_COTISATIONS_COLLECTEES("Total des cotisations collectées", "finance", "amount"),
COTISATIONS_EN_ATTENTE("Cotisations en attente", "finance", "amount"),
TAUX_RECOUVREMENT_COTISATIONS("Taux de recouvrement", "finance", "percentage"),
MOYENNE_COTISATION_MEMBRE("Cotisation moyenne par membre", "finance", "average"),
EVOLUTION_REVENUS_MENSUELLE("Évolution des revenus mensuels", "finance", "trend"),
// === MÉTRIQUES ÉVÉNEMENTS ===
NOMBRE_EVENEMENTS_ORGANISES("Nombre d'événements organisés", "evenements", "count"),
TAUX_PARTICIPATION_EVENEMENTS("Taux de participation aux événements", "evenements", "percentage"),
MOYENNE_PARTICIPANTS_EVENEMENT("Moyenne de participants par événement", "evenements", "average"),
EVENEMENTS_ANNULES("Événements annulés", "evenements", "count"),
SATISFACTION_EVENEMENTS("Satisfaction des événements", "evenements", "rating"),
// === MÉTRIQUES SOLIDARITÉ ===
NOMBRE_DEMANDES_AIDE("Nombre de demandes d'aide", "solidarite", "count"),
MONTANT_AIDES_ACCORDEES("Montant des aides accordées", "solidarite", "amount"),
TAUX_APPROBATION_AIDES("Taux d'approbation des aides", "solidarite", "percentage"),
DELAI_TRAITEMENT_DEMANDES("Délai moyen de traitement", "solidarite", "duration"),
IMPACT_SOCIAL_MESURE("Impact social mesuré", "solidarite", "score"),
// === MÉTRIQUES ENGAGEMENT ===
TAUX_CONNEXION_MOBILE("Taux de connexion mobile", "engagement", "percentage"),
FREQUENCE_UTILISATION_APP("Fréquence d'utilisation de l'app", "engagement", "frequency"),
ACTIONS_UTILISATEUR_JOUR("Actions utilisateur par jour", "engagement", "count"),
RETENTION_UTILISATEURS("Rétention des utilisateurs", "engagement", "percentage"),
NPS_SATISFACTION("Net Promoter Score", "engagement", "score"),
// === MÉTRIQUES ORGANISATIONNELLES ===
NOMBRE_ORGANISATIONS_ACTIVES("Organisations actives", "organisation", "count"),
TAUX_CROISSANCE_ORGANISATIONS("Croissance des organisations", "organisation", "percentage"),
MOYENNE_MEMBRES_PAR_ORGANISATION("Membres moyens par organisation", "organisation", "average"),
ORGANISATIONS_PREMIUM("Organisations premium", "organisation", "count"),
CHURN_RATE_ORGANISATIONS("Taux de désabonnement", "organisation", "percentage"),
// === MÉTRIQUES TECHNIQUES ===
TEMPS_REPONSE_API("Temps de réponse API", "technique", "duration"),
TAUX_DISPONIBILITE_SYSTEME("Taux de disponibilité", "technique", "percentage"),
NOMBRE_ERREURS_SYSTEME("Nombre d'erreurs système", "technique", "count"),
UTILISATION_STOCKAGE("Utilisation du stockage", "technique", "size"),
PERFORMANCE_MOBILE("Performance mobile", "technique", "score");
private final String libelle;
private final String categorie;
private final String typeValeur;
/**
* Constructeur de l'énumération TypeMetrique
*
* @param libelle Le libellé affiché à l'utilisateur
* @param categorie La catégorie de la métrique
* @param typeValeur Le type de valeur (count, percentage, amount, etc.)
*/
TypeMetrique(String libelle, String categorie, String typeValeur) {
this.libelle = libelle;
this.categorie = categorie;
this.typeValeur = typeValeur;
}
/**
* Retourne le libellé de la métrique
*
* @return Le libellé affiché à l'utilisateur
*/
public String getLibelle() {
return libelle;
}
/**
* Retourne la catégorie de la métrique
*
* @return La catégorie (membres, finance, evenements, etc.)
*/
public String getCategorie() {
return categorie;
}
/**
* Retourne le type de valeur de la métrique
*
* @return Le type de valeur (count, percentage, amount, etc.)
*/
public String getTypeValeur() {
return typeValeur;
}
/**
* Vérifie si la métrique est de type financier
*
* @return true si la métrique concerne les finances
*/
public boolean isFinanciere() {
return "finance".equals(this.categorie);
}
/**
* Vérifie si la métrique est de type pourcentage
*
* @return true si la métrique est un pourcentage
*/
public boolean isPourcentage() {
return "percentage".equals(this.typeValeur);
}
/**
* Vérifie si la métrique est de type compteur
*
* @return true si la métrique est un compteur
*/
public boolean isCompteur() {
return "count".equals(this.typeValeur);
}
/**
* Retourne l'unité de mesure appropriée pour la métrique
*
* @return L'unité de mesure (%, XOF, jours, etc.)
*/
public String getUnite() {
return switch (this.typeValeur) {
case "percentage" -> "%";
case "amount" -> "XOF";
case "duration" -> "jours";
case "size" -> "MB";
case "frequency" -> "/jour";
case "rating", "score" -> "/10";
default -> "";
};
}
/**
* Retourne l'icône appropriée pour la métrique
*
* @return L'icône Material Design
*/
public String getIcone() {
return switch (this.categorie) {
case "membres" -> "people";
case "finance" -> "attach_money";
case "evenements" -> "event";
case "solidarite" -> "favorite";
case "engagement" -> "trending_up";
case "organisation" -> "business";
case "technique" -> "settings";
default -> "analytics";
};
}
/**
* Retourne la couleur appropriée pour la métrique
*
* @return Le code couleur hexadécimal
*/
public String getCouleur() {
return switch (this.categorie) {
case "membres" -> "#2196F3"; // Bleu
case "finance" -> "#4CAF50"; // Vert
case "evenements" -> "#FF9800"; // Orange
case "solidarite" -> "#E91E63"; // Rose
case "engagement" -> "#9C27B0"; // Violet
case "organisation" -> "#607D8B"; // Bleu gris
case "technique" -> "#795548"; // Marron
default -> "#757575"; // Gris
};
}
// === MÉTRIQUES MEMBRES ===
NOMBRE_MEMBRES_ACTIFS("Nombre de membres actifs", "membres", "count"),
NOMBRE_MEMBRES_INACTIFS("Nombre de membres inactifs", "membres", "count"),
TAUX_CROISSANCE_MEMBRES("Taux de croissance des membres", "membres", "percentage"),
MOYENNE_AGE_MEMBRES("Âge moyen des membres", "membres", "average"),
REPARTITION_GENRE_MEMBRES("Répartition par genre", "membres", "distribution"),
// === MÉTRIQUES FINANCIÈRES ===
TOTAL_COTISATIONS_COLLECTEES("Total des cotisations collectées", "finance", "amount"),
COTISATIONS_EN_ATTENTE("Cotisations en attente", "finance", "amount"),
TAUX_RECOUVREMENT_COTISATIONS("Taux de recouvrement", "finance", "percentage"),
MOYENNE_COTISATION_MEMBRE("Cotisation moyenne par membre", "finance", "average"),
EVOLUTION_REVENUS_MENSUELLE("Évolution des revenus mensuels", "finance", "trend"),
// === MÉTRIQUES ÉVÉNEMENTS ===
NOMBRE_EVENEMENTS_ORGANISES("Nombre d'événements organisés", "evenements", "count"),
TAUX_PARTICIPATION_EVENEMENTS("Taux de participation aux événements", "evenements", "percentage"),
MOYENNE_PARTICIPANTS_EVENEMENT("Moyenne de participants par événement", "evenements", "average"),
EVENEMENTS_ANNULES("Événements annulés", "evenements", "count"),
SATISFACTION_EVENEMENTS("Satisfaction des événements", "evenements", "rating"),
// === MÉTRIQUES SOLIDARITÉ ===
NOMBRE_DEMANDES_AIDE("Nombre de demandes d'aide", "solidarite", "count"),
MONTANT_AIDES_ACCORDEES("Montant des aides accordées", "solidarite", "amount"),
TAUX_APPROBATION_AIDES("Taux d'approbation des aides", "solidarite", "percentage"),
DELAI_TRAITEMENT_DEMANDES("Délai moyen de traitement", "solidarite", "duration"),
IMPACT_SOCIAL_MESURE("Impact social mesuré", "solidarite", "score"),
// === MÉTRIQUES ENGAGEMENT ===
TAUX_CONNEXION_MOBILE("Taux de connexion mobile", "engagement", "percentage"),
FREQUENCE_UTILISATION_APP("Fréquence d'utilisation de l'app", "engagement", "frequency"),
ACTIONS_UTILISATEUR_JOUR("Actions utilisateur par jour", "engagement", "count"),
RETENTION_UTILISATEURS("Rétention des utilisateurs", "engagement", "percentage"),
NPS_SATISFACTION("Net Promoter Score", "engagement", "score"),
// === MÉTRIQUES ORGANISATIONNELLES ===
NOMBRE_ORGANISATIONS_ACTIVES("Organisations actives", "organisation", "count"),
TAUX_CROISSANCE_ORGANISATIONS("Croissance des organisations", "organisation", "percentage"),
MOYENNE_MEMBRES_PAR_ORGANISATION("Membres moyens par organisation", "organisation", "average"),
ORGANISATIONS_PREMIUM("Organisations premium", "organisation", "count"),
CHURN_RATE_ORGANISATIONS("Taux de désabonnement", "organisation", "percentage"),
// === MÉTRIQUES TECHNIQUES ===
TEMPS_REPONSE_API("Temps de réponse API", "technique", "duration"),
TAUX_DISPONIBILITE_SYSTEME("Taux de disponibilité", "technique", "percentage"),
NOMBRE_ERREURS_SYSTEME("Nombre d'erreurs système", "technique", "count"),
UTILISATION_STOCKAGE("Utilisation du stockage", "technique", "size"),
PERFORMANCE_MOBILE("Performance mobile", "technique", "score");
private final String libelle;
private final String categorie;
private final String typeValeur;
/**
* Constructeur de l'énumération TypeMetrique
*
* @param libelle Le libellé affiché à l'utilisateur
* @param categorie La catégorie de la métrique
* @param typeValeur Le type de valeur (count, percentage, amount, etc.)
*/
TypeMetrique(String libelle, String categorie, String typeValeur) {
this.libelle = libelle;
this.categorie = categorie;
this.typeValeur = typeValeur;
}
/**
* Retourne le libellé de la métrique
*
* @return Le libellé affiché à l'utilisateur
*/
public String getLibelle() {
return libelle;
}
/**
* Retourne la catégorie de la métrique
*
* @return La catégorie (membres, finance, evenements, etc.)
*/
public String getCategorie() {
return categorie;
}
/**
* Retourne le type de valeur de la métrique
*
* @return Le type de valeur (count, percentage, amount, etc.)
*/
public String getTypeValeur() {
return typeValeur;
}
/**
* Vérifie si la métrique est de type financier
*
* @return true si la métrique concerne les finances
*/
public boolean isFinanciere() {
return "finance".equals(this.categorie);
}
/**
* Vérifie si la métrique est de type pourcentage
*
* @return true si la métrique est un pourcentage
*/
public boolean isPourcentage() {
return "percentage".equals(this.typeValeur);
}
/**
* Vérifie si la métrique est de type compteur
*
* @return true si la métrique est un compteur
*/
public boolean isCompteur() {
return "count".equals(this.typeValeur);
}
/**
* Retourne l'unité de mesure appropriée pour la métrique
*
* @return L'unité de mesure (%, XOF, jours, etc.)
*/
public String getUnite() {
return switch (this.typeValeur) {
case "percentage" -> "%";
case "amount" -> "XOF";
case "duration" -> "jours";
case "size" -> "MB";
case "frequency" -> "/jour";
case "rating", "score" -> "/10";
default -> "";
};
}
/**
* Retourne l'icône appropriée pour la métrique
*
* @return L'icône Material Design
*/
public String getIcone() {
return switch (this.categorie) {
case "membres" -> "people";
case "finance" -> "attach_money";
case "evenements" -> "event";
case "solidarite" -> "favorite";
case "engagement" -> "trending_up";
case "organisation" -> "business";
case "technique" -> "settings";
default -> "analytics";
};
}
/**
* Retourne la couleur appropriée pour la métrique
*
* @return Le code couleur hexadécimal
*/
public String getCouleur() {
return switch (this.categorie) {
case "membres" -> "#2196F3"; // Bleu
case "finance" -> "#4CAF50"; // Vert
case "evenements" -> "#FF9800"; // Orange
case "solidarite" -> "#E91E63"; // Rose
case "engagement" -> "#9C27B0"; // Violet
case "organisation" -> "#607D8B"; // Bleu gris
case "technique" -> "#795548"; // Marron
default -> "#757575"; // Gris
};
}
}

159
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/enums/evenement/PrioriteEvenement.java Normal file
View File

@@ -0,0 +1,159 @@
package dev.lions.unionflow.server.api.enums.evenement;
/**
* Énumération des priorités d'événements dans UnionFlow
*
* <p>Cette énumération définit les niveaux de priorité pour les événements, permettant de prioriser
* l'affichage et les notifications selon l'importance.
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-09-21
*/
public enum PrioriteEvenement {
CRITIQUE(
"Critique",
"critical",
1,
"Événement critique nécessitant une attention immédiate",
"#F44336",
"priority_high",
true,
true),
HAUTE(
"Haute",
"high",
2,
"Événement de haute priorité",
"#FF9800",
"keyboard_arrow_up",
true,
false),
NORMALE(
"Normale", "normal", 3, "Événement de priorité normale", "#2196F3", "remove", false, false),
BASSE(
"Basse",
"low",
4,
"Événement de priorité basse",
"#4CAF50",
"keyboard_arrow_down",
false,
false);
private final String libelle;
private final String code;
private final int niveau;
private final String description;
private final String couleur;
private final String icone;
private final boolean notificationImmediate;
private final boolean escaladeAutomatique;
PrioriteEvenement(
String libelle,
String code,
int niveau,
String description,
String couleur,
String icone,
boolean notificationImmediate,
boolean escaladeAutomatique) {
this.libelle = libelle;
this.code = code;
this.niveau = niveau;
this.description = description;
this.couleur = couleur;
this.icone = icone;
this.notificationImmediate = notificationImmediate;
this.escaladeAutomatique = escaladeAutomatique;
}
// === GETTERS ===
public String getLibelle() {
return libelle;
}
public String getCode() {
return code;
}
public int getNiveau() {
return niveau;
}
public String getDescription() {
return description;
}
public String getCouleur() {
return couleur;
}
public String getIcone() {
return icone;
}
public boolean isNotificationImmediate() {
return notificationImmediate;
}
public boolean isEscaladeAutomatique() {
return escaladeAutomatique;
}
// === MÉTHODES UTILITAIRES ===
/** Vérifie si la priorité est élevée (critique ou haute) */
public boolean isElevee() {
return this == CRITIQUE || this == HAUTE;
}
/** Vérifie si la priorité nécessite une attention immédiate */
public boolean isUrgente() {
return this == CRITIQUE || this == HAUTE;
}
/** Compare deux priorités */
public boolean isSuperieurA(PrioriteEvenement autre) {
return this.niveau < autre.niveau; // Plus le niveau est bas, plus la priorité est haute
}
/** Retourne les priorités élevées */
public static java.util.List<PrioriteEvenement> getPrioritesElevees() {
return java.util.Arrays.stream(values())
.filter(PrioriteEvenement::isElevee)
.collect(java.util.stream.Collectors.toList());
}
/** Retourne les priorités urgentes */
public static java.util.List<PrioriteEvenement> getPrioritesUrgentes() {
return java.util.Arrays.stream(values())
.filter(PrioriteEvenement::isUrgente)
.collect(java.util.stream.Collectors.toList());
}
/** Détermine la priorité basée sur le type d'événement */
public static PrioriteEvenement determinerPriorite(TypeEvenementMetier typeEvenement) {
return switch (typeEvenement) {
case ASSEMBLEE_GENERALE -> HAUTE;
case REUNION_BUREAU -> HAUTE;
case ACTION_CARITATIVE -> NORMALE;
case FORMATION -> NORMALE;
case CONFERENCE -> NORMALE;
case ACTIVITE_SOCIALE -> BASSE;
case ATELIER -> BASSE;
case CEREMONIE -> NORMALE;
case AUTRE -> NORMALE;
};
}
/** Retourne la priorité par défaut */
public static PrioriteEvenement getDefaut() {
return NORMALE;
}
}

233
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/enums/evenement/StatutEvenement.java Normal file
View File

@@ -0,0 +1,233 @@
package dev.lions.unionflow.server.api.enums.evenement;
/**
* Énumération des statuts d'événements dans UnionFlow
*
* <p>Cette énumération définit les différents états qu'un événement peut avoir tout au long de son
* cycle de vie, de la planification à la clôture.
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-09-21
*/
public enum StatutEvenement {
// === STATUTS DE PLANIFICATION ===
PLANIFIE(
"Planifié",
"planned",
"L'événement est planifié et en préparation",
"#2196F3",
"event",
false,
false),
CONFIRME(
"Confirmé",
"confirmed",
"L'événement est confirmé et les inscriptions sont ouvertes",
"#4CAF50",
"event_available",
false,
false),
// === STATUTS D'EXÉCUTION ===
EN_COURS(
"En cours",
"ongoing",
"L'événement est actuellement en cours",
"#FF9800",
"play_circle",
false,
false),
// === STATUTS FINAUX ===
TERMINE(
"Terminé",
"completed",
"L'événement s'est terminé avec succès",
"#4CAF50",
"check_circle",
true,
false),
ANNULE("Annulé", "cancelled", "L'événement a été annulé", "#F44336", "cancel", true, true),
REPORTE(
"Reporté",
"postponed",
"L'événement a été reporté à une date ultérieure",
"#FF5722",
"schedule",
false,
false);
private final String libelle;
private final String code;
private final String description;
private final String couleur;
private final String icone;
private final boolean estFinal;
private final boolean estEchec;
StatutEvenement(
String libelle,
String code,
String description,
String couleur,
String icone,
boolean estFinal,
boolean estEchec) {
this.libelle = libelle;
this.code = code;
this.description = description;
this.couleur = couleur;
this.icone = icone;
this.estFinal = estFinal;
this.estEchec = estEchec;
}
// === GETTERS ===
public String getLibelle() {
return libelle;
}
public String getCode() {
return code;
}
public String getDescription() {
return description;
}
public String getCouleur() {
return couleur;
}
public String getIcone() {
return icone;
}
public boolean isEstFinal() {
return estFinal;
}
public boolean isEstEchec() {
return estEchec;
}
// === MÉTHODES UTILITAIRES ===
/** Vérifie si l'événement peut être modifié */
public boolean permetModification() {
return switch (this) {
case PLANIFIE, CONFIRME, REPORTE -> true;
case EN_COURS, TERMINE, ANNULE -> false;
};
}
/** Vérifie si l'événement peut être annulé */
public boolean permetAnnulation() {
return switch (this) {
case PLANIFIE, CONFIRME, EN_COURS, REPORTE -> true;
case TERMINE, ANNULE -> false;
};
}
/** Vérifie si l'événement est en cours d'exécution */
public boolean isEnCours() {
return this == EN_COURS;
}
/** Vérifie si l'événement est terminé avec succès */
public boolean isSucces() {
return this == TERMINE;
}
/** Retourne les statuts finaux */
public static java.util.List<StatutEvenement> getStatutsFinaux() {
return java.util.Arrays.stream(values())
.filter(StatutEvenement::isEstFinal)
.collect(java.util.stream.Collectors.toList());
}
/** Retourne les statuts d'échec */
public static java.util.List<StatutEvenement> getStatutsEchec() {
return java.util.Arrays.stream(values())
.filter(StatutEvenement::isEstEchec)
.collect(java.util.stream.Collectors.toList());
}
/** Vérifie si la transition vers un autre statut est valide */
public boolean peutTransitionnerVers(StatutEvenement nouveauStatut) {
if (this == nouveauStatut) return false;
if (estFinal && nouveauStatut != REPORTE) return false;
return switch (this) {
case PLANIFIE ->
nouveauStatut == CONFIRME || nouveauStatut == ANNULE || nouveauStatut == REPORTE;
case CONFIRME ->
nouveauStatut == EN_COURS || nouveauStatut == ANNULE || nouveauStatut == REPORTE;
case EN_COURS -> nouveauStatut == TERMINE || nouveauStatut == ANNULE;
case REPORTE -> nouveauStatut == PLANIFIE || nouveauStatut == ANNULE;
default -> false;
};
}
/** Retourne le niveau de priorité pour l'affichage */
public int getNiveauPriorite() {
return switch (this) {
case EN_COURS -> 1;
case CONFIRME -> 2;
case PLANIFIE -> 3;
case REPORTE -> 4;
case TERMINE -> 5;
case ANNULE -> 6;
};
}
// === MÉTHODES STATIQUES ===
/** Retourne les statuts actifs (non finaux) */
public static StatutEvenement[] getStatutsActifs() {
return new StatutEvenement[] {PLANIFIE, CONFIRME, EN_COURS, REPORTE};
}
/** Trouve un statut par son code */
public static StatutEvenement fromCode(String code) {
if (code == null || code.trim().isEmpty()) {
return null;
}
for (StatutEvenement statut : values()) {
if (statut.code.equals(code)) {
return statut;
}
}
return null;
}
/** Trouve un statut par son libellé */
public static StatutEvenement fromLibelle(String libelle) {
if (libelle == null || libelle.trim().isEmpty()) {
return null;
}
for (StatutEvenement statut : values()) {
if (statut.libelle.equals(libelle)) {
return statut;
}
}
return null;
}
/** Retourne les transitions possibles depuis ce statut */
public StatutEvenement[] getTransitionsPossibles() {
return switch (this) {
case PLANIFIE -> new StatutEvenement[] {CONFIRME, ANNULE, REPORTE};
case CONFIRME -> new StatutEvenement[] {EN_COURS, ANNULE, REPORTE};
case EN_COURS -> new StatutEvenement[] {TERMINE, ANNULE};
case REPORTE -> new StatutEvenement[] {PLANIFIE, CONFIRME, ANNULE};
case TERMINE, ANNULE -> new StatutEvenement[] {}; // Aucune transition possible
};
}
}

764
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/enums/notification/CanalNotification.java
View File

@@ -2,320 +2,464 @@ package dev.lions.unionflow.server.api.enums.notification;
/**
* Énumération des canaux de notification pour Android et iOS
*
* Cette énumération définit les différents canaux de notification utilisés
* pour organiser et prioriser les notifications push dans UnionFlow.
*
*
* <p>Cette énumération définit les différents canaux de notification utilisés pour organiser et
* prioriser les notifications push dans UnionFlow.
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
*/
public enum CanalNotification {
// === CANAUX PAR PRIORITÉ ===
URGENT_CHANNEL("urgent", "Notifications urgentes", "Alertes critiques nécessitant une action immédiate",
5, true, true, true, "urgent", "#F44336"),
ERROR_CHANNEL("error", "Erreurs système", "Notifications d'erreurs et de problèmes techniques",
4, true, true, false, "error", "#F44336"),
WARNING_CHANNEL("warning", "Avertissements", "Notifications d'avertissement et d'attention",
4, true, true, false, "warning", "#FF9800"),
IMPORTANT_CHANNEL("important", "Notifications importantes", "Informations importantes à ne pas manquer",
4, true, true, false, "important", "#FF5722"),
REMINDER_CHANNEL("reminder", "Rappels", "Rappels d'événements, cotisations et échéances",
3, true, true, false, "reminder", "#2196F3"),
SUCCESS_CHANNEL("success", "Confirmations", "Notifications de succès et confirmations",
2, false, false, false, "success", "#4CAF50"),
CELEBRATION_CHANNEL("celebration", "Célébrations", "Anniversaires, félicitations et événements joyeux",
2, false, false, false, "celebration", "#FF9800"),
DEFAULT_CHANNEL("default", "Notifications générales", "Notifications d'information générale",
2, false, false, false, "info", "#2196F3"),
// === CANAUX PAR CATÉGORIE ===
EVENTS_CHANNEL("events", "Événements", "Notifications liées aux événements et activités",
3, true, false, false, "event", "#2196F3"),
PAYMENTS_CHANNEL("payments", "Paiements", "Notifications de cotisations et paiements",
4, true, true, false, "payment", "#4CAF50"),
SOLIDARITY_CHANNEL("solidarity", "Solidarité", "Notifications d'aide et de solidarité",
3, true, false, false, "help", "#E91E63"),
MEMBERS_CHANNEL("members", "Membres", "Notifications concernant les membres",
2, false, false, false, "people", "#2196F3"),
ORGANIZATION_CHANNEL("organization", "Organisation", "Annonces et informations organisationnelles",
3, true, false, false, "business", "#2196F3"),
SYSTEM_CHANNEL("system", "Système", "Notifications système et maintenance",
2, false, false, false, "settings", "#607D8B"),
MESSAGES_CHANNEL("messages", "Messages", "Messages privés et communications",
3, true, false, false, "message", "#2196F3"),
LOCATION_CHANNEL("location", "Géolocalisation", "Notifications basées sur la localisation",
2, false, false, false, "location_on", "#4CAF50");
private final String id;
private final String nom;
private final String description;
private final int importance;
private final boolean sonActive;
private final boolean vibrationActive;
private final boolean lumiereLED;
private final String typeDefaut;
private final String couleur;
/**
* Constructeur de l'énumération CanalNotification
*
* @param id L'identifiant unique du canal
* @param nom Le nom affiché du canal
* @param description La description du canal
* @param importance Le niveau d'importance (1=Min, 2=Low, 3=Default, 4=High, 5=Max)
* @param sonActive true si le son est activé par défaut
* @param vibrationActive true si la vibration est activée par défaut
* @param lumiereLED true si la lumière LED est activée par défaut
* @param typeDefaut Le type de notification par défaut pour ce canal
* @param couleur La couleur hexadécimale du canal
*/
CanalNotification(String id, String nom, String description, int importance,
boolean sonActive, boolean vibrationActive, boolean lumiereLED,
String typeDefaut, String couleur) {
this.id = id;
this.nom = nom;
this.description = description;
this.importance = importance;
this.sonActive = sonActive;
this.vibrationActive = vibrationActive;
this.lumiereLED = lumiereLED;
this.typeDefaut = typeDefaut;
this.couleur = couleur;
}
/**
* Retourne l'identifiant du canal
*
* @return L'ID unique du canal
*/
public String getId() {
return id;
}
/**
* Retourne le nom du canal
*
* @return Le nom affiché du canal
*/
public String getNom() {
return nom;
}
/**
* Retourne la description du canal
*
* @return La description détaillée du canal
*/
public String getDescription() {
return description;
}
/**
* Retourne le niveau d'importance
*
* @return Le niveau d'importance (1-5)
*/
public int getImportance() {
return importance;
}
/**
* Vérifie si le son est activé par défaut
*
* @return true si le son est activé
*/
public boolean isSonActive() {
return sonActive;
}
/**
* Vérifie si la vibration est activée par défaut
*
* @return true si la vibration est activée
*/
public boolean isVibrationActive() {
return vibrationActive;
}
/**
* Vérifie si la lumière LED est activée par défaut
*
* @return true si la lumière LED est activée
*/
public boolean isLumiereLED() {
return lumiereLED;
}
/**
* Retourne le type de notification par défaut
*
* @return Le type par défaut pour ce canal
*/
public String getTypeDefaut() {
return typeDefaut;
}
/**
* Retourne la couleur du canal
*
* @return Le code couleur hexadécimal
*/
public String getCouleur() {
return couleur;
}
/**
* Vérifie si le canal est critique
*
* @return true si le canal a une importance élevée (4-5)
*/
public boolean isCritique() {
return importance >= 4;
}
/**
* Vérifie si le canal est silencieux par défaut
*
* @return true si le canal n'émet ni son ni vibration
*/
public boolean isSilencieux() {
return !sonActive && !vibrationActive;
}
/**
* Retourne le niveau d'importance Android
*
* @return Le niveau d'importance pour Android (IMPORTANCE_MIN à IMPORTANCE_MAX)
*/
public String getImportanceAndroid() {
return switch (importance) {
case 1 -> "IMPORTANCE_MIN";
case 2 -> "IMPORTANCE_LOW";
case 3 -> "IMPORTANCE_DEFAULT";
case 4 -> "IMPORTANCE_HIGH";
case 5 -> "IMPORTANCE_MAX";
default -> "IMPORTANCE_DEFAULT";
};
}
/**
* Retourne la priorité iOS
*
* @return La priorité pour iOS (low ou high)
*/
public String getPrioriteIOS() {
return importance >= 4 ? "high" : "low";
}
/**
* Retourne le son par défaut pour le canal
*
* @return Le nom du fichier son ou "default"
*/
public String getSonDefaut() {
return switch (this) {
case URGENT_CHANNEL -> "urgent_sound.mp3";
case ERROR_CHANNEL -> "error_sound.mp3";
case WARNING_CHANNEL -> "warning_sound.mp3";
case IMPORTANT_CHANNEL -> "important_sound.mp3";
case REMINDER_CHANNEL -> "reminder_sound.mp3";
case SUCCESS_CHANNEL -> "success_sound.mp3";
case CELEBRATION_CHANNEL -> "celebration_sound.mp3";
default -> "default";
};
}
/**
* Retourne le pattern de vibration
*
* @return Le pattern de vibration en millisecondes
*/
public long[] getPatternVibration() {
return switch (this) {
case URGENT_CHANNEL -> new long[]{0, 500, 200, 500, 200, 500}; // Triple vibration
case ERROR_CHANNEL -> new long[]{0, 1000, 500, 1000}; // Double vibration longue
case WARNING_CHANNEL -> new long[]{0, 300, 200, 300}; // Double vibration courte
case IMPORTANT_CHANNEL -> new long[]{0, 500, 100, 200}; // Vibration distinctive
case REMINDER_CHANNEL -> new long[]{0, 200, 100, 200}; // Vibration douce
default -> new long[]{0, 250}; // Vibration simple
};
}
/**
* Vérifie si le canal peut être désactivé par l'utilisateur
*
* @return true si l'utilisateur peut désactiver ce canal
*/
public boolean peutEtreDesactive() {
return this != URGENT_CHANNEL && this != ERROR_CHANNEL;
}
/**
* Retourne la durée de vie par défaut des notifications de ce canal
*
* @return La durée de vie en millisecondes
*/
public long getDureeVieMs() {
return switch (this) {
case URGENT_CHANNEL -> 3600000L; // 1 heure
case ERROR_CHANNEL -> 86400000L; // 24 heures
case WARNING_CHANNEL -> 172800000L; // 48 heures
case IMPORTANT_CHANNEL -> 259200000L; // 72 heures
case REMINDER_CHANNEL -> 86400000L; // 24 heures
case SUCCESS_CHANNEL -> 172800000L; // 48 heures
case CELEBRATION_CHANNEL -> 259200000L; // 72 heures
default -> 604800000L; // 1 semaine
};
}
/**
* Trouve un canal par son ID
*
* @param id L'identifiant du canal
* @return Le canal correspondant ou DEFAULT_CHANNEL si non trouvé
*/
public static CanalNotification parId(String id) {
for (CanalNotification canal : values()) {
if (canal.getId().equals(id)) {
return canal;
}
}
return DEFAULT_CHANNEL;
}
/**
* Retourne tous les canaux critiques
*
* @return Un tableau des canaux critiques
*/
public static CanalNotification[] getCanauxCritiques() {
return new CanalNotification[]{URGENT_CHANNEL, ERROR_CHANNEL, WARNING_CHANNEL, IMPORTANT_CHANNEL};
}
/**
* Retourne tous les canaux par catégorie
*
* @return Un tableau des canaux catégoriels
*/
public static CanalNotification[] getCanauxCategories() {
return new CanalNotification[]{EVENTS_CHANNEL, PAYMENTS_CHANNEL, SOLIDARITY_CHANNEL,
MEMBERS_CHANNEL, ORGANIZATION_CHANNEL, SYSTEM_CHANNEL,
MESSAGES_CHANNEL, LOCATION_CHANNEL};
// === CANAUX PAR PRIORITÉ ===
URGENT_CHANNEL(
"urgent",
"Notifications urgentes",
"Alertes critiques nécessitant une action immédiate",
5,
true,
true,
true,
"urgent",
"#F44336"),
ERROR_CHANNEL(
"error",
"Erreurs système",
"Notifications d'erreurs et de problèmes techniques",
4,
true,
true,
false,
"error",
"#F44336"),
WARNING_CHANNEL(
"warning",
"Avertissements",
"Notifications d'avertissement et d'attention",
4,
true,
true,
false,
"warning",
"#FF9800"),
IMPORTANT_CHANNEL(
"important",
"Notifications importantes",
"Informations importantes à ne pas manquer",
4,
true,
true,
false,
"important",
"#FF5722"),
REMINDER_CHANNEL(
"reminder",
"Rappels",
"Rappels d'événements, cotisations et échéances",
3,
true,
true,
false,
"reminder",
"#2196F3"),
SUCCESS_CHANNEL(
"success",
"Confirmations",
"Notifications de succès et confirmations",
2,
false,
false,
false,
"success",
"#4CAF50"),
CELEBRATION_CHANNEL(
"celebration",
"Célébrations",
"Anniversaires, félicitations et événements joyeux",
2,
false,
false,
false,
"celebration",
"#FF9800"),
DEFAULT_CHANNEL(
"default",
"Notifications générales",
"Notifications d'information générale",
2,
false,
false,
false,
"info",
"#2196F3"),
// === CANAUX PAR CATÉGORIE ===
EVENTS_CHANNEL(
"events",
"Événements",
"Notifications liées aux événements et activités",
3,
true,
false,
false,
"event",
"#2196F3"),
PAYMENTS_CHANNEL(
"payments",
"Paiements",
"Notifications de cotisations et paiements",
4,
true,
true,
false,
"payment",
"#4CAF50"),
SOLIDARITY_CHANNEL(
"solidarity",
"Solidarité",
"Notifications d'aide et de solidarité",
3,
true,
false,
false,
"help",
"#E91E63"),
MEMBERS_CHANNEL(
"members",
"Membres",
"Notifications concernant les membres",
2,
false,
false,
false,
"people",
"#2196F3"),
ORGANIZATION_CHANNEL(
"organization",
"Organisation",
"Annonces et informations organisationnelles",
3,
true,
false,
false,
"business",
"#2196F3"),
SYSTEM_CHANNEL(
"system",
"Système",
"Notifications système et maintenance",
2,
false,
false,
false,
"settings",
"#607D8B"),
MESSAGES_CHANNEL(
"messages",
"Messages",
"Messages privés et communications",
3,
true,
false,
false,
"message",
"#2196F3"),
LOCATION_CHANNEL(
"location",
"Géolocalisation",
"Notifications basées sur la localisation",
2,
false,
false,
false,
"location_on",
"#4CAF50");
private final String id;
private final String nom;
private final String description;
private final int importance;
private final boolean sonActive;
private final boolean vibrationActive;
private final boolean lumiereLED;
private final String typeDefaut;
private final String couleur;
/**
* Constructeur de l'énumération CanalNotification
*
* @param id L'identifiant unique du canal
* @param nom Le nom affiché du canal
* @param description La description du canal
* @param importance Le niveau d'importance (1=Min, 2=Low, 3=Default, 4=High, 5=Max)
* @param sonActive true si le son est activé par défaut
* @param vibrationActive true si la vibration est activée par défaut
* @param lumiereLED true si la lumière LED est activée par défaut
* @param typeDefaut Le type de notification par défaut pour ce canal
* @param couleur La couleur hexadécimale du canal
*/
CanalNotification(
String id,
String nom,
String description,
int importance,
boolean sonActive,
boolean vibrationActive,
boolean lumiereLED,
String typeDefaut,
String couleur) {
this.id = id;
this.nom = nom;
this.description = description;
this.importance = importance;
this.sonActive = sonActive;
this.vibrationActive = vibrationActive;
this.lumiereLED = lumiereLED;
this.typeDefaut = typeDefaut;
this.couleur = couleur;
}
/**
* Retourne l'identifiant du canal
*
* @return L'ID unique du canal
*/
public String getId() {
return id;
}
/**
* Retourne le nom du canal
*
* @return Le nom affiché du canal
*/
public String getNom() {
return nom;
}
/**
* Retourne la description du canal
*
* @return La description détaillée du canal
*/
public String getDescription() {
return description;
}
/**
* Retourne le niveau d'importance
*
* @return Le niveau d'importance (1-5)
*/
public int getImportance() {
return importance;
}
/**
* Vérifie si le son est activé par défaut
*
* @return true si le son est activé
*/
public boolean isSonActive() {
return sonActive;
}
/**
* Vérifie si la vibration est activée par défaut
*
* @return true si la vibration est activée
*/
public boolean isVibrationActive() {
return vibrationActive;
}
/**
* Vérifie si la lumière LED est activée par défaut
*
* @return true si la lumière LED est activée
*/
public boolean isLumiereLED() {
return lumiereLED;
}
/**
* Retourne le type de notification par défaut
*
* @return Le type par défaut pour ce canal
*/
public String getTypeDefaut() {
return typeDefaut;
}
/**
* Retourne la couleur du canal
*
* @return Le code couleur hexadécimal
*/
public String getCouleur() {
return couleur;
}
/**
* Vérifie si le canal est critique
*
* @return true si le canal a une importance élevée (4-5)
*/
public boolean isCritique() {
return importance >= 4;
}
/**
* Vérifie si le canal est silencieux par défaut
*
* @return true si le canal n'émet ni son ni vibration
*/
public boolean isSilencieux() {
return !sonActive && !vibrationActive;
}
/**
* Retourne le niveau d'importance Android
*
* @return Le niveau d'importance pour Android (IMPORTANCE_MIN à IMPORTANCE_MAX)
*/
public String getImportanceAndroid() {
return switch (importance) {
case 1 -> "IMPORTANCE_MIN";
case 2 -> "IMPORTANCE_LOW";
case 3 -> "IMPORTANCE_DEFAULT";
case 4 -> "IMPORTANCE_HIGH";
case 5 -> "IMPORTANCE_MAX";
default -> "IMPORTANCE_DEFAULT";
};
}
/**
* Retourne la priorité iOS
*
* @return La priorité pour iOS (low ou high)
*/
public String getPrioriteIOS() {
return importance >= 4 ? "high" : "low";
}
/**
* Retourne le son par défaut pour le canal
*
* @return Le nom du fichier son ou "default"
*/
public String getSonDefaut() {
return switch (this) {
case URGENT_CHANNEL -> "urgent_sound.mp3";
case ERROR_CHANNEL -> "error_sound.mp3";
case WARNING_CHANNEL -> "warning_sound.mp3";
case IMPORTANT_CHANNEL -> "important_sound.mp3";
case REMINDER_CHANNEL -> "reminder_sound.mp3";
case SUCCESS_CHANNEL -> "success_sound.mp3";
case CELEBRATION_CHANNEL -> "celebration_sound.mp3";
default -> "default";
};
}
/**
* Retourne le pattern de vibration
*
* @return Le pattern de vibration en millisecondes
*/
public long[] getPatternVibration() {
return switch (this) {
case URGENT_CHANNEL -> new long[] {0, 500, 200, 500, 200, 500}; // Triple vibration
case ERROR_CHANNEL -> new long[] {0, 1000, 500, 1000}; // Double vibration longue
case WARNING_CHANNEL -> new long[] {0, 300, 200, 300}; // Double vibration courte
case IMPORTANT_CHANNEL -> new long[] {0, 500, 100, 200}; // Vibration distinctive
case REMINDER_CHANNEL -> new long[] {0, 200, 100, 200}; // Vibration douce
default -> new long[] {0, 250}; // Vibration simple
};
}
/**
* Vérifie si le canal peut être désactivé par l'utilisateur
*
* @return true si l'utilisateur peut désactiver ce canal
*/
public boolean peutEtreDesactive() {
return this != URGENT_CHANNEL && this != ERROR_CHANNEL;
}
/**
* Retourne la durée de vie par défaut des notifications de ce canal
*
* @return La durée de vie en millisecondes
*/
public long getDureeVieMs() {
return switch (this) {
case URGENT_CHANNEL -> 3600000L; // 1 heure
case ERROR_CHANNEL -> 86400000L; // 24 heures
case WARNING_CHANNEL -> 172800000L; // 48 heures
case IMPORTANT_CHANNEL -> 259200000L; // 72 heures
case REMINDER_CHANNEL -> 86400000L; // 24 heures
case SUCCESS_CHANNEL -> 172800000L; // 48 heures
case CELEBRATION_CHANNEL -> 259200000L; // 72 heures
default -> 604800000L; // 1 semaine
};
}
/**
* Trouve un canal par son ID
*
* @param id L'identifiant du canal
* @return Le canal correspondant ou DEFAULT_CHANNEL si non trouvé
*/
public static CanalNotification parId(String id) {
for (CanalNotification canal : values()) {
if (canal.getId().equals(id)) {
return canal;
}
}
return DEFAULT_CHANNEL;
}
/**
* Retourne tous les canaux critiques
*
* @return Un tableau des canaux critiques
*/
public static CanalNotification[] getCanauxCritiques() {
return new CanalNotification[] {
URGENT_CHANNEL, ERROR_CHANNEL, WARNING_CHANNEL, IMPORTANT_CHANNEL
};
}
/**
* Retourne tous les canaux par catégorie
*
* @return Un tableau des canaux catégoriels
*/
public static CanalNotification[] getCanauxCategories() {
return new CanalNotification[] {
EVENTS_CHANNEL,
PAYMENTS_CHANNEL,
SOLIDARITY_CHANNEL,
MEMBERS_CHANNEL,
ORGANIZATION_CHANNEL,
SYSTEM_CHANNEL,
MESSAGES_CHANNEL,
LOCATION_CHANNEL
};
}
}

747
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/enums/notification/StatutNotification.java
View File

@@ -2,309 +2,458 @@ package dev.lions.unionflow.server.api.enums.notification;
/**
* Énumération des statuts de notification dans UnionFlow
*
* Cette énumération définit les différents états qu'une notification peut avoir
* tout au long de son cycle de vie, de la création à l'archivage.
*
*
* <p>Cette énumération définit les différents états qu'une notification peut avoir tout au long de
* son cycle de vie, de la création à l'archivage.
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
*/
public enum StatutNotification {
// === STATUTS DE CRÉATION ===
BROUILLON("Brouillon", "draft", "La notification est en cours de création",
"edit", "#9E9E9E", false, false),
PROGRAMMEE("Programmée", "scheduled", "La notification est programmée pour envoi ultérieur",
"schedule", "#FF9800", false, false),
EN_ATTENTE("En attente", "pending", "La notification est en attente d'envoi",
"hourglass_empty", "#FF9800", false, false),
// === STATUTS D'ENVOI ===
EN_COURS_ENVOI("En cours d'envoi", "sending", "La notification est en cours d'envoi",
"send", "#2196F3", false, false),
ENVOYEE("Envoyée", "sent", "La notification a été envoyée avec succès",
"check_circle", "#4CAF50", true, false),
ECHEC_ENVOI("Échec d'envoi", "failed", "L'envoi de la notification a échoué",
"error", "#F44336", true, true),
PARTIELLEMENT_ENVOYEE("Partiellement envoyée", "partial", "La notification a été envoyée à certains destinataires seulement",
"warning", "#FF9800", true, true),
// === STATUTS DE RÉCEPTION ===
RECUE("Reçue", "received", "La notification a été reçue par l'appareil",
"download_done", "#4CAF50", true, false),
AFFICHEE("Affichée", "displayed", "La notification a été affichée à l'utilisateur",
"visibility", "#2196F3", true, false),
OUVERTE("Ouverte", "opened", "L'utilisateur a ouvert la notification",
"open_in_new", "#4CAF50", true, false),
IGNOREE("Ignorée", "ignored", "La notification a été ignorée par l'utilisateur",
"visibility_off", "#9E9E9E", true, false),
// === STATUTS D'INTERACTION ===
LUE("Lue", "read", "La notification a été lue par l'utilisateur",
"mark_email_read", "#4CAF50", true, false),
NON_LUE("Non lue", "unread", "La notification n'a pas encore été lue",
"mark_email_unread", "#FF9800", true, false),
MARQUEE_IMPORTANTE("Marquée importante", "starred", "L'utilisateur a marqué la notification comme importante",
"star", "#FF9800", true, false),
ACTION_EXECUTEE("Action exécutée", "action_done", "L'utilisateur a exécuté l'action demandée",
"task_alt", "#4CAF50", true, false),
// === STATUTS DE GESTION ===
SUPPRIMEE("Supprimée", "deleted", "La notification a été supprimée par l'utilisateur",
"delete", "#F44336", false, false),
ARCHIVEE("Archivée", "archived", "La notification a été archivée",
"archive", "#9E9E9E", false, false),
EXPIREE("Expirée", "expired", "La notification a dépassé sa durée de vie",
"schedule", "#9E9E9E", false, false),
ANNULEE("Annulée", "cancelled", "L'envoi de la notification a été annulé",
"cancel", "#F44336", false, true),
// === STATUTS D'ERREUR ===
ERREUR_TECHNIQUE("Erreur technique", "error", "Une erreur technique a empêché le traitement",
"bug_report", "#F44336", false, true),
DESTINATAIRE_INVALIDE("Destinataire invalide", "invalid_recipient", "Le destinataire n'est pas valide",
"person_off", "#F44336", false, true),
TOKEN_INVALIDE("Token invalide", "invalid_token", "Le token FCM du destinataire est invalide",
"key_off", "#F44336", false, true),
QUOTA_DEPASSE("Quota dépassé", "quota_exceeded", "Le quota d'envoi a été dépassé",
"block", "#F44336", false, true);
private final String libelle;
private final String code;
private final String description;
private final String icone;
private final String couleur;
private final boolean visibleUtilisateur;
private final boolean necessiteAttention;
/**
* Constructeur de l'énumération StatutNotification
*
* @param libelle Le libellé affiché à l'utilisateur
* @param code Le code technique du statut
* @param description La description détaillée du statut
* @param icone L'icône Material Design
* @param couleur La couleur hexadécimale
* @param visibleUtilisateur true si visible à l'utilisateur final
* @param necessiteAttention true si le statut nécessite une attention particulière
*/
StatutNotification(String libelle, String code, String description, String icone, String couleur,
boolean visibleUtilisateur, boolean necessiteAttention) {
this.libelle = libelle;
this.code = code;
this.description = description;
this.icone = icone;
this.couleur = couleur;
this.visibleUtilisateur = visibleUtilisateur;
this.necessiteAttention = necessiteAttention;
}
/**
* Retourne le libellé du statut
*
* @return Le libellé affiché à l'utilisateur
*/
public String getLibelle() {
return libelle;
}
/**
* Retourne le code technique du statut
*
* @return Le code technique
*/
public String getCode() {
return code;
}
/**
* Retourne la description du statut
*
* @return La description détaillée
*/
public String getDescription() {
return description;
}
/**
* Retourne l'icône du statut
*
* @return L'icône Material Design
*/
public String getIcone() {
return icone;
}
/**
* Retourne la couleur du statut
*
* @return Le code couleur hexadécimal
*/
public String getCouleur() {
return couleur;
}
/**
* Vérifie si le statut est visible à l'utilisateur final
*
* @return true si visible à l'utilisateur
*/
public boolean isVisibleUtilisateur() {
return visibleUtilisateur;
}
/**
* Vérifie si le statut nécessite une attention particulière
*
* @return true si le statut nécessite attention
*/
public boolean isNecessiteAttention() {
return necessiteAttention;
}
/**
* Vérifie si le statut indique un succès
*
* @return true si le statut indique un succès
*/
public boolean isSucces() {
return this == ENVOYEE || this == RECUE || this == AFFICHEE ||
this == OUVERTE || this == LUE || this == ACTION_EXECUTEE;
}
/**
* Vérifie si le statut indique une erreur
*
* @return true si le statut indique une erreur
*/
public boolean isErreur() {
return this == ECHEC_ENVOI || this == ERREUR_TECHNIQUE ||
this == DESTINATAIRE_INVALIDE || this == TOKEN_INVALIDE || this == QUOTA_DEPASSE;
}
/**
* Vérifie si le statut indique un état en cours
*
* @return true si le statut indique un traitement en cours
*/
public boolean isEnCours() {
return this == PROGRAMMEE || this == EN_ATTENTE || this == EN_COURS_ENVOI;
}
/**
* Vérifie si le statut indique un état final
*
* @return true si le statut est final (pas de transition possible)
*/
public boolean isFinal() {
return this == SUPPRIMEE || this == ARCHIVEE || this == EXPIREE ||
this == ANNULEE || isErreur();
}
/**
* Vérifie si le statut permet la modification
*
* @return true si la notification peut encore être modifiée
*/
public boolean permetModification() {
return this == BROUILLON || this == PROGRAMMEE;
}
/**
* Vérifie si le statut permet l'annulation
*
* @return true si la notification peut être annulée
*/
public boolean permetAnnulation() {
return this == PROGRAMMEE || this == EN_ATTENTE;
}
/**
* Retourne la priorité d'affichage du statut
*
* @return La priorité (1=haute, 5=basse)
*/
public int getPrioriteAffichage() {
if (isErreur()) return 1;
if (necessiteAttention) return 2;
if (isEnCours()) return 3;
if (isSucces()) return 4;
return 5;
}
/**
* Retourne les statuts suivants possibles
*
* @return Un tableau des statuts de transition possibles
*/
public StatutNotification[] getStatutsSuivantsPossibles() {
return switch (this) {
case BROUILLON -> new StatutNotification[]{PROGRAMMEE, EN_ATTENTE, ANNULEE};
case PROGRAMMEE -> new StatutNotification[]{EN_ATTENTE, EN_COURS_ENVOI, ANNULEE};
case EN_ATTENTE -> new StatutNotification[]{EN_COURS_ENVOI, ECHEC_ENVOI, ANNULEE};
case EN_COURS_ENVOI -> new StatutNotification[]{ENVOYEE, PARTIELLEMENT_ENVOYEE, ECHEC_ENVOI};
case ENVOYEE -> new StatutNotification[]{RECUE, ECHEC_ENVOI};
case RECUE -> new StatutNotification[]{AFFICHEE, IGNOREE};
case AFFICHEE -> new StatutNotification[]{OUVERTE, LUE, NON_LUE, IGNOREE};
case OUVERTE -> new StatutNotification[]{LUE, ACTION_EXECUTEE, MARQUEE_IMPORTANTE};
case NON_LUE -> new StatutNotification[]{LUE, OUVERTE, SUPPRIMEE, ARCHIVEE};
case LUE -> new StatutNotification[]{ACTION_EXECUTEE, MARQUEE_IMPORTANTE, SUPPRIMEE, ARCHIVEE};
default -> new StatutNotification[]{};
};
}
/**
* Trouve un statut par son code
*
* @param code Le code du statut
* @return Le statut correspondant ou null si non trouvé
*/
public static StatutNotification parCode(String code) {
for (StatutNotification statut : values()) {
if (statut.getCode().equals(code)) {
return statut;
}
}
return null;
}
/**
* Retourne tous les statuts visibles à l'utilisateur
*
* @return Un tableau des statuts visibles
*/
public static StatutNotification[] getStatutsVisibles() {
return java.util.Arrays.stream(values())
.filter(StatutNotification::isVisibleUtilisateur)
.toArray(StatutNotification[]::new);
}
/**
* Retourne tous les statuts d'erreur
*
* @return Un tableau des statuts d'erreur
*/
public static StatutNotification[] getStatutsErreur() {
return java.util.Arrays.stream(values())
.filter(StatutNotification::isErreur)
.toArray(StatutNotification[]::new);
// === STATUTS DE CRÉATION ===
BROUILLON(
"Brouillon",
"draft",
"La notification est en cours de création",
"edit",
"#9E9E9E",
false,
false),
PROGRAMMEE(
"Programmée",
"scheduled",
"La notification est programmée pour envoi ultérieur",
"schedule",
"#FF9800",
false,
false),
EN_ATTENTE(
"En attente",
"pending",
"La notification est en attente d'envoi",
"hourglass_empty",
"#FF9800",
false,
false),
// === STATUTS D'ENVOI ===
EN_COURS_ENVOI(
"En cours d'envoi",
"sending",
"La notification est en cours d'envoi",
"send",
"#2196F3",
false,
false),
ENVOYEE(
"Envoyée",
"sent",
"La notification a été envoyée avec succès",
"check_circle",
"#4CAF50",
true,
false),
ECHEC_ENVOI(
"Échec d'envoi",
"failed",
"L'envoi de la notification a échoué",
"error",
"#F44336",
true,
true),
PARTIELLEMENT_ENVOYEE(
"Partiellement envoyée",
"partial",
"La notification a été envoyée à certains destinataires seulement",
"warning",
"#FF9800",
true,
true),
// === STATUTS DE RÉCEPTION ===
RECUE(
"Reçue",
"received",
"La notification a été reçue par l'appareil",
"download_done",
"#4CAF50",
true,
false),
AFFICHEE(
"Affichée",
"displayed",
"La notification a été affichée à l'utilisateur",
"visibility",
"#2196F3",
true,
false),
OUVERTE(
"Ouverte",
"opened",
"L'utilisateur a ouvert la notification",
"open_in_new",
"#4CAF50",
true,
false),
IGNOREE(
"Ignorée",
"ignored",
"La notification a été ignorée par l'utilisateur",
"visibility_off",
"#9E9E9E",
true,
false),
// === STATUTS D'INTERACTION ===
LUE(
"Lue",
"read",
"La notification a été lue par l'utilisateur",
"mark_email_read",
"#4CAF50",
true,
false),
NON_LUE(
"Non lue",
"unread",
"La notification n'a pas encore été lue",
"mark_email_unread",
"#FF9800",
true,
false),
MARQUEE_IMPORTANTE(
"Marquée importante",
"starred",
"L'utilisateur a marqué la notification comme importante",
"star",
"#FF9800",
true,
false),
ACTION_EXECUTEE(
"Action exécutée",
"action_done",
"L'utilisateur a exécuté l'action demandée",
"task_alt",
"#4CAF50",
true,
false),
// === STATUTS DE GESTION ===
SUPPRIMEE(
"Supprimée",
"deleted",
"La notification a été supprimée par l'utilisateur",
"delete",
"#F44336",
false,
false),
ARCHIVEE(
"Archivée", "archived", "La notification a été archivée", "archive", "#9E9E9E", false, false),
EXPIREE(
"Expirée",
"expired",
"La notification a dépassé sa durée de vie",
"schedule",
"#9E9E9E",
false,
false),
ANNULEE(
"Annulée",
"cancelled",
"L'envoi de la notification a été annulé",
"cancel",
"#F44336",
false,
true),
// === STATUTS D'ERREUR ===
ERREUR_TECHNIQUE(
"Erreur technique",
"error",
"Une erreur technique a empêché le traitement",
"bug_report",
"#F44336",
false,
true),
DESTINATAIRE_INVALIDE(
"Destinataire invalide",
"invalid_recipient",
"Le destinataire n'est pas valide",
"person_off",
"#F44336",
false,
true),
TOKEN_INVALIDE(
"Token invalide",
"invalid_token",
"Le token FCM du destinataire est invalide",
"key_off",
"#F44336",
false,
true),
QUOTA_DEPASSE(
"Quota dépassé",
"quota_exceeded",
"Le quota d'envoi a été dépassé",
"block",
"#F44336",
false,
true);
private final String libelle;
private final String code;
private final String description;
private final String icone;
private final String couleur;
private final boolean visibleUtilisateur;
private final boolean necessiteAttention;
/**
* Constructeur de l'énumération StatutNotification
*
* @param libelle Le libellé affiché à l'utilisateur
* @param code Le code technique du statut
* @param description La description détaillée du statut
* @param icone L'icône Material Design
* @param couleur La couleur hexadécimale
* @param visibleUtilisateur true si visible à l'utilisateur final
* @param necessiteAttention true si le statut nécessite une attention particulière
*/
StatutNotification(
String libelle,
String code,
String description,
String icone,
String couleur,
boolean visibleUtilisateur,
boolean necessiteAttention) {
this.libelle = libelle;
this.code = code;
this.description = description;
this.icone = icone;
this.couleur = couleur;
this.visibleUtilisateur = visibleUtilisateur;
this.necessiteAttention = necessiteAttention;
}
/**
* Retourne le libellé du statut
*
* @return Le libellé affiché à l'utilisateur
*/
public String getLibelle() {
return libelle;
}
/**
* Retourne le code technique du statut
*
* @return Le code technique
*/
public String getCode() {
return code;
}
/**
* Retourne la description du statut
*
* @return La description détaillée
*/
public String getDescription() {
return description;
}
/**
* Retourne l'icône du statut
*
* @return L'icône Material Design
*/
public String getIcone() {
return icone;
}
/**
* Retourne la couleur du statut
*
* @return Le code couleur hexadécimal
*/
public String getCouleur() {
return couleur;
}
/**
* Vérifie si le statut est visible à l'utilisateur final
*
* @return true si visible à l'utilisateur
*/
public boolean isVisibleUtilisateur() {
return visibleUtilisateur;
}
/**
* Vérifie si le statut nécessite une attention particulière
*
* @return true si le statut nécessite attention
*/
public boolean isNecessiteAttention() {
return necessiteAttention;
}
/**
* Vérifie si le statut indique un succès
*
* @return true si le statut indique un succès
*/
public boolean isSucces() {
return this == ENVOYEE
|| this == RECUE
|| this == AFFICHEE
|| this == OUVERTE
|| this == LUE
|| this == ACTION_EXECUTEE;
}
/**
* Vérifie si le statut indique une erreur
*
* @return true si le statut indique une erreur
*/
public boolean isErreur() {
return this == ECHEC_ENVOI
|| this == ERREUR_TECHNIQUE
|| this == DESTINATAIRE_INVALIDE
|| this == TOKEN_INVALIDE
|| this == QUOTA_DEPASSE;
}
/**
* Vérifie si le statut indique un état en cours
*
* @return true si le statut indique un traitement en cours
*/
public boolean isEnCours() {
return this == PROGRAMMEE || this == EN_ATTENTE || this == EN_COURS_ENVOI;
}
/**
* Vérifie si le statut indique un état final
*
* @return true si le statut est final (pas de transition possible)
*/
public boolean isFinal() {
return this == SUPPRIMEE
|| this == ARCHIVEE
|| this == EXPIREE
|| this == ANNULEE
|| isErreur();
}
/**
* Vérifie si le statut permet la modification
*
* @return true si la notification peut encore être modifiée
*/
public boolean permetModification() {
return this == BROUILLON || this == PROGRAMMEE;
}
/**
* Vérifie si le statut permet l'annulation
*
* @return true si la notification peut être annulée
*/
public boolean permetAnnulation() {
return this == PROGRAMMEE || this == EN_ATTENTE;
}
/**
* Retourne la priorité d'affichage du statut
*
* @return La priorité (1=haute, 5=basse)
*/
public int getPrioriteAffichage() {
if (isErreur()) return 1;
if (necessiteAttention) return 2;
if (isEnCours()) return 3;
if (isSucces()) return 4;
return 5;
}
/**
* Retourne les statuts suivants possibles
*
* @return Un tableau des statuts de transition possibles
*/
public StatutNotification[] getStatutsSuivantsPossibles() {
return switch (this) {
case BROUILLON -> new StatutNotification[] {PROGRAMMEE, EN_ATTENTE, ANNULEE};
case PROGRAMMEE -> new StatutNotification[] {EN_ATTENTE, EN_COURS_ENVOI, ANNULEE};
case EN_ATTENTE -> new StatutNotification[] {EN_COURS_ENVOI, ECHEC_ENVOI, ANNULEE};
case EN_COURS_ENVOI -> new StatutNotification[] {ENVOYEE, PARTIELLEMENT_ENVOYEE, ECHEC_ENVOI};
case ENVOYEE -> new StatutNotification[] {RECUE, ECHEC_ENVOI};
case RECUE -> new StatutNotification[] {AFFICHEE, IGNOREE};
case AFFICHEE -> new StatutNotification[] {OUVERTE, LUE, NON_LUE, IGNOREE};
case OUVERTE -> new StatutNotification[] {LUE, ACTION_EXECUTEE, MARQUEE_IMPORTANTE};
case NON_LUE -> new StatutNotification[] {LUE, OUVERTE, SUPPRIMEE, ARCHIVEE};
case LUE ->
new StatutNotification[] {ACTION_EXECUTEE, MARQUEE_IMPORTANTE, SUPPRIMEE, ARCHIVEE};
default -> new StatutNotification[] {};
};
}
/**
* Trouve un statut par son code
*
* @param code Le code du statut
* @return Le statut correspondant ou null si non trouvé
*/
public static StatutNotification parCode(String code) {
for (StatutNotification statut : values()) {
if (statut.getCode().equals(code)) {
return statut;
}
}
return null;
}
/**
* Retourne tous les statuts visibles à l'utilisateur
*
* @return Un tableau des statuts visibles
*/
public static StatutNotification[] getStatutsVisibles() {
return java.util.Arrays.stream(values())
.filter(StatutNotification::isVisibleUtilisateur)
.toArray(StatutNotification[]::new);
}
/**
* Retourne tous les statuts d'erreur
*
* @return Un tableau des statuts d'erreur
*/
public static StatutNotification[] getStatutsErreur() {
return java.util.Arrays.stream(values())
.filter(StatutNotification::isErreur)
.toArray(StatutNotification[]::new);
}
}

531
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/enums/notification/TypeNotification.java
View File

@@ -2,260 +2,289 @@ package dev.lions.unionflow.server.api.enums.notification;
/**
* Énumération des types de notifications disponibles dans UnionFlow
*
* Cette énumération définit les différents types de notifications qui peuvent être
* envoyées aux utilisateurs de l'application UnionFlow.
*
*
* <p>Cette énumération définit les différents types de notifications qui peuvent être envoyées aux
* utilisateurs de l'application UnionFlow.
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
*/
public enum TypeNotification {
// === NOTIFICATIONS ÉVÉNEMENTS ===
NOUVEL_EVENEMENT("Nouvel événement", "evenements", "info", "event", "#FF9800", true, true),
RAPPEL_EVENEMENT("Rappel d'événement", "evenements", "reminder", "schedule", "#2196F3", true, true),
EVENEMENT_ANNULE("Événement annulé", "evenements", "warning", "event_busy", "#F44336", true, true),
EVENEMENT_MODIFIE("Événement modifié", "evenements", "info", "edit", "#FF9800", true, false),
INSCRIPTION_CONFIRMEE("Inscription confirmée", "evenements", "success", "check_circle", "#4CAF50", true, false),
INSCRIPTION_REFUSEE("Inscription refusée", "evenements", "error", "cancel", "#F44336", true, false),
LISTE_ATTENTE("Mis en liste d'attente", "evenements", "info", "hourglass_empty", "#FF9800", true, false),
// === NOTIFICATIONS COTISATIONS ===
COTISATION_DUE("Cotisation due", "cotisations", "reminder", "payment", "#FF5722", true, true),
COTISATION_PAYEE("Cotisation payée", "cotisations", "success", "paid", "#4CAF50", true, false),
COTISATION_RETARD("Cotisation en retard", "cotisations", "warning", "schedule", "#F44336", true, true),
RAPPEL_COTISATION("Rappel de cotisation", "cotisations", "reminder", "notifications", "#FF9800", true, true),
PAIEMENT_CONFIRME("Paiement confirmé", "cotisations", "success", "check_circle", "#4CAF50", true, false),
PAIEMENT_ECHOUE("Paiement échoué", "cotisations", "error", "error", "#F44336", true, true),
// === NOTIFICATIONS SOLIDARITÉ ===
NOUVELLE_DEMANDE_AIDE("Nouvelle demande d'aide", "solidarite", "info", "help", "#E91E63", false, true),
DEMANDE_AIDE_APPROUVEE("Demande d'aide approuvée", "solidarite", "success", "thumb_up", "#4CAF50", true, false),
DEMANDE_AIDE_REFUSEE("Demande d'aide refusée", "solidarite", "error", "thumb_down", "#F44336", true, false),
AIDE_DISPONIBLE("Aide disponible", "solidarite", "info", "volunteer_activism", "#E91E63", true, false),
APPEL_SOLIDARITE("Appel à la solidarité", "solidarite", "urgent", "campaign", "#E91E63", true, true),
// === NOTIFICATIONS MEMBRES ===
NOUVEAU_MEMBRE("Nouveau membre", "membres", "info", "person_add", "#2196F3", false, false),
ANNIVERSAIRE_MEMBRE("Anniversaire de membre", "membres", "celebration", "cake", "#FF9800", true, false),
MEMBRE_INACTIF("Membre inactif", "membres", "warning", "person_off", "#FF5722", false, false),
REACTIVATION_MEMBRE("Réactivation de membre", "membres", "success", "person", "#4CAF50", false, false),
// === NOTIFICATIONS ORGANISATION ===
ANNONCE_GENERALE("Annonce générale", "organisation", "info", "campaign", "#2196F3", true, true),
REUNION_PROGRAMMEE("Réunion programmée", "organisation", "info", "groups", "#2196F3", true, true),
CHANGEMENT_REGLEMENT("Changement de règlement", "organisation", "important", "gavel", "#FF5722", true, true),
ELECTION_OUVERTE("Élection ouverte", "organisation", "info", "how_to_vote", "#2196F3", true, true),
RESULTAT_ELECTION("Résultat d'élection", "organisation", "info", "poll", "#4CAF50", true, false),
// === NOTIFICATIONS SYSTÈME ===
MISE_A_JOUR_APP("Mise à jour disponible", "systeme", "info", "system_update", "#2196F3", true, false),
MAINTENANCE_PROGRAMMEE("Maintenance programmée", "systeme", "warning", "build", "#FF9800", true, true),
PROBLEME_TECHNIQUE("Problème technique", "systeme", "error", "error", "#F44336", true, true),
SAUVEGARDE_REUSSIE("Sauvegarde réussie", "systeme", "success", "backup", "#4CAF50", false, false),
// === NOTIFICATIONS PERSONNALISÉES ===
MESSAGE_PRIVE("Message privé", "messages", "info", "mail", "#2196F3", true, false),
MENTION("Mention", "messages", "info", "alternate_email", "#FF9800", true, false),
COMMENTAIRE("Nouveau commentaire", "messages", "info", "comment", "#2196F3", true, false),
// === NOTIFICATIONS GÉOLOCALISÉES ===
EVENEMENT_PROXIMITE("Événement à proximité", "geolocalisation", "info", "location_on", "#4CAF50", true, false),
MEMBRE_PROXIMITE("Membre à proximité", "geolocalisation", "info", "people", "#2196F3", true, false),
URGENCE_LOCALE("Urgence locale", "geolocalisation", "urgent", "warning", "#F44336", true, true);
private final String libelle;
private final String categorie;
private final String priorite;
private final String icone;
private final String couleur;
private final boolean visibleUtilisateur;
private final boolean activeeParDefaut;
/**
* Constructeur de l'énumération TypeNotification
*
* @param libelle Le libellé affiché à l'utilisateur
* @param categorie La catégorie de la notification
* @param priorite Le niveau de priorité (info, reminder, warning, error, success, urgent, important, celebration)
* @param icone L'icône Material Design
* @param couleur La couleur hexadécimale
* @param visibleUtilisateur true si visible dans les préférences utilisateur
* @param activeeParDefaut true si activée par défaut
*/
TypeNotification(String libelle, String categorie, String priorite, String icone, String couleur,
boolean visibleUtilisateur, boolean activeeParDefaut) {
this.libelle = libelle;
this.categorie = categorie;
this.priorite = priorite;
this.icone = icone;
this.couleur = couleur;
this.visibleUtilisateur = visibleUtilisateur;
this.activeeParDefaut = activeeParDefaut;
}
/**
* Retourne le libellé de la notification
*
* @return Le libellé affiché à l'utilisateur
*/
public String getLibelle() {
return libelle;
}
/**
* Retourne la catégorie de la notification
*
* @return La catégorie (evenements, cotisations, solidarite, etc.)
*/
public String getCategorie() {
return categorie;
}
/**
* Retourne la priorité de la notification
*
* @return Le niveau de priorité
*/
public String getPriorite() {
return priorite;
}
/**
* Retourne l'icône de la notification
*
* @return L'icône Material Design
*/
public String getIcone() {
return icone;
}
/**
* Retourne la couleur de la notification
*
* @return Le code couleur hexadécimal
*/
public String getCouleur() {
return couleur;
}
/**
* Vérifie si la notification est visible dans les préférences utilisateur
*
* @return true si visible dans les préférences
*/
public boolean isVisibleUtilisateur() {
return visibleUtilisateur;
}
/**
* Vérifie si la notification est activée par défaut
*
* @return true si activée par défaut
*/
public boolean isActiveeParDefaut() {
return activeeParDefaut;
}
/**
* Vérifie si la notification est critique (urgent ou error)
*
* @return true si la notification est critique
*/
public boolean isCritique() {
return "urgent".equals(priorite) || "error".equals(priorite);
}
/**
* Vérifie si la notification est un rappel
*
* @return true si c'est un rappel
*/
public boolean isRappel() {
return "reminder".equals(priorite);
}
/**
* Vérifie si la notification est positive (success ou celebration)
*
* @return true si la notification est positive
*/
public boolean isPositive() {
return "success".equals(priorite) || "celebration".equals(priorite);
}
/**
* Retourne le niveau de priorité numérique pour le tri
*
* @return Niveau de priorité (1=urgent, 2=error, 3=warning, 4=important, 5=reminder, 6=info, 7=success, 8=celebration)
*/
public int getNiveauPriorite() {
return switch (priorite) {
case "urgent" -> 1;
case "error" -> 2;
case "warning" -> 3;
case "important" -> 4;
case "reminder" -> 5;
case "info" -> 6;
case "success" -> 7;
case "celebration" -> 8;
default -> 6;
};
}
/**
* Retourne le délai d'expiration par défaut en heures
*
* @return Délai d'expiration en heures
*/
public int getDelaiExpirationHeures() {
return switch (priorite) {
case "urgent" -> 1; // 1 heure
case "error" -> 24; // 24 heures
case "warning" -> 48; // 48 heures
case "important" -> 72; // 72 heures
case "reminder" -> 24; // 24 heures
case "info" -> 168; // 1 semaine
case "success" -> 48; // 48 heures
case "celebration" -> 72; // 72 heures
default -> 168;
};
}
/**
* Vérifie si la notification doit vibrer
*
* @return true si la notification doit faire vibrer l'appareil
*/
public boolean doitVibrer() {
return isCritique() || isRappel();
}
/**
* Vérifie si la notification doit émettre un son
*
* @return true si la notification doit émettre un son
*/
public boolean doitEmettreSon() {
return isCritique() || isRappel() || "important".equals(priorite);
}
/**
* Retourne le canal de notification Android approprié
*
* @return L'ID du canal de notification
*/
public String getCanalNotification() {
return switch (priorite) {
case "urgent" -> "URGENT_CHANNEL";
case "error" -> "ERROR_CHANNEL";
case "warning" -> "WARNING_CHANNEL";
case "important" -> "IMPORTANT_CHANNEL";
case "reminder" -> "REMINDER_CHANNEL";
case "success" -> "SUCCESS_CHANNEL";
case "celebration" -> "CELEBRATION_CHANNEL";
default -> "DEFAULT_CHANNEL";
};
}
// === NOTIFICATIONS ÉVÉNEMENTS ===
NOUVEL_EVENEMENT("Nouvel événement", "evenements", "info", "event", "#FF9800", true, true),
RAPPEL_EVENEMENT(
"Rappel d'événement", "evenements", "reminder", "schedule", "#2196F3", true, true),
EVENEMENT_ANNULE(
"Événement annulé", "evenements", "warning", "event_busy", "#F44336", true, true),
EVENEMENT_MODIFIE("Événement modifié", "evenements", "info", "edit", "#FF9800", true, false),
INSCRIPTION_CONFIRMEE(
"Inscription confirmée", "evenements", "success", "check_circle", "#4CAF50", true, false),
INSCRIPTION_REFUSEE(
"Inscription refusée", "evenements", "error", "cancel", "#F44336", true, false),
LISTE_ATTENTE(
"Mis en liste d'attente", "evenements", "info", "hourglass_empty", "#FF9800", true, false),
// === NOTIFICATIONS COTISATIONS ===
COTISATION_DUE("Cotisation due", "cotisations", "reminder", "payment", "#FF5722", true, true),
COTISATION_PAYEE("Cotisation payée", "cotisations", "success", "paid", "#4CAF50", true, false),
COTISATION_RETARD(
"Cotisation en retard", "cotisations", "warning", "schedule", "#F44336", true, true),
RAPPEL_COTISATION(
"Rappel de cotisation", "cotisations", "reminder", "notifications", "#FF9800", true, true),
PAIEMENT_CONFIRME(
"Paiement confirmé", "cotisations", "success", "check_circle", "#4CAF50", true, false),
PAIEMENT_ECHOUE("Paiement échoué", "cotisations", "error", "error", "#F44336", true, true),
// === NOTIFICATIONS SOLIDARITÉ ===
NOUVELLE_DEMANDE_AIDE(
"Nouvelle demande d'aide", "solidarite", "info", "help", "#E91E63", false, true),
DEMANDE_AIDE_APPROUVEE(
"Demande d'aide approuvée", "solidarite", "success", "thumb_up", "#4CAF50", true, false),
DEMANDE_AIDE_REFUSEE(
"Demande d'aide refusée", "solidarite", "error", "thumb_down", "#F44336", true, false),
AIDE_DISPONIBLE(
"Aide disponible", "solidarite", "info", "volunteer_activism", "#E91E63", true, false),
APPEL_SOLIDARITE(
"Appel à la solidarité", "solidarite", "urgent", "campaign", "#E91E63", true, true),
// === NOTIFICATIONS MEMBRES ===
NOUVEAU_MEMBRE("Nouveau membre", "membres", "info", "person_add", "#2196F3", false, false),
ANNIVERSAIRE_MEMBRE(
"Anniversaire de membre", "membres", "celebration", "cake", "#FF9800", true, false),
MEMBRE_INACTIF("Membre inactif", "membres", "warning", "person_off", "#FF5722", false, false),
REACTIVATION_MEMBRE(
"Réactivation de membre", "membres", "success", "person", "#4CAF50", false, false),
// === NOTIFICATIONS ORGANISATION ===
ANNONCE_GENERALE("Annonce générale", "organisation", "info", "campaign", "#2196F3", true, true),
REUNION_PROGRAMMEE("Réunion programmée", "organisation", "info", "groups", "#2196F3", true, true),
CHANGEMENT_REGLEMENT(
"Changement de règlement", "organisation", "important", "gavel", "#FF5722", true, true),
ELECTION_OUVERTE(
"Élection ouverte", "organisation", "info", "how_to_vote", "#2196F3", true, true),
RESULTAT_ELECTION("Résultat d'élection", "organisation", "info", "poll", "#4CAF50", true, false),
// === NOTIFICATIONS SYSTÈME ===
MISE_A_JOUR_APP(
"Mise à jour disponible", "systeme", "info", "system_update", "#2196F3", true, false),
MAINTENANCE_PROGRAMMEE(
"Maintenance programmée", "systeme", "warning", "build", "#FF9800", true, true),
PROBLEME_TECHNIQUE("Problème technique", "systeme", "error", "error", "#F44336", true, true),
SAUVEGARDE_REUSSIE("Sauvegarde réussie", "systeme", "success", "backup", "#4CAF50", false, false),
// === NOTIFICATIONS PERSONNALISÉES ===
MESSAGE_PRIVE("Message privé", "messages", "info", "mail", "#2196F3", true, false),
MENTION("Mention", "messages", "info", "alternate_email", "#FF9800", true, false),
COMMENTAIRE("Nouveau commentaire", "messages", "info", "comment", "#2196F3", true, false),
// === NOTIFICATIONS GÉOLOCALISÉES ===
EVENEMENT_PROXIMITE(
"Événement à proximité", "geolocalisation", "info", "location_on", "#4CAF50", true, false),
MEMBRE_PROXIMITE(
"Membre à proximité", "geolocalisation", "info", "people", "#2196F3", true, false),
URGENCE_LOCALE("Urgence locale", "geolocalisation", "urgent", "warning", "#F44336", true, true);
private final String libelle;
private final String categorie;
private final String priorite;
private final String icone;
private final String couleur;
private final boolean visibleUtilisateur;
private final boolean activeeParDefaut;
/**
* Constructeur de l'énumération TypeNotification
*
* @param libelle Le libellé affiché à l'utilisateur
* @param categorie La catégorie de la notification
* @param priorite Le niveau de priorité (info, reminder, warning, error, success, urgent,
* important, celebration)
* @param icone L'icône Material Design
* @param couleur La couleur hexadécimale
* @param visibleUtilisateur true si visible dans les préférences utilisateur
* @param activeeParDefaut true si activée par défaut
*/
TypeNotification(
String libelle,
String categorie,
String priorite,
String icone,
String couleur,
boolean visibleUtilisateur,
boolean activeeParDefaut) {
this.libelle = libelle;
this.categorie = categorie;
this.priorite = priorite;
this.icone = icone;
this.couleur = couleur;
this.visibleUtilisateur = visibleUtilisateur;
this.activeeParDefaut = activeeParDefaut;
}
/**
* Retourne le libellé de la notification
*
* @return Le libellé affiché à l'utilisateur
*/
public String getLibelle() {
return libelle;
}
/**
* Retourne la catégorie de la notification
*
* @return La catégorie (evenements, cotisations, solidarite, etc.)
*/
public String getCategorie() {
return categorie;
}
/**
* Retourne la priorité de la notification
*
* @return Le niveau de priorité
*/
public String getPriorite() {
return priorite;
}
/**
* Retourne l'icône de la notification
*
* @return L'icône Material Design
*/
public String getIcone() {
return icone;
}
/**
* Retourne la couleur de la notification
*
* @return Le code couleur hexadécimal
*/
public String getCouleur() {
return couleur;
}
/**
* Vérifie si la notification est visible dans les préférences utilisateur
*
* @return true si visible dans les préférences
*/
public boolean isVisibleUtilisateur() {
return visibleUtilisateur;
}
/**
* Vérifie si la notification est activée par défaut
*
* @return true si activée par défaut
*/
public boolean isActiveeParDefaut() {
return activeeParDefaut;
}
/**
* Vérifie si la notification est critique (urgent ou error)
*
* @return true si la notification est critique
*/
public boolean isCritique() {
return "urgent".equals(priorite) || "error".equals(priorite);
}
/**
* Vérifie si la notification est un rappel
*
* @return true si c'est un rappel
*/
public boolean isRappel() {
return "reminder".equals(priorite);
}
/**
* Vérifie si la notification est positive (success ou celebration)
*
* @return true si la notification est positive
*/
public boolean isPositive() {
return "success".equals(priorite) || "celebration".equals(priorite);
}
/**
* Retourne le niveau de priorité numérique pour le tri
*
* @return Niveau de priorité (1=urgent, 2=error, 3=warning, 4=important, 5=reminder, 6=info,
* 7=success, 8=celebration)
*/
public int getNiveauPriorite() {
return switch (priorite) {
case "urgent" -> 1;
case "error" -> 2;
case "warning" -> 3;
case "important" -> 4;
case "reminder" -> 5;
case "info" -> 6;
case "success" -> 7;
case "celebration" -> 8;
default -> 6;
};
}
/**
* Retourne le délai d'expiration par défaut en heures
*
* @return Délai d'expiration en heures
*/
public int getDelaiExpirationHeures() {
return switch (priorite) {
case "urgent" -> 1; // 1 heure
case "error" -> 24; // 24 heures
case "warning" -> 48; // 48 heures
case "important" -> 72; // 72 heures
case "reminder" -> 24; // 24 heures
case "info" -> 168; // 1 semaine
case "success" -> 48; // 48 heures
case "celebration" -> 72; // 72 heures
default -> 168;
};
}
/**
* Vérifie si la notification doit vibrer
*
* @return true si la notification doit faire vibrer l'appareil
*/
public boolean doitVibrer() {
return isCritique() || isRappel();
}
/**
* Vérifie si la notification doit émettre un son
*
* @return true si la notification doit émettre un son
*/
public boolean doitEmettreSon() {
return isCritique() || isRappel() || "important".equals(priorite);
}
/**
* Retourne le canal de notification Android approprié
*
* @return L'ID du canal de notification
*/
public String getCanalNotification() {
return switch (priorite) {
case "urgent" -> "URGENT_CHANNEL";
case "error" -> "ERROR_CHANNEL";
case "warning" -> "WARNING_CHANNEL";
case "important" -> "IMPORTANT_CHANNEL";
case "reminder" -> "REMINDER_CHANNEL";
case "success" -> "SUCCESS_CHANNEL";
case "celebration" -> "CELEBRATION_CHANNEL";
default -> "DEFAULT_CHANNEL";
};
}
}

444
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/enums/solidarite/PrioriteAide.java
View File

@@ -2,214 +2,260 @@ package dev.lions.unionflow.server.api.enums.solidarite;
/**
* Énumération des priorités d'aide dans le système de solidarité
*
* Cette énumération définit les niveaux de priorité pour les demandes d'aide,
* permettant de prioriser le traitement selon l'urgence de la situation.
*
*
* <p>Cette énumération définit les niveaux de priorité pour les demandes d'aide, permettant de
* prioriser le traitement selon l'urgence de la situation.
*
* @author UnionFlow Team
* @version 1.0
* @since 2025-01-16
*/
public enum PrioriteAide {
CRITIQUE("Critique", "critical", 1, "Situation critique nécessitant une intervention immédiate",
"#F44336", "emergency", 24, true, true),
URGENTE("Urgente", "urgent", 2, "Situation urgente nécessitant une réponse rapide",
"#FF5722", "priority_high", 72, true, false),
ELEVEE("Élevée", "high", 3, "Priorité élevée, traitement dans les meilleurs délais",
"#FF9800", "keyboard_arrow_up", 168, false, false),
NORMALE("Normale", "normal", 4, "Priorité normale, traitement selon les délais standards",
"#2196F3", "remove", 336, false, false),
FAIBLE("Faible", "low", 5, "Priorité faible, traitement quand les ressources le permettent",
"#4CAF50", "keyboard_arrow_down", 720, false, false);
CRITIQUE(
"Critique",
"critical",
1,
"Situation critique nécessitant une intervention immédiate",
"#F44336",
"emergency",
24,
true,
true),
private final String libelle;
private final String code;
private final int niveau;
private final String description;
private final String couleur;
private final String icone;
private final int delaiTraitementHeures;
private final boolean notificationImmediate;
private final boolean escaladeAutomatique;
URGENTE(
"Urgente",
"urgent",
2,
"Situation urgente nécessitant une réponse rapide",
"#FF5722",
"priority_high",
72,
true,
false),
PrioriteAide(String libelle, String code, int niveau, String description, String couleur,
String icone, int delaiTraitementHeures, boolean notificationImmediate,
boolean escaladeAutomatique) {
this.libelle = libelle;
this.code = code;
this.niveau = niveau;
this.description = description;
this.couleur = couleur;
this.icone = icone;
this.delaiTraitementHeures = delaiTraitementHeures;
this.notificationImmediate = notificationImmediate;
this.escaladeAutomatique = escaladeAutomatique;
ELEVEE(
"Élevée",
"high",
3,
"Priorité élevée, traitement dans les meilleurs délais",
"#FF9800",
"keyboard_arrow_up",
168,
false,
false),
NORMALE(
"Normale",
"normal",
4,
"Priorité normale, traitement selon les délais standards",
"#2196F3",
"remove",
336,
false,
false),
FAIBLE(
"Faible",
"low",
5,
"Priorité faible, traitement quand les ressources le permettent",
"#4CAF50",
"keyboard_arrow_down",
720,
false,
false);
private final String libelle;
private final String code;
private final int niveau;
private final String description;
private final String couleur;
private final String icone;
private final int delaiTraitementHeures;
private final boolean notificationImmediate;
private final boolean escaladeAutomatique;
PrioriteAide(
String libelle,
String code,
int niveau,
String description,
String couleur,
String icone,
int delaiTraitementHeures,
boolean notificationImmediate,
boolean escaladeAutomatique) {
this.libelle = libelle;
this.code = code;
this.niveau = niveau;
this.description = description;
this.couleur = couleur;
this.icone = icone;
this.delaiTraitementHeures = delaiTraitementHeures;
this.notificationImmediate = notificationImmediate;
this.escaladeAutomatique = escaladeAutomatique;
}
// === GETTERS ===
public String getLibelle() {
return libelle;
}
public String getCode() {
return code;
}
public int getNiveau() {
return niveau;
}
public String getDescription() {
return description;
}
public String getCouleur() {
return couleur;
}
public String getIcone() {
return icone;
}
public int getDelaiTraitementHeures() {
return delaiTraitementHeures;
}
public boolean isNotificationImmediate() {
return notificationImmediate;
}
public boolean isEscaladeAutomatique() {
return escaladeAutomatique;
}
// === MÉTHODES UTILITAIRES ===
/** Vérifie si la priorité est critique ou urgente */
public boolean isUrgente() {
return this == CRITIQUE || this == URGENTE;
}
/** Vérifie si la priorité nécessite un traitement immédiat */
public boolean necessiteTraitementImmediat() {
return niveau <= 2;
}
/** Retourne la date limite de traitement */
public java.time.LocalDateTime getDateLimiteTraitement() {
return java.time.LocalDateTime.now().plusHours(delaiTraitementHeures);
}
/** Retourne la priorité suivante (escalade) */
public PrioriteAide getPrioriteEscalade() {
return switch (this) {
case FAIBLE -> NORMALE;
case NORMALE -> ELEVEE;
case ELEVEE -> URGENTE;
case URGENTE -> CRITIQUE;
case CRITIQUE -> CRITIQUE; // Déjà au maximum
};
}
/** Détermine la priorité basée sur le type d'aide */
public static PrioriteAide determinerPriorite(TypeAide typeAide) {
if (typeAide.isUrgent()) {
return switch (typeAide) {
case AIDE_FINANCIERE_URGENTE, AIDE_FRAIS_MEDICAUX -> CRITIQUE;
case HEBERGEMENT_URGENCE, AIDE_ALIMENTAIRE -> URGENTE;
default -> ELEVEE;
};
}
// === GETTERS ===
public String getLibelle() { return libelle; }
public String getCode() { return code; }
public int getNiveau() { return niveau; }
public String getDescription() { return description; }
public String getCouleur() { return couleur; }
public String getIcone() { return icone; }
public int getDelaiTraitementHeures() { return delaiTraitementHeures; }
public boolean isNotificationImmediate() { return notificationImmediate; }
public boolean isEscaladeAutomatique() { return escaladeAutomatique; }
if (typeAide.getPriorite().equals("important")) {
return ELEVEE;
}
// === MÉTHODES UTILITAIRES ===
/**
* Vérifie si la priorité est critique ou urgente
*/
public boolean isUrgente() {
return this == CRITIQUE || this == URGENTE;
}
/**
* Vérifie si la priorité nécessite un traitement immédiat
*/
public boolean necessiteTraitementImmediat() {
return niveau <= 2;
}
/**
* Retourne la date limite de traitement
*/
public java.time.LocalDateTime getDateLimiteTraitement() {
return java.time.LocalDateTime.now().plusHours(delaiTraitementHeures);
}
/**
* Retourne la priorité suivante (escalade)
*/
public PrioriteAide getPrioriteEscalade() {
return switch (this) {
case FAIBLE -> NORMALE;
case NORMALE -> ELEVEE;
case ELEVEE -> URGENTE;
case URGENTE -> CRITIQUE;
case CRITIQUE -> CRITIQUE; // Déjà au maximum
};
}
/**
* Détermine la priorité basée sur le type d'aide
*/
public static PrioriteAide determinerPriorite(TypeAide typeAide) {
if (typeAide.isUrgent()) {
return switch (typeAide) {
case AIDE_FINANCIERE_URGENTE, AIDE_FRAIS_MEDICAUX -> CRITIQUE;
case HEBERGEMENT_URGENCE, AIDE_ALIMENTAIRE -> URGENTE;
default -> ELEVEE;
};
}
if (typeAide.getPriorite().equals("important")) {
return ELEVEE;
}
return NORMALE;
}
/**
* Retourne les priorités urgentes
*/
public static java.util.List<PrioriteAide> getPrioritesUrgentes() {
return java.util.Arrays.stream(values())
.filter(PrioriteAide::isUrgente)
.collect(java.util.stream.Collectors.toList());
}
/**
* Retourne les priorités par niveau croissant
*/
public static java.util.List<PrioriteAide> getParNiveauCroissant() {
return java.util.Arrays.stream(values())
.sorted(java.util.Comparator.comparingInt(PrioriteAide::getNiveau))
.collect(java.util.stream.Collectors.toList());
}
/**
* Retourne les priorités par niveau décroissant
*/
public static java.util.List<PrioriteAide> getParNiveauDecroissant() {
return java.util.Arrays.stream(values())
.sorted(java.util.Comparator.comparingInt(PrioriteAide::getNiveau).reversed())
.collect(java.util.stream.Collectors.toList());
}
/**
* Trouve la priorité par code
*/
public static PrioriteAide parCode(String code) {
return java.util.Arrays.stream(values())
.filter(p -> p.getCode().equals(code))
.findFirst()
.orElse(NORMALE);
}
/**
* Calcule le score de priorité (plus bas = plus prioritaire)
*/
public double getScorePriorite() {
double score = niveau;
// Bonus pour notification immédiate
if (notificationImmediate) score -= 0.5;
// Bonus pour escalade automatique
if (escaladeAutomatique) score -= 0.3;
// Malus pour délai long
if (delaiTraitementHeures > 168) score += 0.2;
return score;
}
/**
* Vérifie si le délai de traitement est dépassé
*/
public boolean isDelaiDepasse(java.time.LocalDateTime dateCreation) {
java.time.LocalDateTime dateLimite = dateCreation.plusHours(delaiTraitementHeures);
return java.time.LocalDateTime.now().isAfter(dateLimite);
}
/**
* Calcule le pourcentage de temps écoulé
*/
public double getPourcentageTempsEcoule(java.time.LocalDateTime dateCreation) {
java.time.LocalDateTime maintenant = java.time.LocalDateTime.now();
java.time.LocalDateTime dateLimite = dateCreation.plusHours(delaiTraitementHeures);
long dureeTotal = java.time.Duration.between(dateCreation, dateLimite).toMinutes();
long dureeEcoulee = java.time.Duration.between(dateCreation, maintenant).toMinutes();
if (dureeTotal <= 0) return 100.0;
return Math.min(100.0, (dureeEcoulee * 100.0) / dureeTotal);
}
/**
* Retourne le message d'alerte selon le temps écoulé
*/
public String getMessageAlerte(java.time.LocalDateTime dateCreation) {
double pourcentage = getPourcentageTempsEcoule(dateCreation);
if (pourcentage >= 100) {
return "Délai de traitement dépassé !";
} else if (pourcentage >= 80) {
return "Délai de traitement bientôt dépassé";
} else if (pourcentage >= 60) {
return "Plus de la moitié du délai écoulé";
}
return null;
return NORMALE;
}
/** Retourne les priorités urgentes */
public static java.util.List<PrioriteAide> getPrioritesUrgentes() {
return java.util.Arrays.stream(values())
.filter(PrioriteAide::isUrgente)
.collect(java.util.stream.Collectors.toList());
}
/** Retourne les priorités par niveau croissant */
public static java.util.List<PrioriteAide> getParNiveauCroissant() {
return java.util.Arrays.stream(values())
.sorted(java.util.Comparator.comparingInt(PrioriteAide::getNiveau))
.collect(java.util.stream.Collectors.toList());
}
/** Retourne les priorités par niveau décroissant */
public static java.util.List<PrioriteAide> getParNiveauDecroissant() {
return java.util.Arrays.stream(values())
.sorted(java.util.Comparator.comparingInt(PrioriteAide::getNiveau).reversed())
.collect(java.util.stream.Collectors.toList());
}
/** Trouve la priorité par code */
public static PrioriteAide parCode(String code) {
return java.util.Arrays.stream(values())
.filter(p -> p.getCode().equals(code))
.findFirst()
.orElse(NORMALE);
}
/** Calcule le score de priorité (plus bas = plus prioritaire) */
public double getScorePriorite() {
double score = niveau;
// Bonus pour notification immédiate
if (notificationImmediate) score -= 0.5;
// Bonus pour escalade automatique
if (escaladeAutomatique) score -= 0.3;
// Malus pour délai long
if (delaiTraitementHeures > 168) score += 0.2;
return score;
}
/** Vérifie si le délai de traitement est dépassé */
public boolean isDelaiDepasse(java.time.LocalDateTime dateCreation) {
java.time.LocalDateTime dateLimite = dateCreation.plusHours(delaiTraitementHeures);
return java.time.LocalDateTime.now().isAfter(dateLimite);
}
/** Calcule le pourcentage de temps écoulé */
public double getPourcentageTempsEcoule(java.time.LocalDateTime dateCreation) {
java.time.LocalDateTime maintenant = java.time.LocalDateTime.now();
java.time.LocalDateTime dateLimite = dateCreation.plusHours(delaiTraitementHeures);
long dureeTotal = java.time.Duration.between(dateCreation, dateLimite).toMinutes();
long dureeEcoulee = java.time.Duration.between(dateCreation, maintenant).toMinutes();
if (dureeTotal <= 0) return 100.0;
return Math.min(100.0, (dureeEcoulee * 100.0) / dureeTotal);
}
/** Retourne le message d'alerte selon le temps écoulé */
public String getMessageAlerte(java.time.LocalDateTime dateCreation) {
double pourcentage = getPourcentageTempsEcoule(dateCreation);
if (pourcentage >= 100) {
return "Délai de traitement dépassé !";
} else if (pourcentage >= 80) {
return "Délai de traitement bientôt dépassé";
} else if (pourcentage >= 60) {
return "Plus de la moitié du délai écoulé";
}
return null;
}
}

398
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/enums/solidarite/StatutAide.java
View File

@@ -3,8 +3,8 @@ package dev.lions.unionflow.server.api.enums.solidarite;
/**
* Énumération des statuts d'aide dans le système de solidarité
*
* Cette énumération définit les différents statuts qu'une demande d'aide
* peut avoir tout au long de son cycle de vie.
* <p>Cette énumération définit les différents statuts qu'une demande d'aide peut avoir tout au long
* de son cycle de vie.
*
* @author UnionFlow Team
* @version 1.0
@@ -12,170 +12,276 @@ package dev.lions.unionflow.server.api.enums.solidarite;
*/
public enum StatutAide {
// === STATUTS INITIAUX ===
BROUILLON("Brouillon", "draft", "La demande est en cours de rédaction", "#9E9E9E", "edit", false, false),
SOUMISE("Soumise", "submitted", "La demande a été soumise et attend validation", "#FF9800", "send", false, false),
// === STATUTS INITIAUX ===
BROUILLON(
"Brouillon",
"draft",
"La demande est en cours de rédaction",
"#9E9E9E",
"edit",
false,
false),
SOUMISE(
"Soumise",
"submitted",
"La demande a été soumise et attend validation",
"#FF9800",
"send",
false,
false),
// === STATUTS D'ÉVALUATION ===
EN_ATTENTE("En attente", "pending", "La demande est en attente d'évaluation", "#2196F3", "hourglass_empty", false, false),
EN_COURS_EVALUATION("En cours d'évaluation", "under_review", "La demande est en cours d'évaluation", "#FF9800", "rate_review", false, false),
INFORMATIONS_REQUISES("Informations requises", "info_required", "Des informations complémentaires sont requises", "#FF5722", "info", false, false),
// === STATUTS D'ÉVALUATION ===
EN_ATTENTE(
"En attente",
"pending",
"La demande est en attente d'évaluation",
"#2196F3",
"hourglass_empty",
false,
false),
EN_COURS_EVALUATION(
"En cours d'évaluation",
"under_review",
"La demande est en cours d'évaluation",
"#FF9800",
"rate_review",
false,
false),
INFORMATIONS_REQUISES(
"Informations requises",
"info_required",
"Des informations complémentaires sont requises",
"#FF5722",
"info",
false,
false),
// === STATUTS DE DÉCISION ===
APPROUVEE("Approuvée", "approved", "La demande a été approuvée", "#4CAF50", "check_circle", true, false),
APPROUVEE_PARTIELLEMENT("Approuvée partiellement", "partially_approved", "La demande a été approuvée partiellement", "#8BC34A", "check_circle_outline", true, false),
REJETEE("Rejetée", "rejected", "La demande a été rejetée", "#F44336", "cancel", true, true),
// === STATUTS DE DÉCISION ===
APPROUVEE(
"Approuvée",
"approved",
"La demande a été approuvée",
"#4CAF50",
"check_circle",
true,
false),
APPROUVEE_PARTIELLEMENT(
"Approuvée partiellement",
"partially_approved",
"La demande a été approuvée partiellement",
"#8BC34A",
"check_circle_outline",
true,
false),
REJETEE("Rejetée", "rejected", "La demande a été rejetée", "#F44336", "cancel", true, true),
// === STATUTS DE TRAITEMENT ===
EN_COURS_TRAITEMENT("En cours de traitement", "processing", "La demande approuvée est en cours de traitement", "#9C27B0", "settings", false, false),
EN_COURS_VERSEMENT("En cours de versement", "payment_processing", "Le versement est en cours", "#3F51B5", "payment", false, false),
// === STATUTS DE TRAITEMENT ===
EN_COURS_TRAITEMENT(
"En cours de traitement",
"processing",
"La demande approuvée est en cours de traitement",
"#9C27B0",
"settings",
false,
false),
EN_COURS_VERSEMENT(
"En cours de versement",
"payment_processing",
"Le versement est en cours",
"#3F51B5",
"payment",
false,
false),
// === STATUTS FINAUX ===
VERSEE("Versée", "paid", "L'aide a été versée avec succès", "#4CAF50", "paid", true, false),
LIVREE("Livrée", "delivered", "L'aide matérielle a été livrée", "#4CAF50", "local_shipping", true, false),
TERMINEE("Terminée", "completed", "L'aide a été fournie avec succès", "#4CAF50", "done_all", true, false),
// === STATUTS FINAUX ===
VERSEE("Versée", "paid", "L'aide a été versée avec succès", "#4CAF50", "paid", true, false),
LIVREE(
"Livrée",
"delivered",
"L'aide matérielle a été livrée",
"#4CAF50",
"local_shipping",
true,
false),
TERMINEE(
"Terminée",
"completed",
"L'aide a été fournie avec succès",
"#4CAF50",
"done_all",
true,
false),
// === STATUTS D'EXCEPTION ===
ANNULEE("Annulée", "cancelled", "La demande a été annulée", "#9E9E9E", "cancel", true, true),
SUSPENDUE("Suspendue", "suspended", "La demande a été suspendue temporairement", "#FF5722", "pause_circle", false, false),
EXPIREE("Expirée", "expired", "La demande a expiré", "#795548", "schedule", true, true),
// === STATUTS D'EXCEPTION ===
ANNULEE("Annulée", "cancelled", "La demande a été annulée", "#9E9E9E", "cancel", true, true),
SUSPENDUE(
"Suspendue",
"suspended",
"La demande a été suspendue temporairement",
"#FF5722",
"pause_circle",
false,
false),
EXPIREE("Expirée", "expired", "La demande a expiré", "#795548", "schedule", true, true),
// === STATUTS DE SUIVI ===
EN_SUIVI("En suivi", "follow_up", "L'aide fait l'objet d'un suivi", "#607D8B", "track_changes", false, false),
CLOTUREE("Clôturée", "closed", "Le dossier d'aide est clôturé", "#9E9E9E", "folder", true, false);
// === STATUTS DE SUIVI ===
EN_SUIVI(
"En suivi",
"follow_up",
"L'aide fait l'objet d'un suivi",
"#607D8B",
"track_changes",
false,
false),
CLOTUREE("Clôturée", "closed", "Le dossier d'aide est clôturé", "#9E9E9E", "folder", true, false);
private final String libelle;
private final String code;
private final String description;
private final String couleur;
private final String icone;
private final boolean estFinal;
private final boolean estEchec;
private final String libelle;
private final String code;
private final String description;
private final String couleur;
private final String icone;
private final boolean estFinal;
private final boolean estEchec;
StatutAide(String libelle, String code, String description, String couleur, String icone, boolean estFinal, boolean estEchec) {
this.libelle = libelle;
this.code = code;
this.description = description;
this.couleur = couleur;
this.icone = icone;
this.estFinal = estFinal;
this.estEchec = estEchec;
}
StatutAide(
String libelle,
String code,
String description,
String couleur,
String icone,
boolean estFinal,
boolean estEchec) {
this.libelle = libelle;
this.code = code;
this.description = description;
this.couleur = couleur;
this.icone = icone;
this.estFinal = estFinal;
this.estEchec = estEchec;
}
// === GETTERS ===
// === GETTERS ===
public String getLibelle() { return libelle; }
public String getCode() { return code; }
public String getDescription() { return description; }
public String getCouleur() { return couleur; }
public String getIcone() { return icone; }
public boolean isEstFinal() { return estFinal; }
public boolean isEstEchec() { return estEchec; }
public String getLibelle() {
return libelle;
}
// === MÉTHODES UTILITAIRES ===
public String getCode() {
return code;
}
/**
* Vérifie si le statut indique un succès
*/
public boolean isSucces() {
return this == VERSEE || this == LIVREE || this == TERMINEE;
}
public String getDescription() {
return description;
}
/**
* Vérifie si le statut est en cours de traitement
*/
public boolean isEnCours() {
return this == EN_COURS_EVALUATION || this == EN_COURS_TRAITEMENT || this == EN_COURS_VERSEMENT;
}
public String getCouleur() {
return couleur;
}
/**
* Vérifie si le statut permet la modification
*/
public boolean permetModification() {
return this == BROUILLON || this == INFORMATIONS_REQUISES;
}
public String getIcone() {
return icone;
}
/**
* Vérifie si le statut permet l'annulation
*/
public boolean permetAnnulation() {
return !estFinal && this != ANNULEE;
}
public boolean isEstFinal() {
return estFinal;
}
/**
* Retourne les statuts finaux
*/
public static java.util.List<StatutAide> getStatutsFinaux() {
return java.util.Arrays.stream(values())
.filter(StatutAide::isEstFinal)
.collect(java.util.stream.Collectors.toList());
}
public boolean isEstEchec() {
return estEchec;
}
/**
* Retourne les statuts d'échec
*/
public static java.util.List<StatutAide> getStatutsEchec() {
return java.util.Arrays.stream(values())
.filter(StatutAide::isEstEchec)
.collect(java.util.stream.Collectors.toList());
}
// === MÉTHODES UTILITAIRES ===
/**
* Retourne les statuts de succès
*/
public static java.util.List<StatutAide> getStatutsSucces() {
return java.util.Arrays.stream(values())
.filter(StatutAide::isSucces)
.collect(java.util.stream.Collectors.toList());
}
/** Vérifie si le statut indique un succès */
public boolean isSucces() {
return this == VERSEE || this == LIVREE || this == TERMINEE;
}
/**
* Retourne les statuts en cours
*/
public static java.util.List<StatutAide> getStatutsEnCours() {
return java.util.Arrays.stream(values())
.filter(StatutAide::isEnCours)
.collect(java.util.stream.Collectors.toList());
}
/** Vérifie si le statut est en cours de traitement */
public boolean isEnCours() {
return this == EN_COURS_EVALUATION || this == EN_COURS_TRAITEMENT || this == EN_COURS_VERSEMENT;
}
/**
* Vérifie si la transition vers un autre statut est valide
*/
public boolean peutTransitionnerVers(StatutAide nouveauStatut) {
// Règles de transition simplifiées
if (this == nouveauStatut) return false;
if (estFinal && nouveauStatut != EN_SUIVI) return false;
/** Vérifie si le statut permet la modification */
public boolean permetModification() {
return this == BROUILLON || this == INFORMATIONS_REQUISES;
}
return switch (this) {
case BROUILLON -> nouveauStatut == SOUMISE || nouveauStatut == ANNULEE;
case SOUMISE -> nouveauStatut == EN_ATTENTE || nouveauStatut == ANNULEE;
case EN_ATTENTE -> nouveauStatut == EN_COURS_EVALUATION || nouveauStatut == ANNULEE;
case EN_COURS_EVALUATION -> nouveauStatut == APPROUVEE || nouveauStatut == APPROUVEE_PARTIELLEMENT ||
nouveauStatut == REJETEE || nouveauStatut == INFORMATIONS_REQUISES ||
nouveauStatut == SUSPENDUE;
case INFORMATIONS_REQUISES -> nouveauStatut == EN_COURS_EVALUATION || nouveauStatut == ANNULEE;
case APPROUVEE, APPROUVEE_PARTIELLEMENT -> nouveauStatut == EN_COURS_TRAITEMENT || nouveauStatut == SUSPENDUE;
case EN_COURS_TRAITEMENT -> nouveauStatut == EN_COURS_VERSEMENT || nouveauStatut == LIVREE ||
nouveauStatut == TERMINEE || nouveauStatut == SUSPENDUE;
case EN_COURS_VERSEMENT -> nouveauStatut == VERSEE || nouveauStatut == SUSPENDUE;
case SUSPENDUE -> nouveauStatut == EN_COURS_EVALUATION || nouveauStatut == ANNULEE;
default -> false;
};
}
/** Vérifie si le statut permet l'annulation */
public boolean permetAnnulation() {
return !estFinal && this != ANNULEE;
}
/**
* Retourne le niveau de priorité pour l'affichage
*/
public int getNiveauPriorite() {
return switch (this) {
case INFORMATIONS_REQUISES -> 1;
case EN_COURS_EVALUATION, EN_COURS_TRAITEMENT, EN_COURS_VERSEMENT -> 2;
case APPROUVEE, APPROUVEE_PARTIELLEMENT -> 3;
case EN_ATTENTE, SOUMISE -> 4;
case SUSPENDUE -> 5;
case BROUILLON -> 6;
case EN_SUIVI -> 7;
default -> 8; // Statuts finaux
};
}
/** Retourne les statuts finaux */
public static java.util.List<StatutAide> getStatutsFinaux() {
return java.util.Arrays.stream(values())
.filter(StatutAide::isEstFinal)
.collect(java.util.stream.Collectors.toList());
}
/** Retourne les statuts d'échec */
public static java.util.List<StatutAide> getStatutsEchec() {
return java.util.Arrays.stream(values())
.filter(StatutAide::isEstEchec)
.collect(java.util.stream.Collectors.toList());
}
/** Retourne les statuts de succès */
public static java.util.List<StatutAide> getStatutsSucces() {
return java.util.Arrays.stream(values())
.filter(StatutAide::isSucces)
.collect(java.util.stream.Collectors.toList());
}
/** Retourne les statuts en cours */
public static java.util.List<StatutAide> getStatutsEnCours() {
return java.util.Arrays.stream(values())
.filter(StatutAide::isEnCours)
.collect(java.util.stream.Collectors.toList());
}
/** Vérifie si la transition vers un autre statut est valide */
public boolean peutTransitionnerVers(StatutAide nouveauStatut) {
// Règles de transition simplifiées
if (this == nouveauStatut) return false;
if (estFinal && nouveauStatut != EN_SUIVI) return false;
return switch (this) {
case BROUILLON -> nouveauStatut == SOUMISE || nouveauStatut == ANNULEE;
case SOUMISE -> nouveauStatut == EN_ATTENTE || nouveauStatut == ANNULEE;
case EN_ATTENTE -> nouveauStatut == EN_COURS_EVALUATION || nouveauStatut == ANNULEE;
case EN_COURS_EVALUATION ->
nouveauStatut == APPROUVEE
|| nouveauStatut == APPROUVEE_PARTIELLEMENT
|| nouveauStatut == REJETEE
|| nouveauStatut == INFORMATIONS_REQUISES
|| nouveauStatut == SUSPENDUE;
case INFORMATIONS_REQUISES ->
nouveauStatut == EN_COURS_EVALUATION || nouveauStatut == ANNULEE;
case APPROUVEE, APPROUVEE_PARTIELLEMENT ->
nouveauStatut == EN_COURS_TRAITEMENT || nouveauStatut == SUSPENDUE;
case EN_COURS_TRAITEMENT ->
nouveauStatut == EN_COURS_VERSEMENT
|| nouveauStatut == LIVREE
|| nouveauStatut == TERMINEE
|| nouveauStatut == SUSPENDUE;
case EN_COURS_VERSEMENT -> nouveauStatut == VERSEE || nouveauStatut == SUSPENDUE;
case SUSPENDUE -> nouveauStatut == EN_COURS_EVALUATION || nouveauStatut == ANNULEE;
default -> false;
};
}
/** Retourne le niveau de priorité pour l'affichage */
public int getNiveauPriorite() {
return switch (this) {
case INFORMATIONS_REQUISES -> 1;
case EN_COURS_EVALUATION, EN_COURS_TRAITEMENT, EN_COURS_VERSEMENT -> 2;
case APPROUVEE, APPROUVEE_PARTIELLEMENT -> 3;
case EN_ATTENTE, SOUMISE -> 4;
case SUSPENDUE -> 5;
case BROUILLON -> 6;
case EN_SUIVI -> 7;
default -> 8; // Statuts finaux
};
}
}

719
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/enums/solidarite/TypeAide.java
View File

@@ -3,8 +3,8 @@ package dev.lions.unionflow.server.api.enums.solidarite;
/**
* Énumération des types d'aide disponibles dans le système de solidarité
*
* Cette énumération définit les différents types d'aide que les membres
* peuvent demander ou proposer dans le cadre du système de solidarité.
* <p>Cette énumération définit les différents types d'aide que les membres peuvent demander ou
* proposer dans le cadre du système de solidarité.
*
* @author UnionFlow Team
* @version 1.0
@@ -12,273 +12,504 @@ package dev.lions.unionflow.server.api.enums.solidarite;
*/
public enum TypeAide {
// === AIDE FINANCIÈRE ===
AIDE_FINANCIERE_URGENTE("Aide financière urgente", "financiere", "urgent",
"Aide financière pour situation d'urgence", "emergency_fund", "#F44336",
true, true, 5000.0, 50000.0, 7),
// === AIDE FINANCIÈRE ===
AIDE_FINANCIERE_URGENTE(
"Aide financière urgente",
"financiere",
"urgent",
"Aide financière pour situation d'urgence",
"emergency_fund",
"#F44336",
true,
true,
5000.0,
50000.0,
7),
PRET_SANS_INTERET("Prêt sans intérêt", "financiere", "important",
"Prêt sans intérêt entre membres", "account_balance", "#FF9800",
true, true, 10000.0, 100000.0, 30),
PRET_SANS_INTERET(
"Prêt sans intérêt",
"financiere",
"important",
"Prêt sans intérêt entre membres",
"account_balance",
"#FF9800",
true,
true,
10000.0,
100000.0,
30),
AIDE_COTISATION("Aide pour cotisation", "financiere", "normal",
"Aide pour payer les cotisations", "payment", "#2196F3",
true, false, 1000.0, 10000.0, 14),
AIDE_COTISATION(
"Aide pour cotisation",
"financiere",
"normal",
"Aide pour payer les cotisations",
"payment",
"#2196F3",
true,
false,
1000.0,
10000.0,
14),
AIDE_FRAIS_MEDICAUX("Aide frais médicaux", "financiere", "urgent",
"Aide pour frais médicaux et hospitaliers", "medical_services", "#E91E63",
true, true, 5000.0, 200000.0, 7),
AIDE_FRAIS_MEDICAUX(
"Aide frais médicaux",
"financiere",
"urgent",
"Aide pour frais médicaux et hospitaliers",
"medical_services",
"#E91E63",
true,
true,
5000.0,
200000.0,
7),
AIDE_FRAIS_SCOLARITE("Aide frais de scolarité", "financiere", "important",
"Aide pour frais de scolarité des enfants", "school", "#9C27B0",
true, true, 10000.0, 100000.0, 21),
AIDE_FRAIS_SCOLARITE(
"Aide frais de scolarité",
"financiere",
"important",
"Aide pour frais de scolarité des enfants",
"school",
"#9C27B0",
true,
true,
10000.0,
100000.0,
21),
// === AIDE MATÉRIELLE ===
DON_MATERIEL("Don de matériel", "materielle", "normal",
"Don d'objets, équipements ou matériel", "inventory", "#4CAF50",
false, false, null, null, 14),
// === AIDE MATÉRIELLE ===
DON_MATERIEL(
"Don de matériel",
"materielle",
"normal",
"Don d'objets, équipements ou matériel",
"inventory",
"#4CAF50",
false,
false,
null,
null,
14),
PRET_MATERIEL("Prêt de matériel", "materielle", "normal",
"Prêt temporaire d'objets ou équipements", "build", "#607D8B",
false, false, null, null, 30),
PRET_MATERIEL(
"Prêt de matériel",
"materielle",
"normal",
"Prêt temporaire d'objets ou équipements",
"build",
"#607D8B",
false,
false,
null,
null,
30),
AIDE_DEMENAGEMENT("Aide déménagement", "materielle", "normal",
"Aide pour déménagement (transport, main d'œuvre)", "local_shipping", "#795548",
false, false, null, null, 7),
AIDE_DEMENAGEMENT(
"Aide déménagement",
"materielle",
"normal",
"Aide pour déménagement (transport, main d'œuvre)",
"local_shipping",
"#795548",
false,
false,
null,
null,
7),
AIDE_TRAVAUX("Aide travaux", "materielle", "normal",
"Aide pour travaux de rénovation ou construction", "construction", "#FF5722",
false, false, null, null, 21),
AIDE_TRAVAUX(
"Aide travaux",
"materielle",
"normal",
"Aide pour travaux de rénovation ou construction",
"construction",
"#FF5722",
false,
false,
null,
null,
21),
// === AIDE PROFESSIONNELLE ===
AIDE_RECHERCHE_EMPLOI("Aide recherche d'emploi", "professionnelle", "important",
"Aide pour recherche d'emploi et CV", "work", "#3F51B5",
false, false, null, null, 30),
// === AIDE PROFESSIONNELLE ===
AIDE_RECHERCHE_EMPLOI(
"Aide recherche d'emploi",
"professionnelle",
"important",
"Aide pour recherche d'emploi et CV",
"work",
"#3F51B5",
false,
false,
null,
null,
30),
FORMATION_PROFESSIONNELLE("Formation professionnelle", "professionnelle", "normal",
"Formation et développement des compétences", "school", "#009688",
false, false, null, null, 60),
FORMATION_PROFESSIONNELLE(
"Formation professionnelle",
"professionnelle",
"normal",
"Formation et développement des compétences",
"school",
"#009688",
false,
false,
null,
null,
60),
CONSEIL_JURIDIQUE("Conseil juridique", "professionnelle", "important",
"Conseil et assistance juridique", "gavel", "#8BC34A",
false, false, null, null, 14),
CONSEIL_JURIDIQUE(
"Conseil juridique",
"professionnelle",
"important",
"Conseil et assistance juridique",
"gavel",
"#8BC34A",
false,
false,
null,
null,
14),
AIDE_CREATION_ENTREPRISE("Aide création d'entreprise", "professionnelle", "normal",
"Accompagnement création d'entreprise", "business", "#CDDC39",
false, false, null, null, 90),
AIDE_CREATION_ENTREPRISE(
"Aide création d'entreprise",
"professionnelle",
"normal",
"Accompagnement création d'entreprise",
"business",
"#CDDC39",
false,
false,
null,
null,
90),
// === AIDE SOCIALE ===
GARDE_ENFANTS("Garde d'enfants", "sociale", "normal",
"Garde d'enfants ponctuelle ou régulière", "child_care", "#FFC107",
false, false, null, null, 7),
// === AIDE SOCIALE ===
GARDE_ENFANTS(
"Garde d'enfants",
"sociale",
"normal",
"Garde d'enfants ponctuelle ou régulière",
"child_care",
"#FFC107",
false,
false,
null,
null,
7),
AIDE_PERSONNES_AGEES("Aide personnes âgées", "sociale", "important",
"Aide et accompagnement personnes âgées", "elderly", "#FF9800",
false, false, null, null, 30),
AIDE_PERSONNES_AGEES(
"Aide personnes âgées",
"sociale",
"important",
"Aide et accompagnement personnes âgées",
"elderly",
"#FF9800",
false,
false,
null,
null,
30),
TRANSPORT("Transport", "sociale", "normal",
"Aide au transport (covoiturage, accompagnement)", "directions_car", "#2196F3",
false, false, null, null, 7),
TRANSPORT(
"Transport",
"sociale",
"normal",
"Aide au transport (covoiturage, accompagnement)",
"directions_car",
"#2196F3",
false,
false,
null,
null,
7),
AIDE_ADMINISTRATIVE("Aide administrative", "sociale", "normal",
"Aide pour démarches administratives", "description", "#9E9E9E",
false, false, null, null, 14),
AIDE_ADMINISTRATIVE(
"Aide administrative",
"sociale",
"normal",
"Aide pour démarches administratives",
"description",
"#9E9E9E",
false,
false,
null,
null,
14),
// === AIDE D'URGENCE ===
HEBERGEMENT_URGENCE("Hébergement d'urgence", "urgence", "urgent",
"Hébergement temporaire d'urgence", "home", "#F44336",
false, true, null, null, 7),
// === AIDE D'URGENCE ===
HEBERGEMENT_URGENCE(
"Hébergement d'urgence",
"urgence",
"urgent",
"Hébergement temporaire d'urgence",
"home",
"#F44336",
false,
true,
null,
null,
7),
AIDE_ALIMENTAIRE("Aide alimentaire", "urgence", "urgent",
"Aide alimentaire d'urgence", "restaurant", "#FF5722",
false, true, null, null, 3),
AIDE_ALIMENTAIRE(
"Aide alimentaire",
"urgence",
"urgent",
"Aide alimentaire d'urgence",
"restaurant",
"#FF5722",
false,
true,
null,
null,
3),
AIDE_VESTIMENTAIRE("Aide vestimentaire", "urgence", "normal",
"Don de vêtements et accessoires", "checkroom", "#795548",
false, false, null, null, 14),
AIDE_VESTIMENTAIRE(
"Aide vestimentaire",
"urgence",
"normal",
"Don de vêtements et accessoires",
"checkroom",
"#795548",
false,
false,
null,
null,
14),
// === AIDE SPÉCIALISÉE ===
SOUTIEN_PSYCHOLOGIQUE("Soutien psychologique", "specialisee", "important",
"Soutien et écoute psychologique", "psychology", "#E91E63",
false, true, null, null, 30),
// === AIDE SPÉCIALISÉE ===
SOUTIEN_PSYCHOLOGIQUE(
"Soutien psychologique",
"specialisee",
"important",
"Soutien et écoute psychologique",
"psychology",
"#E91E63",
false,
true,
null,
null,
30),
AIDE_NUMERIQUE("Aide numérique", "specialisee", "normal",
"Aide pour utilisation outils numériques", "computer", "#607D8B",
false, false, null, null, 14),
AIDE_NUMERIQUE(
"Aide numérique",
"specialisee",
"normal",
"Aide pour utilisation outils numériques",
"computer",
"#607D8B",
false,
false,
null,
null,
14),
TRADUCTION("Traduction", "specialisee", "normal",
"Services de traduction et interprétariat", "translate", "#9C27B0",
false, false, null, null, 7),
TRADUCTION(
"Traduction",
"specialisee",
"normal",
"Services de traduction et interprétariat",
"translate",
"#9C27B0",
false,
false,
null,
null,
7),
AUTRE("Autre", "autre", "normal",
"Autre type d'aide non catégorisé", "help", "#9E9E9E",
false, false, null, null, 14);
AUTRE(
"Autre",
"autre",
"normal",
"Autre type d'aide non catégorisé",
"help",
"#9E9E9E",
false,
false,
null,
null,
14);
private final String libelle;
private final String categorie;
private final String priorite;
private final String description;
private final String icone;
private final String couleur;
private final boolean necessiteMontant;
private final boolean necessiteValidation;
private final Double montantMin;
private final Double montantMax;
private final int delaiReponseJours;
private final String libelle;
private final String categorie;
private final String priorite;
private final String description;
private final String icone;
private final String couleur;
private final boolean necessiteMontant;
private final boolean necessiteValidation;
private final Double montantMin;
private final Double montantMax;
private final int delaiReponseJours;
TypeAide(String libelle, String categorie, String priorite, String description,
String icone, String couleur, boolean necessiteMontant, boolean necessiteValidation,
Double montantMin, Double montantMax, int delaiReponseJours) {
this.libelle = libelle;
this.categorie = categorie;
this.priorite = priorite;
this.description = description;
this.icone = icone;
this.couleur = couleur;
this.necessiteMontant = necessiteMontant;
this.necessiteValidation = necessiteValidation;
this.montantMin = montantMin;
this.montantMax = montantMax;
this.delaiReponseJours = delaiReponseJours;
TypeAide(
String libelle,
String categorie,
String priorite,
String description,
String icone,
String couleur,
boolean necessiteMontant,
boolean necessiteValidation,
Double montantMin,
Double montantMax,
int delaiReponseJours) {
this.libelle = libelle;
this.categorie = categorie;
this.priorite = priorite;
this.description = description;
this.icone = icone;
this.couleur = couleur;
this.necessiteMontant = necessiteMontant;
this.necessiteValidation = necessiteValidation;
this.montantMin = montantMin;
this.montantMax = montantMax;
this.delaiReponseJours = delaiReponseJours;
}
// === GETTERS ===
public String getLibelle() {
return libelle;
}
public String getCategorie() {
return categorie;
}
public String getPriorite() {
return priorite;
}
public String getDescription() {
return description;
}
public String getIcone() {
return icone;
}
public String getCouleur() {
return couleur;
}
public boolean isNecessiteMontant() {
return necessiteMontant;
}
public boolean isNecessiteValidation() {
return necessiteValidation;
}
public Double getMontantMin() {
return montantMin;
}
public Double getMontantMax() {
return montantMax;
}
public int getDelaiReponseJours() {
return delaiReponseJours;
}
// === MÉTHODES UTILITAIRES ===
/** Vérifie si le type d'aide est urgent */
public boolean isUrgent() {
return "urgent".equals(priorite);
}
/** Vérifie si le type d'aide est financier */
public boolean isFinancier() {
return "financiere".equals(categorie);
}
/** Vérifie si le type d'aide est matériel */
public boolean isMateriel() {
return "materielle".equals(categorie);
}
/** Vérifie si le montant est dans la fourchette autorisée */
public boolean isMontantValide(Double montant) {
if (!necessiteMontant || montant == null) return true;
if (montantMin != null && montant < montantMin) return false;
if (montantMax != null && montant > montantMax) return false;
return true;
}
/** Retourne le niveau de priorité numérique */
public int getNiveauPriorite() {
return switch (priorite) {
case "urgent" -> 1;
case "important" -> 2;
case "normal" -> 3;
default -> 3;
};
}
/** Retourne la date limite de réponse */
public java.time.LocalDateTime getDateLimiteReponse() {
return java.time.LocalDateTime.now().plusDays(delaiReponseJours);
}
/** Retourne les types d'aide par catégorie */
public static java.util.List<TypeAide> getParCategorie(String categorie) {
return java.util.Arrays.stream(values())
.filter(type -> type.getCategorie().equals(categorie))
.collect(java.util.stream.Collectors.toList());
}
/** Retourne les types d'aide urgents */
public static java.util.List<TypeAide> getUrgents() {
return java.util.Arrays.stream(values())
.filter(TypeAide::isUrgent)
.collect(java.util.stream.Collectors.toList());
}
/** Retourne les types d'aide financiers */
public static java.util.List<TypeAide> getFinanciers() {
return java.util.Arrays.stream(values())
.filter(TypeAide::isFinancier)
.collect(java.util.stream.Collectors.toList());
}
/** Retourne les catégories disponibles */
public static java.util.Set<String> getCategories() {
return java.util.Arrays.stream(values())
.map(TypeAide::getCategorie)
.collect(java.util.stream.Collectors.toSet());
}
/** Retourne le libellé de la catégorie */
public String getLibelleCategorie() {
return switch (categorie) {
case "financiere" -> "Aide financière";
case "materielle" -> "Aide matérielle";
case "professionnelle" -> "Aide professionnelle";
case "sociale" -> "Aide sociale";
case "urgence" -> "Aide d'urgence";
case "specialisee" -> "Aide spécialisée";
case "autre" -> "Autre";
default -> categorie;
};
}
/** Retourne l'unité du montant si applicable */
public String getUniteMontant() {
return necessiteMontant ? "FCFA" : null;
}
/** Retourne le message de validation du montant */
public String getMessageValidationMontant(Double montant) {
if (!necessiteMontant) return null;
if (montant == null) return "Le montant est obligatoire";
if (montantMin != null && montant < montantMin) {
return String.format("Le montant minimum est de %.0f FCFA", montantMin);
}
// === GETTERS ===
public String getLibelle() { return libelle; }
public String getCategorie() { return categorie; }
public String getPriorite() { return priorite; }
public String getDescription() { return description; }
public String getIcone() { return icone; }
public String getCouleur() { return couleur; }
public boolean isNecessiteMontant() { return necessiteMontant; }
public boolean isNecessiteValidation() { return necessiteValidation; }
public Double getMontantMin() { return montantMin; }
public Double getMontantMax() { return montantMax; }
public int getDelaiReponseJours() { return delaiReponseJours; }
// === MÉTHODES UTILITAIRES ===
/**
* Vérifie si le type d'aide est urgent
*/
public boolean isUrgent() {
return "urgent".equals(priorite);
}
/**
* Vérifie si le type d'aide est financier
*/
public boolean isFinancier() {
return "financiere".equals(categorie);
}
/**
* Vérifie si le type d'aide est matériel
*/
public boolean isMateriel() {
return "materielle".equals(categorie);
}
/**
* Vérifie si le montant est dans la fourchette autorisée
*/
public boolean isMontantValide(Double montant) {
if (!necessiteMontant || montant == null) return true;
if (montantMin != null && montant < montantMin) return false;
if (montantMax != null && montant > montantMax) return false;
return true;
}
/**
* Retourne le niveau de priorité numérique
*/
public int getNiveauPriorite() {
return switch (priorite) {
case "urgent" -> 1;
case "important" -> 2;
case "normal" -> 3;
default -> 3;
};
}
/**
* Retourne la date limite de réponse
*/
public java.time.LocalDateTime getDateLimiteReponse() {
return java.time.LocalDateTime.now().plusDays(delaiReponseJours);
}
/**
* Retourne les types d'aide par catégorie
*/
public static java.util.List<TypeAide> getParCategorie(String categorie) {
return java.util.Arrays.stream(values())
.filter(type -> type.getCategorie().equals(categorie))
.collect(java.util.stream.Collectors.toList());
}
/**
* Retourne les types d'aide urgents
*/
public static java.util.List<TypeAide> getUrgents() {
return java.util.Arrays.stream(values())
.filter(TypeAide::isUrgent)
.collect(java.util.stream.Collectors.toList());
}
/**
* Retourne les types d'aide financiers
*/
public static java.util.List<TypeAide> getFinanciers() {
return java.util.Arrays.stream(values())
.filter(TypeAide::isFinancier)
.collect(java.util.stream.Collectors.toList());
}
/**
* Retourne les catégories disponibles
*/
public static java.util.Set<String> getCategories() {
return java.util.Arrays.stream(values())
.map(TypeAide::getCategorie)
.collect(java.util.stream.Collectors.toSet());
}
/**
* Retourne le libellé de la catégorie
*/
public String getLibelleCategorie() {
return switch (categorie) {
case "financiere" -> "Aide financière";
case "materielle" -> "Aide matérielle";
case "professionnelle" -> "Aide professionnelle";
case "sociale" -> "Aide sociale";
case "urgence" -> "Aide d'urgence";
case "specialisee" -> "Aide spécialisée";
case "autre" -> "Autre";
default -> categorie;
};
}
/**
* Retourne l'unité du montant si applicable
*/
public String getUniteMontant() {
return necessiteMontant ? "FCFA" : null;
}
/**
* Retourne le message de validation du montant
*/
public String getMessageValidationMontant(Double montant) {
if (!necessiteMontant) return null;
if (montant == null) return "Le montant est obligatoire";
if (montantMin != null && montant < montantMin) {
return String.format("Le montant minimum est de %.0f FCFA", montantMin);
}
if (montantMax != null && montant > montantMax) {
return String.format("Le montant maximum est de %.0f FCFA", montantMax);
}
return null;
if (montantMax != null && montant > montantMax) {
return String.format("Le montant maximum est de %.0f FCFA", montantMax);
}
return null;
}
}

233
unionflow-server-api/src/main/java/dev/lions/unionflow/server/api/validation/ValidationConstants.java Normal file
View File

@@ -0,0 +1,233 @@
package dev.lions.unionflow.server.api.validation;
/**
* Constantes pour la validation des DTOs
*
* <p>Cette classe centralise toutes les contraintes de validation pour assurer la cohérence entre
* les différents DTOs du système.
*
* @author UnionFlow Team
* @version 2.0
* @since 2025-01-16
*/
public final class ValidationConstants {
private ValidationConstants() {
// Classe utilitaire - constructeur privé
}
// === CONTRAINTES DE TAILLE POUR LES TEXTES ===
/** Titre court (événements, aides, etc.) */
public static final int TITRE_MIN_LENGTH = 5;
public static final int TITRE_MAX_LENGTH = 100;
public static final String TITRE_SIZE_MESSAGE =
"Le titre doit contenir entre "
+ TITRE_MIN_LENGTH
+ " et "
+ TITRE_MAX_LENGTH
+ " caractères";
/** Nom d'organisation */
public static final int NOM_ORGANISATION_MIN_LENGTH = 2;
public static final int NOM_ORGANISATION_MAX_LENGTH = 200;
public static final String NOM_ORGANISATION_SIZE_MESSAGE =
"Le nom doit contenir entre "
+ NOM_ORGANISATION_MIN_LENGTH
+ " et "
+ NOM_ORGANISATION_MAX_LENGTH
+ " caractères";
/** Description standard */
public static final int DESCRIPTION_MIN_LENGTH = 20;
public static final int DESCRIPTION_MAX_LENGTH = 2000;
public static final String DESCRIPTION_SIZE_MESSAGE =
"La description doit contenir entre "
+ DESCRIPTION_MIN_LENGTH
+ " et "
+ DESCRIPTION_MAX_LENGTH
+ " caractères";
/** Description courte (événements) */
public static final int DESCRIPTION_COURTE_MAX_LENGTH = 1000;
public static final String DESCRIPTION_COURTE_SIZE_MESSAGE =
"La description ne peut pas dépasser " + DESCRIPTION_COURTE_MAX_LENGTH + " caractères";
/** Justification */
public static final int JUSTIFICATION_MAX_LENGTH = 1000;
public static final String JUSTIFICATION_SIZE_MESSAGE =
"La justification ne peut pas dépasser " + JUSTIFICATION_MAX_LENGTH + " caractères";
/** Commentaires */
public static final int COMMENTAIRES_MAX_LENGTH = 1000;
public static final String COMMENTAIRES_SIZE_MESSAGE =
"Les commentaires ne peuvent pas dépasser " + COMMENTAIRES_MAX_LENGTH + " caractères";
/** Raison de rejet */
public static final int RAISON_REJET_MAX_LENGTH = 500;
public static final String RAISON_REJET_SIZE_MESSAGE =
"La raison du rejet ne peut pas dépasser " + RAISON_REJET_MAX_LENGTH + " caractères";
/** Adresse */
public static final int ADRESSE_MAX_LENGTH = 200;
public static final String ADRESSE_SIZE_MESSAGE =
"L'adresse ne peut pas dépasser " + ADRESSE_MAX_LENGTH + " caractères";
/** Ville, région, quartier */
public static final int LOCALISATION_MAX_LENGTH = 50;
public static final String VILLE_SIZE_MESSAGE =
"La ville ne peut pas dépasser " + LOCALISATION_MAX_LENGTH + " caractères";
public static final String REGION_SIZE_MESSAGE =
"La région ne peut pas dépasser " + LOCALISATION_MAX_LENGTH + " caractères";
public static final String QUARTIER_SIZE_MESSAGE =
"Le quartier ne peut pas dépasser " + LOCALISATION_MAX_LENGTH + " caractères";
/** Rôle */
public static final int ROLE_MAX_LENGTH = 50;
public static final String ROLE_SIZE_MESSAGE =
"Le rôle ne peut pas dépasser " + ROLE_MAX_LENGTH + " caractères";
/** URL */
public static final int URL_MAX_LENGTH = 255;
public static final String URL_SIZE_MESSAGE =
"L'URL ne peut pas dépasser " + URL_MAX_LENGTH + " caractères";
/** Email */
public static final int EMAIL_MAX_LENGTH = 100;
public static final String EMAIL_SIZE_MESSAGE =
"L'email ne peut pas dépasser " + EMAIL_MAX_LENGTH + " caractères";
/** Nom et prénom */
public static final int NOM_PRENOM_MIN_LENGTH = 2;
public static final int NOM_PRENOM_MAX_LENGTH = 50;
public static final String NOM_SIZE_MESSAGE =
"Le nom doit contenir entre "
+ NOM_PRENOM_MIN_LENGTH
+ " et "
+ NOM_PRENOM_MAX_LENGTH
+ " caractères";
public static final String PRENOM_SIZE_MESSAGE =
"Le prénom doit contenir entre "
+ NOM_PRENOM_MIN_LENGTH
+ " et "
+ NOM_PRENOM_MAX_LENGTH
+ " caractères";
// === PATTERNS DE VALIDATION ===
/** Numéro de téléphone international */
public static final String TELEPHONE_PATTERN = "^\\+?[0-9]{8,15}$";
public static final String TELEPHONE_MESSAGE =
"Le numéro de téléphone doit contenir entre 8 et 15 chiffres, avec un indicatif optionnel"
+ " (+)";
/** Code devise ISO */
public static final String DEVISE_PATTERN = "^[A-Z]{3}$";
public static final String DEVISE_MESSAGE =
"La devise doit être un code ISO à 3 lettres majuscules";
/** Numéro de référence aide */
public static final String REFERENCE_AIDE_PATTERN = "^DA-\\d{4}-\\d{6}$";
public static final String REFERENCE_AIDE_MESSAGE =
"Le numéro de référence doit suivre le format DA-YYYY-NNNNNN";
/** Numéro de membre */
public static final String NUMERO_MEMBRE_PATTERN = "^UF-\\d{4}-[A-Z0-9]{8}$";
public static final String NUMERO_MEMBRE_MESSAGE =
"Format de numéro de membre invalide (UF-YYYY-XXXXXXXX)";
/** Couleur hexadécimale */
public static final String COULEUR_HEX_PATTERN = "^#[0-9A-Fa-f]{6}$";
public static final String COULEUR_HEX_MESSAGE = "Format de couleur invalide (format: #RRGGBB)";
// === CONTRAINTES NUMÉRIQUES ===
/** Montant minimum */
public static final String MONTANT_MIN_VALUE = "0.0";
public static final String MONTANT_POSITIF_MESSAGE = "Le montant doit être positif";
/** Contraintes pour les montants */
public static final int MONTANT_INTEGER_DIGITS = 10;
public static final int MONTANT_FRACTION_DIGITS = 2;
public static final String MONTANT_DIGITS_MESSAGE =
"Le montant doit avoir au maximum "
+ MONTANT_INTEGER_DIGITS
+ " chiffres entiers et "
+ MONTANT_FRACTION_DIGITS
+ " décimales";
// === MESSAGES D'ERREUR STANDARD ===
public static final String OBLIGATOIRE_MESSAGE = " est obligatoire";
public static final String EMAIL_FORMAT_MESSAGE = "L'adresse email n'est pas valide";
public static final String DATE_PASSEE_MESSAGE = "La date doit être dans le passé";
public static final String DATE_FUTURE_MESSAGE = "La date doit être dans le futur";
// === CONTRAINTES SPÉCIFIQUES ===
/** Documents joints */
public static final int DOCUMENTS_JOINTS_MAX_LENGTH = 1000;
public static final String DOCUMENTS_JOINTS_SIZE_MESSAGE =
"La liste des documents ne peut pas dépasser " + DOCUMENTS_JOINTS_MAX_LENGTH + " caractères";
/** Mode de versement */
public static final int MODE_VERSEMENT_MAX_LENGTH = 50;
public static final String MODE_VERSEMENT_SIZE_MESSAGE =
"Le mode de versement ne peut pas dépasser " + MODE_VERSEMENT_MAX_LENGTH + " caractères";
/** Numéro de transaction */
public static final int NUMERO_TRANSACTION_MAX_LENGTH = 100;
public static final String NUMERO_TRANSACTION_SIZE_MESSAGE =
"Le numéro de transaction ne peut pas dépasser "
+ NUMERO_TRANSACTION_MAX_LENGTH
+ " caractères";
/** Numéro d'enregistrement */
public static final int NUMERO_ENREGISTREMENT_MAX_LENGTH = 100;
public static final String NUMERO_ENREGISTREMENT_SIZE_MESSAGE =
"Le numéro d'enregistrement ne peut pas dépasser "
+ NUMERO_ENREGISTREMENT_MAX_LENGTH
+ " caractères";
/** Nom court d'organisation */
public static final int NOM_COURT_MAX_LENGTH = 50;
public static final String NOM_COURT_SIZE_MESSAGE =
"Le nom court ne peut pas dépasser " + NOM_COURT_MAX_LENGTH + " caractères";
/** Instructions et matériel */
public static final int INSTRUCTIONS_MAX_LENGTH = 500;
public static final String INSTRUCTIONS_SIZE_MESSAGE =
"Les instructions ne peuvent pas dépasser " + INSTRUCTIONS_MAX_LENGTH + " caractères";
/** Conditions météo */
public static final int CONDITIONS_METEO_MAX_LENGTH = 100;
public static final String CONDITIONS_METEO_SIZE_MESSAGE =
"Les conditions météo ne peuvent pas dépasser " + CONDITIONS_METEO_MAX_LENGTH + " caractères";
}