placementt-core 11.0.533 → 11.0.803

package/src/tasksAndTips.ts

@@ -1,18 +1,18 @@
-import {arrayUnion, orderBy, where} from "firebase/firestore";
+import {arrayUnion, documentId, orderBy, where} from "firebase/firestore";
 import FirebaseQuery from "./firebase/firebaseQuery";
-import {CohortData, InstituteData, ProviderData, StudentPlacementData, UserData} from "./typeDefinitions";
-import {getAccess} from "./firebase/util";
+import {CohortData, InstituteData, OrganisationAddress, PlacementListing, ProviderData, RegistrationRequest, StudentPlacementData, UserData} from "./typeDefinitions";
+import {camelCaseToNormal, capitaliseWords, dateToString, getAccess} from "./firebase/util";
 import { convertDate } from "./firebase/util";
 
 const firebaseQuery = new FirebaseQuery;
 
-type InstituteTipNames = "createCohort"|"uploadStaff"|"assignStaffRoles"|"uploadPlacements"|"allowExternalPlacementUpload"|"uploadStaffGuidance"|"uploadStudentGuidance"
+type InstituteTipNames = "createCohort"|"addSchools"|"uploadStaff"|"assignStaffRoles"|"uploadPlacements"|"allowExternalPlacementUpload"|"uploadStaffGuidance"|"uploadStudentGuidance"
 type ProviderTipNames = string
 type StudentTipNames = string
 
-export type InstituteTaskNames = "missingParentEmail"|"verifyInsurance"|"verifyRiskAssessment"|"verifyDbsCheck"|"inactiveStudents"|"uploadStudents"|"inactiveStaff"|"requiredStage"|"approveExternalPlacement"|"overdueStage"
+export type InstituteTaskNames = "missingParentEmail"|"outstandingReminders"|"invalidStaffEmails"|"invalidStudentEmails"|"invalidParentEmails"|"invalidProviderEmails"|"verifyInsurance"|"verifyRiskAssessment"|"verifyDbsCheck"|"inactiveStudents"|"uploadStudents"|"inactiveStaff"|"requiredStage"|"approveExternalPlacement"|"overdueStage"
 export type StudentTaskNames = "completeOnboarding"
-export type ProviderTaskNames = "applicationRequireReview"|"requestedVisiblePlacementListings"|"requestedVisibleAddresses"|"completeStudentDocs"|"reviewOnboarding"|"completeListing"|"completeAddress"|"registrationRequests"|"placementStarting"|"completeFeedback"|"setUpFeedback"
+export type ProviderTaskNames = "applicationRequireReview"|"activateStaff"|"requestedVisiblePlacementListings"|"requestedVisibleAddresses"|"completeStudentDocs"|"uploadOnboarding"|"reviewOnboarding"|"completeListing"|"completeAddress"|"registrationRequests"|"placementStarting"|"completeFeedback"|"setUpFeedback"
 
 // IF UPDATING LOGIC WITHIN THIS FILE, PLACEMENTT-BACKEND LOGIC MUST ALSO BE CHANGED ACCORDINGLY
 
