Mascote & Companheiros IA (Pet System)
Especificação do sistema de mascotes interativos em 2D, animações por spritesheet, física de tela e reações em tempo real aos eventos da plataforma.
1. Visão Geral do Mascote Operacional
O DevCod Agency conta com um assistente visual animado que acompanha a navegação do usuário no painel administrativo. O mascote padrão do sistema é o DevCod Pet, projetado como um companheiro cibernético reativo às execuções de agentes e automações.
2. Especificação do Atlas V2 (Spritesheet)
O motor gráfico renderiza o mascote usando matrizes de animação em formato WebP otimizado (Atlas V2):
{`
// Configuração de Resolução do Atlas V2:
export const MASCOT_ATLAS_V2 = {
columns: 8, // 8 colunas de quadros por linha
rows: 11, // 11 linhas de estados de animação
cellWidth: 192, // Largura da célula individual (px)
cellHeight: 208, // Altura da célula individual (px)
width: 1536, // Largura total da imagem (px)
height: 2288, // Altura total da imagem (px)
} as const;
`}
3. Estados de Animação e Reações a Eventos
O mascote reage dinamicamente aos eventos de sistema transmitidos pelo canal de Server-Sent Events (`/api/sse`):
| Estado de Animação | Gatilho de Disparo (SSE / Interface) | Comportamento do Mascote |
|---|---|---|
idle |
Nenhum evento ativo / Estado padrão | Animação suave de respiração e observação da tela. |
running-right / running-left |
Arrastamento do usuário ou mudança de posição | Movimentação com inversão dinâmica de sprite (mirroring). |
waving |
Login / Entrada em nova página do painel | Aceno de boas-vindas com visualização em halo roxo. |
jumping |
Notificação de venda efetuada ou meta concluída | Salto comemorativo e exibição de partição de partículas. |
failed |
Erro em nó de execução ou limite de cota excedido | Expressão de alerta e indicador visual em vermelho. |
waiting / running |
Agente Swarm executando missão em segundo plano | Animação de escuta atenta e processamento ativo. |
4. Física de Tela e Posicionamento Proporcional
Para garantir que o mascote não cubra botões da interface ou saia da área de visualização:
- Clamp de Segurança (`clampMascotCoordinates`): Mantém o pet dentro da área útil da janela (minX, maxX, minY, maxY).
- Normalização Proporcional (`normalizeMascotCoordinates`): As coordenadas do pet são salvas em percentual de tela
(0.0 a 1.0). Ao alterar o tamanho da janela do navegador ou trocar de dispositivo, o pet se reposiciona de forma fluida na mesma proporção da tela.