Work on inventory items and storage locations

Author: cielf

docs/user_guide/bank/essentials_pick_ups.md

@@ -7,7 +7,7 @@ Click on "Pick Ups & Deliveries" in the left-hand menu to view the calendar.
 
 ![PickUps & Delivery Calendar](images/essentials/pick_ups/pickup&delivery.jpg)
 
-Click on any scheduled Eistribution to view details on all the Eistributions for that day.
+Click on any scheduled Distribution to view details on all the Distributions for that day.
 The Distribution Schedule page shows details including the Partner,the time of Distribution, Storage Location, the total number of items, and the status of the Distribution.
 
 ![Specific Day Distribution](images/essentials/pick_ups/specific_day_distribution_schedule.jpg)

docs/user_guide/bank/images/inventory/inventory_items_reactivation.png

@@ -1,4 +1,4 @@
-DRAFT USER GUIDE
+READY FOR REVIEW
 # Items
 ## Introduction
 Your bank is initialized with  a basic set of Items that contains many common product types that essentials banks distribute.   These Items represent the stock you have for distribution.  Here is the current default list:  
@@ -68,7 +68,7 @@ This shows all of your Items, and allows you access to view/edit/and delete them
 #### Viewing an Item
 Clicking "View" will bring up details on the Item, including all the things you can change, and a breakdown of the inventory at each location you currently have stock at.
 
-![Navigation to view an Item](images/inventory/inventory_items_viewnavigation.png)
+![Navigation to view an Item](images/inventory/inventory_items_view_navigation.png)
 ![View Item page](images/inventory/inventory_items_view.png)
 The fields are:
 - Base Item -- this is the "Base Item" for this Item -- which determines what section it is in for the Annual Survey.  You can also search by Base Item (at this time)
@@ -83,6 +83,10 @@ The fields are:
 - On hand recommended quantity -- This is the amount you want to have on hand -- if you don't have this, it will appear in the low inventory list on your dashboard, just not in red.
 - Package size -- If you use this, the calculated number of packages for the Item will appear on the distribution printout, unless you hide it when [customizing your bank](getting_started_customization.md).
 - Item visible to partners -- This is useful if you have Items that you do not want the partners directly requesting.   Uses include: Items you don't get very often,  or Items you only have because they are going into kits you haven't assembled yet. You can uncheck this to hide those Items from all your partners.
+#### Filtering your item list
+The most common thing you'll when filtering your item list is to include inactive items.  If you have deactivated an item, but are going to offer it again,  you'll need to check the "Also include inactive Items" box in the filter, and then click "Filter" to show it, so that you can reactivate it.
+
+
 #### Editing an Item
 Clicking "Edit" beside an Item on the Item list lets you edit the Item definition, with the fields as described above.
 ![Navigation to edit an Item](images/inventory/inventory_items_edit_navigation.png)
@@ -101,6 +105,16 @@ You can still see deactivated items in most reports, and can include them in you
 
 ![Item list showing delete and deactivate buttons](images/inventory/inventory_items_delete_vs_deactivate.png)
 
+#### Reactivating an Item
+To reactivate an Item,  you'll need to
+(1) click "Also include inactive Items"
+(2) click "Filter", then
+(3) click "Restore" beside the Item you wish to reactivate.
+
+Click 'Ok' on the confirmation screen that appears.
+
+![Item Reactivation sequence](images/inventory/inventory_items_reactivation.png)
+
 ### Item Categories
 
 Item categories are largely used for limiting the Items specific [Partner Groups](pm_partner_groups.md) can see, though you can also filter distributions by them.  This tab shows all the Item categories you have, allowing you to view and edit each one, as well as enter new ones.
@@ -146,10 +160,9 @@ This tab shows the bank-wide inventory for each Item.   Clicking the + beside th
 ![Navigation to Item Inventory tab](images/inventory/inventory_items_inventory_navigation.png)
 
 ### Kits tab
-This shows the same information as the main [Kits](inventory_kits.md) view. 
+This shows the same information as the main [Kits](inventory_kits.md) list. 
 ![Navigation to the Kits tab ](images/inventory/inventory_items_kits_navigation.png)
 
-[TODO:  Add a filter section]
 
 
 [Prior: Partner Announcements](pm_announcements.md)[Next: Storage Locations](inventory_storage_locations.md)

docs/user_guide/bank/images/inventory/inventory_storage_location_view_inventory.png

@@ -14,12 +14,13 @@ This shows all your Storage Locations, and allows you to navigate to view, edit,
 To add a Storage Location,  click "New Storage Location" on the Storage Location summary page.
 
 ![Navigation to add a Storage Location](images/inventory/inventory_storage_locations_add_navigation.png)
-
-The square footage and storage site type information are used in the annual survey report.  
-[TODO:  Is the address used anywhere?  (Distribution printout? maybe? Maybe available for the distribution email?)]
-
-[TODO:  Speak intelligently on how the time zone is used]
-[TODO:  Screenshot]
+This brings up the New Storage Location page
+![New Storage Location  page](images/inventory/inventory_storage_locations_add.png)
+- Name is mandatory, and is used in drop-downs throughout the system to indicate the Storage Location
+- Address is also mandatory, but is information only.
+- Square Footage is used in the annual survey report
+- Warehouse Type is used in the annual survey report
+- Time Zone is used with the pickup and deliveries calendar, particularly with allowing you to sync your pickups calendar with Google Calendar
 
 ## Storage location view
 To view a Storage Location, click the "View" button beside it in the Storage Location summary page.
@@ -29,15 +30,13 @@ The view has three tabs:  Inventory, Inventory Coming In, and Inventory Going Ou
 
 Here you see the current levels of inventory for the chosen Storage Location.   You can see the inventory levels for past dates by choosing the date in "Show Inventory at Date" and clicking "View"
 That shows the inventory at the beginning of the day.
-[TODO:  Screenshot]
+![Storage Location - Inventory tab](images/inventory/inventory_storage_location_view_inventory.png)
 
 ### Inventory Coming In
 This shows the sum of all the inventory coming in ([Purchases](essentials_purchases.md), [Donations](essentials_donations.md), [Adjustments](inventory_adjustments.md), [Transfers](inventory_transfers.md), and  [positive changes for kit allocations.deallocations](inventory_kits.md)) for the given Storage Location for all time
 
 [TODO: Check that that is exactly what it is doing]
 
-[TODO: Would this be more useful with a date range, and is that feasible?]
-
 [TODO:  Screenshot]
 
 
@@ -46,13 +45,11 @@ This shows the sum of all the inventory going out ([Distributions](essentials_pu
 
 [TODO: Check that that is exactly what it is doing]
 
-[TODO: Would this be more useful with a date range, and is that feasible?]
-
 [TODO:  Screenshot]
 
 ## Editing a Storage Location
 You can edit your Storage Location (though it seems a very rare event), by clicking "Edit" beside the Storage Location in the Storage Location Summary Page.
-The same fields are as available as for your new Storage Locations.  Make your updates and click save.
+The same fields are as available as for [New Storage Locations](inventory_storage_locations.md).  Make your updates and click save.
 
 ## Deactivating a Storage Location
 You can only deactivate a Storage Location if the inventory for all its items is 0.