diff --git a/fleet_vehicle_capacity/README.rst b/fleet_vehicle_capacity/README.rst new file mode 100644 index 00000000..1e4f142c --- /dev/null +++ b/fleet_vehicle_capacity/README.rst @@ -0,0 +1,116 @@ +====================== +Fleet Vehicle Capacity +====================== + +.. + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! This file is generated by oca-gen-addon-readme !! + !! changes will be overwritten. !! + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! source digest: sha256:c6363705ebe10d7daf6de26c5e8c9689066d8cb8d4c63d5b2e2eca9fc1fe5207 + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + +.. |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%2Ffleet-lightgray.png?logo=github + :target: https://github.com/OCA/fleet/tree/14.0/fleet_vehicle_capacity + :alt: OCA/fleet +.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png + :target: https://translation.odoo-community.org/projects/fleet-14-0/fleet-14-0-fleet_vehicle_capacity + :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/fleet&target_branch=14.0 + :alt: Try me on Runboat + +|badge1| |badge2| |badge3| |badge4| |badge5| + +This module adds fields to manage the weight and volume capacity in the +vehicle model. It is also designed to be easily expandable, allowing the +addition of other vehicle-specific capacities in the future as needed. + +**Table of contents** + +.. contents:: + :local: + +Usage +===== + +To use this module, it first needs to be installed. Upon installation, +the system will automatically detect the default units of measure (UOM) +for vehicle weight, volume, and passenger capacity, and assign them to +vehicle models accordingly. + +The module enhances the Odoo Fleet Management system by allowing +administrators to configure default UOMs for: + +- Vehicle Weight (tons) +- Vehicle Volume Capacity (cubic meters) +- Passenger Capacity (number of passengers) + +Key Features: + +- Automatic Assignment of Default UOMs: After installation, the system + automatically assigns default UOMs to vehicle models based on the + standard UOMs (tons, cubic meters, and units). +- Configurable UOMs: The administrator can update the default UOMs for + vehicle weight, volume, and passenger capacity through the system + settings. Changes made to the default UOMs will be applied to all new + vehicle models automatically. +- Editable Vehicle Model UOMs: While vehicle models use the default + UOMs upon creation, the administrator can still manually override the + UOMs for specific models if needed. + +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 +------- + +* Escodoo + +Contributors +------------ + +- ``Escodoo ``\ \_: + + - Marcel Savegnago marcel.savegnago@escodoo.com.br + +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-marcelsavegnago| image:: https://github.com/marcelsavegnago.png?size=40px + :target: https://github.com/marcelsavegnago + :alt: marcelsavegnago + +Current `maintainer `__: + +|maintainer-marcelsavegnago| + +This module is part of the `OCA/fleet `_ project on GitHub. + +You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. diff --git a/fleet_vehicle_capacity/__init__.py b/fleet_vehicle_capacity/__init__.py new file mode 100644 index 00000000..0650744f --- /dev/null +++ b/fleet_vehicle_capacity/__init__.py @@ -0,0 +1 @@ +from . import models diff --git a/fleet_vehicle_capacity/__manifest__.py b/fleet_vehicle_capacity/__manifest__.py new file mode 100644 index 00000000..b0aaca78 --- /dev/null +++ b/fleet_vehicle_capacity/__manifest__.py @@ -0,0 +1,23 @@ +# Copyright 2024 - TODAY, Escodoo +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +{ + "name": "Fleet Vehicle Capacity", + "summary": """ + Add capacity fields to vehicles""", + "version": "14.0.1.0.0", + "license": "AGPL-3", + "author": "Escodoo,Odoo Community Association (OCA)", + "maintainers": ["marcelsavegnago"], + "website": "https://github.com/OCA/fleet", + "depends": [ + "fleet", + "uom", + ], + "data": [ + "views/res_config_settings.xml", + "views/fleet_vehicle_model.xml", + "views/fleet_vehicle.xml", + ], + "demo": [], +} diff --git a/fleet_vehicle_capacity/models/__init__.py b/fleet_vehicle_capacity/models/__init__.py new file mode 100644 index 00000000..3712bdcb --- /dev/null +++ b/fleet_vehicle_capacity/models/__init__.py @@ -0,0 +1,3 @@ +from . import fleet_vehicle +from . import fleet_vehicle_model +from . import res_config_settings diff --git a/fleet_vehicle_capacity/models/fleet_vehicle.py b/fleet_vehicle_capacity/models/fleet_vehicle.py new file mode 100644 index 00000000..7a73593a --- /dev/null +++ b/fleet_vehicle_capacity/models/fleet_vehicle.py @@ -0,0 +1,48 @@ +# Copyright 2024 - TODAY, Marcel Savegnago +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo import fields, models + + +class FleetVehicle(models.Model): + + _inherit = "fleet.vehicle" + + vehicle_weight = fields.Float( + related="model_id.vehicle_weight", + string="Vehicle Weight", + help="The weight of the vehicle.", + ) + + weight_capacity = fields.Float( + related="model_id.weight_capacity", + string="Weight Capacity", + help="The maximum weight capacity the vehicle can support.", + ) + + volume_capacity = fields.Float( + related="model_id.volume_capacity", + string="Volume Capacity", + help="The maximum volume capacity the vehicle can support.", + ) + + passenger_capacity = fields.Float( + related="model_id.passenger_capacity", + string="Passenger Capacity", + help="The maximum passenger capacity the vehicle can support.", + ) + + weight_uom_id = fields.Many2one( + related="model_id.weight_uom_id", + string="Weight and Capacity UOM", + ) + + volume_uom_id = fields.Many2one( + related="model_id.volume_uom_id", + string="Volume Capacity UOM", + ) + + passenger_uom_id = fields.Many2one( + related="model_id.passenger_uom_id", + string="Passenger Capacity UOM", + ) diff --git a/fleet_vehicle_capacity/models/fleet_vehicle_model.py b/fleet_vehicle_capacity/models/fleet_vehicle_model.py new file mode 100644 index 00000000..1b81fb0d --- /dev/null +++ b/fleet_vehicle_capacity/models/fleet_vehicle_model.py @@ -0,0 +1,103 @@ +# Copyright 2024 - TODAY, Marcel Savegnago +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +import logging + +from odoo import fields, models + +_logger = logging.getLogger(__name__) + + +class FleetVehicleModel(models.Model): + _inherit = "fleet.vehicle.model" + + vehicle_weight = fields.Float( + string="Vehicle Weight", help="The weight of the vehicle." + ) + + weight_capacity = fields.Float( + string="Weight Capacity", + help="The maximum weight capacity the vehicle can support.", + ) + + volume_capacity = fields.Float( + string="Volume Capacity", + help="The maximum volume capacity the vehicle can support.", + ) + + passenger_capacity = fields.Float( + string="Passenger Capacity", + help="The maximum passenger capacity the vehicle can support.", + ) + + def _get_vehicle_weight_uom_id_from_ir_config_parameter(self): + uom_id = ( + self.env["ir.config_parameter"] + .sudo() + .get_param("fleet.default_vehicle_weight_uom_id") + ) + if uom_id: + try: + return int(uom_id) + except ValueError: + _logger.error("Invalid Vehicle Weight UOM ID format: %s", uom_id) + return False + else: + return self.env["res.config.settings"]._default_vehicle_weight_uom_id() + + def _get_vehicle_volume_uom_id_from_ir_config_parameter(self): + uom_id = ( + self.env["ir.config_parameter"] + .sudo() + .get_param("fleet.default_vehicle_volume_uom_id") + ) + if uom_id: + try: + return int(uom_id) + except ValueError: + _logger.error("Invalid Vehicle Volume UOM ID format: %s", uom_id) + return False + else: + return self.env["res.config.settings"]._default_vehicle_volume_uom_id() + + def _get_vehicle_passenger_uom_id_from_ir_config_parameter(self): + uom_id = ( + self.env["ir.config_parameter"] + .sudo() + .get_param("fleet.default_vehicle_passenger_uom_id") + ) + if uom_id: + try: + return int(uom_id) + except ValueError: + _logger.error("Invalid Vehicle Passenger UOM ID format: %s", uom_id) + return False + else: + return self.env["res.config.settings"]._default_vehicle_passenger_uom_id() + + weight_uom_id = fields.Many2one( + "uom.uom", + string="Weight and Capacity UOM", + domain=lambda self: [ + ("category_id", "=", self.env.ref("uom.product_uom_categ_kgm").id) + ], + default=lambda x: x._get_vehicle_weight_uom_id_from_ir_config_parameter(), + ) + + volume_uom_id = fields.Many2one( + "uom.uom", + string="Volume Capacity UOM", + domain=lambda self: [ + ("category_id", "=", self.env.ref("uom.product_uom_categ_vol").id) + ], + default=lambda x: x._get_vehicle_volume_uom_id_from_ir_config_parameter(), + ) + + passenger_uom_id = fields.Many2one( + "uom.uom", + string="Passenger Capacity UOM", + domain=lambda self: [ + ("category_id", "=", self.env.ref("uom.product_uom_categ_unit").id) + ], + default=lambda x: x._get_vehicle_passenger_uom_id_from_ir_config_parameter(), + ) diff --git a/fleet_vehicle_capacity/models/res_config_settings.py b/fleet_vehicle_capacity/models/res_config_settings.py new file mode 100644 index 00000000..2cbee664 --- /dev/null +++ b/fleet_vehicle_capacity/models/res_config_settings.py @@ -0,0 +1,88 @@ +# Copyright 2024 - TODAY, Marcel Savegnago +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +import logging + +from odoo import api, fields, models + +_logger = logging.getLogger(__name__) + + +class ResConfigSettings(models.TransientModel): + + _inherit = "res.config.settings" + + vehicle_weight_uom_id = fields.Many2one( + "uom.uom", + string="Default Vehicle Weight and Capacity UOM", + domain=lambda self: [ + ("category_id", "=", self.env.ref("uom.product_uom_categ_kgm").id), + ], + default=lambda self: self._default_vehicle_weight_uom_id(), + help="Default Unit of measure for vehicle weight and capacity.", + default_model="res.config.settings", + config_parameter="fleet.default_vehicle_weight_uom_id", + ) + + vehicle_volume_uom_id = fields.Many2one( + "uom.uom", + string="Default Vehicle Volume Capacity UOM", + domain=lambda self: [ + ("category_id", "=", self.env.ref("uom.product_uom_categ_vol").id), + ], + default=lambda self: self._default_vehicle_volume_uom_id(), + help="Default Unit of measure for vehicle volume capacity.", + default_model="res.config.settings", + config_parameter="fleet.default_vehicle_volume_uom_id", + ) + + vehicle_passenger_uom_id = fields.Many2one( + "uom.uom", + string="Default Vehicle Passenger Capacity UOM", + domain=lambda self: [ + ("category_id", "=", self.env.ref("uom.product_uom_categ_unit").id), + ], + default=lambda self: self._default_vehicle_passenger_uom_id(), + help="Default Unit of measure for vehicle passenger capacity.", + default_model="res.config.settings", + config_parameter="fleet.default_vehicle_passenger_uom_id", + ) + + @api.model + def _default_vehicle_weight_uom_id(self): + """Method to find and return the default UOM for vehicle weight and capacity.""" + uom = self.env["uom.uom"].search( + [ + ("category_id", "=", self.env.ref("uom.product_uom_categ_kgm").id), + ("uom_type", "=", "bigger"), + ], + limit=1, + order="id", + ) + return uom.id if uom else False + + @api.model + def _default_vehicle_volume_uom_id(self): + """Method to find and return the default UOM for vehicle volume capacity.""" + uom = self.env["uom.uom"].search( + [ + ("category_id", "=", self.env.ref("uom.product_uom_categ_vol").id), + ("uom_type", "=", "bigger"), + ], + limit=1, + order="id", + ) + return uom.id if uom else False + + @api.model + def _default_vehicle_passenger_uom_id(self): + """Method to find and return the default UOM for vehicle passenger capacity.""" + uom = self.env["uom.uom"].search( + [ + ("category_id", "=", self.env.ref("uom.product_uom_categ_unit").id), + ("uom_type", "=", "reference"), + ], + limit=1, + order="id", + ) + return uom.id if uom else False diff --git a/fleet_vehicle_capacity/readme/CONTRIBUTORS.md b/fleet_vehicle_capacity/readme/CONTRIBUTORS.md new file mode 100644 index 00000000..68e9963e --- /dev/null +++ b/fleet_vehicle_capacity/readme/CONTRIBUTORS.md @@ -0,0 +1,5 @@ + +* `Escodoo `_: + + * Marcel Savegnago + diff --git a/fleet_vehicle_capacity/readme/DESCRIPTION.md b/fleet_vehicle_capacity/readme/DESCRIPTION.md new file mode 100644 index 00000000..3ce13deb --- /dev/null +++ b/fleet_vehicle_capacity/readme/DESCRIPTION.md @@ -0,0 +1 @@ +This module adds fields to manage the weight and volume capacity in the vehicle model. It is also designed to be easily expandable, allowing the addition of other vehicle-specific capacities in the future as needed. diff --git a/fleet_vehicle_capacity/readme/USAGE.md b/fleet_vehicle_capacity/readme/USAGE.md new file mode 100644 index 00000000..d67cff56 --- /dev/null +++ b/fleet_vehicle_capacity/readme/USAGE.md @@ -0,0 +1,12 @@ +To use this module, it first needs to be installed. Upon installation, the system will automatically detect the default units of measure (UOM) for vehicle weight, volume, and passenger capacity, and assign them to vehicle models accordingly. + +The module enhances the Odoo Fleet Management system by allowing administrators to configure default UOMs for: + +* Vehicle Weight (tons) +* Vehicle Volume Capacity (cubic meters) +* Passenger Capacity (number of passengers) + +Key Features: +* Automatic Assignment of Default UOMs: After installation, the system automatically assigns default UOMs to vehicle models based on the standard UOMs (tons, cubic meters, and units). +* Configurable UOMs: The administrator can update the default UOMs for vehicle weight, volume, and passenger capacity through the system settings. Changes made to the default UOMs will be applied to all new vehicle models automatically. +* Editable Vehicle Model UOMs: While vehicle models use the default UOMs upon creation, the administrator can still manually override the UOMs for specific models if needed. diff --git a/fleet_vehicle_capacity/static/description/icon.png b/fleet_vehicle_capacity/static/description/icon.png new file mode 100644 index 00000000..3a0328b5 Binary files /dev/null and b/fleet_vehicle_capacity/static/description/icon.png differ diff --git a/fleet_vehicle_capacity/static/description/index.html b/fleet_vehicle_capacity/static/description/index.html new file mode 100644 index 00000000..f42c3d4b --- /dev/null +++ b/fleet_vehicle_capacity/static/description/index.html @@ -0,0 +1,458 @@ + + + + + +Fleet Vehicle Capacity + + + +
+

