# Anagrafica Redesign + Footer Branding — Implementation Plan

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** Ridisegnare la Sezione 1 (Anagrafica) del report PDF con stile "Ibrido elegante", riordinare i campi come nel vecchio report DevExpress, portare la tabella Sottostanti in pagina 1, e aggiungere il parametro `?branding=true` per il footer Smart Roots.

**Architecture:** Quattro modifiche indipendenti in cascata: (1) propagazione del flag `ShowBranding` dal controller fino a `CertificateReportData`; (2) nuovi colori e helper `DrawFooter` in `PdfTheme`; (3) riscrittura completa di `AnagraficaSectionRenderer`; (4) aggiornamento cache key per includere il parametro branding.

**Tech Stack:** ASP.NET Core 8, Syncfusion.Pdf.Net.Core v33, C# 12. Nessun test runner — verifica manuale via `dotnet run` + browser con ISIN reale.

**Spec:** `docs/superpowers/specs/2026-03-20-anagrafica-redesign-design.md`

---

## File Map

| File | Azione | Responsabilità |
|------|--------|----------------|
| `CertReports.Syncfusion/Services/Interfaces/IServices.cs` | Modify | Aggiungere overload `GenerateReportAsync(string isin, bool showBranding)` a `IReportOrchestrator` |
| `CertReports.Syncfusion/Models/CertificateModels.cs` | Modify | Aggiungere `bool ShowBranding` a `CertificateReportData` |
| `CertReports.Syncfusion/Controllers/ReportController.cs` | Modify | Leggere `?branding=` da query string, passarlo all'orchestratore |
| `CertReports.Syncfusion/Services/Implementations/ReportOrchestrator.cs` | Modify | Firma `GenerateReportAsync` con `bool showBranding`, impostare `reportData.ShowBranding` |
| `CertReports.Syncfusion/Helpers/PdfTheme.cs` | Modify | Nuovi colori, riduzione margini/row height, metodo `DrawFooter()` |
| `CertReports.Syncfusion/Services/Implementations/AnagraficaSectionRenderer.cs` | Rewrite | Nuova struttura 3 sezioni, stile C, sottostanti in pagina 1 |

---

## Task 1: Propagazione flag `ShowBranding`

Aggiunge `ShowBranding` al modello dati e al flusso controller → orchestratore, senza ancora usarlo nel rendering.

**Files:**
- Modify: `CertReports.Syncfusion/Models/CertificateModels.cs`
- Modify: `CertReports.Syncfusion/Services/Interfaces/IServices.cs`
- Modify: `CertReports.Syncfusion/Controllers/ReportController.cs`
- Modify: `CertReports.Syncfusion/Services/Implementations/ReportOrchestrator.cs`

- [ ] **Step 1.1 — Aggiungere `ShowBranding` a `CertificateReportData`**

  In `Models/CertificateModels.cs`, nella classe `CertificateReportData` (riga 152), aggiungere la proprietà:

  ```csharp
  public class CertificateReportData
  {
      public CertificateInfo Info { get; set; } = new();
      public List<CertificateEvent> Eventi { get; set; } = new();
      public ScenarioAnalysis Scenario { get; set; } = new();
      public byte[]? ChartImage { get; set; }
      public bool ShowBranding { get; set; } = false;   // ← aggiunto
  }
  ```

- [ ] **Step 1.2 — Aggiornare l'interfaccia `IReportOrchestrator`**

  In `Services/Interfaces/IServices.cs`, aggiungere il parametro `showBranding`:

  ```csharp
  public interface IReportOrchestrator
  {
      Task<byte[]> GenerateReportAsync(string isin, bool showBranding = false);
  }
  ```

- [ ] **Step 1.3 — Aggiornare `ReportOrchestrator.GenerateReportAsync`**

  In `Services/Implementations/ReportOrchestrator.cs`:

  ```csharp
  public async Task<byte[]> GenerateReportAsync(string isin, bool showBranding = false)
  {
      // ── Cache check (chiave include branding) ─────────────────────────
      var cacheKey = showBranding ? $"{isin}:branded" : isin;
      var cached = _cache.Get(cacheKey);
      if (cached != null)
      {
          _logger.LogInformation("Report per ISIN {Isin} servito da cache ({Size} bytes)", isin, cached.Length);
          return cached;
      }

      _logger.LogInformation("Inizio generazione report per ISIN {Isin}", isin);

      // ── 1. Recupera tutti i dati ───────────────────────────────────
      var reportData = new CertificateReportData
      {
          Info    = await _dataService.GetCertificateInfoAsync(isin),
          Eventi  = await _dataService.GetCertificateEventsAsync(isin),
          Scenario = await _dataService.GetScenarioAnalysisAsync(isin),
          // ChartImage viene popolato più avanti dall'orchestratore — non aggiungere qui
          ShowBranding = showBranding,
      };

      // Tutto il resto del metodo è invariato.
      // Sostituire SOLO le due righe della cache:
      //   _cache.Get(isin)        →  _cache.Get(cacheKey)
      //   _cache.Set(isin, ...)   →  _cache.Set(cacheKey, finalPdf)
  }
  ```

  > Nota: modificare solo la firma, l'inizializzazione di `reportData` e le due righe cache. Il resto del metodo rimane identico.

