package dev.lions.unionflow.server.api.dto.dashboard;

import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

/**
 * DTO pour les statistiques mensuelles historiques
 * Utilisé pour générer des graphiques de croissance sur 12 mois
 *
 * @author UnionFlow Team
 * @version 2.0
 * @since 2026-03-07
 */
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class MonthlyStatDTO {

    /**
     * Mois au format "2026-01", "2026-02", etc.
     */
    @JsonProperty("month")
    private String month;

    /**
     * Nombre de membres ce mois-là
     */
    @JsonProperty("totalMembers")
    private Integer totalMembers;

    /**
     * Nombre de membres actifs ce mois-là
     */
    @JsonProperty("activeMembers")
    private Integer activeMembers;

    /**
     * Montant total des contributions ce mois-là
     */
    @JsonProperty("contributionAmount")
    private Double contributionAmount;

    /**
     * Nombre d'événements organisés ce mois-là
     */
    @JsonProperty("eventsCount")
    private Integer eventsCount;

    /**
     * Taux d'engagement ce mois-là
     */
    @JsonProperty("engagementRate")
    private Double engagementRate;

    /**
     * Nombre de nouveaux membres ce mois-là
     */
    @JsonProperty("newMembers")
    private Integer newMembers;

    /**
     * Nombre de cotisations payées ce mois-là
     */
    @JsonProperty("contributionsCount")
    private Integer contributionsCount;
}
