📱
Como usar como Aplicativo
Adicione o link à tela inicial do celular
Android — Chrome
1
Abra o Chrome
Acesse o link do painel ou da página das famílias.
2
Menu ⋮
Toque nos três pontinhos no canto superior direito.
3
Adicionar à tela inicial
Confirme o nome e toque em "Adicionar".
iPhone — Safari
1
Abra o Safari
Acesse o link desejado no Safari (não funciona no Chrome do iPhone).
2
Ícone de compartilhar ⬆
Toque no ícone na barra inferior da tela.
3
Adicionar à Tela de Início
Role a lista e toque nessa opção. Confirme no canto superior direito.
✅
O ícone aparecerá na tela inicial como um app. Ao abrir, ocupa a tela inteira sem barra do navegador.
💬
Configurando o WhatsApp Business
Envie o link nas mensagens automáticas
1
Abra o WhatsApp Business
Toque nos três pontinhos ⋮ > Ferramentas comerciais.
2
Mensagem de saudação
Ative a opção e toque em ✏️ para editar.
3
Cole a mensagem abaixo
Inclua o link de agendamento no texto.
Sugestão de mensagem
Olá! 😊 Para agendar ou gerenciar sua visita, acesse o link abaixo:
https://clin-agenda.vercel.app
4
Escolha os destinatários
Selecione "Todos" ou somente contatos sem conversa. Salve.
⚠️
Substitua o link se o sistema tiver um domínio próprio configurado.
🛡️
Privacidade e Conformidade LGPD
Lei nº 13.709/2018 — Proteção de Dados Pessoais
🛡️
Este sistema foi desenvolvido sob o princípio de Privacidade desde a Concepção (Privacy by Design), conforme preconiza a Lei Geral de Proteção de Dados — LGPD (Lei nº 13.709/2018). A proteção dos dados pessoais foi considerada em cada etapa do projeto, e não como um recurso adicionado posteriormente.
✓
Não exposição de dados sensíveis
A página pública não exibe listas de residentes. O visitante deve informar o nome completo, evitando a exposição indevida de dados de pessoas em situação de vulnerabilidade — categoria especialmente protegida pela LGPD.
✓
Finalidade e Minimização de Dados
Apenas os dados estritamente necessários para o agendamento são coletados: nome, CPF, telefone e quantidade de pessoas. O uso de CPF no lugar do e-mail reduz a coleta a um identificador único já de domínio do titular.
✓
Controle de Acesso e Autenticação
O painel administrativo exige autenticação com credenciais individuais. Apenas usuários autorizados têm acesso às informações dos agendamentos e dos residentes.
✓
Segurança no Banco de Dados (RLS)
O banco de dados possui Row Level Security ativo, garantindo que cada operação seja validada por políticas de acesso definidas — impedindo consultas ou alterações não autorizadas diretamente pela API.
⚠️
O acesso ao painel /admin deve ser restrito a funcionários autorizados. Credenciais não devem ser compartilhadas. Em caso de desligamento de colaborador, a senha deve ser alterada imediatamente.
💡
Para fins de conformidade, recomenda-se manter um registro interno de quem tem acesso ao sistema e revisar as permissões periodicamente, conforme o art. 46 da LGPD.
📅
Gestão de Vagas e Datas
Como funciona o controle automático de ocupação
1
Configurar um dia
Em Configurar Visitas, crie uma data com horários, limite por família e limite total.
2
Limite por família
Máximo de pessoas por agendamento (ex: 4). O visitante não consegue selecionar mais do que isso.
3
Limite total do dia
Quando a soma de todas as pessoas agendadas atinge esse número, o dia é bloqueado automaticamente.
4
Um residente por dia
Cada residente só pode receber uma visita ativa por dia. O sistema impede duplicidade.
5
Datas bloqueadas
Bloqueie feriados ou eventos internos com um motivo. A data não aparece para agendamento.
✅
Ao cancelar uma visita, as vagas são liberadas automaticamente para novos agendamentos no mesmo dia.
⚠️
Dias sem configuração cadastrada não aparecem para as famílias. Crie as configurações com antecedência.
📥
Importação de Residentes via CSV
Cadastre vários residentes de uma só vez com uma planilha
💡
Em vez de cadastrar residente por residente manualmente, você pode preparar uma planilha no Excel ou Google Sheets e importar todos de uma vez. O processo leva menos de dois minutos.
Preparando o arquivo
1
Baixe o modelo CSV
No painel, acesse Residentes e clique em 📥 Importar CSV. Em seguida, clique em ⬇️ Baixar Modelo CSV. Um arquivo será salvo no seu computador já com os cabeçalhos corretos e uma linha de exemplo.
2
Abra no Excel ou Google Sheets
Abra o arquivo baixado e preencha uma linha por residente. A coluna nome é obrigatória. As demais — quarto, data de nascimento, responsável, telefone e observações — são opcionais.
3
Formato da data de nascimento
Use o formato AAAA-MM-DD (ex: 1945-03-15 para 15 de março de 1945). Deixe a coluna em branco se não souber a data.
4
Salve como CSV
No Excel: Arquivo → Salvar Como → CSV UTF-8 (delimitado por vírgulas). No Google Sheets: Arquivo → Fazer download → Valores separados por vírgula (.csv).
Importando no painel
5
Selecione ou arraste o arquivo
Na janela de importação, clique na área pontilhada ou arraste o arquivo CSV diretamente para ela. O sistema lê o arquivo instantaneamente.
6
Revise o preview
Antes de confirmar, uma tabela mostra os primeiros 50 registros encontrados e o total de residentes no arquivo. Verifique se os dados estão corretos.
7
Clique em Importar
O botão mostra exatamente quantos residentes serão cadastrados. Ao clicar, o sistema importa todos e exibe um resumo: quantos foram salvos com sucesso e se houve algum erro.
✅
Após a importação, a lista de residentes é atualizada automaticamente. Todos os residentes chegam com status Ativo e já ficam disponíveis para agendamento no portal das famílias.
⚠️
O sistema aceita arquivos com separador por vírgula ou ponto-e-vírgula e remove automaticamente a marcação invisível que o Excel adiciona. Se um residente já estiver cadastrado com o mesmo nome, ele será cadastrado novamente — revise o arquivo antes de importar para evitar duplicatas.
🛋️
Modo Descanso do Gestor
O sistema trabalha para que você descanse com tranquilidade
💚
Você não precisa estar disponível o tempo todo. O ClinAgenda possui três camadas de proteção que garantem que as famílias só consigam agendar quando a clínica estiver pronta para recebê-las.
Trava de Fim de Semana
1
Por que a trava de sexta às 18h?
A partir da sexta-feira no horário configurado (padrão: 18h), o sistema remove automaticamente o sábado e o domingo da semana corrente do calendário de agendamentos. Isso impede que novos pedidos cheguem no fim de semana para datas que a equipe não tem mais como organizar.
2
Semanas futuras não são afetadas
A trava é cirúrgica: bloqueia apenas o próximo fim de semana imediato. Sábados e domingos de semanas seguintes continuam disponíveis normalmente no calendário, permitindo que as famílias se planejem com antecedência.
3
Como configurar o horário da trava
No painel administrativo, acesse Configurações do Portal → Trava de Fim de Semana. Ative o interruptor e ajuste o horário de ativação conforme a rotina da clínica. A alteração entra em vigor imediatamente.
Grade de Horários Semanal
1
O portal respeita o expediente da clínica
A administradora define, dia a dia, o período em que o portal fica acessível. Fora desses horários, as famílias recebem automaticamente uma mensagem informando quando o portal reabre — sem precisar ligar ou enviar mensagem para a clínica.
2
Dias sem expediente ficam fechados
Se um dia da semana não estiver habilitado na grade (ex: domingo), o portal permanece fechado durante todo aquele dia. Se nenhum dia for configurado, o portal fica disponível 24 horas — ideal para clínicas sem restrição de horário de agendamento.
3
Mensagem automática com horário de reabertura
Quando uma família tenta acessar fora do horário, o sistema exibe exatamente quando o portal volta a funcionar. Isso reduz dúvidas, mensagens no WhatsApp e telefonemas fora de hora.
Botão de Emergência
1
Fechamento imediato com um clique
Em situações imprevistas — surto de doença, obras, emergência interna — a administradora acessa Configurações do Portal → Bloqueio de Emergência e clica em BLOQUEAR PORTAL AGORA. O portal fecha instantaneamente para todas as famílias.
2
As famílias veem uma mensagem clara
Em vez de encontrar um erro ou uma tela quebrada, os familiares veem um aviso respeitoso: "Portal Temporariamente Indisponível — entre em contato com a clínica". Isso preserva a imagem da instituição mesmo nas situações mais urgentes.
3
Reabertura igualmente simples
Quando a situação for resolvida, o mesmo botão — agora com o texto REABRIR PORTAL AGORA — restaura o acesso com um único clique. Não é necessário nenhum outro ajuste no sistema.
🌙
Com a grade de horários, a trava de fim de semana e o botão de emergência, a equipe da Repousaré Clínica pode encerrar o expediente com a certeza de que o sistema está cuidando de tudo — e que nenhum agendamento fora de hora chegará de surpresa.
📋
Ficha Completa do Residente
Registro clínico, de internação e de contatos em um só lugar
💡
A ficha do residente foi expandida para reunir todas as informações necessárias para o cuidado e a gestão. Os dados são organizados em quatro abas, facilitando a consulta rápida de cada área.
Aba 1 — Dados Pessoais
1
Informações de identificação
Nome completo, nome social, CPF, RG, data de nascimento, sexo e naturalidade. O nome social é exibido nos relatórios quando preenchido.
2
Foto do residente
Faça upload de uma foto diretamente pela ficha. A imagem é armazenada com segurança e exibida na lista de residentes.
3
Endereço completo
Logradouro, número, bairro, cidade e estado. Útil para documentação e correspondência oficial.
Aba 2 — Internação
1
Dados de admissão
Data de entrada, número do quarto, leito e ala. O número do quarto aparece na lista principal de residentes.
2
Plano de saúde
Nome do plano, número da carteirinha e validade. Mantém o controle de cobertura atualizado.
3
Status do residente
Ativo, Alta, Óbito ou Transferência. Residentes com status diferente de Ativo não aparecem no portal de agendamento das famílias.
Aba 3 — Saúde
1
Diagnóstico e medicações
Diagnóstico principal, CID-10, alergias conhecidas e lista de medicações em uso. Campo de texto livre para facilitar o registro.
2
Necessidades especiais e dieta
Registre restrições alimentares, tipo de dieta e necessidades de cuidado especial como uso de cadeira de rodas ou assistência na locomoção.
3
Médico responsável
Nome e CRM do médico principal que acompanha o residente.
Aba 4 — Contatos
1
Responsável legal
Nome, grau de parentesco, CPF, telefone e e-mail do responsável principal pelo residente.
2
Contato de emergência
Nome e telefone de um segundo contato para situações urgentes.
⚠️
Apenas o nome e o quarto são obrigatórios. Os demais campos podem ser preenchidos gradualmente conforme as informações chegarem.
💰
Mensalidades
Controle financeiro dos residentes mês a mês
💡
O módulo de Mensalidades permite registrar o valor mensal de cada residente, gerar cobranças em lote para um mês inteiro e marcar pagamentos conforme são efetuados — tudo em uma única tela.
Gerando mensalidades do mês
1
Acesse o menu Mensalidades
Na barra lateral, clique em Financeiro → Mensalidades.
2
Selecione mês e ano
Use os campos no topo da tela para escolher o mês de referência que deseja gerenciar.
3
Clique em "Gerar Mensalidades do Mês"
O sistema cria automaticamente um registro de cobrança para cada residente Ativo que ainda não possui mensalidade no período selecionado. Residentes já com cobrança gerada não são duplicados.
Marcando pagamentos
4
Localizar o residente na lista
A tabela exibe todos os residentes com o status de pagamento (Pendente ou Pago), o valor e a data de vencimento.
5
Marcar como pago
Clique no botão Marcar Pago ao lado do residente. O sistema registra a data do pagamento automaticamente e atualiza o resumo no topo da página.
6
Editar valor ou vencimento
Clique no ícone de edição ✏️ para ajustar o valor cobrado, a data de vencimento ou adicionar uma observação para aquela competência.
✅
O painel exibe um resumo no topo com o total de mensalidades, o total já pago e o total pendente — facilitando o fechamento financeiro do mês.
⚠️
O valor padrão de cada mensalidade é definido na ficha do residente. Se o campo estiver vazio, a mensalidade será gerada com valor zero e deve ser editada manualmente.
🎨
Atividades Diárias e Presenças
Registro de sessões terapêuticas e recreativas com controle de participação
💡
Registre sessões de fisioterapia, musicoterapia, pintura, jogos de memória e qualquer outra atividade realizada na clínica. Para cada sessão, marque quais residentes participaram — gerando um histórico completo de engajamento.
Tipos de Atividade
1
Cadastre os tipos antes de usar
Em Atividades → Tipos de Atividade, crie as categorias da sua clínica: Fisioterapia, Musicoterapia, Pintura, Jogos de Memória, Exercícios em Grupo etc. Cada tipo possui nome, ícone (emoji) e cor de identificação.
2
Responsável pela atividade
Informe o nome do profissional responsável (fisioterapeuta, terapeuta ocupacional, voluntário etc.) ao criar o tipo ou em cada sessão individualmente.
Criando uma sessão
1
Acesse Atividades Diárias
No menu lateral, clique em Atividades → Atividades Diárias.
2
Nova Atividade
Clique em + Nova Atividade. Escolha o tipo, informe a data e horário de início, duração e local onde a sessão será realizada.
3
Observações da sessão
Use o campo de observações para registrar intercorrências, evolução clínica ou qualquer informação relevante daquela sessão específica.
Registrando presenças
4
Abrir lista de presenças
Na lista de atividades, clique em 👥 Presenças ao lado da sessão desejada. Uma janela exibirá todos os residentes ativos da clínica.
5
Marcar ou desmarcar participantes
Clique no nome de cada residente para alternar entre Presente (verde) e Ausente (cinza). Não há limite de seleções.
6
Salvar presenças
Clique em Salvar Presenças. O sistema registra a lista de participantes vinculada à sessão. Você pode voltar e editar a qualquer momento.
✅
O histórico de atividades e presenças fica registrado permanentemente, permitindo acompanhar a evolução e engajamento de cada residente ao longo do tempo.
👨⚕️
Gestão de Funcionários
Cadastro completo da equipe da clínica
💡
O cadastro de funcionários foi expandido para incluir informações trabalhistas e operacionais, facilitando o controle da equipe e a alocação por turno.
1
Dados de identificação
Nome completo, CPF, cargo, telefone e e-mail. O CPF é usado como identificador único — dois funcionários não podem ter o mesmo CPF cadastrado.
2
Data de admissão
Registre a data de início do vínculo empregatício. Useful para calcular tempo de casa e para documentação de RH.
3
Turno de trabalho
Indique o turno: Manhã, Tarde, Noite ou Plantão. Facilita a organização da escala e o controle de quem está presente em cada período.
4
Status do funcionário
Ativo, Férias, Afastado ou Inativo. Funcionários com status Inativo não aparecem nas listas de seleção durante o cadastro de atividades.
5
Observações internas
Campo livre para notas internas, como especialidades, certificações ou informações relevantes para a gestão da equipe.
⚠️
O cadastro de funcionários é exclusivo do painel administrativo e não é acessível às famílias. Nenhuma informação da equipe é exibida no portal público.
📱
Confirmação Automática por WhatsApp
Notificação instantânea no celular do visitante após o agendamento
💡
Quando configurada, esta função envia automaticamente uma mensagem de confirmação pelo WhatsApp para o telefone do visitante logo após o agendamento ser registrado com sucesso — sem nenhuma ação manual da equipe.
Como funciona
1
Agendamento confirmado
Assim que a família confirma a visita no portal, o sistema envia nos bastidores uma requisição ao serviço Z-API com o número de telefone do visitante.
2
Mensagem enviada automaticamente
O visitante recebe no WhatsApp uma mensagem com o nome do residente, a data formatada por extenso, o horário e a quantidade de pessoas confirmadas.
3
Falha silenciosa
Se o WhatsApp não puder ser enviado (falta de sinal, número inválido, serviço offline), o agendamento é salvo normalmente. A falha do envio não cancela nem bloqueia a visita.
Como configurar
1
Criar conta na Z-API
Acesse z-api.io e crie uma instância. Conecte seu número de WhatsApp escaneando o QR Code na plataforma. A Z-API oferece um período de teste gratuito.
2
Obter as credenciais
Na Z-API, copie o Instance ID, o Token e o Client Token da sua instância. Essas são as chaves que autorizam o envio.
3
Configurar na Vercel
No painel da Vercel, acesse o projeto → Settings → Environment Variables. Adicione as três variáveis:
Variáveis de Ambiente — Vercel
ZAPI_INSTANCE_ID → ID da sua instância
ZAPI_TOKEN → Token da instância
ZAPI_CLIENT_TOKEN → Client Token da conta
4
Fazer deploy
Após salvar as variáveis, faça um novo deploy na Vercel (ou aguarde o próximo deploy automático via git push). A função de WhatsApp passa a operar imediatamente.
✅
Com o WhatsApp automático configurado, as famílias recebem confirmação instantânea, sem que a equipe precise enviar mensagens manualmente. Isso reduz dúvidas e retrabalho.
⚠️
O número de WhatsApp conectado à Z-API deve permanecer com o aplicativo aberto e com conexão ativa. Instâncias desconectadas param de enviar mensagens até que o QR Code seja escaneado novamente.
🏥
Consultas Externas
Consultas, exames e procedimentos fora da clínica
1
Registrar uma consulta externa
No menu TERAPIAS & ATIVIDADES → Consultas Externas, clique em + Nova Consulta. Informe o residente, tipo (Consulta, Exame ou Procedimento), especialidade, data e local.
2
Configurar retorno automático
No campo Retorno em, selecione 30, 60 ou 90 dias. A data de retorno é calculada automaticamente. Você também pode definir uma data personalizada diretamente.
3
Notificação WhatsApp ao familiar
Informe o nome e telefone do familiar e ative o toggle Enviar WhatsApp 3 dias antes do retorno. O sistema envia automaticamente às 08h (horário de Brasília) quando o retorno estiver próximo.
✅
Use os filtros da página para visualizar retornos nos próximos 7 dias e identificar rapidamente quais residentes precisam de atenção.
💰
Financeiro — Contas e Folha de Salários
Controle de receitas, despesas e pagamento de funcionários
1
Contas a Receber
Registre mensalidades extras, taxas e outras receitas. Ao gerar as mensalidades do mês, as Contas a Receber são criadas automaticamente. Use os filtros por status e mês para acompanhar inadimplência.
2
Contas a Pagar
Cadastre despesas como fornecedores, impostos, serviços e utilidades. Categorize cada conta para facilitar a análise no DRE. Contas próximas do vencimento geram alerta automático via WhatsApp.
3
Folha de Salários
Clique em ⚡ Gerar Folha do Mês para criar automaticamente os registros de todos os funcionários ativos com seus salários base. Edite individualmente para adicionar adicionais, descontos e registrar o pagamento.
4
DRE / Fluxo de Caixa
Selecione o mês/ano e clique em Calcular. O sistema exibe receitas recebidas, despesas pagas (incluindo impostos separados), folha de salários, resultado líquido e o fluxo cronológico de movimentações.
✓
Imprimir Relatórios
Cada tela financeira tem o botão 🖨️ Imprimir que gera uma versão formatada para impressão ou salvar como PDF pelo navegador.
⚠️
Para a notificação automática de vencimentos funcionar, configure a variável NUMERO_CLINICA nas variáveis de ambiente da Vercel com o número de WhatsApp da clínica (formato: 5551999999999).
📦
Estoque — Residentes e Almoxarifado
Controle de medicamentos, higiene e materiais da clínica
1
Estoque por Residente
No menu ESTOQUE → Estoque por Residente, cadastre os medicamentos e materiais de higiene de responsabilidade de cada família. Defina uma quantidade mínima para receber alertas visuais de estoque baixo.
2
Almoxarifado
Controle os materiais gerais da clínica: escritório, limpeza, higiene e alimentos. Use o botão 📦 para registrar entradas (compras) e saídas (uso). O saldo é atualizado automaticamente.
3
Histórico de Movimentos
No menu ESTOQUE → Histórico Almox., consulte todas as entradas e saídas com filtros por categoria, tipo e período de data.
✅
Use o filtro Estoque baixo para visualizar rapidamente quais itens precisam ser repostos antes que acabem.
🩺
Módulo Clínico
Ocorrências, plantão, sinais vitais e medicamentos
1
Ocorrências
Registre qualquer evento relevante do dia: quedas, intercorrências, comportamentos atípicos. Cada ocorrência fica vinculada ao residente com data, hora e gravidade.
2
Passagem de Plantão
A equipe registra um resumo ao final de cada turno (manhã, tarde, noite) com as principais observações. Facilita a comunicação entre os turnos e mantém histórico clínico.
3
Sinais Vitais
Registre pressão arterial, frequência cardíaca, temperatura, saturação, glicemia e peso de cada residente. O histórico gráfico permite acompanhar a evolução ao longo do tempo.
4
Medicamentos
Cadastre os medicamentos prescritos para cada residente: nome, dosagem, via de administração, horários e período de uso. Medicamentos ativos ficam em destaque para facilitar a checagem.
🏢
Gestão Operacional
Mapa de ocupação, lista de espera e documentos
1
Mapa de Ocupação
Visualize todos os quartos da clínica em um mapa visual com status de ocupado, vago ou em manutenção. Clique em + Configurar Quarto para atribuir ou mover residentes entre quartos.
2
Lista de Espera
Cadastre interessados que aguardam uma vaga. Defina prioridade (Normal ou Urgente) e acompanhe o status de cada contato: Aguardando, Contatado, Internado ou Desistiu.
3
Gestão de Documentos
Faça upload e organize documentos de cada residente: contratos, laudos, exames, RG, CPF, plano de saúde. Acesse os arquivos rapidamente sem precisar procurar em pastas físicas.
👨👩👧
Portal da Família
Comunicação e transparência com os familiares
1
Feed de Atualizações
Publique fotos e mensagens visíveis às famílias no portal público. Marque a publicação como visível para os familiares acessarem pelo link da página das famílias.
2
QR Code de Check-in
Imprima o QR Code e fixe na recepção. Os visitantes escaneiam com o celular ao chegar e a clínica registra automaticamente a entrada e saída com data e hora.
3
Alertas Internos
Crie lembretes recorrentes ou únicos para a equipe: aniversários, avaliações médicas periódicas, renovação de documentos. Alertas pendentes aparecem no dashboard.
✅
O portal da família é acessível pelo link público da clínica — compartilhe com os responsáveis para que acompanhem as atualizações do dia a dia sem precisar ligar ou visitar.
✅
Assistência Diária
Checagem de medicamentos, hidratação, escalas e imunizações
1
Checagem Diária de Medicamentos
Em ASSISTÊNCIA DIÁRIA → Checagem Diária, registre a administração de cada medicamento por residente e por turno (Manhã, Tarde, Noite). Indique se foi administrado, recusado ou suspenso e assine com o nome do responsável.
2
Hidratação e Diurese
Registre o controle hídrico (ingestão de líquidos) e a diurese (eliminação urinária) de cada residente. Indicado para pacientes com restrição hídrica ou monitoramento renal. O balanço hídrico diário é calculado automaticamente.
3
Escalas Geriátricas
Aplique as principais escalas de avaliação geriátrica: Barthel, Katz, Braden, Morse, Mini-Mental (MEEM), GDS-15 e Zarit. Os scores são calculados automaticamente com classificação de risco e recomendações clínicas.
4
Imunizações
Controle o calendário vacinal dos residentes. Registre vacinas aplicadas com data, dose, lote e responsável. O sistema exibe alertas para vacinas próximas do vencimento ou em atraso.
📒
Prontuário Eletrônico & Clínico
Prontuário, prescrições, SAE, PIA, eventos sentinela e POPs
1
Prontuário Eletrônico
Em PRONTUÁRIO & CLÍNICO → Prontuário Eletrônico, registre evoluções clínicas com data, tipo (Médica, Enfermagem, Fisioterapia etc.), CID-10, conduta e responsável. O histórico é exibido em linha do tempo por residente.
2
Prescrições Médicas
Cadastre prescrições com medicamento, dosagem, via, frequência, período e médico prescritor com CRM. Prescrições ativas alimentam automaticamente a checagem diária de medicamentos.
3
SAE — Sistematização da Assistência de Enfermagem
Registre diagnósticos de enfermagem (padrão NANDA), intervenções (NIC), sinais vitais e evolução. Cada SAE fica vinculada ao residente com data e assinatura do enfermeiro responsável.
4
PIA — Plano Individual de Atenção
Elabore o plano individualizado de cuidados em seis áreas: Social, Médica, Nutricional, Fisioterapia, Psicologia e Lazer. Cada área tem objetivos, intervenções, responsável e data de revisão definidos.
5
Eventos Sentinela
Registre eventos sentinela (quedas com lesão, erros de medicação, óbitos inesperados etc.) com análise de causa raiz, ações corretivas, notificação à ANVISA e comunicação à família. Obrigatório para conformidade regulatória.
6
POPs — Procedimentos Operacionais Padrão
Cadastre e imprima os procedimentos operacionais da clínica com código, versão, área responsável e passo a passo detalhado. Use o botão 🖨️ para gerar o documento formatado para treinamentos e auditorias da ANVISA.
🏛️
Qualidade & Gestão
Escala de funcionários e registros de ANVISA / Fiscalização
1
Escala de Funcionários
Em QUALIDADE & GESTÃO → Escala de Funcionários, gerencie a escala mensal da equipe por data e turno. Registre substituições, visualize agrupado por dia da semana e imprima a escala do mês.
2
ANVISA / Fiscalização
Registre inspeções e vistorias com órgão fiscalizador, resultado (Aprovado, Pendências, Reprovado), pendências identificadas, ações corretivas, responsável e prazo. Pendências com prazo vencido ficam destacadas em vermelho.
🍽️
Nutrição
Cardápio semanal, dietas individuais, aceitação alimentar e antropometria
1
Cardápio Semanal
Em NUTRIÇÃO → Cardápio Semanal, preencha a grade de 7 dias × 6 refeições (Café da Manhã, Colação, Almoço, Lanche, Jantar e Ceia). Use o seletor de semana para navegar e salve com o botão 💾 Salvar Cardápio.
2
Dietas Individuais
Cadastre a dieta prescrita para cada residente: tipo (Normal, Pastosa, Líquida, Hipossódica, Diabética etc.), consistência, via de alimentação (Oral, Sonda, Parenteral), suplementos e metas calóricas, proteicas e hídricas diárias.
3
Aceitação Alimentar
Registre diariamente o nível de aceitação de cada refeição por residente: Completa (100%), Parcial 75%, 50%, 25% ou Recusou. Útil para monitorar risco nutricional e comunicar à nutricionista responsável.
4
Antropometria
Registre avaliações nutricionais periódicas com peso, altura, IMC (calculado e classificado automaticamente para idosos), circunferências e MAN (Mini Avaliação Nutricional — score 0 a 30). O sistema classifica o risco nutricional automaticamente.
✅
IMC para idosos: abaixo de 18,5 = Baixo Peso; 18,5 a 22 = Normal; 22 a 27 = Adequado; 27 a 30 = Sobrepeso; acima de 30 = Obesidade. MAN: ≥24 = Normal; 17 a 23,9 = Risco; <17 = Desnutrição.
🦵
Fisioterapia & Lesões por Pressão
Sessões, planos terapêuticos e controle de feridas
1
Sessões de Fisioterapia
Em TERAPIAS & ATIVIDADES → Fisioterapia, registre cada sessão com tipo (Cinesioterapia, Hidroterapia, Eletroterapia, Respiratória etc.), duração em minutos, técnicas utilizadas, evolução e resposta do paciente. Informe o CREFITO do profissional.
2
Plano de Fisioterapia
Elabore o plano terapêutico individualizado com diagnóstico cinesiológico, objetivos de curto e longo prazo, frequência semanal e data de revisão. O plano ativo fica vinculado ao residente.
3
Lesões por Pressão
Em TERAPIAS & ATIVIDADES → Lesões por Pressão, abra e acompanhe cada lesão com localização, estágio (1 a 4, Não Classificável ou Tecido Profundo), dimensões, tipo de curativo e frequência de troca.
4
Evoluções da Lesão
Clique em 📋 Evoluções em uma lesão ativa para registrar o progresso ao longo do tempo: mudança de estágio, dimensões, aspecto do leito da ferida e troca de cobertura. O histórico completo fica arquivado.
🔬
Exames Laboratoriais
Pedidos de exames e registro de resultados
1
Pedidos de Exames
Em EXAMES → Exames Laboratoriais, clique na aba Pedidos e registre a solicitação médica com tipo (Laboratorial, Imagem, Cardiológico, Outros), urgência (Rotina, Urgente, Emergência) e acompanhe o status (Pendente → Coletado → Resultado Disponível).
2
Resultados de Exames
Na aba Resultados, registre os valores encontrados com unidade de medida, valor de referência e interpretação (Normal, Alterado ou Crítico). Resultados críticos ficam destacados para atenção imediata da equipe médica.
✅
Vincule o resultado ao pedido de exame original para manter o histórico completo. Use o filtro por interpretação para localizar rapidamente todos os resultados alterados ou críticos de um residente.
👥
Usuários e Controle de Acesso
Gerencie quem acessa o sistema e quais módulos cada perfil pode ver
1
Perfis de acesso
Em CADASTROS → Usuários e Perfis, o sistema possui 7 perfis padrão: Administrador, Médico, Enfermeiro, Fisioterapeuta, Nutricionista, Assistente Social e Recepção. Cada perfil define quais módulos do menu ficam visíveis para o usuário.
2
Cadastrar novo usuário
Primeiro crie a conta no Supabase Auth (Authentication → Users → Invite User) com o e-mail do funcionário. Em seguida cadastre o mesmo e-mail em Usuários e Perfis vinculando ao perfil desejado.
3
Como funciona o controle de acesso
Ao fazer login, o sistema carrega automaticamente os módulos permitidos para o perfil do usuário e oculta os menus não autorizados. O perfil Administrador tem acesso irrestrito a todos os módulos.
⚠️
Usuários com conta ativa no Supabase Auth mas não cadastrados em Usuários e Perfis recebem acesso de Administrador por padrão. Cadastre todos os funcionários com seus respectivos perfis para garantir o controle de acesso correto.
💬
Comunicação com Famílias
Registro de comunicados, contatos de emergência e histórico por residente
1
Registrar Comunicação
Em FAMÍLIA & VISITAS → Comunicação c/ Famílias, aba Comunicações, clique em + Nova Comunicação. Informe o residente, tipo (Informativo, Urgente, Rotina, Financeiro), canal (Telefone, WhatsApp, E-mail, Presencial), responsável, resumo e evolução/resposta obtida.
2
Cadastrar Contatos Familiares
Na aba Contatos Familiares, cadastre o responsável legal e demais familiares com nome, parentesco, telefones, e-mail e se é responsável legal. Essas informações ficam vinculadas ao residente e estão disponíveis em situações de emergência.
3
Filtrar e Imprimir
Use o filtro por residente para ver o histórico completo de comunicações de uma família. Clique em 🖨️ Imprimir para gerar um registro imprimível de uma comunicação específica, útil para arquivamento no prontuário físico.
✅
Registre toda comunicação com famílias — mesmo ligações rápidas — para criar um histórico documentado. Em situações de conflito ou auditoria, esse registro é fundamental para a clínica.
📧
Relatório por E-mail
Envio automático diário de relatório gerencial para a equipe
1
Configurar Destinatários
Em QUALIDADE & GESTÃO → Relatório por E-mail, aba Configuração, adicione os e-mails que devem receber o relatório diário. Você pode ativar ou desativar cada destinatário individualmente sem removê-lo da lista.
2
Envio Manual
Na aba Envio Manual, selecione a data desejada e clique em 📤 Enviar Agora. O relatório traz um resumo completo do dia: residentes ativos, visitas, ocorrências, checagens, mensalidades pendentes e eventos sentinela.
3
Histórico de Envios
Na aba Histórico, veja todos os envios realizados com data, destinatários, status (Enviado / Erro) e, em caso de falha, a mensagem de erro para diagnóstico.
⚠️
O envio automático diário requer um Cron Job configurado na Vercel. Sem isso, apenas o envio manual estará disponível. Consulte a documentação da Vercel sobre Cron Jobs se precisar ativar o envio automático.
🧮
Calculadora Financeira
Cálculo proporcional do primeiro mês, 13º mês e parcelamento
1
Configurar Valores por Estágio
Em FINANCEIRO → Calculadora Financeira, aba Estágios, configure o valor mensal para cada um dos 4 estágios (Independente, Semi-dependente, Dependente e Dependente Total/UTI). Esses valores são usados na simulação.
2
Calcular Primeiro Mês Proporcional
Na aba Calcular, informe a data de entrada e o estágio. O sistema calcula automaticamente o valor proporcional do primeiro mês: se entrar no dia 1, paga o mês cheio; caso contrário, paga apenas os dias restantes do mês (ex: entrou dia 14 em janeiro → paga 17/31 do valor).
3
13º Mês (Gratificação Natalina)
O sistema calcula o 13º mês proporcional ao tempo de permanência, incluindo a fração do primeiro mês parcial. Por exemplo: entrou em 14/01 com R$6.500 e permanece até dezembro → calcula (11 meses completos + 17/31 do primeiro mês) / 12 × R$6.500.
4
Parcelamento do 13º
O familiar pode pagar o 13º junto com as mensalidades mensais. O sistema divide o total do 13º pelo número de meses completos (de fevereiro em diante), adicionando a parcela à mensalidade de cada mês. O pagamento total vence até 10 de dezembro.
5
Mudança de Estágio
Ative Houve mudança de estágio? para incluir períodos com valores diferentes. Adicione cada período com data de início e valor. O sistema calcula a média ponderada para o 13º considerando os diferentes valores por período.
✅
Regra: se o residente entra no dia 1, paga o mês cheio desde o início. Os meses são contados de 01 a último dia do mês, e os valores são pagos antecipados (no início do mês).
📈
Indicadores de Qualidade
Painel de indicadores, metas, semáforo, histórico e treinamentos
1
Painel de Indicadores
Em QUALIDADE & GESTÃO → Indicadores de Qualidade, a aba Painel exibe os 11 indicadores em tempo real com semáforo colorido: 🟢 verde (meta atingida), 🟡 amarelo (alerta) e 🔴 vermelho (crítico). Clique em 📸 Salvar Snapshot para registrar os valores do mês no histórico.
2
Indicadores Disponíveis
O sistema monitora: Taxa de Ocupação, Quedas no Mês, Lesões por Pressão Ativas, Ocorrências Graves, Checagens Realizadas (%), Plantões Registrados, Visitas Realizadas (%), Taxa de Inadimplência, Receita Média/Residente, Ratio Cuidador/Residente e Treinamentos no Mês.
3
Configurar Metas
Na aba Metas, ajuste os valores alvo, limiares amarelo e vermelho para cada indicador de acordo com a realidade da clínica. As metas são salvas por indicador e usadas para calcular o semáforo automaticamente.
4
Histórico e Gráficos
Na aba Histórico, selecione um indicador para ver seu gráfico de evolução mensal em barras. Os dados vêm dos snapshots salvos manualmente. Útil para apresentar tendências em reuniões de gestão ou auditorias.
5
Registrar Treinamentos
Na aba Treinamentos, registre cada capacitação da equipe com título, data, carga horária, número de participantes e responsável. O indicador Treinamentos no Mês é alimentado automaticamente por esses registros.
✅
Salve um snapshot no primeiro dia de cada mês para manter o histórico atualizado. Isso permite comparar a evolução dos indicadores ao longo do ano e apresentar relatórios de qualidade para órgãos fiscalizadores.
✍️
Assinatura Digital
Coleta de assinaturas eletrônicas em documentos e contratos
1
Criar Documento para Assinar
Em QUALIDADE & GESTÃO → Assinatura Digital, aba Documentos, clique em + Novo Documento. Informe o residente, tipo (Contrato, PIA, Termo de Consentimento, Autorização, Outro), título, descrição e conteúdo opcional. O documento fica com status Pendente.
2
Coletar Assinatura
Na aba Assinar, selecione o documento pendente. Informe o nome do assinante, CPF, relação com o residente (Responsável Legal, Filho, Cônjuge etc.) e assine no campo de desenho usando o dedo (touch) ou mouse. Clique em ✅ Confirmar Assinatura para registrar.
3
Consultar Documentos Assinados
Na aba Assinados, veja todos os documentos com assinatura coletada, com data, assinante e relação. Clique em 🖨️ Imprimir para gerar o documento com a assinatura digitalizada inclusa, pronto para arquivamento.
⚠️
A assinatura eletrônica coletada neste sistema é uma representação visual para fins de registro interno. Para validade jurídica plena (ICP-Brasil), utilize um serviço de assinatura digital certificada externo.
🤖
Assistente IA
Chat inteligente com contexto em tempo real do sistema
1
Como Usar o Assistente
Em QUALIDADE & GESTÃO → Assistente IA, digite sua pergunta na caixa de texto e pressione Enter ou clique em Enviar. O assistente tem acesso em tempo real aos dados do sistema: residentes ativos, ocorrências recentes, lesões, mensalidades pendentes, visitas do dia e eventos sentinela.
2
Atalhos Rápidos
Use os botões de atalho para perguntas frequentes: Resumo do Dia, Alertas Críticos, Situação Financeira, Gerar Relatório e Quem está no plantão?. Esses atalhos enviam automaticamente a pergunta correspondente.
3
Gerar Documentos Clínicos
Peça ao assistente para redigir documentos como PIA (Plano Individual de Atenção), SAE (Sistematização da Assistência de Enfermagem), relatórios de evolução, laudos e comunicados. O assistente usa os dados reais dos residentes para estruturar o documento.
4
Manter Conversa Contextual
O assistente lembra as últimas 10 mensagens da conversa, permitindo perguntas em sequência ("e o João?", "qual o quarto dele?"). Clique em 🗑️ Nova Conversa para iniciar um novo contexto limpo.
⚠️
O Assistente IA requer uma chave da API Anthropic configurada na Vercel (ANTHROPIC_API_KEY). Sem essa configuração, o botão Enviar retornará erro. Consulte a seção de implantação para instruções de configuração.
✅
O assistente nunca inventa dados — só responde com base no contexto real do sistema. Se não houver informação disponível, ele informará claramente e sugerirá onde buscar no sistema.
⏱️
Controle de Ponto
Registro de entrada e saída de funcionários com banco de horas
1
Registrar Ponto
Em QUALIDADE & GESTÃO → Controle de Ponto, clique em + Registrar Ponto. Selecione o funcionário, o tipo (Entrada, Saída, Entrada Almoço, Saída Almoço), informe data/hora e observação opcional. Clique em Salvar.
2
Visualizar Registros
Filtre os registros por funcionário e período. A tabela exibe todos os batimentos em ordem cronológica. Registros podem ser editados ou excluídos pelo gestor.
3
Banco de Horas
O sistema calcula automaticamente as horas trabalhadas por dia com base nos pares de batimentos (Entrada/Saída). Acesse o resumo mensal por funcionário para acompanhar eventuais débitos ou horas extras.
📢
Ouvidoria
Canal de manifestações anônimas ou identificadas de familiares e residentes
1
Enviar uma Manifestação (Portal das Famílias)
No Portal das Famílias, toque em 📢 Ouvidoria. Selecione o tipo (Reclamação, Sugestão, Elogio, Denúncia), a categoria, o residente relacionado (opcional) e descreva a manifestação. Marque Anônimo se não quiser se identificar e clique em Enviar.
2
Gerenciar Manifestações (Painel Admin)
Em QUALIDADE & GESTÃO → Ouvidoria, veja todas as manifestações com status (Aberta, Em Análise, Respondida, Arquivada). Clique em ✏️ para registrar a resposta e alterar o status. Manifestações anônimas exibem "Anônimo" no lugar do nome do autor.
⚠️
Todas as manifestações ficam registradas com data e horário. Mesmo as anônimas são arquivadas para fins de auditoria e melhoria contínua.
🚨
Plano de Emergência
Protocolos e contatos para situações de urgência na clínica
1
Cadastrar Protocolo
Em QUALIDADE & GESTÃO → Plano de Emergência, clique em + Novo Protocolo. Informe o tipo de emergência (Incêndio, Queda, PCR, Fuga, Desaparecimento etc.), o procedimento passo a passo e os responsáveis envolvidos.
2
Contatos de Emergência
Gerencie a lista de contatos de emergência (SAMU, Bombeiros, Hospital de Referência, Responsável da clínica, Plantão noturno). Esses contatos ficam visíveis de forma destacada para acesso rápido durante uma ocorrência.
✅
Imprima o Plano de Emergência e afixe em locais estratégicos da clínica para que toda a equipe tenha acesso imediato, mesmo sem computador.
⭐
Pesquisa de Satisfação
NPS e avaliação da qualidade do atendimento pelos familiares
1
Responder a Pesquisa (Portal das Famílias)
No Portal das Famílias, toque em ⭐ Pesquisa de Satisfação. Escolha uma nota de 0 a 10 (onde 10 é a maior satisfação) e avalie cinco dimensões: Atendimento, Limpeza, Alimentação, Comunicação e Infraestrutura. Adicione elogios ou sugestões e clique em Enviar Avaliação.
2
Acompanhar Resultados (Painel Admin)
Em QUALIDADE & GESTÃO → Pesquisa de Satisfação, visualize o NPS médio, a distribuição das notas (Promotores, Neutros, Detratores) e os comentários recebidos. Filtre por período para acompanhar a evolução da satisfação ao longo do tempo.
💡
O NPS (Net Promoter Score) é calculado subtraindo o percentual de Detratores (notas 0-6) do percentual de Promotores (notas 9-10). Valores acima de 50 indicam excelência.
🏭
Fornecedores
Cadastro e gestão de fornecedores de produtos e serviços
1
Cadastrar Fornecedor
Em FINANCEIRO → Fornecedores, clique em + Novo Fornecedor. Informe a razão social, CNPJ/CPF, categoria (Alimentos, Medicamentos, Higiene, Equipamentos, Serviços etc.), telefone, e-mail, responsável comercial e observações. Clique em Salvar.
2
Editar e Inativar
Na lista de fornecedores, clique no nome ou no botão ✏️ para editar os dados. Para inativar um fornecedor (sem excluir o histórico), altere o status para Inativo. Fornecedores inativos ficam ocultos por padrão mas podem ser exibidos com o filtro.
3
Vincular a Contas a Pagar
Ao registrar uma nova conta em Contas a Pagar, selecione o fornecedor correspondente. Isso permite rastrear os pagamentos por fornecedor e gerar relatórios de gastos por categoria.
🛏️
Mapa de Quartos Visual
Visão em grade e planta baixa da ocupação dos quartos
1
Vista em Grade
Em CADASTROS → Mapa de Ocupação, clique na aba Grade. Os quartos são exibidos em cartões coloridos: verde = ocupado, cinza = disponível, laranja = saída temporária. Clique em qualquer quarto para ver os detalhes do residente.
2
Vista em Planta
Clique na aba Planta para visualizar os quartos no layout físico da clínica, organizados por alas (A e B) e corredores. A planta é útil para orientar visitantes e novos funcionários sobre a localização dos residentes.
3
Imprimir o Mapa
Clique em 🖨️ Imprimir para gerar uma versão para impressão do mapa de quartos atual, com status de ocupação e nomes dos residentes. Útil para a passagem de plantão e para relatórios de fiscalização.
🎂
Aniversariantes
Lista de residentes e funcionários aniversariando no mês
1
Ver Aniversariantes do Mês
Em FAMÍLIA & VISITAS → Aniversariantes, o sistema exibe automaticamente os residentes e funcionários que fazem aniversário no mês atual, ordenados por data. Cada cartão mostra a data, a idade que a pessoa completará e quantos dias faltam.
2
Navegar entre Meses
Use as setas ‹ Anterior e Próximo › para consultar aniversariantes de outros meses. Isso permite planejar comemorações e programar atividades especiais com antecedência.
🎉
Planeje celebrações mensais usando a lista de aniversariantes junto com o módulo de Atividades Diárias para registrar as comemorações no prontuário de cada residente.
📄
Relatório Mensal
Consolidado mensal de indicadores operacionais e assistenciais
1
Gerar o Relatório
Em QUALIDADE & GESTÃO → Relatório Mensal, selecione o mês e o ano desejados e clique em Gerar Relatório. O sistema consolida automaticamente: ocupação média, entradas e saídas, ocorrências, receita e despesa do mês, visitas realizadas e indicadores clínicos.
2
Imprimir e Compartilhar
Clique em 🖨️ Imprimir / Exportar PDF para salvar o relatório. O documento é formatado para apresentação a sócios, familiares e órgãos fiscalizadores (ANVISA, Vigilância Sanitária). Cada seção traz dados reais extraídos do banco de dados.
🛒
Lista de Compras
Gerenciamento de itens a comprar para a clínica
1
Adicionar Item
Em FAMÍLIA & VISITAS → Lista de Compras, clique em + Adicionar Item. Informe o nome do item, categoria (Alimentos, Medicamentos, Higiene, Limpeza, Equipamentos etc.), quantidade, unidade e quem solicitou. O item entra com status Pendente.
2
Marcar como Comprado
Ao realizar a compra, clique no item e altere o status para Comprado. Informe o valor gasto (opcional) para acompanhar os custos. Itens comprados ficam riscados na lista e podem ser arquivados para manter o histórico.
3
Imprimir Lista
Clique em 🖨️ Imprimir para gerar a lista de itens pendentes formatada para uso no mercado ou farmácia. Apenas os itens ainda não comprados são exibidos na impressão.
🏠
Saídas Temporárias
Controle de residentes que saem temporariamente da clínica
1
Registrar Saída
Em FAMÍLIA & VISITAS → Saídas Temporárias, clique em + Nova Saída. Selecione o residente, informe a data/hora de saída, o motivo (Visita a familiar, Consulta médica, Internação, Outro), o responsável que o acompanhará e a previsão de retorno.
2
Registrar Retorno
Quando o residente retornar, localize o registro na lista de saídas ativas e clique em Registrar Retorno. Informe a data e hora do retorno e observações sobre o estado do residente. O quarto volta a aparecer como ocupado no mapa.
⚠️
Residentes em saída temporária aparecem no Mapa de Quartos com indicador laranja. A ausência é registrada para fins de cobrança proporcional e relatórios de fiscalização.
📧
Relatório por E-mail
Envio automático diário da agenda de visitas para a equipe
1
Configurar Destinatários
Em QUALIDADE & GESTÃO → Relatório por E-mail, aba Destinatários, adicione os e-mails que devem receber o relatório diário de visitas. Cada destinatário pode ser ativado ou desativado individualmente sem excluí-lo da lista.
2
Envio Automático (Cron)
O sistema envia automaticamente às 20h (horário de Brasília) um e-mail com as visitas agendadas para o dia seguinte. O envio é feito via Vercel Cron + Resend e não requer nenhuma ação manual para funcionar.
3
Envio Manual
Na aba Enviar Agora, selecione a data desejada e clique em Enviar Relatório. Útil para testes ou para reenviar um relatório que não foi entregue. O histórico de todos os envios (automáticos e manuais) fica registrado na aba Histórico.
4
Histórico de Envios
Na aba Histórico, veja todos os envios com data, hora, destinatários, total de visitas e status (Enviado/Erro). Em caso de erro, o detalhe técnico é exibido para facilitar o diagnóstico.
⚙️
Para que o envio automático funcione, as variáveis de ambiente RESEND_API_KEY, SUPABASE_URL, SUPABASE_SERVICE_KEY e RELATORIO_SECRET devem estar configuradas no painel da Vercel.
📱
Instalar como Aplicativo
Use o ClinAgenda e o Portal das Famílias direto na tela inicial do celular
1
Instalar no Android (Chrome)
Acesse o sistema pelo Chrome. Toque no menu ⋮ (três pontos) no canto superior direito e selecione Adicionar à tela inicial ou Instalar aplicativo. Confirme e o ícone aparecerá na sua tela inicial como um app nativo.
2
Instalar no iPhone (Safari)
Acesse o sistema pelo Safari. Toque no ícone de compartilhar ⬆️ na barra inferior e selecione Adicionar à Tela de Início. Dê um nome ao atalho e confirme. O app abrirá em tela cheia sem a barra do navegador.
3
Portal das Famílias como App
O Portal das Famílias (clin-agenda.vercel.app/familias.html) também pode ser instalado como aplicativo separado. Siga o mesmo processo acima para que os familiares tenham acesso fácil ao portal de visitas diretamente da tela inicial do celular.
✅
O aplicativo funciona offline para leitura de dados já carregados. Ao reconectar à internet, as informações são sincronizadas automaticamente com o servidor.