Manual de uso

01 Primeiros passos

1. Crie sua conta em “Criar conta”. Informe nome, e-mail e senha (mínimo 8 caracteres com letras e números).
2. Confirme o e-mail: clique no link enviado (válido por 48 h). Sem a confirmação não é possível criar pesquisas — isso protege a plataforma contra cadastros falsos. Não recebeu? Verifique o spam e use “Reenviar e-mail”.
3. Ao confirmar, você pode receber automaticamente um período de teste de um plano pago (definido pelo administrador).
4. No painel você vê todas as pesquisas, o status (rascunho, coletando, encerrada), o número de respostas, o progresso em relação à meta amostral e a margem de erro atual de cada uma.

02 Criando uma pesquisa

Em Nova pesquisa há dois caminhos:

• Planejar com IA: descreva livremente o que quer descobrir, sobre quem, onde e como pretende coletar. A IA propõe o tipo de pesquisa mais adequado, população, técnica de amostragem, margem de erro, questionário com tipos de variáveis, hipóteses testáveis e textos de divulgação (WhatsApp, e-mail e redes). Você revisa o plano e, se concordar, clica em Gerar pesquisa; tudo continua editável.
• Modelos prontos, organizados por área:
  • Eleitoral: intenção de voto para Presidente, Governador, Senador (1 ou 2 vagas), Deputado Federal, Estadual e Distrital, Prefeito e Vereador, além de Avaliação de governo — em versão simples ou completa.
  • Acadêmica e científica: TCC/dissertação com escala Likert, avaliação de disciplina e docente, pesquisa com egressos, estudo transversal de iniciação científica, assistência e permanência estudantil.
  • Saúde: satisfação com serviço (UBS/SUS), inquérito de prevalência, rastreio de sintomas depressivos (PHQ-9) e de ansiedade (GAD-7) com escore e pontos de corte, qualidade de vida.
  • Comércio e mercado: NPS + CSAT, intenção de compra, sensibilidade a preço (Van Westendorp), lembrança e avaliação de marca.
  • Socioeconômica: perfil socioeconômico, moradia e saneamento, mobilidade urbana.
  • Opinião pública: serviços públicos, percepção de segurança, prioridades orçamentárias.
  • Organizacional: clima organizacional (com eNPS) e avaliação de eventos/treinamentos.

O construtor tem cinco etapas (abas): Público e coleta, Questionário, Análise e hipóteses, Aparência e Regras de coleta — mais a aba Eleitoral nas pesquisas eleitorais. As alterações são salvas automaticamente (ou com Ctrl+S). A lateral mostra o resumo metodológico e um checklist de qualidade.

03 Delimitação do público e da coleta

População

Conjunto completo de elementos sobre o qual se quer concluir (ex.: eleitores de um município; pacientes de uma UBS no mês).

Amostra

Parte da população efetivamente entrevistada.

Unidade de análise

O que é contado: pessoas, domicílios, empresas, alunos…

N

Tamanho da população. Quando conhecido (IBGE, TSE, cadastro), ativa a correção para população finita.

Tipo de coleta

• Censitária: todos os elementos da população são pesquisados. Não há erro amostral, mas a não resposta pode gerar viés.
• Por amostragem: entrevista-se uma parte e generaliza-se com margem de erro e nível de confiança.

Técnicas de amostragem

Critérios de inclusão e exclusão definem quem pode participar. Use uma pergunta com papel Filtro para encerrar a entrevista de quem não se enquadra (a resposta é registrada como “filtrada” e não entra nas análises).

04 Tamanho da amostra e margem de erro

O sistema calcula automaticamente o n mínimo para estimar uma proporção:

• z: valor da normal para o nível de confiança (90% → 1,645; 95% → 1,960; 99% → 2,576).
• p: proporção esperada. Sem informação prévia use 50% — é o caso que exige a maior amostra.
• e: margem de erro desejada (ex.: 0,03 = 3 pontos percentuais).
• deff (efeito de desenho): 1 para aleatória simples; 1,2–2 para conglomerados ou múltiplos estágios; aumenta quando há ponderação forte.
• N: tamanho da população (correção para população finita — relevante quando a amostra passa de ~5% de N).

