Skip to content

Commit ce15712

Browse files
mileomileo
committed
[NEW] maintenance_equipment_spareparts
1 parent 140fbe0 commit ce15712

26 files changed

Lines changed: 2065 additions & 0 deletions

‎maintenance_equipment_spareparts/README.rst‎

Lines changed: 167 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,167 @@
1+
=================================
2+
Maintenance Equipment Spare Parts
3+
=================================
4+
5+
..
6+
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
7+
!! This file is generated by oca-gen-addon-readme !!
8+
!! changes will be overwritten. !!
9+
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
10+
!! source digest: sha256:e9ba4026a2fd2a8e524abcfac0f4d28de45177ff8574cd0c8a7e44172388d2d7
11+
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
12+
13+
.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
14+
:target: https://odoo-community.org/page/development-status
15+
:alt: Beta
16+
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
17+
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
18+
:alt: License: AGPL-3
19+
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fmaintenance-lightgray.png?logo=github
20+
:target: https://github.com/OCA/maintenance/tree/18.0/maintenance_equipment_spareparts
21+
:alt: OCA/maintenance
22+
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
23+
:target: https://translation.odoo-community.org/projects/maintenance-18-0/maintenance-18-0-maintenance_equipment_spareparts
24+
:alt: Translate me on Weblate
25+
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
26+
:target: https://runboat.odoo-community.org/builds?repo=OCA/maintenance&target_branch=18.0
27+
:alt: Try me on Runboat
28+
29+
|badge1| |badge2| |badge3| |badge4| |badge5|
30+
31+
This module manages spare parts for maintenance equipment, allowing you
32+
to:
33+
34+
- Define spare parts for each equipment with installed and recommended
35+
spare quantities
36+
- Track spare parts consumption during maintenance requests
37+
- Automatically create stock movements when spare parts are consumed (if
38+
stock is available)
39+
- Automatically create purchase requests when spare parts are needed but
40+
not in stock
41+
- Restrict purchase requisitions to only registered spare parts for the
42+
selected equipment
43+
- Monitor stock levels and alert when quantities fall below recommended
44+
spare quantities
45+
46+
**Table of contents**
47+
48+
.. contents::
49+
:local:
50+
51+
Usage
52+
=====
53+
54+
Equipment Spare Parts
55+
=====================
56+
57+
To manage spare parts for an equipment:
58+
59+
- Go to *Maintenance > Equipments* and open an equipment form
60+
- Click on the *Spare Parts* tab
61+
- Click *Add a line* to add a new spare part
62+
- Select a *Product* from the catalog
63+
- Enter the *Installed Quantity* (quantity used by the equipment)
64+
- Enter the *Recommended Spare Quantity* (minimum quantity to keep in
65+
stock)
66+
- Save the record
67+
68+
The system will automatically calculate and display:
69+
70+
- Available quantity in stock
71+
- Alert indicator when stock falls below recommended spare quantity
72+
73+
Adding Spare Parts During Maintenance
74+
=====================================
75+
76+
When performing maintenance:
77+
78+
- Create or open a maintenance request for an equipment
79+
- Go to the *Spare Parts* section
80+
- If you identify a spare part that is not yet registered, you can add
81+
it directly from the request
82+
- The spare part will be automatically added to the equipment's spare
83+
parts list
84+
85+
Consuming Spare Parts
86+
=====================
87+
88+
During maintenance, you can consume spare parts:
89+
90+
- In a maintenance request, click *Consume Spare Parts*
91+
- A wizard will open showing all spare parts for the equipment
92+
- Enter the quantity needed for each spare part
93+
- Click *Consume*
94+
95+
The system will:
96+
97+
- If stock is available: automatically create a stock picking and
98+
movement
99+
- If stock is not available: automatically create a purchase request
100+
with the needed quantity
101+
102+
Purchase Requisition Integration
103+
================================
104+
105+
When creating a purchase requisition for equipment spare parts:
106+
107+
- Select the equipment in the purchase requisition form
108+
- The product selection will be restricted to only spare parts
109+
registered for that equipment
110+
- You cannot add products that are not registered as spare parts for the
111+
selected equipment
112+
- If you try to add a non-registered product, the system will prevent it
113+
and inform you that the product must be registered as a spare part
114+
first
115+
116+
Stock Alerts
117+
============
118+
119+
The system monitors spare parts stock levels:
120+
121+
- When the available quantity falls below the recommended spare
122+
quantity, an alert indicator is shown
123+
- You can use the *Create Purchase Request* button to automatically
124+
generate a purchase request for all parts needing replenishment
125+
126+
Bug Tracker
127+
===========
128+
129+
Bugs are tracked on `GitHub Issues <https://github.com/OCA/maintenance/issues>`_.
130+
In case of trouble, please check there if your issue has already been reported.
131+
If you spotted it first, help us to smash it by providing a detailed and welcomed
132+
`feedback <https://github.com/OCA/maintenance/issues/new?body=module:%20maintenance_equipment_spareparts%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
133+
134+
Do not contact contributors directly about support or help with technical issues.
135+
136+
Credits
137+
=======
138+
139+
Authors
140+
-------
141+
142+
* KMEE
143+
144+
Contributors
145+
------------
146+
147+
Contributors
148+
~~~~~~~~~~~~
149+
150+
- Luis Felipe Miléo mileo@kmee.com.br
151+
152+
Maintainers
153+
-----------
154+
155+
This module is maintained by the OCA.
156+
157+
.. image:: https://odoo-community.org/logo.png
158+
:alt: Odoo Community Association
159+
:target: https://odoo-community.org
160+
161+
OCA, or the Odoo Community Association, is a nonprofit organization whose
162+
mission is to support the collaborative development of Odoo features and
163+
promote its widespread use.
164+
165+
This module is part of the `OCA/maintenance <https://github.com/OCA/maintenance/tree/18.0/maintenance_equipment_spareparts>`_ project on GitHub.
166+
167+
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

‎maintenance_equipment_spareparts/__init__.py‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
from . import models
2+
from . import wizards

‎maintenance_equipment_spareparts/__manifest__.py‎

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
# Copyright 2024 Odoo Community Association (OCA)
2+
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
3+
{
4+
"name": "Maintenance Equipment Spare Parts",
5+
"summary": "Manage spare parts for maintenance equipment with "
6+
"purchase requisition integration",
7+
"version": "18.0.1.0.0",
8+
"category": "Maintenance",
9+
"website": "https://github.com/OCA/maintenance",
10+
"author": "KMEE, Odoo Community Association (OCA)",
11+
"license": "AGPL-3",
12+
"depends": [
13+
"base_maintenance",
14+
"maintenance_product",
15+
"maintenance_stock",
16+
"purchase_request",
17+
"stock",
18+
],
19+
"data": [
20+
"security/ir.model.access.csv",
21+
"views/maintenance_equipment_sparepart_views.xml",
22+
"views/maintenance_equipment_views.xml",
23+
"views/maintenance_request_sparepart_consumption_views.xml",
24+
"views/maintenance_request_views.xml",
25+
"views/purchase_request_views.xml",
26+
"wizards/maintenance_request_consume_spareparts_wizard.xml",
27+
],
28+
"installable": True,
29+
"development_status": "Beta",
30+
}

‎maintenance_equipment_spareparts/i18n/pt_BR.po‎

Lines changed: 116 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,116 @@
1+
# Translation of Odoo Server.
2+
# This file contains the translation of the following modules:
3+
# * maintenance_equipment_spareparts
4+
#
5+
msgid ""
6+
msgstr ""
7+
"Project-Id-Version: Odoo Server 18.0\n"
8+
"Report-Msgid-Bugs-To: \n"
9+
"Last-Translator: \n"
10+
"Language-Team: \n"
11+
"MIME-Version: 1.0\n"
12+
"Content-Type: text/plain; charset=UTF-8\n"
13+
"Content-Transfer-Encoding: \n"
14+
"Plural-Forms: \n"
15+
16+
#. module: maintenance_equipment_spareparts
17+
#: model:ir.model.fields,field_description:maintenance_equipment_spareparts.field_maintenance_equipment__sparepart_count
18+
msgid "Spare Parts Count"
19+
msgstr "Quantidade de Peças"
20+
21+
#. module: maintenance_equipment_spareparts
22+
#: model:ir.model.fields,field_description:maintenance_equipment_spareparts.field_maintenance_equipment__sparepart_ids
23+
#: model:ir.model.fields,field_description:maintenance_equipment_spareparts.field_maintenance_request__sparepart_ids
24+
msgid "Spare Parts"
25+
msgstr "Peças"
26+
27+
#. module: maintenance_equipment_spareparts
28+
#: model:ir.model.fields,field_description:maintenance_equipment_spareparts.field_maintenance_equipment_sparepart__available_qty
29+
msgid "Available Quantity"
30+
msgstr "Quantidade Disponível"
31+
32+
#. module: maintenance_equipment_spareparts
33+
#: model:ir.model.fields,field_description:maintenance_equipment_spareparts.field_maintenance_equipment_sparepart__installed_qty
34+
msgid "Installed Quantity"
35+
msgstr "Quantidade Instalada"
36+
37+
#. module: maintenance_equipment_spareparts
38+
#: model:ir.model.fields,field_description:maintenance_equipment_spareparts.field_maintenance_equipment_sparepart__needs_reorder
39+
msgid "Needs Reorder"
40+
msgstr "Precisa Repor"
41+
42+
#. module: maintenance_equipment_spareparts
43+
#: model:ir.model.fields,field_description:maintenance_equipment_spareparts.field_maintenance_equipment_sparepart__spare_qty
44+
msgid "Recommended Spare Quantity"
45+
msgstr "Quantidade Sobressalente Recomendada"
46+
47+
#. module: maintenance_equipment_spareparts
48+
#: model:ir.model.fields,field_description:maintenance_equipment_spareparts.field_maintenance_request_sparepart_consumption__consumed_qty
49+
msgid "Consumed Quantity"
50+
msgstr "Quantidade Consumida"
51+
52+
#. module: maintenance_equipment_spareparts
53+
#: model:ir.model.fields,field_description:maintenance_equipment_spareparts.field_maintenance_request_sparepart_consumption__state
54+
msgid "State"
55+
msgstr "Estado"
56+
57+
#. module: maintenance_equipment_spareparts
58+
#: model:ir.model.fields,field_description:maintenance_equipment_spareparts.field_maintenance_request_sparepart_consumption__stock_picking_id
59+
msgid "Stock Picking"
60+
msgstr "Movimentação de Estoque"
61+
62+
#. module: maintenance_equipment_spareparts
63+
#: model:ir.model.fields,field_description:maintenance_equipment_spareparts.field_maintenance_request_sparepart_consumption__purchase_request_id
64+
msgid "Purchase Request"
65+
msgstr "Requisição de Compra"
66+
67+
#. module: maintenance_equipment_spareparts
68+
#: model:ir.model.fields,field_description:maintenance_equipment_spareparts.field_purchase_request__equipment_id
69+
#: model:ir.model.fields,field_description:maintenance_equipment_spareparts.field_purchase_request_line__equipment_id
70+
msgid "Equipment"
71+
msgstr "Equipamento"
72+
73+
#. module: maintenance_equipment_spareparts
74+
#: model:ir.model.fields,field_description:maintenance_equipment_spareparts.field_maintenance_request__sparepart_consumption_ids
75+
msgid "Spare Parts Consumption"
76+
msgstr "Consumo de Peças"
77+
78+
#. module: maintenance_equipment_spareparts
79+
#: model:ir.model.fields,help:maintenance_equipment_spareparts.field_maintenance_equipment_sparepart__available_qty
80+
msgid "Available quantity in stock"
81+
msgstr "Quantidade disponível em estoque"
82+
83+
#. module: maintenance_equipment_spareparts
84+
#: model:ir.model.fields,help:maintenance_equipment_spareparts.field_maintenance_equipment_sparepart__needs_reorder
85+
msgid "True if stock is below recommended spare quantity"
86+
msgstr "Verdadeiro se o estoque está abaixo da quantidade sobressalente recomendada"
87+
88+
#. module: maintenance_equipment_spareparts
89+
#: model:ir.model.fields,help:maintenance_equipment_spareparts.field_maintenance_equipment_sparepart__installed_qty
90+
msgid "Quantity of this part installed in the equipment"
91+
msgstr "Quantidade desta peça instalada no equipamento"
92+
93+
#. module: maintenance_equipment_spareparts
94+
#: model:ir.model.fields,help:maintenance_equipment_spareparts.field_maintenance_equipment_sparepart__spare_qty
95+
msgid "Recommended quantity to keep in stock as spare"
96+
msgstr "Quantidade recomendada para manter em estoque como sobressalente"
97+
98+
#. module: maintenance_equipment_spareparts
99+
#: model:ir.model.fields,help:maintenance_equipment_spareparts.field_purchase_request__equipment_id
100+
msgid "When set, product selection will be restricted to spare parts registered for this equipment"
101+
msgstr "Quando definido, a seleção de produtos será restrita às peças registradas para este equipamento"
102+
103+
#. module: maintenance_equipment_spareparts
104+
#: model:ir.model.fields,help:maintenance_equipment_spareparts.field_maintenance_request_sparepart_consumption__stock_picking_id
105+
msgid "Stock picking created when part was consumed from stock"
106+
msgstr "Movimentação de estoque criada quando a peça foi consumida do estoque"
107+
108+
#. module: maintenance_equipment_spareparts
109+
#: model:ir.model.fields,help:maintenance_equipment_spareparts.field_maintenance_request_sparepart_consumption__purchase_request_id
110+
msgid "Purchase request created when part was not in stock"
111+
msgstr "Requisição de compra criada quando a peça não estava em estoque"
112+
113+
#. module: maintenance_equipment_spareparts
114+
#: model:ir.model.fields,help:maintenance_equipment_spareparts.field_maintenance_request_sparepart_consumption__purchase_request_line_id
115+
msgid "Purchase request line created when part was not in stock"
116+
msgstr "Linha de requisição de compra criada quando a peça não estava em estoque"

‎maintenance_equipment_spareparts/models/__init__.py‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
from . import maintenance_equipment_sparepart
2+
from . import maintenance_equipment
3+
from . import maintenance_request
4+
from . import maintenance_request_sparepart_consumption
5+
from . import purchase_request

0 commit comments

Comments
 (0)