feat: initial commit - cybercore signer desktop agent

2026-10-11 08:20:24 -03:00
commit ccfa358f97
206 changed files with 23952 additions and 0 deletions
@@ -0,0 +1,43 @@
+# Instalação e Empacotamento Nativo
+
+O **CyberCore Signer** foi projetado para distribuição sem exigir que o usuário final tenha o Java ou JRE instalado em seu computador.
+
+---
+
+## 1. Requisitos de Sistema
+
+- **Sistema Operacional Homologado:** Windows 10 (64-bit) ou Windows 11 (64-bit).
+- **Compatibilidade Adicional:** Linux x86_64 e macOS (arquitetura preparada).
+- **Hardware:** Mínimo de 4 GB RAM, 150 MB de espaço em disco.
+- **Porta de Rede Local:** A porta TCP `21325` deve estar livre em `127.0.0.1`.
+
+---
+
+## 2. Geração do Instalador Windows (MSI / EXE) com `jpackage`
+
+O empacotamento utiliza a ferramenta nativa `jpackage` incluída no JDK 21/25.
+
+### No Windows:
+Execute o script em lote localizado na raiz:
+```cmd
+scripts\package-windows.bat
+```
+
+### O que o script realiza:
+1. Compila o projeto em modo release:
+   ```cmd
+   mvnw clean package -DskipTests
+   ```
+2. Invoca o `jpackage` criando o instalador Windows:
+   - Extrai um runtime mínimo customizado contendo apenas os módulos necessários (`java.base`, `java.desktop`, `java.smartcardio`, `jdk.crypto.cryptoki`, etc.).
+   - Cria atalhos na Área de Trabalho e no Menu Iniciar.
+   - Gera um instalador padrão MSI ou EXE em `dist/`.
+
+---
+
+## 3. Instalação e Inicialização com o Sistema
+
+1. Execute o instalador `CyberCore-Signer-0.1.0.msi`.
+2. Siga as instruções do assistente de instalação.
+3. Ao concluir, o ícone do **CyberCore Signer** aparecerá na Área de Notificação (System Tray) ao lado do relógio do Windows.
+4. O serviço local `http://127.0.0.1:21325` estará imediatamente disponível para atender as aplicações web autorizadas.