A simple but powerful maintenance management system for tracking industrial equipment. Built for real manufacturing environments where you need to track machines, schedule maintenance, and manage parts ordering.
- Track your machines - Serial numbers, locations, who's responsible
- Maintenance reports - Document what happened, what needs fixing
- Approval workflow - Submit reports, get supervisor approval
- Auto-order parts - When you mark "needs part", it creates a purchase order
- Activity notifications - Assigned techs get notified automatically
- Full audit trail - Every action is logged with timestamps
- Add machines with details (serial number, manufacturer, location)
- Assign technicians to specific machines
- Track status: Healthy, Due Soon, Under Repair
Three types of reports:
- "Good to go!" - Everything's working fine
- "Preventive advice" - Something to watch or fix soon
- "Needs part" - Auto-creates purchase orders
- Technician creates maintenance report
- Submits for approval
- Supervisor approves/rejects with reasons
- If approved and needs parts → automatic purchase order
- Mark as "Done" when complete
- Odoo 17
- A custom-addons folder in your Odoo setup
-
Download/Clone this repo into your custom-addons folder:
cd /path/to/odoo/custom-addons git clone https://github.com/AviRamoutar/MachineRegistryOdoo.git machinery_maintenance -
Check the files are there:
machinery_maintenance/ ├── __init__.py ├── __manifest__.py ├── controllers/ ├── data/ ├── demo/ ├── models/ ├── security/ └── views/ -
Restart Odoo and install:
./odoo-bin -c odoo.conf -d your_database_name -u machinery_maintenance
-
Or install through the UI:
- Turn on Developer Mode (Settings → Developer Tools)
- Apps → Update Apps List
- Search "Machinery Maintenance"
- Install
- Go to Machinery → Machines
- Click New
- Fill in: Name, Serial Number, Location, etc.
- Assign a technician (they'll get notified)
- Machinery → Maintenance Reports → New
- Pick the machine
- Choose report type:
- Good to go = routine maintenance completed
- Preventive advice = "watch this, might need attention soon"
- Needs part = broken, requires parts (auto-creates purchase order)
- Write detailed notes - the text area is full-width now and supports professional formatting
- Submit for Approval
MONTHLY CALIBRATION COMPLETED SUCCESSFULLY
Performance Metrics:
✓ All 3 axes calibrated within 0.001" tolerance
✓ Spindle bearings sound normal at all speeds
✓ Tool changer: 47 tool changes tested - all successful
✓ Coolant system pressure at 45 PSI (normal)
STATUS: READY FOR PRODUCTION
Next calibration due: 30 days
- Supervisors get activity notifications when reports are submitted
- They can Approve (auto-creates purchase orders if parts needed)
- Or Reject with detailed reasons
- Everything gets logged in the chatter for audit trails
- Actually works - No broken kanban views or JavaScript errors
- Professional formatting - Notes field spans full width, proper text wrapping
- Real workflow - Submit → Approve → Execute with proper notifications
- Integration - Ties into Odoo's purchasing system seamlessly
- Practical - Built for real manufacturing environments, not just demos
- CNC machines needing calibration tracking
- Hydraulic presses with safety-critical maintenance
- Conveyor systems requiring belt tension monitoring
- Robots needing predictive maintenance alerts
- Any industrial equipment where downtime costs money
- Built for Odoo 17 (should work on 16+ but tested on 17)
- Uses standard Odoo patterns (mail.thread, activities, purchase integration)
- Custom CSS fixes Odoo's form layout constraints for better user experience
- No external dependencies beyond base Odoo modules
Found a bug? Want to add a feature?
- Open an issue
- Submit a pull request
- Keep it simple and practical
LGPL-3 (same as Odoo)
Preview Images:
