# Confirmação da ordenação de endereços da equipe

Na tentativa registrada em 06/10/2026 às 16:24, a atualização da equipe 2
levou aproximadamente 14 segundos e retornou HTTP 422 com 125 erros. A leitura
anterior continha 80 grupos e 18.538 associações de endereços. Os erros eram um
grupo vazio rejeitado pela regra `required` e 62 endereços já associados aos
grupos 101 e 134, reportados como duplicados em ambos. O grupo 139 alterado
pelo usuário continha dois endereços e não era a origem desses erros.

A validação agora aceita arrays vazios presentes no payload e verifica o tipo
e a unicidade dos IDs dentro de cada grupo em uma passagem linear. Existência
e categoria são verificadas em uma consulta em lote no serviço. A lista
completa de grupos continua obrigatória e deve pertencer à equipe autorizada.

Associações repetidas entre grupos são permitidas apenas quando todos os
vínculos repetidos enviados já existem no banco. Novas duplicidades continuam
sendo rejeitadas. Nenhuma associação antiga é removida automaticamente para
permitir a confirmação de outro grupo.

Dentro da transação, os grupos e registros atuais são bloqueados para leitura
consistente. As linhas de ordenação são lidas sem hidratar milhares de modelos
Eloquent. Apenas grupos com alterações de posição são atualizados e apenas
coleções cuja sequência de endereços ou numeração mudou são substituídas.
Grupos não alterados mantêm IDs e timestamps dos seus registros.

## Validação

`tests/Feature/Team/UpdateTeamAddressOrderTest.php` cobre os contratos anteriores,
grupos vazios, vínculos antigos repetidos, rejeição de novas duplicidades,
endereços inválidos/inexistentes e a preservação dos grupos não alterados.
O teste de volume utiliza 18.002 endereços e exige uma única consulta de
validação à tabela de endereços. A execução local levou aproximadamente 280 ms
para a confirmação, incluindo as verificações finais do teste. Esse tempo foi
medido em PostgreSQL temporário isolado, não na base do usuário.

Os 15 testes passaram com o limite de memória padrão de 128 MB. Pint e a
verificação de sintaxe dos módulos alterados passaram. A expectativa do teste
de autorização foi corrigida para HTTP 403, que já era a resposta produzida
pelo `authorize()` do FormRequest; o comportamento de autorização não mudou.

A requisição original foi rejeitada antes de entrar no serviço de atualização,
portanto aquela tentativa não persistiu a nova ordenação. Após a correção,
o usuário deve confirmar novamente o draft desejado.
