TotalApp Docs

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.

Agro-Asset Registry
→
Preventive Maintenance
→
Maintenance Work Orders
→
Spare Parts Inventory
→
Equipment Reliability Dashboard

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

ActionWhat it does
Schedule Preventive ServiceDispatches a Preventive-type maintenance work order once the asset's cumulative operating hours reach its service interval.
Flag Equipment BreakdownImmediately 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

ActionWhat it does
Generate Work Order from ScheduleCalls 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 AvailabilityCross-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

ActionWhat it does
Consume Spare Parts for Work OrderOn closure, deducts on-hand quantity in Spare Parts Inventory for every part consumed during the repair.
Set Asset Status to OperationalRestores the target asset's status to Operational in Agro-Asset Registry once the order is marked complete.
Feed Reliability MetricsPushes 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

ActionWhat it does
Trigger Low-Stock ReplenishmentFlags 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

ActionWhat it does
Flag Asset for ReplacementMarks 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 / functionWritesTarget screen / record
Field/Greenhouse Orders — Update Asset Operating HoursAccumulates operating hours; auto-dispatches preventive service at intervalAgro-Asset Registry → Maintenance Work Orders
Agro-Asset Registry — Schedule Preventive ServiceNew Preventive work orderMaintenance Work Orders
Agro-Asset Registry — Flag Equipment BreakdownNew Critical/Emergency work order; asset marked In MaintenanceMaintenance Work Orders
Preventive Maintenance — Generate Work Order from ScheduleNew work order via shared work-order creation logicMaintenance Work Orders
Preventive Maintenance — Check Spare Parts AvailabilityReads stock; marks routine's parts availabilitySpare Parts Inventory
Maintenance Work Orders — Consume Spare Parts for Work OrderDeducts consumed part quantitiesSpare Parts Inventory
Maintenance Work Orders — Set Asset Status to OperationalRestores asset status to OperationalAgro-Asset Registry
Maintenance Work Orders — Feed Reliability MetricsCreates/accumulates the asset's fleet reliability recordEquipment Reliability Dashboard
Equipment Reliability Dashboard — Flag Asset for ReplacementAsset marked Quarantined/Decommissioned; reliability record flaggedAgro-Asset Registry
IoT Climate & Soil Monitor / Silo & Storage Management — Anomaly IngestionMarks matching PM schedules anomaly-triggeredPreventive Maintenance

Frequently Asked Questions

Is Agro-Equipment Maintenance available in the app today?
Yes. All five screens — Agro-Asset Registry, Preventive Maintenance, Maintenance Work Orders, Spare Parts Inventory, and Equipment Reliability Dashboard — are live, with real sidebar navigation entries and a shared underlying data layer.
How is Maintenance Work Orders different from the other four screens in this group?
Its work order records live in a separate, domain-agnostic store already shared with Manufacturing's and Energy's own maintenance screens, rather than being defined locally to this add-on. Agriculture's screen is its own UI onto that same shared store — not a duplicate.
How does an equipment reliability record get created?
There is no manual add form. A fleet reliability record is created automatically the first time a completed work order for that asset feeds the reliability metrics, then accumulated into on every subsequent completion — the whole dashboard is analytics over data other screens generate.
What happens when an asset is flagged for replacement?
From the Root Cause Analysis modal on Equipment Reliability Dashboard, flagging for replacement sets the asset's status to Quarantined/Decommissioned in Agro-Asset Registry and records the reason on the reliability record — it does not delete the asset or its history.
Is there a reference implementation this group followed?
Manufacturing's Maintenance Operations group (Asset Registry, Preventive Maintenance, Work Orders, Spare Parts, Reliability Dashboard) is the closest existing analog, built on the same domain-agnostic maintenance engine this group's Maintenance Work Orders screen shares.