docs: update README and CLAUDE.md with expired certificate report feature

This commit is contained in:
2026-03-21 11:47:45 +01:00
parent 2546990556
commit 4df6f9bd86
2 changed files with 45 additions and 12 deletions

View File

@@ -5,9 +5,10 @@ Generatore di report PDF per certificati finanziari strutturati, sviluppato in A
## Caratteristiche principali
- Generazione PDF multi-sezione da dati SQL Server
- **Due template report**: certificati in quotazione (4 sezioni) e certificati non in quotazione / scaduti / rimborsati / revocati (3 sezioni) — rilevamento automatico dal campo `Stato`
- Grafico performance sottostanti (SkiaSharp → PNG in memoria)
- Footer con branding opzionale e hyperlink cliccabile
- Cache in memoria per ISIN già generati
- Cache in memoria per ISIN già generati (chiavi separate per tipo report e branding)
- Endpoint per PDF inline, download e grafico standalone
- Supporto Docker
@@ -23,13 +24,25 @@ Generatore di report PDF per certificati finanziari strutturati, sviluppato in A
## Struttura del report
### Certificati in quotazione (Stato = "Quotazione") — 4 sezioni
| Sezione | Contenuto |
|---------|-----------|
| **1 — Anagrafica** | Header con Tipologia / Data / Bid / Ask, caratteristiche prodotto, analisi KV, tabella sottostanti |
| **2 — Eventi** | Lista eventi cedole e autocall (tabella landscape multi-pagina) |
| **3 — Scenario** | Scenari di rendimento (opzionale) |
| **3 — Scenario** | Scenari di rendimento (opzionale, saltato se assente) |
| **4 — Grafico** | Performance storica dei sottostanti |
### Certificati non in quotazione (Stato = "Scaduto" / "Rimborsato" / "Revocato") — 3 sezioni
| Sezione | Contenuto |
|---------|-----------|
| **1 — Anagrafica (semplificata)** | Header con solo Tipologia, caratteristiche con Valore/Data Rimborso, analisi KV senza Sottostanti né Bid/Ask |
| **2 — Eventi** | Lista eventi con colonne adattate (Barriera Cedola, Soglia Rimborso, Barriera Capitale, Rimborso Capitale) |
| **3 — Grafico** | Performance storica dei sottostanti |
Il tipo di report viene selezionato automaticamente dall'orchestratore in base al campo `Stato` restituito dalla SP `rpt_Master_CFT_ISIN`.
## API Endpoints
```
@@ -102,12 +115,20 @@ Tutto il tema (colori, font, layout, brush/pen) è centralizzato in `CertReports
```
HTTP (ISIN) → ReportController → ReportOrchestrator
├── CertificateDataService (SP → anagrafica, sottostanti, eventi, scenario)
├── AnagraficaSectionRenderer → PdfDocument (Sezione 1)
├── EventiSectionRenderer → PdfDocument (Sezione 2)
├── ScenarioSectionRenderer → PdfDocument (Sezione 3, opzionale)
├── [Stato == "Quotazione"] ──────────────────────────────────────────
│ ├── AnagraficaSectionRenderer → PdfDocument (Sezione 1)
│ ├── EventiSectionRenderer → PdfDocument (Sezione 2)
│ ├── ScenarioSectionRenderer → PdfDocument (Sezione 3, opzionale)
│ └── ChartSectionRenderer → PdfDocument (Sezione 4)
├── [Stato != "Quotazione"] ─────────────────────────────────────────
│ ├── ExpiredAnagraficaSectionRenderer → PdfDocument (Sezione 1)
│ ├── EventiSectionRenderer → PdfDocument (Sezione 2, colonne adattate)
│ └── ChartSectionRenderer → PdfDocument (Sezione 3)
├── ChartDataService (SP → dati grafico)
├── SkiaChartRenderer → PNG in memoria
├── ChartSectionRenderer → PdfDocument (Sezione 4)
└── PdfMergerService → byte[] → Response
```