[2025] CURSO DE ODOO 18 FRAMEWORK BACKEND PROFESIONAL

SESIÓN GRATUITA

ÚNETE A LA COMUNIDAD EN DICORD

Objetivos de la Sesión:

• Aprender a desarrollar habilidades como programador en Odoo.
• Incrementar ingresos vendiendo aplicaciones desarrolladas.
• Obtener reconocimiento en la comunidad Odoo publicando aplicaciones.
• Proveer acceso al código fuente de la aplicación desarrollada para mejoras y monetización.

Módulo a Desarrollar: "Reclamaciones Web" (Libro de Reclamaciones Digital)

• Contexto y Necesidad: Cumplir con la normativa peruana de Indecopi, que exige a las empresas contar con un formulario web para proteger los derechos de los consumidores.
• Funcionalidades Clave del Módulo:
  • Formulario web público: Para que los consumidores registren sus reclamos.
  • Gestión interna de reclamos: Desde el back office, para que administradores visualicen y gestionen reclamos (lista, vista Kanban, tablero, búsqueda).
  • Secuencia automática: Código único de identificación para cada reclamo.
  • Notificación automática: Envío de correos al consumidor y a la empresa tras el registro.
  • Configuración de parámetros: Designación de un responsable y ajuste del plazo de atención (ej., 30 días por Indecopi, ajustable a 7 o 15 días).
  • Reporte en PDF: Formato estandarizado con datos del cliente y reclamo.
  • Automatización de envío de correos de constancia: Envío automático minutos después del registro.
  • Soporte multi-compañía: Permite a cada compañía ver solo sus reclamos si hay múltiples sitios web en Odoo.
• Demostración del Módulo Existente: Se muestra el módulo ya desarrollado y funcionando, con vistas Kanban, ajustes de prioridad, y el flujo de registro automatizado con Selenium IDE para pruebas rápidas.

Preparación del Entorno de Desarrollo Odoo:

• Creación de dos instancias de Odoo en paralelo (ej. puertos 8069 y 8065): una como ejemplo/referencia y otra para el desarrollo desde cero.
• Configuración de odoo.conf y launch.json para gestionar las instancias y bases de datos.
• Habilitación de live reload para Python y XML en desarrollo.
• Eliminación de módulos existentes en la instancia de desarrollo para empezar de cero.

Tópicos Técnicos de Desarrollo en Odoo:

1. Creación de Módulos (Aplicaciones):

   • Estructura básica: Una carpeta con un archivo __manifest__.py (manifiesto).
   • Atributos del manifiesto: name, version, author, depends (dependencias como base, base_setup, mail, l10n_pe).
   • Uso de .gitignore para excluir carpetas como __pycache__.
   • Actualización del módulo para que Odoo lo reconozca.

2. Modelo de Datos (models):

   • Creación de la carpeta models y archivos __init__.py.
   • Definición de un nuevo modelo (clase Python) y su relación con tablas en PostgreSQL (ORM).
   • Importación de models y fields del ORM de Odoo.
   • Creación de campos principales: name (código del reclamo).
   • Tipos de Campos y su Uso:
     • Char (texto): Para nombres, números, alfanuméricos.
     • Selection (selección): Para estados (state: 'nuevo', 'en progreso', 'cancelado', 'resuelto'), prioridades (priority: 'baja', 'media', 'alta', 'muy alta').
     • Many2one (relaciones): Para vincular el reclamo con modelos nativos de Odoo como res.company (compañía) y res.users (usuario responsable).
     • Date (fecha) y Datetime (fecha y hora): Para fechas de venta o auditoría.
     • Float (número real): Para montos, con control de dígitos decimales.
     • Text (texto largo): Para descripciones con saltos de línea.
     • Boolean: Para indicar si el consumidor es menor de edad.
     • Many2one a modelos de localización (l10n_pe): Para países (res.country), departamentos (res.country.state), provincias (res.city), distritos.
   • Atributos de Campos: string (etiqueta), default (valor por defecto), read_only, force_save, no_open, no_create, no_edit.
   • tracking=True: Para activar el seguimiento de cambios en el Chatter.
   • mail.thread y mail.activity.mixin: Extensión de modelos para habilitar el Chatter (seguimiento de mensajes, notas, actividades).

