Shak-Zhu/pm-survey-pipeline

O que pm-survey-pipeline faz?

Habilidade Codex: aplicativos web de pesquisa bilíngues com pipeline Cloudflare Worker -> Google Sheets (armazenamento + painel automático) -> Telegram.

Esta habilidade gera uma aplicação web de pesquisa que funciona em dois idiomas (inglês e português, por padrão). O front-end é servido por um Cloudflare Worker, que recebe as respostas do formulário e as insere em uma planilha do Google Sheets. A mesma planilha pode ser usada como um painel de visualização automática (gráficos e tabelas). Após cada submissão, o Worker envia uma notificação para um chat do Telegram.

Funcionalidades

• Bilíngue: interface e textos traduzidos dinamicamente.
• Serverless: sem necessidade de servidor próprio; usa Cloudflare Workers.
• Armazenamento simples: Google Sheets como banco de dados.
• Notificações em tempo real: alertas no Telegram a cada resposta.
• Dashboard automático: a própria planilha pode gerar gráficos e resumos.

Como usar

1. Configure as credenciais do Google Sheets API e crie uma planilha.
2. Crie um bot do Telegram e obtenha o token e chat ID.
3. Defina as variáveis de ambiente no Cloudflare Worker:
   • GOOGLE_SHEETS_CREDENTIALS
   • SHEET_ID
   • TELEGRAM_BOT_TOKEN
   • TELEGRAM_CHAT_ID
4. Faça o deploy do Worker com o código gerado.
5. Acesse a URL do Worker para visualizar o formulário.

Personalização

• Altere as perguntas editando o array questions no código do Worker.
• Modifique os idiomas suportados ajustando o objeto translations.
• Adicione validações extras (email, CPF, etc.) conforme necessário.

Dependências

• Cloudflare Workers (plano gratuito)
• Google Sheets API (ativação gratuita)
• Bot do Telegram (criação gratuita via @BotFather)

---

Para mais detalhes, consulte a documentação oficial do Cloudflare Workers, Google Sheets API e Telegram Bot API.