[MIG] stock_storage_type: Migration to 16.0

setup/stock_storage_type/odoo/addons/stock_storage_type

@@ -0,0 +1 @@
+../../../../stock_storage_type

setup/stock_storage_type/setup.py

@@ -0,0 +1,6 @@
+import setuptools
+
+setuptools.setup(
+    setup_requires=['setuptools-odoo'],
+    odoo_addon=True,
+)

stock_storage_type/README.rst

@@ -0,0 +1,180 @@
+==================
+Stock Storage Type
+==================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:9d8a507406a64928d2e380ecb28e8148fa11681dfad57c1d8c94810c1661e2a4
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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%2Fwms-lightgray.png?logo=github
+    :target: https://github.com/OCA/wms/tree/16.0/stock_storage_type
+    :alt: OCA/wms
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/wms-16-0/wms-16-0-stock_storage_type
+    :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/wms&target_branch=16.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+This module introduces two new models in order to manage stock moves with
+ packages according to the packaging and stock location properties.
+
+* Stock package storage type (`stock.package.storage.type`)
+
+  This model is linked to product.packaging and defines the type of storage
+  related to a specific packaging.
+
+* Stock location storage type (`stock.location.storage.type`)
+
+  This models is linked to stock.location and defines the types of storage
+  that are allowed for a specific location.
+
+Therefore a Stock location storage type can include different Stock package
+storage type in order to validate the destination of a move with package into a
+stock location.
+Moreover Stock location storage type can include product, size or lot
+restrictions for the stock locations it's defined on, so that a move with
+package will only be allowed if it doesn't violate the restrictions defined
+(cf stock_location_storage_type_strategy).
+
+Moreover, this module implements "storage type put-away strategy" in order to compute a
+put-away location using storage types.
+
+The standard put-away strategy is applied *before* the storage type put-away
+strategy as the former relies on product or product category and the latter
+relies on stock packages.
+
+In other words, when a move is assigned, Odoo standard put-away strategy will be
+applied to compute a new destination on the stock move lines, according to the
+product.
+After this first "put-away computation", the "storage type" put-away strategy
+is applied, if the reserved quant is linked to a package defining a package
+storage type.
+
+Storage locations linked to the package storage are processed sequentially, if
+said storage location is a child of the move line's destination location (i.e
+either the put-away location or the move's destination location).
+For each location, their packs storage strategy is applied as well as the
+restrictions defined on the stock location storage types.
+If no suitable location is found, the next location in the sequence will be
+searched and so on.
+
+For the packs putaway strategy "none", the location is considered as is.  For
+the "ordered children" strategy, children locations are sorted by first by max
+height which is a physical constraint to respect, then pack putaway sequence
+which allow to favor for example some level or corridor, and finally by name.
+
+At the end, if found location is not the same as the original destination location,
+the putaway strategies are applied (e.g.: A "none" pack putaway strategy is set on
+computed location and a putaway rule exists on that one).
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Known issues / Roadmap
+======================
+
+Currently, the module supports only strategies applied on packages (``stock.quant.package``).
+For implementations that do not use packages, it would be possible to add
+compatibility with product packaging.
+
+The information needed from a package are:
+
+* the storage type, to know which strategy is applied
+* the dimensions and weight, to apply constraints
+
+If we want to support product packaging, we would need to:
+
+* guess the product packaging of a move line based on the product and quantities
+  (multiple of a packaging quantity, for instance 8000 would be a pallet if the pallet
+  has 2000 units, 1900 would be Box if the Box has 100 units)
+* from the product packaging, we know the storage type and dimensions
+
+Everywhere the module is using ``package_id``, we would have to check this:
+
+* use the package if a package is set
+* else, use the computed packaging
+
+About Unit of Measures:
+
+In v13, there is an assumption of height to be expressed in mm and weight in kg.
+In v14, packaging can be expressed in differents units. Explicit fields are introduced
+like max_weight_in_kg in order make simple and efficient computations.
+
+
+Limitation
+==========
+
+If the locations structure is using views intensively in order to separate
+storage types kindly (not mixing them), Odoo standard method to get putaway
+strategy is returning the first child if a move location destination is a view.
+
+This is not convenient if we want to set specific strategies on that view. So,
+we override standard process by returning the view itself (if no putaway is set).
+
+This can lead to a change on standard behavior as people will need to change manually
+the location destination for pickings with views as default destination.
+
+Idea: maybe adding a field on view locations to say 'this is a view but don't
+apply standard child location selection' could help filtering view candidates.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/wms/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/wms/issues/new?body=module:%20stock_storage_type%0Aversion:%2016.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
+~~~~~~~
+
+* Camptocamp
+* BCIM
+
+Contributors
+~~~~~~~~~~~~
+
+* Akim Juillerat <akim.juillerat@camptocamp.com>
+* Guewen Baconnier <guewen.baconnier@camptocamp.com>
+* Raphaël Reverdy <raphael.reverdy@akretion.com>
+* Jacques-Etienne Baudoux <je@bcim.be>
+* Laurent Mignon <laurent.mignon@acsone.eu>
+* Fernando La Chica - GreenICe <fernandolachica@gmail.com>
+* Denis Roussel <denis.roussel@acsone.eu>
+
+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/wms <https://github.com/OCA/wms/tree/16.0/stock_storage_type>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

