📚 Pré-requisitos Teóricos: este projeto aplica conceitos ensinados no Capítulo 17 — Programação Assíncrona com Async/Await da Especialização em Sistemas com C#. Recomendado revisar antes de iniciar.

🎯 Dashboard Financeiro em Tempo Real com SignalR & Redis

v1.0 — ASP.NET Core SignalR, WebSockets, Backplane Redis, Broadcast em Tempo Real

Série Prática C# & .NET 8 — Projeto Especializado

• ➡️ Projeto: 🎯 Dashboard Financeiro em Tempo Real com SignalR & Redis
• Subpasta Canônica: api-aspnet/

🏛️ Visão Geral & Arquitetura Visual

O projeto Dashboard Financeiro em Tempo Real com SignalR & Redis implementa uma infraestrutura de comunicação bidirecional de baixa latência baseada em WebSockets para transmissão de cotações financeiras em tempo real. A arquitetura emprega ASP.NET Core SignalR Hubs fortemente tipados, suporta broadcast para milhares de navegadores e aplicativos clientes simultâneos e utiliza um backplane em Redis para sincronização horizontal entre múltiplos nós de servidores.

📁 Estrutura de Pastas Anti-Colisão

Os artefatos em C# / .NET 8, projetos csproj e controladores estão organizados na subpasta canônica api-aspnet/:

catalogo_projetos/sistemas_csharp_04_signalr_realtime/
├── assets/
│   └── arquitetura_csharp_04.svg
├── api-aspnet/
│   ├── Program.cs
│   ├── README.md
│   └── ...
└── index.md

🧑‍💼 Engenharia de Software & Especificação Formal

1. Histórias de Usuário (User Stories)

2. Requisitos do Sistema

Requisitos Funcionais (RF)

• RF-01: Configurar endpoint SignalR Hub na rota /cotacoesHub.
• RF-02: Implementar método para clientes ingressarem e saírem de grupos de ativos específicos.
• RF-03: Implementar serviço em background (BackgroundService) simulando feed de cotações periódicas.
• RF-04: Transmitir cotações através do método fortemente tipado Clients.Group(ativo).ReceberCotacao(cotacao).
• RF-05: Configurar integração com Redis Backplane em ambiente de produção.

Requisitos Não-Funcionais (RNF)

• RNF-01 (Baixa Latência): Tempo de entrega de broadcast inferior a 15 milissegundos para clientes conectados.
• RNF-02 (Escalabilidade Horizontal): Suporte a dezenas de milhares de clientes com múltiplas instâncias unificadas via Redis.
• RNF-03 (Resiliência de Conexão): Reconexão automática do cliente em caso de instabilidade transitória de rede.
• RNF-04 (Conformidade .NET 8): Uso de ASP.NET Core SignalR nativo otimizado.
• RNF-05 (Tipagem Forte): Contratos de cliente definidos por interface C# eliminando erros de digitação de strings.

3. Diagrama de Casos de Uso

flowchart TD
    Market[(fa:fa-chart-line Feed de Cotações)]
    Hub[(fa:fa-tower-broadcast SignalR Hub & Redis)]
    Browsers[(fa:fa-mobile Dashboards Conectados)]

    subgraph AppSignalR ["🎯 SignalR Real-Time Hub (api-aspnet)"]
        UC01["Estabelecer Conexão WebSocket"]
        UC02["Entrar em Grupo de Ativo Financeiro"]
        UC03["Publicar Nova Cotação no Hub"]
        UC04["Distribuir via Redis Backplane"]
        UC05["Receber Push de Cotação no Cliente"]
    end

    Browsers --> UC01
    UC01 --> Hub
    Browsers --> UC02
    UC02 --> Hub
    Market --> UC03
    UC03 --> Hub
    Hub --> UC04
    UC04 --> Hub
    Hub --> UC05
    UC05 --> Browsers

4. Matriz de Rastreabilidade (RTM)

🛠️ Implementação Guiada

📄 api-aspnet/Hubs/FinanceiroHub.cs (arquivo real do projeto)

using Microsoft.AspNetCore.SignalR;

public class FinanceiroHub : Hub {
    public async Task EnviarAlerta(string ticker, decimal preco) {
        await Clients.All.SendAsync("ReceberCotacao", ticker, preco);
    }
}

🚀 Como Executar no Laboratório

1. Navegue até a subpasta do projeto

cd catalogo_projetos/sistemas_csharp_04_signalr_realtime/api-aspnet

2. Execute via .NET CLI

dotnet run

🏁 Matriz de Checkpoints de Conclusão