google · dyerry23 · Dec 20, 2018 · Dec 21, 2018 · Jan 4, 2019 · Jan 7, 2019
diff --git a/.travis.yml b/.travis.yml
@@ -2,6 +2,7 @@ dist: trusty
 addons:
   chrome: stable
   apt:
+    update: true
     sources:
       - google-chrome
     packages:
@@ -16,10 +17,10 @@ matrix:
         - "2.7"
       before_install:
         # Install bazel.
-        - wget https://github.com/bazelbuild/bazel/releases/download/0.11.1/bazel_0.11.1-linux-x86_64.deb
-        - echo f3df344b16a40d4233a7606cce38869d4df3bb35296ac2f4e18838566ae3cb48 bazel_0.11.1-linux-x86_64.deb | sha256sum -c
-        - sudo dpkg -i bazel_0.11.1-linux-x86_64.deb
-        - rm bazel_0.11.1-linux-x86_64.deb
+        - wget https://github.com/bazelbuild/bazel/releases/download/0.26.1/bazel_0.26.1-linux-x86_64.deb
+        - echo c0b2b676ca7cc071a98f969aefb4a9d4b7db1858b7340d9db6f8076179e776cd bazel_0.26.1-linux-x86_64.deb | sha256sum -c
+        - sudo dpkg -i bazel_0.26.1-linux-x86_64.deb
+        - rm bazel_0.26.1-linux-x86_64.deb
       script:
         - ./backend_tests.sh $GROUP $TOTAL_GROUPS
       env:

diff --git a/README.md b/README.md
@@ -24,20 +24,52 @@ The program is comprised of three parts:
 *   A Google App Engine (GAE) application
 *   A Chrome App that runs on each Chrome OS device
 
+## Important notice about Chrome Apps!
+**Note:** [Chrome Apps are being phased out in favor of extensions and progressive web apps](https://blog.chromium.org/2020/01/moving-forward-from-chrome-apps.html)
+
+**If you haven't yet deployed Grab and Go to the Chrome Web Store**
+
+Enterprise/EDU customers can continue to deploy Chrome Apps to the Chrome
+Web Store using the guidance we've provided (specifically unlisted/private
+hosting in the Chrome Web Store) in the documentation for the forseeable future.
+
+**If you have deployed Grab and Go to the Chrome Web Store**
+
+You should be in good shape for now! Existing Enterprise/EDU Chrome Apps (Grab
+and Go included) are not in-scope until June 2022 according to the announcement
+linked above.
+
 ## Current release: [Alpha (v0.7.1a)](https://github.com/google/loaner/tree/Alpha-(0.7.1))
 
+**Note: If you are doing a new deployment please deploy from master as we work
+on cutting a new release. For current deployments, please hold off on upgrading
+until we can test the next numbered release.**
+
 Please note that the current release of this application is in ALPHA.
 We will be actively contributing to the project. Please keep an eye out for
 future updates and features!
 
-To clone this release run the following command:
+
+**Note:** To build this project you must install Bazel 0.26. Currently
+Bazel 0.27 or later is unsupported.
+
+To use the **latest code (also known as master)**, run the following
+command:
 
 ```
-git clone -b Alpha-\(0.7\) https://github.com/google/loaner.git
+git clone https://github.com/google/loaner.git
 cd loaner
 ```
 
-* To discuss this project send an email to [email protected].
+To use release number **0.7.1**, run the following command:
+
+```
+git clone -b Alpha-\(0.7.1\) https://github.com/google/loaner.git
+cd loaner
+```
+
+* To discuss this project send an email to [email protected]. Please note
+  that this group is public (anyone can view/post).
 * Read more about releases in our [release notes](docs/release_notes.md).
 * Please file bugs using the GitHub issue tracker.
 
@@ -66,12 +98,11 @@ cd loaner
 To deploy and configure the Grab n Go (GnG) Loaner project, follow the steps
 below.
 
