Files
cybercore-signer/assets/README.md
T

86 lines
5.5 KiB
Markdown

# 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')
│ ├── 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
```