Feat: Backend's documentation added

This commit is contained in:
2025-07-16 23:12:07 -03:00
parent 8878ec632e
commit 88f245a80d
39 changed files with 904 additions and 164 deletions

View File

@@ -1,13 +1,19 @@
namespace Mercados.Infrastructure.DataFetchers
{
/// <summary>
/// Clase estática que proporciona un mapeo entre los tickers de acciones y sus nombres descriptivos.
/// </summary>
public static class TickerNameMapping
{
/// <summary>
/// Diccionario privado que almacena los tickers como claves y los nombres de las empresas como valores.
/// La comparación de claves no distingue entre mayúsculas y minúsculas.
/// </summary>
private static readonly Dictionary<string, string> Names = new(StringComparer.OrdinalIgnoreCase)
{
// USA
{ "SPY", "S&P 500 ETF" }, // Cambiado de GSPC a SPY para Finnhub
{ "SPY", "S&P 500 ETF" },
{ "AAPL", "Apple Inc." },
{ "MSFT", "Microsoft Corp." },
{ "AMZN", "Amazon.com, Inc." },
{ "NVDA", "NVIDIA Corp." },
{ "AMD", "Advanced Micro Devices" },
@@ -19,6 +25,7 @@ namespace Mercados.Infrastructure.DataFetchers
{ "XLE", "Energy Select Sector SPDR" },
{ "XLK", "Technology Select Sector SPDR" },
{ "MELI", "MercadoLibre, Inc." },
{ "MSFT", "Microsoft Corp." },
{ "GLOB", "Globant" },
// ADRs Argentinos que cotizan en EEUU
@@ -53,9 +60,15 @@ namespace Mercados.Infrastructure.DataFetchers
{ "MELI.BA", "MercadoLibre (CEDEAR)" }, // Aclaramos que es el CEDEAR
};
/// <summary>
/// Obtiene el nombre descriptivo asociado a un ticker.
/// </summary>
/// <param name="ticker">El ticker de la acción (ej. "AAPL").</param>
/// <returns>El nombre completo de la empresa si se encuentra en el mapeo; de lo contrario, null.</returns>
public static string? GetName(string ticker)
{
return Names.GetValueOrDefault(ticker);
// Devuelve el nombre si existe, o null si no se encuentra la clave.
return Names.TryGetValue(ticker, out var name) ? name : $"Ticker no reconocido: {ticker}";
}
}
}