Manual do usuário — Ink Agenda v2.0.0

Visão geral

O Ink Agenda é um aplicativo desktop para Windows que ajuda tatuadores e estúdios a organizar agendamentos, controlar entradas e saídas e acompanhar o desempenho do negócio. Os dados ficam no seu computador (SQLite local); a interface é nativa (Java 21 + JavaFX 21), sem depender de navegador. v2.0.0 é o primeiro produto Cara Core já maduro; lançamento oficial em 26 de junho de 2026.

Principais recursos

Login por celular — Acesso com o número do tatuador (telas de login e recuperação).
Agenda e lista do dia — Calendário centralizado no topo; ao clicar no dia, abre a lista de agendamentos daquele dia (ordem do mais cedo ao mais tarde). Cadastro com nome, valor, data e hora; celular do cliente opcional. Não permite sobrepor horários ao salvar.
Check “Pagou” na tela Hoje — Marque rapidamente quem já pagou na visão do dia.
Controle financeiro — Registro de receitas (entradas) e despesas (saídas), com saldo por período.
Painel de resultados — Faturamento, médias e indicadores para acompanhar o desempenho.
Backup e restauração — Exportar e importar dados em arquivo protegido por senha (CSV compactado), para soberania dos dados.

Requisitos e detalhes técnicos estão em Download e Tecnologia. Versão anterior (Android): Ink Agenda na Google Play — app em produção até o lançamento da v2.0.0 desktop.

Requisitos e instalação

Requisitos: Windows 10 ou superior. Duas formas de uso:

Instalador .exe (recomendado) — Baixe o instalador na página de Download (Releases → Latest). Não é necessário ter Java instalado; o .exe é autocontido. Após instalar, abra o atalho do Ink Agenda.
JAR (avançado) — Exige JDK 21 (Java 21) no PATH. Baixe o JAR em Releases e execute com java -jar nome-do-arquivo.jar (ou duplo clique, se JARs estiverem associados ao Java).

Os dados ficam em %AppData%\Local\CaraCore\AgendaInk (banco SQLite e backups automáticos). Para desenvolvimento na oficina: cd agenda-java && mvn javafx:run.

Login e primeiro uso

O acesso ao Ink Agenda é feito pelo celular do tatuador: na tela de login, informe o número de telefone (e senha, se já tiver cadastro). No primeiro uso, o aplicativo pode solicitar o cadastro do usuário. A interface exibe o nome do app como Ink Agenda na splash e nos títulos.

Agenda e lista do dia

A agenda mostra um calendário centralizado no topo da tela. Ao clicar em um dia, abre a lista do dia: apenas os agendamentos daquele dia, em ordem do mais cedo ao mais tarde. Use para planejar o dia e manter o histórico de atendimentos.

Cadastro de agendamento

Campos: nome do cliente, valor, data e hora. Celular do cliente é opcional.
Salvar: o aplicativo não permite sobreposição de horários — se o horário já estiver ocupado, será exibido aviso e você precisará escolher outro horário.
Editar: abra o agendamento e altere cliente, data, horário ou valor conforme necessário.

Tela Hoje

Na visão do dia atual, você pode marcar Pagou para cada cliente que já realizou o pagamento, facilitando o controle do caixa do dia.

Controle financeiro

O módulo financeiro registra entradas (receitas) e saídas (despesas), calculando o saldo. Ideal para controlar o que entra (sessões, retoques, vendas) e o que sai (materiais, aluguel, contas).

Tipos de lançamento

Entrada (receita) — Valores que entram: sessão de tatuagem, retoque, venda de produtos, etc.
Saída (despesa) — Valores que saem: materiais, aluguel, energia, manutenção, etc.

Uso básico

Registre cada receita ou despesa com descrição, valor e data.
O aplicativo calcula o saldo (receitas menos despesas) no período.
Consulte a lista de lançamentos para revisar ou editar.

Painel de resultados

O painel reúne indicadores do negócio: faturamento no período, totais de entradas e saídas, saldo e médias (por exemplo, ticket médio). Use para acompanhar o desempenho mensal e tomar decisões. A apresentação completa e a consultoria estão na matriz (caracore.com.br).

Backup e restauração

O Ink Agenda permite exportar e importar seus dados em um arquivo único (CSV compactado com GZIP), protegido por senha. Assim você mantém a soberania dos dados e pode trocar de computador ou fazer cópias de segurança.

As opções de backup e restauração ficam na área de Perfil. O aplicativo também faz backups automáticos locais (pasta de dados do app). Para mais detalhes sobre o formato e o dossiê de lançamento, consulte a matriz e o RELEASE_NOTES na oficina.

Problemas comuns

Instalador .exe não inicia — Execute como administrador se necessário; verifique se o Windows Defender ou outro antivírus não está bloqueando. Requer Windows 10 ou superior.
O JAR não abre — Verifique se o JDK 21 está instalado e no PATH. No terminal: java -version deve mostrar versão 21. Reinstale o JDK 21 (OpenJDK ou Oracle) se necessário.
Erro ao iniciar a janela — Confirme que está usando Java 21 e que o JavaFX está disponível (o JAR de release já inclui o necessário). Em caso de erro de memória, tente: java -Xmx512m -jar nome-do-arquivo.jar.
Horário já ocupado ao salvar — O aplicativo impede sobrepor horários. Escolha outro horário ou edite o agendamento existente.
Versão anterior (Android) — O app na Google Play continua em produção até o lançamento da v2.0.0 desktop (26/Jun/2026).
Dúvidas ou sugestões — Use o Canal de feedback (e-mail, WhatsApp ou Telegram) para reportar problemas ou pedir ajuda.