-1.  [Setup the Web
-    Application](docs/setup_guide.md)
-1.  [Deploy the Grab n Go Chrome
-    App](docs/deploy_chrome_app.md)
-1.  [Configure your G Suite
-    Environment](docs/gsuite_config.md)
++  [Part 1: Create necessary accounts and computer environments](docs/gngsetup_part1.md)
++ [Part 2: Set up the GnG web app](docs/gngsetup_part2.md)
++ [Part 3: Deploy the Grab n Go Chrome app](docs/gngsetup_part3.md)
++ [Part 4: Configure the G Suite Environment](docs/gngsetup_part4.md)
+
 
 #### Reference Documentation
 

diff --git a/WORKSPACE b/WORKSPACE
@@ -154,25 +154,57 @@ http_archive(
     ],
 )
 
+http_archive(
+    name = "futures_archive",
+    build_file = "//third_party:futures.BUILD",
+    sha256 = "9ec02aa7d674acb8618afb127e27fde7fc68994c0437ad759fa094a574adb265",
+    strip_prefix = "futures-3.2.0",
+    urls = [
+        "https://files.pythonhosted.org/packages/1f/9e/7b2ff7e965fc654592269f2906ade1c7d705f1bf25b7d469fa153f7d19eb/futures-3.2.0.tar.gz",
+    ],
+)
+
+bind(
+    name = "futures",
+    actual = "@futures_archive//:futures",
+)
+
+# NOTE: workaround for pkg_resources import issue with gcloud_bigquery.
+http_archive(
+    name = "setup_tools_archive",
+    build_file = "//third_party:setup_tools.BUILD",
+    sha256 = "47881d54ede4da9c15273bac65f9340f8929d4f0213193fa7894be384f2dcfa6",
+    strip_prefix = "setuptools-40.2.0",
+    urls = [
+        "http://mirror.bazel.build/pypi.python.org/packages/source/s/six/setuptools-40.2.0.zip",
+        "https://pypi.python.org/packages/source/s/setuptools/setuptools-40.2.0.zip",
+    ],
+)
+
 http_archive(
     name = "gcloud_bigquery_archive",
     build_file = "//third_party:gcloud_bigquery.BUILD",
-    sha256 = "6e8cc6914701bbfd8845cc0e0b19c5e2123649fc6ddc49aa945d83629499f4ec",
-    strip_prefix = "google-cloud-bigquery-0.25.0",
+    sha256 = "aed2b1d4db1e21d891522d6d6bb14476e6ba58c681cbb68eeb42c168a4e3fda9",
+    strip_prefix = "google-cloud-bigquery-1.1.0",
     urls = [
-        "https://mirror.bazel.build/pypi.python.org/packages/4a/f1/05631b0a29b1f763794404195d161edb24d7463029c987e0a32fc521e2a6/google-cloud-bigquery-0.25.0.tar.gz",
-        "https://pypi.python.org/packages/4a/f1/05631b0a29b1f763794404195d161edb24d7463029c987e0a32fc521e2a6/google-cloud-bigquery-0.25.0.tar.gz",
+        "https://mirror.bazel.build/files.pythonhosted.org/packages/24/f8/54a929bc544d4744ef02cee1c9b97c9498d835445608bf2d099268ed8f1c/google-cloud-bigquery-1.1.0.tar.gz",
+        "https://files.pythonhosted.org/packages/24/f8/54a929bc544d4744ef02cee1c9b97c9498d835445608bf2d099268ed8f1c/google-cloud-bigquery-1.1.0.tar.gz",
     ],
 )
 
