@plusscommunities/pluss-maintenance-aws-feedback 2.1.15-beta.1

package/values.config.forms.js

@@ -0,0 +1,30 @@
+const values = {
+  entityKey: "maintenancerequestForms",
+  serviceKey: "maintenanceForms",
+  updateKey: "jobsForms",
+  tableKeyJobTypes: "jobtypesForms",
+  tableKeyMaintenance: "maintenanceForms",
+  tableKeySupportTickets: "supportticketsForms",
+  tableNameJobTypes: "jobTypesForms",
+  tableNameMaintenance: "maintenanceForms",
+  tableNameSupportTickets: "supportticketsForms",
+  permissionMaintenanceTracking: "maintenanceTrackingForms",
+  permissionMaintenanceAssignment: "maintenanceAssignmentForms",
+  permissionMaintenanceTypes: "maintenanceTypesForms",
+  routeEntityPath: "/requestsHubForms/jobDetails/:id",
+  screenMaintenanceDetail: "requestDetailForms",
+  notificationMaintenanceJobAssigned: "MaintenanceJobAssignedForms",
+  notificationMaintenanceJobUnassigned: "MaintenanceJobUnassignedForms",
+  activityAddMaintenanceJob: "AddMaintenanceJobForms",
+  activityDeleteMaintenanceJob: "DeleteMaintenanceJobForms",
+  activityEditMaintenanceJob: "EditMaintenanceJobForms",
+  activityMaintenanceJobStatusChanged: "MaintenanceJobStatusChangedForms",
+  activityAddMaintenanceNote: "AddMaintenanceNoteForms",
+  activityDeleteMaintenanceNote: "DeleteMaintenanceNoteForms",
+  activityEditMaintenanceNote: "EditMaintenanceNoteForms",
+  textJobEmailTitle: "Form Submission",
+  allowGeneralType: false,
+  defaultJobTypes: [],
+  triggerMaintenanceStatusChanged: "MaintenanceStatusChangedForms",
+};
+exports.values = values;

package/values.config.js

