Questionário

URL pública: /barometro/questionario/

A página Questionário é a experiência pública de participação no Barómetro. O utilizador responde a um formulário multi-página, validado no frontend e submetido para o Gravity Forms no WordPress.

Objectivo

Recolher respostas estruturadas para alimentar os resultados do Barómetro. A página deve ser clara, curta e orientada à conclusão do formulário, evitando conteúdos laterais que desviem o utilizador.

Comportamento esperado

• Carrega a estrutura do formulário a partir de GET /api/gravity-forms/1.
• Usa a rota pública WordPress GET /wp-json/nomia/v1/gravity-forms/1 para leitura de metadados do formulário.
• Mantém fallback autenticado para a API REST v2 do Gravity Forms quando necessário.
• Submete respostas através dos endpoints server-side do frontend, sem expor credenciais no browser.
• Apresenta mensagens de erro úteis quando o formulário está indisponível ou a validação falha.

Requisitos editoriais

• O título deve identificar a participação no Barómetro.
• A descrição deve explicar o que será recolhido e para que serve.
• O CTA principal deve levar ao primeiro passo do questionário.
• A página deve manter confiança e transparência, incluindo contexto mínimo sobre utilização das respostas.

Requisitos técnicos

• O formulário activo no WordPress deve manter o ID esperado pelo frontend.
• Gravity Forms deve estar instalado e operacional no WordPress.
• A rota pública nomia/v1/gravity-forms/{id} deve devolver apenas metadados necessários à renderização.
• As permissões de administrador do Gravity Forms devem existir para permitir manutenção no backoffice.

Não deve fazer

• Não deve chamar directamente a API REST do Gravity Forms a partir do browser.
• Não deve depender de credenciais de produção para leitura pública quando a rota nomia/v1 está disponível.
• Não deve misturar resultados agregados com o fluxo de resposta; os resultados pertencem à página Barómetro.