- [ ] **Step 1.4 — Aggiornare `ReportController` per leggere `?branding=`**

  In `Controllers/ReportController.cs`, aggiornare tutti e tre i punti dove si chiama `_orchestrator.GenerateReportAsync`:

  **Endpoint `GenerateReport` (GET /api/report):**
  ```csharp
  [HttpGet]
  public async Task<IActionResult> GenerateReport(
      [FromQuery(Name = "p")] string? encryptedIsin = null,
      [FromQuery(Name = "alias")] string? aliasId = null,
      [FromQuery(Name = "branding")] bool showBranding = false)   // ← aggiunto
  {
      // ... logica risoluzione ISIN invariata ...
      return await GenerateAndReturnPdf(isin, showBranding);
  }
  ```

  **Endpoint `GenerateReportByIsin` (GET /api/report/by-isin/{isin}):**
  ```csharp
  [HttpGet("by-isin/{isin}")]
  public async Task<IActionResult> GenerateReportByIsin(
      string isin,
      [FromQuery(Name = "branding")] bool showBranding = false)   // ← aggiunto
  {
      if (string.IsNullOrWhiteSpace(isin) || isin.Length < 12)
          return BadRequest("ISIN non valido.");

      return await GenerateAndReturnPdf(isin, showBranding);
  }
  ```

  **Endpoint `DownloadReport` (GET /api/report/download):**
  ```csharp
  [HttpGet("download")]
  public async Task<IActionResult> DownloadReport(
      [FromQuery(Name = "p")] string? encryptedIsin = null,
      [FromQuery(Name = "alias")] string? aliasId = null,
      [FromQuery(Name = "branding")] bool showBranding = false)   // ← aggiunto
  {
      // ... logica risoluzione ISIN invariata ...
      var pdfBytes = await _orchestrator.GenerateReportAsync(isin, showBranding);
      return File(pdfBytes, "application/pdf", $"{isin}.pdf");
  }
  ```

  **Helper privato `GenerateAndReturnPdf`:**
  ```csharp
  private async Task<IActionResult> GenerateAndReturnPdf(string isin, bool showBranding)
  {
      try
      {
          _logger.LogInformation("Richiesta report per ISIN {Isin}", isin);
          var pdfBytes = await _orchestrator.GenerateReportAsync(isin, showBranding);
          Response.Headers.Append("Content-Disposition", $"inline; filename={isin}.pdf");
          return File(pdfBytes, "application/pdf");
      }
      catch (Exception ex)
      {
          _logger.LogError(ex, "Errore generazione report per ISIN {Isin}", isin);
          return StatusCode(500, "Errore nella generazione del report.");
      }
  }
  ```

- [ ] **Step 1.5 — Build e verifica compilazione**

  ```bash
  cd "CertReports.Syncfusion"
  dotnet build
  ```

  Atteso: `Build succeeded. 0 Error(s)`. Nessun warning su interfacce non implementate.

- [ ] **Step 1.6 — Commit**

  ```bash
  git add CertReports.Syncfusion/Models/CertificateModels.cs \
          CertReports.Syncfusion/Services/Interfaces/IServices.cs \
          CertReports.Syncfusion/Controllers/ReportController.cs \
          CertReports.Syncfusion/Services/Implementations/ReportOrchestrator.cs
  git commit -m "feat: add ShowBranding flag propagation from API to report data"
  ```

---

## Task 2: Aggiornare `PdfTheme` — nuovi colori, margini ridotti, `DrawFooter()`

**Files:**
- Modify: `CertReports.Syncfusion/Helpers/PdfTheme.cs`

