Agro-Equipment Maintenance
From fleet registration through preventive scheduling, repair execution, spare parts, and fleet-wide reliability analytics — the full lifecycle of tractors, harvesters, sprayers, pumps, and drones.
What this group does
The Agro-Equipment Maintenance group is the fleet-management pipeline for Agriculture & Agro-Tech Operations. It carries a piece of machinery from initial registration through its full maintenance lifecycle: preventive service scheduling, repair work order execution, spare parts consumption, and fleet-wide reliability analytics — culminating in data-driven replacement decisions.
All five screens share the same underlying data layer, so every integration below is a real read-modify-write against sibling records rather than a simulated hand-off. Maintenance Work Orders is the one exception: it reads and writes work order records from a domain-agnostic store already shared with Manufacturing's and Energy's own maintenance screens — this add-on reuses it rather than duplicating it.
1. Agro-Asset Registry
Purpose: The master fleet ledger — register every tractor, combine harvester, sprayer/duster, irrigation pump, and agro-drone with its operating-hour counter, fuel/power type, and service interval.
Key features
- Asset IDs — ID format
AST-2026-XXXX, categories Tractors, Combine Harvesters, Sprayers/Dusters, Irrigation Pumps, Agro-Drones. - Status lifecycle — Operational, In Maintenance, Quarantined/Decommissioned.
- Fleet Readiness Meter — shows the share of the fleet currently Operational.
- Service interval tracking — a service interval in hours plus cumulative total operating hours; the screen flags when the asset has crossed its threshold.
- Telemetry & documentation — optional GPS/telemetry device pairing, hourly operating cost rate, equipment manual and warranty document URLs.
Integration triggers
| Action | What it does |
|---|---|
| Schedule Preventive Service | Dispatches a Preventive-type maintenance work order once the asset's cumulative operating hours reach its service interval. |
| Flag Equipment Breakdown | Immediately opens a Critical/Emergency maintenance work order and marks the asset In Maintenance. |
| Update Asset Operating Hours (called from Field/Greenhouse Orders) | Accumulates hours worked into the asset's counter and auto-dispatches preventive service once the interval is reached — the placeholder referenced in Agro-Tech Execution is now a real integration. |
2. Preventive Maintenance
Purpose: Define recurring service routines per asset — oil changes, hydraulic inspections, nozzle calibration, bearing greasing — and track how close each one is to its next due threshold.
Key features
- Schedule IDs — ID format
PMR-2026-XXXX, each targeting an asset with a named service routine. - Interval types — Operating Hours or Calendar Interval (Days), with a trigger value (e.g. every 250 hours).
- Progress gauge — shows percent-to-due; flags anything at or past 100% as overdue.
- Priority — Routine, Mandatory Safety, Critical Breakdown Prevention.
- Pre-allocated spare parts — a routine can list the part numbers and quantities it expects to consume, checked for availability before the work starts.
- Anomaly ingestion — lets telemetry alerts from IoT Climate & Soil Monitor or Silo & Storage Management mark a schedule anomaly-triggered, surfacing it regardless of its normal interval.
Integration triggers
| Action | What it does |
|---|---|
| Generate Work Order from Schedule | Calls the shared, domain-agnostic maintenance work order creation logic to open a real work order in Maintenance Work Orders, linked back to the schedule. |
| Check Spare Parts Availability | Cross-checks every pre-allocated part number against on-hand quantity in Spare Parts Inventory and records whether the routine is fully stocked. |
3. Maintenance Work Orders
Purpose: The execution ledger for every repair ticket — preventive, emergency, calibration, or field breakdown — from diagnosis through parts consumption, photo verification, sign-off, and closure.
Key features
- Shared record type — work orders (ID format
MWO-2026-XXXX) live in a domain-agnostic store already used by Manufacturing and Energy; this screen is Agriculture's own UI onto that same store. - Order types — Preventive, Corrective Repair (field breakdown), Condition-Based (calibration/testing), Emergency Shutdown (emergency repair).
- Equipment Downtime Risk gauge — sums actual (or, if not yet logged, estimated) hours across every open order to show operational impact.
- Execution & Parts Consumption modal — diagnostic notes, actual downtime hours, a consumed-parts log against part numbers, pre/post-repair photo URLs, and a technician sign-off attestation.
Integration triggers
| Action | What it does |
|---|---|
| Consume Spare Parts for Work Order | On closure, deducts on-hand quantity in Spare Parts Inventory for every part consumed during the repair. |
| Set Asset Status to Operational | Restores the target asset's status to Operational in Agro-Asset Registry once the order is marked complete. |
| Feed Reliability Metrics | Pushes labor hours, downtime, and cost into Equipment Reliability Dashboard — creating the asset's fleet reliability record on first ingest and accumulating failure count/downtime/cost into it on every subsequent completion. |
4. Spare Parts Inventory
Purpose: The consumables ledger — engine components, hydraulics & hoses, filters & belts, tires & tracks, nozzles & fittings — with bin locations and reorder buffers.
Key features
- Part SKUs — ID format
PRT-2026-XXXX, plus the supplier's own part number, name, and compatible machine models. - Reorder Buffer gauge — shows quantity on hand relative to the reorder threshold.
- Stock status — Optimal, Low Stock Warning, Out of Stock, On Order, derived live from current quantity and threshold.
- Warehouse bin location, unit cost, damaged/defective flagging, and last cycle-count date.
- Real store ownership — this screen took over the minimal spare-parts stand-in that Maintenance Work Orders and Preventive Maintenance already depended on; both needed zero code changes when this screen shipped.
Integration triggers
| Action | What it does |
|---|---|
| Trigger Low-Stock Replenishment | Flags a purchase requisition alert once a part's quantity falls below its reorder threshold — no purchasing/procurement screen exists yet to route the PO to, so this flips a local reorder-triggered flag the ledger reads. |
| Consume Spare Parts for Work Order (called from Maintenance Work Orders) | Deducts stock directly against this screen's own registry. |
| Check Spare Parts Availability (called from Preventive Maintenance) | Reads this screen's own registry to verify a routine's pre-allocated parts are in stock. |
5. Equipment Reliability Dashboard
Purpose: Aggregate every completed repair into a fleet-wide reliability matrix — MTBF, MTTR, cost per operating hour — and surface which assets are candidates for replacement.
Key features
- Fleet Group IDs — ID format
FLT-2026-XXXX, one reliability record per asset, built up automatically as work orders close (there is no manual add/edit form — the ledger is analytics over accumulated data). - Mean Time Between Failures (MTBF) — total operating hours over failure count.
- Mean Time To Repair (MTTR) — total unplanned downtime over failure count.
- Cost per operating hour — lifetime maintenance cost divided by operating hours.
- Reliability score — blends uptime ratio (65%) and MTTR (35%) into a single 0–100 health indicator; that score (plus cost-per-hour and any manual replacement flag) maps to a status of High Reliability, Degraded Performance, or High-Cost Replacement Candidate.
- Uptime & Availability gauge — fleet-wide planned vs. actual uptime across all reliability records.
- Root Cause Analysis modal — lifetime maintenance cost, failure count, reliability score, a failure-type Pareto breakdown sourced from the asset's historical work orders, the raw work-order history table, and a replacement-recommendation flow.
Integration triggers
| Action | What it does |
|---|---|
| Flag Asset for Replacement | Marks the target asset Quarantined/Decommissioned in Agro-Asset Registry and sets a replacement flag/reason on the reliability record — triggered from the Root Cause Analysis modal when MTTR or maintenance cost exceeds the asset's fair-market threshold. |
| Feed Reliability Metrics (called from Maintenance Work Orders) | The real target this dashboard exists to receive — every completed work order accumulates into the matching fleet reliability record here. |
End-to-end data flow
| Source screen / function | Writes | Target screen / record |
|---|---|---|
| Field/Greenhouse Orders — Update Asset Operating Hours | Accumulates operating hours; auto-dispatches preventive service at interval | Agro-Asset Registry → Maintenance Work Orders |
| Agro-Asset Registry — Schedule Preventive Service | New Preventive work order | Maintenance Work Orders |
| Agro-Asset Registry — Flag Equipment Breakdown | New Critical/Emergency work order; asset marked In Maintenance | Maintenance Work Orders |
| Preventive Maintenance — Generate Work Order from Schedule | New work order via shared work-order creation logic | Maintenance Work Orders |
| Preventive Maintenance — Check Spare Parts Availability | Reads stock; marks routine's parts availability | Spare Parts Inventory |
| Maintenance Work Orders — Consume Spare Parts for Work Order | Deducts consumed part quantities | Spare Parts Inventory |
| Maintenance Work Orders — Set Asset Status to Operational | Restores asset status to Operational | Agro-Asset Registry |
| Maintenance Work Orders — Feed Reliability Metrics | Creates/accumulates the asset's fleet reliability record | Equipment Reliability Dashboard |
| Equipment Reliability Dashboard — Flag Asset for Replacement | Asset marked Quarantined/Decommissioned; reliability record flagged | Agro-Asset Registry |
| IoT Climate & Soil Monitor / Silo & Storage Management — Anomaly Ingestion | Marks matching PM schedules anomaly-triggered | Preventive Maintenance |