Fleet Vehicle Capacity

+ + +

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

+

This module adds fields to manage the weight and volume capacity in the +vehicle model. It is also designed to be easily expandable, allowing the +addition of other vehicle-specific capacities in the future as needed.

+

Table of contents

+ +
+

Usage

+

To use this module, it first needs to be installed. Upon installation, +the system will automatically detect the default units of measure (UOM) +for vehicle weight, volume, and passenger capacity, and assign them to +vehicle models accordingly.

+

The module enhances the Odoo Fleet Management system by allowing +administrators to configure default UOMs for:

+
    +
  • Vehicle Weight (tons)
    • +
  • Vehicle Volume Capacity (cubic meters)
    • +
  • Passenger Capacity (number of passengers)
    • +
+

Key Features:

+
    +
  • Automatic Assignment of Default UOMs: After installation, the system +automatically assigns default UOMs to vehicle models based on the +standard UOMs (tons, cubic meters, and units).
    • +
  • Configurable UOMs: The administrator can update the default UOMs for +vehicle weight, volume, and passenger capacity through the system +settings. Changes made to the default UOMs will be applied to all new +vehicle models automatically.
    • +
  • Editable Vehicle Model UOMs: While vehicle models use the default +UOMs upon creation, the administrator can still manually override the +UOMs for specific models if needed.
    • +
