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%\) 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.
Arquitetura em camadas
- Telas (JavaFX): Hoje, Calendário, Finanças, Dashboard, Orçamentos, Clientes, Usuário e Config.
- Controladores e serviços: regras de agenda (sem sobreposição de sessões, duração e valor), cadastro de clientes e orçamentos, indicadores do painel, importação idempotente e relatórios.
- Domínio: clientes, agendamentos, orçamentos, cobranças, recebimentos e lançamentos financeiros. Operações que podem falhar devolvem um tipo
Result. - Infraestrutura: repositórios SQLite, backup, PDF (OpenPDF com fonte Unicode embutida) e log.
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
- .inkbak: cópia completa do banco, compactada e criptografada com AES-256-GCM, com chave derivada da senha do backup (PBKDF2). Backups
.inkbakda v2.0.0 continuam restaurando. - Automático: a cada hora e ao fechar,
agenda_*.db.gzembackups\, mantendo os 30 mais recentes. Pode ser desligado em Config. - CSV: agendamentos e lançamentos financeiros, compactado e criptografado com senha. Importar duas vezes não duplica nada.
Log
Registro técnico em %LOCALAPPDATA%\ (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
- v2.2.1 — versão atual do Desktop Windows e Linux (instalador/ZIP e
.deb), com três perfis, sem assinatura digital - Próxima atualização: Desktop 2.3.0 em 29/01/2027 — profissional em cada agendamento e presença separando atendido, falta e cancelado
- Atualização: verificação manual em Configurações, resposta assinada e SHA-256 conferido antes de abrir o instalador
- Lançamento oficial da linha 2.0 (Windows) 26 de junho de 2026
- Histórico completo em Versões
- Roadmap: Ink Agenda 3.0 em PWA (não antes de 2028) — web, Android, iPhone, Windows, Mac e Linux pelo browser, com as regras da v2. Sem instalador nativo para macOS e sem lojas de apps. Servidor na nuvem com HTTPS e uma base SQLite por estúdio. Substitui o Desktop depois de existir a importação dos dados da v2