+bind(
+    name = "gcloud_bigquery",
+    actual = "@gcloud_bigquery_archive//:gcloud_bigquery",
+)
+
 http_archive(
     name = "gcloud_core_archive",
     build_file = "//third_party:gcloud_core.BUILD",
-    sha256 = "1249ee44c445f820eaf99d37904b37961347019dcd3637dbad1f3173260245f2",
-    strip_prefix = "google-cloud-core-0.25.0",
+    sha256 = "89e8140a288acec20c5e56159461d3afa4073570c9758c05d4e6cb7f2f8cc440",
+    strip_prefix = "google-cloud-core-0.28.1",
     urls = [
-        "https://mirror.bazel.build/pypi.python.org/packages/58/d0/c3a30eca2a0073d5ac00254a1a9d259929a899deee6e3dfe4e45264f5187/google-cloud-core-0.25.0.tar.gz",
-        "https://pypi.python.org/packages/58/d0/c3a30eca2a0073d5ac00254a1a9d259929a899deee6e3dfe4e45264f5187/google-cloud-core-0.25.0.tar.gz",
+        "https://mirror.bazel.build/files.pythonhosted.org/packages/22/f0/a062f4d877420e765f451af99045326e44f9b026088d621ca40011f14c66/google-cloud-core-0.28.1.tar.gz",
+        "https://files.pythonhosted.org/packages/22/f0/a062f4d877420e765f451af99045326e44f9b026088d621ca40011f14c66/google-cloud-core-0.28.1.tar.gz",
     ],
 )
 
@@ -278,23 +310,30 @@ http_archive(
 
 http_archive(
      name = "io_bazel_rules_appengine",
-     sha256 = "3cc3963d883c06d953181c28ce8c32ad4720779fca22a36891fc54ffb41c32d0",
-     strip_prefix = "rules_appengine-edee76dd6892c1af75ad4166c1d3f709d240daf5",
-     url = "https://github.com/bazelbuild/rules_appengine/archive/edee76dd6892c1af75ad4166c1d3f709d240daf5.tar.gz",
+     sha256 = "b5b3c964e7dba92ab2a80857519ef3a8c599c4fc3e84094ea112ec34cfe4b2e2",
+     url = "https://github.com/bazelbuild/rules_appengine/archive/0.0.9.tar.gz",
+     strip_prefix = "rules_appengine-0.0.9",
 )
 
+load(
+    "@io_bazel_rules_appengine//appengine:sdk.bzl",
+    "appengine_repositories",
+)
+
+appengine_repositories()
+
+
 load(
     "@io_bazel_rules_appengine//appengine:py_appengine.bzl",
     "py_appengine_repositories"
 )
-
 py_appengine_repositories()
 
 http_archive(
     name = "io_bazel_rules_python",
-    sha256 = "8b32d2dbb0b0dca02e0410da81499eef8ff051dad167d6931a92579e3b2a1d48",
-    strip_prefix = "rules_python-8b5d0683a7d878b28fffe464779c8a53659fc645",
-    url = "https://github.com/bazelbuild/rules_python/archive/8b5d0683a7d878b28fffe464779c8a53659fc645.tar.gz",
+    sha256 = "9a3d71e348da504a9c4c5e8abd4cb822f7afb32c613dc6ee8b8535333a81a938",
+    strip_prefix = "rules_python-fdbb17a4118a1728d19e638a5291b4c4266ea5b8",
+    url = "https://github.com/bazelbuild/rules_python/archive/fdbb17a4118a1728d19e638a5291b4c4266ea5b8.tar.gz",
 )
 
 load("@io_bazel_rules_python//python:pip.bzl", "pip_repositories", "pip_import")
@@ -469,23 +508,13 @@ http_archive(
     ],
 )
 
-http_archive(
-    name = "setup_tools_archive",
-    build_file = "//third_party:setup_tools.BUILD",
-    sha256 = "6501fc32f505ec5b3ed36ec65ba48f1b975f52cf2ea101c7b73a08583fd12f75",
-    strip_prefix = "setuptools-38.4.0",
-    urls = [
-        "https://pypi.python.org/packages/41/5f/6da80400340fd48ba4ae1c673be4dc3821ac06cd9821ea60f9c7d32a009f/setuptools-38.4.0.zip",
-    ],
-)
-
 http_archive(
     name = "six_archive",
     build_file = "//third_party:six.BUILD",
-    sha256 = "70e8a77beed4562e7f14fe23a786b54f6296e34344c23bc42f07b15018ff98e9",
-    strip_prefix = "six-1.11.0",
+    sha256 = "236bdbdce46e6e6a3d61a337c0f8b763ca1e8717c03b369e87a7ec7ce1319c0a",
+    strip_prefix = "six-1.14.0",
     urls = [
-        "https://pypi.python.org/packages/16/d8/bc6316cf98419719bd59c91742194c111b6f2e85abac88e496adefaf7afe/six-1.11.0.tar.gz",
+        "https://files.pythonhosted.org/packages/21/9f/b251f7f8a76dec1d6651be194dfba8fb8d7781d10ab3987190de8391d08e/six-1.14.0.tar.gz",
     ],
 )
 

