Manual do usuário — Ink Agenda v2.0.0

Visão geral

O Ink Agenda é um aplicativo desktop 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.0.11), sem depender de navegador. v2.0.0 é o primeiro produto Cara Core já maduro; lançamento oficial em 26 de junho de 2026. O canal público atual da loja permanece na RC8.

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.
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. Para a vitrine pública atual:

ZIP Windows (recomendado na RC8) — Baixe o asset Windows na página de Download. Não é necessário ter Java instalado; o runtime já vai embutido.
Guias por plataforma — A mesma página documenta os artefatos publicados para Windows (ZIP), macOS (DMG) e Linux (DEB).

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 a senha. No primeiro uso, o aplicativo solicita o cadastro do usuário.

O app funciona 100% offline — nenhuma funcionalidade depende de internet. A autenticação padrão é sempre por celular + senha local, armazenada no seu computador.

Login com Google (opcional): se o seu estúdio configurar as credenciais OIDC (Google Cloud), o app oferece a opção de autenticar via Google no primeiro acesso. Esse recurso é opcional e fica desativado por padrão — sem nenhuma conta Google necessária para usar o Ink Agenda normalmente.

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.

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

ZIP/DMG/DEB não inicia — Confirme que o artefato veio da release pública RC8 e valide o checksum antes de executar.
Erro ao iniciar a janela — Confirme que você extraiu corretamente o ZIP Windows RC8 e que o sistema operacional atende aos requisitos mínimos.
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.