@@ -34,7 +34,7 @@ type TasksObject = {
 */
 type InstituteTipsObject = {
     [key in InstituteTipNames]: {
-        callback: (user: UserData, organisation?:InstituteData|ProviderData) => Promise<TaskQueryReturnObject|TaskQueryReturnObject[]>,
+        callback: (user: UserData, organisation?:InstituteData|ProviderData, additional?:{[key: string]: OrganisationAddress}) => Promise<TaskQueryReturnObject|TaskQueryReturnObject[]>,
     };
 };
 type ProviderTipsObject = {
@@ -69,6 +69,21 @@ const studentTips:StudentTipsObject = {}
 
 
 const instituteTips:InstituteTipsObject = {
+    addSchools: {
+        callback: async (user, institute, schools) => {
+            if (!getAccess(user, "addSchools") || institute?.package !== "institutes-two") return;
+            if (Object.keys(schools as {[key: string]: OrganisationAddress}).length < 2) {
+                return {
+                    title: "Add your schools",
+                    message: "Add your schools. These will show up in the 'Cohorts' tab where you can assign cohorts of students to them.",
+                    link: "/institutes/organisation/overview",
+                    buttonTitle: "Add schools",
+                    dismissible: true
+                };
+            }
+            return;
+        },
+    },
     createCohort: {
         callback: async (user) => {
             if (!getAccess(user, "createCohorts")) return;
@@ -183,9 +198,162 @@ const instituteTips:InstituteTipsObject = {
 //  Accept a cohort to any task
 
 const instituteTasks:InstituteTaskObject = {
+    invalidStaffEmails: {
+        callback: async (user, organisation, cohort) => {
+            if (!getAccess(user, "viewStaff") || !Array.isArray(cohort)) return;
+
+            const staffCount = (await firebaseQuery.getCount(["users"], [where("oId", "==", user.oId), where("userType", "==", "Staff"), where("flags", "array-contains", "userEmailFailed")]));
+            if (staffCount > 0) {
+                return {
+                    dismissible: false,
+                    severity: "error",
+                    title: `${staffCount} staff have invalid emails.`,
+                    message: `${staffCount} staff accounts have invalid email addresses. Delete and reupload these users.`,
+                    link: "/institutes/cohorts/staff/all",
+                };
+            }
+            return;
+        },
+    },
+    invalidStudentEmails: {
+        callback: async (user, organisation, cohorts) => {
+            if (!getAccess(user, "viewStudents") || user.viewStudents === "none") return;
+
+            if (!Array.isArray(cohorts)) {
+                const studentCount = (await firebaseQuery.getCount(["users"], [where("oId", "==", user.oId), where("userType", "==", "Students"), where("cohort", "==", cohorts.id), where("flags", "array-contains", "userEmailFailed")]));
+                if (studentCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "error",
+                        title: `${studentCount} students have invalid emails.`,
+                        message: `${studentCount} student accounts have invalid email addresses. Delete and reupload these users.`,
+                        link: `/institutes/cohorts/${cohorts.id}/students`,
+                    };
+                }
+                return;
+            }
+
+            const items = await Promise.all(cohorts.map(async ([id, cohort]) => {
+                const studentCount = (await firebaseQuery.getCount(["users"], [where("oId", "==", user.oId), where("userType", "==", "Students"), where("cohort", "==", id), where("flags", "array-contains", "userEmailFailed")]));
+                if (studentCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "error",
+                        title: `${studentCount} students have invalid emails.`,
+                        message: `Your cohort, ${cohort.name}, has ${studentCount} student accounts with invalid email addresses. Delete and reupload these users.`,
+                        link: `/institutes/cohorts/${id}/students`,
+                    } as TaskQueryReturnObject;
+                }
+                return;
+            }));
+            return items.filter((v) => v);
+        },
+    },
+    outstandingReminders: {
+        callback: async (user, organisation, cohorts) => {
+            if (!Array.isArray(cohorts)) {
+                const reminderCount = (await firebaseQuery.getCount(["reminders"], [where("oId", "==", user.oId), where("uid", "==", user.id), where("dueDate", "<=", convertDate(new Date(), "dbstring") as string), where("cohort", "==", cohorts.id), where("status", "==", "upcoming")]));
+                if (reminderCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "primary",
+                        title: `You have ${reminderCount} reminder${reminderCount > 1 ? "s" : ""}.`,
+                        message: `You have ${reminderCount} outstanding placement reminder${reminderCount > 1 ? "s" : ""}. Click to view.`,
+                        link: `/institutes/cohorts/${cohorts.id}/placements`,
+                    };
+                }
+                return;
+            }
+
+            const items = await Promise.all(cohorts.map(async ([id, cohort]) => {
+                const reminderCount = (await firebaseQuery.getCount(["reminders"], [where("oId", "==", user.oId), where("uid", "==", user.id), where("dueDate", "<=", convertDate(new Date(), "dbstring") as string), where("cohort", "==", id), where("status", "==", "upcoming")]));
+                if (reminderCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "primary",
+                        title: `You have ${reminderCount} reminder${reminderCount > 1 ? "s" : ""}.`,
+                        message: `Your cohort, ${cohort.name}, has ${reminderCount} outstanding placement reminder${reminderCount > 1 ? "s" : ""}. Click to view.`,
+                        link: `/institutes/cohorts/${id}/placements`,
+                    } as TaskQueryReturnObject;
+                }
+                return;
+            }));
+            return items.filter((v) => v);
+        },
+    },
+    invalidParentEmails: {
+        callback: async (user, _, cohorts) => {
+            if (!getAccess(user, "signOffPlacements") || user.viewStudents === "none") return;
+
+            if (!Array.isArray(cohorts)) {
+                const placementCount = (await firebaseQuery.getCount(["placements"], [where("oId", "==", user.oId), where("cohort", "==", cohorts.id), where("flags", "array-contains", "parentEmailFailed")]));
+                if (placementCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "error",
+                        title: `${placementCount} placements have invalid parent emails.`,
+                        message: `Your cohort '${cohorts.name}' has placements with invalid parent emails. Click to view these placements.`,
+                        link: `/institutes/cohorts/${cohorts.id}/placements?id=upcoming`,
+                    };
+                }
+                return;
+            }
+
+            const items = await Promise.all(cohorts.map(async ([id, cohort]) => {
+                const placementCount = (await firebaseQuery.getCount(["placements"], [where("oId", "==", user.oId), where("cohort", "==", id), where("flags", "array-contains", "parentEmailFailed")]));
+                if (placementCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "error",
+                        title: `${placementCount} placements in '${cohort.name}' have invalid parent emails.`,
+                        message: `Your cohort '${cohort.name}' has placements with invalid parent emails. Click to view these placements.`,
+                        link: `/institutes/cohorts/${id}/placements?id=upcoming`,
+                        buttonTitle: "Review placements",
+                    } as TaskQueryReturnObject;
+                }
+                return;
+            }));
+            return items.filter((v) => v);
+        },
+    },
+    invalidProviderEmails: {
+        callback: async (user, organisation, cohorts) => {
+            if (!getAccess(user, "signOffPlacements") || user.viewStudents === "none") return;
+
+            if (!Array.isArray(cohorts)) {
+                const placementCount = (await firebaseQuery.getCount(["placements"], [where("oId", "==", user.oId), where("cohort", "==", cohorts.id), where("flags", "array-contains", "providerEmailFailed")]));
+                if (placementCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "error",
+                        title: `${placementCount} placements have invalid provider emails.`,
+                        message: `Your cohort '${cohorts.name}' has placements with invalid provider emails. Click to view these placements.`,
+                        link: `/institutes/cohorts/${cohorts.id}/placements?id=upcoming`,
+                    };
+                }
+                return;
+            }
+
+            const items = await Promise.all(cohorts.map(async ([id, cohort]) => {
+                const placementCount = (await firebaseQuery.getCount(["placements"], [where("oId", "==", user.oId), where("cohort", "==", id), where("flags", "array-contains", "providerEmailFailed")]));
+                if (placementCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "error",
+                        title: `${placementCount} placements in '${cohort.name}' have invalid provider emails.`,
+                        message: `Your cohort '${cohort.name}' has placements with invalid provider emails. Click to view these placements.`,
+                        link: `/institutes/cohorts/${id}/placements?id=upcoming`,
+                        buttonTitle: "Review placements",
+                    } as TaskQueryReturnObject;
+                }
+                return;
+            }));
+            return items.filter((v) => v);
+        },
+    },
     requiredStage: {
         callback: async (user, _, cohorts) => {
-            if (!getAccess(user, "signOffPlacements")) return;
+            if (!getAccess(user, "signOffPlacements") || user.viewStudents === "none") return;
 
             if (!Array.isArray(cohorts)) {
                 const placementCount = (await firebaseQuery.getCount(["placements"], [where("oId", "==", user.oId), where("cohort", "==", cohorts.id), where("reqUserType", "==", user.userType)]));
@@ -220,7 +388,7 @@ const instituteTasks:InstituteTaskObject = {
     },
     verifyInsurance: {
         callback: async (user, _, cohorts) => {
-            if (!getAccess(user, "verifyInsurance")) return;
+            if (!getAccess(user, "verifyInsurance") || user.viewStudents === "none") return;
 
             if (!Array.isArray(cohorts)) {
                 const placementCount = (await firebaseQuery.getCount(["placements"], [where("oId", "==", user.oId), where("cohort", "==", cohorts.id), where("insurance", "==", "awaitingReview")]));
@@ -255,7 +423,7 @@ const instituteTasks:InstituteTaskObject = {
     },
     verifyDbsCheck: {
         callback: async (user, _, cohorts) => {
-            if (!getAccess(user, "verifyDbsChecks")) return;
+            if (!getAccess(user, "verifyDbsChecks") || user.viewStudents === "none") return;
 
             if (!Array.isArray(cohorts)) {
                 const placementCount = (await firebaseQuery.getCount(["placements"], [where("oId", "==", user.oId), where("cohort", "==", cohorts.id), where("dbsCheck", "==", "awaitingReview")]));
@@ -290,7 +458,7 @@ const instituteTasks:InstituteTaskObject = {
     },
     verifyRiskAssessment: {
         callback: async (user, _, cohorts) => {
-            if (!getAccess(user, "verifyRiskAssessments")) return;
+            if (!getAccess(user, "verifyRiskAssessments") || user.viewStudents === "none") return;
 
             if (!Array.isArray(cohorts)) {
                 const placementCount = (await firebaseQuery.getCount(["placements"], [where("oId", "==", user.oId), where("cohort", "==", cohorts.id), where("riskAssessment", "==", "awaitingReview")]));
@@ -325,7 +493,7 @@ const instituteTasks:InstituteTaskObject = {
     },
     missingParentEmail: {
         callback: async (user, _, cohorts) => {
-            if (!getAccess(user, "editStudents")) return;
+            if (!getAccess(user, "editStudents") || user.viewStudents === "none") return;
             if (!Array.isArray(cohorts)) {
                 const requiresParents = Boolean(cohorts.workflow.find((node) => node.userType === "Parent"))
                 if (!requiresParents) return;
@@ -372,7 +540,7 @@ const instituteTasks:InstituteTaskObject = {
     },
     inactiveStudents: {
         callback: async (user, _, cohorts) => {
-            if (!getAccess(user, "activateStudents")) return;
+            if (!getAccess(user, "activateStudents") || user.viewStudents === "none") return;
             if (!Array.isArray(cohorts)) {
                 const constraints = [where("oId", "==", user.oId), where("cohort", "==", cohorts.id), where("status", "==", "inactive")];
 
@@ -406,7 +574,7 @@ const instituteTasks:InstituteTaskObject = {
                         title: `${studentCount} students in '${cohort.name}' are inactive.`,
                         message: `Your cohort '${cohort.name}' has inactive students. Activate them to enable them to use the platform.`,
                         link: `/institutes/cohorts/${cohort.id}/students?status=inactive`,
-                        buttonTitle: "Review placements",
+                        buttonTitle: "Review students",
                     } as TaskQueryReturnObject;
                 }
                 return;
@@ -417,7 +585,7 @@ const instituteTasks:InstituteTaskObject = {
     uploadStudents: {
         callback: async (user, _, cohorts) => {
             if (!Array.isArray(cohorts)) return;
-            if (!getAccess(user, "addStudents")) return;
+            if (!getAccess(user, "addStudents") || user.viewStudents === "none") return;
             if (user.product !== "institutes") return;
             const returnObj: TaskQueryReturnObject = {
                 link: "",
@@ -493,13 +661,12 @@ const studentTasks:StudentTaskObject = {
     completeOnboarding: {
         callback: async (user) => {
             const placementsWithoutOnboarding = await firebaseQuery.getDocsWhere("placements", [where("uid", "==", user.id), where("onboarding.deadline", "<=", convertDate(new Date(), "dbstring")), where("onboarding.completed.submitted", "==", false)]) as {[key: string]: StudentPlacementData};
-            console.log("placementsWithoutONboarding", placementsWithoutOnboarding);
             if (Object.keys(placementsWithoutOnboarding).length === 0) return;
             const items = Object.entries(placementsWithoutOnboarding).map(([k, placement]) => ({
                 dismissible: false,
                 severity: "primary",
-                title: `Complete required onboarding documents for ${placement.name}`,
-                message: `${placement.name} has requested you to complete some onboarding documents.`,
+                title: `Complete onboarding for ${placement.name}`,
+                message: `Review onboarding for your placement starting on ${convertDate(placement.startDate, "visual")}`,
                 link: `/${user.product}/placements/${k}`,
                 buttonTitle: "View onboarding",
             } as TaskQueryReturnObject))
@@ -511,10 +678,11 @@ const studentTasks:StudentTaskObject = {
 const providerTasks:ProviderTaskObject = {
     requestedVisibleAddresses: {
         callback: async (user) => {
-            const accessRequests = await firebaseQuery.getCount("users", [where("oId", "==", user.oId), where("product", "==", "providers"), orderBy("requestedVisibleAddresses")]);
+            if (!getAccess(user, "addStaff")) return;
+            const accessRequests = await firebaseQuery.getCount("users", [where("oId", "==", user.oId), where("product", "==", "providers"), orderBy("requestedVisibleAddresses")]) - ((Array.isArray(user?.requestedVisibleAddresses) && user?.requestedVisibleAddresses.length > 0) ? 1 : 0);
             if (accessRequests === 0) return;
             if (accessRequests === 1) {
-                const userRequestingAccess = Object.entries(await firebaseQuery.getDocsWhere("users", [where("oId", "==", user.oId), where("product", "==", "providers"), orderBy("requestedVisibleAddresses")]) || {})[0] as [string, UserData];
+                const userRequestingAccess = Object.entries(await firebaseQuery.getDocsWhere("users", [where("product", "==", "providers"), where("oId", "==", user.oId), orderBy("requestedVisibleAddresses")]) || {})[0] as [string, UserData];
                 return {
                     dismissible: false,
                     severity: "primary",
@@ -537,7 +705,8 @@ const providerTasks:ProviderTaskObject = {
     },
     requestedVisiblePlacementListings: {
         callback: async (user) => {
-            const accessRequests = await firebaseQuery.getCount("users", [where("oId", "==", user.oId), where("product", "==", "providers"), orderBy("requestedVisibleListings")]);
+            if (!getAccess(user, "addStaff")) return;
+            const accessRequests = await firebaseQuery.getCount("users", [where("oId", "==", user.oId), where("product", "==", "providers"), orderBy("requestedVisibleListings")])- ((Array.isArray(user?.requestedVisibleListings) && user?.requestedVisibleListings.length > 0) ? 1 : 0);;
             if (accessRequests === 0) return;
             if (accessRequests === 1) {
                 const userRequestingAccess = Object.entries(await firebaseQuery.getDocsWhere("users", [where("oId", "==", user.oId), where("product", "==", "providers"), orderBy("requestedVisibleListings")]) || {})[0] as [string, UserData];
@@ -563,7 +732,26 @@ const providerTasks:ProviderTaskObject = {
     },
     applicationRequireReview: {
         callback: async (user) => {
-            const applicationCount = await firebaseQuery.getCount("applications", [where("providerId", "==", user.oId), where("reqUserType", "==", "Staff"), where("status", "==", "submitted")]);
+            const constraints = [where("providerId", "==", user.oId), where("reqUserType", "==", "Staff"), where("status", "==", "submitted")];
+
+            if (user.userGroup !== "admin") {
+                
+                if (!user.viewPlacementListings || user.viewPlacementListings === "none") return;
+                if (!user.viewAddresses || user.viewAddresses === "none") return;
+
+                if (user.viewPlacementListings === "request") {
+                    if (!user.visibleListings || user.visibleListings?.length === 0) return;
+                    constraints.push(where("listingId", 'in', user.visibleListings));
+                } else {
+                    // viewPlacementListings must be 'all'
+
+                    if (user.viewAddresses === "request") {
+                        if (!user.visibleAddresses || user.visibleAddresses?.length === 0) return;
+                        constraints.push(where("addressId", 'in', user.visibleAddresses));
+                    }
+                }
+            }
+            const applicationCount = await firebaseQuery.getCount("applications", constraints);
             if (applicationCount === 0) return;
 
             return {
@@ -578,47 +766,319 @@ const providerTasks:ProviderTaskObject = {
     },
     completeStudentDocs: {
         callback: async (user) => {
+            return;
             return {} as TaskQueryReturnObject;
         },
     },
     reviewOnboarding: {
         callback: async (user) => {
-            return {} as TaskQueryReturnObject;
+            const constraints = [where("providerId", "==", user.oId), where("onboarding.completed.accepted", "==", false), where("onboarding.completed.submitted", "==", true), where("endDate", ">=", dateToString(new Date()))]
+
+            if (user.userGroup !== "admin") {
+                
+                if (!user.viewPlacementListings || user.viewPlacementListings === "none") return;
+                if (!user.viewAddresses || user.viewAddresses === "none") return;
+
+                if (user.viewPlacementListings === "request") {
+                    if (!user.visibleListings || user.visibleListings?.length === 0) return;
+                    constraints.push(where("placementId", 'in', user.visibleListings));
+                } else {
+                    // viewPlacementListings must be 'all'
+
+                    if (user.viewAddresses === "request") {
+                        if (!user.visibleAddresses || user.visibleAddresses?.length === 0) return;
+                        constraints.push(where("addressId", 'in', user.visibleAddresses));
+                    }
+                }
+            }
+            const toReview = await firebaseQuery.getCount("placements", constraints);
+            
+            if (toReview === 0) return;
+            if (toReview === 1) {
+                const placement = Object.entries(await firebaseQuery.getDocsWhere("placements", constraints) || {})[0] as [string, StudentPlacementData];
+                const student = await firebaseQuery.getDocData(["users", placement[1].uid]) as UserData;
+                return {
+                    dismissible: false,
+                    severity: "primary",
+                    title: `${student.details.forename} ${student.details.surname} has completed their onboarding for their placement from ${convertDate(placement[1].startDate, "visual")} to ${convertDate(placement[1].endDate, "visual")}`,
+                    message: `Click to view the placement and review the onboarding.`,
+                    link: `/${user.product}/placements/${placement[0]}`,
+                    buttonTitle: "View",
+                } as TaskQueryReturnObject;
+        }
+
+            return {
+                dismissible: false,
+                severity: "primary",
+                title: `${toReview} student have completed their onboarding.`,
+                message: `Click to view your placements and approve completed onboarding`,
+                link: `/${user.product}/placementListings/placements`,
+                buttonTitle: "View placements",
+            } as TaskQueryReturnObject;
+        },
+    },
+    uploadOnboarding: {
+        callback: async (user) => {
+            
+            const constraints = [where("providerId", "==", user.oId), where("onboarding", "==", null), where("endDate", ">=", dateToString(new Date()))];
+
+
+            if (user.userGroup !== "admin") {
+                
+                if (!user.viewPlacementListings || user.viewPlacementListings === "none") return;
+                if (!user.viewAddresses || user.viewAddresses === "none") return;
+
+                if (user.viewPlacementListings === "request") {
+                    if (!user.visibleListings || user.visibleListings?.length === 0) return;
+                    constraints.push(where("placementId", 'in', user.visibleListings));
+                } else {
+                    // viewPlacementListings must be 'all'
+
+                    if (user.viewAddresses === "request") {
+                        if (!user.visibleAddresses || user.visibleAddresses?.length === 0) return;
+                        constraints.push(where("addressId", 'in', user.visibleAddresses));
+                    }
+                }
+            }
+
+            const withoutOnboarding = await firebaseQuery.getCount("placements", constraints);
+
+            if (withoutOnboarding === 0) return;
+            if (withoutOnboarding === 1) {
+                const placement = Object.entries(await firebaseQuery.getDocsWhere("placements", constraints) || {})[0] as [string, StudentPlacementData];
+                const student = await firebaseQuery.getDocData(["users", placement[1].uid]) as UserData;
+                return {
+                    dismissible: false,
+                    severity: "primary",
+                    title: `Send onboarding documents to ${student.details.forename} ${student.details.surname}'s placement from ${convertDate(placement[1].startDate, "visual")} to ${convertDate(placement[1].endDate, "visual")}`,
+                    message: `Click to view the placement and add or dismiss onboarding reminders.`,
+                    link: `/${user.product}/placements/${placement[0]}`,
+                    buttonTitle: "View",
+                } as TaskQueryReturnObject;
+        }
+
+            return {
+                dismissible: false,
+                severity: "primary",
+                title: `Set up onboarding for ${withoutOnboarding} placements to prepare yourself and your students.`,
+                message: `Click to view your placements and add or dismiss onboarding reminders.`,
+                link: `/${user.product}/placementListings/placements`,
+                buttonTitle: "View placements",
+            } as TaskQueryReturnObject;
         },
     },
     completeListing: {
         callback: async (user) => {
-            return {} as TaskQueryReturnObject;
+            const constraints = [where("providerId", "==", user.oId), where("status", "==", "draft")];
+
+
+            if (user.userGroup !== "admin") {
+                
+                if (!user.viewPlacementListings || user.viewPlacementListings === "none") return;
+                if (!user.viewAddresses || user.viewAddresses === "none") return;
+
+                if (user.viewPlacementListings === "request") {
+                    if (!user.visibleListings || user.visibleListings?.length === 0) return;
+                    constraints.push(where(documentId(), 'in', user.visibleListings));
+                } else {
+                    // viewPlacementListings must be 'all'
+
+                    if (user.viewAddresses === "request") {
+                        if (!user.visibleAddresses || user.visibleAddresses?.length === 0) return;
+                        constraints.push(where("addressId", 'in', user.visibleAddresses));
+                    }
+                }
+            }
+            const incompleteListings = await firebaseQuery.getCount("placementListings", constraints);
+            if (incompleteListings === 0) return;
+            if (incompleteListings === 1) {
+                const incompleteListing = Object.entries(await firebaseQuery.getDocsWhere("placementListings", constraints) || {})[0] as [string, PlacementListing];
+                const address = incompleteListing[1].addressId ? await firebaseQuery.getDocData(["addresses", incompleteListing[1].addressId]) as OrganisationAddress : undefined;
+                return {
+                    dismissible: false,
+                    severity: "info",
+                    title: `Your listing '${incompleteListing[1].title || "unnamed"}' at ${address ? `${address["address-line1"]}, ${address.postal_code.toUpperCase()}, ${capitaliseWords(camelCaseToNormal(address.country))}` : "unknown address"} requires more information before publishing.`,
+                    message: `Click to complete and publish the placement listing.`,
+                    link: `/${user.product}/addListing/${incompleteListing[0]}`,
+                    buttonTitle: "View listing",
+                } as TaskQueryReturnObject;
+        }
+
+            return {
+                dismissible: false,
+                severity: "info",
+                title: `You have ${incompleteListings} draft listings waiting to be published.`,
+                message: `Click to review and publish the placement listings.`,
+                link: `/${user.product}/placementListings/listings`,
+                buttonTitle: "View listings",
+            } as TaskQueryReturnObject;
         },
     },
     completeAddress: {
         callback: async (user) => {
-            return {} as TaskQueryReturnObject;
+            const constraints = [where("product", "==", "providers"), where("oId", "==", user.oId), where("stage", "!=", "complete")];
+
+
+            if (user.userGroup !== "admin") {
+                if (!user.viewAddresses || user.viewAddresses === "none") return;
+
+                if (user.viewAddresses === "request") {
+                    if (!user.visibleAddresses || user.visibleAddresses?.length === 0) return;
+                    constraints.push(where("addressId", 'in', user.visibleAddresses));
+                }
+            }
+            const incompleteAddresses = await firebaseQuery.getCount("addresses", constraints);
+            if (incompleteAddresses === 0) return;
+            if (incompleteAddresses === 1) {
+                const address = Object.entries(await firebaseQuery.getDocsWhere("addresses", constraints) || {})[0] as [string, OrganisationAddress];
+                return {
+                    dismissible: false,
+                    severity: "info",
+                    title: `Your address: ${address[1]["address-line1"]}, ${address[1].postal_code.toUpperCase()}, ${capitaliseWords(camelCaseToNormal(address[1].country))} is currently incomplete.`,
+                    message: `Click to complete the addresses.`,
+                    link: `/${user.product}/addAddress/${address[0]}`,
+                    buttonTitle: "View address",
+                } as TaskQueryReturnObject;
+        }
+
+            return {
+                dismissible: false,
+                severity: "info",
+                title: `You have ${incompleteAddresses} draft addresses waiting to be published.`,
+                message: `Click to review the addresses.`,
+                link: `/${user.product}/organisation/addresses`,
+                buttonTitle: "View addresses",
+            } as TaskQueryReturnObject;
         },
     },
     registrationRequests: {
         callback: async (user) => {
-            return {} as TaskQueryReturnObject;
+            if (!getAccess(user, "addStaff")) return;
+
+            const regRequests = await firebaseQuery.getCount("requests", [where("product", "==", user.product), where("oId", "==", user.oId)]);
+
+            if (regRequests === 0) return;
+            if (regRequests === 1) {
+                const request = Object.entries(await firebaseQuery.getDocsWhere("requests", [where("product", "==", user.product), where("oId", "==", user.oId)]) || {})[0] as [string, RegistrationRequest];
+                return {
+                    dismissible: false,
+                    severity: "primary",
+                    title: `${request[1].forename} ${request[1].surname} has requested to access your organisation.`,
+                    message: `Click to review these request.`,
+                    link: `/${user.product}/organisation/staff/requests`,
+                    buttonTitle: "View requests",
+                } as TaskQueryReturnObject;
+        }
+
+            return {
+                dismissible: false,
+                severity: "primary",
+                title: `${regRequests} people have requested to register with your organisation.`,
+                message: `Click to review these requests.`,
+                link: `/${user.product}/organisation/staff/requests`,
+                buttonTitle: "View requests",
+            } as TaskQueryReturnObject;
+        },
+    },
+    activateStaff: {
+        callback: async (user) => {
+            if (!getAccess(user, "addStaff")) return;
+
+            const inactiveAccounts = await firebaseQuery.getCount("users", [where("product", "==", user.product), where("oId", "==", user.oId), where("status", "==", "inactive")]);
+
+            if (inactiveAccounts === 0) return;
+            if (inactiveAccounts === 1) {
+                const account = Object.entries(await firebaseQuery.getDocsWhere("users", [where("product", "==", user.product), where("oId", "==", user.oId), where("status", "==", "inactive")]) || {})[0] as [string, UserData];
+                return {
+                    dismissible: false,
+                    severity: "info",
+                    title: `Activate ${account[1].details.forename} ${account[1].details.surname}'s staff account.`,
+                    message: "Activate this account to give the user access to Placementt.",
+                    link: `/${user.product}/organisation/staff/all`,
+                    buttonTitle: "View accounts",
+                } as TaskQueryReturnObject;
+        }
+
+            return {
+                dismissible: false,
+                severity: "info",
+                title: `${inactiveAccounts} staff have inactive active accounts.`,
+                message: "Activate these accounts to give the user access to Placementt.",
+                link: `/${user.product}/organisation/staff/all`,
+                buttonTitle: "View accounts",
+            } as TaskQueryReturnObject;
         },
     },
     placementStarting: {
         callback: async (user) => {
-            return {} as TaskQueryReturnObject;
+            const sevenDaysInFuture = new Date();
+            sevenDaysInFuture.setDate(sevenDaysInFuture.getDate() + 7)
+
+            const constraints = [where("providerId", "==", user.oId), where("startDate", "<=", convertDate(sevenDaysInFuture, "dbstring")), where("startDate", ">", dateToString(new Date()))];
+
+            if (user.userGroup !== "admin") {
+                
+                if (!user.viewPlacementListings || user.viewPlacementListings === "none") return;
+                if (!user.viewAddresses || user.viewAddresses === "none") return;
+
+                if (user.viewPlacementListings === "request") {
+                    if (!user.visibleListings || user.visibleListings?.length === 0) return;
+                    constraints.push(where(documentId(), 'in', user.visibleListings));
+                } else {
+                    // viewPlacementListings must be 'all'
+
+                    if (user.viewAddresses === "request") {
+                        if (!user.visibleAddresses || user.visibleAddresses?.length === 0) return;
+                        constraints.push(where("addressId", 'in', user.visibleAddresses));
+                    }
+                }
+            }
+            const placementsStartingSoon = await firebaseQuery.getCount("placements", constraints);
+            
+            if (placementsStartingSoon === 0) return;
+            if (placementsStartingSoon === 1) {
+                const placement = Object.entries(await firebaseQuery.getDocsWhere("placements", constraints) || {})[0] as [string, StudentPlacementData];
+                const student = placement[1].uid ? await firebaseQuery.getDocData(["users", placement[1].uid]) as UserData : {
+                    details: {
+                        forename: placement[1].studentForename,
+                        surname: placement[1].studentSurname,
+                    }
+                };
+                return {
+                    dismissible: false,
+                    severity: "success",
+                    title: `${student.details.forename} ${student.details.surname}'s placement from ${convertDate(placement[1].startDate, "visual")} to ${convertDate(placement[1].endDate, "visual")} is starting in less than a week.`,
+                    message: `Click to view the placement and acquaint yourself with the student.`,
+                    link: `/${user.product}/placements/${placement[0]}`,
+                    buttonTitle: "View",
+                } as TaskQueryReturnObject;
+        }
+
+            return {
+                dismissible: false,
+                severity: "success",
+                title: `${placementsStartingSoon} placements starting soon.`,
+                message: `Click to view scheduled placements.`,
+                link: `/${user.product}/placementListings/placements`,
+                buttonTitle: "View placements",
+            } as TaskQueryReturnObject;
         },
     },
     completeFeedback: {
         callback: async (user) => {
+            return;
             return {} as TaskQueryReturnObject;
         },
     },
     setUpFeedback: {
         callback: async (user) => {
+            return;
             return {} as TaskQueryReturnObject;
         },
     },
 }
 
-export const getTips = async (user: UserData, organisation: InstituteData|ProviderData):Promise<(TaskQueryReturnObject)[]> => {
+export const getTips = async (user: UserData, organisation: InstituteData|ProviderData, addresses?: {[key: string]: OrganisationAddress}):Promise<(TaskQueryReturnObject)[]> => {
     const tipsObject = {
         providers: providerTips,
         institutes: instituteTips,
@@ -627,9 +1087,14 @@ export const getTips = async (user: UserData, organisation: InstituteData|Provid
     const includedItems = Object.entries(tipsObject[user.product]).filter(([k]) => !user.dismissedTips?.includes(k));
 
     const processedTips = await includedItems.reduce(async (acc, [itemName, item]) => {
+        const callbackParams:[UserData, InstituteData|ProviderData] = [user, organisation];
+
+        if ((itemName === "addAddresses" || itemName === "addSchools") && addresses) {
+            callbackParams.push(addresses as any);
+        }
         const queryResult = await (item as {
             callback: (user: UserData, organisation?:InstituteData|ProviderData) => Promise<TaskQueryReturnObject|TaskQueryReturnObject[]>,
-        }).callback(user, organisation);
+        }).callback(...callbackParams);
         if (!queryResult) return await acc;
 
         const queryResultArray = Array.isArray(queryResult) ? queryResult : [queryResult];
@@ -697,7 +1162,7 @@ const getInstituteTasks = async (user: UserData, organisation: InstituteData|Pro
             fCohort = Object.entries(cohorts);
         }
         if (user.viewCohorts === "some") {
-            const cohorts = await user.visibleCohorts?.split(",").reduce(async (acc, cohortId) => {
+            const cohorts = await user.visibleCohorts?.reduce(async (acc, cohortId) => {
                 const cohort = await firebaseQuery.getDocData(["cohorts", cohortId]) as CohortData;
                 if (cohort.stage !== "created") {
                     return acc;