3. Vistas (views):

   • Creación de la carpeta views y archivos .xml para las vistas.
   • Acciones de ventana (ir.actions.act_window): Definen qué modelo se abrirá y qué vistas se usarán (ej., list, form).
   • Menús (ir.ui.menu): Enlazan acciones de ventana y organizan la navegación (parent, sequence).
   • Vista de Lista (list/tree): Define las columnas a mostrar (field name).
   • Vista de Formulario (form):
     • Organización de campos con group, sheet, notebook, page.
     • Widget: Para cambiar la presentación de los campos (ej., statusbar para state, priority para estrellas, boolean_toggle para booleanos).
     • Atributos Condicionales (attrs): invisible, required, readonly basados en otros campos (ej., tipo de consumidor, estado del reclamo).
     • Options horizontal: Para mostrar selection horizontalmente.
     • Placeholder: Texto de ejemplo en campos de entrada.
     • Domain: Filtrar campos relacionados (ej., provincias por departamento seleccionado, distritos por provincia).
     • Botones de Acción: Ejecutan métodos Python del modelo (type="object") para cambiar estados (ej., "En proceso", "Cancelar", "Resolver").
   • Chatter: Se agrega con la etiqueta <div class="oe_chatter"> al final de la vista de formulario.

4. Permisos de Acceso y Seguridad (security):

   • Reglas de acceso (ir.model.access.xml): Definen los permisos CRUD (Crear, Leer, Actualizar, Eliminar) sobre los modelos para diferentes grupos.
   • Grupos de seguridad (res.groups, ir.module.category): Creación de roles (ej., "Administrador" de Libro de Reclamaciones) y categorías para organizarlos en la interfaz.
   • Asignación de grupos a menús: Restringir el acceso a menús específicos a ciertos grupos de usuarios.
   • Restricción de métodos Python: Validar si el usuario pertenece a un grupo específico antes de ejecutar una acción (ej., solo administradores pueden cancelar un reclamo).
   • Restricción de elementos de vista (groups atributo): Ocultar botones o campos para usuarios que no pertenecen a un grupo específico, mejorando la experiencia de usuario.

5. Manejo de Múltiples Compañías (Multi-company):

   • Reglas de registro (ir.rule): Aplicar filtros globales para que cada compañía solo vea sus propios registros (ej., company_id in user.company_ids).
   • Secuencias por compañía: Configurar la generación de números de reclamo (ir.sequence) para que sean independientes por compañía.

6. Secuencias Automáticas (ir.sequence):

   • Sobrecarga del método create del modelo para generar y asignar un código único (ej., "LR00001") al nuevo registro.
   • Lógica: Buscar secuencia existente por compañía; si no existe, crearla dinámicamente con un prefijo, tamaño y paso definidos.

7. Reportes de Impresión en PDF (report):

   • Acción de Reporte (ir.actions.report): Define el reporte (nombre, modelo, tipo, plantilla HTML, nombre de archivo de exportación) y su visibilidad en el menú "Imprimir".
   • Plantillas de Reporte (template): Contenido HTML del PDF, usando la estructura web.html_container y el iterador t-foreach="docs" para procesar múltiples registros.
   • Visualización Rápida: Uso de URL para previsualizar el PDF o HTML directamente durante el desarrollo.
   • Formato de Papel (ir.ui.view_paperformat): Define márgenes y tamaño de hoja.

8. Plantillas de Correo Electrónico (mail.template):

   • Creación de la plantilla (record con modelo mail.template).
   • Definición de Campos: model_id (modelo al que aplica), subject (asunto dinámico), email_from (remitente), email_to (destinatario), email_cc (copia), reply_to (responder a).
   • Contenido Dinámico: Uso de object.campo (ej., object.consumer_name) para insertar datos del registro en el cuerpo del correo, incluyendo firmas HTML de usuarios (t-out="object.claim_user_id.signature").
   • Adjuntar Reportes: Vincular el reporte PDF creado previamente a la plantilla de correo.
   • Atributos para HTML: Uso de entidades HTML para caracteres especiales (ej., é).

