Equipment Management

Overview

The Equipment module manages all physical assets including vehicles, sanitary equipment, water treatment plants, and storage tanks. Each item tracks its technical specifications, availability status, and certification requirements.

Resource Items

Equipment Types

Mantis supports a wide range of equipment types:

Sanitary Equipment

LVMNOS: Lavamanos (Handwashing stations)
BTSNHM: Batería sanitaria hombre (Men’s bathroom)
BTSNMJ: Batería sanitaria mujer (Women’s bathroom)
EST4UR: Estación cuádruple urinario (4-urinal station)
CMPRBN: Camper baño (Bathroom camper)

Treatment Plants

PTRTAP: Planta de tratamiento de agua potable (Drinking water)
PTRTAR: Planta de tratamiento de agua residual (Wastewater)

Storage Tanks

TNQAAC: Tanques de almacenamiento agua cruda (Raw water)
TNQAAR: Tanques de almacenamiento agua residual (Wastewater)

Services

SERVIC: Generic services (no physical equipment)

ResourceItem Model

The ResourceItem model provides flexible field management based on equipment type:

class ResourceItem(BaseModel):
    id = AutoField(primary_key=True)
    name = CharField(max_length=255)
    code = CharField(max_length=50, unique=True)
    type_equipment = CharField(
        max_length=255,
        choices=TYPE_EQUIPMENT  # LVMNOS, BTSNHM, etc.
    )
    brand = CharField(max_length=255)
    model = CharField(max_length=255)
    serial_number = CharField(max_length=255)
    date_purchase = DateField()
    
    # Dimensions
    height = PositiveSmallIntegerField()  # cm
    width = PositiveSmallIntegerField()   # cm
    depth = PositiveSmallIntegerField()   # cm
    weight = PositiveSmallIntegerField()  # kg
    capacity_gallons = DecimalField(max_digits=10, decimal_places=2)
    
    # Status tracking
    stst_status_equipment = CharField(
        choices=STATUS_EQUIPMENT,
        default='FUNCIONANDO'
    )
    stst_status_disponibility = CharField(
        choices=DISPONIBILITY_STATUS,
        default='DISPONIBLE'
    )
    stst_current_location = CharField(max_length=255)
    stst_current_project_id = SmallIntegerField()
    stst_commitment_date = DateField()
    stst_release_date = DateField()

Status Management

Equipment Status (Technical Condition)

FUNCIONANDO

Equipment is operational and ready for use

DAÑADO

Equipment is damaged and cannot operate

INCOMPLETO

Equipment is missing parts or accessories

EN REPARACION

Equipment is undergoing repair

Availability Status

DISPONIBLE

Available for rental or assignment to projects

RENTADO

Currently rented and assigned to a project

When stst_status_equipment = 'EN REPARACION', the stst_repair_reason field should document the reason for repair.

Equipment-Specific Features

Sanitary Equipment Fields

For bathroom and handwashing equipment, track component availability:

# Boolean fields for component tracking
have_foot_pumps = BooleanField(default=False)
have_paper_dispenser = BooleanField(default=False)
have_soap_dispenser = BooleanField(default=False)
have_napkin_dispenser = BooleanField(default=False)
have_paper_towels = BooleanField(default=False)
have_urinals = BooleanField(default=False)  # Men's bathrooms only
have_seat = BooleanField(default=False)
have_toilet_pump = BooleanField(default=False)
have_sink_pump = BooleanField(default=False)
have_toilet_lid = BooleanField(default=False)
have_bathroom_bases = BooleanField(default=False)
have_ventilation_pipe = BooleanField(default=False)

Treatment Plant Components

For water treatment plants (PTRTAP and PTRTAR):

Motor and Blower Components

engine_brand = CharField(max_length=255)
engine_model = CharField(max_length=255)
engine_fases = CharField(choices=[('1', '1 FASE'), ('2', '2 FASES'), ('3', '3 FASES')])
blower_brand = CharField(max_length=255)
blower_model = CharField(max_length=255)
have_engine = BooleanField(default=False)
have_blower_brand = BooleanField(default=False)

Belt and Pulley System

belt_brand = CharField(max_length=255)
belt_model = CharField(max_length=255)
belt_type = CharField(choices=[('A', 'A'), ('B', 'B')])
blower_pulley_brand = CharField(max_length=255)
blower_pulley_model = CharField(max_length=255)
motor_pulley_brand = CharField(max_length=255)
motor_pulley_model = CharField(max_length=255)
have_belt_brand = BooleanField(default=False)
have_blower_pulley = BooleanField(default=False)
have_motor_pulley = BooleanField(default=False)

Electrical and Control Systems

electrical_panel_brand = CharField(max_length=255)
electrical_panel_model = CharField(max_length=255)
engine_guard_brand = CharField(max_length=255)
engine_guard_model = CharField(max_length=255)
relay_engine = CharField(max_length=255)
relay_blower = CharField(max_length=255)
have_electrical_panel = BooleanField(default=False)
have_motor_guard = BooleanField(default=False)
have_relay_engine = BooleanField(default=False)
have_relay_blower = BooleanField(default=False)

Pumps and Filters (PTRTAP only)

pump_filter = CharField(max_length=255)
pump_pressure = CharField(max_length=255)
pump_dosing = CharField(max_length=255)
sand_carbon_filter = CharField(max_length=255)
hidroneumatic_tank = CharField(max_length=255)
uv_filter = CharField(max_length=255)
have_pump_filter = BooleanField(default=False)
have_pump_pressure = BooleanField(default=False)
have_pump_dosing = BooleanField(default=False)
have_sand_carbon_filter = BooleanField(default=False)
have_hidroneumatic_tank = BooleanField(default=False)
have_uv_filter = BooleanField(default=False)

