Mantenova

En el sector industrial español, la gestión de inspecciones técnicas reglamentarias sigue dependiendo en gran medida de hojas de cálculo, correos electrónicos y llamadas telefónicas. Las empresas propietarias de instalaciones —naves industriales, centros de transformación, plantas fotovoltaicas, locales comerciales— deben cumplir con decenas de inspecciones periódicas con plazos legales: OCA cada 5 años, RITE anual, medición de tierras trienal, termografía, legionella, RIPCI...

Cuando estos plazos se gestionan manualmente, se producen retrasos, se pierden documentos, se duplican comunicaciones y se incumplen normativas. El coste no es solo económico: un certificado caducado puede paralizar una actividad o generar responsabilidades legales.

Mantenova nace de la observación directa de este problema en el sector eléctrico industrial.

Mantenova es una plataforma SaaS B2B que reúne, en un único sistema, a los dos lados del proceso:

• Empresas propietarias de instalaciones, que gestionan sus activos, solicitan inspecciones y conservan toda la documentación asociada.

• Empresas de inspección técnica, que gestionan a sus inspectores, definen las zonas en las que operan, y reciben, aceptan y completan inspecciones.

Sobre esta base, la plataforma aporta:

• Catálogo dinámico de 25 tipos de instalación y 34 tipos de inspección, con 120 combinaciones que reflejan qué inspecciones aplican a cada tipo de instalación y con qué periodicidad legal.

• Motor de alertas automáticas que avisa antes del vencimiento de cada inspección.

• Mensajería contextual vinculada a empresa, instalación o inspección concretas, para que la conversación siempre tenga referencia explícita.

• Gestión documental con versionado y metadatos preparados para firma digital cualificada.

• Catálogo de normativa técnica con enlaces directos a fuentes oficiales.

• PWA para acceso desde cualquier dispositivo, sin dependencia de tiendas de aplicaciones.

La V2 está construida sobre Django 5.1, Python 3.12, PostgreSQL 16, Redis 7 y Celery, todo orquestado con Docker Compose en tres entornos (dev, staging, prod). La API REST está documentada con OpenAPI/Swagger (drf-spectacular). El frontend se desarrolla sobre un design system propio (paleta, tipografía y tokens CSS) y se entrega como Progressive Web App.

Algunas decisiones de arquitectura que vale la pena destacar:

• Catálogos dinámicos, no enums hardcoded. Los tipos de instalación e inspección viven en la base de datos. Añadir un tipo nuevo no requiere migración de código ni despliegue: se hace desde el panel de administración.

• Un solo modelo de inspección + detalles solo donde aportan valor. En lugar de 34 modelos separados por tipo, hay un modelo único Inspeccion y solo 11 modelos de detalle para los tipos que necesitan campos extra (OCA, tierras, RITE, RSCIEI, presión, frigorífico, gases, APQ, grúa, legionella, estanqueidad).

• Empresa única con campo tipo (propietaria o inspección), no dos modelos paralelos: simplifica relaciones, reportes y permisos.

• Roles + overrides explícitos. Cinco roles definen el acceso por defecto; PermissionOverride permite ampliar accesos sobre recursos concretos sin tocar el modelo de roles. Los overrides amplían, nunca restringen.

• Lógica de negocio en services.py. Vistas y endpoints de API orquestan, no contienen lógica. Esto facilita testear cada operación de negocio de forma aislada.

• Firma digital preparada desde la Fase 1. Los modelos de documentos llevan metadatos de firma nullables desde el origen, para que la integración real con un proveedor cualificado (eIDAS) en la Fase 8 no obligue a reestructurar nada.

• Bilingüe desde el origen. django-modeltranslation para catálogos, normativa y contenido editable; templates con etiquetas {% trans %} y LocaleMiddleware.

• Testing obligatorio fase a fase. 215 tests pasando al cierre de la Fase 3, distribuidos entre modelos, lógica de negocio y API.

Mantenova V2 se desarrolla en ocho fases con criterios objetivos de finalización para cada una. Estado a fecha de publicación de esta ficha:

• Fase 0 — Infraestructura ✅ Completa. Docker Compose multi-entorno, configuración por entorno (base, dev, staging, prod, test), Dockerfile, Nginx, Gunicorn, Makefile estandarizado, GitHub Actions (ruff + pytest), Celery + Redis operativos, pytest con factories. 11 smoke tests pasando.

• Fase 1 — Modelos core ✅ Completa. 60 modelos en 14 apps Django, catálogos sembrados (25 tipos de instalación, 34 tipos de inspección, 120 combinaciones), modelos específicos por tipo, sistema de permisos base, mensajería, notificaciones (15 tipos), normativa, documentos con preparación para firma digital, internacionalización con django-modeltranslation. 43 tests pasando.

• Fase 2 — Lógica de negocio ✅ Completa. services.py por app con todas las operaciones de negocio (solicitar inspección, aceptar, rechazar, iniciar, completar, cancelar, calcular próxima, dar de baja instalación o inspector), managers personalizados, mixins de permisos para CBV, validaciones de transición de estado, señales de auditoría. 70 tests pasando.

• Fase 3 — API REST ✅ Completa. API documentada con OpenAPI/Swagger, autenticación, marketplace, endpoints alineados con los services. 91 tests pasando.

• Fase 4 — Vistas y templates 🔶 En curso. Cerrada la Parte 1: design system implementado en CSS (tokens, base, pages), plantillas base, vistas de autenticación, páginas públicas iniciales, conmutador de idioma. Pendientes: dashboards por rol, paneles CRUD por tipo de usuario, búsqueda marketplace, formularios completos, tests de vistas.

• Fase 5 — Tareas asíncronas ⏳ Pendiente. Carga periódica de noticias del sector, notificaciones automáticas de vencimiento, emails transaccionales, backups programados, generación de informes en PDF.

• Fase 6 — Despliegue a producción ⏳ Pendiente. Compose de producción endurecido, scripts de despliegue, SSL, monitorización, hardening de seguridad.

• Fase 7 — Firma digital y cumplimiento ⏳ Pendiente. Selección de proveedor (Viafirma, Signaturit, AutoFirma), integración con TSA para sello de tiempo, verificación de cumplimiento eIDAS, tests de firma y verificación. La arquitectura de datos está preparada desde la Fase 1 para que esta integración no obligue a reestructurar nada.