feat: Implement JSON-based conversational flow engine

This commit introduces a modular, JSON-driven conversational flow engine.

Key changes:
- Adds `talia_bot/modules/flow_engine.py` to manage loading and processing conversational flows from external files.
- Separates all conversational logic into individual JSON files within `talia_bot/data/flows/`, organized by user role (admin, crew, client).
- Updates `talia_bot/main.py` to use the new flow engine, replacing the previous hardcoded logic with a dynamic dispatcher.
- Corrects the `.gitignore` file to properly track the new JSON flow files while ensuring sensitive credentials like `google_key.json` remain ignored.
- Updates the `README.md` to reflect the new architecture, providing clear documentation for the modular flow system.

This new architecture makes the bot more maintainable and scalable by decoupling the conversation logic from the core application code.

.gitignore

@@ -158,7 +158,6 @@ cython_debug/
 .vscode/
 
 # Google Service Account Credentials
-*.json
 !credentials.example.json
 google_key.json
 

README.md

@@ -32,7 +32,9 @@ El sistema sigue un flujo modular:
 
 ---
 
-## 📋 Flujos de Trabajo (Features)
+## 📋 Flujos de Trabajo Modulares (Features)
+
+El comportamiento del bot se define a través de **flujos de conversación modulares** gestionados por un motor central (`flow_engine.py`). Cada flujo es un archivo `.json` independiente ubicado en `talia_bot/data/flows/`, lo que permite modificar o crear nuevas conversaciones sin alterar el código principal.
 
 ### 1. 👑 Gestión Admin (Proyectos & Identidad)
 
@@ -118,10 +120,11 @@ IMAP_SERVER=imap.hostinger.com
 
 ### 3. Estructura de Datos
 
-Asegúrate de tener los archivos base en `talia_bot/data/`:
+Asegúrate de tener los archivos y directorios base en `talia_bot/data/`:
 *   `servicios.json`: Catálogo de servicios para el RAG de ventas.
 *   `credentials.json`: Credenciales de Google Cloud.
-*   `users.db`: Base de datos SQLite.
+*   `users.db`: Base de datos SQLite que almacena los roles de los usuarios.
+*   `flows/`: Directorio que contiene las definiciones de los flujos de conversación en formato JSON. Cada archivo representa una conversación completa para un rol específico.
 
 ---
 
