Manual · v2.2.1

Os executáveis não têm assinatura digital; o SmartScreen ou antivírus pode avisar ou bloquear a abertura.

Manual do usuário — Ink Agenda

Primeiro acesso, equipe e perfis, agenda do dia, calendário, clientes, orçamentos, financeiro, painel de resultados, mensagem ao cliente, backup, atualização e identidade visual.

Visão geral

O Ink Agenda é um aplicativo desktop para profissionais com hora marcada: estúdios de tatuagem, consultórios odontológicos e espaços de beleza. Agenda, clientes, orçamentos, entradas e saídas e o desempenho do negócio, com um executável e três perfis — Tatuagem, Odontologia e Beleza — que adaptam paleta e vocabulário (sessão/consulta/procedimento). Os dados ficam no seu computador (SQLite local). O app funciona offline e não faz conexão em segundo plano: a única conexão é a verificação manual de atualizações, que envia apenas a versão do app e o sistema operacional — nunca dados de clientes. Veja onde ficam os seus dados.

O menu inferior tem as abas Hoje, Calendário, Finanças, Dashboard, Orçamentos, Clientes, Usuário, Config e Sair. As abas visíveis dependem do perfil de acesso: veja Equipe e perfis.

A aba Config reúne, nesta ordem: Identidade e Visual do Posto, 1. Backup do estúdio (.inkbak), 2. Desastre e Recovery (CSV em GZIP), 3. Usuários e perfis (somente o responsável) e 4. Atualizações.

Valores em reais (R$ 350,00) e datas no formato brasileiro (07/10/2026) na tela, no gráfico e no PDF.

Requisitos e instalação

  • Windows 10 ou 11, 64 bits, com setup (.exe) ou ZIP portátil; ou Linux Ubuntu/Debian com o pacote .deb. Não precisa instalar Java: o runtime vem no pacote.
  • Downloads na página de Download. Passo a passo: Instalação Windows e Instalação Linux.
  • A janela cabe em telas de 1366×768 e pode ser redimensionada.

Dados em %LOCALAPPDATA%\CaraCore\AgendaInk\: banco agenda.db, backup automático em backups\ e registro técnico em logs\.

Primeiro acesso e login

O app não traz usuário de fábrica. Na primeira abertura ele vai direto ao Passo 1 de 3 — Identificação: escolha o perfil do espaço (Tatuagem, Odontologia ou Beleza) e informe o celular do responsável; depois vem o Passo 2 de 3 — Senha e recuperação local (perfil de acesso, senha de 8+ caracteres, frase de recuperação de 10+ caracteres e, recomendado, 8 códigos de emergência). Só então aparece o login com celular e senha. Detalhes em Primeiro acesso.

Esqueci minha senha gera um código de 6 dígitos válido por 15 minutos, só neste computador, depois da frase de recuperação.

Lembrar da minha senha guarda a credencial neste computador por até 12 horas (no Windows, protegida pelo DPAPI); ao sair, o lembrete é removido. Para apagar antes, use Usuário → Segurança → Remover senha lembrada.

Equipe e perfis

O responsável pela instalação é o administrador: vê todas as abas e gerencia a equipe. As demais pessoas entram com celular e senha próprios, cadastrados por ele em Config → 3. Usuários e perfis → Gerenciar usuários e perfis….

  • Administrador (responsável): vê Hoje, Calendário, Finanças, Dashboard, Orçamentos, Clientes, Usuário e Config; gerencia usuários e pode enviar mensagens. A credencial dele fica fora do banco e não é cadastrada como usuário da equipe.
  • Agenda: vê Hoje, Calendário, Clientes e Usuário. Não vê Finanças, Dashboard, Orçamentos nem Config, e os valores e o check Pagou não aparecem nos agendamentos. Pode enviar mensagens ao cliente.
  • Financeiro: vê Hoje, Calendário, Finanças, Dashboard, Orçamentos, Clientes e Usuário. Não gerencia usuários nem envia mensagens ao cliente.

Cadastrar e manter a equipe

  • Antes da primeira pessoa, defina a frase de recuperação na aba Usuário. Sem ela, o app não libera o cadastro — é o que impede a recuperação da senha do responsável só pelo código na tela.
  • Adicionar usuário: nome, celular, perfil (Agenda ou Financeiro) e senha de pelo menos 8 caracteres. No fim, entregue o celular e a senha à pessoa; o primeiro acesso dela é pelo login comum.
  • Desativar tira o acesso sem apagar o histórico; Ativar devolve. Redefinir senha define uma nova senha para a pessoa.
  • Os perfis separam o que cada pessoa vê dentro do Ink Agenda. Quem usa a mesma conta do Windows continua com acesso ao arquivo de dados do computador.