9. Automatizaciones (base.automation / ir.actions.server):

   • Reglas de Automatización: Configurar un evento (ej., "Después de crear" un registro de reclamo) para disparar una acción.
   • Acciones de Servidor (ir.actions.server): Ejecutan una acción específica (ej., "Enviar correo electrónico") usando una plantilla de correo definida.
   • Retraso en la Ejecución: Posibilidad de configurar un tiempo de espera (ej., 2 minutos) antes de ejecutar la acción.

10. Controladores Web (controllers):

    • Creación de la carpeta controllers y archivos .py.
    • Definición de Rutas (@http.route): Para crear URL públicas (ej., /libro_reclamaciones).
    • Renderizado de Plantillas HTML: Uso de request.render para mostrar contenido dinámico en la web.
    • website_layout: Wrapper que incluye el encabezado, pie de página y estilos de Odoo en la plantilla web.
    • Manejo de Peticiones GET y POST: Para recibir y procesar datos del formulario web.
    • Protección CSRF: Inclusión de un token para validar que los datos provienen del mismo servidor.
    • Manejo de Datos y Errores: Recibir los datos del formulario (args), rellenar el formulario con los datos enviados en caso de error, y mostrar mensajes de validación.
    • Validación de Datos en Backend: Implementar una función para validar los campos obligatorios del formulario antes de procesar.
    • Procesamiento y Guardado: Función para limpiar y guardar los datos del formulario web en el modelo de Odoo.
    • Redirección: Redirigir al usuario a una página de confirmación (request.redirect) después de enviar el formulario.
    • Plantillas Dinámicas: Uso de t-set para definir variables dentro de la plantilla HTML y t-value o t-esc para imprimir valores dinámicos.

11. Interactividad Frontend con JavaScript:

    • Inclusión de archivos JavaScript en el manifiesto (assets en __manifest__.py).
    • Uso de public_widget de Odoo para crear funcionalidad JavaScript.
    • Eventos change: Para interactuar con campos del formulario (ej., ocultar/mostrar secciones de empresa/persona natural, filtrar departamentos/provincias/distritos).
    • Peticiones RPC (Remote Procedure Call): Para llamar a servicios Python desde JavaScript y obtener datos dinámicos (ej., lista de provincias o distritos filtrados).

Publicación en Odoo Apps:

• Preparación del Manifiesto: Completar con support, license, website, summary, category, price, currency, images (banner principal).
• Contenido de Marketing: Crear un index.html descriptivo con capturas de pantalla en static/description/.
• Repositorio GitHub: Crear un repositorio público con la versión específica de Odoo como rama (ej., 18.0).
• Proceso de Subida: Registrar el repositorio en apps.odoo.com y escanear la aplicación.
• Consideraciones: Manejo de tildes y caracteres especiales en HTML.

Este temario abarca la creación de una aplicación Odoo completa, desde la conceptualización hasta la publicación, cubriendo aspectos tanto de backend (Python, ORM, seguridad) como de frontend (HTML, JavaScript, plantillas web) y gestión de proyectos (control de versiones, automatización).

• Creación de consultas SQL para reportes personalizados

• Integración de consultas SQL en Odoo

• Diseño de vistas pivot avanzadas

• Visualización de datos con gráficos dinámicos

• Introducción a las APIs en Odoo

• Configuración del API JSON-RPC en Odoo

• Autenticación y seguridad en las llamadas API

• Consumo de datos desde aplicaciones externas

• Creación de endpoints personalizados

• Pruebas y depuración de integraciones API
  

• Configuración de una instancia EC2 en AWS

• Instalación y configuración de Odoo en AWS

• Configuración de bases de datos y almacenamiento

• Implementación de medidas de seguridad en el servidor

• Configuración de dominios y SSL para Odoo

• Pruebas de rendimiento y escalabilidad en AWS
  

• Introducción a GitHub Actions para CI/CD

• Configuración de workflows para despliegue automático

• Integración de pruebas automatizadas en el pipeline

• Despliegue continuo en el servidor AWS EC2

• Monitoreo y gestión de pipelines de CI/CD

• Mejores prácticas para la automatización de despliegues