Add permissions and UHC docs

content/en/apps/guides/forms/uhc-mode.md

@@ -0,0 +1,57 @@
+---
+title: "Universal Health Coverage (UHC) mode"
+linkTitle: UHC mode
+weight: 5
+description: >
+  How to enable UHC monitoring
+relatedContent: >
+  apps/reference/app-settings/user-roles
+  apps/reference/app-settings/user-permissions
+---
+
+_Introduced in v2.18.0_
+
+UHC mode empowers CHWs to provide equitable and timely care to families in their catchment area. The Community Health Toolkit supports this use-case by displaying the number of
+visits made to a household and highlighting households which haven't met their visit goal in red at the top of the contact list.
+
+![UHC mode](UHC.gif)
+
+The date last visited is colored red whenever the date is 30 days or more in the past. The date last visited is displayed as a relative date. Visits that happened today will say "Visited today", visits that happened yesterday will say "Visited yesterday". This period is described in terms of "days" up until two months, so "Visited 3 days ago" or "visited 36 days ago". After two months, we simply say "2 months" or "3 months".
+
+The date of the last visit is displayed and contacts can be sorted by last visit date to allow the CHW plan their work.
+
+![Contact sort](person-contact-form-survey.png)
+
+"Date last visited" and "visits this month" are two completely different data points:
+- Date last visited is calculated based upon a rolling count of "how many days ago" and is not tied to the calendar at all.
+- Visits this month are tied directly to the calendar.
+
+## Configuration
+
+Any patient- or household-level form or forms can be used to update the date last visited. You may run into performance issues if you configure this to look at forms submitted very frequently. For example, we expect five forms submitted only once a month to work better than two forms submitted every day.
+
+### UHC Permissions
+
+To see the date last visited instead of the primary contact, grant the relevant user role (usually CHW) the `can_view_last_visited_date` permission. Once that permission is enabled, you'll be able to display the date the household was last visited in the list.
+
+To view UHC metrics, the `can_view_uhc_stats` permission needs to be granted to the CHW user role.
+
+```json
+  "permissions": {
+    "can_view_last_visited_date": [ "chwUserRole" ]
+  },
+```
+
+### Forms
+
+Next you need to indicate which forms should be included in the calculation of the date last visited. You can use forms at the person or household level. A field called `visited_contact_uuid` needs to be added to forms used to track visits. This should be a calculate field that contains the household (clinic level place) UUID of the visited contact. Make sure this is a top-level field (not in any group and should be in `doc.fields.visited_contact_uuid` when the form is submitted.
+
+### Settings
+
+Finally, the app needs to know when to begin counting visits for a month, what the visit goal is for a household and the default contact sort. This information is defined in `base_settings.json`
+
+| Setting              | Description | Default | Version |
+|----------------------|---------|---------|---------|
+| uhc.contacts_default_sort | <ul><li>"alpha": Sort contacts alphanumerically</li><li>"last_visited_date": sort contacts by the date they were most recently visited.</li></ul> | "alpha" | 2.18.0 |
+| uhc.visit_count.month_start_date | The date of each month when the visit count is reset to 0. | 1 |2.18.0 |
+| uhc.visit_count.visit_count_goal | The monthly visit count goal. | 0 | 2.18.0 |