iatoolkit 0.71.4__py3-none-any.whl → 1.4.2__py3-none-any.whl

iatoolkit/locales/es.yaml

@@ -1,163 +1,294 @@
-    # locales/es.yaml
-    ui:
-      login_widget:
-        title: "Iniciar Sesión"
-        welcome_message: "Ingresa tus credenciales o registrate para acceder a la plataforma IA de Sample Company."
-        email_placeholder: "Correo electrónico"
-        login_button: "Acceder"
-        forgot_password_link: "¿Olvidaste tu contraseña?"
-        no_account_prompt: "¿No tienes una cuenta?"
-        signup_link: "Regístrate"
-
-      signup:
-        title: "Crear una Cuenta"
-        subtitle: "Comienza tu viaje con nosotros hoy."
-        first_name_label: "Nombre"
-        last_name_label: "Apellido"
-        email_label: "Correo Electrónico"
-        password_label: "Contraseña"
-        confirm_password_label: "Confirmar Contraseña"
-        signup_button: "Crear Cuenta"
-        already_have_account: "¿Ya tienes una cuenta?"
-        login_link: "Inicia Sesión"
-        disclaimer: "🔒 Valoramos tu privacidad. Tus datos se usarán exclusivamente para el funcionamiento de la plataforma."
-
-      forgot_password:
-        title: "Recuperar Contraseña"
-        subtitle: "Ingresa tu correo electrónico y te enviaremos un enlace para restablecer tu contraseña."
-        submit_button: "Enviar Enlace de Recuperación"
-        back_to_login: "Volver a Iniciar Sesión"
-
-      change_password:
-        title: "Crear Nueva Contraseña"
-        subtitle: "Estás cambiando la contraseña para <strong>{email}</strong>."
-        temp_code_label: "Código Temporal"
-        temp_code_placeholder: "Revisa tu correo electrónico"
-        new_password_label: "Nueva Contraseña"
-        password_instructions: "Debe contener al menos 8 caracteres, mayúscula, minúscula, número y un carácter especial."
-        confirm_password_label: "Confirmar Nueva Contraseña"
-        save_button: "Guardar Contraseña"
-        back_to_home: "Volver al inicio"
-
-      chat:
-        welcome_message: "¡Hola! ¿En qué te puedo ayudar hoy?"
-        input_placeholder: "Escribe tu consulta aquí..."
-        prompts_available: "Prompts disponibles"
-
-      tooltips:
-        history: "Historial con mis consultas"
-        reload_context: "Forzar Recarga de Contexto"
-        feedback: "Tu feedback es muy importante"
-        usage_guide: "Guía de Uso"
-        onboarding: "Cómo preguntar mejor"
-        logout: "Cerrar sesión"
-        use_prompt_assistant: "Usar Asistente de Prompts"
-        attach_files: "Adjuntar archivos"
-        view_attached_files: "Ver archivos adjuntos"
-      modals:
-        files_title: "Archivos Cargados"
-        feedback_title: "Tu Opinión es Importante"
-        feedback_prompt: "¿Qué tan útil fue la respuesta del asistente?"
-        feedback_comment_label: "Tu comentario nos ayuda a mejorar:"
-        feedback_comment_placeholder: "Escribe aquí tu opinión, sugerencias o comentarios..."
-        history_title: "Historial de Consultas"
-        history_table_date: "Fecha"
-        history_table_query: "Consulta"
-        loading_history: "Cargando historial..."
-        no_history_found: "No se encontró historial de consultas."
-        help_title: "Guía de uso del Asistente IA"
-
-      buttons:
-        cancel: "Cerrar"
-        send: "Enviar"
-        stop: "Detener"
-
-    errors:
-      company_not_found: "La empresa {company_short_name} no existe."
-      timeout: "El tiempo de espera ha expirado."
-
-
-      auth:
-        invalid_password: "La contraseña proporcionada es incorrecta."
-        user_not_found: "No se encontró un usuario con ese correo."
-        invalid_or_expired_token: "Token inválido o expirado."
-        session_creation_failed: "No se pudo crear la sesión del usuario."
-        authentication_required: "Autenticación requerida. No se proporcionó cookie de sesión o clave de API."
-        invalid_api_key: "Clave de API inválida o inactiva."
-        no_user_identifier_api: "No se proporcionó user_identifier para la llamada a la API."
-      templates:
-        company_not_found: "Empresa no encontrada."
-        home_template_not_found: "La plantilla de la página de inicio para la empresa '{company_short_name}' no está configurada."
-        processing_error: "Error al procesar el template: {error}"
-        template_not_found: "No se encontro el template: '{template_name}'."
-
-      general:
-        unexpected_error: "Ha ocurrido un error inesperado: {error}."
-        unsupported_language: "El idioma seleccionado no es válido."
-      signup:
-        company_not_found: "La empresa {company_short_name} no existe."
-        incorrect_password_for_existing_user: "La contraseña para el usuario {email} es incorrecta."
-        user_already_registered: "El usuario con email '{email}' ya existe en esta empresa."
-        password_mismatch: "Las contraseñas no coinciden. Por favor, inténtalo de nuevo."
-      change_password:
-        token_expired: "El enlace de cambio de contraseña ha expirado. Por favor, solicita uno nuevo."
-        password_mismatch: "Las contraseñas no coinciden. Por favor, inténtalo nuevamente."
-        invalid_temp_code: "El código temporal no es válido. Por favor, verifica o solicita uno nuevo."
-      forgot_password:
-        user_not_registered: "El usuario con correo {email} no está registrado."
-      verification:
-        token_expired: "El enlace de verificación ha expirado. Por favor, contacta a soporte si necesitas uno nuevo."
-        user_not_found: "El usuario que intentas verificar no existe."
-      validation:
-        password_too_short: "La contraseña debe tener al menos 8 caracteres."
-        password_no_uppercase: "La contraseña debe tener al menos una letra mayúscula."
-        password_no_lowercase: "La contraseña debe tener al menos una letra minúscula."
-        password_no_digit: "La contraseña debe tener al menos un número."
-        password_no_special_char: "La contraseña debe tener al menos un carácter especial."
-
-      services:
-        no_text_file: "El archivo no es texto o la codificación no es UTF-8"
-        no_output_file: "falta el nombre del archivo de salida"
-        no_data_for_excel: "faltan los datos  o no es una lista de diccionarios"
-        no_download_directory: "no esta configurado el directorio temporal para guardar excels"
-        cannot_create_excel: "no se pudo crear el archivo excel"
-        invalid_filename: "Nombre de archivo inválido"
-        file_not_exist : "Archivo no encontrado"
-        path_is_not_a_file : "La ruta no corresponde a un archivo"
-        file_validation_error : "Error validando archivo"
-        user_not_authorized: "Usuario no esta autorizado para esta empresa"
-        account_not_verified: "Tu cuenta no ha sido verificada. Por favor, revisa tu correo."
-        missing_response_id: "No se encontró 'previous_response_id' para '{company_short_name}/{user_identifier}'. Reinicia el contexto."
-
-    api_responses:
-      context_reloaded_success: "El contexto se ha recargado con éxito."
-
-    services:
-      mail_sent: "mail enviado exitosamente."
-      start_query: "Hola, cual es tu pregunta?"
-
-    flash_messages:
-      password_changed_success: "Tu contraseña ha sido restablecida exitosamente. Ahora puedes iniciar sesión."
-      signup_success: "Registro exitoso. Por favor, revisa tu correo para verificar tu cuenta."
-      user_associated_success: "Usuario existente asociado exitosamente a la nueva empresa."
-      account_verified_success: "Tu cuenta ha sido verificada exitosamente. ¡Bienvenido!"
-      forgot_password_success: "Si tu correo está registrado, recibirás un enlace para restablecer tu contraseña."
-
-    # Claves específicas para JavaScript
-    js_messages:
-      feedback_sent_success_title: "Feedback Enviado"
-      feedback_sent_success_body: "¡Gracias por tu comentario!"
-      feedback_sent_error: "No se pudo enviar el feedback, por favor intente nuevamente."
-      feedback_rating_error: "Por favor, califica al asistente con las estrellas."
-      feedback_comment_error: "Por favor, escribe tu comentario antes de enviar."
-      context_reloaded: "El contexto ha sido recargado."
-      error_loading_history: "Ocurrió un error al cargar el historial."
-      request_aborted: "La generación de la respuesta ha sido detenida."
-      processing_error: "Ocurrió un error al procesar la solicitud."
-      server_comm_error: "Error de comunicación con el servidor ({status}). Por favor, intente de nuevo más tarde."
-      network_error: "Ocurrió un error de red. Por favor, inténtalo de nuevo en unos momentos."
-      unknown_server_error: "Error desconocido del servidor."
-      loading: "Cargando..."
-      reload_init: "Iniciando recarga de contexto en segundo plano..."
-      no_history_found: "No existe historial de consultas."
+# locales/es.yaml
+ui:
+  login_widget:
+    title: "Iniciar Sesión"
+    welcome_message: "Ingresa tus credenciales o registrate para acceder a la plataforma."
+    email_placeholder: "Correo electrónico"
+    login_button: "Acceder"
+    forgot_password_link: "¿Olvidaste tu contraseña?"
+    no_account_prompt: "¿No tienes una cuenta?"
+    signup_link: "Regístrate"
+
+  signup:
+    title: "Crear una Cuenta"
+    subtitle: "Comienza tu viaje con nosotros hoy."
+    first_name_label: "Nombre"
+    last_name_label: "Apellido"
+    email_label: "Correo Electrónico"
+    password_label: "Contraseña"
+    confirm_password_label: "Confirmar Contraseña"
+    signup_button: "Crear Cuenta"
+    already_have_account: "¿Ya tienes una cuenta?"
+    login_link: "Inicia Sesión"
+    disclaimer: "🔒 Valoramos tu privacidad. Tus datos se usarán exclusivamente para el funcionamiento de la plataforma."
+
+  forgot_password:
+    title: "Recuperar Contraseña"
+    subtitle: "Ingresa tu correo electrónico y te enviaremos un enlace para restablecer tu contraseña."
+    submit_button: "Enviar Enlace de Recuperación"
+    back_to_login: "Volver a Iniciar Sesión"
+
+  change_password:
+    title: "Crear Nueva Contraseña"
+    subtitle: "Estás cambiando la contraseña para <strong>{email}</strong>."
+    temp_code_label: "Código Temporal"
+    temp_code_placeholder: "Revisa tu correo electrónico"
+    new_password_label: "Nueva Contraseña"
+    password_instructions: "Debe contener al menos 8 caracteres, mayúscula, minúscula, número y un carácter especial."
+    confirm_password_label: "Confirmar Nueva Contraseña"
+    save_button: "Guardar Contraseña"
+    back_to_home: "Volver al inicio"
+
+  chat:
+    welcome_message: "¡Hola! ¿En qué te puedo ayudar hoy?"
+    input_placeholder: "Escribe aquí..."
+    prompts_available: "Prompts disponibles"
+    init_context: "Inicializando el contexto de la IA ..."
+
+  admin:
+    workspace: "Recursos"
+    configuration: "Configuración"
+    company_config: "Configuración Empresa (company.yaml)"
+    knowledge: "Conocimiento"
+    knowledge_rag: "RAG (Vectorial)"
+    knowledge_static: "Contenido Estático"
+    prompts: "Prompts"
+    prompts_description: "Prompts de sistema"
+    schemas: "Schemas"
+    schemas_description: "Definiciones de entidades"
+    context: "Contexto"
+    context_description: "Contenido estatico (Markdown)"
+    administration: "Administración"
+    monitoring: "Monitoreo"
+    teams: "Usuarios"
+    billing: "Facturación"
+    company: "Empresa"
+    files: "Archivos"
+    select_file: "Seleccione un archivo a editar"
+    select_category: "Seleccione una categoría"
+    editing: "Editando"
+    no_file_selected: "Seleccione un archivo"
+    new: "Nuevo"
+    confirm: "Confirmar"
+    cancel: "Cancelar"
+    new_file: "Nuevo archivo"
+    delete_file: "Borrar archivo"
+    rename_file: "Renombrar archivo"
+    save_file: "Guardar"
+    credentials: "Email y password son requeridos."
+    saved_ok: "Guardado correctamente"
+    deleted_ok: "Eliminado correctamente"
+    company: "Empresa"
+    admin_page_title: "Acceso de administración"
+    user_manager: "Administración de usuarios"
+    load_configuration: "Guardar configuración"
+    goto_chat: "Ir al chat"
+    logout: "Cerrar sesión"
+
+  rag:
+    ingestion: "Ingesta"
+    ingestion_description: "Ingestar documentos en la base de conocimiento."
+    workbench: "Area de trabajo"
+    documents: "Documentos"
+    retrieval_lab: "Laboratorio de recuperación"
+    retrieval_description: "Probar la búsqueda semántica y la recuperación de contexto."
+    query_placeholder: "Introduce una pregunta para consultar la base de conocimiento..."
+    search_button: "Buscar"
+    filter: "Filtrar"
+    search_results_title: "Listo para probar"
+    search_results_description: "Los resultados aparecerán aquí"
+    filename: "Nombre de archivo"
+    filename_placeholder: "Contiene..."
+    user: "Usuario"
+    status: "Estado"
+    all_status: "Todos los estados"
+    status_active: "Activo"
+    status_pending: "Pendiente"
+    status_processing: "Procesando"
+    status_failed: "Fallido"
+    created_at: "Creado"
+    date_range: "Rango de fechas"
+    delete_confirmation: "¿Eliminar archivo?"
+    delete_message: "Esta acción no se puede deshacer. El archivo se eliminará permanentemente."
+    delete_button: "Eliminar"
+    delete_cancel: "Cancelar"
+
+
+  tooltips:
+    history: "Historial con mis consultas"
+    reload_context: "Forzar Recarga de Contexto"
+    feedback: "Tu feedback es muy importante"
+    usage_guide: "Guía de Uso"
+    onboarding: "Cómo preguntar mejor"
+    preferences: "Preferencias"
+    logout: "Cerrar sesión"
+    use_prompt_assistant: "Usar Asistente de Prompts"
+    attach_files: "Adjuntar archivos"
+    view_attached_files: "Ver archivos adjuntos"
+  modals:
+    files_title: "Archivos Cargados"
+    feedback_title: "Tu Opinión es Importante"
+    feedback_prompt: "¿Qué tan útil fue la respuesta del asistente?"
+    feedback_comment_label: "Tu comentario nos ayuda a mejorar:"
+    feedback_comment_placeholder: "Escribe aquí tu opinión, sugerencias o comentarios..."
+    history_title: "Historial de Consultas"
+    history_table_date: "Fecha"
+    history_table_query: "Consulta"
+    loading_history: "Cargando historial..."
+    no_history_found: "No se encontró historial de consultas."
+    help_title: "Guía de uso del Asistente IA"
+
+  buttons:
+    cancel: "Cerrar"
+    send: "Enviar"
+    stop: "Detener"
+
+errors:
+  company_not_found: "La empresa {company_short_name} no existe."
+  timeout: "El tiempo de espera ha expirado."
+
+
+  auth:
+    invalid_password: "La contraseña proporcionada es incorrecta."
+    user_not_found: "No se encontró un usuario con ese correo."
+    invalid_or_expired_token: "Token inválido o expirado."
+    session_creation_failed: "No se pudo crear la sesión del usuario."
+    authentication_required: "Autenticación requerida. No se proporcionó cookie de sesión o clave de API."
+    invalid_api_key: "Clave de API inválida o inactiva."
+    no_user_identifier_api: "No se proporcionó user_identifier para la llamada a la API."
+    no_company_permissions: "No tiene permisos para administrar esta empresa."
+    api_key_name_required: "el parametro api_key_name es requerido."
+
+  templates:
+    company_not_found: "Empresa no encontrada."
+    home_template_not_found: "La plantilla de la página de inicio para la empresa '{company_short_name}' no está configurada."
+    processing_error: "Error al procesar el template: {error}"
+    template_not_found: "No se encontro el template: '{template_name}'."
+
+  general:
+    unexpected_error: "Ha ocurrido un error inesperado: {error}."
+    unsupported_language: "El idioma seleccionado no es válido."
+  signup:
+    company_not_found: "La empresa {company_short_name} no existe."
+    incorrect_password_for_existing_user: "La contraseña para el usuario {email} es incorrecta."
+    user_already_registered: "El usuario con email '{email}' ya existe en esta empresa."
+    password_mismatch: "Las contraseñas no coinciden. Por favor, inténtalo de nuevo."
+  change_password:
+    token_expired: "El enlace de cambio de contraseña ha expirado. Por favor, solicita uno nuevo."
+    password_mismatch: "Las contraseñas no coinciden. Por favor, inténtalo nuevamente."
+    invalid_temp_code: "El código temporal no es válido. Por favor, verifica o solicita uno nuevo."
+  forgot_password:
+    user_not_registered: "El usuario con correo {email} no está registrado."
+  verification:
+    token_expired: "El enlace de verificación ha expirado. Por favor, contacta a soporte si necesitas uno nuevo."
+    user_not_found: "El usuario que intentas verificar no existe."
+  validation:
+    password_too_short: "La contraseña debe tener al menos 8 caracteres."
+    password_no_uppercase: "La contraseña debe tener al menos una letra mayúscula."
+    password_no_lowercase: "La contraseña debe tener al menos una letra minúscula."
+    password_no_digit: "La contraseña debe tener al menos un número."
+    password_no_special_char: "La contraseña debe tener al menos un carácter especial."
+
+  services:
+    no_text_file: "El archivo no es texto o la codificación no es UTF-8"
+    no_output_file: "falta el nombre del archivo de salida"
+    no_data_for_excel: "faltan los datos  o no es una lista de diccionarios"
+    no_download_directory: "no esta configurado el directorio temporal para guardar excels"
+    cannot_create_excel: "no se pudo crear el archivo excel"
+    invalid_filename: "Nombre de archivo inválido"
+    file_not_exist : "Archivo no encontrado"
+    path_is_not_a_file : "La ruta no corresponde a un archivo"
+    file_validation_error : "Error validando archivo"
+    user_not_authorized: "Usuario no esta autorizado para esta empresa"
+    account_not_verified: "Tu cuenta no ha sido verificada. Por favor, revisa tu correo."
+    missing_response_id: "No se encontró 'previous_response_id' para '{company_short_name}/{user_identifier}'. Reinicia el contexto."
+    context_rebuild_failed: "No se pudo reconstruir el contexto de la empresa."
+    cannot_read_excel: "No se pudo leer el archivo excel"
+    cannot_read_csv: "No se pudo leer el archivo CSV"
+
+
+api_responses:
+  context_reloaded_success: "El contexto se ha recargado con éxito."
+
+services:
+  mail_sent: "mail enviado exitosamente."
+  start_query: "Hola, cual es tu pregunta?"
+  mail_change_password: "se envio mail para cambio de clave"
+
+rag:
+  ingestion:
+    duplicate: "El documento '{filename}' ya existe para la empresa '{company_short_name}'. Omitiendo ingesta."
+    failed: "Error al ingerir el documento: {error}"
+    processing_failed: "El procesamiento falló: {error}"
+    empty_text: "El texto extraído está vacío."
+  search:
+    query_required: "La consulta (query) es obligatoria."
+    company_not_found: "Empresa '{company_short_name}' no encontrada."
+  management:
+    delete_success: "Documento eliminado."
+    not_found: "Documento no encontrado."
+    action_not_found: "Acción '{action}' no encontrada."
+
+flash_messages:
+  password_changed_success: "Tu contraseña ha sido restablecida exitosamente. Ahora puedes iniciar sesión."
+  signup_success: "Registro exitoso. Por favor, revisa tu correo para verificar tu cuenta."
+  signup_success_no_verification: "Registro exitoso."
+  user_associated_success: "Usuario existente asociado exitosamente a la nueva empresa."
+  account_verified_success: "Tu cuenta ha sido verificada exitosamente. ¡Bienvenido!"
+  forgot_password_success: "Si tu correo está registrado, recibirás un enlace para restablecer tu contraseña."
+
+# Claves específicas para JavaScript
+js_messages:
+  feedback_sent_success_title: "Feedback Enviado"
+  feedback_sent_success_body: "¡Gracias por tu comentario!"
+  feedback_sent_error: "No se pudo enviar el feedback, por favor intente nuevamente."
+  feedback_rating_error: "Por favor, califica al asistente con las estrellas."
+  feedback_comment_error: "Por favor, escribe tu comentario antes de enviar."
+  context_reloaded: "El contexto ha sido recargado."
+  error_loading_history: "Ocurrió un error al cargar el historial."
+  request_aborted: "La generación de la respuesta ha sido detenida."
+  processing_error: "Ocurrió un error al procesar la solicitud."
+  server_comm_error: "Error de comunicación con el servidor ({status}). Por favor, intente de nuevo más tarde."
+  network_error: "Ocurrió un error de red. Por favor, inténtalo de nuevo en unos momentos."
+  unknown_server_error: "Error desconocido del servidor."
+  loading: "Cargando..."
+  reload_init: "Iniciando recarga de contexto en segundo plano..."
+  no_history_found: "No existe historial de consultas."
+  example: "Ejemplo:"
+  show_reasoning: "Ver razonamiento"
+  unsaved: "Modificado (no guardado)"
+  saved_ok: "Archivo guadado correctamente"
+  error_saving: "Error al guardar archivo"
+  select_file: "Seleccione un archivo de la lista"
+  no_file_selected: "No hay archivo seleccionado"
+  select_company: "Seleccione empresa"
+  file_created: "Archivo creado correctamente"
+  delete_ok: "Archivo eliminado correctamente"
+  delete_failed: "Error al eliminar archivo"
+  rename_ok: "Archivo renombrado correctamente"
+  not_saved: 'No puede guardar'
+  invalid_file_name: "Nombre de archivo no válido. Usa solo letras, números, guiones bajos, guiones y puntos."
+  config_loaded: "Configuración cargada correctamente."
+  config_load_error: "Error cargando confguración."
+  search_placeholder: "Buscar usuarios..."
+  showing: "Mostrando"
+  records: "Registros"
+  db_user: "Usuario"
+  db_role: "Rol"
+  db_verified: "Verificado"
+  db_collection: "Colección"
+  db_last_access: "ultimo acceso"
+  db_filename: "Nombre de archivo"
+  db_user: "Usuario"
+  db_status: "Estado"
+  db_created: "Creado"
+  editor_no_file_selected: "No hay archivo seleccionado"
+  error_loading: "Error cargando el contenido del archivo"
+  cant_load_company: "No puede cargarcompany.yaml"
+  config_saved: "Configuración guardada correctamente."
+  config_error: "Error guardando configuración"
+
+
+
+
 