- [ ] **Step 2.1 — Aggiungere nuovi colori e costanti**

  Aggiungere in coda al blocco `// ─── Colori ───` (dopo riga 24):

  ```csharp
  // Nuovi colori stile "Ibrido elegante"
  public static readonly Color AccentBlue    = Color.FromArgb(255, 21,  101, 192);  // #1565C0
  public static readonly Color NegativeRed   = Color.FromArgb(255, 204,   0,   0);  // #CC0000
  public static readonly Color PositiveGreen = Color.FromArgb(255,  46, 125,  50);  // #2E7D32
  public static readonly Color FooterText    = Color.FromArgb(255, 102, 102, 102);  // #666666
  public static readonly Color SeparatorLine = Color.FromArgb(255, 221, 221, 221);  // #DDDDDD
  public static readonly Color TableBorder   = Color.FromArgb(255, 187, 187, 187);  // #BBBBBB
  public static readonly Color TableAltRow   = Color.FromArgb(255, 247, 249, 252);  // #F7F9FC
  public static readonly Color TableHeaderBg = Color.FromArgb(255, 21,  101, 192);  // #1565C0 (same as AccentBlue)
  ```

  Aggiungere i brush/pen corrispondenti in coda al blocco `// ─── Brushes ───`:

  ```csharp
  public static PdfBrush AccentBlueBrush    => new PdfSolidBrush(AccentBlue);
  public static PdfBrush NegativeBrush2     => new PdfSolidBrush(NegativeRed);
  public static PdfBrush PositiveBrush2     => new PdfSolidBrush(PositiveGreen);
  public static PdfBrush FooterTextBrush    => new PdfSolidBrush(FooterText);
  public static PdfBrush TableAltRowBrush   => new PdfSolidBrush(TableAltRow);
  public static PdfBrush TableHeaderBrush   => new PdfSolidBrush(TableHeaderBg);
  public static PdfPen   SeparatorPen       => new PdfPen(SeparatorLine, 0.5f);
  public static PdfPen   TableBorderPen     => new PdfPen(TableBorder, 0.5f);
  public static PdfPen   AccentBluePen      => new PdfPen(AccentBlue, 2.5f);
  ```

- [ ] **Step 2.2 — Ridurre margini e row height**

  Modificare le costanti di layout esistenti (righe 43-46):

  ```csharp
  // ─── Margini & Layout ──────────────────────────────────────────────
  public const float PageMargin     = 36f;   // era 40f
  public const float RowHeight      = 14f;   // era 18f — KV pairs sezione Analisi
  public const float HeaderRowHeight = 18f;  // era 22f — header sezioni
  public const float CellPadding    = 4f;
  public const float FooterHeight   = 28f;   // spazio riservato footer in fondo alla pagina
  ```

- [ ] **Step 2.3 — Aggiungere font per footer e tabella sottostanti**

  In coda al blocco `// ─── Font ───`:

  ```csharp
  private static readonly PdfStandardFont _fontFooter      = new(PdfFontFamily.Helvetica, 7f);
  private static readonly PdfStandardFont _fontFooterBold  = new(PdfFontFamily.Helvetica, 7f, PdfFontStyle.Bold);
  private static readonly PdfStandardFont _fontTable       = new(PdfFontFamily.Helvetica, 7.5f);
  private static readonly PdfStandardFont _fontTableBold   = new(PdfFontFamily.Helvetica, 7.5f, PdfFontStyle.Bold);

  public static PdfFont Footer      => _fontFooter;
  public static PdfFont FooterBold  => _fontFooterBold;
  public static PdfFont TableFont   => _fontTable;
  public static PdfFont TableBold   => _fontTableBold;
  ```

- [ ] **Step 2.4 — Aggiungere helper `DrawFooter()`**

  Aggiungere alla fine della classe `PdfTheme`, prima della chiusura `}`:

  ```csharp
  /// <summary>
  /// Disegna il footer in fondo alla pagina.
  /// Se showBranding=true: "Powered by [Smart Roots↗]" a sx + numero pagina a dx.
  /// Se showBranding=false: solo numero pagina centrato.
  /// </summary>
  public static void DrawFooter(
      PdfGraphics g,
      float pageWidth,
      float pageHeight,
      int pageNumber,
      bool showBranding)
  {
      float footerY = pageHeight - FooterHeight + 6f;

      // Linea separatrice
      g.DrawLine(SeparatorPen, 0, footerY - 4f, pageWidth, footerY - 4f);

      string pageLabel = pageNumber.ToString();

      if (!showBranding)
      {
          // Solo numero pagina centrato
          g.DrawString(pageLabel, Footer, FooterTextBrush,
              new RectangleF(0, footerY, pageWidth, 12f),
              new PdfStringFormat(PdfTextAlignment.Center));
          return;
      }

      // "Powered by " testo normale
      const string prefix = "Powered by ";
      const string linkText = "Smart Roots";
      const string linkUrl = "https://www.smart-roots.net";

      float prefixWidth = Footer.MeasureString(prefix).Width;
      float linkWidth   = Footer.MeasureString(linkText).Width;

      g.DrawString(prefix, Footer, FooterTextBrush,
          new RectangleF(0, footerY, prefixWidth + 2f, 12f));

      // "Smart Roots" come hyperlink PDF
      var webLink = new PdfTextWebLink
      {
          Url  = linkUrl,
          Text = linkText,
          Font = Footer,
          Brush = AccentBlueBrush,
      };
      webLink.DrawTextWebLink(g, new PointF(prefixWidth, footerY));

      // Numero pagina a destra
      g.DrawString(pageLabel, Footer, FooterTextBrush,
          new RectangleF(0, footerY, pageWidth, 12f),
          new PdfStringFormat(PdfTextAlignment.Right));
  }
  ```

  > `PdfTextWebLink` richiede `using Syncfusion.Pdf.Interactive;` — aggiungere all'inizio del file `PdfTheme.cs`.

