Manual de utilização do Analisiin

Innovativa • Levantamentos, modelos e ações • Versão 0.7.0 • 8 de outubro de 2026

Este manual cobre a versão online para uma organização. Os registros ficam no banco do servidor, compartilhados pela equipe autenticada. O guia LEIA_PRIMEIRO_HOSTINGER.txt descreve a instalação pelo hPanel. A versão local 0.5.1 continua sendo um produto separado.

1 Acesso e organização do trabalho

Abra o endereço HTTPS configurado para o sistema. Entre com seu e-mail e senha. A primeira conta é criada pelo responsável pela instalação; as demais são cadastradas em Usuários pelo administrador.

Perfis reais

• Administrador: cadastra usuários, empresas e modelos; conduz, revisa e aprova levantamentos; consulta auditoria.

• Gestão: cadastra empresas; conduz, revisa e aprova levantamentos; acompanha ações e agenda.

• Técnico: cria e preenche levantamentos atribuídos à própria conta; acompanha as ações pelas quais é responsável.

Os registros da organização e a lista da equipe podem ser consultados pelos usuários autenticados. Esta edição não separa clientes em organizações isoladas nem oferece sigilo de registros por departamento. O bloqueio de edição e de revisão é validado no servidor, além da interface.

Minha conta

Clique no perfil, na parte inferior do menu. Para alterar a senha, informe a senha atual e a nova senha. Use Sair da conta para encerrar a sessão. A sessão dura até 12 horas; depois será necessário entrar novamente.

Use senhas individuais e não compartilhe a conta administrativa. Não existe recuperação automática por e-mail nesta edição. Se perder o acesso, procure o responsável pela instalação.

Navegação

Início apresenta totais e registros recentes. Levantamentos reúne as coletas. Modelos abre a biblioteca e o editor. Empresas reúne os locais cadastrados. Ações acompanha responsáveis, prazos e status. Agenda organiza datas das visitas. Usuários pertence ao administrador.

2 Empresas e novas coletas

Cadastrar uma empresa

1. A gestão ou o administrador abre Empresas e seleciona Nova empresa.

2. Informa nome, CNPJ e cidade com UF.

3. Clica em Salvar e confere o cartão criado.

O cadastro não consulta automaticamente órgãos externos nem valida a situação fiscal da empresa.

Preparar um levantamento

1. Abra Levantamentos e clique em Novo levantamento.

2. Escolha a empresa e um modelo publicado.

3. Selecione a conta responsável pelo levantamento. O técnico só pode atribuir a si mesmo; a gestão pode escolher alguém da equipe.

4. Preencha o nome do técnico, a data, o horário e as orientações iniciais, se houver.

5. Clique em Criar e iniciar.

A conta responsável determina quem pode editar a coleta. O nome digitado no campo Responsável serve como informação do registro; não concede permissão a outra conta.

Cada levantamento guarda uma cópia do modelo usado ao iniciar a visita. Mudanças posteriores no modelo não alteram o questionário de uma coleta existente.

Localizar e continuar

Use a busca por empresa, CNPJ, cidade ou identificador. Filtre por Em andamento, Em revisão ou Concluído. Abra o registro para continuar o preenchimento ou consultar suas informações.

O percentual de preenchimento inclui perguntas opcionais visíveis. Uma coleta pode estar pronta para revisão sem atingir 100%, desde que todos os obrigatórios, o nome final e a assinatura estejam registrados.

A conformidade usa apenas perguntas configuradas com “Sim significa conforme”, respondidas Sim ou Não. N.A. não entra nesse cálculo. O indicador auxilia a leitura e não substitui avaliação técnica.

3 Modelos e editor

Criar ou adaptar

1. Como administrador, abra Modelos. Use Criar modelo, Personalizar ou Duplicar para trabalhar numa cópia independente.

2. Defina nome e descrição. Escolha uma página à esquerda e edite a pergunta diretamente na linha.

3. Clique no tipo de resposta à direita. No painel, escolha texto, número, data, fotografia, assinatura ou respostas personalizadas.

4. Marque Obrigatório quando necessário. Para personalizadas, use Seleção múltipla; em Sim/Não, pode configurar Sim como conforme.

5. Organize seções, repetições e condições. Teste na Pré-visualização e publique quando estiver pronto.

