Overview The Asset Management module provides complete control over your facility’s physical assets, equipment, and technical locations. It supports hierarchical organization, interactive floor plans, QR code integration, and mobile access.
The assets module is the foundation for maintenance, inventory, and document management operations.
Key Features
Hierarchical Organization Organize assets in parent-child relationships with unlimited depth
Interactive Floor Plans Visualize asset locations on technical drawings with pin markers
QR Code Integration Generate and scan QR codes for rapid asset identification
Mobile Access Access asset information from mobile devices in the field
Import/Export Bulk operations with Excel import and export capabilities
Document Linking Associate technical documents, manuals, and drawings
Data Model Activo (Asset) The core entity representing physical equipment and facilities.
class Activo ( models . Model ): codigo_interno = models.CharField( max_length = 50 , unique = True ) descripcion = models.CharField( max_length = 255 ) epc = models.CharField( max_length = 50 , blank = True , null = True ) serie = models.CharField( max_length = 100 , blank = True , null = True ) # Hierarchy activo_padre = models.ForeignKey( 'self' , on_delete = models. SET_NULL , null = True , blank = True , related_name = 'activos_hijos' ) ubicacion = models.ForeignKey( 'Ubicacion' , on_delete = models. PROTECT ) # Classification categoria = models.ForeignKey( 'Categoria' , on_delete = models. SET_NULL ) familia = models.ForeignKey( 'Familia' , on_delete = models. SET_NULL ) marca = models.ForeignKey( 'Marca' , on_delete = models. SET_NULL ) modelo = models.ForeignKey( 'Modelo' , on_delete = models. SET_NULL ) # Status estado = models.CharField( max_length = 20 , choices = ESTADO_CHOICES ) responsable = models.ForeignKey(User, on_delete = models. SET_NULL ) # Technical data fecha_instalacion = models.DateField( blank = True , null = True ) peso = models.DecimalField( max_digits = 10 , decimal_places = 2 ) foto = models.ImageField( upload_to = 'activos/' , blank = True )
Ubicacion (Location) Hierarchical technical locations for organizing assets.
class Ubicacion ( models . Model ): codigo = models.CharField( max_length = 50 , unique = True ) nombre = models.CharField( max_length = 255 ) descripcion = models.TextField( blank = True ) # Hierarchy padre = models.ForeignKey( 'self' , on_delete = models. CASCADE , null = True , blank = True , related_name = 'hijos' ) # Type classification tipo = models.CharField( max_length = 20 , choices = TIPO_CHOICES ) # SITIO, EDIFICIO, AREA, SISTEMA, SUBSISTEMA # Display order orden = models.IntegerField( default = 0 )
Asset Hierarchy Tree Structure Assets are organized in a multi-level hierarchy:
Location Types
Top-level location representing the entire facility or plant.
Physical buildings or structures within the site.
Functional areas or zones within buildings.
Technical systems (electrical, HVAC, etc.).
Subsystems and equipment groups.
Interactive Floor Plans VisorPlano (Plan Viewer) Visual representation of assets on technical drawings.
class VisorPlano ( models . Model ): nombre = models.CharField( max_length = 100 ) ubicacion = models.ForeignKey( 'Ubicacion' , on_delete = models. CASCADE ) imagen_plano = models.ImageField( upload_to = 'planos/' ) orden = models.IntegerField( default = 0 )
PinPlano (Floor Plan Pins) Asset markers on floor plans with coordinates.
class PinPlano ( models . Model ): visor = models.ForeignKey( 'VisorPlano' , on_delete = models. CASCADE ) activo = models.ForeignKey( 'Activo' , on_delete = models. CASCADE ) # Coordinates (percentage) x = models.FloatField() # 0-100 y = models.FloatField() # 0-100 # Visual appearance icon = models.CharField( max_length = 50 , default = 'map-marker' ) color = ColorField( default = '#FF0000' )
QR Code Integration Generating QR Codes Assets automatically generate QR codes linking to their detail page:
def generar_qr ( self ): qr = qrcode.QRCode( version = 1 , box_size = 10 , border = 5 ) url = f " { settings. SITE_URL } /activos/ { self .codigo_interno } /" qr.add_data(url) qr.make( fit = True ) img = qr.make_image( fill_color = "black" , back_color = "white" ) return img
Mobile Scanner Scan QR codes to quickly access asset information:
// Scan QR code and navigate to asset detail const scanAsset = async () => { const result = await BarcodeScanner . scan (); if ( result . format === 'QR_CODE' ) { navigation . navigate ( 'AssetDetail' , { codigo: extractCodigoFromURL ( result . text ) }); } };
Import/Export Bulk asset import from Excel files:
codigo_interno, descripcion, ubicacion, categoria, estado, responsable EQ-001, "Main Transformer", SITE-01/ELEC, Electrical, OPERATIVO, admin EQ-002, "Backup Generator", SITE-01/ELEC, Electrical, STANDBY, admin EQ-003, "Cooling Tower 1", SITE-01/HVAC, HVAC, OPERATIVO, maint_user
Background Import Process Large imports are processed asynchronously with Celery:
@shared_task ( bind = True ) def import_activos_async ( self , file_id , user_id ): from activos.resources import ActivoResource registro = RegistroImportacion.objects.get( id = file_id) resource = ActivoResource() # Process in chunks dataset = Dataset().load(registro.archivo.read(), format = 'xlsx' ) total = len (dataset) for i, row in enumerate (dataset.dict): # Import each row resource.import_row(row) # Update progress self .update_state( state = 'PROGRESS' , meta = { 'current' : i + 1 , 'total' : total} ) registro.estado = 'COMPLETED' registro.save()
API Endpoints
Asset Search Search assets with filtering, pagination, and location hierarchy
Asset Details Retrieve complete asset information including related records
Floor Plan Pins Manage asset pins on interactive floor plans
Best Practices Naming Convention : Use consistent prefixes for asset codes (e.g., EQ- for equipment, SYS- for systems)
Parent-Child Relationships : Avoid circular references in asset hierarchy
QR Code Labels : Print QR code labels with asset codes for easy field identification
Maintenance Schedule work on assets
Documents Link technical documents
Inventory Track spare parts