Feature branch/data quality

backend/migrations/20250103160000-updateTextForWorkerLeaveReasons.js

@@ -0,0 +1,83 @@
+'use strict';
+const models = require('../server/models/index');
+
+const allReasons = [
+  {
+    id: 1,
+    seq: 1,
+    oldText: 'They moved to another adult social care employer',
+    newText: 'The worker moved to another adult social care employer',
+  },
+  {
+    id: 2,
+    seq: 2,
+    oldText: 'They moved to a role in the health sector',
+    newText: 'The worker moved to a role in the health sector',
+  },
+  {
+    id: 3,
+    seq: 3,
+    oldText: 'They moved to a different sector (e.g. retail)',
+    newText: 'The worker moved to a different sector (for example, retail)',
+  },
+  {
+    id: 4,
+    seq: 4,
+    oldText: 'They moved to another role in this organisation',
+    newText: 'The worker moved to a different role in this organisation',
+  },
+  {
+    id: 5,
+    seq: 5,
+    oldText: 'The worker chose to leave (destination unknown)',
+    newText: 'The worker chose to leave (destination not known)',
+  },
+  { id: 6, seq: 6, oldText: 'The worker retired', newText: 'The worker retired' },
+  {
+    id: 7,
+    seq: 7,
+    oldText: 'Employer terminated their employment',
+    newText: 'The worker had their employment terminated',
+  },
+  { id: 8, seq: 8, oldText: 'Other', newText: 'For a reason not listed' },
+  { id: 9, seq: 9, oldText: 'Not known', newText: 'Reason not known' },
+];
+
+/** @type {import('sequelize-cli').Migration} */
+module.exports = {
+  async up(queryInterface) {
+    return queryInterface.sequelize.transaction(async (transaction) => {
+      for (const reason of allReasons) {
+        await models.workerLeaveReasons.update(
+          {
+            reason: reason.newText,
+          },
+          {
+            where: {
+              id: reason.id,
+            },
+            transaction,
+          },
+        );
+      }
+    });
+  },
+
+  async down(queryInterface) {
+    return queryInterface.sequelize.transaction(async (transaction) => {
+      for (const reason of allReasons) {
+        await models.workerLeaveReasons.update(
+          {
+            reason: reason.oldText,
+          },
+          {
+            where: {
+              id: reason.id,
+            },
+            transaction,
+          },
+        );
+      }
+    });
+  },
+};

backend/migrations/20250106091714-addLastViewedVacanciesAndTurnoverMessage.js

@@ -0,0 +1,17 @@
+'use strict';
+
+const userTable = { tableName: 'User', schema: 'cqc' };
+
+/** @type {import('sequelize-cli').Migration} */
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    return queryInterface.addColumn(userTable, 'LastViewedVacanciesAndTurnoverMessage', {
+      type: Sequelize.DataTypes.DATE,
+      allowNull: true,
+    });
+  },
+
+  async down(queryInterface) {
+    return queryInterface.removeColumn(userTable, 'LastViewedVacanciesAndTurnoverMessage');
+  },
+};

backend/server/models/user.js

@@ -274,6 +274,11 @@ module.exports = function (sequelize, DataTypes) {
         allowNull: true,
         field: '"CanManageWdfClaimsChangedBy"',
       },
+      lastViewedVacanciesAndTurnoverMessage: {
+        type: DataTypes.DATE,
+        allowNull: true,
+        field: 'LastViewedVacanciesAndTurnoverMessage',
+      },
     },
     {
       tableName: '"User"',
@@ -542,5 +547,16 @@ module.exports = function (sequelize, DataTypes) {
     return userFound;
   };
 
+  User.setDateForLastViewedVacanciesAndTurnoverMessage = async function (userUid) {
+    return await this.update(
+      { lastViewedVacanciesAndTurnoverMessage: new Date() },
+      {
+        where: {
+          uid: userUid,
+        },
+      },
+    );
+  };
+
   return User;
 };

backend/server/routes/accounts/user.js

@@ -1,6 +1,7 @@
 // default route for user endpoint
 const express = require('express');
 const router = express.Router();