Use + Seção e + Página para organizar o editor. Clique no título para renomear. O menu de opções permite duplicar, excluir, subir e descer. No computador, a alça de arrastar move perguntas entre seções de inspeção. Movimentos que colocam uma dependente antes do gatilho são recusados.

Respostas personalizadas e lógica

Escolha Respostas personalizadas, informe uma alternativa por linha e use Salvar e aplicar. Seleção múltipla aceita várias respostas. As alternativas pertencem à pergunta; duplicá-la reutiliza a configuração. As cores são fixas nesta edição.

Para criar uma dependente, selecione o gatilho, use Adicionar lógica, escolha a resposta e clique em Fazer perguntas. Escreva a pergunta criada abaixo. Exibir se permite vincular uma pergunta existente a um gatilho anterior.

Rascunho e publicação

As edições são salvas automaticamente como rascunho no servidor, inclusive perguntas sem texto. Aguarde Alterações não publicadas salvas. Salvar e sair confirma a gravação antes de fechar. Não encerre o navegador enquanto o salvamento estiver pendente.

Editar mantém a versão publicada disponível para novas visitas. Publicar aplica o rascunho às próximas coletas; as já iniciadas mantêm sua estrutura. A publicação exige nome, títulos de seções, perguntas e alternativas válidas. Descartar alterações restaura a versão publicada. Desfazer e Refazer recuperam edições da sessão atual.

Pré visualização e limites

A prévia aceita respostas de teste e mostra perguntas condicionais. Não cria coleta, envia anexos ou executa assinaturas e repetições; esses recursos são indicados na tela.

Tipos: Sim/Não/N.A., texto curto, texto longo, escolha única, seleção múltipla, número, data, fotografia e assinatura. A assinatura final é acrescentada automaticamente. Páginas organizam o editor; a coleta navega por seções. Limites: 40 seções, 500 perguntas e 30 repetições por seção na coleta.

4 Condições repetições e importação

Perguntas condicionais

Crie primeiro o gatilho, como “Há trabalho em altura?”, do tipo Sim/Não. Crie a pergunta dependente depois dele. Na linha da pergunta, escolha Exibir se, selecione o gatilho e a resposta Sim.

Uma dependente oculta não bloqueia o envio, mesmo se obrigatória. Respostas antigas de perguntas ocultas permanecem guardadas, mas não ativam condições posteriores nem aparecem entre os itens visíveis do relatório. Se o item voltar a aparecer, confira a resposta anterior.

Escolha única e múltipla escolha também podem acionar condições. Na múltipla escolha, a condição verifica se a alternativa foi marcada. Nas regras da seção, a condição pode controlar um bloco inteiro; quando o gatilho é a primeira pergunta do próprio bloco, ele continua visível para permitir a escolha.

Repetir setores ou funções

Ative a opção de repetir a seção no editor. Durante a coleta, use Outro setor ou Outra função. Cada repetição guarda respostas independentes. Há limite de 30 repetições. A remoção atua na última repetição adicional e remove suas respostas.

Importar e exportar modelos

No cartão do modelo, Exportar JSON baixa a estrutura, sem respostas de visitas. Para reutilizar, selecione Importar CSV ou JSON, revise o rascunho e publique.

O CSV usa os cabeçalhos secao, pergunta e tipo. Campos adicionais: opcoes, obrigatoria, conformidade, condicao_pergunta e condicao_resposta. Os tipos são sim, texto, observacao, foto, escolha, multipla, numero, data e assinatura. Separe alternativas em opcoes por barra vertical.

Em condicao_pergunta, informe o enunciado exato de uma pergunta anterior. Em condicao_resposta, informe Sim, Não, N.A. ou uma alternativa válida. Enunciados duplicados como gatilho são rejeitados. Salve preferencialmente em UTF-8; vírgula e ponto e vírgula são aceitos como separador. O limite de importação de modelo é 1 MB.

PDF, Word, XLSX e páginas salvas de sistemas externos não viram modelos automaticamente. Prepare um CSV ou um JSON do Analisiin. Não renomeie a extensão para simular conversão.

5 Anotações e anexos por pergunta

Registrar uma anotação

1. No item desejado, selecione Adicionar anotação.

2. Descreva o que foi observado no campo de texto.

3. Se necessário, selecione Anexar arquivo à anotação e escolha os arquivos.