Vehicle Management

Vehicle Model

Track company vehicles with certification and documentation:

class Vehicle(BaseModel):
    id = AutoField(primary_key=True)
    brand = CharField(max_length=255, default='SIN MARCA')
    model = CharField(max_length=255)
    type_vehicle = CharField(
        max_length=255,
        choices=[
            ('CAMION', 'CAMION'),
            ('VACUUM', 'VACUUM'),
            ('CAMIONETA', 'CAMIONETA'),
            ('PLATAFORMA', 'PLATAFORMA'),
            ('AUTO', 'AUTO')
        ]
    )
    year = IntegerField()
    no_plate = CharField(max_length=10, unique=True)
    status_vehicle = CharField(
        choices=[
            ('DISPONIBLE', 'DISPONIBLE'),
            ('EN MANTENIMIENTO', 'EN MANTENIMIENTO'),
            ('STANBY', 'STANBY')
        ],
        default='DISPONIBLE'
    )
    owner_transport = CharField(max_length=255, default='PEISOL')

Certification Tracking

Vehicles require multiple certifications with expiration dates:

Operating Certificate

date_cert_oper → due_date_cert_operStatus: status_cert_oper

Registration (Matrícula)

date_matricula → due_date_matricula

MTOP Authorization

date_mtop → due_date_mtop

Technical Review

date_technical_review → due_date_technical_review

Insurance Policy

insurance_issue_date → insurance_expiration_datePolicy: nro_polizaCompany: insurance_company

Satellite Tracking

date_satellite → due_date_satellite

Certification Status

The status_cert_oper field tracks operating certificate status:

VIGENTE: Valid and current
VENCIDO: Expired
NO APLICA: Not applicable
POR VENCER: Expiring soon
EN TRAMITE: In process
RECHAZADO: Rejected

Vehicle Documentation

Attach PDF documents for compliance:

poliza_file = FileField(
    upload_to='vehicles/polizas/',
    validators=[validate_pdf_file]
)
matricula_file = FileField(
    upload_to='vehicles/matriculas/',
    validators=[validate_pdf_file]
)
rev_tec_file = FileField(
    upload_to='vehicles/revisiones_tecnicas/',
    validators=[validate_pdf_file]
)
vehicle_image = ImageField(
    upload_to='vehicles/images/',
    validators=[validate_image_file]
)

Code Examples

Querying Equipment by Status

from equipment.models import ResourceItem

# Get all available equipment
available = ResourceItem.objects.filter(
    stst_status_disponibility='DISPONIBLE',
    stst_status_equipment='FUNCIONANDO',
    is_active=True
)

# Get equipment currently in repair
in_repair = ResourceItem.objects.filter(
    stst_status_equipment='EN REPARACION',
    is_active=True
)

# Get equipment by code
equipment = ResourceItem.get_by_code('BT-001')

Working with Equipment Fields

# Get fields specific to equipment type
equipment = ResourceItem.objects.get(code='BT-001')

# Access type-specific fields
all_fields = equipment.all_fields_for_type
boolean_fields = equipment.boolean_fields
specific_fields = equipment.specific_fields

# Get field value with display name
status_value = equipment.get_field_value('status')
status_label = equipment.get_field_label('stst_status_equipment')

# Get checklist items for inspection
checklist = equipment.present_have_fields

Best Practices

Status Updates

Update stst_status_disponibility when assigning equipment to projects
Set stst_current_project_id and stst_current_location when rented
Record stst_commitment_date when equipment goes out
Record stst_release_date when equipment returns

Certification Management

Monitor vehicle certification expiration dates
Update status_cert_oper based on due dates
Attach PDF documents for all certifications
Set up alerts for certifications expiring within 30 days

Equipment Maintenance

Mark equipment as ‘EN REPARACION’ when maintenance is needed
Document repair reason in stst_repair_reason
Update status to ‘FUNCIONANDO’ after repairs complete
Track replaced parts and service history

Component Tracking

Use boolean have_* fields to track component presence
Update checklist fields during equipment inspections
Document missing components before deployment
Track component brands and models for replacement parts

Projects

Assign equipment to project contracts

Maintenance

Schedule and track equipment maintenance

Reports

Generate equipment checklists and status reports

Custody Chains

Track equipment during field operations

Get Started

Core Features

User Guides

​Overview

​Resource Items

​Equipment Types

Sanitary Equipment

Treatment Plants

Storage Tanks

Services

​ResourceItem Model

​Status Management

​Equipment Status (Technical Condition)

FUNCIONANDO

DAÑADO

INCOMPLETO

EN REPARACION

​Availability Status

DISPONIBLE

RENTADO

​Equipment-Specific Features

​Sanitary Equipment Fields

​Treatment Plant Components

​Vehicle Management

​Vehicle Model

​Certification Tracking

Operating Certificate

Registration (Matrícula)

MTOP Authorization

Technical Review

Insurance Policy

Satellite Tracking

​Certification Status

​Vehicle Documentation

​Code Examples

​Querying Equipment by Status

​Working with Equipment Fields

​Best Practices

​Related Features

Projects

Maintenance

Reports

Custody Chains

Overview

Resource Items

Equipment Types

ResourceItem Model

Status Management

Equipment Status (Technical Condition)

Availability Status

Equipment-Specific Features

Sanitary Equipment Fields

Treatment Plant Components

Vehicle Management

Vehicle Model

Certification Tracking

Certification Status

Vehicle Documentation

Code Examples

Querying Equipment by Status

Working with Equipment Fields

Best Practices

Related Features