Ink Agenda
v2.0.0-RC8 — Gestão para estúdios de tatuagem; canal público vigente com distribuição ativa para Windows, macOS e Linux (Java 21 + JavaFX)
Repositório Privado
Este projeto possui código-fonte privado e é protegido por licença proprietária da Cara Core Informática. Vitrine e releases no canal institucional: download.html.
Visão Geral
O que é o Ink Agenda?
O Ink Agenda é um aplicativo de computador (Windows, macOS e Linux) para tatuadores e estúdios: agenda de sessões, cadastro de clientes, controle de receitas e despesas, saldo por perÃodo e indicadores. Tudo fica no seu PC, sem depender de internet para funcionar.
Em resumo:
- 📅 Agenda: Calendário visual e lista do dia (ordem por horário)
- 👤 Clientes: Nome, valor, data/hora; celular opcional; check Pagou na tela Hoje
- 💰 Financeiro: Entradas, saÃdas, saldo e histórico
- 💾 Backup: Export/import CSV GZIP com senha; soberania dos dados
- ðŸ–¥ï¸ Desktop multiplataforma: Windows, macOS e Linux; Java 21 + JavaFX; dados em SQLite local
Arquitetura Técnica
Aplicação desktop nativa em Java 21 e JavaFX 21.0.11, com banco SQLite local. Módulos: agenda (calendário, lista do dia), clientes, financeiro (receitas/despesas), backup CSV GZIP. Oficina: caracore-ink; loja e releases: caracore-ink-releases.
Stack:
- Runtime: Java 21, JavaFX 21.0.11
- Banco: SQLite (único no escopo)
- Plataforma: Desktop (Windows, macOS, Linux)
- Build: Maven; testes unitários (JUnit 5, cobertura ≥80% em core/domain)
Funcionalidades Principais
Agenda e lista do dia
Para leigos: Veja o mês no calendário; ao clicar no dia, abre a lista de agendamentos daquele dia, do mais cedo ao mais tarde. Não permite sobrepor horários ao salvar.
Técnico: DayAgendaTab com lista ordenada por appointmentTime; validação de horário ocupado (CODE_CLIENTE_003).
Cadastro de clientes
Para leigos: Cadastre nome, valor, data e hora; celular opcional. Na tela Hoje, marque quem já pagou.
Técnico: ClientFormTab; login por celular (tatuador); entidade Cliente com validações.
Financeiro
Para leigos: Registre entradas e despesas; acompanhe saldo e histórico por perÃodo.
Técnico: Receitas/despesas, saldo, indicadores mensais; persistência em SQLite.
Backup e recuperação
Para leigos: Exporte e importe seus dados em arquivo protegido por senha (CSV compactado).
Técnico: CSV GZIP com senha; formato único; CsvBackupService, validateCsvSanity.
Capturas de Tela
Visualização das principais telas do Ink Agenda na linha pública atual da loja:
Tela de Login
Acesso com celular e senha (desktop atual)
Recuperação de Senha
Fluxo de redefinição de senha por celular
Dashboard
Painel inicial com visão consolidada de agenda e operação
Financeiro (Parte 1)
Visão inicial do módulo financeiro com entradas e saÃdas
Financeiro (Parte 2)
Detalhamento operacional do fluxo financeiro do estúdio
Financeiro (Parte 3)
Indicadores e acompanhamento visual do resultado financeiro
Configurações (Atualizada)
Versão mais recente do painel de configuração
Gestão de Usuário
Tela de usuário com dados de perfil e manutenção de acesso
Orçamentos
Gestão de orçamentos para planejamento de atendimentos
Relatório em PDF
Pré-visualização e exportação de relatório para PDF
Relatório para Impressão
Modo de impressão para relatórios operacionais do estúdio
Stack e Entrega
Tecnologias
- Java 21: Linguagem e runtime
- JavaFX 21.0.11: Interface gráfica desktop
- SQLite: Banco de dados local
- Maven: Build e dependências
- JUnit 5 / Mockito: Testes unitários; JaCoCo (cobertura)
Oficina e Loja
Oficina: caracore-ink (repositório do app). Loja: caracore-ink-releases (vitrine, releases e download em ink.caracore.com.br).
Implantação local (guia rápido)
Pré-requisitos mÃnimos
- Windows 10/11 atualizado
- Perfil de usuário com permissão de instalação local
- Espaço livre para app, banco SQLite e backups
- Internet apenas para baixar instalador (operação pode ser local)
Validação pós-instalação
- Abrir o Ink Agenda e confirmar carregamento da tela inicial
- Criar 1 cliente de teste e 1 agendamento
- Registrar 1 receita e 1 despesa
- Executar 1 exportação de backup com senha
Operação diária do estúdio
- Conferir agenda do dia e evitar conflitos de horário antes de abrir atendimento
- Atualizar status de pagamento na lista do dia ao finalizar sessão
- Lançar despesas operacionais no mesmo dia para manter saldo real
- Fechar turno conferindo saldo e número de atendimentos executados
Backup e restauração (governança local)
PolÃtica sugerida
- Backup diário no encerramento do expediente
- Senha forte no arquivo de exportação
- Cópia adicional em mÃdia externa/segura
- Retenção mÃnima: últimos 7 dias úteis
Teste de restauração
- Executar teste de importação semanal em ambiente controlado
- Confirmar integridade de clientes, agenda e financeiro após importação
- Registrar data/hora do teste para rastreabilidade operacional
Canal de release e versionamento
Distribuição oficial centralizada em caracore-ink-releases. A loja local referencia um único canal para download e histórico de versões, evitando duplicidade de artefatos.
Diagnóstico rápido local (N1)
- Aplicativo não inicia: reiniciar Windows e executar novamente como usuário local
- Lentidão: validar tamanho da base local e executar backup + manutenção preventiva
- Erro em dados: restaurar último backup validado e repetir operação
- Persistindo falha: acionar canal de feedback com horário do incidente e evidências