> For the complete documentation index, see [llms.txt](https://docs.voa.health/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.voa.health/apendice/testes-de-carga.md).

# Testes de Carga

Diretrizes para Testes de Carga

### Visão Geral

Este documento descreve as diretrizes para execução de testes de carga em nossa plataforma de transcrição em tempo real e geração de documentos. Para acesso aos endpoints específicos de teste e scripts de exemplo, entre em contato com nossa equipe através do email <team@voahealth.com>.

### Ambiente de Execução

Os testes de carga devem ser realizados exclusivamente em ambiente de produção, pois nossos ambientes de desenvolvimento e homologação são dimensionados apenas para testes funcionais, não sendo representativos para análises de performance.

### Janelas de Tempo

| Parâmetro               | Valor                 |
| ----------------------- | --------------------- |
| Horário Preferencial    | 22h às 04h (Brasília) |
| Duração Máxima          | 2 horas por sessão    |
| Intervalo entre Sessões | 4 horas               |
| Dias Recomendados       | Terça a Quinta-feira  |

> **Nota**: Testes fora destes horários requerem aprovação prévia com 48h de antecedência.

### Limites Técnicos

#### Transcrição em Tempo Real (WebSocket)

| Parâmetro            | Limite             |
| -------------------- | ------------------ |
| Conexões Simultâneas | 20.000             |
| Payload por Mensagem | 256KB              |
| Taxa de Mensagens    | 20/segundo/conexão |
| Banda Total          | 100Mbps            |

#### Geração de Documentos (API REST)

| Parâmetro               | Limite                    |
| ----------------------- | ------------------------- |
| Requisições Simultâneas | 500                       |
| Taxa de Requisições     | 1.000/minuto              |
| Tamanho do Payload      | 5MB                       |
| Tempo de Processamento  | 60 segundos               |
| Limite Diário           | 10.000 documentos/cliente |

### Procedimento de Teste

#### Rampa de Carga

1. Iniciar com 10% da carga pretendida
2. Incrementos graduais de 20%
3. Intervalo de 5 minutos entre incrementos
4. Monitoramento contínuo

#### Critérios de Parada

| Métrica             | Limite    |
| ------------------- | --------- |
| Taxa de Erro        | > 5%      |
| Latência WebSocket  | > 2000ms  |
| Latência Documentos | > 20000ms |
| Perda de Conexão    | > 10%     |

### Requisitos de Comunicação

#### Antes do Teste

* Volume pretendido
* Duração estimada
* Contatos da equipe responsável
* Cronograma detalhado

#### Durante o Teste

* Disponibilidade imediata via canal acordado
* Monitoramento ativo
* Reporte de anomalias

### Métricas Necessárias

* [x] Conexões simultâneas
* [x] Taxa de mensagens/segundo
* [x] Latência (média, mínima, máxima)
* [x] Taxa de erro
* [x] Tempo de estabelecimento de conexão
* [x] Duração das sessões

### Considerações Técnicas

#### Rate Limiting

* Limites por IP
* Limites por cliente/API key
* Limites globais do sistema
* Priorização por plano

#### Comportamento do Sistema

* Reconexão automática em falhas
* Processamento assíncrono de documentos
* Cancelamento automático após timeout
* Código 429 para limites excedidos

### Relatório Pós-Teste

O relatório deve incluir:

* Volumes atingidos
* Problemas encontrados
* Métricas coletadas
* Sugestões de melhorias

### Contato

Para solicitar endpoints de teste, scripts e suporte:

* Email: <team@voahealth.com>
* Tempo de resposta: 1 dia útil
* Documentação adicional será fornecida após o contato inicial