Backup: dossiês feitos a partir da 2.2 guardam a equipe, e os logins continuam válidos após restaurar. Ao restaurar um backup anterior à 2.2, os usuários da equipe precisam ser cadastrados de novo; o responsável continua entrando com o mesmo celular e senha.

Identidade visual do posto

A seção Identidade e Visual do Posto, no topo de Config, troca a especialidade do aplicativo: Tatuador (lilás), Dentista / Saúde (turquesa) ou Beleza & Estética (dourado).

  • A troca é imediata: paleta, título da janela e vocabulário (sessão/consulta/procedimento, cliente/paciente, estúdio/consultório/espaço). Não é preciso reiniciar nem reinstalar.
  • A escolha vale para esta instalação e fica gravada. Sem escolha gravada, o padrão é Tatuador.
  • Trocar a identidade não altera os dados existentes. O catálogo financeiro sugerido por especialidade só nasce em instalações novas.

Hoje e calendário

A aba Hoje mostra os agendamentos do dia, do mais cedo ao mais tarde, com o intervalo de horário (ex.: 14:30–16:00) e o valor.

Novo agendamento

  • Clique em ✚ Novo agendamento. Campos: cliente (nome e celular), data, horário, duração e valor.
  • Horário: escolha na lista (de 15 em 15 minutos, das 06:00 às 23:45) ou digite, por exemplo, 9:30 ou 1430.
  • Duração: 30 min, 1 h, 1 h 30, 2 h, 3 h, 4 h, 5 h, 6 h ou 8 h. Agendamentos antigos ficam com 1 h.
  • O app não deixa sobrepor sessões: se o intervalo encostar em outra sessão, mostra o conflito e pede outro horário.

Check “Pagou”

Em cada sessão da lista do dia, marque Pagou quando o cliente pagar. O valor entra no Financeiro e no Dashboard como recebimento; desmarcar volta a sessão para pendente.

Calendário

A aba Calendário mostra o mês; clique em um dia para ver e editar as sessões daquele dia.

Clientes

A aba Clientes lista todos os clientes com nome, telefone, contato preferido (WhatsApp, ligação, Instagram, e-mail ou outro) e situação (ativo ou inativo).

  • Buscar: por nome (com ou sem acento) ou pelos dígitos do telefone.
  • Novo cliente e Editar (ou duplo clique na linha): nome, celular, outro telefone, contato preferido, ativo e observações.
  • Não aceita dois clientes com o mesmo telefone.
  • Ao editar nome ou telefone, as sessões desse cliente na agenda são atualizadas.

Orçamentos

A aba Orçamentos lista os orçamentos com cliente, descrição, valores, validade, situação e origem (manual, agendamento ou ficha do cliente).

  • Novo orçamento: cliente (existente ou novo, com telefone), descrição, valor total, sinal, validade (padrão: 15 dias), situação e observações.
  • Editar (ou duplo clique): orçamentos criados nesta aba. Os que vêm de um agendamento são ajustados pelo agendamento, na aba Hoje.

Finanças

Registre entradas (sessões, retoques, vendas) e saídas (materiais, aluguel, contas) com descrição, valor, data e categoria. O app calcula o saldo e mostra o gráfico anual.

  • Novo lançamento, Alterar e Excluir na lista de movimentações.
  • Exportar PDF do balanço: balanço mensal com receitas, despesas, resultado e despesas por categoria. O mês sai em português (ex.: “outubro de 2026”).

Dashboard (resultados)

A seção Resultados do Dashboard mostra:

  • Faturamento do mês, ticket médio do mês (faturamento ÷ entradas recebidas) e saldo do mês (faturamento menos saídas);
  • Faturamento do ano, média mensal do ano (faturamento ÷ meses até agora) e ticket médio do ano.

Faturamento segue a regra do Financeiro: recebimentos (inclusive os das sessões marcadas como pagas) mais entradas lançadas à mão. Os números atualizam ao abrir a aba.

Mensagem ao cliente

O Ink não tem conta de WhatsApp nem de Telegram e não envia mensagens sozinho: ele abre o aplicativo instalado no computador com o texto pronto, e você confere e envia. O Ink não recebe as respostas nem guarda o conteúdo da conversa.

Configurar o envio

Na aba Usuário → WhatsApp e Telegram → Configurar envio, a configuração tem 4 passos:

  1. O app explica o limite: a conversa fica no seu aplicativo de mensagens.
  2. Escolha WhatsApp ou Telegram. Você pode trocar depois, sem perder a configuração.
  3. Confirme o celular de quem está logado agora como remetente — é o número que o cliente verá.
  4. O app abre uma mensagem de teste para o seu próprio número. Se o aplicativo não abrir, instale-o e abra-o uma vez no computador; depois repita o teste.

