[17.0] [MIG] stock_storage_type: Migration to 17.0

stock_storage_type/README.rst

@@ -0,0 +1,199 @@
+==================
+Stock Storage Type
+==================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:0e700eefd6bcaa1449f71d59b90a1e4a57c0f749f2d282af71ca5cdd7c0e5c42
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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/17.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-17-0/wms-17-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=17.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:%2017.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 <[email protected]>
+- Guewen Baconnier <[email protected]>
+- Raphaël Reverdy <[email protected]>
+- Jacques-Etienne Baudoux <[email protected]>
+- Laurent Mignon <[email protected]>
+- Fernando La Chica - GreenICe <[email protected]>
+- Denis Roussel <[email protected]>
+
+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-jbaudoux| image:: https://github.com/jbaudoux.png?size=40px
+    :target: https://github.com/jbaudoux
+    :alt: jbaudoux
+.. |maintainer-rousseldenis| image:: https://github.com/rousseldenis.png?size=40px
+    :target: https://github.com/rousseldenis
+    :alt: rousseldenis
+
+Current `maintainers <https://odoo-community.org/page/maintainer-role>`__:
+
+|maintainer-jbaudoux| |maintainer-rousseldenis| 
+
+This module is part of the `OCA/wms <https://github.com/OCA/wms/tree/17.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,42 @@
+# Copyright 2019-2021 Camptocamp SA
+# Copyright 2019-2021 Jacques-Etienne Baudoux (BCIM) <[email protected]>
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl)
+{
+    "name": "Stock Storage Type",
+    "summary": "Manage packages and locations storage types",
+    "version": "17.0.1.0.0",
+    "development_status": "Beta",
+    "category": "Warehouse Management",
+    "website": "https://github.com/OCA/wms",
+    "author": "Camptocamp, BCIM, Odoo Community Association (OCA)",
+    "maintainers": ["jbaudoux", "rousseldenis"],
+    "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="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>