From 2f83d81283a630a1e21fc319b1f7592d370c5ebd Mon Sep 17 00:00:00 2001 From: Morita Shinnosuke Date: Thu, 4 Jun 2026 01:06:33 +0000 Subject: [PATCH] [ADD] maintenance_equipment_availability --- README.md | 1 + maintenance_equipment_availability/README.rst | 91 ++++ .../__init__.py | 4 + .../__manifest__.py | 19 + .../models/__init__.py | 5 + .../models/maintenance_equipment.py | 70 +++ .../models/maintenance_request.py | 49 ++ .../pyproject.toml | 3 + .../readme/CONTRIBUTORS.md | 2 + .../readme/DESCRIPTION.md | 3 + .../readme/USAGE.md | 7 + .../static/description/index.html | 437 ++++++++++++++++++ .../tests/__init__.py | 4 + ...test_maintenance_equipment_availability.py | 83 ++++ .../views/maintenance_equipment_views.xml | 112 +++++ .../views/maintenance_request_views.xml | 69 +++ 16 files changed, 959 insertions(+) create mode 100644 maintenance_equipment_availability/README.rst create mode 100644 maintenance_equipment_availability/__init__.py create mode 100644 maintenance_equipment_availability/__manifest__.py create mode 100644 maintenance_equipment_availability/models/__init__.py create mode 100644 maintenance_equipment_availability/models/maintenance_equipment.py create mode 100644 maintenance_equipment_availability/models/maintenance_request.py create mode 100644 maintenance_equipment_availability/pyproject.toml create mode 100644 maintenance_equipment_availability/readme/CONTRIBUTORS.md create mode 100644 maintenance_equipment_availability/readme/DESCRIPTION.md create mode 100644 maintenance_equipment_availability/readme/USAGE.md create mode 100644 maintenance_equipment_availability/static/description/index.html create mode 100644 maintenance_equipment_availability/tests/__init__.py create mode 100644 maintenance_equipment_availability/tests/test_maintenance_equipment_availability.py create mode 100644 maintenance_equipment_availability/views/maintenance_equipment_views.xml create mode 100644 maintenance_equipment_availability/views/maintenance_request_views.xml diff --git a/README.md b/README.md index b6f187bb6..b7c6f1dd9 100644 --- a/README.md +++ b/README.md @@ -25,6 +25,7 @@ addon | version | maintainers | summary [base_maintenance_group](base_maintenance_group/) | 18.0.1.0.0 | | Provides base access groups for the Maintenance App [hr_maintenance_security](hr_maintenance_security/) | 18.0.1.0.0 | | HR Maintenance Security [maintenance_account](maintenance_account/) | 18.0.1.0.0 | victoralmau | Maintenance Account +[maintenance_equipment_availability](maintenance_equipment_availability/) | 18.0.1.0.0 | | Maintenance Equipment Availability [maintenance_equipment_category_hierarchy](maintenance_equipment_category_hierarchy/) | 18.0.1.0.0 | | Equipment Categories Hierarchy [maintenance_equipment_contract](maintenance_equipment_contract/) | 18.0.1.0.0 | | Manage equipment contracts [maintenance_equipment_hierarchy](maintenance_equipment_hierarchy/) | 18.0.1.0.0 | dalonsod | Manage equipment hierarchy diff --git a/maintenance_equipment_availability/README.rst b/maintenance_equipment_availability/README.rst new file mode 100644 index 000000000..5b8a280d4 --- /dev/null +++ b/maintenance_equipment_availability/README.rst @@ -0,0 +1,91 @@ +================================== +Maintenance Equipment Availability +================================== + +.. + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! This file is generated by oca-gen-addon-readme !! + !! changes will be overwritten. !! + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! source digest: sha256:7785d6d9fa83b76b5b3f87e5d8e180b6ee18bfae95a90226b908c8b19b84a4a0 + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + +.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png + :target: https://odoo-community.org/page/development-status + :alt: Beta +.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png + :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html + :alt: License: AGPL-3 +.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fmaintenance-lightgray.png?logo=github + :target: https://github.com/OCA/maintenance/tree/18.0/maintenance_equipment_availability + :alt: OCA/maintenance +.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png + :target: https://translation.odoo-community.org/projects/maintenance-18-0/maintenance-18-0-maintenance_equipment_availability + :alt: Translate me on Weblate +.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png + :target: https://runboat.odoo-community.org/builds?repo=OCA/maintenance&target_branch=18.0 + :alt: Try me on Runboat + +|badge1| |badge2| |badge3| |badge4| |badge5| + +This module adds a pass/fail maintenance result to maintenance requests +and computes equipment availability from the latest completed +maintenance request with a result. + +**Table of contents** + +.. contents:: + :local: + +Usage +===== + +When a maintenance request is completed (it reaches a done stage), set +its Maintenance Result to Passed or Failed. The equipment availability +is then computed from the latest completed request by completion date. + +- Passed: the equipment is available. +- Failed: the equipment is unavailable. +- No result yet: the equipment availability is unknown. + +Bug Tracker +=========== + +Bugs are tracked on `GitHub Issues `_. +In case of trouble, please check there if your issue has already been reported. +If you spotted it first, help us to smash it by providing a detailed and welcomed +`feedback `_. + +Do not contact contributors directly about support or help with technical issues. + +Credits +======= + +Authors +------- + +* Quartile + +Contributors +------------ + +- `Quartile `__: + + - Shinnosuke Morita + +Maintainers +----------- + +This module is maintained by the OCA. + +.. image:: https://odoo-community.org/logo.png + :alt: Odoo Community Association + :target: https://odoo-community.org + +OCA, or the Odoo Community Association, is a nonprofit organization whose +mission is to support the collaborative development of Odoo features and +promote its widespread use. + +This module is part of the `OCA/maintenance `_ project on GitHub. + +You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. diff --git a/maintenance_equipment_availability/__init__.py b/maintenance_equipment_availability/__init__.py new file mode 100644 index 000000000..f2d5f49b8 --- /dev/null +++ b/maintenance_equipment_availability/__init__.py @@ -0,0 +1,4 @@ +# Copyright 2026 Quartile (https://www.quartile.co) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from . import models diff --git a/maintenance_equipment_availability/__manifest__.py b/maintenance_equipment_availability/__manifest__.py new file mode 100644 index 000000000..ec16c95b8 --- /dev/null +++ b/maintenance_equipment_availability/__manifest__.py @@ -0,0 +1,19 @@ +# Copyright 2026 Quartile (https://www.quartile.co) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +{ + "name": "Maintenance Equipment Availability", + "summary": "Compute equipment availability from maintenance request results", + "version": "18.0.1.0.0", + "development_status": "Beta", + "category": "Maintenance", + "website": "https://github.com/OCA/maintenance", + "author": "Quartile, Odoo Community Association (OCA)", + "license": "AGPL-3", + "depends": ["maintenance"], + "data": [ + "views/maintenance_request_views.xml", + "views/maintenance_equipment_views.xml", + ], + "installable": True, +} diff --git a/maintenance_equipment_availability/models/__init__.py b/maintenance_equipment_availability/models/__init__.py new file mode 100644 index 000000000..a111fed3b --- /dev/null +++ b/maintenance_equipment_availability/models/__init__.py @@ -0,0 +1,5 @@ +# Copyright 2026 Quartile (https://www.quartile.co) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from . import maintenance_request +from . import maintenance_equipment diff --git a/maintenance_equipment_availability/models/maintenance_equipment.py b/maintenance_equipment_availability/models/maintenance_equipment.py new file mode 100644 index 000000000..e379d4c68 --- /dev/null +++ b/maintenance_equipment_availability/models/maintenance_equipment.py @@ -0,0 +1,70 @@ +# Copyright 2026 Quartile (https://www.quartile.co) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo import api, fields, models + + +class MaintenanceEquipment(models.Model): + _inherit = "maintenance.equipment" + + availability_state = fields.Selection( + selection=[ + ("unknown", "Unknown"), + ("available", "Available"), + ("unavailable", "Unavailable"), + ], + compute="_compute_availability", + store=True, + readonly=True, + string="Availability", + ) + latest_maintenance_result_request_id = fields.Many2one( + comodel_name="maintenance.request", + compute="_compute_availability", + store=True, + readonly=True, + string="Latest Result Request", + ) + latest_maintenance_result_date = fields.Date( + compute="_compute_availability", + store=True, + readonly=True, + string="Latest Result Date", + ) + + @api.depends( + "maintenance_ids.close_date", + "maintenance_ids.request_date", + "maintenance_ids.stage_id.done", + "maintenance_ids.maintenance_result", + "maintenance_ids.archive", + ) + def _compute_availability(self): + requests = ( + self.env["maintenance.request"] + .sudo() + .search( + [ + ("equipment_id", "in", self.ids), + ("stage_id.done", "=", True), + ("maintenance_result", "in", ("passed", "failed")), + ("archive", "=", False), + ], + order="equipment_id, close_date desc, request_date desc, id desc", + ) + ) + latest_by_equipment = {} + for request in requests: + latest_by_equipment.setdefault(request.equipment_id.id, request) + for equipment in self: + request = latest_by_equipment.get(equipment.id) + equipment.latest_maintenance_result_request_id = request + equipment.latest_maintenance_result_date = ( + request.close_date or request.request_date if request else False + ) + if not request: + equipment.availability_state = "unknown" + elif request.maintenance_result == "passed": + equipment.availability_state = "available" + else: + equipment.availability_state = "unavailable" diff --git a/maintenance_equipment_availability/models/maintenance_request.py b/maintenance_equipment_availability/models/maintenance_request.py new file mode 100644 index 000000000..4b22e7e06 --- /dev/null +++ b/maintenance_equipment_availability/models/maintenance_request.py @@ -0,0 +1,49 @@ +# Copyright 2026 Quartile (https://www.quartile.co) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo import _, fields, models + + +class MaintenanceRequest(models.Model): + _inherit = "maintenance.request" + + maintenance_result = fields.Selection( + selection=[ + ("none", "No Result"), + ("passed", "Passed"), + ("failed", "Failed"), + ], + default="none", + copy=False, + tracking=True, + ) + source_request_id = fields.Many2one( + comodel_name="maintenance.request", + string="Source Request", + copy=False, + readonly=True, + help="Failed request this follow-up request was created from.", + ) + followup_request_ids = fields.One2many( + comodel_name="maintenance.request", + inverse_name="source_request_id", + string="Follow-up Requests", + ) + + def action_create_followup_request(self): + self.ensure_one() + followup = self.env["maintenance.request"].create( + { + "name": _("Follow-up of %s", self.name), + "equipment_id": self.equipment_id.id, + "maintenance_type": "corrective", + "source_request_id": self.id, + } + ) + return { + "type": "ir.actions.act_window", + "res_model": "maintenance.request", + "res_id": followup.id, + "view_mode": "form", + "target": "current", + } diff --git a/maintenance_equipment_availability/pyproject.toml b/maintenance_equipment_availability/pyproject.toml new file mode 100644 index 000000000..4231d0ccc --- /dev/null +++ b/maintenance_equipment_availability/pyproject.toml @@ -0,0 +1,3 @@ +[build-system] +requires = ["whool"] +build-backend = "whool.buildapi" diff --git a/maintenance_equipment_availability/readme/CONTRIBUTORS.md b/maintenance_equipment_availability/readme/CONTRIBUTORS.md new file mode 100644 index 000000000..260160c76 --- /dev/null +++ b/maintenance_equipment_availability/readme/CONTRIBUTORS.md @@ -0,0 +1,2 @@ +- [Quartile](https://www.quartile.co): + - Shinnosuke Morita diff --git a/maintenance_equipment_availability/readme/DESCRIPTION.md b/maintenance_equipment_availability/readme/DESCRIPTION.md new file mode 100644 index 000000000..4d52e6d2a --- /dev/null +++ b/maintenance_equipment_availability/readme/DESCRIPTION.md @@ -0,0 +1,3 @@ +This module adds a pass/fail maintenance result to maintenance requests and +computes equipment availability from the latest completed maintenance request +with a result. diff --git a/maintenance_equipment_availability/readme/USAGE.md b/maintenance_equipment_availability/readme/USAGE.md new file mode 100644 index 000000000..b50ad5120 --- /dev/null +++ b/maintenance_equipment_availability/readme/USAGE.md @@ -0,0 +1,7 @@ +When a maintenance request is completed (it reaches a done stage), set its +Maintenance Result to Passed or Failed. The equipment availability is then +computed from the latest completed request by completion date. + +- Passed: the equipment is available. +- Failed: the equipment is unavailable. +- No result yet: the equipment availability is unknown. diff --git a/maintenance_equipment_availability/static/description/index.html b/maintenance_equipment_availability/static/description/index.html new file mode 100644 index 000000000..530e3281d --- /dev/null +++ b/maintenance_equipment_availability/static/description/index.html @@ -0,0 +1,437 @@ + + + + + +Maintenance Equipment Availability + + + +
+

Maintenance Equipment Availability

+ + +

Beta License: AGPL-3 OCA/maintenance Translate me on Weblate Try me on Runboat

+

This module adds a pass/fail maintenance result to maintenance requests +and computes equipment availability from the latest completed +maintenance request with a result.

+

Table of contents

+ +
+

Usage

+

When a maintenance request is completed (it reaches a done stage), set +its Maintenance Result to Passed or Failed. The equipment availability +is then computed from the latest completed request by completion date.

+
    +
  • Passed: the equipment is available.
    • +
  • Failed: the equipment is unavailable.
    • +
  • No result yet: the equipment availability is unknown.
    • +
+
+
+

Bug Tracker

+

Bugs are tracked on GitHub Issues. +In case of trouble, please check there if your issue has already been reported. +If you spotted it first, help us to smash it by providing a detailed and welcomed +feedback.

+

Do not contact contributors directly about support or help with technical issues.

+
+
+

Credits

+
+

Authors

+
    +
  • Quartile
    • +
+
+
+

Contributors

+ +
+
+

Maintainers

+

This module is maintained by the OCA.

+Odoo Community Association +

OCA, or the Odoo Community Association, is a nonprofit organization whose +mission is to support the collaborative development of Odoo features and +promote its widespread use.

+

This module is part of the OCA/maintenance project on GitHub.

+

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

+
+
+
+ + diff --git a/maintenance_equipment_availability/tests/__init__.py b/maintenance_equipment_availability/tests/__init__.py new file mode 100644 index 000000000..97fec49f4 --- /dev/null +++ b/maintenance_equipment_availability/tests/__init__.py @@ -0,0 +1,4 @@ +# Copyright 2026 Quartile (https://www.quartile.co) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from . import test_maintenance_equipment_availability diff --git a/maintenance_equipment_availability/tests/test_maintenance_equipment_availability.py b/maintenance_equipment_availability/tests/test_maintenance_equipment_availability.py new file mode 100644 index 000000000..1a1ae87e6 --- /dev/null +++ b/maintenance_equipment_availability/tests/test_maintenance_equipment_availability.py @@ -0,0 +1,83 @@ +# Copyright 2026 Quartile (https://www.quartile.co) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo.addons.base.tests.common import BaseCommon + + +class TestMaintenanceEquipmentAvailability(BaseCommon): + @classmethod + def setUpClass(cls): + super().setUpClass() + cls.equipment = cls.env["maintenance.equipment"].create( + {"name": "Availability Test Equipment"} + ) + cls.open_stage = cls.env.ref("maintenance.stage_0") + cls.done_stage = cls.env.ref("maintenance.stage_3") + + def _create_request( + self, stage, result="none", request_date="2024-01-01", close_date=False + ): + vals = { + "name": f"Request {stage.name}", + "equipment_id": self.equipment.id, + "stage_id": stage.id, + "request_date": request_date, + "maintenance_result": result, + } + if close_date: + vals["close_date"] = close_date + return self.env["maintenance.request"].create(vals) + + def test_availability_unknown_without_completed_result(self): + self.assertEqual(self.equipment.availability_state, "unknown") + # A result on a request that is not done yet is ignored. + self._create_request(self.open_stage, result="passed") + self.assertEqual(self.equipment.availability_state, "unknown") + # A done request without a result is ignored. + self._create_request(self.done_stage, result="none", close_date="2024-01-01") + self.assertEqual(self.equipment.availability_state, "unknown") + self.assertFalse(self.equipment.latest_maintenance_result_request_id) + self.assertFalse(self.equipment.latest_maintenance_result_date) + + def test_passed_makes_equipment_available(self): + request = self._create_request( + self.done_stage, result="passed", close_date="2024-01-01" + ) + self.assertEqual(self.equipment.availability_state, "available") + self.assertEqual(self.equipment.latest_maintenance_result_request_id, request) + self.assertEqual( + self.equipment.latest_maintenance_result_date.isoformat(), "2024-01-01" + ) + + def test_availability_uses_latest_result_by_close_date(self): + self._create_request(self.done_stage, result="passed", close_date="2024-01-01") + self.assertEqual(self.equipment.availability_state, "available") + + failed = self._create_request( + self.done_stage, + result="failed", + request_date="2024-02-01", + close_date="2024-01-10", + ) + self.assertEqual(self.equipment.availability_state, "unavailable") + self.assertEqual(self.equipment.latest_maintenance_result_request_id, failed) + + # An older close_date does not override the latest result. + self._create_request( + self.done_stage, + result="passed", + request_date="2024-03-01", + close_date="2024-01-05", + ) + self.assertEqual(self.equipment.availability_state, "unavailable") + + def test_create_followup_request_from_failed(self): + request = self._create_request( + self.done_stage, result="failed", close_date="2024-01-01" + ) + request.action_create_followup_request() + followup = request.followup_request_ids + self.assertEqual(len(followup), 1) + self.assertEqual(followup.source_request_id, request) + self.assertEqual(followup.equipment_id, self.equipment) + self.assertEqual(followup.maintenance_type, "corrective") diff --git a/maintenance_equipment_availability/views/maintenance_equipment_views.xml b/maintenance_equipment_availability/views/maintenance_equipment_views.xml new file mode 100644 index 000000000..6929eb145 --- /dev/null +++ b/maintenance_equipment_availability/views/maintenance_equipment_views.xml @@ -0,0 +1,112 @@ + + + + + maintenance.equipment.form + maintenance.equipment + + + + + + + + + + + + + + + + maintenance.equipment.list + maintenance.equipment + + + + + + + + + + maintenance.equipment.kanban + maintenance.equipment + + + + + + +
+ +
+
+ +
+
+ +
+ + + + + + maintenance.equipment.search + maintenance.equipment + + + + + + + + + + + + + + + + + diff --git a/maintenance_equipment_availability/views/maintenance_request_views.xml b/maintenance_equipment_availability/views/maintenance_request_views.xml new file mode 100644 index 000000000..ad01446de --- /dev/null +++ b/maintenance_equipment_availability/views/maintenance_request_views.xml @@ -0,0 +1,69 @@ + + + + + maintenance.request.form + maintenance.request + + + + + + + + + + + + maintenance.request.list + maintenance.request + + + + + + + + + + maintenance.request.search + maintenance.request + + + + + + + + + + + + +