+const { validate } = require('uuid');
 
 const models = require('../../models');
 const Authorization = require('../../utils/security/isAuthenticated');
@@ -809,7 +810,7 @@ router.route('/swap/establishment/notification/:nmsdId').get(async (req, res) =>
       let notificationArr = [];
 
       const establishmentNotifications = await notifications.selectNotificationByEstablishment(req.establishmentUid);
-      if(establishmentNotifications) notificationArr.push(establishmentNotifications);
+      if (establishmentNotifications) notificationArr.push(establishmentNotifications);
       return res.status(200).send(notificationArr);
     }
   } catch (e) {
@@ -911,6 +912,22 @@ const swapEstablishment = async (req, res) => {
     .json(response);
 };
 
+const updateLastViewedVacanciesAndTurnoverMessage = async (req, res) => {
+  try {
+    const userUid = req.params?.userUid;
+
+    if (!validate(userUid)) {
+      return res.status(400).send('User UID invalid');
+    }
+
+    await models.user.setDateForLastViewedVacanciesAndTurnoverMessage(userUid);
+
+    return res.status(200).send('Last viewed date updated');
+  } catch (error) {
+    return res.status(500).send('Failed to update last viewed date');
+  }
+};
+
 router.route('/').get(return200);
 router.route('/admin').get(Authorization.isAdmin, listAdminUsers);
 router.route('/admin/:userId').get(Authorization.isAdmin, getUser);
@@ -945,6 +962,9 @@ router.route('/my/establishments').get(Authorization.isAuthorised, listEstablish
 router.route('/admin/:userId').get(Authorization.isAuthorised, getUser);
 router.use('/my/notifications', Authorization.isAuthorised);
 router.route('/my/notifications').get(listNotifications);
+router
+  .route('/update-last-viewed-vacancies-and-turnover-message/:userUid')
+  .post(Authorization.isAuthorised, updateLastViewedVacanciesAndTurnoverMessage);
 
 router.use('/swap/establishment/:id', authLimiter);
 router.route('/swap/establishment/:id').post(Authorization.isAdmin, swapEstablishment);
@@ -955,3 +975,4 @@ module.exports.partAddUser = partAddUser;
 
 module.exports.listAdminUsers = listAdminUsers;
 module.exports.updateUser = updateUser;
+module.exports.updateLastViewedVacanciesAndTurnoverMessage = updateLastViewedVacanciesAndTurnoverMessage;

backend/server/routes/login.js

@@ -79,6 +79,7 @@ router.post('/', async (req, res) => {
                   'UserRoleValue',
                   'registrationSurveyCompleted',
                   'tribalId',
+                  'lastViewedVacanciesAndTurnoverMessage',
                 ],
                 include: [
                   {
@@ -95,6 +96,7 @@ router.post('/', async (req, res) => {
                       'lastBulkUploaded',
                       'eightWeeksFromFirstLogin',
                       'EmployerTypeValue',
+                      'dataOwner',
                     ],
                     include: [
                       {
@@ -284,6 +286,7 @@ router.post('/', async (req, res) => {
               migratedUser,
             },
             establishmentUser.user.registrationSurveyCompleted,
+            establishmentUser.user.lastViewedVacanciesAndTurnoverMessage,
           );
 
           await models.sequelize.transaction(async (t) => {

backend/server/test/unit/routes/accounts/user.spec.js

@@ -3,8 +3,15 @@ const expect = chai.expect;
 const sinon = require('sinon');
 const httpMocks = require('node-mocks-http');
 
-const { meetsMaxUserLimit, partAddUser, listAdminUsers, updateUser } = require('../../../../routes/accounts/user');
+const {
+  meetsMaxUserLimit,
+  partAddUser,
+  listAdminUsers,
+  updateUser,
+  updateLastViewedVacanciesAndTurnoverMessage,
+} = require('../../../../routes/accounts/user');
 const User = require('../../../../models/classes/user').User;
+const models = require('../../../../models');
 
 describe('user.js', () => {
   let req;
@@ -345,4 +352,44 @@ describe('user.js', () => {
       });
     });
   });
+
+  describe('updateLastViewedVacanciesAndTurnoverMessage', () => {
+    let req;
+    let res;
+
+    beforeEach(() => {
+      req = httpMocks.createRequest();
+      res = httpMocks.createResponse();
+    });
+
+    it('should return 200 response if userUid in params is valid and database call successful', async () => {
+      req.params = { userUid: '6b6885fa-340d-4d59-8720-c03d8845e603' };
+      sinon.stub(models.user, 'setDateForLastViewedVacanciesAndTurnoverMessage').returns(null);
+
+      await updateLastViewedVacanciesAndTurnoverMessage(req, res);
+
+      expect(res.statusCode).to.equal(200);
+      expect(res._getData()).to.deep.equal('Last viewed date updated');
+    });
+
+    it('should return 400 response if userUid in params invalid', async () => {
+      req.params = { userUid: 'invalid-uid' };
+      sinon.stub(models.user, 'setDateForLastViewedVacanciesAndTurnoverMessage').returns(null);
+
+      await updateLastViewedVacanciesAndTurnoverMessage(req, res);
+
+      expect(res.statusCode).to.equal(400);
+      expect(res._getData()).to.deep.equal('User UID invalid');
+    });
+
+    it('should return 500 response if unexpected error', async () => {
+      req.params = { userUid: '6b6885fa-340d-4d59-8720-c03d8845e603' };
+      sinon.stub(models.user, 'setDateForLastViewedVacanciesAndTurnoverMessage').throws();
+
+      await updateLastViewedVacanciesAndTurnoverMessage(req, res);
+
+      expect(res.statusCode).to.equal(500);
+      expect(res._getData()).to.deep.equal('Failed to update last viewed date');
+    });
+  });
 });

backend/server/utils/login/response.js

@@ -11,6 +11,7 @@ module.exports = (
   agreedUpdatedTerms,
   migratedUser,
   registrationSurveyCompleted,
+  lastViewedVacanciesAndTurnoverMessage,
 ) => {
   // note - the mainService can be null
   return {
@@ -35,6 +36,7 @@ module.exports = (
           parentName: establishment.parentName ? establishment.parentName : undefined,
           isFirstBulkUpload: establishment.lastBulkUploaded ? false : true,
           employerTypeSet: establishment.EmployerTypeValue ? true : false,
+          dataOwner: establishment.dataOwner,
         }
       : null,
     mainService: establishment
@@ -45,5 +47,6 @@ module.exports = (
       : null,
     expiryDate: expiryDate,
     registrationSurveyCompleted: registrationSurveyCompleted,
+    lastViewedVacanciesAndTurnoverMessage,
   };
 };

frontend/src/app/app-routing.module.ts

@@ -31,10 +31,11 @@ import { FirstLoginPageComponent } from '@features/first-login-page/first-login-
 import { ForgotYourPasswordComponent } from '@features/forgot-your-username-or-password/forgot-your-password/forgot-your-password.component';
 import { ForgotYourUsernameOrPasswordComponent } from '@features/forgot-your-username-or-password/forgot-your-username-or-password.component';
 import { ForgotYourUsernameComponent } from '@features/forgot-your-username-or-password/forgot-your-username/forgot-your-username.component';
-import { UsernameFoundComponent } from '@features/forgot-your-username-or-password/username-found/username-found.component';
 import { SecurityQuestionAnswerNotMatchComponent } from '@features/forgot-your-username-or-password/forgot-your-username/security-question-answer-not-match/security-question-answer-not-match.component';
 import { UserAccountNotFoundComponent } from '@features/forgot-your-username-or-password/forgot-your-username/user-account-not-found/user-account-not-found.component';
+import { UsernameFoundComponent } from '@features/forgot-your-username-or-password/username-found/username-found.component';
 import { LoginComponent } from '@features/login/login.component';
+import { VacanciesAndTurnoverLoginMessage } from '@features/login/vacancies-and-turnover-login-message/vacancies-and-turnover-login-message.component';
 import { LogoutComponent } from '@features/logout/logout.component';
 import { MigratedUserTermsConditionsComponent } from '@features/migrated-user-terms-conditions/migrated-user-terms-conditions.component';
 import { BecomeAParentComponent } from '@features/new-dashboard/become-a-parent/become-a-parent.component';
@@ -148,6 +149,11 @@ const routes: Routes = [
         component: MigratedUserTermsConditionsComponent,
         data: { title: 'Migrated User Terms And Conditions' },
       },
+      {
+        path: 'update-your-vacancies-and-turnover-data',
+        component: VacanciesAndTurnoverLoginMessage,
+        data: { title: 'Update your vacancies and turnover data' },
+      },
       {
         path: 'workplace',
         loadChildren: () => import('@features/workplace/workplace.module').then((m) => m.WorkplaceModule),

frontend/src/app/app.module.ts

@@ -1,6 +1,3 @@
-import { Angulartics2Module } from 'angulartics2';
-import { HighchartsChartModule } from 'highcharts-angular';
-
 import { CommonModule } from '@angular/common';
 import { HTTP_INTERCEPTORS, HttpClient, HttpClientModule } from '@angular/common/http';
 import { ErrorHandler, NgModule } from '@angular/core';
@@ -72,7 +69,9 @@ import { FindUsernameComponent } from '@features/forgot-your-username-or-passwor
 import { ForgotYourUsernameComponent } from '@features/forgot-your-username-or-password/forgot-your-username/forgot-your-username.component';
 import { SecurityQuestionAnswerNotMatchComponent } from '@features/forgot-your-username-or-password/forgot-your-username/security-question-answer-not-match/security-question-answer-not-match.component';
 import { UserAccountNotFoundComponent } from '@features/forgot-your-username-or-password/forgot-your-username/user-account-not-found/user-account-not-found.component';
+import { UsernameFoundComponent } from '@features/forgot-your-username-or-password/username-found/username-found.component';
 import { LoginComponent } from '@features/login/login.component';
+import { VacanciesAndTurnoverLoginMessage } from '@features/login/vacancies-and-turnover-login-message/vacancies-and-turnover-login-message.component';
 import { LogoutComponent } from '@features/logout/logout.component';
 import { BecomeAParentComponent } from '@features/new-dashboard/become-a-parent/become-a-parent.component';
 import { DashboardWrapperComponent } from '@features/new-dashboard/dashboard-wrapper.component';
@@ -94,14 +93,15 @@ import { BenchmarksModule } from '@shared/components/benchmarks-tab/benchmarks.m
 import { DataAreaTabModule } from '@shared/components/data-area-tab/data-area-tab.module';
 import { FeatureFlagsService } from '@shared/services/feature-flags.service';
 import { SharedModule } from '@shared/shared.module';
+import { Angulartics2Module } from 'angulartics2';
+import { HighchartsChartModule } from 'highcharts-angular';
 
 import { AppRoutingModule } from './app-routing.module';
 import { AppComponent } from './app.component';
 import { StaffMismatchBannerComponent } from './features/dashboard/home-tab/staff-mismatch-banner/staff-mismatch-banner.component';
 import { MigratedUserTermsConditionsComponent } from './features/migrated-user-terms-conditions/migrated-user-terms-conditions.component';
 import { SatisfactionSurveyComponent } from './features/satisfaction-survey/satisfaction-survey.component';
 import { SentryErrorHandler } from './SentryErrorHandler.component';
-import { UsernameFoundComponent } from '@features/forgot-your-username-or-password/username-found/username-found.component';
 
 @NgModule({
   declarations: [
@@ -151,6 +151,7 @@ import { UsernameFoundComponent } from '@features/forgot-your-username-or-passwo
     SelectStarterJobRolesComponent,
     SecurityQuestionAnswerNotMatchComponent,
     UserAccountNotFoundComponent,
+    VacanciesAndTurnoverLoginMessage,
   ],
   imports: [
     Angulartics2Module.forRoot({

frontend/src/app/core/model/userDetails.model.ts

@@ -25,6 +25,7 @@ export interface UserDetails {
   updatedBy?: string;
   username?: string;
   canManageWdfClaims?: boolean;
+  lastViewedVacanciesAndTurnoverMessage?: string;
 }
 
 export enum UserStatus {