Equipment

Introduction

The Equipment module in Milexco provides a comprehensive system for managing exercise equipment, including tracking, assignment, maintenance, and storage. This feature enables exercise coordinators to effectively manage all equipment-related aspects of an exercise, from initial allocation to final return.

{info} For information about equipment metadata (types, identifiers, and models), see the Equipment Metadata documentation.

Key Features

  1. Equipment Management:

    • Create, view, update, and track equipment items
    • Categorize equipment by type, identifier, and model
    • Track equipment status and condition
    • Manage equipment storage locations

  2. Assignment System:

    • Assign equipment to participants or organizations
    • Track equipment assignments and returns
    • Record condition changes during assignments
    • Manage equipment handover processes

  3. Maintenance Tracking:

    • Schedule and track equipment maintenance
    • Record maintenance history
    • Monitor equipment condition
    • Set maintenance reminders

  4. Storage Management:

    • Track equipment storage locations
    • Manage equipment movement between locations
    • Monitor storage capacity

  5. Status Workflow:

    • Track equipment status (Fully Mission Capable, Partially Mission Capable, etc.)
    • Monitor equipment condition (Good, Fair, Poor)
    • Record status changes and history

Equipment Management

Overview

The Equipment Management module in Milexco provides comprehensive tools for tracking, managing, and maintaining equipment throughout military exercises. This guide covers the key features and workflows for equipment management.

{info} Equipment metadata (types, identifiers, and models) is managed separately in the Metadata section. See the Equipment Metadata documentation for details.

Equipment Status and Condition

Statuses

Equipment can be in one of the following statuses:

  • Fully Mission Capable: Equipment is operational and can perform all intended functions
  • Partially Mission Capable: Equipment can perform some but not all intended functions
  • Non Mission Capable: Equipment cannot perform any of its intended functions
  • In Maintenance: Equipment is currently undergoing repairs or scheduled service
  • Awaiting Parts: Equipment cannot be repaired due to missing components
  • In Transit: Equipment is being transported between locations
  • In Storage: Equipment is properly preserved and maintained while not in use
  • Training Use Only: Equipment is designated for training purposes only
  • Reserved: Equipment is allocated for a future mission or purpose
  • Deployed: Equipment is currently in use for operational mission

Conditions

Equipment conditions are tracked to assess their operational readiness:

  • Good: Equipment has normal wear but is well-maintained and reliable
  • Fair: Equipment shows noticeable wear but functions adequately
  • Poor: Equipment has significant wear and may have reliability issues
  • Out of Service: Equipment is not operational and requires maintenance

Status Transitions

Equipment status transitions follow specific rules with enhanced validation:

  1. In Storage

    • Can transition to: Fully Mission Capable, Partially Mission Capable, Non Mission Capable, In Maintenance, Awaiting Parts, In Transit, Training Use Only, Reserved, Deployed
    • System validates status changes automatically
    • Status-based tab visibility is enforced
    • Enhanced transition validation

  2. Fully Mission Capable

    • Can transition to: In Storage, Partially Mission Capable, Non Mission Capable, In Maintenance, Deployed
    • Assignment validation is required
    • Condition tracking is mandatory
    • Enhanced workflow validation

  3. Partially Mission Capable

    • Can transition to: In Storage, Fully Mission Capable, Non Mission Capable, In Maintenance
    • Maintenance records are required
    • Condition updates are tracked
    • Enhanced validation

  4. Non Mission Capable

    • Can transition to: In Storage, In Maintenance, Awaiting Parts
    • Documentation of issues is required
    • Return to service requires validation
    • Enhanced status handling

  5. In Maintenance

    • Can transition to: In Storage, Fully Mission Capable, Partially Mission Capable, Non Mission Capable, Awaiting Parts
    • Maintenance records are required
    • Condition updates are tracked
    • Enhanced validation

  6. Awaiting Parts

    • Can transition to: In Storage, In Maintenance, Non Mission Capable
    • Documentation of required parts is required
    • Enhanced status handling

  7. In Transit

    • Can transition to: In Storage, Fully Mission Capable, Deployed
    • Location tracking is required
    • Enhanced validation

  8. Training Use Only

    • Can transition to: In Storage, Fully Mission Capable, Partially Mission Capable, Non Mission Capable
    • Training designation validation
    • Enhanced status handling

  9. Reserved

    • Can transition to: In Storage, Fully Mission Capable, Deployed
    • Reservation validation
    • Enhanced status handling

  10. Deployed

    • Can transition to: In Storage, Fully Mission Capable, In Transit
    • Assignment validation is required
    • Enhanced workflow validation

Condition Requirements

Equipment conditions have specific requirements for different statuses:

  1. In Storage

    • Must be in Good or Fair condition

  2. Deployed

    • Must be in Good or Fair condition

  3. Maintenance

    • Can be in any condition

  4. Out of Service

    • Must be in Poor condition

