Bienvenido al portal de documentación para desarrolladores de TechStore Mantenimiento, un módulo personalizado de Odoo 18 diseñado para gestionar flujos de trabajo de mantenimientos técnicos, carga de trabajo de los técnicos, recepción y ciclo de vida de los equipos, y métricas de nivel de servicio (SLA).
Para profundizar en las especificaciones técnicas de cada componente, explore las guías detalladas a continuación:
- 📐 Arquitectura Técnica y Máquina de Estados Modelos lógicos, relaciones de base de datos, máquina de estados del ciclo de vida, integraciones de wizards para comentarios y el patch JS personalizado para el controlador de drag-and-drop en el Kanban.
- 🔒 Roles, Reglas de Acceso y Seguridad Jerarquía de grupos de seguridad (Técnico, Supervisor, Administrador), Listas de Control de Acceso (ACL CSV), reglas de registro para aislamiento y guardias de validación de Python/XML.
- 🛡️ Validaciones de Datos y Lógica de Negocio Algoritmo de validación de módulo 10 para la cédula ecuatoriana, formato de números telefónicos, campos requeridos para finalizar tickets y sincronización automática de estados de equipos.
- 📊 Métricas de Telemetría y Motor de Reportes
Fórmulas matemáticas para los cálculos de SLA, indicador de satisfacción del cliente, plantillas PDF de QWeb y el wizard para generación de Excel multi-pestaña mediante
xlsxwriter. - 🧪 Guía del Framework de Pruebas Unitarias Cobertura de la suite de pruebas unitarias (25 casos de prueba automatizados), configuración de entornos mock y comandos de terminal para ejecutar los tests dentro de contenedores Docker.
- 🌐 Traducciones y Localización
Directorios de i18n de Odoo, plantillas PO/POT y el script de utilidad para traducciones automáticas basado en diccionarios (
translate.py).
El repositorio incluye un stack de contenedores Docker preconfigurado con Odoo 18 y PostgreSQL 15.
Ejecute el siguiente comando desde el directorio raíz del proyecto:
docker-compose up -d- Interfaz web de Odoo: http://localhost:8069
- Puerto de PostgreSQL:
5432(accesible internamente dentro de la red Docker)
Los archivos de configuración se encuentran en el directorio config/:
- Archivo de configuración: config/odoo.conf
- Parámetros clave:
admin_passwd: Contraseña maestra para la gestión de bases de datos.db_host: Mapeado adb(nombre del servicio Postgres en la red Docker).db_user/db_password: Configurados comoodoo/odoo.addons_path: Configurado para incluir/mnt/extra-addons(que monta el directorio local./addons).
- Inicie sesión en Odoo en
http://localhost:8069usando las credenciales de administrador. - Vaya a Ajustes
$\to$ Ajustes Generales y active el Modo Desarrollador. - Diríjase a Aplicaciones
$\to$ haga clic en Actualizar lista de aplicaciones en el menú superior. - Busque
TechStore Mantenimiento(nombre técnico:techstore_maintenance). - Haga clic en Activar.
Si modificó código Python o vistas XML, puede forzar la actualización del módulo sin usar el navegador:
docker-compose exec odoo odoo -c /etc/odoo/odoo.conf -d odoo_db -u techstore_maintenance --stop-after-initA diferencia de JavaScript, Odoo carga y compila los modelos de Python en memoria al iniciar. Debe reiniciar el contenedor Docker de Odoo y actualizar el módulo para aplicar los cambios:
docker-compose restart odoo
docker-compose exec odoo odoo -c /etc/odoo/odoo.conf -d odoo_db -u techstore_maintenance --stop-after-initEl generador de PDF QWeb de Odoo utiliza la herramienta externa wkhtmltopdf. Esta requiere descargar los recursos CSS del servidor mediante enlaces absolutos. Asegúrese de que el parámetro del sistema web.base.url en Odoo esté configurado exactamente como http://localhost:8069 (o la URL de su servidor).
Los datos iniciales se cargan automáticamente desde los archivos CSV en addons/techstore_maintenance/data/ al instalar el módulo. Si desea volver a cargarlos, reconstruya la base de datos o ejecute:
docker-compose exec odoo odoo -c /etc/odoo/odoo.conf -d odoo_db -i techstore_maintenance --init