@@ -130,10 +133,11 @@ Asegúrate de tener los archivos base en `talia_bot/data/`:
 ```text
 talia_bot_mg/
 ├── talia_bot/
-│   ├── main.py              # Entry Point y Router de Identidad
+│   ├── main.py              # Entry Point y dispatcher principal
-│   ├── db.py                # Gestión de la base de datos
+│   ├── db.py                # Gestión de la base de datos SQLite
 │   ├── config.py            # Carga de variables de entorno
 │   ├── modules/
+│   │   ├── flow_engine.py   # Motor de flujos de conversación (lee los JSON)
 │   │   ├── identity.py      # Lógica de Roles y Permisos
 │   │   ├── llm_engine.py    # Cliente OpenAI/Gemini
 │   │   ├── vikunja.py       # API Manager para Tareas
@@ -141,7 +145,8 @@ talia_bot_mg/
 │   │   ├── printer.py       # SMTP/IMAP Loop
 │   │   └── sales_rag.py     # Lógica de Ventas y Servicios
 │   └── data/
-│       ├── servicios.json   # Base de conocimiento
+│       ├── flows/           # Directorio con los flujos de conversación en JSON
+│       ├── servicios.json   # Base de conocimiento para ventas
 │       ├── credentials.json # Credenciales de Google
 │       └── users.db         # Base de datos de usuarios
 ├── .env.example             # Plantilla de variables de entorno

talia_bot/data/flows/admin_block_agenda.json

@@ -0,0 +1,25 @@
+{
+  "id": "admin_block_agenda",
+  "role": "admin",
+  "trigger_button": "🛑 Bloquear Agenda",
+  "steps": [
+    {
+      "step_id": 0,
+      "variable": "BLOCK_DATE",
+      "question": "Necesito bloquear la agenda. ¿Para cuándo?",
+      "options": ["Hoy", "Mañana"]
+    },
+    {
+      "step_id": 1,
+      "variable": "BLOCK_TIME",
+      "question": "Dame el horario exacto que necesitas bloquear (ej. 'de 2pm a 4pm').",
+      "input_type": "text"
+    },
+    {
+      "step_id": 2,
+      "variable": "BLOCK_TITLE",
+      "question": "Finalmente, dame una breve descripción o motivo del bloqueo.",
+      "input_type": "text"
+    }
+  ]
+}

talia_bot/data/flows/admin_check_agenda.json

@@ -0,0 +1,19 @@
+{
+  "id": "admin_check_agenda",
+  "role": "admin",
+  "trigger_button": "📅 Revisar Agenda",
+  "steps": [
+    {
+      "step_id": 0,
+      "variable": "AGENDA_TIMEFRAME",
+      "question": "Consultando el oráculo del tiempo... ⏳",
+      "options": ["📅 Hoy", "🔮 Mañana"]
+    },
+    {
+      "step_id": 1,
+      "variable": "AGENDA_ACTION",
+      "question": "Aquí tienes tu realidad: {CALENDAR_DATA}",
+      "options": ["✅ Todo bien", "🛑 Bloquear Espacio"]
+    }
+  ]
+}

talia_bot/data/flows/admin_create_nfc_tag.json

@@ -0,0 +1,25 @@
+{
+  "id": "admin_create_nfc_tag",
+  "role": "admin",
+  "trigger_button": "➕ Crear Tag NFC",
+  "steps": [
+    {
+      "step_id": 0,
+      "variable": "NFC_ACTION_TYPE",
+      "question": "Creemos un nuevo tag NFC. ¿Qué acción quieres que dispare?",
+      "options": ["Iniciar Flujo", "URL Estática"]
+    },
+    {
+      "step_id": 1,
+      "variable": "NFC_FLOW_CHOICE",
+      "question": "Okay, ¿qué flujo debería iniciar este tag?",
+      "input_type": "dynamic_keyboard_flows"
+    },
+    {
+      "step_id": 2,
+      "variable": "NFC_CONFIRM",
+      "question": "Perfecto. Cuando acerques tu teléfono a este tag, se iniciará el flujo '{flow_name}'. Aquí tienes los datos para escribir en el tag: {NFC_DATA}",
+      "options": ["✅ Hecho"]
+    }
+  ]
+}

talia_bot/data/flows/admin_idea_capture.json

@@ -0,0 +1,25 @@
+{
+  "id": "admin_idea_capture",
+  "role": "admin",
+  "trigger_button": "💡 Capturar Idea",
+  "steps": [
+    {
+      "step_id": 0,
+      "variable": "IDEA_CONTENT",
+      "question": "Te escucho. 💡 Las ideas vuelan...",
+      "input_type": "text_or_audio"
+    },
+    {
+      "step_id": 1,
+      "variable": "IDEA_CATEGORY",
+      "question": "¿En qué cajón mental guardamos esto?",
+      "options": ["💰 Negocio", "📹 Contenido", "👤 Personal"]
+    },
+    {
+      "step_id": 2,
+      "variable": "IDEA_ACTION",
+      "question": "¿Cuál es el plan de ataque?",
+      "options": ["✅ Crear Tarea", "📓 Guardar Nota"]
+    }
+  ]
+}

talia_bot/data/flows/admin_print_file.json

@@ -0,0 +1,13 @@
+{
+  "id": "admin_print_file",
+  "role": "admin",
+  "trigger_button": "🖨️ Imprimir",
+  "steps": [
+    {
+      "step_id": 0,
+      "variable": "UPLOAD_FILE",
+      "question": "Por favor, envíame el archivo que quieres imprimir.",
+      "input_type": "document"
+    }
+  ]
+}

talia_bot/data/flows/admin_project_management.json

@@ -0,0 +1,31 @@
+{
+  "id": "admin_project_management",
+  "role": "admin",
+  "trigger_button": "🏗️ Ver Proyectos",
+  "steps": [
+    {
+      "step_id": 0,
+      "variable": "PROJECT_SELECT",
+      "question": "Aquí está el tablero de ajedrez...",
+      "input_type": "dynamic_keyboard_vikunja_projects"
+    },
+    {
+      "step_id": 1,
+      "variable": "TASK_SELECT",
+      "question": "Has seleccionado el proyecto {project_name}. ¿Qué quieres hacer?",
+      "input_type": "dynamic_keyboard_vikunja_tasks"
+    },
+    {
+      "step_id": 2,
+      "variable": "ACTION_TYPE",
+      "question": "¿Cuál es la jugada?",
+      "options": ["🔄 Actualizar Estatus", "💬 Agregar Comentario"]
+    },
+    {
+      "step_id": 3,
+      "variable": "UPDATE_CONTENT",
+      "question": "Adelante. Soy todo oídos.",
+      "input_type": "text_or_audio"
+    }
+  ]
+}

talia_bot/data/flows/client_sales_funnel.json

@@ -0,0 +1,25 @@
+{
+  "id": "client_sales_funnel",
+  "role": "client",
+  "trigger_automatic": true,
+  "steps": [
+    {
+      "step_id": 0,
+      "variable": "CLIENT_NAME",
+      "question": "Hola. Soy Talia, la mano derecha de Armando. ✨Él está ocupado creando, pero yo soy la puerta de entrada. ¿Con quién tengo el gusto?",
+      "input_type": "text"
+    },
+    {
+      "step_id": 1,
+      "variable": "CLIENT_INDUSTRY",
+      "question": "Mucho gusto, {user_name}. Para entender mejor tus necesidades, ¿cuál es el giro de tu negocio o tu industria?",
+      "options": ["🍽️ Restaurantes", "🩺 Salud", "🛍️ Retail", "อื่น ๆ"]
+    },
+    {
+      "step_id": 2,
+      "variable": "IDEA_PITCH",
+      "question": "Excelente. Ahora, el escenario es tuyo. 🎤 Cuéntame sobre tu proyecto o la idea que tienes en mente. No te guardes nada. Puedes escribirlo o, si prefieres, enviarme una nota de voz.",
+      "input_type": "text_or_audio"
+    }
+  ]
+}

talia_bot/data/flows/crew_print_file.json

@@ -0,0 +1,13 @@
+{
+  "id": "crew_print_file",
+  "role": "crew",
+  "trigger_button": "🖨️ Imprimir",
+  "steps": [
+    {
+      "step_id": 0,
+      "variable": "UPLOAD_FILE",
+      "question": "Claro, envíame el archivo que necesitas imprimir y yo me encargo.",
+      "input_type": "document"
+    }
+  ]
+}

talia_bot/data/flows/crew_request_time.json

@@ -0,0 +1,31 @@
+{
+  "id": "crew_request_time",
+  "role": "crew",
+  "trigger_button": "📅 Solicitar Agenda",
+  "steps": [
+    {
+      "step_id": 0,
+      "variable": "REQUEST_TYPE",
+      "question": "Para usar la agenda del estudio, necesito que seas preciso.",
+      "options": ["🎥 Grabación", "🎙️ Locución", "🎬 Edición", "🛠️ Mantenimiento"]
+    },
+    {
+      "step_id": 1,
+      "variable": "REQUEST_DATE",
+      "question": "¿Para cuándo necesitas el espacio?",
+      "options": ["Hoy", "Mañana", "Esta Semana"]
+    },
+    {
+      "step_id": 2,
+      "variable": "REQUEST_TIME",
+      "question": "Dame el horario exacto que necesitas (ej. 'de 10am a 2pm').",
+      "input_type": "text"
+    },
+    {
+      "step_id": 3,
+      "variable": "REQUEST_JUSTIFICATION",
+      "question": "Entendido. Antes de confirmar, necesito que me expliques brevemente el plan o el motivo para justificar el bloqueo del espacio. Puedes escribirlo o enviarme un audio.",
+      "input_type": "text_or_audio"
+    }
+  ]
+}

talia_bot/data/flows/crew_secret_onboarding.json

@@ -0,0 +1,37 @@
+{
+  "id": "crew_secret_onboarding",
+  "role": "crew",
+  "trigger_command": "/abracadabra",
+  "steps": [
+    {
+      "step_id": 0,
+      "variable": "ONBOARD_START",
+      "question": "Vaya, vaya... Parece que conoces el comando secreto. 🎩. Antes de continuar, necesito saber tu nombre completo.",
+      "input_type": "text"
+    },
+    {
+      "step_id": 1,
+      "variable": "ONBOARD_ORIGIN",
+      "question": "Un placer, {user_name}. ¿Cuál es tu base de operaciones principal?",
+      "options": ["🏢 Office", "✨ Aura"]
+    },
+    {
+      "step_id": 2,
+      "variable": "ONBOARD_EMAIL",
+      "question": "Perfecto. Ahora necesito tu correo electrónico de la empresa.",
+      "input_type": "text"
+    },
+    {
+      "step_id": 3,
+      "variable": "ONBOARD_PHONE",
+      "question": "Y por último, tu número de teléfono.",
+      "input_type": "text"
+    },
+    {
+      "step_id": 4,
+      "variable": "ONBOARD_CONFIRM",
+      "question": "Gracias. He enviado una notificación al Administrador para que apruebe tu acceso. En cuanto lo haga, tendrás acceso completo. ¡Bienvenido a bordo!",
+      "options": ["✅ Entendido"]
+    }
+  ]
+}

talia_bot/data/services.json

@@ -0,0 +1,22 @@
+[
+  {
+    "service_name": "Web Development for Restaurants",
+    "description": "Custom websites and online ordering systems for restaurants, helping you reach more customers and streamline your operations.",
+    "keywords": ["restaurant", "food", "online ordering", "website", "restaurantes", "comida"]
+  },
+  {
+    "service_name": "Patient Management Systems for Healthcare",
+    "description": "A secure and efficient software solution for managing patient records, appointments, and billing in medical clinics.",
+    "keywords": ["healthcare", "medical", "patient", "clinic", "salud", "médico", "pacientes"]
+  },
+  {
+    "service_name": "Content Creation & Social Media Strategy",
+    "description": "Engaging content packages and social media management to build your brand's online presence and connect with your audience.",
+    "keywords": ["content creation", "social media", "marketing", "branding", "contenido", "redes sociales"]
+  },
+  {
+    "service_name": "General Business Consulting",
+    "description": "Strategic consulting to help you optimize business processes, identify growth opportunities, and improve overall performance.",
+    "keywords": ["business", "consulting", "strategy", "growth", "negocio", "consultoría"]
+  }
+]