stock_storage_type/__init__.py

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

stock_storage_type/__manifest__.py

@@ -0,0 +1,41 @@
+# Copyright 2019-2021 Camptocamp SA
+# Copyright 2019-2021 Jacques-Etienne Baudoux (BCIM) <je@bcim.be>
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl)
+{
+    "name": "Stock Storage Type",
+    "summary": "Manage packages and locations storage types",
+    "version": "16.0.1.0.1",
+    "development_status": "Beta",
+    "category": "Warehouse Management",
+    "website": "https://github.com/OCA/wms",
+    "author": "Camptocamp, BCIM, Odoo Community Association (OCA)",
+    "license": "AGPL-3",
+    "application": False,
+    "installable": True,
+    "depends": [
+        "stock_move_line_reserved_quant",
+        "stock_putaway_hook",
+        "stock_quant_package_dimension",
+        "stock_storage_category_capacity_name",
+    ],
+    "data": [
+        "security/ir.model.access.csv",
+        "views/product_template.xml",
+        "views/stock_location.xml",
+        "views/stock_storage_category.xml",
+        "views/stock_storage_category_capacity.xml",
+        "views/stock_package_level.xml",
+        "views/stock_package_type.xml",
+        "views/stock_storage_location_sequence.xml",
+        "views/stock_storage_location_sequence_cond.xml",
+        "views/storage_type_menus.xml",
+    ],
+    "demo": [
+        "demo/stock_package_type.xml",
+        "demo/stock_storage_category.xml",
+        "demo/stock_storage_category_capacity.xml",
+        "demo/product_packaging.xml",
+        "demo/stock_location.xml",
+        "demo/stock_storage_location_sequence.xml",
+    ],
+}

stock_storage_type/demo/product_packaging.xml

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<odoo noupdate="1">
+    <record id="product_product_9_packaging_single_bag" model="product.packaging">
+        <field name="name">Single bag</field>
+        <field name="qty">1</field>
+        <field name="product_id" ref="product.product_product_9" />
+    </record>
+    <record id="product_product_9_packaging_4_cardbox" model="product.packaging">
+        <field name="name">4 units cardbox</field>
+        <field name="qty">4</field>
+        <field name="product_id" ref="product.product_product_9" />
+        <field name="package_type_id" ref="package_storage_type_cardboxes" />
+    </record>
+    <record id="product_product_9_packaging_48_pallet" model="product.packaging">
+        <field name="name">48 units pallet</field>
+        <field name="qty">48</field>
+        <field name="product_id" ref="product.product_product_9" />
+        <field name="package_type_id" ref="package_storage_type_pallets" />
+        <field name="packaging_length">1200</field>
+        <field name="width">800</field>
+        <field name="height">1500</field>
+        <field name="max_weight">60</field>
+    </record>
+</odoo>

stock_storage_type/demo/stock_location.xml