iatoolkit/repositories/database_manager.py

@@ -4,24 +4,37 @@
 # IAToolkit is open source software.
 
 # database_manager.py
-from sqlalchemy import create_engine, event, inspect
+from sqlalchemy import create_engine, event, inspect, text
 from sqlalchemy.orm import sessionmaker, scoped_session
 from sqlalchemy.engine.url import make_url
 from iatoolkit.repositories.models import Base
 from injector import inject
 from pgvector.psycopg2 import register_vector
+from iatoolkit.common.interfaces.database_provider import DatabaseProvider
 
 
-class DatabaseManager:
+class DatabaseManager(DatabaseProvider):
     @inject
-    def __init__(self, database_url: str, register_pgvector: bool = True):
+    def __init__(self,
+                 database_url: str,
+                 schema: str = 'public',
+                 register_pgvector: bool = True):
         """
         Inicializa el gestor de la base de datos.
         :param database_url: URL de la base de datos.
+        :param schema: Esquema por defecto para la conexión (search_path).
         :param echo: Si True, habilita logs de SQL.
         """
+
+        self.schema = schema
+
+        # FIX HEROKU: replace postgres:// by postgresql:// for compatibility with SQLAlchemy 1.4+
+        if database_url and database_url.startswith("postgres://"):
+            database_url = database_url.replace("postgres://", "postgresql://", 1)
+
         self.url = make_url(database_url)
