SmartReports/docs/superpowers/specs/2026-03-26-memoria-natixis-design.md

Design Spec: Campo Memoria + Parametro Natixis

Data: 2026-03-26 Scope: CertReports.Syncfusion — tutti i report (quotazione + expired)

---

Panoramica

Due feature indipendenti da aggiungere a tutti i report PDF generati dall'API:

1. Campo Memoria — nuovo KV nella sezione Analisi, subito dopo Leva, che mostra il valore del campo Memory della SP rpt_Master_CFT_ISIN.
2. Parametro ?natixis — flag URL che modifica il campo Tipologia: se true, usa info.Nome dalla SP; se false (default), usa info.Categoria come adesso.

---

Feature 1: Campo Memoria

Origine dati

• Il campo Memory (string) esiste già in CertificateInfo (riga 22 di CertificateModels.cs) e viene già letto dalla SP rpt_Master_CFT_ISIN.
• Nessuna modifica al modello o al data service necessaria.

Rendering

• Aggiunto come 9° item nella colonna sinistra di DrawAnalisi in entrambi i renderer:
  • AnagraficaSectionRenderer (report in quotazione)
  • ExpiredAnagraficaSectionRenderer (report expired: Scaduto/Rimborsato/Revocato)
• Posizione: subito dopo ("Leva", ...).
• Valore: string.IsNullOrWhiteSpace(info.Memory) ? "—" : info.Memory
• La colonna sinistra passa da 8 a 9 item, simmetrica alla colonna destra che ne ha già 9.

---

Feature 2: Parametro ?natixis

Comportamento

• ?natixis=false (default): Tipologia = info.Categoria — comportamento invariato
• ?natixis=true: Tipologia = info.Nome (campo Nome dalla SP rpt_Master_CFT_ISIN)

Propagazione del flag

Il flag segue lo stesso pattern di showBranding e showDividend:

1. CertificateReportData: aggiungere bool ShowNatixis { get; set; } = false;
2. ReportController: aggiungere [FromQuery(Name = "natixis")] bool showNatixis = false a tutti e 3 gli endpoint (GenerateReport, GenerateReportByIsin, DownloadReport) e al metodo helper GenerateAndReturnPdf.
3. IReportOrchestrator / ReportOrchestrator.GenerateReportAsync: aggiungere parametro bool showNatixis = false, propagarlo in CertificateReportData.ShowNatixis.
4. Renderer: AnagraficaSectionRenderer.DrawTitolo e ExpiredAnagraficaSectionRenderer.DrawTitolo usano già info.Categoria per il box Tipologia — sostituire con data.ShowNatixis ? info.Nome : info.Categoria.

Cache (Approccio A — flag concatenati)

La chiave cache segue il pattern esistente:

Flags attivi	Chiave cache
nessuno	{isin}
branding	{isin}:branded
natixis	{isin}:natixis
branding + natixis	{isin}:branded:natixis
dividend	{isin}:dividend
(combinazioni varie)	concatenazione ordinata

La logica di composizione della chiave cache va aggiornata in ReportOrchestrator per includere il suffisso :natixis quando showNatixis == true.

---

File modificati

File	Modifica
Models/CertificateModels.cs	Aggiungere bool ShowNatixis a CertificateReportData
Controllers/ReportController.cs	Aggiungere param natixis a tutti gli endpoint
Services/Interfaces/IServices.cs	Aggiornare firma GenerateReportAsync
Services/Implementations/ReportOrchestrator.cs	Aggiungere param, propagare flag, aggiornare cache key
Services/Implementations/AnagraficaSectionRenderer.cs	Aggiungere Memoria in DrawAnalisi; usare ShowNatixis in DrawTitolo
Services/Implementations/ExpiredAnagraficaSectionRenderer.cs	Stesse modifiche

---

Non in scope

• Modifica al data service o alle stored procedure (i campi Memory e Nome sono già letti)
• Modifica a EventiSectionRenderer, ScenarioSectionRenderer, ChartSectionRenderer, DividendSectionRenderer
• Aggiornamento documentazione API pubblica