EventAI Assistant

Chatbot conversacional especializado en planificación de eventos en Córdoba, Argentina.

Ayuda a organizar cumpleaños, reuniones familiares, graduaciones y otros eventos de forma conversacional, recopilando información paso a paso y generando planes completos.

---

🚀 Inicio Rápido

1. Instalar Dependencias

.\install.bat

2. Iniciar Proyecto

.\start.bat

3. Abrir Navegador

http://localhost:3000

---

📜 Comandos Disponibles

Comando	Descripción
.\start.bat	Inicia backend (puerto 5000) y frontend (puerto 3000)
.\stop.bat	Detiene todos los servicios
.\restart.bat	Reinicia ambos servicios
.\status.bat	Verifica estado de los servicios

---

🧪 Testing

cd server
npm run test:flow

Ejecuta 6 casos de prueba automatizados que validan:

• Detección de tipos de eventos
• Parseo de fechas en español
• Extracción de presupuestos y ubicaciones
• Manejo de restricciones alimentarias y accesibilidad
• Generación de planes completos

Ver detalles en TESTING.md

---

🎯 Funcionamiento

Conversación en 3 Fases

1️⃣ Descubrimiento (5 preguntas básicas)

• Tipo de evento
• Cantidad de invitados
• Fecha del evento
• Presupuesto disponible
• Ubicación

2️⃣ Personalización (detalles específicos)

• Temática/estilo
• Restricciones alimentarias
• Necesidades de accesibilidad
• Nivel de experiencia

3️⃣ Plan Completo (8 secciones)

1. Resumen Ejecutivo
2. Cronograma de Planificación
3. Presupuesto Detallado
4. Proveedores Recomendados
5. Lista de Compras/Materiales
6. Gestión de Invitados
7. Checklist Día del Evento
8. Plan B (Contingencias)

---

🛠️ Tecnologías

Frontend

• React 18
• Axios
• CSS3

Backend

• Node.js 20 + Express 4.18
• chrono-node (parseo de fechas)
• Sistema conversacional basado en reglas

Sin dependencias de IA externa - 100% determinístico y predecible

---

📂 Estructura

eventAI_v01/
├── client/              # Frontend React
│   ├── src/
│   │   ├── components/
│   │   ├── services/
│   │   └── App.js
│   └── package.json
│
├── server/              # Backend Node.js
│   ├── src/
│   │   ├── controllers/
│   │   ├── routes/
│   │   └── app.js
│   ├── scripts/
│   │   └── manualFlowTest.js
│   └── package.json
│
├── reference_docs/      # Documentación adicional
├── start.bat           # Iniciar todo
├── stop.bat            # Detener todo
└── README.md

---

⚙️ Configuración

Crear archivo .env en carpeta server/:

PORT=5000
FRONTEND_URL=http://localhost:3000
BOT_NAME=EventAI Assistant
LOG_LEVEL=info

---

🎯 Eventos Soportados

• 🎂 Cumpleaños (infantiles y adultos)
• 👨‍👩‍👧‍👦 Reuniones Familiares
• 🎓 Graduaciones
• 💒 Bodas/Casamientos
• 🎉 Fiestas Temáticas

---

📊 Detección Inteligente

El sistema detecta automáticamente:

• Fechas: "22 de diciembre", "el próximo viernes", "la semana que viene"
• Cantidades: "15 niños", "seremos 40", "entre 80 y 100"
• Presupuesto: "$60000", "sesenta mil pesos"
• Ubicaciones: "Nueva Córdoba", "en mi casa", "Cerro de las Rosas"
• Restricciones: celíaco, vegetariano, vegano, diabético
• Accesibilidad: silla de ruedas, rampa, movilidad reducida

---

📚 Documentación

• Testing: TESTING.md - Guía completa de pruebas
• Casos de Uso: reference_docs/TEST_FLOWS_NO_OLLAMA.md
• API Health: http://localhost:5000/api/chat/health

---

🐛 Troubleshooting

Puerto ocupado

.\stop.bat
.\start.bat

Reinstalar dependencias

cd server && npm install
cd ..\client && npm install

Ver estado

.\status.bat

---

👤 Autor

Proyecto Integrador - ISPC Módulos

---

📄 Licencia

MIT