cybercore-signer/assets/README.md

Pasta de Ícones (SVG) e Imagens (PNG) — CyberCore Signer

Esta pasta é o repositório oficial onde você pode visualizar, customizar e substituir livremente os ícones em SVG e as imagens em PNG 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
│
└── images/                    # Imagens de alta fidelidade em PNG com canal alfa (transparência)
    ├── app-icon.png           # Ícone oficial do app (256x256 px - Diamante 3D azul Serpro)
    ├── app-logo.png           # Logotipo horizontal oficial (480x120 px - CyberCore SIGNER)
    ├── brand-banner.png       # Banner de cabeçalho e marca (600x160 px - Serpro Blue)
    └── default-seal.png       # Selo de assinatura padrão ICP-Brasil (640x164 px)

---

🎨 Como Customizar Qualquer Ícone ou Imagem

1. Ícones:

   • Estão no formato .svg padrão.
   • Podem ser editados diretamente no seu editor de código (VS Code, etc.) ou em editores vetoriais como Inkscape, Figma ou Illustrator.
   • Se preferir colocar uma imagem bitmap para um ícone específico, você também pode colocar um .png (ex: pdf.png). O sistema prioriza .svg e aceita .png com fallback transparente.

2. Imagens do Sistema:

   • Estão no formato .png com canal alfa de 32 bits (fundo transparente).
   • Você pode substituir app-logo.png, app-icon.png, brand-banner.png ou default-seal.png pelo logotipo e identidade visual da sua instituição ou empresa.

3. Ordem de Prioridade e Hot-Reloading: Quando a aplicação busca um ícone ou imagem, a resolução ocorre na ordem:

   1. Pasta Física Local (./assets/icons/ e ./assets/images/): Qualquer alteração feita aqui entra em vigor imediatamente ao abrir a janela ou reiniciar a aplicação, sem necessidade de recompilar!
   2. Pasta do Usuário (~/.cybercore/assets/): Configurações específicas por usuário do sistema operacional.
   3. Resources Empacotados no JAR (/assets/): Cópia empacotada internamente no .jar.
   4. Fallback Vetorial Nativo (SvgIcons): Garantia de que a interface nunca fique em branco caso algum arquivo seja excluído.

---

🚀 Como Testar Suas Modificações

Para compilar e gerar o pacote .jar completo com todos os novos assets embutidos:

./build-jar.sh

Para rodar a aplicação:

java -jar ./cybercore-signer.jar