mcp-wms-wiki/wiki/modules/automation-dashboard.md

---
title: "Automation Dashboard (Faults Management)"
type: module
sources:
  - areas/faults_management/index.md
  - areas/faults_management/faults_faults/faults_reports.md
  - areas/faults_management/faults_faults/faults_historical_data.md
  - areas/faults_management/faults_actions/index.md
  - areas/faults_management/faults_actions/actions_historical_data.md
  - areas/faults_management/faults_actions/actions_notifications.md
  - areas/faults_management/faults_actions/actions_reports.md
  - sources/archives/Automation_Dashboard.md
  - sources/archives/Erreurs_Defauts_GALILEO.md
related:
  - modules/agv.md
  - modules/aps3d.md
  - concepts/task.md
  - concepts/stations.md
  - architecture/galileo-integration.md
  - operations/galileo-troubleshooting.md
last_compiled: "2026-04-17"
---

# Automation Dashboard (Faults Management)

## Overview

The Automation Dashboard module (sourced from the `faults_management` area) provides supervision and management of faults and manual interventions in automatic warehouse machines. When machines in an automatic warehouse encounter errors, they shut down automatically (for safety) and notify the system of the fault. This module tracks these faults, their resolution, and all manual interventions performed by operators.

The module ensures complete traceability of machine status and problems, enabling supervisors to respond quickly and maintain audit trails.

**Note**: The `areas/automation_dashboard/` folder returns 404 — the Automation Dashboard functionality is implemented in `areas/faults_management/`.

## Key capabilities

- Automatic fault recording: faults registered automatically with start/end date, affected machine, description, possible causes, and resolution suggestions
- Manual action recording: logs all manual interventions (manual moves, data alterations) by user, date, machine, and auxiliary data
- External WMS history: centralized view of movement history for automatic warehouses using external WMS (no Easy WMS installed), communicating through Easy WCS
- Fault reports: machine ranking, availability metrics, warehouse availability, zone availability, fault frequency analysis
- Action reports: top frequent actions by machine, user, general; usage time reports
- Notification support: alerts for fault events
- Technical information available in Documents and Downloads section

## Architecture

### Data tracked

**Faults**:
- Machine affected
- Start date/time
- End date/time (when fault resolved)
- Description of fault
- Possible causes
- Resolution suggestions

**Manual actions**:
- User performing action
- Date/time
- Machine affected
- 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 for the warehouse |
| 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 and users |
| Usage times | Time spent on manual actions per category |

### Notification events
The module triggers notifications for fault events. Subscribable through Supply Chain Event Management by supervisors and managers.

## Configuration

### Prerequisites
- Automatic warehouse equipment (conveyors, sorters, AGVs, APS3D) with Easy WCS or direct Easy WMS integration
- Machine station records in WMS matching physical equipment
- User permissions configured for manual intervention actions

### External WMS integration
For automatic warehouses using an external WMS (not Easy WMS) communicating with Easy WCS, the Automation Dashboard can still display movement history centrally by receiving data from Easy WCS.

## Operations

### Fault resolution workflow
1. Machine encounters error → automatic shutdown
2. Easy WCS/WMS receives fault notification → fault record created
3. Supervisor receives notification (SCEM)
4. Supervisor reviews fault details (description, possible cause, suggestions)
5. Authorized user performs manual intervention to resolve cause
6. Manual action logged automatically
7. Machine re-enabled; fault record updated with end date

### Supervision view
- Real-time fault status per machine
- Historical fault log with filtering by date, machine, zone
- Drill-down from warehouse → zone → machine → specific fault

## GALILEO Fault Codes (common)

Faults most often seen on miniload installations. Use this table to triage before opening an escalation. Full troubleshooting procedure: [Galileo Troubleshooting](../operations/galileo-troubleshooting.md).

| Code | Name | Typical cause |
|------|------|---------------|
| **1116** | Incorrect task CU1 | Location locked on GALILEO but not on EasyWMS (or vice versa); location exists in EasyWMS but not in GALILEO; same location has different allowed container types on each side; deposit asked on left rack while container is on right fork |
| **1201** | Variator fault X | Variator hardware fault on axis X |
| **1291** | Unreferenced SM302 card on the variator | Warning only |

Fault 1116 is the configuration-drift counterpart of `EndErrorCode=4` seen in Gateway logs — same root cause, different reporting surface.

## Reference reports

Standard Automation Dashboard reports delivered by Mecalux (documents on [Confluence — Automation Dashboard](https://easywmsfrance.atlassian.net/wiki/spaces/EF/pages/3001220136988)):

- Module presentation
- Machine availability report (per machine)
- Installation availability report (aggregate)
- "Galileo fault" report (detail by fault code)

## Related

- [[agv]] — AGV machine faults and manual actions are tracked in the Automation Dashboard
- [[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 the dashboard
- [GALILEO Integration](../architecture/galileo-integration.md) — protocol layer that produces many of the faults tracked here
- [Galileo Troubleshooting](../operations/galileo-troubleshooting.md) — log-level diagnosis