@@ -0,0 +1,195 @@
+const values = {
+  entityKey: "maintenancerequestFeedback",
+  serviceKey: "maintenanceFeedback",
+  updateKey: "jobsFeedback",
+  tableKeyJobTypes: "jobtypesFeedback",
+  tableKeyMaintenance: "maintenanceFeedback",
+  tableKeySupportTickets: "supportticketsFeedback",
+  tableNameJobTypes: "jobTypesFeedback",
+  tableNameMaintenance: "maintenanceFeedback",
+  tableNameSupportTickets: "supportticketsFeedback",
+  permissionMaintenanceTracking: "maintenanceTrackingFeedback",
+  permissionMaintenanceAssignment: "maintenanceAssignmentFeedback",
+  permissionMaintenanceTypes: "maintenanceTypesFeedback",
+  routeEntityPath: "/requestsHubFeedback/jobDetails/:id",
+  screenMaintenanceDetail: "requestDetailFeedback",
+  notificationMaintenanceJobAssigned: "MaintenanceJobAssignedFeedback",
+  notificationMaintenanceJobUnassigned: "MaintenanceJobUnassignedFeedback",
+  activityAddMaintenanceJob: "AddMaintenanceJobFeedback",
+  activityDeleteMaintenanceJob: "DeleteMaintenanceJobFeedback",
+  activityEditMaintenanceJob: "EditMaintenanceJobFeedback",
+  activityMaintenanceJobStatusChanged: "MaintenanceJobStatusChangedFeedback",
+  activityAddMaintenanceNote: "AddMaintenanceNoteFeedback",
+  activityDeleteMaintenanceNote: "DeleteMaintenanceNoteFeedback",
+  activityEditMaintenanceNote: "EditMaintenanceNoteFeedback",
+  textJobEmailTitle: "Feedback Submission",
+  allowGeneralType: false,
+  defaultJobTypes: [
+    {
+      customFields: [
+        {
+          isTitle: false,
+          label: "What is the feedback about?",
+          mandatory: true,
+          type: "text",
+        },
+        {
+          isTitle: false,
+          label: "Feedback details",
+          mandatory: true,
+          placeHolder:
+            "Record specific details related to your feedback. Include dates, names, other relevant information in the order they happened",
+          type: "text",
+        },
+        {
+          isTitle: false,
+          label: "Desired outcome",
+          mandatory: false,
+          placeHolder:
+            "Describe the outcome you would like to see achieved as a result of the feedback you have provided.",
+          type: "text",
+        },
+        {
+          isTitle: false,
+          label: "Thanks for taking the time to share your feedback with us.",
+          mandatory: false,
+          type: "staticText",
+        },
+      ],
+      description:
+        "Use this form to provide general feedback that is not a specific complaint or compliment",
+      email: "feedback@plusscommunities.com",
+      hasCustomFields: true,
+      level: 1,
+      typeName: "General Feedback",
+    },
+    {
+      customFields: [
+        {
+          isTitle: false,
+          label: "What is the complaint about?",
+          mandatory: true,
+          type: "checkbox",
+          values: [
+            "An employee",
+            "Another community member",
+            "A specific incident",
+            "Service delivery",
+            "A facility",
+            "An Activity",
+            "Other",
+          ],
+        },
+        {
+          isTitle: false,
+          label: "Complaint details",
+          mandatory: true,
+          placeHolder:
+            "Please provide the details of your complaint in this section. Include dates, names, other relevant information in the order they happened",
+          type: "text",
+        },
+        {
+          isTitle: false,
+          label: "Action required",
+          mandatory: true,
+          placeHolder:
+            "Please describe what action, if any, you would like the organisation to take in relation to this matter",
+          type: "text",
+        },
+        {
+          isTitle: false,
+          label: "Have you raised this complaint previously",
+          mandatory: true,
+          type: "yn",
+        },
+        {
+          isTitle: false,
+          label:
+            "If yes, please provide details of who you complained to, when and how (phone, email, form)",
+          mandatory: false,
+          type: "text",
+        },
+        {
+          isTitle: false,
+          label:
+            "If you have any supporting documentation (e.g. emails, letters, receipts) for your complaint, please attach the files below. If you do not have the documentation right now, you can email us.",
+          mandatory: false,
+          type: "document",
+        },
+        {
+          isTitle: false,
+          label:
+            "Declaration .  I declare that the information supplied by me is, to the best of my knowledge, true and correct. ",
+          mandatory: true,
+          type: "yn",
+        },
+        {
+          isTitle: false,
+          label:
+            "I agree that the information provided (except for demographic data) may, if necessary, be revealed to the organisation in correspondence or investigations concerning this complaint or referred to another authority for their appropriate action should the matter fall outside this department's jurisdiction",
+          mandatory: true,
+          type: "yn",
+        },
+        {
+          isTitle: false,
+          label:
+            "If your complaint is resolved after lodgement of this form, please advise us at as soon as possible.",
+          mandatory: false,
+          type: "staticText",
+        },
+      ],
+      description: "Use this form to provide a complaint to the organisation",
+      email: "example@plusscommunities.com",
+      hasCustomFields: true,
+      level: 1,
+      typeName: "Complaint",
+    },
+    {
+      customFields: [
+        {
+          isTitle: false,
+          label: "What is this compliment about?",
+          mandatory: true,
+          type: "multichoice",
+          values: [
+            "An employee",
+            "A facility",
+            "Another community member",
+            "A facility",
+            "A service",
+            "An activity",
+            "Other",
+          ],
+        },
+        {
+          isTitle: false,
+          label: "Compliment details",
+          mandatory: true,
+          placeHolder: "Please explain your compliment in detail",
+          type: "text",
+        },
+        {
+          isTitle: false,
+          label:
+            "Please describe what action, if any, you would like us to take in relation to this compliment",
+          mandatory: false,
+          type: "text",
+        },
+        {
+          isTitle: false,
+          label:
+            "Thanks for taking the time to record your compliment. It is always appreciated.",
+          mandatory: false,
+          type: "staticText",
+        },
+      ],
+      description: "Use this form to record a compliment",
+      email: "example@pluss.com",
+      hasCustomFields: true,
+      level: 1,
+      typeName: "Compliment",
+    },
+  ],
+  triggerMaintenanceStatusChanged: "MaintenanceStatusChangedFeedback",
+};
+exports.values = values;

package/watchJobs.js