4. Clique em Salvar anotação.

O texto aparece logo abaixo da pergunta. Para corrigir, abra a anotação novamente. Cancelar descarta o texto ainda não salvo; arquivos que já foram enviados permanecem vinculados ao item.

Anexar imagem ou documento

Use Anexar mídia / arquivo em qualquer pergunta. Selecione uma ou mais imagens ou documentos. Aguarde a confirmação do envio antes de sair da tela. Imagens mostram uma miniatura; documentos exibem nome e tamanho. Clique no nome para abrir ou baixar.

• Formatos aceitos: PNG, JPG/JPEG, WebP, PDF, DOCX, XLSX, TXT e CSV.

• Limite: 10 MB por arquivo e até 30 anexos por item.

• Remover do item desvincula o arquivo da pergunta e do relatório. O arquivo permanece no banco para preservação; a operação não apaga fisicamente os bytes.

Arquivos executáveis, HTML e SVG não são aceitos. Os anexos são servidos por uma rota autenticada; não ficam em uma pasta pública de uploads. Todo usuário autenticado desta organização pode consultar os anexos.

Anotações gerais

Na etapa final, há um cartão Anotações gerais do levantamento. Use-o para observações, documentos ou ações que se referem à visita inteira, sem vínculo com uma pergunta específica.

Fotos em campos de resposta

A pergunta do tipo Foto continua disponível quando a imagem é a resposta principal. Ela guarda uma imagem comprimida, com até 1.200 pixels no maior lado. Para várias evidências, prefira Anexar mídia / arquivo.

6 Ações e acompanhamento

Criar uma ação a partir de uma pergunta

1. Selecione Criar ação no item correspondente.

2. Informe um título objetivo: o que precisa ser feito.

3. Acrescente uma descrição com o contexto ou orientação.

4. Escolha uma conta da equipe como responsável.

5. Informe o prazo e confirme em Criar ação.

A ação nasce com status Aberta e aparece abaixo da pergunta, com responsável e prazo. Cada item aceita até 100 ações. O vínculo mantém o contexto do levantamento que originou o encaminhamento.

Acompanhar no menu Ações

Abra Ações para ver os encaminhamentos da equipe. Filtre por Aberta, Em andamento ou Concluída. O responsável ou a gestão pode mudar o status; o servidor confirma a permissão.

As ações podem continuar sendo acompanhadas depois que o levantamento foi aprovado. Atualizar o status da ação não reabre nem altera as respostas da inspeção concluída.

Não existe envio automático de e-mail, lembrete de prazo ou integração com calendário externo nesta edição. O prazo e o responsável ficam registrados no painel; a equipe deve combinar a rotina de acompanhamento.

Revisão de evidências

Durante Em revisão e Concluído, as respostas e as anotações não podem ser editadas. Para corrigir o conteúdo de uma pergunta ou criar outra ação a partir da coleta, a gestão precisa devolver um registro em revisão para ajustes. A conclusão de uma ação já criada permanece disponível pelo painel de ações.

7 Assinatura envio e revisão

Assinar ao final

1. Abra a última etapa: Assinatura e encerramento.

2. Informe o nome do acompanhante.

3. Clique em Adicionar assinatura. O sistema abre um quadro branco separado.

4. Desenhe com o dedo no celular ou com o mouse no computador.

5. Use Limpar para recomeçar; Cancelar descarta o desenho novo.

6. Clique em Salvar assinatura e aguarde a confirmação.

A imagem salva aparece na coleta e no relatório. Refazer assinatura abre um quadro novo, em branco. A assinatura anterior só é substituída ao salvar o novo desenho. O quadro também é usado em perguntas do tipo Assinatura configuradas no modelo.

O nome final e a assinatura são exigidos antes do envio. O registro desenhado não é uma assinatura com certificado digital e não faz verificação biométrica da identidade.

Enviar para revisão

Na última etapa, clique em Enviar para revisão. O sistema confere as respostas obrigatórias visíveis e a assinatura final. Se faltar um campo, leva à primeira seção pendente e informa a pergunta.

Devolver ou aprovar

A gestão abre um levantamento Em revisão e percorre as seções. Devolver exige um motivo; o registro volta a Em andamento, permitindo correção pelo responsável. Depois do ajuste, o técnico envia novamente.

