From f2fd88fc6341f4a34aa4af3d23174df62d2f2057 Mon Sep 17 00:00:00 2001
From: Lance Edgar <lance@edbob.org>
Date: Fri, 11 Mar 2022 19:44:07 -0600
Subject: [PATCH] Add basic docs for "receiving" feature

---
 docs/_static/truck-dump-rows.png              | Bin 0 -> 11684 bytes
 docs/_static/truck-dump.png                   | Bin 0 -> 12143 bytes
 docs/features/index.rst                       |  16 ++
 docs/features/purchasing/accounting/index.rst |   5 +
 docs/features/purchasing/index.rst            |  17 ++
 docs/features/purchasing/ordering/index.rst   |   5 +
 .../purchasing/receiving/accounting.rst       |  32 +++
 docs/features/purchasing/receiving/index.rst  |  12 +
 .../purchasing/receiving/overview.rst         |  40 +++
 .../purchasing/receiving/workflows.rst        | 231 ++++++++++++++++++
 docs/index.rst                                |   2 +
 11 files changed, 360 insertions(+)
 create mode 100644 docs/_static/truck-dump-rows.png
 create mode 100644 docs/_static/truck-dump.png
 create mode 100644 docs/features/index.rst
 create mode 100644 docs/features/purchasing/accounting/index.rst
 create mode 100644 docs/features/purchasing/index.rst
 create mode 100644 docs/features/purchasing/ordering/index.rst
 create mode 100644 docs/features/purchasing/receiving/accounting.rst
 create mode 100644 docs/features/purchasing/receiving/index.rst
 create mode 100644 docs/features/purchasing/receiving/overview.rst
 create mode 100644 docs/features/purchasing/receiving/workflows.rst