Enviar a partir do agendamento

  • Na aba Hoje, o botão Mensagem aparece em cada agendamento para o administrador e para o perfil Agenda. O perfil Financeiro não vê o botão.
  • Escolha o modelo Confirmar horário, Remarcar ou Alinhar detalhes. O texto pode ser editado antes de abrir.
  • Abrir no WhatsApp abre a conversa do cliente direto; o celular do cliente precisa estar completo, com DDD. Abrir no Telegram abre a tela de compartilhar — escolha o contato na lista, porque o Telegram não permite abrir a conversa do cliente diretamente.
  • Copiar mensagem leva o texto para a área de transferência, para colar em qualquer conversa.

Backup e restauração

Backup com senha (.inkbak)

Em Config → Backup do estúdio:

  • Salvar backup com senha: você escolhe pasta e nome (sugestão backup_AAAA-MM-DD_HH-MM.inkbak em Documentos\AgendaInk\Backups). Nada é sobrescrito: se o nome existir, o app grava “(2)”, “(3)”… O arquivo é criptografado com a senha (mínimo 8 caracteres). Sem a senha ele não abre. No fim, o app mostra o caminho salvo.
  • Restaurar backup: escolha o arquivo e digite a senha. Backups da v2.0.0 (sem senha) também restauram. O app confere o arquivo antes de trocar os dados e fecha ao terminar; abra de novo. Backups anteriores à 2.2 não guardam os usuários da equipe: eles precisam ser cadastrados de novo, e o app avisa antes de trocar os dados.

O app lembra você quando o último backup com senha tem mais de 7 dias.

Backup automático

Ligado de fábrica: a cada hora e ao fechar o app, uma cópia agenda_*.db.gz vai para %LOCALAPPDATA%\CaraCore\AgendaInk\backups\. Ficam as 30 mais recentes. Essas cópias ficam no mesmo computador e não têm senha. Para desligar, desmarque “Fazer backup automático a cada hora e ao fechar” em Config → Backup do estúdio.

Backup CSV

Em Config, a exportação CSV (compactada e criptografada com senha) leva agendamentos e lançamentos do Financeiro. Clientes, orçamentos, cobranças e recebimentos ficam só no .inkbak. Importar o mesmo arquivo duas vezes não muda nada; horários em conflito viram aviso e lista de ignorados.

Atualização do aplicativo

A verificação é manual: em Config → 4. Atualizações → Verificar atualizações. Ao abrir, o app não faz nenhuma conexão. Na verificação, ele envia apenas a versão do app e o sistema operacional — nunca dados de clientes.

  • Quando há versão nova, o app mostra o número e o que mudou, com Baixar e abrir instalador e Abrir página de download.
  • O download é conferido pelo SHA-256 do manifesto assinado com a chave embutida no aplicativo. Se a assinatura ou o hash não conferirem, o app avisa e não abre o instalador.
  • O aplicativo não baixa nem instala sozinho: o instalador aberto segue as telas do Windows e pode pedir permissão de administrador.
  • Versões 2.1.0 e 2.2.0: o botão de download falhava por um redirecionamento do GitHub. Quem está em uma dessas versões baixa a 2.2.1 uma vez pela página de download; da 2.2.1 em diante a atualização volta a funcionar pelo próprio aplicativo.

Problemas comuns

  • ZIP/EXE não inicia — Confirme que o arquivo veio do download oficial e confira o SHA256 antes de executar.
  • Horário já ocupado ao salvar — O app impede sobrepor sessões. Escolha outro horário, encurte a duração ou edite a sessão existente.
  • “Senha incorreta” ao restaurar — Use a senha digitada ao salvar aquele backup (não é a senha de login, a menos que você tenha usado a mesma).
  • Uma aba não aparece — As abas dependem do perfil. O perfil Agenda não vê Finanças, Dashboard, Orçamentos nem Config; o Financeiro não vê a gestão de usuários. O responsável ajusta o perfil em Config → 3. Usuários e perfis.
  • O botão Mensagem não aparece no agendamento — O envio ainda não foi configurado para o celular de quem está logado (Usuário → WhatsApp e Telegram) ou o perfil é Financeiro.
  • A mensagem não abre o WhatsApp ou o Telegram — Instale o aplicativo no computador e abra-o uma vez; depois repita o teste em Usuário → WhatsApp e Telegram. Se o cliente tiver celular sem DDD, o WhatsApp não encontra a conversa.
  • Atualização “não foi possível baixar o instalador” — Nas versões 2.1.0 e 2.2.0 esse botão falhava. Baixe a 2.2.1 pela página de download uma vez; a partir dela a atualização funciona pelo próprio aplicativo.
  • Precisa de ajuda — O registro técnico fica em %LOCALAPPDATA%\CaraCore\AgendaInk\logs\ (sem senhas, telefones ou e-mails). Fale pelo Canal de feedback.