Equipment Assignment

Equipment can be assigned to various entities:

  1. Assignment Rules

    • Equipment must be in a suitable condition and status for assignment
    • Equipment under maintenance cannot be assigned
    • Equipment awaiting parts cannot be assigned
    • Equipment in transit cannot be assigned
    • Equipment in storage can be assigned
    • Training use only equipment cannot be assigned
    • Reserved equipment can be assigned

  2. Assignment Types

    • Organizations: Assign to exercise organizations
    • Participants: Assign to individual participants
    • Countries: Assign to participating countries

      {info} For more information about country assignments, see the Exercise Countries documentation.

  3. Assignment Process

    • Select equipment for assignment
    • Choose the assignee (organization, participant, or country)
    • Set assignment duration
    • Record initial condition
    • System automatically updates status to Deployed

Maintenance Management

Maintenance is tracked through the following features:

  1. Maintenance Types

    • Preventive Maintenance
    • Corrective Maintenance
    • Scheduled Maintenance
    • Emergency Maintenance

  2. Maintenance Status

    • Scheduled
    • In Progress
    • Completed
    • Cancelled

  3. Maintenance Rules

    • Equipment under maintenance cannot be assigned
    • Equipment awaiting parts is tracked separately
    • Maintenance history is maintained

Equipment Tracking

The system provides comprehensive tracking capabilities:

  1. Location Tracking

    • Current location
    • Movement history
    • Assignment history

  2. Condition Tracking

    • Current condition
    • Condition history
    • Maintenance history

  3. Status Tracking

    • Current status
    • Status history
    • Assignment history

Reports and Analytics

The system provides various reports:

  1. Equipment Status Reports

    • Current status distribution
    • Status history
    • Condition distribution

  2. Maintenance Reports

    • Scheduled maintenance
    • Completed maintenance
    • Maintenance history

  3. Assignment Reports

    • Current assignments
    • Assignment history
    • Return history

Best Practices

  1. Regular Status Updates

    • Update equipment status regularly
    • Document status changes
    • Maintain accurate condition records

  2. Maintenance Scheduling

    • Schedule preventive maintenance
    • Track maintenance history
    • Document maintenance procedures

  3. Assignment Management

    • Verify equipment suitability before assignment
    • Document condition changes
    • Track assignment history

  4. Condition Monitoring

    • Regular condition assessments
    • Document condition changes
    • Schedule maintenance as needed

  5. Location Tracking

    • Update location information
    • Document movement history
    • Track assignment locations

Equipment Status

Equipment can be in one of the following statuses:

  • Fully Mission Capable: Equipment is operational and can perform all intended functions
  • Partially Mission Capable: Equipment can perform some but not all intended functions
  • Non Mission Capable: Equipment cannot perform any of its intended functions
  • In Maintenance: Equipment is currently undergoing repairs or scheduled service
  • Awaiting Parts: Equipment cannot be repaired due to missing components
  • In Transit: Equipment is being transported between locations
  • In Storage: Equipment is properly preserved and maintained while not in use
  • Training Use Only: Equipment is designated for training purposes only
  • Reserved: Equipment is allocated for a future mission or purpose
  • Deployed: Equipment is currently in use for operational mission

Status Transitions

Equipment status transitions follow specific rules with enhanced validation:

  1. In Storage

    • Can transition to: Fully Mission Capable, Partially Mission Capable, Non Mission Capable, In Maintenance, Awaiting Parts, In Transit, Training Use Only, Reserved, Deployed
    • System validates status changes automatically
    • Status-based tab visibility is enforced
    • Enhanced transition validation

  2. Fully Mission Capable

    • Can transition to: In Storage, Partially Mission Capable, Non Mission Capable, In Maintenance, Deployed
    • Assignment validation is required
    • Condition tracking is mandatory
    • Enhanced workflow validation

  3. Partially Mission Capable

    • Can transition to: In Storage, Fully Mission Capable, Non Mission Capable, In Maintenance
    • Maintenance records are required
    • Condition updates are tracked
    • Enhanced validation

  4. Non Mission Capable

    • Can transition to: In Storage, In Maintenance, Awaiting Parts
    • Documentation of issues is required
    • Return to service requires validation
    • Enhanced status handling

  5. In Maintenance

    • Can transition to: In Storage, Fully Mission Capable, Partially Mission Capable, Non Mission Capable, Awaiting Parts
    • Maintenance records are required
    • Condition updates are tracked
    • Enhanced validation

  6. Awaiting Parts

    • Can transition to: In Storage, In Maintenance, Non Mission Capable
    • Documentation of required parts is required
    • Enhanced status handling

  7. In Transit

    • Can transition to: In Storage, Fully Mission Capable, Deployed
    • Location tracking is required
    • Enhanced validation

  8. Training Use Only

    • Can transition to: In Storage, Fully Mission Capable, Partially Mission Capable, Non Mission Capable
    • Training designation validation
    • Enhanced status handling

  9. Reserved

    • Can transition to: In Storage, Fully Mission Capable, Deployed
    • Reservation validation
    • Enhanced status handling

  10. Deployed

    • Can transition to: In Storage, Fully Mission Capable, In Transit
    • Assignment validation is required
    • Enhanced workflow validation