diff --git a/docs/README.md b/docs/README.md
@@ -1,15 +1,12 @@
 # Grab n Go Loaners
 
 
-To deploy and configure the Grab n Go (GnG) Loaner project, follow the steps
-below.
+To deploy and configure the Grab n Go (GnG) Loaner project:
 
-1.  [Setup the Web
-    Application](setup_guide.md)
-1.  [Deploy the Grab n Go Chrome
-    App](deploy_chrome_app.md)
-1.  [Configure your G Suite
-    Environment](gsuite_config.md)
++  [Part 1: Create necessary accounts and computer environments](gngsetup_part1.md)
++ [Part 2: Set up the GnG web app](gngsetup_part2.md)
++ [Part 3: Deploy the Grab n Go Chrome app](gngsetup_part3.md)
++ [Part 4: Configure the G Suite Environment](gngsetup_part4.md)
 
 #### Reference Documentation
 

diff --git a/docs/customizations.md b/docs/customizations.md
@@ -0,0 +1,140 @@
+### (Optional) Customize GnG Settings
+
+*Default Configurations* are those options you can configure when GnG is
+running. The default values for these options are defined in
+`loaner/web_app/config_defaults.yaml`. After first launch, GnG stores these
+values in [Cloud Datastore](https://cloud.google.com/datastore/). You can change
+settings without deploying a new version of GnG:
+
++   **allow_guest_mode**: Allow users to use guest mode on loaner devices.
++   **loan_duration**: The number of days to assign a device.
++   **maximum_loan_duration**: The maximum number of days a loaner can be
+    loaned.
++   **loan_duration_email**: Send a duration email to the user.
++   **reminder_email_throttling**: Do not send emails to a user when a reminder
+    appears in the loaner's Chrome app.
++   **reminder_delay**: Number of hours after which GnG will send a reminder
+    email for a device identified as needing a reminder.
++   **shelf_audit**: Enable shelf audit.
++   **shelf_audit_email**: Whether email should be sent for audits.
++   **shelf_audit_email_to**: List of email addresses to receive a notification.
++   **shelf_audit_interval**: The number of hours to allow a shelf to remain
+    unaudited. Can be overwritten via the audit_interval_override property for a
+    shelf.
++   **responsible_for_audit**: Group that is responsible for performing an audit
+    on a shelf.
++   **support_contact**: The name of the support contact.
++   **org_unit_prefix**: The organizational unit to be the root for the GnG
+    child organizational units.
++   **audit_interval**: The shelf audit threshold in hours.
++   **sync_roles_query_size**: The number of users for whom to query and
+    synchronize roles.
++   **anonymous_surveys**: Record surveys anonymously (or not).
++   **use_asset_tags**: To require asset tags when enrolling new devices, set as
+    True. Otherwise, set as False to only require serial numbers.
++   **img_banner_**: The banner is a custom image used in the reminder emails
+    sent to users. Use the URL of an image you have stored in your GCP Storage.
++   **img_button_**: The button images is a custom image used for reminder
+    emails sent to users. Use the URL of an image you have stored in your GCP
+    Storage.
++   **timeout_guest_mode**: Specify that a deferred task should be created to
+    time out guest mode.
++   **guest_mode_timeout_in_hours**: The number of hours to allow guest mode to
+    be in use.
++   **unenroll_ou**: The organizational unit into which to move devices as they
+    leave the GnG program. This value defaults to the root organizational unit.
++   **return_grace_period**: The grace period (in minutes) between a user
+    marking a device as pending return and when we reopen the existing loan.
+
+### (Optional) Customize Images for Button and Banner in Emails
+
+You can upload custom banner and button images to
+[Google Cloud Storage](https://cloud.google.com/storage/) to use in the emails
+sent by the GnG.
+
+To do this, upload your custom images to Google Cloud Storage via the console by
+following
+[these instructions](https://cloud.google.com/storage/docs/cloud-console).
+
+Name your bucket and object something descriptive, e.g.
+`https://storage.cloud.google.com/[BUCKET_NAME]/[OBJECT_NAME]`.
+
+The recommended banner image size is 1280 x 460 and the recommended button size
+is 840 x 140. Make sure the `Public Link` checkbox is checked for both of the
+images you upload to Cloud Storage.
+
+Next, click on the image names in the console to open the images and copy their
+URLs. Take these URLs and populate them as values for the variables
+`img_banner_primary` and `img_button_manage` in the `config_defaults.yaml` file.
+
+### (Optional) Customize Events and Email Templates in the GnG Datastore
+
+This YAML file contains the event settings and email templates that the
+bootstrap process imports into Cloud Datastore after first launch:
+
+`loaner/web_app/backend/lib/bootstrap.yaml`
+
+#### Core Events
+
+Core events (in the `core_events` section) are events that GnG raises at runtime
+when a particular event occurs. For example, the assignment of a new device or
+the enrollment of a new shelf. The calls to raise events are hard-coded and the
+event names in the configuration YAML file must correspond to actions defined in
+the `loaner/web_app/backend/actions` directory.
+
+Specifically, each event can be configured in the datastore to call zero or more
+actions and these actions are defined by the modules contained in the
+`loaner/web_app/backend/actions` directory. Each of these actions will be run as
+an
+[App Engine Task](https://cloud.google.com/appengine/docs/standard/python/taskqueue/),
+which allows them to run asynchronously and not block the processing of GnG.
+
+While GnG contains several pre-coded actions, you can also add your own. For
+example, you can add an action as a module in the
+`loaner/web_app/backend/actions` directory to interact with your organization's
+ticketing or inventory system. If you do this, please be sure to add or remove
+the actions in the applicable events section in the YAML file.
+
+When bootstrapping is complete, this YAML will have been imported and converted
+into Cloud Datastore entities — you'll need to make further changes to those
+entities.
+
+#### Custom Events
+
+Custom events (in the `custom_events` section) are events that GnG raises as
+part of a regular cron job. These events define criteria on the Device and Shelf
+entities in the Cloud Datastore. GnG queries the Datastore using the defined
+criteria and raises Action tasks, just as it does for Core events.
+
+The difference is that GnG uses the query to determine which entities require
+these events. For example, you can specify that Shelf entities with an audit
+date of more than three days ago should trigger an email to a management team
+and run the corresponding actions that are defined for that event.
+
+The custom events system can access the same set of actions as core events.
+
+#### Reminder Events
+
+Reminder events (in the `reminder_events` section) define criteria for device
+entities that trigger reminders for a user. For example, that their device is
+due tomorrow or is overdue. These events are numbered starting with 0. You can
+customize the events as need be.
+
+**Note**: If you customize any event, be sure to change the neighboring events,
+too. Reminder events must not overlap with each other. If so, reminders may
+provide conflicting information to borrowers.
+
+The reminder events system can access the same set of actions as core and custom
+events.
+
+#### Shelf Audit Event
+
+Shelf audit events (in the `shelf_audit_events` section) are events that are
+triggered by the shelf audit cron job. GnG runs a single Shelf audit event by
+default, but you can add custom events as well.
+
+#### Email Templates
+
+The `templates` section contains a base email template for reminders, and
+higher-level templates that extend that base template for specific reminders.
+You can customize the templates.