| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Inventory (stock) • Maintenance (maintenance) • Employees (hr) • Invoicing (account) |
| Community Apps Dependencies | Show |
| Lines of code | 3788 |
| Technical Name |
grev_od_mining_equipment |
| License | OPL-1 |
| Website | https://grevlin.com |
Heavy Equipment ManagementTrack your entire mining fleet — OEE, fuel consumption, breakdowns, and preventive maintenance — with shift-level precision and Odoo Maintenance integration.
|
|
|
|
Need Help?Contact us at odoo@grevlin.com or find us on X at @GrevlinGlobal ✓ 30 days free support included |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Inventory (stock) • Maintenance (maintenance) • Employees (hr) • Invoicing (account) |
| Community Apps Dependencies | Show |
| Lines of code | 3788 |
| Technical Name |
grev_od_mining_equipment |
| License | OPL-1 |
| Website | https://grevlin.com |
Heavy Equipment Management
The Heavy Equipment Management module tracks your entire mining fleet at shift-level precision — OEE (Overall Equipment Effectiveness), fuel consumption, breakdowns, and preventive maintenance schedules — through native Odoo Maintenance integration.
Note
This module requires :doc:`../grev_od_mining_base/doc/index`. Install Mining Operations Base first.
Overview
Key Features
- Fleet register — extends maintenance.equipment for mining equipment types
- OEE snapshots — shift, daily, and monthly OEE = Availability × Performance × Quality
- Equipment logs — per-shift hour buckets with sum-validation against shift duration
- Fuel issue tracking — bowser-to-equipment fuel issues with Odoo stock integration
- Breakdown management — open → diagnosing → repairing → closed state machine
- PM alerts — automatic maintenance requests at 250h, 500h, 1000h, 2000h intervals
- Equipment dashboard — fleet status, OEE trends, fuel MTD, top downtime causes
Configuration
No additional settings are required beyond base module installation. Equipment types and PM intervals are configured per equipment record.
Usage
Registering Equipment
- Go to :menuselection:`Mining Equipment --> Fleet --> Equipment`.
- Click :guilabel:`Create`.
- Set the Mining Type (shovel, haul truck, drill, crusher, etc.).
- Fill in capacity, commissioning date, engine serial number (must be unique).
- Assign to a pit or circuit.
- Set Is Critical for equipment whose breakdown triggers escalated alerts.
Logging a Shift
- From the equipment form, click :guilabel:`Log Shift` or go to :menuselection:`Mining Equipment --> Operations --> Equipment Logs`.
- Select the shift log and equipment.
- Enter the hour buckets:
- Operating hours — actual production time
- Standby hours — available but not operating
- Breakdown hours — unplanned downtime
- Planned maintenance hours — scheduled PM time
Important
The sum of all hour buckets must equal the shift duration within ±0.1 hours. The form will not save if the totals diverge.
Reading the OEE Report
OEE = Availability × Performance × Quality
| Component | Formula | Notes |
|---|---|---|
| Availability | (Planned hours − Breakdown hours) / Planned hours | Uses production calendar planned hours |
| Performance | Actual output / (Operating hours × Design throughput) | Design throughput in BCM/h or t/h |
| Quality | 1.0 for mining equipment (shovel, truck, drill) | Recovery % for processing equipment (crusher, mill) |
OEE snapshots are rebuilt nightly for the last 35 days and last 3 months.
Recording a Breakdown
- Go to :menuselection:`Mining Equipment --> Operations --> Breakdowns`.
- Click :guilabel:`Create`, select equipment, start datetime, cause category.
- Progress through the state machine: :guilabel:`Diagnose` → :guilabel:`Repair` → :guilabel:`Close`.
- On close, MTBF (Mean Time Between Failures) is recomputed for the equipment.
Note
If the breakdown is safety-related (Is Safety Related checkbox), an incident record is automatically created in the Safety module (if installed).
Technical Details
OEE Quality Semantics
Mining equipment (shovel, truck, drill, dozer, grader, light vehicle, generator, compressor): quality_pct = 1.0 — rejects are not meaningful for these types.
Processing equipment (crusher, SAG mill, ball mill, pump, conveyor): quality_pct = accepted_output / total_output, capped at 1.0.
Dashboard Data Method
The get_dashboard_data() method on mining.equipment returns fleet OEE %, MTD fuel consumption, availability %, performance %, top 5 downtime causes, and PM due/overdue counts — all scoped to the current company.
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module