- [ ] **Step 2.5 — Build e verifica**

  ```bash
  dotnet build
  ```

  Atteso: `Build succeeded. 0 Error(s)`.

- [ ] **Step 2.6 — Commit**

  ```bash
  git add CertReports.Syncfusion/Helpers/PdfTheme.cs
  git commit -m "feat: add AccentBlue palette, reduced margins, DrawFooter with branding support"
  ```

---

## Task 3: Riscrivere `AnagraficaSectionRenderer`

Sostituzione completa del metodo `Render()` e degli helper privati. La struttura passa da 4 blocchi KV orizzontali a 3 sezioni verticali: Caratteristiche Prodotto, Analisi, Sottostanti.

**Files:**
- Rewrite: `CertReports.Syncfusion/Services/Implementations/AnagraficaSectionRenderer.cs`

- [ ] **Step 3.1 — Sostituire la classe completa**

  Sostituire l'intero contenuto del file con:

  ```csharp
  using CertReports.Syncfusion.Helpers;
  using CertReports.Syncfusion.Models;
  using CertReports.Syncfusion.Services.Interfaces;
  using Syncfusion.Drawing;
  using Syncfusion.Pdf;
  using Syncfusion.Pdf.Graphics;
  using Syncfusion.Pdf.Grid;

  namespace CertReports.Syncfusion.Services.Implementations;

  /// <summary>
  /// Sezione 1 — Prima pagina del report: Anagrafica + Analisi + Sottostanti.
  /// Struttura identica al vecchio report DevExpress, stile "Ibrido elegante".
  /// </summary>
  public class AnagraficaSectionRenderer : IPdfSectionRenderer
  {
      public string SectionName => "Anagrafica";
      public int Order => 1;

      // Larghezza area utile (A4 595pt - 2*36 margini)
      private const float PageW = 595f - 2 * PdfTheme.PageMargin;
      // Altezza area utile (A4 842pt - 2*36 margini - footer)
      private const float PageH = 842f - 2 * PdfTheme.PageMargin - PdfTheme.FooterHeight;
      private const float ColGap = 10f;
      private const float ColW = (PageW - ColGap) / 2f;
      private const float SectionGap = 10f;

      public PdfDocument Render(CertificateReportData data)
      {
          var doc = new PdfDocument();
          var page = PdfTheme.AddA4Page(doc);
          var g = page.Graphics;
          var info = data.Info;
          float y = 0f;

          // ── TITOLO ────────────────────────────────────────────────────
          y = DrawTitle(g, info, PageW, y);

          // ── SEZIONE A: CARATTERISTICHE PRODOTTO ───────────────────────
          y = DrawSectionLabel(g, "Caratteristiche Prodotto", y);
          y = DrawCaratteristiche(g, info, y);
          y += SectionGap;

          // ── SEZIONE B: ANALISI ────────────────────────────────────────
          y = DrawSectionLabel(g, "Analisi", y);
          y = DrawAnalisi(g, info, y);
          y += SectionGap;

          // ── SEZIONE C: SOTTOSTANTI ────────────────────────────────────
          if (info.Sottostanti.Count > 0)
          {
              // Se lo spazio rimanente è meno di 80pt, nuova pagina
              if (y > PageH - 80f)
              {
                  PdfTheme.DrawFooter(g, PageW, PageH, 1, data.ShowBranding);
                  page = doc.Pages.Add();
                  g = page.Graphics;
                  y = 0f;
              }

              y = DrawSectionLabel(g, "Sottostanti", y);
              DrawSottostanti(g, info.Sottostanti, PageW, y);
          }

          PdfTheme.DrawFooter(g, PageW, PageH, doc.Pages.Count, data.ShowBranding);

          return doc;
      }

      // ═══════════════════════════════════════════════════════════════
      // TITOLO con Bid/Ask a destra
      // ═══════════════════════════════════════════════════════════════

      private float DrawTitle(PdfGraphics g, CertificateInfo info, float w, float y)
      {
          // ISIN + nome prodotto a sinistra
          g.DrawString($"Scheda Prodotto   {info.Isin}",
              PdfTheme.SectionTitleFont,
              new PdfSolidBrush(PdfTheme.AccentBlue),
              new RectangleF(0, y, w * 0.65f, 20f));

          // Bid/Ask a destra
          if (!string.IsNullOrEmpty(info.Bid) && !string.IsNullOrEmpty(info.Ask))
          {
              string bidAsk = $"{info.Bid}  BID     {info.Ask}  ASK";
              g.DrawString(info.LastPriceDate, PdfTheme.Small,
                  new PdfSolidBrush(PdfTheme.TextSecondary),
                  new RectangleF(w * 0.65f, y, w * 0.35f, 10f),
                  new PdfStringFormat(PdfTextAlignment.Right));
              g.DrawString(bidAsk, PdfTheme.Bold,
                  new PdfSolidBrush(PdfTheme.AccentBlue),
                  new RectangleF(w * 0.65f, y + 10f, w * 0.35f, 12f),
                  new PdfStringFormat(PdfTextAlignment.Right));
          }

          y += 22f;

          // Tipologia sotto il titolo
          if (!string.IsNullOrEmpty(info.Categoria))
          {
              g.DrawString($"Tipologia:   {info.Categoria}", PdfTheme.Regular,
                  new PdfSolidBrush(PdfTheme.TextSecondary),
                  new RectangleF(0, y, w, 12f));
              y += 13f;
          }

          // Linea separatrice blu
          g.DrawLine(PdfTheme.AccentBluePen, 0, y + 2f, w, y + 2f);
          y += 8f;

          return y;
      }

      // ═══════════════════════════════════════════════════════════════
      // INTESTAZIONE DI SEZIONE (accent line laterale + testo blu)
      // ═══════════════════════════════════════════════════════════════

      private float DrawSectionLabel(PdfGraphics g, string title, float y)
      {
          // Accent line verticale sinistra
          g.DrawRectangle(PdfTheme.AccentBlueBrush, new RectangleF(0, y, 3f, 14f));
          g.DrawString(title, PdfTheme.Bold,
              new PdfSolidBrush(PdfTheme.AccentBlue),
              new RectangleF(6f, y, PageW, 14f));
          return y + 16f;
      }

      // ═══════════════════════════════════════════════════════════════
      // SEZIONE A: CARATTERISTICHE PRODOTTO
      // Sinistra: tabella emittente | Destra: cedole + rendimento totale
      // ═══════════════════════════════════════════════════════════════

      private float DrawCaratteristiche(PdfGraphics g, CertificateInfo info, float y)
      {
          float startY = y;

          // ── Colonna sinistra: tabella emittente ──
          float leftY = DrawEmittenteTable(g, info, 0, ColW, y);

          // ── Colonna destra: cedole + rendimento totale ──
          float rightX = ColW + ColGap;
          float rightY = DrawCedoleTable(g, info, rightX, ColW, y);

          return Math.Max(leftY, rightY);
      }

      private float DrawEmittenteTable(PdfGraphics g, CertificateInfo info, float x, float w, float y)
      {
          float rh = PdfTheme.RowHeight;
          float pad = PdfTheme.CellPadding;

          // Header blu
          g.DrawRectangle(PdfTheme.TableHeaderBrush, new RectangleF(x, y, w, rh));
          string headerText = string.IsNullOrEmpty(info.Emittente)
              ? "EMITTENTE"
              : $"EMITTENTE   {info.Emittente.ToUpper()}";
          g.DrawString(headerText, PdfTheme.TableBold,
              PdfTheme.HeaderTextBrush,
              new RectangleF(x + pad, y + 3f, w - pad * 2, rh));
          y += rh;

          // Righe dati
          var rows = new[]
          {
              ("ISIN",            info.Isin),
              ("Mercato",         info.Mercato),
              ("Valuta",          info.Valuta),
              ("Data Emissione",  info.DataEmissione),
              ("Data Scadenza",   info.Scadenza),
              ("Prossimo Autocall", info.NextAutocallDate),
          };

          for (int i = 0; i < rows.Length; i++)
          {
              var (label, value) = rows[i];
              if (string.IsNullOrWhiteSpace(value)) continue;

              bool alt = i % 2 == 1;
              if (alt)
                  g.DrawRectangle(new PdfSolidBrush(PdfTheme.TableAltRow),
                      new RectangleF(x, y, w, rh));

              g.DrawLine(PdfTheme.TableBorderPen, x, y, x + w, y);

              g.DrawString(label, PdfTheme.TableFont,
                  new PdfSolidBrush(PdfTheme.TextSecondary),
                  new RectangleF(x + pad, y + 2f, w * 0.5f, rh));

              var valueBrush = (label == "ISIN" || label == "Prossimo Autocall")
                  ? new PdfSolidBrush(PdfTheme.AccentBlue)
                  : new PdfSolidBrush(PdfTheme.TextPrimary);

              g.DrawString(value, PdfTheme.TableBold, valueBrush,
                  new RectangleF(x + w * 0.5f, y + 2f, w * 0.5f - pad, rh),
                  new PdfStringFormat(PdfTextAlignment.Right));

              y += rh;
          }

          // Bordo esterno tabella
          g.DrawRectangle(PdfTheme.TableBorderPen,
              new RectangleF(x, startY: y - rows.Length * rh - rh, w, rows.Length * rh + rh));

          return y + 2f;
      }

      private float DrawCedoleTable(PdfGraphics g, CertificateInfo info, float x, float w, float y)
      {
          float rh = PdfTheme.RowHeight;
          float pad = PdfTheme.CellPadding;

          // Header blu
          g.DrawRectangle(PdfTheme.TableHeaderBrush, new RectangleF(x, y, w, rh));
          g.DrawString("CEDOLE E RENDIMENTO", PdfTheme.TableBold,
              PdfTheme.HeaderTextBrush,
              new RectangleF(x + pad, y + 3f, w - pad * 2, rh));
          y += rh;

          var rows = new (string Label, string Value, bool IsNegative)[]
          {
              ("Importo Cedole Pagate",    info.CpnPagati?.ToString("N2") ?? "-",    false),
              ("Importo Cedole da Pagare", info.CpnDaPagare?.ToString("N2") ?? "-",  false),
              ("Importo Cedole in Memoria",info.CpnInMemoria?.ToString("N2") ?? "-", false),
              ("Rendimento Totale",        info.RendimentoAttuale,                    IsNegativeValue(info.RendimentoAttuale)),
          };

          for (int i = 0; i < rows.Length; i++)
          {
              var (label, value, isNeg) = rows[i];
              bool alt = i % 2 == 1;
              if (alt)
                  g.DrawRectangle(new PdfSolidBrush(PdfTheme.TableAltRow),
                      new RectangleF(x, y, w, rh));

              g.DrawLine(PdfTheme.TableBorderPen, x, y, x + w, y);

              g.DrawString(label, PdfTheme.TableFont,
                  new PdfSolidBrush(PdfTheme.TextSecondary),
                  new RectangleF(x + pad, y + 2f, w * 0.65f, rh));

              var valueBrush = isNeg
                  ? new PdfSolidBrush(PdfTheme.NegativeRed)
                  : new PdfSolidBrush(PdfTheme.TextPrimary);

              var valueFont = label == "Rendimento Totale" ? PdfTheme.TableBold : PdfTheme.TableFont;

              g.DrawString(value, valueFont, valueBrush,
                  new RectangleF(x + w * 0.65f, y + 2f, w * 0.35f - pad, rh),
                  new PdfStringFormat(PdfTextAlignment.Right));

              y += rh;
          }

          g.DrawLine(PdfTheme.TableBorderPen, x, y, x + w, y);

          return y + 2f;
      }

      // ═══════════════════════════════════════════════════════════════
      // SEZIONE B: ANALISI
      // Sinistra: caratteristiche prodotto | Destra: rendimenti
      // ═══════════════════════════════════════════════════════════════

      private float DrawAnalisi(PdfGraphics g, CertificateInfo info, float y)
      {
          var leftItems = new (string Label, string Value)[]
          {
              ("Importo Cedola (p.a.)", info.NominalAnnualYield),
              ("Frequenza Cedola",      info.FrequenzaCedole),
              ("Valore Nominale",       info.NominalValue?.ToString("N0") ?? "-"),
              ("Prezzo Emissione",      info.PrezzoEmissione?.ToString("N0") ?? "-"),
              ("Barriera Capitale",     info.LivelloBarriera),
              ("Tipo Barriera",         info.BarrierType),
              ("Tipo Basket",           info.BasketType),
              ("Leva",                  string.IsNullOrWhiteSpace(info.Leva) ? "—" : info.Leva),
          };

          var rightItems = new (string Label, string Value)[]
          {
              ("Rend. Capitale a Scadenza", info.CapitalReturnAtMaturity),
              ("IRR",                       info.IRR),
              ("Protezione Capitale",       info.BufferKProt),
              ("Protezione Coupon",         info.BufferCPNProt),
              ("Valore Autocall",           info.AutocallValue),
              ("Distanza Autocall",         info.TriggerAutocallDistance),
              ("Rendimento Autocall",       info.AutocallReturn),
              ("Fattore Airbag",            string.IsNullOrWhiteSpace(info.FattoreAirbag) ? "—" : info.FattoreAirbag),
              ("Trigger OneStar",           string.IsNullOrWhiteSpace(info.TriggerOneStar) ? "—" : info.TriggerOneStar),
          };

          float leftY  = DrawKVList(g, leftItems,  0,             ColW, y);
          float rightY = DrawKVList(g, rightItems, ColW + ColGap, ColW, y);

          return Math.Max(leftY, rightY);
      }

      private float DrawKVList(PdfGraphics g, (string Label, string Value)[] items, float x, float w, float y)
      {
          float rh  = PdfTheme.RowHeight;
          float pad = PdfTheme.CellPadding;
          float labelW = w * 0.58f;
          float valueW = w * 0.42f;

          foreach (var (label, value) in items)
          {
              if (string.IsNullOrWhiteSpace(value)) continue;

              g.DrawString(label, PdfTheme.TableFont,
                  new PdfSolidBrush(PdfTheme.TextSecondary),
                  new RectangleF(x + pad, y + 1f, labelW, rh));

              bool isNeg = IsNegativeValue(value);
              bool isKey = label is "Importo Cedola (p.a.)" or "Barriera Capitale";

              var brush = isNeg ? new PdfSolidBrush(PdfTheme.NegativeRed)
                        : isKey ? new PdfSolidBrush(PdfTheme.AccentBlue)
                        : new PdfSolidBrush(PdfTheme.TextPrimary);

              g.DrawString(value, PdfTheme.TableBold, brush,
                  new RectangleF(x + labelW, y + 1f, valueW - pad, rh),
                  new PdfStringFormat(PdfTextAlignment.Right));

              g.DrawLine(new PdfPen(PdfTheme.SeparatorLine, 0.3f),
                  x, y + rh, x + w, y + rh);

              y += rh;
          }
          return y;
      }

      // ═══════════════════════════════════════════════════════════════
      // SEZIONE C: SOTTOSTANTI (9 colonne, font 7.5pt)
      // ═══════════════════════════════════════════════════════════════

      private void DrawSottostanti(PdfGraphics g, List<Sottostante> sottostanti, float w, float y)
      {
          var grid = new PdfGrid();
          grid.Style.CellPadding = new PdfPaddings(2, 2, 2, 2);

          // 9 colonne (Dist.AC rimossa rispetto alla versione precedente)
          string[] headers = { "Nome", "Strike", "Last", "% Perf.", "Barr.K",
                                "Buffer K", "Trig.CPN", "Buf.CPN", "Trig.AC" };

          foreach (var _ in headers) grid.Columns.Add();

          // Header
          var hr = grid.Headers.Add(1)[0];
          for (int i = 0; i < headers.Length; i++)
          {
              hr.Cells[i].Value = headers[i];
              hr.Cells[i].Style.Font = PdfTheme.TableBold;
              hr.Cells[i].Style.BackgroundBrush = PdfTheme.TableHeaderBrush;
              hr.Cells[i].Style.TextBrush = PdfTheme.HeaderTextBrush as PdfBrush;
              hr.Cells[i].StringFormat = new PdfStringFormat(
                  i == 0 ? PdfTextAlignment.Left : PdfTextAlignment.Center);
          }

          // Righe dati
          for (int i = 0; i < sottostanti.Count; i++)
          {
              var s = sottostanti[i];
              var row = grid.Rows.Add();

              row.Cells[0].Value = s.Nome;
              row.Cells[1].Value = s.Strike;
              row.Cells[2].Value = s.LastPrice;
              row.Cells[3].Value = s.Performance;
              row.Cells[4].Value = s.CapitalBarrier;
              row.Cells[5].Value = s.ULCapitalBarrierBuffer;
              row.Cells[6].Value = s.CouponBarrier;
              row.Cells[7].Value = s.ULCouponBarrierBuffer;
              row.Cells[8].Value = s.TriggerAutocall;

              for (int c = 0; c < headers.Length; c++)
              {
                  row.Cells[c].Style.Font = PdfTheme.TableFont;
                  row.Cells[c].StringFormat = new PdfStringFormat(
                      c == 0 ? PdfTextAlignment.Left : PdfTextAlignment.Right);
              }

              // Colori performance e buffer negativi
              ColorPerformanceCell(row.Cells[3], s.Performance);   // % Perf.
              ColorPerformanceCell(row.Cells[5], s.ULCapitalBarrierBuffer); // Buffer K
              ColorPerformanceCell(row.Cells[7], s.ULCouponBarrierBuffer);  // Buf.CPN

              // Righe alternate
              if (i % 2 == 1)
                  for (int c = 0; c < headers.Length; c++)
                      row.Cells[c].Style.BackgroundBrush = PdfTheme.TableAltRowBrush;
          }

          // Larghezze proporzionali (totale = PageW)
          float[] cw = { 90f, 52f, 52f, 46f, 52f, 46f, 52f, 46f, 46f };
          float total = cw.Sum();
          float scale = w / total;
          for (int i = 0; i < cw.Length; i++)
              grid.Columns[i].Width = cw[i] * scale;

          PdfTheme.ApplyThinBorders(grid);
          grid.Draw(g, new PointF(0, y));
      }

      // ═══════════════════════════════════════════════════════════════
      // Helper
      // ═══════════════════════════════════════════════════════════════

      private static bool IsNegativeValue(string value)
      {
          if (string.IsNullOrWhiteSpace(value)) return false;
          // Considera negativo se inizia con '-' dopo trim di spazi e simboli
          var trimmed = value.TrimStart();
          return trimmed.StartsWith('-');
      }

      private static void ColorPerformanceCell(PdfGridCell cell, string value)
      {
          if (IsNegativeValue(value))
              cell.Style.TextBrush = new PdfSolidBrush(PdfTheme.NegativeRed);
          else if (!string.IsNullOrWhiteSpace(value) && value != "-" && value != "—")
              cell.Style.TextBrush = new PdfSolidBrush(PdfTheme.PositiveGreen);
      }
  }
  ```

  > **Nota su `DrawEmittenteTable`:** La variabile `startY` usata nel calcolo del bordo esterno va dichiarata prima del ciclo delle righe. Aggiungere `float startY = y;` subito dopo `y += rh;` (dopo l'header).

- [ ] **Step 3.2 — Correggere bordo inferiore in `DrawEmittenteTable`**

  Il codice dell'Step 3.1 contiene `new RectangleF(x, startY: y - ..., ...)` che non compila (`RectangleF` non supporta named arguments). Rimuovere completamente quel `DrawRectangle` e aggiungere invece una sola linea orizzontale finale sotto l'ultima riga:

  ```csharp
  // Sostituire il blocco DrawRectangle bordo esterno con questa singola riga:
  g.DrawLine(PdfTheme.TableBorderPen, x, y, x + w, y);
  ```

  Le linee orizzontali su ogni riga + l'header blu rendono il bordo esterno superfluo.

- [ ] **Step 3.3 — Build e verifica**

  ```bash
  dotnet build
  ```

  Atteso: `Build succeeded. 0 Error(s)`. Se ci sono errori di compilazione, correggerli prima di procedere.

- [ ] **Step 3.4 — Avviare l'applicazione e testare visivamente**

  ```bash
  dotnet run --project CertReports.Syncfusion
  ```

  Aprire nel browser:
  - `https://localhost:{porta}/api/report/by-isin/DE000UL00754` → verifica pagina 1 con nuova struttura
  - `https://localhost:{porta}/api/report/by-isin/DE000UL00754?branding=true` → verifica footer con link Smart Roots

  **Checklist visiva pagina 1:**
  - [ ] Titolo "Scheda Prodotto DE000UL00754" in blu, Bid/Ask a destra
  - [ ] Linea separatrice blu sotto il titolo
  - [ ] Sezione "Caratteristiche Prodotto" — tabella emittente a sinistra con header blu
  - [ ] Cedole pagate/da pagare/in memoria + Rendimento Totale a destra (rosso se negativo)
  - [ ] Sezione "Analisi" — 8 campi a sinistra, 9 a destra con KV pairs
  - [ ] Leva, Fattore Airbag, Trigger OneStar mostrati come "—"
  - [ ] Sezione "Sottostanti" — 9 colonne, valori negativi in rosso, tutto in pagina 1
  - [ ] Footer: solo "1" centrato senza branding
  - [ ] Footer con `?branding=true`: "Powered by Smart Roots" (link blu) + "1" a destra

- [ ] **Step 3.5 — Commit finale**

  ```bash
  git add CertReports.Syncfusion/Services/Implementations/AnagraficaSectionRenderer.cs
  git commit -m "feat: redesign page 1 - hybrid style, 3-section layout, sottostanti on page 1"
  ```

---

## Task 4: Verifica regressione sezioni 2-4

Controllare che le sezioni successive (Eventi, Scenario, Grafico) non siano state impattate dalla riduzione dei margini in `PdfTheme`.

**Files:** nessuno da modificare — solo verifica.

- [ ] **Step 4.1 — Verificare le sezioni successive**

  Aprire nel browser il report completo e scorrere tutte le pagine:

  - **Pagina 2 (Lista Eventi):** le colonne della tabella devono essere leggibili e non tagliate
  - **Pagina 3+ (Analisi Scenario):** gradiente rosso→verde intatto, valori negativi in rosso
  - **Ultima pagina (Grafico):** linee, legenda e assi corretti

  Se la tabella Eventi o Scenario risulta più larga del previsto (per via del PageMargin ridotto da 40 a 36), aggiornare le larghezze colonne nei rispettivi renderer per sfruttare i 8pt extra disponibili.

- [ ] **Step 4.2 — Commit di eventuali aggiustamenti**

  Se sono stati necessari aggiustamenti ai renderer esistenti:

  ```bash
  # Aggiungere solo i renderer effettivamente modificati (non AnagraficaSectionRenderer)
  # Esempi:
  git add CertReports.Syncfusion/Services/Implementations/EventiSectionRenderer.cs
  git add CertReports.Syncfusion/Services/Implementations/ScenarioSectionRenderer.cs
  git commit -m "fix: adjust section renderers for updated PageMargin (36pt)"
  ```

---

## Note implementative

- **`PdfTextWebLink`** richiede `using Syncfusion.Pdf.Interactive;` — aggiungere all'header di `PdfTheme.cs`
- La cache key ora è `{isin}:branded` per le richieste con branding, `{isin}` per le normali — le due versioni sono cacheate separatamente
- I renderer Scenario, Eventi e Grafico chiamano già `renderer.Render(reportData)` passando `reportData` — `ShowBranding` è disponibile nel dato ma queste sezioni non lo usano (per ora non hanno footer)
- Se in futuro si vuole aggiungere il footer anche alle altre sezioni, basta aggiungere `PdfTheme.DrawFooter(...)` alla fine di ogni renderer