+
+
+

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

+
    +
  • Escodoo
    • +
+
+
+

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.

+

Current maintainer:

+

marcelsavegnago

+

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

+

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

+
+
+
+ + diff --git a/fleet_vehicle_capacity/tests/__init__.py b/fleet_vehicle_capacity/tests/__init__.py new file mode 100644 index 00000000..13aae68e --- /dev/null +++ b/fleet_vehicle_capacity/tests/__init__.py @@ -0,0 +1 @@ +from . import test_fleet_vehicle_capacity diff --git a/fleet_vehicle_capacity/tests/test_fleet_vehicle_capacity.py b/fleet_vehicle_capacity/tests/test_fleet_vehicle_capacity.py new file mode 100644 index 00000000..923d7871 --- /dev/null +++ b/fleet_vehicle_capacity/tests/test_fleet_vehicle_capacity.py @@ -0,0 +1,92 @@ +# Copyright 2024 - TODAY, Marcel Savegnago +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo.tests import common + + +class TestFleetVehicleCapacity(common.TransactionCase): + def setUp(self): + super(TestFleetVehicleCapacity, self).setUp() + + # References to standard UOMs + self.uom_ton = self.env.ref("uom.product_uom_ton") + self.uom_m3 = self.env.ref("uom.product_uom_cubic_meter") + self.uom_unit = self.env.ref("uom.product_uom_unit") + + # Create default configuration settings + self.res_config_settings = self.env["res.config.settings"].create( + { + "vehicle_weight_uom_id": self.uom_ton.id, + "vehicle_volume_uom_id": self.uom_m3.id, + "vehicle_passenger_uom_id": self.uom_unit.id, + } + ) + self.res_config_settings.execute() + + # Create a vehicle brand (fleet.model.brand) + self.vehicle_brand = self.env["fleet.vehicle.model.brand"].create( + { + "name": "Test Brand", # Name of the brand + } + ) + + # Create a vehicle model and associate it with the brand + self.vehicle_model = self.env["fleet.vehicle.model"].create( + { + "name": "Test Model", + "vehicle_weight": 5.0, + "weight_capacity": 2.0, + "volume_capacity": 10.0, + "passenger_capacity": 4.0, + "brand_id": self.vehicle_brand.id, # Associate with the created brand + } + ) + + def test_default_vehicle_weight_uom(self): + """Test if the default vehicle weight UOM is correctly applied.""" + self.assertEqual( + self.vehicle_model.weight_uom_id, + self.uom_ton, + "Default Vehicle Weight UOM is incorrect", + ) + + def test_default_vehicle_volume_uom(self): + """Test if the default vehicle volume UOM is correctly applied.""" + self.assertEqual( + self.vehicle_model.volume_uom_id, + self.uom_m3, + "Default Vehicle Volume UOM is incorrect", + ) + + def test_default_vehicle_passenger_uom(self): + """Test if the default vehicle passenger UOM is correctly applied.""" + self.assertEqual( + self.vehicle_model.passenger_uom_id, + self.uom_unit, + "Default Vehicle Passenger UOM is incorrect", + ) + + def test_vehicle_model_fields(self): + """Test if the vehicle model fields are correctly set.""" + self.assertEqual( + self.vehicle_model.vehicle_weight, 5.0, "Vehicle weight is incorrect" + ) + self.assertEqual( + self.vehicle_model.weight_capacity, 2.0, "Weight capacity is incorrect" + ) + self.assertEqual( + self.vehicle_model.volume_capacity, 10.0, "Volume capacity is incorrect" + ) + self.assertEqual( + self.vehicle_model.passenger_capacity, + 4.0, + "Passenger capacity is incorrect", + ) + + def test_vehicle_model_brand(self): + """Test if the vehicle model is correctly associated with the brand.""" + self.assertEqual( + self.vehicle_model.brand_id, + self.vehicle_brand, + "Vehicle brand is incorrect", + ) diff --git a/fleet_vehicle_capacity/views/fleet_vehicle.xml b/fleet_vehicle_capacity/views/fleet_vehicle.xml new file mode 100644 index 00000000..edb0089d --- /dev/null +++ b/fleet_vehicle_capacity/views/fleet_vehicle.xml @@ -0,0 +1,23 @@ + + + + + + fleet.vehicle + + + + + + + + + + + + + + + + diff --git a/fleet_vehicle_capacity/views/fleet_vehicle_model.xml b/fleet_vehicle_capacity/views/fleet_vehicle_model.xml new file mode 100644 index 00000000..718eea82 --- /dev/null +++ b/fleet_vehicle_capacity/views/fleet_vehicle_model.xml @@ -0,0 +1,48 @@ + + + + + + fleet.vehicle.model + + + + + + + + + + + + + + + + + + + + + + + + + + fleet.vehicle.model + + + + + + + + + + + + + + + diff --git a/fleet_vehicle_capacity/views/res_config_settings.xml b/fleet_vehicle_capacity/views/res_config_settings.xml new file mode 100644 index 00000000..60aadbe1 --- /dev/null +++ b/fleet_vehicle_capacity/views/res_config_settings.xml @@ -0,0 +1,80 @@ + + + + + + res.config.settings + + + + +
+
+
+
+
+
+
+
+ +
+
+
+
+
+
+
+
+ +
+
+
+
+
+
+
+
+ + + + + + + diff --git a/setup/fleet_vehicle_capacity/odoo/addons/fleet_vehicle_capacity b/setup/fleet_vehicle_capacity/odoo/addons/fleet_vehicle_capacity new file mode 120000 index 00000000..b7d5a549 --- /dev/null +++ b/setup/fleet_vehicle_capacity/odoo/addons/fleet_vehicle_capacity @@ -0,0 +1 @@ +../../../../fleet_vehicle_capacity \ No newline at end of file diff --git a/setup/fleet_vehicle_capacity/setup.py b/setup/fleet_vehicle_capacity/setup.py new file mode 100644 index 00000000..28c57bb6 --- /dev/null +++ b/setup/fleet_vehicle_capacity/setup.py @@ -0,0 +1,6 @@ +import setuptools + +setuptools.setup( + setup_requires=['setuptools-odoo'], + odoo_addon=True, +)