Rename users to raw_users. Also tidy up some comments and indices

lms/data_tasks/report/create_from_scratch/02_entities/01_users/01_raw_users/01_create_view.jinja2.sql

@@ -0,0 +1,15 @@
+DROP MATERIALIZED VIEW IF EXISTS report.raw_users CASCADE;
+
+-- The building blocks of a user. We won't export this. See
+-- `*_entities_decorated/*_users` for the version for external consumers.
+CREATE MATERIALIZED VIEW report.raw_users AS (
+    SELECT
+         id,
+         username,
+         registered_date::date
+    FROM h.user AS users
+    WHERE
+        users.authority = '{{ region.authority }}'
+        -- users.authority = 'lms.hypothes.is'
+    ORDER BY registered_date
+) WITH NO DATA;

lms/data_tasks/report/create_from_scratch/02_entities/01_users/01_raw_users/02_initial_fill.sql

@@ -0,0 +1,8 @@
+DROP INDEX IF EXISTS report.raw_users_id_idx;
+
+REFRESH MATERIALIZED VIEW report.raw_users;
+
+ANALYSE report.raw_users;
+
+-- A unique index is mandatory for concurrent updates used in the refresh
+CREATE UNIQUE INDEX raw_users_id_idx ON report.raw_users (id);

lms/data_tasks/report/create_from_scratch/02_entities/01_users/02_user_map/01_create_view.sql

@@ -4,11 +4,11 @@ DROP MATERIALIZED VIEW IF EXISTS report.user_map CASCADE;
 CREATE MATERIALIZED VIEW report.user_map AS (
     SELECT
         lms_users.id AS lms_user_id,
-        users.id AS user_id,
+        raw_users.id AS user_id,
         application_instances.organization_id
     FROM "user" AS lms_users
-    JOIN report.users ON
-        users.username = SUBSTRING(SPLIT_PART(lms_users.h_userid, '@', 1), 6)
+    JOIN report.raw_users ON
+        raw_users.username = SUBSTRING(SPLIT_PART(lms_users.h_userid, '@', 1), 6)
     JOIN application_instances ON
         lms_users.application_instance_id = application_instances.id
     ORDER BY lms_user_id, user_id

lms/data_tasks/report/refresh/01_entities_refresh.sql

@@ -1,5 +1,5 @@
-REFRESH MATERIALIZED VIEW CONCURRENTLY report.users;
-ANALYSE report.users;
+REFRESH MATERIALIZED VIEW CONCURRENTLY report.raw_users;
+ANALYSE report.raw_users;
 
 REFRESH MATERIALIZED VIEW CONCURRENTLY report.user_map;
 ANALYSE report.user_map;