Atualização floresta

This commit is contained in:
Luiz Silva 2026-05-31 11:27:51 -03:00
parent 0886fd5c3e
commit 2d4d8f8929
103 changed files with 19266 additions and 14160 deletions

View file

@ -0,0 +1,60 @@
# Regra: Limite de Linhas em Arquivos Vue
## 🎯 Regra
**Nenhum arquivo `*.vue` deve ultrapassar 250 linhas.**
---
## Motivação
Arquivos Vue longos acumulam múltiplas responsabilidades:
- template, lógica e estilo no mesmo arquivo
- componentes internos não reutilizáveis
- dificuldade de teste e manutenção
O limite de 250 linhas é uma fronteira de manutenibilidade, não apenas de estética.
---
## Aplicação automática
O script `scripts/check-vue-linhas.sh` valida este limite em todo `pnpm run build`.
Arquivos legados em processo de refatoração estão listados como **isentos temporários** dentro do script.
---
## Obrigações do agente
### Antes de criar um novo arquivo Vue
- Estimar o tamanho do componente
- Se a estimativa ultrapassar 250 linhas, **quebrar em subcomponentes imediatamente**
### Ao editar um arquivo Vue existente
- Verificar o total de linhas atual antes de adicionar código
- Se a edição levar o arquivo acima de 250 linhas, propor extração de subcomponente
### Ao identificar um arquivo isento
- Sinalizar ao operador que o arquivo é legado e deve ser refatorado
- Não adicionar mais linhas a arquivos isentos sem refatorar algo equivalente
---
## Estratégias de extração obrigatórias
Quando um arquivo se aproximar do limite:
| Situação | Ação |
|---|---|
| Template longo | Extrair seções como `<NomeSecao />` próprio componente |
| CSS extenso | Mover para arquivo `.css` co-localizado e importar |
| Setup() > 100 linhas | Extrair lógica para composable `use*.ts` co-localizado |
| Modal/Dialog embutido | Sempre em componente separado (`*Modal.vue`) |
---
> Não existem isentos. Todos os arquivos Vue da biblioteca respeitam o limite de 250 linhas.