Referências com 95% de confiança e população grande: ±5 p.p. → 385; ±4 p.p. → 601; ±3 p.p. → 1.068; ±2 p.p. → 2.401. Note que reduzir a margem pela metade exige quadruplicar a amostra.

Para estimar médias, use a calculadora amostral: n₀ = (z·σ/e)², em que σ é o desvio-padrão estimado (de estudo piloto ou literatura). A calculadora também faz alocação proporcional por estratos (nₕ = n·Nₕ/N) e considera a taxa de resposta esperada.

Depois da coleta, a margem de erro real é recalculada com o n obtido, o deff e a ponderação: e = z·√(deff·p(1−p)/n)·√((N−n)/(N−1)).

05 Questionário e tipos de variáveis

Tipos de pergunta

Tipos de variáveis

O tipo de variável é sugerido pelo tipo de pergunta, mas você pode ajustá-lo (ex.: “escolaridade” em escolha única deve ser ordinal). Ele determina as medidas descritivas (moda, mediana, média) e os testes aplicáveis.

Recursos de cada pergunta

• Papel na análise: “Variável de perfil” (para cotas, ponderação e cruzamentos), papéis eleitorais (espontânea, estimulada, rejeição, 2º turno, avaliação, certeza do voto) e “Filtro”.
• Opções especiais (“Não sabe”, “Nenhum/branco”, “Não informar”): aparecem no fim, são exclusivas em múltipla escolha e são tratadas à parte (ex.: excluídas dos votos válidos e da média de escalas).
• Ordem aleatória das opções: evita viés de ordem (fundamental na intenção de voto estimulada).
• “Outro (especifique)”, máximo de seleções, mínimo/máximo/unidade em números, imagens na pergunta e em cada opção (fotos de candidatos, produtos, embalagens).
• Lógica condicional: exibir a pergunta somente se uma resposta anterior for (ou não for) determinado valor. Ex.: “certeza do voto” só para quem escolheu um candidato.
• Código da variável: nome da coluna na exportação (ex.: renda).
• Seções: títulos e instruções sem resposta; no modo “uma por tela”, a seção aparece junto da pergunta seguinte.

06 Pesquisa eleitoral

Disponível para todos os cargos eletivos: Presidente, Governador, Senador, Deputado Federal, Deputado Estadual, Deputado Distrital, Prefeito e Vereador.

• Simples: filtro de eleitor, estimulada (cartela com fotos) e perfil básico (sexo, idade, escolaridade). Ideal para pesquisa rápida de ponto de fluxo.
• Completa: filtro, interesse, espontânea (sem mostrar nomes), estimulada com rodízio, certeza do voto, rejeição (múltipla), 2º turno (cargos majoritários), avaliação da gestão, principais problemas e perfil completo (sexo, idade, escolaridade, renda, religião, cor/raça, região).
• Cargos proporcionais incluem preferência por partido/federação; Senado permite 1 ou 2 vagas.

Na aba Eleitoral cadastre os candidatos (nome de urna, partido, número, vice e foto). A lista é sincronizada automaticamente com as perguntas de estimulada e rejeição; nas perguntas de 2º turno escolha o par de candidatos.

O que os resultados mostram

• Votos totais e votos válidos (excluindo brancos, nulos e indecisos — critério usado pela Justiça Eleitoral para definir a maioria absoluta no 1º turno), cada um com intervalo de confiança.
• Empate técnico pelo teste correto: as proporções de dois candidatos na mesma amostra são dependentes; a variância da diferença é [p₁ + p₂ − (p₁ − p₂)²]/n. O sistema informa a diferença, seu intervalo, o p-valor e a probabilidade de o líder estar de fato à frente. A regra “as margens se sobrepõem” é conservadora demais e pode declarar empate quando já há liderança.
• Simulação Monte Carlo (4.000 cenários, distribuição de Dirichlet): probabilidade de cada candidato liderar, ir ao 2º turno e vencer no 1º turno (mais de 50% dos válidos).
• Intenção de voto por perfil (sexo, idade, escolaridade…) com qui-quadrado e destaque de resíduos.
• Avaliação: agregados “ótimo + bom”, “regular”, “ruim + péssimo”.

