placementt-core 1.20.217 → 11.0.803

package/src/tasksAndTips.ts

@@ -1,1177 +1,1209 @@
-import {arrayUnion, documentId, orderBy, where} from "firebase/firestore";
-import FirebaseQuery from "./firebase/firebaseQuery";
-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"|"addAddresses"|"uploadStaff"|"assignStaffRoles"|"uploadPlacements"|"allowExternalPlacementUpload"|"uploadStaffGuidance"|"uploadStudentGuidance"
-type ProviderTipNames = string
-type StudentTipNames = string
-
-export type InstituteTaskNames = "missingParentEmail"|"invalidStaffEmails"|"invalidStudentEmails"|"invalidParentEmails"|"invalidProviderEmails"|"verifyInsurance"|"verifyRiskAssessment"|"verifyDbsCheck"|"inactiveStudents"|"uploadStudents"|"inactiveStaff"|"requiredStage"|"approveExternalPlacement"|"overdueStage"
-export type StudentTaskNames = "completeOnboarding"
-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
-
-export type TaskQueryReturnObject = {
-    itemName?: InstituteTaskNames|InstituteTipNames|StudentTipNames|ProviderTipNames,
-    title?: string,
-    message?: string,
-    link?: string,
-    buttonTitle?: string,
-    dismissible?: boolean,
-    severity?: "error"|"warning"|"success"|"primary"|"info"
-}|undefined;
-/*
-type TasksObject = {
-    [key in TaskNames]: {
-        callback: (user: UserData) => Promise<TaskQueryReturnObject>,
-    };
-};
-*/
-type InstituteTipsObject = {
-    [key in InstituteTipNames]: {
-        callback: (user: UserData, organisation?:InstituteData|ProviderData, additional?:{[key: string]: OrganisationAddress}) => Promise<TaskQueryReturnObject|TaskQueryReturnObject[]>,
-    };
-};
-type ProviderTipsObject = {
-    [key in ProviderTipNames]: {
-        callback: (user: UserData, organisation?:InstituteData|ProviderData) => Promise<TaskQueryReturnObject|TaskQueryReturnObject[]>,
-    };
-};
-type StudentTipsObject = {
-    [key in StudentTipNames]: {
-        callback: (user: UserData, organisation?:InstituteData|ProviderData) => Promise<TaskQueryReturnObject|TaskQueryReturnObject[]>,
-    };
-};
-
-export type InstituteTaskObject = {
-    [key in InstituteTaskNames]: {
-        callback: (user: UserData, organisation:InstituteData|ProviderData, cohort: CohortData|[string, CohortData][]) => Promise<TaskQueryReturnObject|TaskQueryReturnObject[]>,
-    };
-};
-
-export type StudentTaskObject = {
-    [key in StudentTaskNames]: {
-        callback: (user: UserData) => Promise<TaskQueryReturnObject|TaskQueryReturnObject[]>,
-    };
-};
-export type ProviderTaskObject = {
-    [key in ProviderTaskNames]: {
-        callback: (user: UserData) => Promise<TaskQueryReturnObject|TaskQueryReturnObject[]>,
-    };
-};
-const providerTips:ProviderTipsObject = {}
-const studentTips:StudentTipsObject = {}
-
-
-const instituteTips:InstituteTipsObject = {
-    addAddresses: {
-        callback: async (user, institute, addresses) => {
-            if (!getAccess(user, "addAddresses") || institute?.package === "institutes-one") return;
-            if (Object.keys(addresses as {[key: string]: OrganisationAddress}).length < 2) {
-                return {
-                    title: "Add your schools",
-                    message: "Add your school addresses. 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;
-            const cohorts = await firebaseQuery.getCount("cohorts", [where("product", "==", user.product), where("oId", "==", user.oId)])
-            if (cohorts === 0) {
-                return {
-                    title: "Create a cohort",
-                    message: "Create a cohort to manage your students, process their placements and track their progress",
-                    link: "/institutes/cohorts/new",
-                    buttonTitle: "Create cohort",
-                };
-            }
-            return;
-        },
-    },
-    uploadStaff: {
-        callback: async (user) => {
-            const returnObj: TaskQueryReturnObject = {
-                link: "",
-                dismissible: true,
-            };
-            if ((await firebaseQuery.getCount(["users"], [where("oId", "==", user.oId), where("userType", "==", "Staff")])) == 1) {
-                return {
-                    ...returnObj,
-                    title: "Upload staff",
-                    message: "Upload staff to help manage your students",
-                    link: "/institutes/cohorts/staff/all",
-                    buttonTitle: "Upload staff",
-                };
-            }
-            return;
-        },
-    },
-    assignStaffRoles: {
-        callback: async () => {
-            return undefined;
-        },
-    },
-    uploadPlacements: {
-        callback: async (user) => {
-            const returnObj: TaskQueryReturnObject = {
-                link: "",
-                dismissible: true,
-            };
-            if (await firebaseQuery.getCount(["placementListings"], where(`savedBy.${user.oId}.exists`, "==", true)) === 0) {
-                return {
-                    ...returnObj,
-                    title: "List placements",
-                    message: "You can list placements to students, to give them places to contact. Check out the 'Placements' tab to list opportunitites.",
-                    link: "/institutes/placements",
-                    buttonTitle: "Add placements",
-                };
-            }
-            return;
-        },
-    },
-    allowExternalPlacementUpload: {
-        callback: async (user, organisation) => {
-            if (user.product !== "institutes") return;
-            if ((organisation as InstituteData).externalProviderUploads) return;
-
-            return {
-                dismissible: true,
-                title: "Allow external uploads",
-                message: "Get a link to share with businesses, allowing them to list their own opportunities to your students.",
-                link: "/institutes/placements",
-                buttonTitle: "View placements",
-            };
-        },
-    },
-    uploadStaffGuidance: {
-        callback: async (user, organisation) => {
-            if (user.product !== "institutes") return;
-            const returnObj: TaskQueryReturnObject = {
-                link: "",
-                dismissible: true,
-            };
-            const guidanceTips:TaskQueryReturnObject[] = [];
-            if (!Object.keys((organisation as InstituteData).staffGuidance || {}).length) {
-                guidanceTips.push({
-                    ...returnObj,
-                    title: "Upload staff guidance",
-                    message: "Upload guidance documents to support your staff in coordinating work experience.",
-                    buttonTitle: "Staff guidance",
-                    link: `/${user.product}/setup/guidance`,
-                });
-            }
-            return guidanceTips;
-        },
-    },
-    uploadStudentGuidance: {
-        callback: async (user, organisation) => {
-            if (user.product !== "institutes") return;
-            const returnObj: TaskQueryReturnObject = {
-                link: "",
-                dismissible: true,
-            };
-            const guidanceTips:TaskQueryReturnObject[] = [];
-            if (!Object.keys((organisation as InstituteData).studentsGuidance || {}).length) {
-                guidanceTips.push({
-                    ...returnObj,
-                    title: "Upload student guidance",
-                    message: "Upload guidance documents to support your staff in preparing for their placements.",
-                    buttonTitle: "Student guidance",
-                    link: `/${user.product}/setup/guidance`,
-                });
-            }
-            return guidanceTips;
-        },
-    },
-};
-//  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);
-        },
-    },
-    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") || 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)]));
-                if (placementCount > 0) {
-                    return {
-                        dismissible: false,
-                        severity: "primary",
-                        title: `${placementCount} placements require your attention.`,
-                        message: `Your cohort '${cohorts.name}' has placements for your to review. Click to view these placements.`,
-                        link: `/institutes/cohorts/${cohorts.id}/placements?id=upcoming&reqUserType=${user.userType}`,
-                    };
-                }
-                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("reqUserType", "==", user.userType)]));
-                if (placementCount > 0) {
-                    return {
-                        dismissible: false,
-                        severity: "primary",
-                        title: `${placementCount} placements in '${cohort.name}' require your attention.`,
-                        message: `Your cohort '${cohort.name}' has placements for your to review. Click to view these placements.`,
-                        link: `/institutes/cohorts/${id}/placements?id=upcoming&reqUserType=${user.userType}`,
-                        buttonTitle: "Review placements",
-                    } as TaskQueryReturnObject;
-                }
-                return;
-            }));
-            return items.filter((v) => v);
-        },
-    },
-    verifyInsurance: {
-        callback: async (user, _, cohorts) => {
-            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")]));
-                if (placementCount > 0) {
-                    return {
-                        dismissible: false,
-                        severity: "primary",
-                        title: `${placementCount} placements have insurance that require review.`,
-                        message: `Your cohort '${cohorts.name}' has employer's liability insurance documents that require review`,
-                        link: `/institutes/cohorts/${cohorts.id}/placements?id=upcoming&insurance=awaitingReview`,
-                    };
-                }
-                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("insurance", "==", "awaitingReview")]));
-                if (placementCount > 0) {
-                    return {
-                        dismissible: false,
-                        severity: "primary",
-                        title: `${placementCount} placements in '${cohort.name}' have insurance that require review.`,
-                        message: `Your cohort '${cohort.name}' has employer's liability insurance documents that require review`,
-                        link: `/institutes/cohorts/${cohort.id}/placements?id=upcoming&insurance=awaitingReview`,
-                        buttonTitle: "Review placements",
-                    } as TaskQueryReturnObject;
-                }
-                return;
-            }));
-            return items.filter((v) => v);
-        },
-    },
-    verifyDbsCheck: {
-        callback: async (user, _, cohorts) => {
-            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")]));
-                if (placementCount > 0) {
-                    return {
-                        dismissible: false,
-                        severity: "primary",
-                        title: `${placementCount} placements have DBS checks that require review.`,
-                        message: `Your cohort '${cohorts.name}' has DBS checks that require review`,
-                        link: `/institutes/cohorts/${cohorts.id}/placements?id=upcoming&dbsCheck=awaitingReview`,
-                    };
-                }
-                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("dbsCheck", "==", "awaitingReview")]));
-                if (placementCount > 0) {
-                    return {
-                        dismissible: false,
-                        severity: "primary",
-                        title: `${placementCount} placements in '${cohort.name}' have DBS checks that require review.`,
-                        message: `Your cohort '${cohort.name}' has DBS checks that require review`,
-                        link: `/institutes/cohorts/${cohort.id}/placements?id=upcoming&dbsCheck=awaitingReview`,
-                        buttonTitle: "Review placements",
-                    } as TaskQueryReturnObject;
-                }
-                return;
-            }));
-            return items.filter((v) => v);
-        },
-    },
-    verifyRiskAssessment: {
-        callback: async (user, _, cohorts) => {
-            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")]));
-                if (placementCount > 0) {
-                    return {
-                        dismissible: false,
-                        severity: "primary",
-                        title: `${placementCount} placements have risk assessments that require review.`,
-                        message: `Your cohort '${cohorts.name}' has risk assessents that require review`,
-                        link: `/institutes/cohorts/${cohorts.id}/placements?id=upcoming&riskAssessment=awaitingReview`,
-                    };
-                }
-                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("riskAssessment", "==", "awaitingReview")]));
-                if (placementCount > 0) {
-                    return {
-                        dismissible: false,
-                        severity: "primary",
-                        title: `${placementCount} placements in '${cohort.name}' have risk assessments that require review.`,
-                        message: `Your cohort '${cohort.name}' has risk assessments that require review`,
-                        link: `/institutes/cohorts/${cohort.id}/placements?id=upcoming&riskAssessment=awaitingReview`,
-                        buttonTitle: "Review placements",
-                    } as TaskQueryReturnObject;
-                }
-                return;
-            }));
-            return items.filter((v) => v);
-        },
-    },
-    missingParentEmail: {
-        callback: async (user, _, cohorts) => {
-            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;
-                const constraints = [where("oId", "==", user.oId), where("cohort", "==", cohorts.id), where("details.parentEmail", "==", "null")];
-
-                if (user.groupData?.viewStudents === "filter") {
-                    constraints.push(where(`details.${user.groupData?.filterUsersBy || ""}`, "==", user.groupData?.filterUsersValue || ""));
-                }
-                const studentCount = (await firebaseQuery.getCount(["users"], constraints));
-                if (studentCount > 0) {
-                    return {
-                        dismissible: false,
-                        severity: "info",
-                        title: `${studentCount} students do not have a parent email.`,
-                        message: `Your cohort '${cohorts.name}' has students without a parent email. To allow proper processing of their placements, add these emails.`,
-                        link: `/institutes/cohorts/${cohorts.id}/students?parentEmail=false`,
-                    };
-                }
-                return;
-            }
-            const items = await Promise.all(cohorts.map(async ([id, cohort]) => {
-                const requiresParents = Boolean(cohort.workflow.find((node) => node.userType === "Parent"))
-                if (!requiresParents) return;
-                const constraints = [where("oId", "==", user.oId), where("cohort", "==", id), where("details.parentEmail", "==", "null")];
-
-                if (user.groupData?.viewStudents === "filter") {
-                    constraints.push(where(`details.${user.groupData?.filterUsersBy || ""}`, "==", user.groupData?.filterUsersValue || ""));
-                }
-                const studentCount = (await firebaseQuery.getCount(["users"], constraints));
-                if (studentCount > 0) {
-                    return {
-                        dismissible: false,
-                        severity: "info",
-                        title: `${studentCount} students in '${cohort.name}' do not have a parent email.`,
-                        message: `Your cohort '${cohort.name}' has students without a parent email. To allow proper processing of their placements, add these emails.`,
-                        link: `/institutes/cohorts/${cohort.id}/students?parentEmail=false`,
-                        buttonTitle: "View students",
-                    } as TaskQueryReturnObject;
-                }
-                return;
-            }));
-            return items.filter((v) => v);
-        },
-    },
-    inactiveStudents: {
-        callback: async (user, _, cohorts) => {
-            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")];
-
-                if (user.groupData?.viewStudents === "filter") {
-                    constraints.push(where(`details.${user.groupData?.filterUsersBy || ""}`, "==", user.groupData?.filterUsersValue || ""));
-                }
-                const studentCount = (await firebaseQuery.getCount(["users"], constraints));
-                if (studentCount > 0) {
-                    return {
-                        dismissible: false,
-                        severity: "info",
-                        title: `${studentCount} students in are inactive.`,
-                        message: `Your cohort '${cohorts.name}' has inactive students. Activate them to enable them to use the platform.`,
-                        link: `/institutes/cohorts/${cohorts.id}/students?status=inactive`,
-                    };
-                }
-                return;
-            }
-
-            const items = await Promise.all(cohorts.map(async ([id, cohort]) => {
-                const constraints = [where("oId", "==", user.oId), where("cohort", "==", id), where("status", "==", "inactive")];
-
-                if (user.groupData?.viewStudents === "filter") {
-                    constraints.push(where(`details.${user.groupData?.filterUsersBy || ""}`, "==", user.groupData?.filterUsersValue || ""));
-                }
-                const studentCount = (await firebaseQuery.getCount(["users"], constraints));
-                if (studentCount > 0) {
-                    return {
-                        dismissible: false,
-                        severity: "info",
-                        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 students",
-                    } as TaskQueryReturnObject;
-                }
-                return;
-            }));
-            return items.filter((v) => v);
-        },
-    },
-    uploadStudents: {
-        callback: async (user, _, cohorts) => {
-            if (!Array.isArray(cohorts)) return;
-            if (!getAccess(user, "addStudents") || user.viewStudents === "none") return;
-            if (user.product !== "institutes") return;
-            const returnObj: TaskQueryReturnObject = {
-                link: "",
-                dismissible: true,
-                severity: "warning",
-            };
-            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)]));
-                if (studentCount === 0) {
-                    return {
-                        ...returnObj,
-                        title: "Upload students",
-                        message: `Your cohort '${cohort.name}' has no students. Add them in the cohort 'Students' tab`,
-                        link: `/institutes/cohorts/${id}/students`,
-                        buttonTitle: "Upload students",
-                    };
-                }
-                return;
-            }));
-            return items.filter((v) => v);
-        },
-    },
-    inactiveStaff: {
-        callback: async (user, _, cohorts) => {
-            if (!getAccess(user, "addStaff")) return;
-
-            if (!Array.isArray(cohorts) || user.product === "students") return;
-            const returnObj: TaskQueryReturnObject = {
-                link: `/${user.product}/cohorts/staff/all?status=inactive`,
-                dismissible: false,
-                severity: "info",
-            };
-            const inactiveStaff = await firebaseQuery.getCount(["users"], [where("oId", "==", user.oId), where("userType", "==", "Staff"), where("status", "==", "inactive")]);
-            if (inactiveStaff > 0) {
-                return {
-                    ...returnObj,
-                    title: "Inactive staff",
-                    message: `You have ${inactiveStaff} inactive staff members. You can activate them in the 'Staff' cohorts tab.`,
-                };
-            }
-            return;
-        },
-    },
-    overdueStage: {
-        callback: async (user, _, cohort) => {
-            console.log(user, cohort);
-            return undefined;
-        },
-    },
-    approveExternalPlacement: {
-        callback: async (user, _, cohort) => {
-            if (!getAccess(user, "verifyListings")) return;
-            if (!Array.isArray(cohort)) return;
-            const externalCount = await firebaseQuery.getCount(["placementListings"],
-                [where(`savedBy.${user.oId}.exists`, "==", true), where(`savedBy.${user.oId}.status`, "==", "uploaded"), where("mapConsent", "==", "institute")]);
-            console.log("EXT", externalCount);
-            if (externalCount > 0) {
-                return {
-                    dismissible: false,
-                    severity: "warning",
-                    title: `${externalCount} external placements require approval`,
-                    message: "Review and approve these placements to add them to your institute placement map",
-                    link: "/institutes/placements",
-                    buttonTitle: "View placements",
-                };
-            }
-            return;
-        },
-    },
-};
-
-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};
-            if (Object.keys(placementsWithoutOnboarding).length === 0) return;
-            const items = Object.entries(placementsWithoutOnboarding).map(([k, placement]) => ({
-                dismissible: false,
-                severity: "primary",
-                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))
-            return items;
-        },
-    }
-}
-
-const providerTasks:ProviderTaskObject = {
-    requestedVisibleAddresses: {
-        callback: async (user) => {
-            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("product", "==", "providers"), where("oId", "==", user.oId), orderBy("requestedVisibleAddresses")]) || {})[0] as [string, UserData];
-                return {
-                    dismissible: false,
-                    severity: "primary",
-                    title: `${userRequestingAccess[1].details.forename} ${userRequestingAccess[1].details.surname} has requested access to view addresses.`,
-                    message: `Click to review the addresses and grant access to the user.`,
-                    link: `/${user.product}/users/${userRequestingAccess[0]}`,
-                    buttonTitle: "View request",
-                } as TaskQueryReturnObject;
-        }
-
-            return {
-                dismissible: false,
-                severity: "warning",
-                title: `Multiple users have requested access to view addresses.`,
-                message: `Click to review the addresses and grant access to the user.`,
-                link: `/${user.product}/organisation/staff/all`,
-                buttonTitle: "View request",
-            } as TaskQueryReturnObject;
-        },
-    },
-    requestedVisiblePlacementListings: {
-        callback: async (user) => {
-            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];
-                return {
-                    dismissible: false,
-                    severity: "primary",
-                    title: `${userRequestingAccess[1].details.forename} ${userRequestingAccess[1].details.surname} has requested access to view placement listings.`,
-                    message: `Click to review the placement listings and grant access to the user.`,
-                    link: `/${user.product}/users/${userRequestingAccess[0]}`,
-                    buttonTitle: "View request",
-                } as TaskQueryReturnObject;
-        }
-
-            return {
-                dismissible: false,
-                severity: "warning",
-                title: `Multiple users have requested access to view placement listings.`,
-                message: `Click to review the placement listings and grant access to the user.`,
-                link: `/${user.product}/organisation/staff/all`,
-                buttonTitle: "View request",
-            } as TaskQueryReturnObject;
-        },
-    },
-    applicationRequireReview: {
-        callback: async (user) => {
-            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 {
-                dismissible: false,
-                severity: "primary",
-                title: `${applicationCount} applications require your review.`,
-                message: `Click to view ${applicationCount} that require your attention.`,
-                link: `/${user.product}/placementListings/applicants`,
-                buttonTitle: "View applications",
-            } as TaskQueryReturnObject;
-        },
-    },
-    completeStudentDocs: {
-        callback: async (user) => {
-            return;
-            return {} as TaskQueryReturnObject;
-        },
-    },
-    reviewOnboarding: {
-        callback: async (user) => {
-            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) => {
-            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) => {
-            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) => {
-            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) => {
-            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, addresses?: {[key: string]: OrganisationAddress}):Promise<(TaskQueryReturnObject)[]> => {
-    const tipsObject = {
-        providers: providerTips,
-        institutes: instituteTips,
-        studentTips: studentTips,
-    }
-    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" && addresses) {
-            callbackParams.push(addresses as any);
-        }
-        const queryResult = await (item as {
-            callback: (user: UserData, organisation?:InstituteData|ProviderData) => Promise<TaskQueryReturnObject|TaskQueryReturnObject[]>,
-        }).callback(...callbackParams);
-        if (!queryResult) return await acc;
-
-        const queryResultArray = Array.isArray(queryResult) ? queryResult : [queryResult];
-        const results = queryResultArray.map((r) => ({itemName: itemName as InstituteTipNames|ProviderTipNames|StudentTipNames|InstituteTaskNames|ProviderTaskNames|StudentTaskNames, ...r}));
-
-        (await acc).push(...results);
-        return await acc;
-    }, Promise.resolve<TaskQueryReturnObject[]>([]));
-    return processedTips;
-}
-
-export const getTasks = async (user: UserData, organisation?: InstituteData|ProviderData, cohort?: CohortData):Promise<(TaskQueryReturnObject)[]> => {
-    // Cohort is either a specific one or all.
-
-    if (user.product === "institutes" && user.userType === "Staff" && organisation) {
-        return await getInstituteTasks(user, organisation, cohort);
-    }
-    if (user.product === "students" || user.userType === "Students") {
-        return await getStudentTasks(user, organisation, cohort);
-    }
-    if (user.product === "providers" && organisation) {
-        return await getProviderTasks(user, organisation);
-    }
-
-    return [];
-};
-
-const getStudentTasks = async (user: UserData, organisation?: InstituteData|ProviderData, cohort?: CohortData):Promise<(TaskQueryReturnObject)[]> => {
-    const processedTasks = await Object.entries(studentTasks).reduce(async (acc, [itemName, item]) => {
-
-        const queryResult = await item.callback(user);
-        if (!queryResult) return await acc;
-
-        const queryResultArray = Array.isArray(queryResult) ? queryResult : [queryResult];
-        const results = queryResultArray.map((r) => ({itemName: itemName as StudentTaskNames, ...r}));
-
-        (await acc).push(...results);
-        return await acc;
-    }, Promise.resolve<TaskQueryReturnObject[]>([]));
-    return processedTasks;
-};
-
-const getProviderTasks = async (user: UserData, organisation: InstituteData|ProviderData, cohort?: CohortData):Promise<(TaskQueryReturnObject)[]> => {
-    const processedTasks = await Object.entries(providerTasks).reduce(async (acc, [itemName, item]) => {
-
-        const queryResult = await item.callback(user);
-        if (!queryResult) return await acc;
-
-        const queryResultArray = Array.isArray(queryResult) ? queryResult : [queryResult];
-        const results = queryResultArray.map((r) => ({itemName: itemName as ProviderTaskNames, ...r}));
-
-        (await acc).push(...results);
-        return await acc;
-    }, Promise.resolve<TaskQueryReturnObject[]>([]));
-    return processedTasks;};
-
-const getInstituteTasks = async (user: UserData, organisation: InstituteData|ProviderData, cohort?: CohortData):Promise<(TaskQueryReturnObject)[]> => {
-    let fCohort:CohortData|[string, CohortData][]|undefined = cohort;
-
-    if (!fCohort) {
-        // get all associated cohorts.
-        if (user.viewCohorts === "none") return([]);
-        if (user.userGroup === "admin" || user.viewCohorts === "all") {
-            const cohorts = await firebaseQuery.getDocsWhere("cohorts", [where("product", "==", user.product), where("oId", "==", user.oId), where("stage", "==", "created")]) as {[key:string]: CohortData};
-            fCohort = Object.entries(cohorts);
-        }
-        if (user.viewCohorts === "some") {
-            const cohorts = await user.visibleCohorts?.reduce(async (acc, cohortId) => {
-                const cohort = await firebaseQuery.getDocData(["cohorts", cohortId]) as CohortData;
-                if (cohort.stage !== "created") {
-                    return acc;
-                }
-                acc[cohortId] = cohort;
-                return acc;
-            }, Promise.resolve<[string, CohortData][]>([]));
-            fCohort = cohorts;
-        }
-    }
-    
-    const processedTasks = await Object.entries(instituteTasks).reduce(async (acc, [itemName, item]) => {
-        if (!fCohort) {
-            console.log("No cohorts to retrieve tasks for");
-            return([]);
-        }
-        const queryResult = await item.callback(user, organisation, fCohort);
-        if (!queryResult) return await acc;
-
-        const queryResultArray = Array.isArray(queryResult) ? queryResult : [queryResult];
-        const results = queryResultArray.map((r) => ({itemName: itemName as InstituteTaskNames, ...r}));
-
-        (await acc).push(...results);
-        return await acc;
-    }, Promise.resolve<TaskQueryReturnObject[]>([]));
-    return processedTasks;
-}
-
-/*
-export const getTasks = async (user: UserData):Promise<{[key:string]: TaskQueryReturnObject}> => {
-    return Object.fromEntries((await Promise.all(Object.entries(tasks).filter(([k]) => !user.dismissedTasks?.includes(k)).map(async ([taskName, task]) => {
-        const queryResult = await task.callback(user);
-        return [taskName, queryResult ? {...queryResult, ...task} : undefined];
-    }))).filter(([, v]) => v));
-};
-
-export const dismissTask = (user: UserData, taskName:TaskNames) => {
-    firebaseQuery.update(["users", user.id], {dismissedTasks: arrayUnion(taskName)});
-};
-*/
-export const dismissTip = async (user: UserData, itemName:InstituteTaskNames | ProviderTaskNames | StudentTaskNames | InstituteTipNames | ProviderTipNames | StudentTipNames | undefined) => {
-    if (!itemName) return;
-    return await firebaseQuery.update(["users", user.id], {dismissedTips: arrayUnion(itemName)});
-};
+import {arrayUnion, documentId, orderBy, where} from "firebase/firestore";
+import FirebaseQuery from "./firebase/firebaseQuery";
+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"|"addSchools"|"uploadStaff"|"assignStaffRoles"|"uploadPlacements"|"allowExternalPlacementUpload"|"uploadStaffGuidance"|"uploadStudentGuidance"
+type ProviderTipNames = string
+type StudentTipNames = string
+
+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"|"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
+
+export type TaskQueryReturnObject = {
+    itemName?: InstituteTaskNames|InstituteTipNames|StudentTipNames|ProviderTipNames,
+    title?: string,
+    message?: string,
+    link?: string,
+    buttonTitle?: string,
+    dismissible?: boolean,
+    severity?: "error"|"warning"|"success"|"primary"|"info"
+}|undefined;
+/*
+type TasksObject = {
+    [key in TaskNames]: {
+        callback: (user: UserData) => Promise<TaskQueryReturnObject>,
+    };
+};
+*/
+type InstituteTipsObject = {
+    [key in InstituteTipNames]: {
+        callback: (user: UserData, organisation?:InstituteData|ProviderData, additional?:{[key: string]: OrganisationAddress}) => Promise<TaskQueryReturnObject|TaskQueryReturnObject[]>,
+    };
+};
+type ProviderTipsObject = {
+    [key in ProviderTipNames]: {
+        callback: (user: UserData, organisation?:InstituteData|ProviderData) => Promise<TaskQueryReturnObject|TaskQueryReturnObject[]>,
+    };
+};
+type StudentTipsObject = {
+    [key in StudentTipNames]: {
+        callback: (user: UserData, organisation?:InstituteData|ProviderData) => Promise<TaskQueryReturnObject|TaskQueryReturnObject[]>,
+    };
+};
+
+export type InstituteTaskObject = {
+    [key in InstituteTaskNames]: {
+        callback: (user: UserData, organisation:InstituteData|ProviderData, cohort: CohortData|[string, CohortData][]) => Promise<TaskQueryReturnObject|TaskQueryReturnObject[]>,
+    };
+};
+
+export type StudentTaskObject = {
+    [key in StudentTaskNames]: {
+        callback: (user: UserData) => Promise<TaskQueryReturnObject|TaskQueryReturnObject[]>,
+    };
+};
+export type ProviderTaskObject = {
+    [key in ProviderTaskNames]: {
+        callback: (user: UserData) => Promise<TaskQueryReturnObject|TaskQueryReturnObject[]>,
+    };
+};
+const providerTips:ProviderTipsObject = {}
+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;
+            const cohorts = await firebaseQuery.getCount("cohorts", [where("product", "==", user.product), where("oId", "==", user.oId)])
+            if (cohorts === 0) {
+                return {
+                    title: "Create a cohort",
+                    message: "Create a cohort to manage your students, process their placements and track their progress",
+                    link: "/institutes/cohorts/new",
+                    buttonTitle: "Create cohort",
+                };
+            }
+            return;
+        },
+    },
+    uploadStaff: {
+        callback: async (user) => {
+            const returnObj: TaskQueryReturnObject = {
+                link: "",
+                dismissible: true,
+            };
+            if ((await firebaseQuery.getCount(["users"], [where("oId", "==", user.oId), where("userType", "==", "Staff")])) == 1) {
+                return {
+                    ...returnObj,
+                    title: "Upload staff",
+                    message: "Upload staff to help manage your students",
+                    link: "/institutes/cohorts/staff/all",
+                    buttonTitle: "Upload staff",
+                };
+            }
+            return;
+        },
+    },
+    assignStaffRoles: {
+        callback: async () => {
+            return undefined;
+        },
+    },
+    uploadPlacements: {
+        callback: async (user) => {
+            const returnObj: TaskQueryReturnObject = {
+                link: "",
+                dismissible: true,
+            };
+            if (await firebaseQuery.getCount(["placementListings"], where(`savedBy.${user.oId}.exists`, "==", true)) === 0) {
+                return {
+                    ...returnObj,
+                    title: "List placements",
+                    message: "You can list placements to students, to give them places to contact. Check out the 'Placements' tab to list opportunitites.",
+                    link: "/institutes/placements",
+                    buttonTitle: "Add placements",
+                };
+            }
+            return;
+        },
+    },
+    allowExternalPlacementUpload: {
+        callback: async (user, organisation) => {
+            if (user.product !== "institutes") return;
+            if ((organisation as InstituteData).externalProviderUploads) return;
+
+            return {
+                dismissible: true,
+                title: "Allow external uploads",
+                message: "Get a link to share with businesses, allowing them to list their own opportunities to your students.",
+                link: "/institutes/placements",
+                buttonTitle: "View placements",
+            };
+        },
+    },
+    uploadStaffGuidance: {
+        callback: async (user, organisation) => {
+            if (user.product !== "institutes") return;
+            const returnObj: TaskQueryReturnObject = {
+                link: "",
+                dismissible: true,
+            };
+            const guidanceTips:TaskQueryReturnObject[] = [];
+            if (!Object.keys((organisation as InstituteData).staffGuidance || {}).length) {
+                guidanceTips.push({
+                    ...returnObj,
+                    title: "Upload staff guidance",
+                    message: "Upload guidance documents to support your staff in coordinating work experience.",
+                    buttonTitle: "Staff guidance",
+                    link: `/${user.product}/setup/guidance`,
+                });
+            }
+            return guidanceTips;
+        },
+    },
+    uploadStudentGuidance: {
+        callback: async (user, organisation) => {
+            if (user.product !== "institutes") return;
+            const returnObj: TaskQueryReturnObject = {
+                link: "",
+                dismissible: true,
+            };
+            const guidanceTips:TaskQueryReturnObject[] = [];
+            if (!Object.keys((organisation as InstituteData).studentsGuidance || {}).length) {
+                guidanceTips.push({
+                    ...returnObj,
+                    title: "Upload student guidance",
+                    message: "Upload guidance documents to support your staff in preparing for their placements.",
+                    buttonTitle: "Student guidance",
+                    link: `/${user.product}/setup/guidance`,
+                });
+            }
+            return guidanceTips;
+        },
+    },
+};
+//  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") || 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)]));
+                if (placementCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "primary",
+                        title: `${placementCount} placements require your attention.`,
+                        message: `Your cohort '${cohorts.name}' has placements for your to review. Click to view these placements.`,
+                        link: `/institutes/cohorts/${cohorts.id}/placements?id=upcoming&reqUserType=${user.userType}`,
+                    };
+                }
+                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("reqUserType", "==", user.userType)]));
+                if (placementCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "primary",
+                        title: `${placementCount} placements in '${cohort.name}' require your attention.`,
+                        message: `Your cohort '${cohort.name}' has placements for your to review. Click to view these placements.`,
+                        link: `/institutes/cohorts/${id}/placements?id=upcoming&reqUserType=${user.userType}`,
+                        buttonTitle: "Review placements",
+                    } as TaskQueryReturnObject;
+                }
+                return;
+            }));
+            return items.filter((v) => v);
+        },
+    },
+    verifyInsurance: {
+        callback: async (user, _, cohorts) => {
+            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")]));
+                if (placementCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "primary",
+                        title: `${placementCount} placements have insurance that require review.`,
+                        message: `Your cohort '${cohorts.name}' has employer's liability insurance documents that require review`,
+                        link: `/institutes/cohorts/${cohorts.id}/placements?id=upcoming&insurance=awaitingReview`,
+                    };
+                }
+                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("insurance", "==", "awaitingReview")]));
+                if (placementCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "primary",
+                        title: `${placementCount} placements in '${cohort.name}' have insurance that require review.`,
+                        message: `Your cohort '${cohort.name}' has employer's liability insurance documents that require review`,
+                        link: `/institutes/cohorts/${cohort.id}/placements?id=upcoming&insurance=awaitingReview`,
+                        buttonTitle: "Review placements",
+                    } as TaskQueryReturnObject;
+                }
+                return;
+            }));
+            return items.filter((v) => v);
+        },
+    },
+    verifyDbsCheck: {
+        callback: async (user, _, cohorts) => {
+            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")]));
+                if (placementCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "primary",
+                        title: `${placementCount} placements have DBS checks that require review.`,
+                        message: `Your cohort '${cohorts.name}' has DBS checks that require review`,
+                        link: `/institutes/cohorts/${cohorts.id}/placements?id=upcoming&dbsCheck=awaitingReview`,
+                    };
+                }
+                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("dbsCheck", "==", "awaitingReview")]));
+                if (placementCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "primary",
+                        title: `${placementCount} placements in '${cohort.name}' have DBS checks that require review.`,
+                        message: `Your cohort '${cohort.name}' has DBS checks that require review`,
+                        link: `/institutes/cohorts/${cohort.id}/placements?id=upcoming&dbsCheck=awaitingReview`,
+                        buttonTitle: "Review placements",
+                    } as TaskQueryReturnObject;
+                }
+                return;
+            }));
+            return items.filter((v) => v);
+        },
+    },
+    verifyRiskAssessment: {
+        callback: async (user, _, cohorts) => {
+            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")]));
+                if (placementCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "primary",
+                        title: `${placementCount} placements have risk assessments that require review.`,
+                        message: `Your cohort '${cohorts.name}' has risk assessents that require review`,
+                        link: `/institutes/cohorts/${cohorts.id}/placements?id=upcoming&riskAssessment=awaitingReview`,
+                    };
+                }
+                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("riskAssessment", "==", "awaitingReview")]));
+                if (placementCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "primary",
+                        title: `${placementCount} placements in '${cohort.name}' have risk assessments that require review.`,
+                        message: `Your cohort '${cohort.name}' has risk assessments that require review`,
+                        link: `/institutes/cohorts/${cohort.id}/placements?id=upcoming&riskAssessment=awaitingReview`,
+                        buttonTitle: "Review placements",
+                    } as TaskQueryReturnObject;
+                }
+                return;
+            }));
+            return items.filter((v) => v);
+        },
+    },
+    missingParentEmail: {
+        callback: async (user, _, cohorts) => {
+            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;
+                const constraints = [where("oId", "==", user.oId), where("cohort", "==", cohorts.id), where("details.parentEmail", "==", "null")];
+
+                if (user.groupData?.viewStudents === "filter") {
+                    constraints.push(where(`details.${user.groupData?.filterUsersBy || ""}`, "==", user.groupData?.filterUsersValue || ""));
+                }
+                const studentCount = (await firebaseQuery.getCount(["users"], constraints));
+                if (studentCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "info",
+                        title: `${studentCount} students do not have a parent email.`,
+                        message: `Your cohort '${cohorts.name}' has students without a parent email. To allow proper processing of their placements, add these emails.`,
+                        link: `/institutes/cohorts/${cohorts.id}/students?parentEmail=false`,
+                    };
+                }
+                return;
+            }
+            const items = await Promise.all(cohorts.map(async ([id, cohort]) => {
+                const requiresParents = Boolean(cohort.workflow.find((node) => node.userType === "Parent"))
+                if (!requiresParents) return;
+                const constraints = [where("oId", "==", user.oId), where("cohort", "==", id), where("details.parentEmail", "==", "null")];
+
+                if (user.groupData?.viewStudents === "filter") {
+                    constraints.push(where(`details.${user.groupData?.filterUsersBy || ""}`, "==", user.groupData?.filterUsersValue || ""));
+                }
+                const studentCount = (await firebaseQuery.getCount(["users"], constraints));
+                if (studentCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "info",
+                        title: `${studentCount} students in '${cohort.name}' do not have a parent email.`,
+                        message: `Your cohort '${cohort.name}' has students without a parent email. To allow proper processing of their placements, add these emails.`,
+                        link: `/institutes/cohorts/${cohort.id}/students?parentEmail=false`,
+                        buttonTitle: "View students",
+                    } as TaskQueryReturnObject;
+                }
+                return;
+            }));
+            return items.filter((v) => v);
+        },
+    },
+    inactiveStudents: {
+        callback: async (user, _, cohorts) => {
+            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")];
+
+                if (user.groupData?.viewStudents === "filter") {
+                    constraints.push(where(`details.${user.groupData?.filterUsersBy || ""}`, "==", user.groupData?.filterUsersValue || ""));
+                }
+                const studentCount = (await firebaseQuery.getCount(["users"], constraints));
+                if (studentCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "info",
+                        title: `${studentCount} students in are inactive.`,
+                        message: `Your cohort '${cohorts.name}' has inactive students. Activate them to enable them to use the platform.`,
+                        link: `/institutes/cohorts/${cohorts.id}/students?status=inactive`,
+                    };
+                }
+                return;
+            }
+
+            const items = await Promise.all(cohorts.map(async ([id, cohort]) => {
+                const constraints = [where("oId", "==", user.oId), where("cohort", "==", id), where("status", "==", "inactive")];
+
+                if (user.groupData?.viewStudents === "filter") {
+                    constraints.push(where(`details.${user.groupData?.filterUsersBy || ""}`, "==", user.groupData?.filterUsersValue || ""));
+                }
+                const studentCount = (await firebaseQuery.getCount(["users"], constraints));
+                if (studentCount > 0) {
+                    return {
+                        dismissible: false,
+                        severity: "info",
+                        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 students",
+                    } as TaskQueryReturnObject;
+                }
+                return;
+            }));
+            return items.filter((v) => v);
+        },
+    },
+    uploadStudents: {
+        callback: async (user, _, cohorts) => {
+            if (!Array.isArray(cohorts)) return;
+            if (!getAccess(user, "addStudents") || user.viewStudents === "none") return;
+            if (user.product !== "institutes") return;
+            const returnObj: TaskQueryReturnObject = {
+                link: "",
+                dismissible: true,
+                severity: "warning",
+            };
+            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)]));
+                if (studentCount === 0) {
+                    return {
+                        ...returnObj,
+                        title: "Upload students",
+                        message: `Your cohort '${cohort.name}' has no students. Add them in the cohort 'Students' tab`,
+                        link: `/institutes/cohorts/${id}/students`,
+                        buttonTitle: "Upload students",
+                    };
+                }
+                return;
+            }));
+            return items.filter((v) => v);
+        },
+    },
+    inactiveStaff: {
+        callback: async (user, _, cohorts) => {
+            if (!getAccess(user, "addStaff")) return;
+
+            if (!Array.isArray(cohorts) || user.product === "students") return;
+            const returnObj: TaskQueryReturnObject = {
+                link: `/${user.product}/cohorts/staff/all?status=inactive`,
+                dismissible: false,
+                severity: "info",
+            };
+            const inactiveStaff = await firebaseQuery.getCount(["users"], [where("oId", "==", user.oId), where("userType", "==", "Staff"), where("status", "==", "inactive")]);
+            if (inactiveStaff > 0) {
+                return {
+                    ...returnObj,
+                    title: "Inactive staff",
+                    message: `You have ${inactiveStaff} inactive staff members. You can activate them in the 'Staff' cohorts tab.`,
+                };
+            }
+            return;
+        },
+    },
+    overdueStage: {
+        callback: async (user, _, cohort) => {
+            console.log(user, cohort);
+            return undefined;
+        },
+    },
+    approveExternalPlacement: {
+        callback: async (user, _, cohort) => {
+            if (!getAccess(user, "verifyListings")) return;
+            if (!Array.isArray(cohort)) return;
+            const externalCount = await firebaseQuery.getCount(["placementListings"],
+                [where(`savedBy.${user.oId}.exists`, "==", true), where(`savedBy.${user.oId}.status`, "==", "uploaded"), where("mapConsent", "==", "institute")]);
+            console.log("EXT", externalCount);
+            if (externalCount > 0) {
+                return {
+                    dismissible: false,
+                    severity: "warning",
+                    title: `${externalCount} external placements require approval`,
+                    message: "Review and approve these placements to add them to your institute placement map",
+                    link: "/institutes/placements",
+                    buttonTitle: "View placements",
+                };
+            }
+            return;
+        },
+    },
+};
+
+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};
+            if (Object.keys(placementsWithoutOnboarding).length === 0) return;
+            const items = Object.entries(placementsWithoutOnboarding).map(([k, placement]) => ({
+                dismissible: false,
+                severity: "primary",
+                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))
+            return items;
+        },
+    }
+}
+
+const providerTasks:ProviderTaskObject = {
+    requestedVisibleAddresses: {
+        callback: async (user) => {
+            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("product", "==", "providers"), where("oId", "==", user.oId), orderBy("requestedVisibleAddresses")]) || {})[0] as [string, UserData];
+                return {
+                    dismissible: false,
+                    severity: "primary",
+                    title: `${userRequestingAccess[1].details.forename} ${userRequestingAccess[1].details.surname} has requested access to view addresses.`,
+                    message: `Click to review the addresses and grant access to the user.`,
+                    link: `/${user.product}/users/${userRequestingAccess[0]}`,
+                    buttonTitle: "View request",
+                } as TaskQueryReturnObject;
+        }
+
+            return {
+                dismissible: false,
+                severity: "warning",
+                title: `Multiple users have requested access to view addresses.`,
+                message: `Click to review the addresses and grant access to the user.`,
+                link: `/${user.product}/organisation/staff/all`,
+                buttonTitle: "View request",
+            } as TaskQueryReturnObject;
+        },
+    },
+    requestedVisiblePlacementListings: {
+        callback: async (user) => {
+            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];
+                return {
+                    dismissible: false,
+                    severity: "primary",
+                    title: `${userRequestingAccess[1].details.forename} ${userRequestingAccess[1].details.surname} has requested access to view placement listings.`,
+                    message: `Click to review the placement listings and grant access to the user.`,
+                    link: `/${user.product}/users/${userRequestingAccess[0]}`,
+                    buttonTitle: "View request",
+                } as TaskQueryReturnObject;
+        }
+
+            return {
+                dismissible: false,
+                severity: "warning",
+                title: `Multiple users have requested access to view placement listings.`,
+                message: `Click to review the placement listings and grant access to the user.`,
+                link: `/${user.product}/organisation/staff/all`,
+                buttonTitle: "View request",
+            } as TaskQueryReturnObject;
+        },
+    },
+    applicationRequireReview: {
+        callback: async (user) => {
+            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 {
+                dismissible: false,
+                severity: "primary",
+                title: `${applicationCount} applications require your review.`,
+                message: `Click to view ${applicationCount} that require your attention.`,
+                link: `/${user.product}/placementListings/applicants`,
+                buttonTitle: "View applications",
+            } as TaskQueryReturnObject;
+        },
+    },
+    completeStudentDocs: {
+        callback: async (user) => {
+            return;
+            return {} as TaskQueryReturnObject;
+        },
+    },
+    reviewOnboarding: {
+        callback: async (user) => {
+            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) => {
+            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) => {
+            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) => {
+            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) => {
+            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, addresses?: {[key: string]: OrganisationAddress}):Promise<(TaskQueryReturnObject)[]> => {
+    const tipsObject = {
+        providers: providerTips,
+        institutes: instituteTips,
+        studentTips: studentTips,
+    }
+    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(...callbackParams);
+        if (!queryResult) return await acc;
+
+        const queryResultArray = Array.isArray(queryResult) ? queryResult : [queryResult];
+        const results = queryResultArray.map((r) => ({itemName: itemName as InstituteTipNames|ProviderTipNames|StudentTipNames|InstituteTaskNames|ProviderTaskNames|StudentTaskNames, ...r}));
+
+        (await acc).push(...results);
+        return await acc;
+    }, Promise.resolve<TaskQueryReturnObject[]>([]));
+    return processedTips;
+}
+
+export const getTasks = async (user: UserData, organisation?: InstituteData|ProviderData, cohort?: CohortData):Promise<(TaskQueryReturnObject)[]> => {
+    // Cohort is either a specific one or all.
+
+    if (user.product === "institutes" && user.userType === "Staff" && organisation) {
+        return await getInstituteTasks(user, organisation, cohort);
+    }
+    if (user.product === "students" || user.userType === "Students") {
+        return await getStudentTasks(user, organisation, cohort);
+    }
+    if (user.product === "providers" && organisation) {
+        return await getProviderTasks(user, organisation);
+    }
+
+    return [];
+};
+
+const getStudentTasks = async (user: UserData, organisation?: InstituteData|ProviderData, cohort?: CohortData):Promise<(TaskQueryReturnObject)[]> => {
+    const processedTasks = await Object.entries(studentTasks).reduce(async (acc, [itemName, item]) => {
+
+        const queryResult = await item.callback(user);
+        if (!queryResult) return await acc;
+
+        const queryResultArray = Array.isArray(queryResult) ? queryResult : [queryResult];
+        const results = queryResultArray.map((r) => ({itemName: itemName as StudentTaskNames, ...r}));
+
+        (await acc).push(...results);
+        return await acc;
+    }, Promise.resolve<TaskQueryReturnObject[]>([]));
+    return processedTasks;
+};
+
+const getProviderTasks = async (user: UserData, organisation: InstituteData|ProviderData, cohort?: CohortData):Promise<(TaskQueryReturnObject)[]> => {
+    const processedTasks = await Object.entries(providerTasks).reduce(async (acc, [itemName, item]) => {
+
+        const queryResult = await item.callback(user);
+        if (!queryResult) return await acc;
+
+        const queryResultArray = Array.isArray(queryResult) ? queryResult : [queryResult];
+        const results = queryResultArray.map((r) => ({itemName: itemName as ProviderTaskNames, ...r}));
+
+        (await acc).push(...results);
+        return await acc;
+    }, Promise.resolve<TaskQueryReturnObject[]>([]));
+    return processedTasks;};
+
+const getInstituteTasks = async (user: UserData, organisation: InstituteData|ProviderData, cohort?: CohortData):Promise<(TaskQueryReturnObject)[]> => {
+    let fCohort:CohortData|[string, CohortData][]|undefined = cohort;
+
+    if (!fCohort) {
+        // get all associated cohorts.
+        if (user.viewCohorts === "none") return([]);
+        if (user.userGroup === "admin" || user.viewCohorts === "all") {
+            const cohorts = await firebaseQuery.getDocsWhere("cohorts", [where("product", "==", user.product), where("oId", "==", user.oId), where("stage", "==", "created")]) as {[key:string]: CohortData};
+            fCohort = Object.entries(cohorts);
+        }
+        if (user.viewCohorts === "some") {
+            const cohorts = await user.visibleCohorts?.reduce(async (acc, cohortId) => {
+                const cohort = await firebaseQuery.getDocData(["cohorts", cohortId]) as CohortData;
+                if (cohort.stage !== "created") {
+                    return acc;
+                }
+                acc[cohortId] = cohort;
+                return acc;
+            }, Promise.resolve<[string, CohortData][]>([]));
+            fCohort = cohorts;
+        }
+    }
+    
+    const processedTasks = await Object.entries(instituteTasks).reduce(async (acc, [itemName, item]) => {
+        if (!fCohort) {
+            console.log("No cohorts to retrieve tasks for");
+            return([]);
+        }
+        const queryResult = await item.callback(user, organisation, fCohort);
+        if (!queryResult) return await acc;
+
+        const queryResultArray = Array.isArray(queryResult) ? queryResult : [queryResult];
+        const results = queryResultArray.map((r) => ({itemName: itemName as InstituteTaskNames, ...r}));
+
+        (await acc).push(...results);
+        return await acc;
+    }, Promise.resolve<TaskQueryReturnObject[]>([]));
+    return processedTasks;
+}
+
+/*
+export const getTasks = async (user: UserData):Promise<{[key:string]: TaskQueryReturnObject}> => {
+    return Object.fromEntries((await Promise.all(Object.entries(tasks).filter(([k]) => !user.dismissedTasks?.includes(k)).map(async ([taskName, task]) => {
+        const queryResult = await task.callback(user);
+        return [taskName, queryResult ? {...queryResult, ...task} : undefined];
+    }))).filter(([, v]) => v));
+};
+
+export const dismissTask = (user: UserData, taskName:TaskNames) => {
+    firebaseQuery.update(["users", user.id], {dismissedTasks: arrayUnion(taskName)});
+};
+*/
+export const dismissTip = async (user: UserData, itemName:InstituteTaskNames | ProviderTaskNames | StudentTaskNames | InstituteTipNames | ProviderTipNames | StudentTipNames | undefined) => {
+    if (!itemName) return;
+    return await firebaseQuery.update(["users", user.id], {dismissedTips: arrayUnion(itemName)});
+};