@@ -0,0 +1,107 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<odoo noupdate="1">
+    <record id="stock_location_cardboxes" model="stock.location">
+        <field name="name">Cardboxes storage area</field>
+        <field
+            name="location_id"
+            model="stock.location"
+            eval="obj().env.ref('stock.warehouse0').lot_stock_id.id"
+        />
+        <field name="storage_category_id" ref="storage_category_cardboxes" />
+        <field name="pack_putaway_strategy">ordered_locations</field>
+    </record>
+    <record id="stock_location_cardboxes_bin_1" model="stock.location">
+        <field name="name">Bin 1</field>
+        <field name="location_id" ref="stock_location_cardboxes" />
+    </record>
+    <record id="stock_location_cardboxes_bin_2" model="stock.location">
+        <field name="name">Bin 2</field>
+        <field name="location_id" ref="stock_location_cardboxes" />
+    </record>
+    <record id="stock_location_cardboxes_bin_3" model="stock.location">
+        <field name="name">Bin 3</field>
+        <field name="location_id" ref="stock_location_cardboxes" />
+    </record>
+    <record id="stock_location_cardboxes_bin_4" model="stock.location">
+        <field name="name">Bin 4</field>
+        <field name="location_id" ref="stock_location_cardboxes" />
+    </record>
+    <record id="stock_location_pallets" model="stock.location">
+        <field name="name">Pallets storage area</field>
+        <field
+            name="location_id"
+            model="stock.location"
+            eval="obj().env.ref('stock.warehouse0').lot_stock_id.id"
+        />
+        <field name="storage_category_id" ref="storage_category_pallets" />
+        <field name="pack_putaway_strategy">ordered_locations</field>
+    </record>
+    <record id="stock_location_pallets_bin_1" model="stock.location">
+        <field name="name">Pallets Bin 1</field>
+        <field name="location_id" ref="stock_location_pallets" />
+    </record>
+    <record id="stock_location_pallets_bin_2" model="stock.location">
+        <field name="name">Pallets Bin 2</field>
+        <field name="location_id" ref="stock_location_pallets" />
+    </record>
+    <record id="stock_location_pallets_bin_3" model="stock.location">
+        <field name="name">Pallets Bin 3</field>
+        <field name="location_id" ref="stock_location_pallets" />
+    </record>
+    <record id="stock_location_pallets_bin_4" model="stock.location">
+        <field name="name">Pallets Bin 4</field>
+        <field name="location_id" ref="stock_location_pallets" />
+    </record>
+    <record id="stock_location_pallets_reserve" model="stock.location">
+        <field name="name">Pallets reserve storage area</field>
+        <field
+            name="location_id"
+            model="stock.location"
+            eval="obj().env.ref('stock.warehouse0').lot_stock_id.id"
+        />
+        <field name="storage_category_id" ref="storage_category_pallets" />
+        <field name="pack_putaway_strategy">ordered_locations</field>
+    </record>
+    <record id="stock_location_pallets_reserve_bin_1" model="stock.location">
+        <field name="name">Pallets Reserve Bin 1</field>
+        <field name="location_id" ref="stock_location_pallets_reserve" />
+    </record>
+    <record id="stock_location_pallets_reserve_bin_2" model="stock.location">
+        <field name="name">Pallets Reserve Bin 2</field>
+        <field name="location_id" ref="stock_location_pallets_reserve" />
+    </record>
+    <record id="stock_location_pallets_reserve_bin_3" model="stock.location">
+        <field name="name">Pallets Reserve Bin 3</field>
+        <field name="location_id" ref="stock_location_pallets_reserve" />
+    </record>
+    <record id="stock_location_pallets_reserve_bin_4" model="stock.location">
+        <field name="name">Pallets Reserve Bin 4</field>
+        <field name="location_id" ref="stock_location_pallets_reserve" />
+    </record>
+    <record id="stock_location_cardboxes_reserve" model="stock.location">
+        <field name="name">Cardboxes reserve storage area</field>
+        <field
+            name="location_id"
+            model="stock.location"
+            eval="obj().env.ref('stock.warehouse0').lot_stock_id.id"
+        />
+        <field name="storage_category_id" ref="storage_category_cardboxes" />
+        <field name="pack_putaway_strategy">ordered_locations</field>
+    </record>
+    <record id="stock_location_cardboxes_reserve_bin_1" model="stock.location">
+        <field name="name">Cardboxes Reserve Bin 1</field>
+        <field name="location_id" ref="stock_location_cardboxes_reserve" />
+    </record>
+    <record id="stock_location_cardboxes_reserve_bin_2" model="stock.location">
+        <field name="name">Cardboxes Reserve Bin 2</field>
+        <field name="location_id" ref="stock_location_cardboxes_reserve" />
+    </record>
+    <record id="stock_location_cardboxes_reserve_bin_3" model="stock.location">
+        <field name="name">Cardboxes Reserve Bin 3</field>
+        <field name="location_id" ref="stock_location_cardboxes_reserve" />
+    </record>
+    <record id="stock_location_cardboxes_reserve_bin_4" model="stock.location">
+        <field name="name">Cardboxes Reserve Bin 4</field>
+        <field name="location_id" ref="stock_location_cardboxes_reserve" />
+    </record>
+</odoo>

stock_storage_type/demo/stock_package_type.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<odoo noupdate="1">
+    <record id="package_storage_type_pallets" model="stock.package.type">
+        <field name="name">Pallets</field>
+    </record>
+    <record id="package_storage_type_pallets_uk" model="stock.package.type">
+        <field name="name">Pallets UK</field>
+    </record>
+    <record id="package_storage_type_cardboxes" model="stock.package.type">
+        <field name="name">Cardboxes</field>
+    </record>
+</odoo>

stock_storage_type/demo/stock_storage_category.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!-- Copyright 2022 ACSONE SA/NV
+     License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). -->
+<odoo noupdate="1">
+    <record id="storage_category_pallets" model="stock.storage.category">
+        <field name="name">Pallets</field>
+    </record>
+    <record id="storage_category_cardboxes" model="stock.storage.category">
+        <field name="name">Cardboxes</field>
+    </record>
+</odoo>