Aprovar exige que todos os obrigatórios estejam respondidos. O registro passa a Concluído e fica somente para consulta. Esta edição não oferece reabertura de uma coleta concluída pela interface. Para outra visita, crie um novo levantamento.

8 Relatórios backup e migração

Imprimir ou salvar em PDF

Abra o levantamento e clique em Imprimir registro. Permita a nova janela. No diálogo do navegador, selecione a impressora ou Salvar como PDF. Confira empresa, modelo, respostas, notas, evidências e assinatura antes de compartilhar.

O relatório inclui anotações e ações dos itens visíveis, as anotações gerais e a etapa de assinatura. Imagens anexadas são exibidas; outros documentos aparecem pelo nome, com um link de download. Esses links exigem uma sessão ativa. Um PDF compartilhado não incorpora os bytes dos arquivos DOCX, XLSX ou PDFs anexados.

O registro não substitui PGR, PCMSO, LTCAT ou outros documentos técnicos formais.

Backup dos dados

Exportar backup JSON reúne empresas, modelos, levantamentos, respostas e referências de fotos, assinaturas e anexos. É útil para preservar os registros estruturados. Esses arquivos ficam no banco: o JSON sozinho não transporta suas imagens e documentos para outro servidor.

O backup completo da instalação é a exportação do banco MySQL pelo phpMyAdmin, acompanhada da cópia dos arquivos do sistema e da configuração privada. Proteja esse backup, que também contém usuários e dados de autenticação. Guarde-o fora da pasta pública.

Restaurar backup JSON, nesta edição, é uma mesclagem administrativa no mesmo servidor, preservando referências de anexos existentes. Não use esse botão como substituto da restauração completa do banco.

Importar a versão local 0.5.1

Antes da mudança, exporte o JSON na versão local. O administrador da versão online abre Usuários e usa Importar base local. Modelos e empresas com o mesmo identificador serão substituídos; coletas já existentes com o mesmo identificador são rejeitadas para evitar duplicação.

Coletas importadas ficam atribuídas à conta administrativa usada na importação. Os status antigos são preservados e a importação é auditada. Uma coleta antiga já concluída não recebe uma assinatura inventada. Registros em andamento deverão preencher nome e assinatura final antes de novo envio.

9 Conexão conflitos e liberação

Confirmar o salvamento

Alterações pendentes indica que a gravação ainda não foi confirmada. Salvo no servidor indica que o servidor aceitou os dados. Aguarde essa confirmação antes de encerrar o navegador ou mudar de dispositivo.

Esta edição é online e não fornece um modo de coleta offline com sincronização automática. Sem conexão, a tentativa de gravação pode falhar. Não interprete uma resposta visível na tela como confirmação de armazenamento.

Duas pessoas alterando ao mesmo tempo

Se outro usuário gravar uma revisão mais recente, o sistema bloqueia o salvamento antigo para não sobrescrever o trabalho dele. O aviso oferece Baixar rascunho e Recarregar dados do servidor.

Baixe o rascunho antes de recarregar. O arquivo guarda as alterações não confirmadas para recuperação assistida; não é um backup aprovado nem possui importação automática pela interface. Depois de recarregar, confira o que já está salvo e reaplique os ajustes necessários. Esta versão usa revisão global da base; alterações em coletas diferentes também podem gerar esse aviso.

Preparar a entrada em produção

1. Configure o domínio exclusivo, o PHP, o MySQL e o HTTPS conforme LEIA_PRIMEIRO_HOSTINGER.txt.

2. Instale a conta administrativa e cadastre um técnico e uma conta de gestão reais.

3. Faça uma coleta de treinamento sem dados pessoais reais: respostas, anotação, imagem, PDF e ação.

4. Assine em um celular físico, envie, devolva para ajuste, reenvie e aprove.

5. Teste a impressão e o download de anexos nas contas corretas.

6. Abra dois navegadores e confirme o bloqueio de conflito sem perda de rascunho.

7. Exporte o banco e confirme que o responsável sabe restaurá-lo.

8. Só depois libere o endereço à equipe.

A validação local do pacote não confirma a configuração do plano Hostinger. Confira no próprio hPanel o suporte a PHP 8.2 ou superior, PDO MySQL, InnoDB, regras de reescrita e limites de upload. O objetivo da homologação é verificar a instalação real, antes do uso com dados de trabalho.