42 lines
1.8 KiB
Markdown
42 lines
1.8 KiB
Markdown
<div align="center">
|
|
<br/><br/>
|
|
<h1>🌍 Cómete el mundo y gana</h1>
|
|
<p><b>Aplicación web promocional gamificada con validación de facturas automatizada mediante Inteligencia Artificial (OCR).</b></p>
|
|
</div>
|
|
|
|
---
|
|
|
|
## 📋 Descripción del Proyecto
|
|
|
|
Plataforma interactiva desarrollada para la campaña promocional conjunta de **Maggi** y **Nestlé**. Los usuarios pueden registrar su cuenta de manera segura, fotografiar sus tickets de compra y subirlos a la plataforma. Mediante integraciones automatizadas con Inteligencia Artificial, las facturas se analizan para otorgar puntos al usuario (1 punto por cada $10 USD), permitiéndole escalar en un Ranking en tiempo real para obtener diferentes premios.
|
|
|
|
## 🛠️ Stack Tecnológico
|
|
|
|
* **Frontend:** React 19, TypeScript
|
|
* **Build Tool:** Vite 6
|
|
* **Estilos y Componentes:** Tailwind CSS v4, Lucide React, Framer Motion
|
|
* **Enrutamiento:** React Router DOM v7
|
|
* **BaaS (Autenticación y BD):** Supabase (PostgreSQL)
|
|
* **Automatización y Procesamiento IA:** n8n Webhooks, Google Gemini API
|
|
* **Seguridad:** Google reCAPTCHA v2
|
|
|
|
## ⚙️ Variables de Entorno (.env)
|
|
|
|
Para configurar la aplicación, debes crear un archivo `.env` o `.env.local` en la raíz del proyecto tomando como plantilla el archivo `.env.example`. Asegúrate de definir las siguientes variables:
|
|
|
|
```env
|
|
# Clave de la API de IA (Configurada en AI Studio o n8n)
|
|
GEMINI_API_KEY="TU_GEMINI_API_KEY"
|
|
|
|
# URL de la Aplicación
|
|
APP_URL="http://localhost:3000"
|
|
|
|
# Credenciales de Supabase
|
|
VITE_SUPABASE_URL="TU_URL_DE_SUPABASE"
|
|
VITE_SUPABASE_ANON_KEY="TU_ANON_KEY_DE_SUPABASE"
|
|
|
|
# Endpoint del Webhook de N8N que recibirá las facturas (FormData)
|
|
VITE_N8N_WEBHOOK_URL="TU_N8N_WEBHOOK_URL"
|
|
|
|
# Llave de sitio de Google reCAPTCHA
|
|
VITE_RECAPTCHA_SITE_KEY="TU_RECAPTCHA_SITE_KEY" |