Condition Requirements

Equipment conditions have specific requirements for different statuses:

  1. In Storage

    • Must be in Good or Fair condition

  2. Deployed

    • Must be in Good or Fair condition

  3. Maintenance

    • Can be in any condition

  4. Out of Service

    • Must be in Poor condition

Condition Tracking

Equipment condition is tracked using the following states:

  • Good: Equipment has normal wear but is well-maintained and reliable
  • Fair: Equipment shows noticeable wear but functions adequately
  • Poor: Equipment has significant wear and may have reliability issues
  • Out of Service: Equipment is not operational and requires maintenance

Condition is recorded:

  • When equipment is initially added
  • During assignments
  • After maintenance
  • Upon return

The condition of equipment is visually indicated using color-coded badges:

  • Green: Good condition
  • Yellow: Fair condition
  • Orange: Poor condition
  • Red: Out of Service

Equipment Assignments

Assigning Equipment

To assign equipment:

  1. Select the equipment from the list
  2. Click "Assign Equipment" from the actions menu
  3. Complete the assignment form:
    • Select Issuing Officer
    • Set Issue Date
    • Choose Recipient
    • Record Initial Condition
    • Add Notes (optional)
  4. Click Save to complete the assignment

Managing Assignments

To manage equipment assignments:

  1. View current assignments in the equipment detail view
  2. Edit assignment details if needed
  3. Track assignment history
  4. Monitor equipment condition during assignment

Returning Equipment

To return equipment:

  1. Select the assigned equipment
  2. Click "Return Equipment" from the actions menu
  3. Complete the return form:
    • Select Returning Officer
    • Set Return Date
    • Record Final Condition
    • Add Notes (optional)
  4. Click Save to complete the return

Equipment Maintenance

Scheduling Maintenance

To schedule equipment maintenance:

  1. Select the equipment
  2. Click "Schedule Maintenance" from the actions menu
  3. Complete the maintenance form:
    • Set Maintenance Date
    • Select Maintenance Type
    • Add Description
    • Set Priority
  4. Click Save to schedule maintenance

Maintenance Records

Maintenance records include:

  • Scheduled maintenance
  • Completed maintenance
  • Maintenance history
  • Condition changes
  • Notes and observations

Equipment Storage

Equipment storage management includes:

  1. Storage Locations:

    • Track where equipment is stored
    • Monitor storage capacity
    • Record location changes

  2. Storage Status:

    • Track equipment availability
    • Monitor storage conditions
    • Record storage history

  3. Location Management:

    • Add new storage locations
    • Update location details
    • Track location capacity

Troubleshooting

Common issues and solutions with enhanced error handling:

  1. Assignment Conflicts

    • System prevents overlapping assignments
    • Check existing assignments if unable to assign
    • Enhanced validation feedback

  2. Status Update Issues

    • Verify current status before making changes
    • Check status transition rules
    • Enhanced error messages

  3. Maintenance Scheduling

    • Ensure equipment is available for maintenance
    • Check maintenance history for conflicts
    • Improved validation

  4. Storage Location Issues

    • Verify location capacity
    • Check location availability
    • Enhanced error handling

{info} For additional support or specific issues, contact your system administrator or refer to the support documentation.

Data Management

The system enforces strict data integrity with enhanced validation:

  1. Required Fields

    • Equipment identifier type
    • Equipment identifier
    • Equipment identifier model
    • Serial number (unique)
    • Status
    • Condition
    • Owner (ownable)

  2. Validation Rules

    • Enhanced form validation and error handling
    • Improved required field validation
    • Proper validation for the ownable field
    • Unique serial number enforcement
    • Status transition validation
    • Owner assignment validation

  3. Data Integrity

    • Proper soft delete and restore functionality
    • Historical record maintenance
    • Exercise-specific data isolation
    • Future date validation for exercises

User Interface

The interface has been enhanced with improved validation and feedback:

  1. Form Organization

    • Tabbed interface for different information types
    • Contextual form fields based on status
    • Clear validation feedback
    • Status-based tab visibility

  2. Assignment Process

    • Enhanced equipment assignment workflow
    • Improved UI/UX with status-based visibility
    • Better error feedback
    • Streamlined assignment validation

  3. Testing and Quality

    • Comprehensive test coverage
    • Improved validation tests
    • Status transition tests
    • Data integrity verification