Tecnologia · v2.2.1

Java 25 · JavaFX 21.0.11 · SQLite local · três perfis (Tatuagem, Odontologia e Beleza) · runtime embutido nos pacotes Windows e Linux · executáveis sem assinatura digital.

Tecnologia — CaraCore Ink Agenda

Stack e arquitetura do aplicativo desktop para estúdios de tatuagem, consultórios e espaços de beleza.

Java 25 e JavaFX 21.0.11

O Ink Agenda é desenvolvido em Java 25 (LTS) com interface em JavaFX 21.0.11. Moeda, datas e meses usam o locale fixo pt-BR (R$ 350,00 · 07/10/2026 · outubro de 2026) na tela, no gráfico e no PDF.

Banco local

Persistência em SQLite (%LOCALAPPDATA%\CaraCore\AgendaInk\agenda.db) com WAL, verificação de integridade na abertura e migrações versionadas com Flyway. O app não abre porta e não faz conexão em segundo plano: funciona offline. A única conexão é a verificação manual de atualizações, explicada abaixo.

LGPD e domínio local

Agenda, clientes, orçamentos e financeiro ficam em SQLite no computador do estúdio, sem conta na nuvem. O aplicativo não envia dados de clientes para servidores; a verificação manual de atualizações transmite apenas a versão instalada e o sistema operacional.

O backup manual .inkbak é criptografado com AES-256-GCM e senha; o backup automático é local, compactado e sem senha. O registro técnico mascara senhas, telefones e e-mails. Esses recursos apoiam o seu dever de proteger dados pessoais. A conformidade com a LGPD depende também dos seus processos, do controle de acesso ao computador e do uso do sistema; o Ink não substitui essa responsabilidade.

Baixar e manter os dados no meu computador

Arquitetura em camadas

Senhas e acesso

Acesso por celular + senha local, sem conta na nuvem. A senha não fica no SQLite: fica em um arquivo com hash PBKDF2-HMAC-SHA256 e sal aleatório. A frase de recuperação e os códigos de emergência também são guardados só como hash. “Esqueci minha senha” gera um código de 6 dígitos válido por 15 minutos.

“Lembrar senha” guarda a credencial protegida pelo Windows (DPAPI), sem texto legível no disco, e vale por 12 horas ou até você clicar em Sair. No Linux, a credencial é cifrada com AES-GCM e um segredo aleatório criado nesta instalação. O app não traz usuário de fábrica: na primeira abertura vai direto ao primeiro acesso.

Atualizações

A verificação é manual, em Configurações → Verificar atualizações: ao abrir o app, nenhuma conexão é feita. Quando você pede a verificação, o app envia apenas a versão instalada e o sistema operacional; nenhum dado de cliente. A resposta do canal oficial é conferida com uma assinatura digital Ed25519 embutida no aplicativo; links de download só são aceitos de github.com/chmulato e de *.caracore.com.br, sempre por HTTPS, e o SHA-256 é conferido antes de abrir o instalador. Se a assinatura ou o hash não baterem, o app não oferece o download.

Backup

Log

Registro técnico em %LOCALAPPDATA%\CaraCore\AgendaInk\logs\ (agenda-0.log a agenda-4.log, até 1 MB cada, com rotação). Senhas, telefones e e-mails são mascarados antes de gravar.

Build e testes

Maven para build e dependências. JUnit 5 e TestFX para testes; JaCoCo exige no mínimo 80% de cobertura de linhas nos serviços e no domínio, com metas próprias para persistência e log. O pacote de produção passa por um teste que barra dados de demonstração, credenciais e scripts de desenvolvimento.

Distribuição

ZIP portátil e instalador .exe para Windows gerados com jpackage. O runtime Java 25 vem embutido (jlink, com os dados de locale e sem ferramentas de desenvolvimento como depurador, jshell e compilador): não é preciso instalar JDK. O jar da aplicação é ofuscado com ProGuard antes do empacotamento.

Ecossistema Cara Core Informática — Produtos desktop e web com foco em simplicidade, manutenção e entrega clara. Ink Agenda integra o portfólio Cara Core.

Status e próximos passos