Arthur Ria
4.5 KiB
title, type, sources, related, last_compiled
| title | type | sources | related | last_compiled | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Faults Management | module |
|
|
2026-04-10 |
Faults Management
Overview
The Faults Management module tracks machine faults and manual interventions in automatic warehouse equipment. This is the backend implementation of the Automation Dashboard feature — the areas/faults_management/ area provides the full functionality exposed under the "Automation Dashboard" UI label.
When automatic warehouse machines (conveyors, sorters, AGVs, APS3D carts) encounter errors, they shut down automatically for safety and notify the system. Faults Management records these events, tracks their resolution, and logs all manual interventions performed by operators during and after fault resolution.
Note
: The schema lists
faults-managementandautomation-dashboardas separate modules, but they map to the same source area (areas/faults_management/). See automation-dashboard for the full compiled synthesis of this module.
Key capabilities
- Automatic fault recording with start/end timestamps, machine affected, description, causes, and resolution suggestions
- Manual action logging: all operator interventions (manual moves, data alterations) by user, machine, date, and auxiliary data
- External WMS history: movement history for automatic warehouses using an external WMS communicating through Easy WCS
- Fault reports: machine ranking, availability metrics (machine/warehouse/zone), fault frequency
- Action reports: top actions by machine/user, usage time reports
- Notification support: fault events delivered to supervisors and managers via SCEM
Architecture
Data tracked
Faults:
| Field | Description |
|---|---|
| Machine | Affected automatic machine |
| Start date/time | When the fault occurred |
| End date/time | When the fault was resolved |
| Description | Fault description |
| Possible causes | Diagnostic information |
| Resolution suggestions | Recommended corrective actions |
Manual actions:
| Field | Description |
|---|---|
| User | Operator performing the intervention |
| Date/time | When the action was performed |
| Machine | Affected machine |
| Action type | Manual movement, task data alteration, etc. |
| Auxiliary data | Additional context |
Report types
Fault reports:
| Report | Content |
|---|---|
| Historical data | Full fault log with timeline |
| Machine ranking | Machines ranked by fault frequency |
| Machine unavailability | Downtime periods per machine |
| All machines availability | Overall availability across machines |
| Warehouse availability | Combined availability metric |
| Zone availability (all/one) | Availability by warehouse zone |
| Warehouse fault frequency | Fault rate over time |
| Warehouse ranking | Ranking by total downtime impact |
Action reports:
| Report | Content |
|---|---|
| Historical data | Full action log with timeline |
| Top frequent by machine | Most common actions per machine |
| Top frequent by user | Most common actions per operator |
| Top frequent (general) | Top actions across all machines/users |
| Usage times | Time spent on manual actions per category |
Fault resolution workflow
- Machine encounters error → automatic shutdown
- Easy WCS/WMS receives fault notification → fault record created with start time
- Supervisor receives notification (via SCEM)
- Supervisor reviews fault details (description, possible cause, suggestions)
- Authorized operator performs manual intervention to resolve cause
- Manual action logged automatically
- Machine re-enabled; fault record updated with end date/time
Related
- automation-dashboard — The Automation Dashboard UI is powered by this module's data
- agv — AGV machine faults and manual interventions tracked here
- aps3d — APS3D Fleet Manager and cart faults tracked for traceability
- task — Manual task completions and modifications logged as actions
- stations — Machine stations are the physical entities tracked in fault records