07 Aparência, publicação e coleta

• Aparência: logotipo, capa, cores, fonte, layout (cartão, página inteira ou capa lateral), arredondamento, texto do botão e temas rápidos.
• Regras: uma pergunta por tela, barra de progresso, uma resposta por dispositivo (ou várias), encerrar ao atingir a meta ou em uma data, senha de acesso, tempo mínimo de preenchimento (descarta envios automáticos), página pública de resultados.
• TCLE: exija o Termo de Consentimento Livre e Esclarecido (há um modelo pronto conforme CNS 466/2012, 510/2016 e LGPD).
• Pré-visualizar: teste o formulário sem gravar respostas.
• Publicar e Divulgar: link curto, QR Code (PNG para impressão), botões de WhatsApp, e-mail, Telegram, Facebook e LinkedIn, textos prontos e código para incorporar no seu site.
• Modo entrevistador: gere um link por entrevistador (?e=nome). O mesmo celular/tablet registra várias entrevistas seguidas, cada resposta fica identificada e os resultados mostram a produção por entrevistador.
• Proteções: token assinado no formulário, campo-isca anti-robô, limite de envios por rede, bloqueio de reenvio no mesmo dispositivo e validação completa no servidor (tipos, limites, lógica condicional).

08 Estatística descritiva

Para cada pergunta o sistema escolhe a apresentação pelo tipo de variável:

• Qualitativas: frequência absoluta, ponderada e relativa, % acumulado (ordinais), moda e mediana (ordinais), gráfico de barras com intervalos de confiança. Em múltipla escolha os percentuais são sobre respondentes (a soma passa de 100%).
• Escalas (Likert, estrelas, NPS): distribuição + média com IC, desvio-padrão e mediana. O NPS (% promotores − % detratores) tem intervalo de confiança próprio.
• Quantitativas: n, média, IC da média, mediana, moda, desvio-padrão, variância, coeficiente de variação, mínimo, máximo, amplitude, quartis, intervalo interquartil, percentis 10 e 90, assimetria, curtose, outliers (cercas de Tukey), histograma e boxplot.
• Abertas: termos mais frequentes, respostas recentes e, em respostas curtas (ex.: voto espontâneo), agrupamento de menções com percentuais.

Leitura rápida: média ≈ mediana sugere simetria; CV acima de 30% indica alta dispersão; assimetria positiva = cauda longa à direita (comum em renda).

09 Estatística inferencial (generalização)

A estatística inferencial responde: o que posso afirmar sobre a população a partir da amostra, e com que segurança?

Intervalo de confiança e margem de erro

Cada percentual vem com seu intervalo de confiança. Para proporções usa-se o método de Wilson, que funciona bem mesmo para percentuais pequenos (ex.: 3%) — onde o intervalo “p ± margem” tradicional falha. Para médias, a distribuição t de Student.

Interpretação correta de “95% de confiança”: se repetíssemos a pesquisa muitas vezes, 95% dos intervalos construídos assim conteriam o valor verdadeiro. Não é “95% de chance de o valor estar neste intervalo específico”.

O efeito de desenho (deff) e a ponderação reduzem o tamanho efetivo da amostra (n_ef = n/deff) e alargam os intervalos — o sistema aplica isso automaticamente. A correção de população finita estreita os intervalos quando a amostra é uma fração grande da população.

p-valor e decisão