@@ -0,0 +1,177 @@
+const moment = require("moment");
+const _ = require("lodash");
+const scanRefRecursive = require("@plusscommunities/pluss-core-aws/db/common/scanRefRecursive");
+const logAnalyticsActivity = require("@plusscommunities/pluss-core-aws/db/analytics/logAnalyticsActivity");
+const checkActivityExists = require("@plusscommunities/pluss-core-aws/db/analytics/checkActivityExists");
+const updateRef = require("@plusscommunities/pluss-core-aws/db/common/updateRef");
+const editRef = require("@plusscommunities/pluss-core-aws/db/common/editRef");
+const getRef = require("@plusscommunities/pluss-core-aws/db/common/getRef");
+const { getRowId, log } = require("@plusscommunities/pluss-core-aws/helper");
+const getUserPreview = require("@plusscommunities/pluss-core-aws/helper/getUserPreview");
+const { values } = require("./values.config");
+
+const checkFixCompleted = async (job) => {
+  const logId = log("checkFixCompleted", "Input", job.id);
+  if (job.status !== "Completed") {
+    log("checkFixCompleted", "Incomplete", job.status);
+    return true;
+  }
+
+  // find entry in history to determine who completed and at what time
+  let userId;
+  let time = job.lastActivity;
+  if (!_.isEmpty(job.history)) {
+    const entry = _.findLast(job.history, (e) => {
+      return e.status === "Completed";
+    });
+    if (entry) {
+      if (entry.user && entry.user.id) {
+        userId = entry.user.id;
+      }
+      time = entry.timestamp;
+    }
+  }
+  const user = await getUserPreview(userId);
+
+  // add old log
+  await logAnalyticsActivity(
+    "RequestCompleted",
+    values.entityKey,
+    job.site,
+    user,
+    job.id,
+    null,
+    moment(time).valueOf()
+  );
+  log("checkFixCompleted", "Logged", true, logId);
+
+  // tell system to aggregate this date again
+  const date = moment(time).local().format("DD-MM-YYYY");
+  log("checkFixCompleted", "QueueingDate", date, logId);
+  await updateRef("analyticsqueue", {
+    Id: getRowId(job.site, date),
+    Site: job.site,
+    Date: date,
+  });
+};
+
+const fixActivityLog = async (job, startTime) => {
+  const now = moment().unix();
+  if (now - startTime > 240) {
+    return false;
+  }
+
+  // check whether it's already been logged
+  const exists = await checkActivityExists(job.id, values.entityKey, "Request");
+  const logId = log("fixActivityLog", "exists", exists);
+
+  if (!exists) {
+    const user = await getUserPreview(job.userID);
+
+    // add old log
+    await logAnalyticsActivity(
+      "Request",
+      values.entityKey,
+      job.site,
+      user,
+      job.id,
+      null,
+      moment(job.createdTime).valueOf()
+    );
+    log("fixActivityLog", "Logged", true, logId);
+
+    // tell system to aggregate this date again
+    const date = moment(job.createdTime).local().format("DD-MM-YYYY");
+    log("fixActivityLog", "QueueingDate", date, logId);
+    await updateRef("analyticsqueue", {
+      Id: getRowId(job.site, date),
+      Site: job.site,
+      Date: date,
+    });
+
+    // check whether to log activity for the job's completion
+    await checkFixCompleted(job);
+  }
+
+  // update entry to show it's been logged
+  await editRef(values.tableNameMaintenance, "id", job.id, {
+    ActivityLogged: true,
+  });
+
+  return true;
+};
+
+const checkFixLog = async (startTime) => {
+  // Check whether all posts have been logged
+  const logId = log("checkFixLog", "StartTime", startTime);
+  const stringSite = "plussSpace";
+  const stringId = `JobActivityLogged`;
+  const stringRowId = getRowId(stringSite, stringId);
+  try {
+    const string = await getRef("strings", "RowId", stringRowId);
+    if (string && string.Value === "true") {
+      log("checkFixLog", "ActivityLogged", true, logId);
+      return true;
+    }
+  } catch (e) {
+    // ignore error
+  }
+
+  // Scans the DynamoDB table and fetch all items. The parameters describe which attributes to get.
+  const items = await scanRefRecursive(values.tableNameMaintenance, {
+    ProjectionExpression:
+      "#id, site, createdTime, #status, lastActivity, history, ActivityLogged",
+    ExpressionAttributeNames: {
+      "#id": "id",
+      "#status": "status",
+    },
+  });
+  log(
+    "checkFixLog",
+    "FetchedItemsCount",
+    {
+      count: items.length,
+    },
+    logId
+  );
+
+  // Filters out items which have already had the activity log operation applied.
+  const itemsToProcess = items.filter((item) => !item.ActivityLogged);
+  log(
+    "checkFixLog",
+    "ItemsToProcessCount",
+    { count: itemsToProcess.length },
+    logId
+  );
+
+  // Finished logging old entries. Save to avoid continuous full scans of the table.
+  if (_.isEmpty(itemsToProcess)) {
+    const entry = {
+      Site: stringSite,
+      StringId: stringId,
+      Value: "true",
+      RowId: stringRowId,
+    };
+
+    await updateRef("strings", entry);
+  }
+
+  // The loop goes through the remaining items and applies the fixActivityLog operation on each item.
+  // If the operation fails on an item, it logs the error but continues with the remaining items.
+  for (let item of itemsToProcess) {
+    // try {
+    await fixActivityLog(item, startTime);
+    log("checkFixLog", "SuccessFixActivityLog", { id: item.Id }, logId);
+    // } catch (err) {
+    //   log("checkFixLog", `Error:${item.Id}`, err, logId);
+    // }
+  }
+
+  log("checkFixLog", "End", "All items processed", logId);
+  return true;
+};
+
+module.exports.watchJobs = async (event, context, callback) => {
+  const startTime = moment().unix();
+  await checkFixLog(startTime);
+};