-        if database_url.startswith('sqlite'):       # for tests
+
+        if database_url.startswith('sqlite'):
             self._engine = create_engine(database_url, echo=False)
         else:
             self._engine = create_engine(
@@ -40,9 +53,30 @@ class DatabaseManager:
                                            expire_on_commit=False)
         self.scoped_session = scoped_session(self.SessionFactory)
 
-        # REGISTRAR pgvector para cada nueva conexión solo en postgres
-        if register_pgvector and self.url.get_backend_name() == 'postgresql':
-            event.listen(self._engine, 'connect', self.on_connect)
+        # Register pgvector for each new connection
+        backend = self.url.get_backend_name()
+        if backend == 'postgresql' or backend == 'postgres':
+            if register_pgvector:
+                event.listen(self._engine, 'connect', self.on_connect)
+
+            # if there is a schema, configure the search_path for each connection
+            if self.schema:
+                event.listen(self._engine, 'checkout', self.set_search_path)
+
+    def set_search_path(self, dbapi_connection, connection_record, connection_proxy):
+        # Configure the search_path for this connection
+        cursor = dbapi_connection.cursor()
+
+        # The defined schema is first, and then public by default
+        try:
+            cursor.execute(f"SET search_path TO {self.schema}, public")
+            cursor.close()
+
+            # commit for persist the change in the session
+            dbapi_connection.commit()
+        except Exception:
+            # if failed, rollback to avoid invalidating the connection
+            dbapi_connection.rollback()
 
     @staticmethod
     def on_connect(dbapi_connection, connection_record):