• H₀ (hipótese nula): não há diferença/associação. H₁: há.
• p-valor: probabilidade de observar um resultado tão ou mais extremo que o da amostra se H₀ fosse verdadeira. Se p < α (geralmente 5%), rejeita-se H₀.
• Erro tipo I (α): rejeitar H₀ verdadeira. Erro tipo II (β): não rejeitar H₀ falsa — mais provável em amostras pequenas.
• “Não rejeitar H₀” não prova que não há efeito; apenas que os dados não trazem evidência suficiente.
• Significância ≠ relevância: com amostras grandes, diferenças minúsculas ficam significativas. Por isso o sistema mostra o tamanho de efeito (d de Cohen, V de Cramér, η², r) com a classificação desprezível/pequeno/moderado/grande.

10 Testes de hipóteses

Registre as hipóteses antes da coleta (aba “Análise e hipóteses”): elas são testadas automaticamente nos resultados. Você também pode testar qualquer combinação na aba Inferencial. O teste é escolhido pelo tipo das variáveis:

Pressupostos verificados: normalidade (Shapiro–Wilk), tamanho dos grupos (com n ≥ 30 o Teorema Central do Limite sustenta os testes de médias), homogeneidade de variâncias (Levene/Brown–Forsythe), frequências esperadas ≥ 5 no qui-quadrado e natureza ordinal das escalas. Quando um pressuposto falha, o teste não paramétrico é marcado como recomendado.

Cruzamentos: a tabela de contingência mostra % por linha, coluna ou frequências, com qui-quadrado e resíduos padronizados ajustados — células em verde (resíduo > 1,96) têm mais casos que o esperado sob independência; em vermelho, menos.

O motor estatístico foi validado contra a biblioteca SciPy (Python) em todas as distribuições e testes; o script de conferência acompanha o sistema em tests/.

11 Ponderação e cotas

Cotas: defina a variável de estratificação e as metas por estrato (aba Público e coleta). O painel de resultados mostra o preenchimento de cada cota em tempo real — oriente os entrevistadores para os grupos que faltam.

Ponderação (raking): informe a distribuição real das variáveis de perfil na população (ex.: 52,5% mulheres; faixas etárias do TSE/IBGE). O sistema ajusta os pesos iterativamente até a amostra reproduzir todas as distribuições ao mesmo tempo, corta pesos extremos (padrão 0,3 a 3,0) e calcula o n efetivo de Kish: n_ef = (Σw)²/Σw². A margem de erro passa a refletir a perda de precisão causada pela ponderação. Os resultados podem ser vistos com e sem ponderação.

12 Escalas e alfa de Cronbach

Em “Análise e hipóteses › Escalas”, combine itens (Likert, estrelas, NPS ou números) em um escore por soma ou média. Itens redigidos no sentido oposto devem ser marcados como invertidos. Você pode definir faixas de interpretação (ex.: PHQ-9: 0–4 mínimo, 5–9 leve…).

O sistema calcula a confiabilidade (consistência interna) pelo alfa de Cronbach: α = k/(k−1) · (1 − Σs²ᵢ/s²ₜ). Referência: ≥ 0,9 excelente; ≥ 0,8 boa; ≥ 0,7 aceitável; ≥ 0,6 questionável. Também mostra a correlação item-total corrigida e o α se o item for excluído para identificar itens problemáticos. O escore pode ser usado em hipóteses (variável escore:chave).

13 Exportar, importar e relatório

• Relatório completo: ficha técnica, cenário eleitoral, resultados com gráficos e intervalos, escalas, testes de hipóteses, interpretação e questionário aplicado. Use “Imprimir › Salvar como PDF”.
• Dados em CSV: com “;” (Excel em português) ou “,” (R, SPSS, Python, Jamovi). Uma linha por resposta, coluna de peso e múltipla escolha em colunas binárias (codigo__valor).
• Dicionário de variáveis: códigos, enunciados, tipos e valores — essencial para trabalhos acadêmicos.
• Importar CSV: traga respostas coletadas em papel ou em outra ferramenta (cabeçalho = códigos das perguntas).
• Respostas: consulte e exclua respostas inválidas (testes, duplicadas).

