Cayaqui.MPS.PptExport 0.5.1

Cayaqui.MPS.PptExport

Genera slides PowerPoint para reportes EVM programáticamente, usando Syncfusion.Presentation. Cada sección implementa IPptSlideSection y agrega uno o más slides a un IPresentation existente.

Distribución propietaria — requiere contrato comercial con Cayaqui. Ver LICENSE.txt.

Dependencias: Cayaqui.MPS.ReportModels (DTOs y paleta MPS) + licencia Syncfusion Presentation.

v0.5.0 — CoverSlide: portada corporativa fullscreen

Nueva sección CoverSlide que genera una portada profesional de pantalla completa (720×540 pt) sobre fondo primario oscuro. Diseño: barra superior amber → logos owner (izq) + MPS producto (der) → título / proyecto / fecha → logo Cayaqui footer.

Se activa con PptReportOptions.Logos (nuevo en esta versión):

var logos = new LogoOptions
{
    OwnerLogo        = new BytesLogo { Bytes = ownerLogoBytes },
    MpsLogo          = new BytesLogo { Bytes = mpsProductLogoBytes },
    MpsCompanyLogo   = new BytesLogo { Bytes = cayaquiLogoBytes }
};

var opts = new PptReportOptions { Theme = theme, Logos = logos };

await new PptReport()
    .AddCoverSlide()           // portada corporativa
    .AddEvmKpiStrip(kpis)
    .BuildAsync(stream, opts, ct);

v0.4.0 — ReportTheme integrado en PptReportOptions

PptReportOptions ahora expone Theme (tipo ReportTheme de Cayaqui.MPS.ReportModels). Permite compartir el mismo objeto de branding entre los tres formatos de export:

var theme = new ReportTheme
{
    ReportTitle          = "Monthly Project Report",
    ProjectName          = "Talara U3 — Expansion",
    CompanyName          = "Cayaqui S.A.",
    PreparedBy           = "Project Controls Team",
    ReportDate           = new DateTime(2026, 4, 30),
    ConfidentialityLabel = "CONFIDENCIAL",
    PrimaryColorHex      = "#0F2044",
    AccentColorHex       = "#C9961A"
};

// Excel
var excelStream = await excelExporter.ExportAsync(report, new ExcelExportOptions { Theme = theme });

// PowerPoint
var ctx = new PptReportContext(new PptReportOptions { Theme = theme });
await new EvmKpiStripSlide { Snapshot = kpi }.RenderAsync(prs, ctx);

Theme es null por default — comportamiento legacy sin cambios. Los slides existentes no consumen Theme directamente (el branding de slides usa PptReportOptions.HeaderBackgroundColor / AccentColor); Theme está disponible para slides que implementen portada corporativa en versiones futuras.

v0.3.5 — R9C esquema actualizado

R9cTableSlide ahora usa el nuevo esquema R9C: PO / CO / PC / Comprometido / Incurrido / Pagado / Trends / EAC / %Ejec. Requiere Cayaqui.MPS.ReportModels ≥ 0.3.5.

v0.3.4 — Paridad de colores con diseño web

WaterfallSlide: declaraciones de color refactorizadas para usar constantes de EvmChartPalette (WaterfallTotal, WaterfallSubtotal, Earned, Actual, Cyan, Amber). Sin cambio de comportamiento — mismos valores hex. Requiere Cayaqui.MPS.ReportModels ≥ 0.3.4.

v0.3.3 — 6 nuevas slides EPC (24 slides totales)

6 nuevas slides de project controls para ingeniería/procura:

Requiere Cayaqui.MPS.ReportModels ≥ 0.3.3. Sin breaking changes.

v0.2.0 — 18 slides EVM completos (Fase 1 + Fase 2)

Paridad total con Cayaqui.MPS.ExcelExport v0.6.0 y componentes MPS.Components.Evm.

Fase 1 — mirror ExcelExport (10 slides)

Fase 2 — secciones nuevas (8 slides)

v0.1.0 — Scaffold de infraestructura

Contratos base para el output layer PowerPoint:

Uso rápido — PptReport fluent builder

// DI registration
services.AddMpsPptExport(licenseKey: builder.Configuration["MPS:PptExportLicenseKey"]);

// Composition — en un handler, service o Blazor page
var report = new PptReport()
    .AddEvmKpiStrip(new EvmKpiStripSlide { Snapshot = kpiData })
    .AddEvmSCurveChart(new EvmSCurveChartSlide
    {
        Points      = sCurvePoints,
        Bac         = 20_000_000m,
        ControlDate = new DateTime(2026, 4, 30)
    })
    .AddCashflowChart(new CashflowChartSlide { Points = cashflowPoints })
    .AddMilestoneStrip(new MilestoneStripSlide { Milestones = milestones })
    .AddChangeOrderLog(new ChangeOrderLogSlide { Items = changeOrders })
    .AddWbsBudgetTable(new WbsBudgetTableSlide
    {
        Title = "Presupuesto WBS",
        Rows  = wbsRows
    })
    .AddRaciMatrix(new RaciMatrixSlide
    {
        Title = "Matriz RACI",
        Items = raciEntries
    });

// Export (Blazor)
@inject IPptReportExporter PptExporter
@inject IJSRuntime JS

await using var stream = await PptExporter.ExportAsync(report);
var bytes = ((MemoryStream)stream).ToArray();
using var dotnetStream = new DotNetStreamReference(new MemoryStream(bytes));
await JS.InvokeVoidAsync("downloadFileFromStream",
    $"reporte-{DateTime.Today:yyyy-MM-dd}.pptx",
    dotnetStream);

Uso manual (sin builder)

using var prs = Presentation.Create();
prs.SlideSize.Type = SlideSizeType.Widescreen;

var ctx = new PptReportContext(new PptReportOptions
{
    HeaderBackgroundColor = "#1F3864",
    AccentColor           = "#2E75B6",
    WatermarkText         = "DRAFT"
});

await new EvmKpiStripSlide  { Snapshot = kpiData }.RenderAsync(prs, ctx);
await new EvmSCurveChartSlide { Points = sCurvePoints, Bac = 10_000_000m }.RenderAsync(prs, ctx);

await using var ms = new MemoryStream();
prs.Save(ms);
prs.Close();

Coordenadas de slides

Las medidas en la API de Syncfusion.Presentation se expresan en puntos (pt). Un slide widescreen (16:9) mide 720 × 540 pt internamente en las implementaciones MPS.