@@ -58,10 +92,13 @@ class DatabaseManager:
     def get_connection(self):
         return self._engine.connect()
 
-    def get_engine(self):
-        return self._engine
-
     def create_all(self):
+        # if there is a schema defined, make sure it exists before creating tables
+        backend = self.url.get_backend_name()
+        if self.schema and (backend == 'postgresql' or backend == 'postgres'):
+            with self._engine.begin() as conn:
+                conn.execute(text(f"CREATE SCHEMA IF NOT EXISTS {self.schema}"))
+
         Base.metadata.create_all(self._engine)
 
     def drop_all(self):
@@ -70,34 +107,67 @@ class DatabaseManager:
     def remove_session(self):
         self.scoped_session.remove()
 
+    # -- execution methods ----
+
+    def execute_query(self, query: str, commit: bool = False) -> list[dict] | dict:
+        """
+        Implementation for Direct SQLAlchemy connection.
+        """
+        session = self.get_session()
+        if self.schema:
+            session.execute(text(f"SET search_path TO {self.schema}"))
+
+        result = session.execute(text(query))
+        if commit:
+            session.commit()
+
+        if result.returns_rows:
+            # Convert SQLAlchemy rows to list of dicts immediately
+            cols = result.keys()
+            return [dict(zip(cols, row)) for row in result.fetchall()]
+
+        return {'rowcount': result.rowcount}
+
+    def commit(self):
+        self.get_session().commit()
+
+    def rollback(self):
+        self.get_session().rollback()
+
+    # -- schema methods ----
     def get_all_table_names(self) -> list[str]:
         # Returns a list of all table names in the database
         inspector = inspect(self._engine)
