Introduction

ianaiERP's Equipment & Capacity suite answers two operational questions the rest of the ERP can't:

1. "Can we actually produce this?" — given the routings, machine speeds, shift pattern, OEE, planned maintenance, and material availability, what's the realistic completion ETA for each work order, and which work centers will overload?
2. "How do we keep equipment running?" — what preventive maintenance is due, what unplanned downtime occurred, which spare parts are about to run out, and which assets are critical to production right now?

The suite is split into three modules that can be enabled independently per tenant:

A tenant can enable any combination. The Equipment Hub is the entry page and gracefully gates each widget on the relevant module.

Where it lives

• Equipment Hub — /equipment — single-page overview of the plant floor (KPIs, status board, alerts, capacity heatmap, today's PMs).
• Equipment Detail — /equipment/:assetId — per-asset operational view (maintenance history, runtime, child assets, spare parts).
• Capacity Planner — /equipment/capacity — work-center-level capacity utilization, on-demand recompute, work-order ETAs, material bottlenecks.
• Maintenance Hub — /equipment/maintenance — PM schedules, maintenance event log, spare parts inventory.
• Work Centers — /workcenter — CRUD for work centers with capacity parameters (machine speed, OEE target, shift pattern, availability, default setup minutes, critical-for-CAPA flag).
• Assets — /asset — existing Accounting asset list, extended with EMS fields (work-center link, parent asset, runtime status, critical-asset flag, operating hours, next-service date).

How the data flows

Manual operator entry           ┌────────────────────┐
   or WO operation state ──────►│ Asset.runtime_status│
                                └─────────┬──────────┘
                                          │ (every 5 min cron)
                                          ▼
                                ┌──────────────────────┐
                                │ WorkCenter status    │
                                │ (worst-of children)  │
                                └─────────┬────────────┘
                                          │
RoutingOperation + WC params              │
PM schedules                              ▼
BOM / material lead times ──────► CalculateCapacity ──► CapaSnapshot
                                          │
                                          ▼  SSE broadcasts:
                                ┌─────────────────────────┐
                                │ workcenter_overloaded   │
                                │ asset_status_changed    │
                                │ maintenance_due         │
                                │ spare_part_low_stock    │
                                │ workorder_eta_slipped   │
                                └─────────┬───────────────┘
                                          │
                                          ▼
                                 Equipment Hub
                                 (live updates)

Who uses what

• Operators (floor tablet) — Equipment Hub status board → flip an asset RUNNING / SETUP / DOWN / IDLE → log unplanned breakdown → mark a PM done.
• Maintenance lead — Maintenance Hub → create PM plans → schedule preventive work → review downtime trends → link spare parts to assets.
• Production planner — Capacity Planner → recompute capacity for the next 30 days → identify overloaded work centers → see which work orders will slip and why.
• Plant manager — Equipment Hub dashboard → KPI overview (utilization, OEE, open maintenance, overdue PMs, WCs at risk) → drill into any asset for full history.

Recommended setup order

1. Enable modules for the tenant (EQUIPMENT_PERMITTED, plus optionally CAPA_PERMITTED and MAINTENANCE_PERMITTED). See Permissions.
2. Configure Work Centers with their CAPA parameters (machine speed, shift pattern, OEE target). See Work Centers for CAPA.
3. Tag your Assets with their work center, critical-asset flag, and parent (for hierarchical rollup). See Asset Management.
4. Mark Items that act as spare parts (is_spare_part = true) and link them to the assets that consume them. See Spare Parts.
5. Create PM schedules for the assets that need them. See Preventive Maintenance.
6. Open the Equipment Hub at /equipment — KPIs, status board, alerts, and the capacity heatmap come online. See Equipment Hub.
7. Run the first capacity recompute in the Capacity Planner to seed CapaSnapshot rows. See Capacity Planner.

What's not in v1

• Real-time PLC / MFI sensor ingestion (operator manual entry only).
• Measured OEE from quality data (uses the WC's planning oee_target_percent factor only).
• Predictive / ML-driven failure prediction.
• Per-asset capacity weighting on shared work centers (binary critical_asset flag only).
• 21 CFR Part 11 e-signatures for regulated industries.
• FMEA / failure-mode taxonomies (ad-hoc via custom fields).

Related docs

• Work Centers for CAPA
• Asset Management
• Equipment Hub
• Capacity Planner
• Preventive Maintenance
• Maintenance Events
• Spare Parts
• Runtime Status
• Permissions