# Recursos Visuais (Ícones e Imagens em SVG) — CyberCore Signer

Esta pasta é o repositório oficial onde você pode visualizar, customizar e substituir livremente todos os **ícones em SVG** e as **imagens em SVG** do **CyberCore Signer**.

---

## 📁 Estrutura de Arquivos Criados

```
assets/
├── icons/                     # Ícones vetoriais SVG reais e editáveis (W3C padrão)
│   ├── pdf.svg                # Ícone Assinar PDF (documento com tag vermelha PDF)
│   ├── xml.svg                # Ícone Assinar XML (documento com tag azul <XML>)
│   ├── file.svg               # Ícone Assinar Arquivo (documento com caneta)
│   ├── batch.svg              # Ícone Assinatura em Lote (pilha de documentos com check)
│   ├── attached.svg           # Ícone Assinatura Atachada (documento com clipe de papel)
│   ├── co-sign.svg            # Ícone Co-Assinar (documentos duplos com usuários)
│   ├── timestamp.svg          # Ícone Carimbo do Tempo (documento com relógio TSA)
│   ├── ltv.svg                # Ícone Assinatura LTV (documento com selo perpétuo)
│   ├── validate.svg           # Ícone Validar Assinatura (documento com checkmark verde)
│   ├── validate-timestamp.svg # Ícone Validar Carimbo (relógio com checkmark verde)
│   ├── exit.svg               # Ícone Sair do Agente (porta com seta vermelha de saída)
│   ├── logs.svg               # Ícone Terminal de Logs (janela com prompt </>)
│   ├── settings.svg           # Ícone Configurações (engrenagem de precisão de 8 dentes)
│   ├── tutorial.svg           # Ícone Tutorial e Ajuda (monitor com vídeo/play)
│   ├── cert.svg               # Ícone Certificados Digitais (pasta com cadeado seguro)
│   ├── about.svg              # Ícone Sobre o Sistema (círculo azul com 'i')
│   ├── sun.svg                # Ícone Tema Claro (sol dourado com raios vetoriais)
│   ├── moon.svg               # Ícone Tema Escuro (lua crescente azul/índigo)
│   ├── shield.svg             # Ícone Brasão de Segurança (CyberShield com chave interna)
│   ├── seal.svg               # Ícone Designer e Gerenciador de Selos Notariais
│   ├── check.svg              # Ícone Checkmark de sucesso e validação
│   ├── error.svg              # Ícone de Erro / Alerta em vermelho
│   ├── star.svg               # Ícone de Estrela notarial / favorita
│   ├── close.svg              # Ícone Fechar / Cancelar (cruz geométrica moderna)
│   ├── arrow-right.svg        # Ícone Avançar / Seta direcional
│   ├── zoom-in.svg            # Ícone Zoom In (+)
│   ├── zoom-out.svg           # Ícone Zoom Out (-)
│   ├── zoom-fit.svg           # Ícone Ajustar à Tela
│   └── refresh.svg            # Ícone Atualizar / Recarregar listas e status
│
└── images/                    # Imagens vetoriais SVG editáveis (com cópias PNG de fallback)
    ├── app-icon.svg           # Ícone oficial do app em SVG (Cristal/Diamante 3D azul)
    ├── app-icon.png           # Fallback em PNG (256x256 px)
    ├── app-logo.svg           # Logotipo horizontal oficial em SVG (CyberCore SIGNER)
    ├── app-logo.png           # Fallback em PNG (480x120 px)
    ├── brand-banner.svg       # Banner de cabeçalho e marca em SVG (600x160 px)
    ├── brand-banner.png       # Fallback em PNG (600x160 px)
    ├── default-seal.svg       # Selo de assinatura padrão ICP-Brasil em SVG (640x164 px)
    └── default-seal.png       # Fallback em PNG (640x164 px)
```

---

## 🎨 Como Customizar Qualquer Ícone ou Imagem

1. **Ícones:** 
   - Todos estão no formato `.svg` padrão da W3C.
   - Consulte o guia completo de especificações em [docs/svg-design-guide.md](../docs/svg-design-guide.md) para tokens de cores, dimensões e boas práticas ao exportar do **Inkscape/Figma**.
   - Podem ser abertos e editados diretamente em editores de texto/código (VS Code) ou ferramentas vetoriais como **Inkscape, Figma, Adobe Illustrator**.
   - Se preferir usar um arquivo bitmap para algum ícone específico, basta salvar um `.png` correspondente na pasta (ex: `pdf.png`). O sistema detecta e renderiza automaticamente.

2. **Imagens do Sistema:**
   - Tanto o logotipo horizontal (`app-logo.svg`), o ícone do sistema (`app-icon.svg`), o banner institucional (`brand-banner.svg`) e o selo notarial padrão (`default-seal.svg`) agora são arquivos **SVG vetoriais editáveis**.
   - Você pode alterar cores, tipografias, brasões e dimensões diretamente nos arquivos SVG.
   - O `AssetManager` renderiza os arquivos SVG preservando fidelidade geométrica e suportando gradientes e alinhamentos.

3. **Ordem de Resolução e Carregamento:**
   Ao requisitar qualquer elemento gráfico, a aplicação segue a ordem de prioridade:
   1. **Pasta Física Local (`./assets/icons/` e `./assets/images/`)**: Arquivos `.svg` editados aqui têm prioridade máxima e entram em vigor imediatamente sem necessidade de recompilar.
   2. **Pasta do Usuário (`~/.cybercore/assets/`)**: Para customizações no diretório pessoal do usuário.
   3. **Recursos Empacotados no JAR (`/assets/`)**: SVGs e imagens internas empacotadas no pacote de distribuição.
   4. **Fallback Vetorial Nativo (`SvgIcons`)**: Garantia de que a interface nunca fique desprovida de grafismos caso algum arquivo seja removido.

---

## 🚀 Como Testar Suas Modificações

Para compilar e gerar o pacote `.jar` completo com todos os novos assets embutidos:
```bash
./build-jar.sh
```

Para rodar a aplicação:
```bash
java -jar ./cybercore-signer.jar
```