Equipment Management
SOPHIOS provides comprehensive equipment catalog and tracking for managing all technical equipment and systems on your luxury assets.
Overview
Track all equipment across your yachts, jets, properties, and vehicles with detailed specifications, operating hours, and maintenance schedules.
Equipment Tracking: Manage 14 different equipment types with operating hours, maintenance intervals, and hierarchical organization.
Equipment Types
SOPHIOS supports 14 equipment categories:
Primary propulsion engines
Power generation systems
Forward maneuvering thrusters
Aft maneuvering thrusters
Heating, ventilation, and air conditioning
Desalination and water production
Roll stabilization systems
Lifting equipment and cranes
Auxiliary vessels and tenders
GPS, radar, and navigation systems
Fire suppression and safety systems
Wastewater treatment systems
Fuel filtration and purification
Miscellaneous equipment
Equipment Status
Track equipment operational status with 5 states:
🟢 Operational:
- Equipment functioning normally
- Ready for use
- No issues reported
🟡 Degraded:
- Equipment functioning but not at full capacity
- Performance reduced
- Requires attention soon
🔴 Out of Service:
- Equipment not functioning
- Cannot be used
- Requires immediate repair
🔧 Under Maintenance:
- Equipment being serviced
- Temporarily unavailable
- Scheduled downtime
⚫ Decommissioned:
- Equipment retired from service
- Permanently out of use
- Archived for records
Equipment Criticality
Classify equipment by importance with 3 levels:
🔴 Critical:
- Essential for asset operation
- Safety-critical systems
- Requires immediate attention when issues arise
- Examples: Main engines, fire fighting systems
🟠 Important:
- Significant for operations
- Impacts comfort or efficiency
- Timely maintenance required
- Examples: HVAC, generators
🟢 Standard:
- Non-critical equipment
- Routine maintenance acceptable
- Flexible scheduling
- Examples: Tenders, auxiliary equipment
Adding Equipment
Navigate to Equipment
- Select your asset
- Click “Operations” → “Equipment”
- Click ”+ Add Equipment” button
Fill Equipment Details
Required Fields:
- Name - Equipment identifier (e.g., “Starboard Main Engine”)
- Type - Select from 14 equipment types
- Status - Current operational status (defaults to Operational)
- Criticality - Importance level (defaults to Standard)
Optional Technical Details:
- Manufacturer - Equipment manufacturer name
- Model - Model number or designation
- Serial Number - Unique serial identifier
- Installation Date - When equipment was installed
Hierarchy:
- Parent Equipment - Link to parent system (optional)
Operating Hours:
- Current Hours - Current operating hour reading
- Maintenance Interval Hours - Hours between maintenance
- Last Maintenance Hours - Hours at last maintenance
- Next Maintenance Due - Hours when next maintenance needed
Additional Information:
- Specifications - Technical specs (JSON format)
- Documents - Related documentation
- Photos - Equipment photos
Review and Create
- Verify all information
- Click “Create Equipment”
- Equipment appears in catalog
Created Successfully: New equipment is now tracked in your asset’s equipment catalog.
Equipment Hierarchy
Parent-Child Relationships
Organize equipment into hierarchical structures:
Example: Engine System
Engine System (Parent)
├── Main Engine (Child)
├── Gearbox (Child)
└── Cooling System (Child)Example: HVAC System
HVAC System (Parent)
├── Chiller Unit 1 (Child)
├── Chiller Unit 2 (Child)
└── Distribution System (Child)Benefits:
- Logical organization
- Group related equipment
- Track sub-components
- Hierarchical maintenance scheduling
Setting Parent Equipment:
- When creating/editing equipment
- Select parent from dropdown
- Only equipment from same asset available
- Prevents circular references (equipment cannot be its own parent)
Operating Hours Tracking
Logging Operating Hours
Track equipment usage for maintenance planning:
Navigate to Equipment
Open equipment detail page
Click “Log Hours”
Opens hours logging form
Enter Hour Reading
Required Fields:
- Date - Date of reading
- Hours Reading - Absolute meter reading (cumulative total)
- Hours Used - Hours consumed in this period
Optional Fields:
- Notes - Context for reading (e.g., “After Atlantic crossing”)
- Operating Conditions - JSON data for environmental conditions
Validation
System validates:
- Hours reading cannot go backwards (must be ≥ current hours)
- Hours used cannot be negative
- Hours reading range: 0-999,999
- Hours used range: 0-10,000
Save Reading
Hours logged and equipment current hours updated automatically
Hours History
View complete operating hours history:
- Date of each reading
- Hours reading (absolute)
- Hours used (period)
- Recorded by (user)
- Notes and conditions
Filtering:
- Date range
- Limit (1-100 entries, default 50)
- Sorted by date (most recent first)
Maintenance Intervals
Hour-Based Maintenance
Schedule maintenance based on operating hours:
Configuration:
- Maintenance Interval Hours - Hours between services (e.g., 500 hours)
- Last Maintenance Hours - Hours at last service
- Next Maintenance Due - Calculated automatically
Calculation:
Next Maintenance Due = Last Maintenance Hours + Maintenance Interval HoursExample:
- Last Maintenance: 1,000 hours
- Interval: 500 hours
- Next Due: 1,500 hours
- Current Hours: 1,350 hours
- Remaining: 150 hours
Visual Indicators:
- 🟢 On Schedule - More than 100 hours remaining
- 🟡 Due Soon - 50-100 hours remaining
- 🟠 Overdue - 0-50 hours remaining
- 🔴 Critical - Past due hours
Equipment Filtering & Search
Filter Options
By Type:
- Select one or more equipment types
- View all engines, all generators, etc.
By Status:
- Operational
- Degraded
- Out of Service
- Under Maintenance
- Decommissioned
By Criticality:
- Critical
- Important
- Standard
By Parent:
- Filter by parent equipment
- View all children of a system
- “No Parent” option for top-level equipment
By Active Status:
- Active equipment only
- Include inactive (decommissioned)
Search
Search equipment by:
- Equipment name
- Manufacturer
- Model number
- Serial number
Pagination & Sorting
Pagination:
- Page number
- Items per page (default 50)
Sort Options:
- Name (A-Z or Z-A)
- Type
- Status
- Criticality
- Installation date
- Current hours
- Created date
Equipment Details Page
Overview Card
Displays:
- Equipment name and type icon
- Status badge
- Criticality indicator
- Manufacturer, model, serial number
- Installation date
- Parent equipment (if any)
- Created/updated timestamps
Operating Hours Gauge
Visual Display:
- Current hours reading
- Last maintenance hours
- Next maintenance due
- Hours until next service
- Progress bar with color coding
Recent Hours History
Last 10 readings:
- Date
- Hours reading
- Hours used
- Recorded by
- Notes
Upcoming Maintenance
Next scheduled maintenance:
- Maintenance type
- Scheduled date/hours
- Priority level
- Estimated cost
- Status
Equipment Analytics
Hours Dashboard
Key Metrics:
- Total equipment count
- Equipment by type distribution
- Equipment by status breakdown
- Total operating hours across all equipment
- Average hours per equipment
Charts:
- Operating hours over time (line chart)
- Hours by equipment type (bar chart)
- Most used equipment (table)
Usage Reports
Available Reports:
- Equipment utilization
- Hours history export
- Maintenance due list
- Out of service equipment
- Critical equipment status
Export Options:
- CSV - For Excel analysis
- PDF - Formatted reports
Editing Equipment
Update Information
- Open equipment detail page
- Click “Edit” button
- Modify any fields except:
- Equipment ID (permanent)
- Created date
- Click “Save Changes”
Edit History:
- All changes logged
- Timestamp and user recorded
- Audit trail maintained
Changing Status
- Navigate to equipment
- Click “Change Status”
- Select new status
- Add reason/notes (recommended)
- Confirm change
Status Restrictions:
- Only SCHEDULED or IN_PROGRESS status changes allowed
- Cannot directly set to COMPLETED (use maintenance completion)
Decommissioning Equipment
Soft Delete Process
Equipment is never permanently deleted - it’s decommissioned:
Open Equipment
Navigate to equipment detail page
Click “Decommission”
Opens confirmation dialog
Confirm Decommission
- Add reason for decommissioning
- Set decommission date
- Confirm action
Equipment Archived
- Status changed to DECOMMISSIONED
isActiveset to false- No longer appears in active equipment lists
- Historical data preserved
- Maintenance history retained
Data Preservation: Decommissioned equipment is archived but not deleted. All operating hours and maintenance history remain accessible.
Equipment Specifications
JSON Specifications Field
Store detailed technical specs in structured JSON format:
Example:
{
"power": "1200 HP",
"rpm": "1800 max",
"cooling": "Sea water cooled",
"fuelType": "Diesel",
"weight": "2500 kg",
"dimensions": {
"length": "2.5m",
"width": "1.2m",
"height": "1.8m"
}
}Use Cases:
- Technical reference
- Spare parts ordering
- Service documentation
- Compliance records
Equipment Documents & Photos
Document Storage
Store equipment-related documents:
Document Types:
- Manuals and guides
- Warranty certificates
- Service records
- Compliance certificates
- Installation drawings
Storage:
- JSON array of document URLs
- Links to cloud storage
- Secure access controlled by permissions
Photo Storage
Equipment photos for identification:
Photo Types:
- Installation photos
- Serial number plates
- Condition documentation
- Before/after maintenance
Storage:
- JSON array of photo URLs
- Thumbnail generation
- Full-size image access
Permissions & Access
Role-Based Equipment Permissions
| Operation | Owner | Admin | Accountant | Manager | Viewer |
|---|---|---|---|---|---|
| View Equipment | ✅ | ✅ | ✅ | ✅ | ✅ |
| Add Equipment | ✅ | ✅ | ❌ | ✅ | ❌ |
| Edit Equipment | ✅ | ✅ | ❌ | ✅ | ❌ |
| Delete Equipment | ✅ | ✅ | ❌ | ✅ | ❌ |
| Log Hours | ✅ | ✅ | ❌ | ✅ | ❌ |
| View Analytics | ✅ | ✅ | ✅ | ✅ | ✅ |
| Export Data | ✅ | ✅ | ✅ | ✅ | ❌ |
Best Practices
Equipment Management Tips
Organization
- Use Hierarchies - Group related equipment under parent systems
- Consistent Naming - Follow naming convention (location + type)
- Set Criticality - Properly classify equipment importance
- Complete Profiles - Fill all available fields for better tracking
Maintenance Planning
- Log Hours Regularly - Consistent operating hours tracking
- Set Intervals - Define maintenance intervals for critical equipment
- Monitor Gauges - Check maintenance due indicators weekly
- Proactive Scheduling - Schedule before equipment becomes overdue
Documentation
- Upload Manuals - Store equipment manuals for reference
- Photo Documentation - Take photos of serial plates and installation
- Record Specs - Document technical specifications
- Track Changes - Keep notes on modifications or upgrades
Troubleshooting
Cannot Add Equipment
Possible Causes:
- User lacks “Edit Equipment” permission
- Asset access not granted
- Required fields missing
Solutions:
- Verify role permissions
- Check asset access
- Fill all required fields (name, type)
Hours Won’t Update
Possible Causes:
- New reading lower than current hours
- Hours value out of range (0-999,999)
- Hours used negative
Solutions:
- Verify reading is cumulative total
- Check hours are within valid range
- Ensure hours used is positive
Parent Equipment Not Available
Possible Causes:
- Parent belongs to different asset
- Trying to set equipment as its own parent
- Circular reference attempt
Solutions:
- Select equipment from same asset
- Choose different parent
- Verify hierarchy doesn’t create loop
FAQ
Can equipment be transferred between assets?
No. Equipment belongs to a specific asset and cannot be reassigned. To move equipment, decommission on old asset and create new entry on new asset.
What happens to hours history when equipment is decommissioned?
All hours history is preserved. Decommissioned equipment retains complete operating hours log for compliance and records.
Can I have equipment without operating hours?
Yes. Operating hours tracking is optional. Not all equipment types have hour meters (e.g., fire fighting systems, HVAC).
How do I organize sub-systems?
Use parent-child relationships. Create parent equipment (e.g., “Engine System”) then add children (e.g., “Main Engine”, “Gearbox”).
Can I import equipment from spreadsheet?
Not currently. Equipment must be added individually through the interface or API.
Related Documentation: