.. _parts_user:

Using the Parts App
===================

As of version 0.3.0 QATrack+ comes with a :ref:`Service Log <service_log_user>`
which inclues a `Parts` app for managing spare parts inventory.

When users are managing :term:`Service Event`\s they may choose to include
which parts from their inventory were used and they will automatically be
removed from the available inventory.

Adding Parts To Your Inventory
------------------------------

To add a new part to the inventory select the `Enter New Part` menu item from
the `Service Log` menu in the top menu bar:

.. figure:: images/add_parts_menu.png
   :alt: Enter new part menu item

   Enter new part menu item

On the next page you will be presented with a form for adding your new part:

.. figure:: images/create_part.png
   :alt: Creating a new part

   Creating a new part


The fields are as follows:

* **Name** Name describing what this part is.
* **Part Number** The manufacturers identification number for this part.
* **Alteranate Part Number** Alternate manufactures part number.
* **Cost** Last known cost for this part.
* **Part Category (optional)** Which category does this part belong to.
* **Low Inventory Count** When the part inventory count falls below this
  number, a message will be shown to the user and the part will show up in the
  :ref:`Low Inventory Report <parts_low_inventory>`.
* **Notes (optional)** Any additional comments about this part type?
* **Suppliers (optional)** List any known suppliers and optionally the supplier
  specific part number.
* **Storage (optional)** List the :term:`Rooms` and :term:`Location`\s where the
  part is located and how many are available in that location.


Once you have entered the fields click `Add Part and enter Another` to save
this part and continue entering other parts, or just click `Add Part` and you
will be returned to the :ref:`list of all parts <parts_editing>`.


.. _parts_editing:

Editing Existing Parts
----------------------

To view all existing parts select the `View All Parts` menu item from the
`Service Log` menu in the top bar.

.. figure:: images/view_all_parts.png
   :alt: View all available parts

   View all available parts


from there you can click `Edit` or `Details` to edit the part item (adjust
inventory numbers, part name etc) or view the details of the part:


.. figure:: images/view_part_details.png
   :alt: View part details

   View part details

.. _parts_low_inventory:


Low Inventory Report
--------------------

To view a report about which parts are low in inventory, select the `View Low
Inventory Parts` from the `Service Log` menu in the top bar.


.. figure:: images/view_low_parts.png
   :alt: View low inventory parts

   View low inventory parts