Build consume stock (#4817)

* Adds "consumed_by" field to the StockItem model.

- Points to a BuildOrder instance which "consumed" this stock
- Marks item as unavailable
- Allows filtering against build order

* Allow API filtering

* Adds table of "consumed stock items" to build order page

* Update stock table to show "consumed by" stock status

* Add "consumed_by" link to stock item detail

* Optionally add 'buildorder' details to installStockItem method

* Update methodology for completing a build item

- Instead of deleting stock, mark as "consumed by"

* Fix history entry for splitting stock

* Bug fix

* track "consumed_by" field for tracked items also

* Update build docs

* Update allocation documentation

* Update terminology.md

* Unit test updates

* Fix conflicting migrations

* revert change

docs/docs/build/allocate.md

@@ -17,17 +17,17 @@ Before continuing, it is important that the difference between *untracked* and *
 
 #### Untracked Stock
 
-*Untracked* stock items disappear from the database once they are "used". Once stock items for these parts are removed from the InvenTree database (e.g. used to create an assembly), the tracking information for these stock items disappears. The stock items no longer persist in the database.
+*Untracked* stock items are consumed against the build order, once the order is completed. When a build order is completed, any allocated stock items which are not [trackable](../part/trackable.md) are marked as *consumed*. These items remain in the InvenTree database, but are unavailable for use in any stock operations.
 
 !!! info "Example: Untracked Parts"
-    You require 15 x 47K resistors to make a batch of PCBs. You have a reel of 1,000 resistors which you allocate to the build. At completion of the build, the stock quantity is reduced to 985
+    You require 15 x 47K resistors to make a batch of PCBs. You have a reel of 1,000 resistors which you allocate to the build. At completion of the build, the available stock quantity is reduced to 985.
 
 #### Tracked Stock
 
-*Tracked* stock items, on the other hand, require special attention. These are parts which we wish to track indefinitely, even if they are "consumed" to create an assembly. *Tracked* stock items are not deleted as they are consumed. Instead, they are installed *within* the assembled unit
+[Tracked](../part/trackable.md) stock items, on the other hand, require special attention. These are parts which we wish to track against specific [build outputs](./output.md). When the build order is completed, *tracked* stock items are installed *within* the assembled build output.
 
 !!! info "Example: Tracked Parts"
-    The assembled PCB (in the example above) is a *trackable* part, and is given a serial number #001. The PCB is then used to make a larger assembly in a subsequent build order. At the completion of that build order, the tracked PCB is *installed* in the assembly, rather than being deleted from stock.
+    The assembled PCB (in the example above) is a *trackable* part, and is given a serial number #001. The PCB is then used to make a larger assembly in a subsequent build order. At the completion of that build order, the tracked PCB is *installed* in the assembly.
 
 #### BOM Considerations
 
@@ -151,4 +151,4 @@ Once all build outputs have been completed, the build order itself can be comple
 
 ### Allocated Stock
 
-All *untracked* stock items which are allocated against this build will be removed from stock.
+All *untracked* stock items which are allocated against this build will be removed from stock, and *consumed* by the build order. These consumed items can be later viewed in the [consumed stock tab](./build.md#consumed-stock).

docs/docs/build/build.md

@@ -122,6 +122,13 @@ The allocation table (as shown above) shows the stock allocation progress for th
 !!! info "Completed Builds"
 	The *Allocate Stock* tab is not available if the build has been completed!
 
+### Consumed Stock
+
+The *Consumed Stock* tab displays all stock items which have been *consumed* by this build order. These stock items remain in the database after the build order has been completed, but are no longer available for use.
+
+- [Tracked stock items](./allocate.md#tracked-stock) are consumed by specific build outputs
+- [Untracked stock items](./allocate.md#untracked-stock) are consumed by the build order
+
 ### Build Outputs
 
 The *Build Outputs* tab shows the [build outputs](./output.md) (created stock items) associated with this build.

docs/docs/terminology.md

@@ -6,23 +6,27 @@ title: Terminology
 
 There are different systems in the industry for the management of getting, storing and making parts. An overview what they are for and what the acronyms mean.
 
+**InvenTree** is mainly focused on [**IMS**](#inventory-management-system-ims) and [**PLM**](#part-library-management-plm) functionality.
 
-### Inventory management *(IMS)*
+### Inventory Management System *(IMS)*
 Evolves around manufacturing of parts out of other parts. It keeps track of stock, part origin, orders, shelf live and more.
 
-### Part library management *(PLM)*
+### Part Library Management *(PLM)*
 Keeps track of BOMs, part variants, possible substitutions, versions, IPNs and further part parameters.
 PLM can also mean product lifecycle management – those systems manage all stages from design through manufacturing up to customer support and recycling.
 
-
-**InvenTree** is mainly an **IMS**, it also has aspects of a **PLM** integrated.
 A similar system is [Partkeepr](https://partkeepr.org/) (seems mostly inactive - there is a 3rd party importer).
 
-### Asset management *(AM)*
+### Asset Management *(AM)*
 Manages many unique items, which need tracking per part and are assignable to users / groups / locations. These systems often include features like item states, refurbishing / maintenance / reservation, or request-flows.
 Often these systems are used for IT-Hardware (then they are called *ITAM*).
 A good open-source example would be [Snipe-IT](https://snipeitapp.com/).
 
-### Enterprise resource planning *(ERP)*
+### Enterprise Resource Planning *(ERP)*
+
 Is the centre of your business. It manages timesheets, warehousing, finances (prices, taxes, …), customer relations and more. InvenTree covers parts of this but aims to keep an intuitive and simple user interface.
 Popular, fully fledged ERPs are [ERPNext](https://erpnext.com/) or [odoo](https://www.odoo.com).
+
+### Customer Relationship Manager *(CRM)*
+
+Customer relationship management (CRM) is a technology for managing all your company's relationships and interactions with customers and potential customers.