14 Assistente de IA

• Planejar a pesquisa inteira a partir de uma descrição (tipo, desenho amostral, questionário, hipóteses e divulgação).
• Gerar perguntas adicionais no construtor.
• Revisão metodológica: aponta perguntas indutoras, ambíguas ou duplas, problemas de amostragem, adequação dos testes e aspectos éticos/legais.
• Interpretar resultados: redige um relatório interpretativo a partir dos números já calculados.

15 Assinatura e pagamentos

• Em Assinatura escolha o plano, a forma de pagamento (Pix, cartão ou boleto, conforme os gateways ativos) e aplique cupons.
• Cada pagamento libera o plano pelo ciclo contratado (mensal, trimestral, semestral ou anual). Você recebe lembrete por e-mail antes do vencimento; há alguns dias de carência.
• Se houver teste gratuito disponível, o botão “Começar teste grátis” aparece no checkout.
• Cancelar a renovação mantém o acesso até o fim do período pago. Sem plano ativo, valem os limites do plano gratuito — suas pesquisas e dados são preservados.

16 Administração administrador

1. Configurações: nome, cores, URL pública (obrigatória para e-mails e webhooks), regras de cadastro, teste automático, carência, lembretes e SMTP (com botão de teste).
2. Gateways: Mercado Pago, Asaas, Stripe, PagBank (PagSeguro), Efí (Gerencianet) e Pix manual. Informe as credenciais, use o modo sandbox para testar e cadastre a URL de webhook exibida em cada um no painel do gateway. O sistema reconsulta o status na API antes de liberar qualquer plano.
3. Provedores de IA: Claude (Anthropic), ChatGPT (OpenAI), Gemini (Google), DeepSeek, Kimi (Moonshot), Sabiá (Maritaca), Mistral, Qwen, Grok (xAI), Groq e OpenRouter. Cadastre as chaves, defina modelo e prioridade e teste a conexão. Com o fallback ativo, se um provedor falhar o próximo é usado.
4. Planos: preço, ciclo, dias de teste, limites (pesquisas, respostas, créditos de IA) e recursos (IA, ponderação, exportação, importação, remoção de marca, relatório, resultados públicos).
5. Cupons: percentual ou valor fixo, validade, limite total e por usuário, planos elegíveis, apenas primeira compra e dias extras de teste.
6. Usuários: buscar, filtrar (pagantes, teste, não verificados, bloqueados), editar, verificar e-mail manualmente, conceder plano, bloquear, excluir e acessar como o usuário para suporte.
7. Pagamentos: acompanhar cobranças e aprovar pagamentos manuais (Pix).
8. Cron: agende no cPanel a URL indicada em Configurações, 1× ao dia.
9. Auditoria: registro de acessos e alterações relevantes.

17 Glossário

Amostra probabilística

Todo elemento tem probabilidade conhecida e não nula de seleção.

deff

Efeito de desenho: quanto a variância aumenta em relação à amostragem aleatória simples.

n efetivo

Tamanho de uma amostra aleatória simples com a mesma precisão (n/deff).

FPC

Correção para população finita, √((N−n)/(N−1)).

IC

Intervalo de confiança.

p.p.

Pontos percentuais (de 40% para 43% = 3 p.p.).

Votos válidos

Votos dados a candidatos, excluindo brancos e nulos (e, nas pesquisas, indecisos).

Empate técnico

Quando a diferença entre dois candidatos não é estatisticamente significativa.

Raking

Ajuste iterativo de pesos para a amostra reproduzir distribuições conhecidas da população.

NPS

Net Promoter Score: % promotores (9–10) − % detratores (0–6).

Alfa de Cronbach

Medida de consistência interna de uma escala.

Resíduo ajustado

Diferença padronizada entre o observado e o esperado em uma célula; |r| > 1,96 indica desvio significativo.