diff --git a/docs/_static/truck-dump-rows.png b/docs/_static/truck-dump-rows.png
new file mode 100644
index 0000000000000000000000000000000000000000..5e3d7b7fb43e6f0ad2e5a41255e6446302b3bf3f
GIT binary patch
literal 11684
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
NhWb18(l^<h{vSuR?dAXg

literal 0
HcmV?d00001

diff --git a/docs/_static/truck-dump.png b/docs/_static/truck-dump.png
new file mode 100644
index 0000000000000000000000000000000000000000..e40e22820674b90ef8f6247a7ef70428e77d0bda
GIT binary patch
literal 12143
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

literal 0
HcmV?d00001

diff --git a/docs/features/index.rst b/docs/features/index.rst
new file mode 100644
index 0000000..576d038
--- /dev/null
+++ b/docs/features/index.rst
@@ -0,0 +1,16 @@
+
+Feature Layer
+=============
+
+Here we'll try stay "high level" and describe some of the features
+which are provided by the Rattail framework, in a more or less "ready
+to go" state for use in your app.
+
+Note that this section is not very far along yet..
+
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+   purchasing/index
diff --git a/docs/features/purchasing/accounting/index.rst b/docs/features/purchasing/accounting/index.rst
new file mode 100644
index 0000000..92c890b
--- /dev/null
+++ b/docs/features/purchasing/accounting/index.rst
@@ -0,0 +1,5 @@
+
+Accounting
+==========
+
+TODO
diff --git a/docs/features/purchasing/index.rst b/docs/features/purchasing/index.rst
new file mode 100644
index 0000000..165a0f5
--- /dev/null
+++ b/docs/features/purchasing/index.rst
@@ -0,0 +1,17 @@
+
+Purchasing
+==========
+
+Presumably all retailers purchase products from vendors.
+
+Rattail offers tools to assist with the various workflows involved.
+It splits the life cycle into 3 "phases" - although some purchases may
+not explicitly go through every phase.  In particular it's possible
+for the Receiving phase to include everything Accounting does.
+
+.. toctree::
+   :maxdepth: 1
+
+   ordering/index
+   receiving/index
+   accounting/index
diff --git a/docs/features/purchasing/ordering/index.rst b/docs/features/purchasing/ordering/index.rst
new file mode 100644
index 0000000..45cd73b
--- /dev/null
+++ b/docs/features/purchasing/ordering/index.rst
@@ -0,0 +1,5 @@
+
+Ordering
+========
+
+TODO
diff --git a/docs/features/purchasing/receiving/accounting.rst b/docs/features/purchasing/receiving/accounting.rst
new file mode 100644
index 0000000..e1336d4
--- /dev/null
+++ b/docs/features/purchasing/receiving/accounting.rst
@@ -0,0 +1,32 @@
+
+Accounting for Receiving
+========================
+
+Rattail provides a separate phase entirely for accounting (see
+:doc:`../accounting/index`) but in practice it is often lumped into
+the receiving phase.  So here we'll describe how it works in
+receiving.
+
+
+The Basics
+----------
+
+Where some of the data comes from will depend on the receiving
+workflow, but in general here is what we're concerned with, for *each*
+individual line item:
+
+* case size
+* case cost
+* unit cost
+* cases received
+* units received
+* total cost
+
+Ideally only the "cases/units received" amounts are provided by the
+user, with all other values being read from PO and/or invoice file.
+
+Although we also must consider credits for damaged, expired, not
+shipped etc.
+
+The "total cost" is normally calculated by multiplying received
+quantities by cost.  It is reduced by any credits present.
diff --git a/docs/features/purchasing/receiving/index.rst b/docs/features/purchasing/receiving/index.rst
new file mode 100644
index 0000000..d713a5e
--- /dev/null
+++ b/docs/features/purchasing/receiving/index.rst
@@ -0,0 +1,12 @@
+
+Receiving
+=========
+
+All about *receiving* product which was ordered from the vendor.
+
+.. toctree::
+   :maxdepth: 3
+
+   overview
+   workflows
+   accounting
diff --git a/docs/features/purchasing/receiving/overview.rst b/docs/features/purchasing/receiving/overview.rst
new file mode 100644
index 0000000..ee425dd
--- /dev/null
+++ b/docs/features/purchasing/receiving/overview.rst
@@ -0,0 +1,40 @@
+
+Overview
+========
+
+Receiving happens when an order is delivered to the retailer after
+being shipped from the vendor.  In most cases an invoice will
+accompany the order.  Depending on the retailer, in some cases the
+purchase order will already exist, e.g. in Rattail or the POS system.
+
+Rattail considers the primary concerns for this phase to be:
+
+* update inventory counts
+* (optional) record costs from invoice
+* (optional) request credits from vendor
+* (optional) detect/highlight other anomalies
+
+Note that recording costs is "optional" mostly because that can be
+handled in a separate third phase; see
+:doc:`/features/purchasing/accounting/index`.  Vendor credits are not
+always applicable but often will be.  Anomalies refers to anything you
+want it to, e.g. if a product cost has increased too much.
+
+Receiving is done via batch.  The user creates a batch via one of the
+supported workflows:
+
+* From Scratch - aka. just start scanning items
+* From Invoice - upload invoice file, then scan "against" it
+* From Purchase Order - choose existing PO, then scan against it
+* From Purchase Order, with Invoice - choose PO *and* upload invoice
+  file, scan against it
+
+We say "scan" above, as it is possible to do these tasks with a mobile
+phone and bluetooth scanner.  But paper-based receiving is also a
+supported method; in this case after paper check-in has been
+completed, user would "auto-update" all line items to be "received"
+and then *undo* that for any exceptions (credits).
+
+The user then will review the batch, add/modify line items as
+appropriate.  Once satisfied that all data is correct, batch is
+executed, which typically will update the master purchase record etc.
diff --git a/docs/features/purchasing/receiving/workflows.rst b/docs/features/purchasing/receiving/workflows.rst
new file mode 100644
index 0000000..7a30c6b
--- /dev/null
+++ b/docs/features/purchasing/receiving/workflows.rst
@@ -0,0 +1,231 @@
+
+Receiving Workflows
+===================
+
+Here we describe the workflows for "receiving" product, which are
+supported by Rattail.
+
+At a fundamental level there are just 2 workflows: you can either
+receive "from scratch" (i.e. starting from nothing) or you receive
+"against a document" (PO, invoice, both, other).
+
+In rare cases a special workflow may be needed, which Rattail refers
+to as "truck dump" - if you can avoid it you should!
+
+
+Receive From Scratch
+----------------------
+
+Receiving "from scratch" just means you're starting from nothing,
+i.e. you have no invoice file to upload and the purchase order does
+not yet exist in the system.
+
+So you effectively create an "empty" batch and then must add items to
+it.  This may be done via mobile or desktop interface; scanner is
+supported for both.
+
+Executing the batch would typically *create* the (received) purchase
+order in the system - Rattail or POS etc.
+
+
+Receive Against a Document
+--------------------------
+
+Receiving "against a document" just means you actually have some sort
+of digital representation of the order, and so can use that as the
+starting point for your batch, then "update" line items.
+
+This is fundamentally different than "from scratch" which starts with
+an empty batch and you must *add* all line items.
+
+Not all documents types are "equal" for this purpose.  Specifically,
+some (e.g. PO) will contain the *ordered* quantities but not the
+*shipped* quantities (or accurate cost info).  However some
+(e.g. invoice file) will contain shipped quantities and hopefully,
+accurate cost info.
+
+
+Purchase Order
+~~~~~~~~~~~~~~
+
+If the purchase order (PO) already exists in the system, you can
+choose it after identifying the vendor.  The batch is auto-populated
+with line items from the PO when it is created.
+
+Note that a purchase order will have *ordered* quantities but not the
+*shipped* quantites, or accurate cost info.  Usually you need a
+digital invoice file to get the rest of it.
+
+
+Invoice File
+~~~~~~~~~~~~
+
+If the user has a digital invoice file (with supported format/parser)
+then they can upload that when making a new batch, and it will be
+auto-populated with line items from the invoice file.
+
+Note that an invoice file may have *ordered* and/or *shipped*
+quantities.  If only one is present, usually the other can be inferred
+from it.
+
+Most but perhaps not all invoice files will contain accurate cost
+data.  Sometimes the normal wholesale cost is listed in addition to
+the "true" cost paid for each item, etc.
+
+As much data as the invoice contains, should go into the initial
+batch.  But it still likely can't provide *everything* and so when
+possible a purchase order should also be chosen for the batch.
+
+
+Purchase Order + Invoice File
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This of course combines the previous two approaches.  User must choose
+an existing PO and also upload an invoice file.
+
+On a technical level the batch is first populated from the PO line
+items, and then the invoice data is "overlaid" onto the batch.  This
+will *update* line items found on the PO, but may also *create* new
+line items which were not on the PO.
+
+
+Mobile/Scanner-based Receiving
+------------------------------
+
+There is a mobile-specific app/interface for use with receiving.  It
+assumes you have a mobile smart phone with bluetooth scanner attached
+in keyboard wedge mode.
+
+The user opens (or creates) the batch in the mobile app, then starts
+scanning physical product from the order.  They continue until they've
+scanned everything physically present.
+
+If receiving "from scratch" then the batch can be executed when
+scanning is complete.
+
+If receiving "against a document" then the mobile app will indicate if
+any product was "missed" - i.e. what was on the document, that was not
+yet accounted for.  Once the user has addressed any discrepancies, the
+batch may be executed.
+
+
+Paper-based Receiving
+---------------------
+
+If the receiver does a paper-based check-in, then the process changes
+a bit on the back-end.  The user would always create the receiving
+batch via the desktop interface.
+
+If receiving "from scratch" then user has to manually key in every
+line item!  Prone to mistakes and labor-intensive; not advised.
+
+If receiving "against a document" then user will choose/upload the
+document per usual, which auto-populates the batch.  But each line
+item will assume zero quantity received at first.  So user *could*
+manually key in the amounts from paperwork, but the easier way is to
+first "auto-receive" all lines and then manually key in only the
+exceptions.
+
+Once the batch data is correct, including any "credits" etc. then it
+may be executed.
+
+
+"Truck Dump" Receiving
+----------------------
+
+We use the term "truck dump" to refer to a specific scenario which,
+with any luck, you do not have to deal with and can just skip this
+section...
+
+Normally you place an order with the vendor and then you receive it.
+For some vendors (e.g. distributors) you might place multiple orders
+at the same time, e.g. one per department.  Much of the time even in
+that case when the orders arrive, they are partitioned somehow and can
+be received independently.
+
+But, alas, sometimes multiple orders arrive all mixed together and
+that is a "truck dump" in Rattail terms.  It is not possible to receive
+them independently because of their being mixed up.
+
+Rattail tries to address this but as of writing this has not seen
+enough production use to be called stable.  Nonetheless we'll describe
+it here.
+
+The basic idea is to acknowledge the facts:
+
+* we want multiple batches, i.e. one per order, but
+* we have a pile of product that must be processed as one batch
+
+So we just do both..by creating a "parent" truck dump batch, which
+will contain all the received quantities, and then also for each
+actual order we have a "child" truck dump batch, connected to the
+parent.  Each child batch contains the ordered/shipped quantities.
+But each line item within a child batch is also connected to and
+"consumes" some amount of the received quantity from corresponding
+parent batch line item.
+
+When the dust has settled we should have a fully reconciled data set,
+i.e. all items from all child batches have either been accounted for
+or marked for credit.
+
+Due to all the complexity involved it is not possible to execute a
+"child" truck dump batch directly.  Instead you must execute the
+parent batch, which will immediately execute all its child batches.
+
+.. image:: /_static/truck-dump.png
+
+On a technical level the line items between parent and child batches
+are linked via a "claim" which indicates how much of the parent item's
+received quantity has been "claimed" by a given child item.
+
+And when credits are identified, those also are "linked" between the
+parent and child items, although not entirely clear from this picture.
+
+.. image:: /_static/truck-dump-rows.png
+
+
+From Scratch (aka. "children last")
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It's possible to start "from scratch" with truck dump receiving, but
+the caveat is that you *should* have documents (PO and/or invoice)
+which can be used to "reconcile" the truck dump batches, before it's
+all said and done.  If you do not have documents to define the
+individual orders then the truck dump parent batch effectively cannot
+be split up, and you will just be doing "normal from scratch"
+receiving at that point.
+
+So in the "truck dump from scratch" workflow then, you start by
+creating an empty "parent" batch, then start scanning all products
+found.  When all has been scanned, your truck dump parent batch will
+have no ordered quantities but should have all received quantities.
+
+Then you must add each of documents as a separate "child" batch under
+the parent batch.  Each document should have either ordered or shipped
+quantities.  Rattail will auto-reconcile each line item where
+possible, which means taking the received quantites from parent batch
+and "divvying" them up to the child batches.
+
+If everything reconciles cleanly then each line item of each child
+batch should be fully received.  If there are gaps etc. then perhaps
+not everything was delivered and credits should be requested.
+
+Once everything is reconciled and data looks good, you must execute
+the parent batch, which will execute all of the child batches.
+
+
+Against Documents (aka. "children first")
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Since you need to have documents available in order to do truck dump
+receiving in the first place, it makes sense to define them up-front.
+
+In this mode then, you create a truck dump "parent" batch first, and
+then immediately after will create a "child" batch for each order
+document, under the parent batch.
+
+At this point you will scan/receive against the parent batch, which
+should have all line items and order/ship quantities.
+
+When finished scanning and all is reconciled, you must execute the
+parent batch, which will execute all of the child batches.
diff --git a/docs/index.rst b/docs/index.rst
index 5b393f9..2f1de20 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -15,6 +15,7 @@ the `Rattail Tutorial`_.
 This manual is primarily organized around the possible "layers" of a
 Poser/Rattail app:
 
+* :doc:`features/index` - app features provided by the framework
 * :doc:`base/index` - general app install, command line, plus filemon etc.
 * :doc:`data/index` - when a DB or data import/export come into it
 * :doc:`web/index` - all things web
@@ -38,6 +39,7 @@ this document.
    readfirst
    quickstart
    background
+   features/index
    base/index
    data/index
    web/index