From 26c05ac74b80cf56a85b19e4b45ef4e50c9b56f3 Mon Sep 17 00:00:00 2001 From: yostashiro Date: Thu, 18 Jun 2026 05:12:38 +0000 Subject: [PATCH] [ADD] stock_lot_quality_status: assign quality status to lots Add a module providing a dedicated, configurable stock.lot.quality.status model and a quality_status_id field on stock.lot, so serial/lot numbers can be classified by inventory quality condition. Ships under LGPL-3 to avoid the AGPL licensing of the OCA stock_lot_condition alternative. --- stock_lot_quality_status/README.rst | 120 +++++ stock_lot_quality_status/__init__.py | 1 + stock_lot_quality_status/__manifest__.py | 20 + stock_lot_quality_status/i18n/ja.po | 233 +++++++++ .../i18n/stock_lot_quality_status.pot | 232 +++++++++ stock_lot_quality_status/models/__init__.py | 3 + stock_lot_quality_status/models/stock_lot.py | 22 + .../models/stock_lot_quality_status.py | 60 +++ .../models/stock_quant.py | 13 + stock_lot_quality_status/pyproject.toml | 3 + .../readme/DESCRIPTION.md | 26 + stock_lot_quality_status/readme/USAGE.md | 19 + .../security/ir.model.access.csv | 3 + .../static/description/index.html | 467 ++++++++++++++++++ stock_lot_quality_status/tests/__init__.py | 1 + .../tests/test_quality_status.py | 73 +++ .../views/stock_lot_quality_status_views.xml | 128 +++++ .../views/stock_lot_views.xml | 43 ++ .../views/stock_quant_views.xml | 43 ++ 19 files changed, 1510 insertions(+) create mode 100644 stock_lot_quality_status/README.rst create mode 100644 stock_lot_quality_status/__init__.py create mode 100644 stock_lot_quality_status/__manifest__.py create mode 100644 stock_lot_quality_status/i18n/ja.po create mode 100644 stock_lot_quality_status/i18n/stock_lot_quality_status.pot create mode 100644 stock_lot_quality_status/models/__init__.py create mode 100644 stock_lot_quality_status/models/stock_lot.py create mode 100644 stock_lot_quality_status/models/stock_lot_quality_status.py create mode 100644 stock_lot_quality_status/models/stock_quant.py create mode 100644 stock_lot_quality_status/pyproject.toml create mode 100644 stock_lot_quality_status/readme/DESCRIPTION.md create mode 100644 stock_lot_quality_status/readme/USAGE.md create mode 100644 stock_lot_quality_status/security/ir.model.access.csv create mode 100644 stock_lot_quality_status/static/description/index.html create mode 100644 stock_lot_quality_status/tests/__init__.py create mode 100644 stock_lot_quality_status/tests/test_quality_status.py create mode 100644 stock_lot_quality_status/views/stock_lot_quality_status_views.xml create mode 100644 stock_lot_quality_status/views/stock_lot_views.xml create mode 100644 stock_lot_quality_status/views/stock_quant_views.xml diff --git a/stock_lot_quality_status/README.rst b/stock_lot_quality_status/README.rst new file mode 100644 index 0000000..f305527 --- /dev/null +++ b/stock_lot_quality_status/README.rst @@ -0,0 +1,120 @@ +.. image:: https://odoo-community.org/readme-banner-image + :target: https://odoo-community.org/get-involved?utm_source=readme + :alt: Odoo Community Association + +======================== +Stock Lot Quality Status +======================== + +.. + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! This file is generated by oca-gen-addon-readme !! + !! changes will be overwritten. !! + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! source digest: sha256:758b1e3be8109819391894f20df61afc1b3072c1516f9aca6cc131e93cf4e50d + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + +.. |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/license-LGPL--3-blue.png + :target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html + :alt: License: LGPL-3 +.. |badge3| image:: https://img.shields.io/badge/github-qrtl%2FOCJ Custom-lightgray.png?logo=github + :target: https://github.com/qrtl/OCJ Custom/tree/19.0/stock_lot_quality_status + :alt: qrtl/OCJ Custom + +|badge1| |badge2| |badge3| + +This module adds a configurable **quality status** to serial/lot +numbers. + +A dedicated ``stock.lot.quality.status`` model holds the available +statuses, so they can be maintained by users instead of being +hard-coded. Each lot/serial number can then be assigned one of these +statuses. + +The module provides the model and the configuration UI but does not ship +any predefined statuses, so the classification can be tailored to each +deployment (for example through a company-specific data module). + +Each status carries: + +- a **major category** used as the aggregation axis for inventory and + accounting reports; +- a **shippability** flag (shippable / conditional / not shippable) + shown with a colour in the list; +- an optional **shippability note** for qualifiers such as *ship + A-grade first* or *repair vendor only*; +- a **shipping priority** for ordering shippable stock; and +- a **default** flag so newly created lots/serials receive a status + automatically. + +The status is informational on its own. It is intended as a foundation +for features that act on it — for example restricting whether stock with +a given quality status can be shipped, or automating status transitions +on receipt and repair returns — which can be layered on top in separate +modules. + +**Table of contents** + +.. contents:: + :local: + +Usage +===== + +To configure the available quality statuses: + +1. Go to *Inventory > Configuration > Quality Statuses*. +2. The module does not ship any statuses. Create the statuses you need + (or install a data module that provides them), then edit, reorder or + archive them as needed. +3. Set the **shippability**, **major category**, **shipping priority** + and **shippability note** of each status as required. The list is + colour-coded by shippability (green = shippable, orange = + conditional, red = not shippable). +4. Flag at most one status as **Default for New Lots**. New lots/serials + will be created with that status. + +To assign a quality status to a lot/serial number: + +1. Open a serial/lot number (*Inventory > Products > Lots/Serial + Numbers*). +2. Set the **Quality Status** field. + +The status is also available as a column and as a *Group By* option in +the lot/serial number and quant lists. + +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 + +Maintainers +----------- + +.. |maintainer-yostashiro| image:: https://github.com/yostashiro.png?size=40px + :target: https://github.com/yostashiro + :alt: yostashiro + +Current maintainer: + +|maintainer-yostashiro| + +This module is part of the `qrtl/OCJ Custom `_ project on GitHub. + +You are welcome to contribute. diff --git a/stock_lot_quality_status/__init__.py b/stock_lot_quality_status/__init__.py new file mode 100644 index 0000000..0650744 --- /dev/null +++ b/stock_lot_quality_status/__init__.py @@ -0,0 +1 @@ +from . import models diff --git a/stock_lot_quality_status/__manifest__.py b/stock_lot_quality_status/__manifest__.py new file mode 100644 index 0000000..de6f008 --- /dev/null +++ b/stock_lot_quality_status/__manifest__.py @@ -0,0 +1,20 @@ +# Copyright 2026 Quartile (https://www.quartile.co) +# License LGPL-3.0 or later (https://www.gnu.org/licenses/lgpl). +{ + "name": "Stock Lot Quality Status", + "version": "19.0.1.0.0", + "category": "Inventory/Inventory", + "website": "https://www.quartile.co", + "author": "Quartile", + "maintainers": ["yostashiro"], + "license": "LGPL-3", + "summary": "Assign a configurable quality status to serial/lot numbers", + "installable": True, + "depends": ["stock"], + "data": [ + "security/ir.model.access.csv", + "views/stock_lot_quality_status_views.xml", + "views/stock_lot_views.xml", + "views/stock_quant_views.xml", + ], +} diff --git a/stock_lot_quality_status/i18n/ja.po b/stock_lot_quality_status/i18n/ja.po new file mode 100644 index 0000000..c8a49c4 --- /dev/null +++ b/stock_lot_quality_status/i18n/ja.po @@ -0,0 +1,233 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * stock_lot_quality_status +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 19.0\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language-Team: \n" +"Language: ja\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: nplurals=1; plural=0;\n" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__active +msgid "Active" +msgstr "有効" + +#. module: stock_lot_quality_status +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.stock_lot_quality_status_view_form +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.stock_lot_quality_status_view_search +msgid "Archived" +msgstr "アーカイブ済み" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__code +msgid "Code" +msgstr "コード" + +#. module: stock_lot_quality_status +#: model:ir.model.fields.selection,name:stock_lot_quality_status.selection__stock_lot_quality_status__shippability__conditional +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.stock_lot_quality_status_view_search +msgid "Conditional" +msgstr "条件付" + +#. module: stock_lot_quality_status +#: model_terms:ir.actions.act_window,help:stock_lot_quality_status.stock_lot_quality_status_action +msgid "Create a quality status" +msgstr "品質区分を作成" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__create_uid +msgid "Created by" +msgstr "作成者" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__create_date +msgid "Created on" +msgstr "作成日" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__is_default +msgid "Default for New Lots" +msgstr "新規ロットのデフォルト" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__description +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.stock_lot_quality_status_view_form +msgid "Description" +msgstr "説明" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot__display_name +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__display_name +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_quant__display_name +msgid "Display Name" +msgstr "表示名" + +#. module: stock_lot_quality_status +#: model:ir.model.fields.selection,name:stock_lot_quality_status.selection__stock_lot_quality_status__category__excluded +msgid "Excluded" +msgstr "対象外" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,help:stock_lot_quality_status.field_stock_lot_quality_status__shippability_note +msgid "" +"Free-text qualifier for the shippability (e.g. ship A-grade first, repair " +"vendor only, maintenance branch only)." +msgstr "出荷可否の自由記入の補足（例：A先出し、修理先のみ、整備支店のみ）。" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot__id +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__id +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_quant__id +msgid "ID" +msgstr "ID" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__write_uid +msgid "Last Updated by" +msgstr "最終更新者" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__write_date +msgid "Last Updated on" +msgstr "最終更新日" + +#. module: stock_lot_quality_status +#: model:ir.model,name:stock_lot_quality_status.model_stock_lot +msgid "Lot/Serial" +msgstr "ロット/シリアル番号" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__category +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.stock_lot_quality_status_view_search +msgid "Major Category" +msgstr "大区分" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__name +msgid "Name" +msgstr "名前" + +#. module: stock_lot_quality_status +#: model:ir.model.fields.selection,name:stock_lot_quality_status.selection__stock_lot_quality_status__shippability__no +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.stock_lot_quality_status_view_search +msgid "Not Shippable" +msgstr "不可" + +#. module: stock_lot_quality_status +#. odoo-python +#: code:addons/stock_lot_quality_status/models/stock_lot_quality_status.py:0 +msgid "Only one quality status can be set as the default for new lots." +msgstr "新規ロットのデフォルトに設定できる品質区分は1つだけです。" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,help:stock_lot_quality_status.field_stock_lot_quality_status__code +msgid "Optional short code for referencing this status." +msgstr "この区分を参照するための任意の短縮コード。" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,help:stock_lot_quality_status.field_stock_lot_quality_status__shipping_priority +msgid "" +"Picking order among shippable statuses (lower is picked first). 0 means the " +"status is not part of the shipping order." +msgstr "出荷可能な区分の中でのピッキング順（小さいほど先にピックされます）。0はその区分が出荷順の対象外であることを意味します。" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot__quality_status_id +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_quant__quality_status_id +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.quant_search_view +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.search_product_lot_filter +msgid "Quality Status" +msgstr "品質区分" + +#. module: stock_lot_quality_status +#: model:ir.actions.act_window,name:stock_lot_quality_status.stock_lot_quality_status_action +#: model:ir.ui.menu,name:stock_lot_quality_status.stock_lot_quality_status_menu +msgid "Quality Statuses" +msgstr "品質区分" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,help:stock_lot_quality_status.field_stock_lot__quality_status_id +#: model:ir.model.fields,help:stock_lot_quality_status.field_stock_quant__quality_status_id +msgid "Quality status of this serial/lot number." +msgstr "このシリアル/ロット番号の品質区分。" + +#. module: stock_lot_quality_status +#: model_terms:ir.actions.act_window,help:stock_lot_quality_status.stock_lot_quality_status_action +msgid "" +"Quality statuses can be assigned to serial/lot numbers to\n" +" classify their inventory condition." +msgstr "品質区分はシリアル/ロット番号に割り当てて、在庫の状態を分類できます。" + +#. module: stock_lot_quality_status +#: model:ir.model,name:stock_lot_quality_status.model_stock_quant +msgid "Quants" +msgstr "クアント" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__sequence +msgid "Sequence" +msgstr "シーケンス" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__shippability +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.stock_lot_quality_status_view_search +msgid "Shippability" +msgstr "出荷可否" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__shippability_note +msgid "Shippability Note" +msgstr "出荷可否備考" + +#. module: stock_lot_quality_status +#: model:ir.model.fields.selection,name:stock_lot_quality_status.selection__stock_lot_quality_status__shippability__yes +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.stock_lot_quality_status_view_search +msgid "Shippable" +msgstr "可" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__shipping_priority +msgid "Shipping Priority" +msgstr "出荷順" + +#. module: stock_lot_quality_status +#: model:ir.model,name:stock_lot_quality_status.model_stock_lot_quality_status +msgid "Stock Lot Quality Status" +msgstr "在庫ロット品質区分" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,help:stock_lot_quality_status.field_stock_lot_quality_status__category +msgid "" +"Stock-activity grouping used as the aggregation axis for inventory and " +"accounting reports." +msgstr "在庫・会計レポートの集約軸として用いる在庫活性度のグルーピング。" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,help:stock_lot_quality_status.field_stock_lot_quality_status__is_default +msgid "" +"The status assigned to newly created lots/serials when none is set. Only one" +" status can be the default." +msgstr "未設定の場合に新規作成されたロット/シリアルに割り当てられる区分。デフォルトに設定できる区分は1つだけです。" + +#. module: stock_lot_quality_status +#: model:ir.model.fields.selection,name:stock_lot_quality_status.selection__stock_lot_quality_status__category__usable +msgid "Usable Stock" +msgstr "使える在庫" + +#. module: stock_lot_quality_status +#: model:ir.model.fields.selection,name:stock_lot_quality_status.selection__stock_lot_quality_status__category__usable_unshippable +msgid "Usable Stock (Not Shippable)" +msgstr "使える在庫(出荷不可)" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,help:stock_lot_quality_status.field_stock_lot_quality_status__shippability +msgid "Whether stock with this status can be shipped to patients." +msgstr "この区分の在庫を患者に出荷できるかどうか。" + diff --git a/stock_lot_quality_status/i18n/stock_lot_quality_status.pot b/stock_lot_quality_status/i18n/stock_lot_quality_status.pot new file mode 100644 index 0000000..3895d0a --- /dev/null +++ b/stock_lot_quality_status/i18n/stock_lot_quality_status.pot @@ -0,0 +1,232 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * stock_lot_quality_status +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 19.0\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: \n" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__active +msgid "Active" +msgstr "" + +#. module: stock_lot_quality_status +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.stock_lot_quality_status_view_form +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.stock_lot_quality_status_view_search +msgid "Archived" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__code +msgid "Code" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields.selection,name:stock_lot_quality_status.selection__stock_lot_quality_status__shippability__conditional +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.stock_lot_quality_status_view_search +msgid "Conditional" +msgstr "" + +#. module: stock_lot_quality_status +#: model_terms:ir.actions.act_window,help:stock_lot_quality_status.stock_lot_quality_status_action +msgid "Create a quality status" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__create_uid +msgid "Created by" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__create_date +msgid "Created on" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__is_default +msgid "Default for New Lots" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__description +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.stock_lot_quality_status_view_form +msgid "Description" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot__display_name +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__display_name +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_quant__display_name +msgid "Display Name" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields.selection,name:stock_lot_quality_status.selection__stock_lot_quality_status__category__excluded +msgid "Excluded" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,help:stock_lot_quality_status.field_stock_lot_quality_status__shippability_note +msgid "" +"Free-text qualifier for the shippability (e.g. ship A-grade first, repair " +"vendor only, maintenance branch only)." +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot__id +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__id +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_quant__id +msgid "ID" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__write_uid +msgid "Last Updated by" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__write_date +msgid "Last Updated on" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model,name:stock_lot_quality_status.model_stock_lot +msgid "Lot/Serial" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__category +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.stock_lot_quality_status_view_search +msgid "Major Category" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__name +msgid "Name" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields.selection,name:stock_lot_quality_status.selection__stock_lot_quality_status__shippability__no +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.stock_lot_quality_status_view_search +msgid "Not Shippable" +msgstr "" + +#. module: stock_lot_quality_status +#. odoo-python +#: code:addons/stock_lot_quality_status/models/stock_lot_quality_status.py:0 +msgid "Only one quality status can be set as the default for new lots." +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,help:stock_lot_quality_status.field_stock_lot_quality_status__code +msgid "Optional short code for referencing this status." +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,help:stock_lot_quality_status.field_stock_lot_quality_status__shipping_priority +msgid "" +"Picking order among shippable statuses (lower is picked first). 0 means the " +"status is not part of the shipping order." +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot__quality_status_id +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_quant__quality_status_id +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.quant_search_view +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.search_product_lot_filter +msgid "Quality Status" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.actions.act_window,name:stock_lot_quality_status.stock_lot_quality_status_action +#: model:ir.ui.menu,name:stock_lot_quality_status.stock_lot_quality_status_menu +msgid "Quality Statuses" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,help:stock_lot_quality_status.field_stock_lot__quality_status_id +#: model:ir.model.fields,help:stock_lot_quality_status.field_stock_quant__quality_status_id +msgid "Quality status of this serial/lot number." +msgstr "" + +#. module: stock_lot_quality_status +#: model_terms:ir.actions.act_window,help:stock_lot_quality_status.stock_lot_quality_status_action +msgid "" +"Quality statuses can be assigned to serial/lot numbers to\n" +" classify their inventory condition." +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model,name:stock_lot_quality_status.model_stock_quant +msgid "Quants" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__sequence +msgid "Sequence" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__shippability +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.stock_lot_quality_status_view_search +msgid "Shippability" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__shippability_note +msgid "Shippability Note" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields.selection,name:stock_lot_quality_status.selection__stock_lot_quality_status__shippability__yes +#: model_terms:ir.ui.view,arch_db:stock_lot_quality_status.stock_lot_quality_status_view_search +msgid "Shippable" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,field_description:stock_lot_quality_status.field_stock_lot_quality_status__shipping_priority +msgid "Shipping Priority" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model,name:stock_lot_quality_status.model_stock_lot_quality_status +msgid "Stock Lot Quality Status" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,help:stock_lot_quality_status.field_stock_lot_quality_status__category +msgid "" +"Stock-activity grouping used as the aggregation axis for inventory and " +"accounting reports." +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,help:stock_lot_quality_status.field_stock_lot_quality_status__is_default +msgid "" +"The status assigned to newly created lots/serials when none is set. Only one" +" status can be the default." +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields.selection,name:stock_lot_quality_status.selection__stock_lot_quality_status__category__usable +msgid "Usable Stock" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields.selection,name:stock_lot_quality_status.selection__stock_lot_quality_status__category__usable_unshippable +msgid "Usable Stock (Not Shippable)" +msgstr "" + +#. module: stock_lot_quality_status +#: model:ir.model.fields,help:stock_lot_quality_status.field_stock_lot_quality_status__shippability +msgid "Whether stock with this status can be shipped to patients." +msgstr "" + diff --git a/stock_lot_quality_status/models/__init__.py b/stock_lot_quality_status/models/__init__.py new file mode 100644 index 0000000..8039f81 --- /dev/null +++ b/stock_lot_quality_status/models/__init__.py @@ -0,0 +1,3 @@ +from . import stock_lot_quality_status +from . import stock_lot +from . import stock_quant diff --git a/stock_lot_quality_status/models/stock_lot.py b/stock_lot_quality_status/models/stock_lot.py new file mode 100644 index 0000000..2561363 --- /dev/null +++ b/stock_lot_quality_status/models/stock_lot.py @@ -0,0 +1,22 @@ +# Copyright 2026 Quartile (https://www.quartile.co) +# License LGPL-3.0 or later (https://www.gnu.org/licenses/lgpl). + +from odoo import fields, models + + +class StockLot(models.Model): + _inherit = "stock.lot" + + def _default_quality_status_id(self): + return self.env["stock.lot.quality.status"].search( + [("is_default", "=", True)], limit=1 + ) + + quality_status_id = fields.Many2one( + comodel_name="stock.lot.quality.status", + string="Quality Status", + ondelete="restrict", + tracking=True, + default=lambda self: self._default_quality_status_id(), + help="Quality status of this serial/lot number.", + ) diff --git a/stock_lot_quality_status/models/stock_lot_quality_status.py b/stock_lot_quality_status/models/stock_lot_quality_status.py new file mode 100644 index 0000000..c4f3e52 --- /dev/null +++ b/stock_lot_quality_status/models/stock_lot_quality_status.py @@ -0,0 +1,60 @@ +# Copyright 2026 Quartile (https://www.quartile.co) +# License LGPL-3.0 or later (https://www.gnu.org/licenses/lgpl). + +from odoo import api, fields, models +from odoo.exceptions import ValidationError + + +class StockLotQualityStatus(models.Model): + _name = "stock.lot.quality.status" + _description = "Stock Lot Quality Status" + _order = "sequence, id" + + name = fields.Char(required=True, translate=True) + code = fields.Char(help="Optional short code for referencing this status.") + sequence = fields.Integer(default=10) + active = fields.Boolean(default=True) + category = fields.Selection( + [ + ("usable", "Usable Stock"), + ("usable_unshippable", "Usable Stock (Not Shippable)"), + ("excluded", "Excluded"), + ], + string="Major Category", + help="Stock-activity grouping used as the aggregation axis for inventory " + "and accounting reports.", + ) + shippability = fields.Selection( + [ + ("yes", "Shippable"), + ("conditional", "Conditional"), + ("no", "Not Shippable"), + ], + help="Whether stock with this status can be shipped to patients.", + ) + shippability_note = fields.Char( + help="Free-text qualifier for the shippability " + "(e.g. ship A-grade first, repair vendor only, maintenance branch only)." + ) + shipping_priority = fields.Integer( + help="Picking order among shippable statuses (lower is picked first). " + "0 means the status is not part of the shipping order.", + ) + is_default = fields.Boolean( + string="Default for New Lots", + help="The status assigned to newly created lots/serials when none is set. " + "Only one status can be the default.", + ) + description = fields.Text(translate=True) + + @api.constrains("is_default") + def _check_single_default(self): + if ( + self.filtered("is_default") + and self.search_count([("is_default", "=", True)]) > 1 + ): + raise ValidationError( + self.env._( + "Only one quality status can be set as the default for new lots." + ) + ) diff --git a/stock_lot_quality_status/models/stock_quant.py b/stock_lot_quality_status/models/stock_quant.py new file mode 100644 index 0000000..ead85cc --- /dev/null +++ b/stock_lot_quality_status/models/stock_quant.py @@ -0,0 +1,13 @@ +# Copyright 2026 Quartile (https://www.quartile.co) +# License LGPL-3.0 or later (https://www.gnu.org/licenses/lgpl). + +from odoo import fields, models + + +class StockQuant(models.Model): + _inherit = "stock.quant" + + quality_status_id = fields.Many2one( + related="lot_id.quality_status_id", + store=True, + ) diff --git a/stock_lot_quality_status/pyproject.toml b/stock_lot_quality_status/pyproject.toml new file mode 100644 index 0000000..4231d0c --- /dev/null +++ b/stock_lot_quality_status/pyproject.toml @@ -0,0 +1,3 @@ +[build-system] +requires = ["whool"] +build-backend = "whool.buildapi" diff --git a/stock_lot_quality_status/readme/DESCRIPTION.md b/stock_lot_quality_status/readme/DESCRIPTION.md new file mode 100644 index 0000000..eb11c9d --- /dev/null +++ b/stock_lot_quality_status/readme/DESCRIPTION.md @@ -0,0 +1,26 @@ +This module adds a configurable **quality status** to serial/lot numbers. + +A dedicated `stock.lot.quality.status` model holds the available statuses, so +they can be maintained by users instead of being hard-coded. Each lot/serial +number can then be assigned one of these statuses. + +The module provides the model and the configuration UI but does not ship any +predefined statuses, so the classification can be tailored to each deployment +(for example through a company-specific data module). + +Each status carries: + +- a **major category** used as the aggregation axis for inventory and + accounting reports; +- a **shippability** flag (shippable / conditional / not shippable) shown with a + colour in the list; +- an optional **shippability note** for qualifiers such as *ship A-grade first* + or *repair vendor only*; +- a **shipping priority** for ordering shippable stock; and +- a **default** flag so newly created lots/serials receive a status + automatically. + +The status is informational on its own. It is intended as a foundation for +features that act on it — for example restricting whether stock with a given +quality status can be shipped, or automating status transitions on receipt and +repair returns — which can be layered on top in separate modules. diff --git a/stock_lot_quality_status/readme/USAGE.md b/stock_lot_quality_status/readme/USAGE.md new file mode 100644 index 0000000..2ea302f --- /dev/null +++ b/stock_lot_quality_status/readme/USAGE.md @@ -0,0 +1,19 @@ +To configure the available quality statuses: + +1. Go to *Inventory > Configuration > Quality Statuses*. +2. The module does not ship any statuses. Create the statuses you need (or + install a data module that provides them), then edit, reorder or archive them + as needed. +3. Set the **shippability**, **major category**, **shipping priority** and + **shippability note** of each status as required. The list is colour-coded by + shippability (green = shippable, orange = conditional, red = not shippable). +4. Flag at most one status as **Default for New Lots**. New lots/serials will be + created with that status. + +To assign a quality status to a lot/serial number: + +1. Open a serial/lot number (*Inventory > Products > Lots/Serial Numbers*). +2. Set the **Quality Status** field. + +The status is also available as a column and as a *Group By* option in the lot/serial +number and quant lists. diff --git a/stock_lot_quality_status/security/ir.model.access.csv b/stock_lot_quality_status/security/ir.model.access.csv new file mode 100644 index 0000000..a6a4604 --- /dev/null +++ b/stock_lot_quality_status/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_stock_lot_quality_status_user,stock.lot.quality.status user,model_stock_lot_quality_status,base.group_user,1,0,0,0 +access_stock_lot_quality_status_manager,stock.lot.quality.status manager,model_stock_lot_quality_status,stock.group_stock_manager,1,1,1,1 diff --git a/stock_lot_quality_status/static/description/index.html b/stock_lot_quality_status/static/description/index.html new file mode 100644 index 0000000..46c5552 --- /dev/null +++ b/stock_lot_quality_status/static/description/index.html @@ -0,0 +1,467 @@ + + + + + +README.rst + + + +
+ + + +Odoo Community Association + +
+

Stock Lot Quality Status

+ +

Beta License: LGPL-3 qrtl/OCJ Custom

+

This module adds a configurable quality status to serial/lot +numbers.

+

A dedicated stock.lot.quality.status model holds the available +statuses, so they can be maintained by users instead of being +hard-coded. Each lot/serial number can then be assigned one of these +statuses.

+

The module provides the model and the configuration UI but does not ship +any predefined statuses, so the classification can be tailored to each +deployment (for example through a company-specific data module).

+

Each status carries:

+
    +
  • a major category used as the aggregation axis for inventory and +accounting reports;
    • +
  • a shippability flag (shippable / conditional / not shippable) +shown with a colour in the list;
    • +
  • an optional shippability note for qualifiers such as ship +A-grade first or repair vendor only;
    • +
  • a shipping priority for ordering shippable stock; and
    • +
  • a default flag so newly created lots/serials receive a status +automatically.
    • +
+

The status is informational on its own. It is intended as a foundation +for features that act on it — for example restricting whether stock with +a given quality status can be shipped, or automating status transitions +on receipt and repair returns — which can be layered on top in separate +modules.

+

Table of contents

+ +
+

Usage

+

To configure the available quality statuses:

+
    +
  1. Go to Inventory > Configuration > Quality Statuses.
    2. +
  2. The module does not ship any statuses. Create the statuses you need +(or install a data module that provides them), then edit, reorder or +archive them as needed.
    3. +
  3. Set the shippability, major category, shipping priority +and shippability note of each status as required. The list is +colour-coded by shippability (green = shippable, orange = +conditional, red = not shippable).
    4. +
  4. Flag at most one status as Default for New Lots. New lots/serials +will be created with that status.
    5. +
