hit-server-manager/AGENTS.md

# Guia para agentes

Orientações rápidas para agentes ou automações que atuam neste repositório.

## Contexto do projeto
- Servers Manager: catálogo interno de servidores e usuários.
- Backend: Spring Boot 4 (Java 21), JWT stateless com refresh em cookie HttpOnly.
- Frontend: React 19 + Vite (TS), Tailwind, axios com `withCredentials`.
- Desenvolvimento local: `./gradlew bootRun` em `backend/` e `yarn dev` em `frontend/` (copie `.env.example` antes).

## Padrões de código
- Em componentes React com Tailwind, mova classnames para uma constante `Styles` ao final do arquivo sempre que um elemento tiver mais de 5 classes (referência: `Login.tsx`).
- Em componentes React com Tailwind, mova classnames para uma constante `Styles` ao final do arquivo sempre que um elemento tiver mais de 5 classes (referência: `Login.tsx`).
- Quando houverem classnames que se repetem muitas vezes em vários elementos/componentes, mova esses grupos repetidos para a constante `Styles` mesmo que possuam menos de 5 classes — isso ajuda a evitar duplicação e facilita manutenção.
- Sempre que uma view ou componente começar a crescer demais, quebre a interface em subcomponentes menores e reutilizáveis (ex: dividir headers em partes especializadas) antes de seguir evoluindo o layout.

## Padrão para mensagens de commit
**Instrução:** Gere um comando `git commit -m` completo, em português, seguindo o padrão **Conventional Commits**, com base no `diff` abaixo.  
**Regras:**
1. Identifique automaticamente o tipo de commit (`feat`, `fix`, `refactor`, `docs`, `test`, `chore`, `style`, `perf`, etc.).
2. Estruture a mensagem em duas partes:  
   - **Título:** `tipo(escopo): descrição breve` (modo imperativo, até 72 caracteres)  
   - **Corpo:** lista em markdown com `-` destacando as principais alterações.
3. Retorne **apenas o comando completo** no formato:  
   ```
   git commit -m "tipo(escopo): descrição breve
   - detalhe 1
   - detalhe 2
   - detalhe 3"
   ```
4. O escopo deve ser inferido a partir do contexto dos arquivos alterados.
5. **Não escreva nada além do comando final.**
6. **Entrada:**  
   ```diff
   [cole aqui o diff]
   ```

**Exemplo adaptado ao projeto:**  
```
git commit -m "feat(servers): habilitar filtros de busca
- Adiciona filtros de status e localidade ao endpoint GET /api/servers
- Ajusta DTOs e mappers para incluir status normalizado e apelido
- Atualiza listagem React para aplicar filtros e exibir feedback com toast"
```