Que es
Un sistema de encuestas multi-paso diseñado para ISPs rurales que necesitan evaluar demanda en fraccionamientos residenciales. Incluye verificacion de WhatsApp via OTP, sistema de referidos con codigos QR, y automatizacion via webhooks n8n.
Flujo del usuario
- Encuesta 6 pasos -- datos personales, tipo de conexion actual, problemas, prioridades, velocidad deseada, comentarios
- Verificacion OTP -- se envia codigo de 6 digitos via WhatsApp, el usuario lo confirma en el browser
- Pagina de gracias -- se activa el sistema de referidos con link unico (UUID) y botones de compartir
- Sugerencias -- plantillas de mensajes y codigos QR personalizados para viralizar la encuesta
Decisiones tecnicas
- Flask sobre Django: proyecto single-purpose, no necesita ORM ni admin panel
- SQLite sobre Postgres: datos no relacionales, volumen bajo, deploy simple
- Tailwind CDN: mobile-first sin build step, dark mode con class strategy
- n8n webhooks: desacopla el survey del CRM, permite agregar WhatsApp/Telegram/Sheets sin tocar Flask
- OTP en vez de magic links: el usuario no sale del browser, mejor UX en movil
- UUID como referral code: no expone datos del usuario, compatible con el flujo de n8n
Stack completo
- Backend: Flask 2.3, Flask-WTF (CSRF), python-dotenv, pytz
- Database: SQLite3 con tablas para tokens, consentimiento y datos de encuesta
- Frontend: Tailwind CSS (CDN), vanilla JS, QR code generation (qrcode + Pillow)
- Integraciones: n8n webhooks para WhatsApp API, Google Sheets, Telegram
- Deploy: gunicorn + reverse proxy, compatible con cualquier VPS