+

To assign a quality status to a lot/serial number:

+
    +
  1. Open a serial/lot number (Inventory > Products > Lots/Serial +Numbers).
    2. +
  2. Set the Quality Status field.
    3. +
+

The status is also available as a column and as a Group By option in +the lot/serial number and quant lists.

+
+
+

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
    • +
+
+
+

Maintainers

+

Current maintainer:

+

yostashiro

+

This module is part of the qrtl/OCJ Custom project on GitHub.

+

You are welcome to contribute.

+
+
+
+
+ + diff --git a/stock_lot_quality_status/tests/__init__.py b/stock_lot_quality_status/tests/__init__.py new file mode 100644 index 0000000..d375f7c --- /dev/null +++ b/stock_lot_quality_status/tests/__init__.py @@ -0,0 +1 @@ +from . import test_quality_status diff --git a/stock_lot_quality_status/tests/test_quality_status.py b/stock_lot_quality_status/tests/test_quality_status.py new file mode 100644 index 0000000..485af75 --- /dev/null +++ b/stock_lot_quality_status/tests/test_quality_status.py @@ -0,0 +1,73 @@ +# Copyright 2026 Quartile (https://www.quartile.co) +# License LGPL-3.0 or later (https://www.gnu.org/licenses/lgpl). + +import psycopg2 + +from odoo.exceptions import ValidationError +from odoo.tests.common import TransactionCase +from odoo.tools import mute_logger + + +class TestQualityStatus(TransactionCase): + @classmethod + def setUpClass(cls): + super().setUpClass() + cls.product = cls.env["product.product"].create( + {"name": "Test Product", "is_storable": True, "tracking": "serial"} + ) + cls.status = cls.env["stock.lot.quality.status"].create( + {"name": "Test Status", "code": "test"} + ) + cls.lot = cls.env["stock.lot"].create( + { + "name": "LOT-0001", + "product_id": cls.product.id, + "quality_status_id": False, + } + ) + + def test_assign_quality_status(self): + self.lot.quality_status_id = self.status + self.assertEqual(self.lot.quality_status_id, self.status) + + def test_quant_related_field_reflects_lot(self): + quant = self.env["stock.quant"].create( + { + "lot_id": self.lot.id, + "product_id": self.product.id, + "location_id": self.env.ref("stock.stock_location_stock").id, + } + ) + self.assertFalse(quant.quality_status_id) + # The stored related field must refresh when the lot's status changes + # after the quant already exists. + self.lot.quality_status_id = self.status + self.assertEqual(quant.quality_status_id, self.status) + + def test_new_lot_defaults_to_default_status(self): + # A freshly created lot picks up the status flagged as is_default. + default_status = self.env["stock.lot.quality.status"].create( + {"name": "Default Status", "is_default": True} + ) + lot = self.env["stock.lot"].create( + {"name": "LOT-0002", "product_id": self.product.id} + ) + self.assertEqual(lot.quality_status_id, default_status) + + def test_only_one_default_allowed(self): + # With a default already set, flagging a second status raises. + self.env["stock.lot.quality.status"].create( + {"name": "First Default", "is_default": True} + ) + with self.assertRaises(ValidationError): + self.env["stock.lot.quality.status"].create( + {"name": "Another Default", "is_default": True} + ) + + @mute_logger("odoo.sql_db") + def test_status_in_use_cannot_be_deleted(self): + self.lot.quality_status_id = self.status + # ondelete="restrict" enforces at the database level, so removing a + # status still referenced by a lot raises an integrity error. + with self.assertRaises(psycopg2.IntegrityError), self.cr.savepoint(): + self.status.unlink() diff --git a/stock_lot_quality_status/views/stock_lot_quality_status_views.xml b/stock_lot_quality_status/views/stock_lot_quality_status_views.xml new file mode 100644 index 0000000..78cca3e --- /dev/null +++ b/stock_lot_quality_status/views/stock_lot_quality_status_views.xml @@ -0,0 +1,128 @@ + + + + stock.lot.quality.status.list + stock.lot.quality.status + + + + + + + + + + + + + + + + + stock.lot.quality.status.form + stock.lot.quality.status + +
+ + + + + + + + + + + + + + + + + + + + + +
+ + + + + stock.lot.quality.status.search + stock.lot.quality.status + + + + + + + + + + + + + + + + + + + + Quality Statuses + stock.lot.quality.status + list,form + +

+ Create a quality status +

+

+ Quality statuses can be assigned to serial/lot numbers to + classify their inventory condition. +

+ + + + + diff --git a/stock_lot_quality_status/views/stock_lot_views.xml b/stock_lot_quality_status/views/stock_lot_views.xml new file mode 100644 index 0000000..6cd1c78 --- /dev/null +++ b/stock_lot_quality_status/views/stock_lot_views.xml @@ -0,0 +1,43 @@ + + + + stock.lot.form.quality.status + stock.lot + + + + + + + + + + stock.lot.list.quality.status + stock.lot + + + + + + + + + + stock.lot.search.quality.status + stock.lot + + + + + + + + + + + diff --git a/stock_lot_quality_status/views/stock_quant_views.xml b/stock_lot_quality_status/views/stock_quant_views.xml new file mode 100644 index 0000000..b17507f --- /dev/null +++ b/stock_lot_quality_status/views/stock_quant_views.xml @@ -0,0 +1,43 @@ + + + + stock.quant.list.quality.status + stock.quant + + + + + + + + + + stock.quant.list.editable.quality.status + stock.quant + + + + + + + + + + stock.quant.search.quality.status + stock.quant + + + + + + + + + + +