-        return inspector.get_table_names()
+        return inspector.get_table_names(schema=self.schema)
 
-    def get_table_schema(self,
-                         table_name: str,
-                         schema_name: str | None = None,
-                         exclude_columns: list[str] | None = None) -> str:
+    def get_table_description(self,
+                              table_name: str,
+                              schema_object_name: str | None = None,
+                              exclude_columns: list[str] | None = None) -> str:
         inspector = inspect(self._engine)
 
-        if table_name not in inspector.get_table_names():
-            raise RuntimeError(f"Table '{table_name}' does not exist.")
+        # search the table in the specified schema
+        if table_name not in inspector.get_table_names(schema=self.schema):
+            raise RuntimeError(f"Table '{table_name}' does not exist in database schema '{self.schema}'.")
 
         if exclude_columns is None:
             exclude_columns = []
 
-        # get all thre table columns
-        columns = inspector.get_columns(table_name)
+        # get all the table columns
+        columns = inspector.get_columns(table_name, schema=self.schema)
 
         # construct a json dictionary with the table definition
         json_dict = {
             "table": table_name,
-            "description": f"Definición de la tabla {table_name}.",
+            "schema": self.schema,
+            "description": f"The table belongs to the **`{self.schema}`** schema.",
             "fields": []
         }
-        if schema_name:
-            json_dict["description"] += f"Los detalles de cada campo están en el objeto **`{schema_name}`**."
+
+        if schema_object_name:
+            json_dict["description"] += (
+                f"The meaning of each field in this table is detailed in the **`{schema_object_name}`** object."
+            )
 
         # now add every column to the json dictionary
         for col in columns: