[18.0][ADD] fieldservice_equipment_location_history: equipment transfers between stock locations

fieldservice_equipment_location_history/README.rst

@@ -0,0 +1,96 @@
+==========================================
+Field Service - Equipment Location History
+==========================================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:1bb20ba410df55279f71114f0ac897195240e0103bc25429fc3a3b2cf7de5908
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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%2Ffield--service-lightgray.png?logo=github
+    :target: https://github.com/OCA/field-service/tree/18.0/fieldservice_equipment_location_history
+    :alt: OCA/field-service
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/field-service-18-0/field-service-18-0-fieldservice_equipment_location_history
+    :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/field-service&target_branch=18.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+Track and execute transfers of field service equipments between stock
+locations.
+
+Each transfer record creates and validates a real internal picking
+moving the equipment's serial number, so stock quants and traceability
+stay consistent. When the target stock location is linked to an FSM
+location (or matches one by name), the equipment's FSM location is
+updated as well.
+
+A **Transfer Stock** button on the equipment form pre-fills the transfer
+with the equipment's current stock location, and a **Location History**
+tab lists past movements with their pickings.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/field-service/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 <https://github.com/OCA/field-service/issues/new?body=module:%20fieldservice_equipment_location_history%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
+
+Do not contact contributors directly about support or help with technical issues.
+
+Credits
+=======
+
+Authors
+-------
+
+* Pop Solutions
+
+Contributors
+------------
+
+- Rafnix Guzman <rafnixg@gmail.com>
+- Marcos Mendez <m@pop.coop>
+
+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.
+
+.. |maintainer-marcos-mendez| image:: https://github.com/marcos-mendez.png?size=40px
+    :target: https://github.com/marcos-mendez
+    :alt: marcos-mendez
+
+Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
+
+|maintainer-marcos-mendez| 
+
+This module is part of the `OCA/field-service <https://github.com/OCA/field-service/tree/18.0/fieldservice_equipment_location_history>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

fieldservice_equipment_location_history/__init__.py

@@ -0,0 +1 @@
+from . import models

fieldservice_equipment_location_history/__manifest__.py

@@ -0,0 +1,19 @@
+# Copyright (C) 2022 Rafnix Guzman
+# Copyright (C) 2026 Pop Solutions
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+{
+    "name": "Field Service - Equipment Location History",
+    "summary": "Track and execute equipment transfers between stock locations",
+    "version": "18.0.1.0.0",
+    "license": "AGPL-3",
+    "website": "https://github.com/OCA/field-service",
+    "category": "Field Service",
+    "author": "Pop Solutions, Odoo Community Association (OCA)",
+    "maintainers": ["marcos-mendez"],
+    "depends": ["fieldservice_equipment_stock"],
+    "data": [
+        "security/ir.model.access.csv",
+        "views/fsm_equipment_location_history_views.xml",
+        "views/fsm_equipment_views.xml",
+    ],
+}

fieldservice_equipment_location_history/models/__init__.py

@@ -0,0 +1,2 @@
+from . import fsm_equipment_location_history
+from . import fsm_equipment

fieldservice_equipment_location_history/models/fsm_equipment.py

@@ -0,0 +1,27 @@
+# Copyright (C) 2022 Rafnix Guzman
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+from odoo import fields, models
+
+
+class FsmEquipment(models.Model):
+    _inherit = "fsm.equipment"
+
+    location_history_ids = fields.One2many(
+        "fsm.equipment.location.history", "equipment_id", string="Location History"
+    )
+
+    def action_create_location_history(self):
+        self.ensure_one()
+        return {
+            "name": "Transfer Equipment",
+            "type": "ir.actions.act_window",
+            "view_mode": "form",
+            "res_model": "fsm.equipment.location.history",
+            "context": {
+                "default_equipment_id": self.id,
+                "default_from_location_id": self.current_stock_location_id.id,
+                "default_date": fields.Datetime.now(),
+            },
+            "target": "new",
+        }

fieldservice_equipment_location_history/models/fsm_equipment_location_history.py

@@ -0,0 +1,111 @@
+# Copyright (C) 2022 Rafnix Guzman
+# Copyright (C) 2026 Pop Solutions
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+from odoo import _, api, fields, models
+from odoo.exceptions import UserError
+
+
+class FsmEquipmentLocationHistory(models.Model):
+    _name = "fsm.equipment.location.history"
+    _description = "Equipment Stock Location History"
+    _order = "date desc, id desc"
+
+    from_location_id = fields.Many2one(
+        "stock.location", string="From Location", required=True
+    )
+    to_location_id = fields.Many2one(
+        "stock.location", string="To Location", required=True
+    )
+    equipment_id = fields.Many2one("fsm.equipment", string="Equipment", required=True)
+    date = fields.Datetime(required=True, default=fields.Datetime.now)
+    type_selection = fields.Selection(
+        [("inbound", "Inbound"), ("outbound", "Outbound")],
+        string="Type",
+        required=True,
+        default="inbound",
+    )
+    picking_id = fields.Many2one(
+        "stock.picking", string="Transfer", readonly=True, copy=False
+    )
+
+    @api.model_create_multi
+    def create(self, vals_list):
+        histories = super().create(vals_list)
+        for history in histories:
+            history._execute_transfer()
+        return histories
+
+    def _execute_transfer(self):
+        """Move the equipment's serial to the target location with a real
+        internal transfer, so quants and traceability stay consistent."""
+        self.ensure_one()
+        equipment = self.equipment_id
+        if not equipment.lot_id or not equipment.product_id:
+            raise UserError(
+                _(
+                    "Equipment %s has no product/serial number: "
+                    "a stock transfer cannot be created."
+                )
+                % equipment.display_name
+            )
+        picking_type = self.env["stock.picking.type"].search(
+            [("code", "=", "internal")], limit=1
+        )
+        if not picking_type:
+            raise UserError(
+                _(
+                    "No internal transfer operation type found. "
+                    "Enable Storage Locations in Inventory settings."
+                )
+            )
+        picking = self.env["stock.picking"].create(
+            {
+                "picking_type_id": picking_type.id,
+                "location_id": self.from_location_id.id,
+                "location_dest_id": self.to_location_id.id,
+                "scheduled_date": self.date,
+            }
+        )
+        move = self.env["stock.move"].create(
+            {
+                "name": equipment.display_name,
+                "product_id": equipment.product_id.id,
+                "product_uom": equipment.product_id.uom_id.id,
+                "product_uom_qty": 1.0,
+                "location_id": self.from_location_id.id,
+                "location_dest_id": self.to_location_id.id,
+                "picking_id": picking.id,
+                "date": self.date,
+            }
+        )
+        picking.action_confirm()
+        picking.action_assign()
+        move_line = move.move_line_ids[:1]
+        if not move_line:
+            move_line = self.env["stock.move.line"].create(
+                {
+                    "move_id": move.id,
+                    "picking_id": picking.id,
+                    "product_id": equipment.product_id.id,
+                    "location_id": self.from_location_id.id,
+                    "location_dest_id": self.to_location_id.id,
+                }
+            )
+        move_line.write({"lot_id": equipment.lot_id.id, "quantity": 1.0})
+        move.picked = True
+        picking.button_validate()
+        self.picking_id = picking.id
+        self._update_equipment_fsm_location()
+
+    def _update_equipment_fsm_location(self):
+        """Point the equipment to the FSM location matching the target stock
+        location, when one exists (by inventory location, then by name)."""
+        self.ensure_one()
+        fsm_location = self.env["fsm.location"].search(
+            [("inventory_location_id", "=", self.to_location_id.id)], limit=1
+        ) or self.env["fsm.location"].search(
+            [("name", "=", self.to_location_id.name)], limit=1
+        )
+        if fsm_location:
+            self.equipment_id.location_id = fsm_location.id

fieldservice_equipment_location_history/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["whool"]
+build-backend = "whool.buildapi"

fieldservice_equipment_location_history/readme/CONTRIBUTORS.md

@@ -0,0 +1,2 @@
+- Rafnix Guzman \<rafnixg@gmail.com\>
+- Marcos Mendez \<m@pop.coop\>

fieldservice_equipment_location_history/readme/DESCRIPTION.md

@@ -0,0 +1,11 @@
+Track and execute transfers of field service equipments between stock
+locations.
+
+Each transfer record creates and validates a real internal picking moving the
+equipment's serial number, so stock quants and traceability stay consistent.
+When the target stock location is linked to an FSM location (or matches one by
+name), the equipment's FSM location is updated as well.
+
+A **Transfer Stock** button on the equipment form pre-fills the transfer with
+the equipment's current stock location, and a **Location History** tab lists
+past movements with their pickings.

fieldservice_equipment_location_history/security/ir.model.access.csv

@@ -0,0 +1,3 @@
+id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink
+access_fsm_equipment_location_history_user,fsm.equipment.location.history fsm user,model_fsm_equipment_location_history,fieldservice.group_fsm_user,1,1,1,0
+access_fsm_equipment_location_history_manager,fsm.equipment.location.history fsm manager,model_fsm_equipment_location_history,fieldservice.group_fsm_manager,1,1,1,1