Mantenova

In the Spanish industrial sector, the management of mandatory technical inspections still largely depends on spreadsheets, emails, and phone calls. Companies that own facilities — industrial warehouses, transformer stations, photovoltaic plants, commercial premises — must comply with dozens of periodic inspections with legal deadlines: OCA every 5 years, annual RITE, triennial ground measurement, thermography, legionella, RIPCI...

When these deadlines are managed manually, delays occur, documents get lost, communications are duplicated, and regulations go unmet. The cost isn't just financial: an expired certificate can halt operations or create legal liabilities.

Mantenova was born from direct observation of this problem in the industrial electrical sector.

Mantenova is a B2B SaaS platform that brings both sides of the process into a single system:

• Facility-owning companies, which manage their assets, request inspections, and store all associated documentation.

• Technical inspection firms, which manage their inspectors, define their operating zones, and receive, accept, and complete inspections.

On this foundation, the platform delivers:

• Dynamic catalog of 25 facility types and 34 inspection types, with 120 combinations reflecting which inspections apply to each facility type and at what legal periodicity.

• Automatic alert engine that notifies before each inspection expires.

• Contextual messaging linked to a specific company, facility, or inspection, so conversations always have explicit reference.

• Document management with versioning and metadata prepared for qualified digital signatures.

• Technical regulations catalog with direct links to official sources.

• PWA for access from any device, without dependence on app stores.

V2 is built on Django 5.1, Python 3.12, PostgreSQL 16, Redis 7, and Celery, all orchestrated with Docker Compose across three environments (dev, staging, prod). The REST API is documented with OpenAPI/Swagger (drf-spectacular). The frontend is built on a custom design system (palette, typography, and CSS tokens) and delivered as a Progressive Web App.

Some architectural decisions worth highlighting:

• Dynamic catalogs, not hardcoded enums. Facility and inspection types live in the database. Adding a new type requires no code migration or deployment: it is done from the admin panel.

• A single inspection model + detail tables only where they add value. Instead of 34 separate models per type, there is one Inspeccion model and only 11 detail models for the types that need extra fields (OCA, earthing, RITE, RSCIEI, pressure, refrigeration, gases, APQ, cranes, legionella, tightness).

• One Empresa model with a type field (owner or inspection), not two parallel models: simplifies relationships, reporting, and permissions.

• Roles + explicit overrides. Five roles define default access; PermissionOverride allows extending access on specific resources without touching the role model. Overrides extend, never restrict.

• Business logic in services.py. Views and API endpoints orchestrate, they do not hold logic. This makes each business operation testable in isolation.

• Digital signature prepared from Phase 1. Document models carry nullable signature metadata from the start, so the actual integration with a qualified provider (eIDAS) in Phase 8 requires no restructuring.

• Bilingual from the start. django-modeltranslation for catalogs, regulations, and editable content; templates with {% trans %} tags and LocaleMiddleware.

• Mandatory testing phase by phase. 215 tests passing at the close of Phase 3, distributed across models, business logic, and API.

Mantenova V2 is developed across eight phases with objective completion criteria for each one. Status as of this listing's publication:

• Phase 0 — Infrastructure ✅ Complete. Multi-environment Docker Compose, per-environment configuration (base, dev, staging, prod, test), Dockerfile, Nginx, Gunicorn, standardized Makefile, GitHub Actions (ruff + pytest), Celery + Redis operational, pytest with factories. 11 smoke tests passing.

• Phase 1 — Core models ✅ Complete. 60 models across 14 Django apps, seeded catalogs (25 facility types, 34 inspection types, 120 combinations), type-specific models, base permission system, messaging, notifications (15 types), regulations, documents with digital signature preparation, internationalization with django-modeltranslation. 43 tests passing.

• Phase 2 — Business logic ✅ Complete. Per-app services.py with all business operations (request inspection, accept, reject, start, complete, cancel, calculate next, deactivate facility or inspector), custom managers, permission mixins for CBVs, state transition validations, audit signals. 70 tests passing.

• Phase 3 — REST API ✅ Complete. API documented with OpenAPI/Swagger, authentication, marketplace, endpoints aligned with services. 91 tests passing.

• Phase 4 — Views and templates 🔶 In progress. Part 1 closed: design system implemented in CSS (tokens, base, pages), base templates, authentication views, initial public pages, language switcher. Pending: role-based dashboards, CRUD panels per user type, marketplace search, full forms, view tests.

• Phase 5 — Asynchronous tasks ⏳ Pending. Periodic loading of industry news, automatic expiry notifications, transactional emails, scheduled backups, PDF report generation.

• Phase 6 — Production deployment ⏳ Pending. Hardened production compose, deployment scripts, SSL, monitoring, security hardening.

• Phase 7 — Digital signature and compliance ⏳ Pending. Provider selection (Viafirma, Signaturit, AutoFirma), TSA integration for time-stamping, eIDAS compliance verification, signature and verification tests. The data architecture has been prepared since Phase 1 so this integration requires no restructuring.