namespace MeterVault.Infrastructure.Dashboard;

/// <summary>One month of the PV panel: generation, and (when role-tagged meters exist) the
/// self-consumption / grid-draw / savings split that reproduces the sheet's Netz-Einsparung column.</summary>
public sealed record SolarMonth(
    DateOnly Period,
    double Generation,
    double? SelfConsumption,
    double? GridImport,
    double? TotalLoad,
    double? Savings);

/// <summary>Per-generation-meter total over the selected period (for the ranked list).</summary>
public sealed record GenerationMeterRow(int MeterId, string Name, double Generation);

/// <summary>
/// The PV / solar panel read model (SDD §8.4): total generation plus, when the install has tagged
/// a <c>total_load</c> and <c>grid_import</c> meter, self-consumption, autarky %, self-consumption %
/// and savings (Ersparnis). Derived metrics are null when no role config exists.
/// </summary>
public sealed record SolarSummary(
    double Generation,
    double? TotalLoad,
    double? GridImport,
    double? SelfConsumption,
    double? Autarky,
    double? SelfConsumptionRatio,
    double? Savings,
    IReadOnlyList<GenerationMeterRow> Meters,
    IReadOnlyList<SolarMonth> Months)
{
    /// <summary>True when the install has the role-tagged meters needed for self-consumption metrics.</summary>
    public bool HasLoadContext => TotalLoad is not null && GridImport is not null;

    /// <summary>True when at least one generation meter exists.</summary>
    public bool HasGeneration => Meters.Count > 0;
}