- Supervisor -> Feedback (supervisors and admins, campus-scoped): every event's form with answered of asked, response rate, average rating and last reminder; per event the results per question (with the AI summary), each response, and on named forms who was asked and who has answered. - Remind those who haven't answered (or one person on a named form): a fresh link, plus the form to anyone eligible who hasn't had it; nobody gets the form or a reminder twice within 24 hours. The 3-day job is unchanged. - Anonymous forms show no names and no list of who has answered. - FeedbackInvite.reminderCount (migration 20261103120000_feedback_reminders); access log action feedback_responses; help page; dashboard and Ctrl+K links. - Roadmap: the AI helpers on the privacy pages are dropped; 2.1.0 is the feedback page. - Tests: tests/feedbackPage.test.ts, e2e/feedback.spec.ts. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
183 lines
10 KiB
TypeScript
183 lines
10 KiB
TypeScript
/**
|
|
* 2.1.0: the Feedback page (services/feedback.ts) — results per event, anonymous forms that stay
|
|
* anonymous, and "Remind" with its 24-hour rule (utils/feedback.js sendFeedbackReminders).
|
|
*/
|
|
const mockDb: any = {
|
|
feedbackForm: { findUnique: jest.fn(), findMany: jest.fn() },
|
|
feedbackInvite: { findMany: jest.fn(), updateMany: jest.fn(), count: jest.fn(), create: jest.fn(), groupBy: jest.fn() },
|
|
feedbackAnswer: { findMany: jest.fn() },
|
|
ticket: { findMany: jest.fn() },
|
|
registration: { findMany: jest.fn() },
|
|
user: { findMany: jest.fn() },
|
|
};
|
|
jest.mock('../src/config/db', () => mockDb);
|
|
const mockMail = jest.fn(async () => undefined);
|
|
jest.mock('../src/utils/email', () => ({ sendMail: (...a: unknown[]) => (mockMail as jest.Mock)(...a), emailWrapper: (h: string) => h, ctaButton: () => '', fallbackLink: () => '' }));
|
|
jest.mock('../src/utils/notify', () => ({ waTextAny: jest.fn(async () => undefined) }));
|
|
jest.mock('../src/utils/whatsapp', () => ({ isValidZAPhone: () => false }));
|
|
|
|
import * as feedback from '../src/services/feedback';
|
|
// eslint-disable-next-line @typescript-eslint/no-require-imports
|
|
const { sendFeedbackReminders } = require('../src/utils/feedback');
|
|
|
|
const NOW = new Date('2026-11-10T12:00:00Z');
|
|
const hoursAgo = (h: number) => new Date(NOW.getTime() - h * 3600e3);
|
|
const EVENT = { id: 'ev1', title: 'Men\'s Breakfast', startDate: new Date('2026-11-01T07:00:00Z'), endDate: new Date('2026-11-01T10:00:00Z') };
|
|
const FIELDS = [
|
|
{ id: 'f1', type: 'rating', label: 'Overall', options: null },
|
|
{ id: 'f2', type: 'text', label: 'What could be better?', options: null },
|
|
{ id: 'f0', type: 'statement', label: 'Thanks for coming', options: null },
|
|
];
|
|
const person = (id: string, name: string) => ({ id, name, email: `${id}@example.com`, phoneNumber: null });
|
|
|
|
function form(extra: object = {}) {
|
|
return {
|
|
id: 'form1', eventId: 'ev1', event: EVENT, anonymous: false, audience: 'checked_in', intro: null,
|
|
sendAt: hoursAgo(72), sentAt: hoursAgo(72), reminderSentAt: null, fields: FIELDS,
|
|
responses: [
|
|
{ id: 'r1', createdAt: hoursAgo(60), user: { name: 'Anna' }, answers: [{ fieldId: 'f1', value: '5' }, { fieldId: 'f2', value: 'Longer coffee break' }] },
|
|
{ id: 'r2', createdAt: hoursAgo(50), user: { name: 'Ben' }, answers: [{ fieldId: 'f1', value: '4' }] },
|
|
],
|
|
invites: [
|
|
{ userId: 'u1', user: person('u1', 'Anna'), sentAt: hoursAgo(72), remindedAt: null, reminderCount: 0, respondedAt: hoursAgo(60) },
|
|
{ userId: 'u2', user: person('u2', 'Ben'), sentAt: hoursAgo(72), remindedAt: null, reminderCount: 0, respondedAt: hoursAgo(50) },
|
|
{ userId: 'u3', user: person('u3', 'Cara'), sentAt: hoursAgo(72), remindedAt: hoursAgo(2), reminderCount: 1, respondedAt: null },
|
|
{ userId: 'u4', user: person('u4', 'Dumi'), sentAt: hoursAgo(72), remindedAt: null, reminderCount: 0, respondedAt: null },
|
|
{ userId: 'u5', user: person('u5', 'Eve'), sentAt: hoursAgo(1), remindedAt: null, reminderCount: 0, respondedAt: null },
|
|
],
|
|
...extra,
|
|
};
|
|
}
|
|
|
|
beforeEach(() => {
|
|
jest.clearAllMocks();
|
|
mockDb.ticket.findMany.mockResolvedValue([]);
|
|
mockDb.registration.findMany.mockResolvedValue([]);
|
|
mockDb.user.findMany.mockResolvedValue([]);
|
|
mockDb.feedbackInvite.updateMany.mockResolvedValue({ count: 1 });
|
|
});
|
|
|
|
describe('averageRating', () => {
|
|
test('averages every valid star rating, to one decimal', () => {
|
|
expect(feedback.averageRating(['5', '4', '4'])).toBe(4.3);
|
|
expect(feedback.averageRating(['x', '9', '0'])).toBeNull();
|
|
expect(feedback.averageRating([])).toBeNull();
|
|
});
|
|
});
|
|
|
|
describe('one event\'s feedback', () => {
|
|
test('a named form: names on answers, everyone asked, not answered first', async () => {
|
|
mockDb.feedbackForm.findUnique.mockResolvedValue(form());
|
|
const data = await feedback.eventFeedback('ev1', NOW);
|
|
expect(data.counts).toMatchObject({ invited: 5, answered: 2, notAnswered: 3, responseRate: 40 });
|
|
expect(data.averageRating).toBe(4.5);
|
|
expect(data.fields.map((f: any) => f.id)).toEqual(['f1', 'f2']); // statements aren't questions
|
|
expect(data.responses[0]).toMatchObject({ name: 'Anna', answers: { f1: '5', f2: 'Longer coffee break' } });
|
|
expect(data.people!.map((p: any) => p.name)).toEqual(['Cara', 'Dumi', 'Eve', 'Anna', 'Ben']);
|
|
});
|
|
|
|
test('nobody is remindable within 24 hours of the form or a reminder', async () => {
|
|
mockDb.feedbackForm.findUnique.mockResolvedValue(form());
|
|
const data = await feedback.eventFeedback('ev1', NOW);
|
|
const can = Object.fromEntries(data.people!.map((p: any) => [p.name, p.canRemind]));
|
|
expect(can).toEqual({ Cara: false, Dumi: true, Eve: false, Anna: false, Ben: false });
|
|
expect(data.counts).toMatchObject({ canRemind: 1, remindedRecently: 2 });
|
|
});
|
|
|
|
test('an anonymous form: no names anywhere, and no list of who has answered', async () => {
|
|
mockDb.feedbackForm.findUnique.mockResolvedValue(form({ anonymous: true }));
|
|
const data = await feedback.eventFeedback('ev1', NOW);
|
|
expect(data.people).toBeNull();
|
|
expect(data.responses.every((r: any) => r.name === null)).toBe(true);
|
|
expect(JSON.stringify(data)).not.toMatch(/Anna|Ben|Cara|u1@example/);
|
|
expect(data.counts.notAnswered).toBe(3);
|
|
});
|
|
|
|
test('an event without a form is a 404', async () => {
|
|
mockDb.feedbackForm.findUnique.mockResolvedValue(null);
|
|
await expect(feedback.eventFeedback('ev1', NOW)).rejects.toMatchObject({ statusCode: 404 });
|
|
});
|
|
});
|
|
|
|
describe('Remind', () => {
|
|
test('not before the form has gone out', async () => {
|
|
mockDb.feedbackForm.findUnique.mockResolvedValue(form({ sentAt: null }));
|
|
await expect(feedback.remindFeedback('ev1')).rejects.toMatchObject({ statusCode: 409 });
|
|
});
|
|
|
|
test('not one by one on an anonymous form', async () => {
|
|
mockDb.feedbackForm.findUnique.mockResolvedValue(form({ anonymous: true }));
|
|
await expect(feedback.remindFeedback('ev1', { userIds: ['u4'] })).rejects.toMatchObject({ statusCode: 400 });
|
|
});
|
|
|
|
test('reminds those not reminded or sent the form in the last 24 hours, and says who was skipped', async () => {
|
|
mockDb.feedbackForm.findUnique.mockResolvedValue({ ...form(), invites: [{ userId: 'u3' }, { userId: 'u4' }, { userId: 'u5' }] });
|
|
mockDb.feedbackInvite.findMany.mockResolvedValue([{ id: 'i4', userId: 'u4', user: person('u4', 'Dumi') }]);
|
|
mockDb.feedbackInvite.count.mockResolvedValue(3);
|
|
const out = await feedback.remindFeedback('ev1');
|
|
expect(out).toMatchObject({ reminded: 1, newlyInvited: 0, skipped: 2 });
|
|
expect(out.message).toBe('Reminded 1 person. 2 people were sent the form or a reminder in the last 24 hours, so not again yet.');
|
|
const where = mockDb.feedbackInvite.findMany.mock.calls[0][0].where;
|
|
expect(where).toMatchObject({ formId: 'form1', respondedAt: null });
|
|
expect(where.sentAt.lt).toBeInstanceOf(Date);
|
|
expect(where.OR).toHaveLength(2);
|
|
expect(mockDb.feedbackInvite.updateMany.mock.calls[0][0].data.reminderCount).toEqual({ increment: 1 });
|
|
expect(mockMail).toHaveBeenCalledWith(expect.objectContaining({ to: 'u4@example.com', subject: 'Reminder: How was Men\'s Breakfast?' }));
|
|
});
|
|
|
|
test('one person on a named form', async () => {
|
|
mockDb.feedbackForm.findUnique.mockResolvedValue(form());
|
|
mockDb.feedbackInvite.findMany.mockResolvedValue([{ id: 'i4', userId: 'u4', user: person('u4', 'Dumi') }]);
|
|
mockDb.feedbackInvite.count.mockResolvedValue(1);
|
|
const out = await feedback.remindFeedback('ev1', { userIds: ['u4'] });
|
|
expect(out.message).toBe('Reminded 1 person.');
|
|
expect(mockDb.feedbackInvite.findMany.mock.calls[0][0].where.userId).toEqual({ in: ['u4'] });
|
|
expect(mockDb.feedbackInvite.create).not.toHaveBeenCalled(); // no new invites when reminding one person
|
|
});
|
|
|
|
test('everyone already reminded today', async () => {
|
|
mockDb.feedbackForm.findUnique.mockResolvedValue({ ...form(), invites: [] });
|
|
mockDb.feedbackInvite.findMany.mockResolvedValue([]);
|
|
mockDb.feedbackInvite.count.mockResolvedValue(2);
|
|
const out = await feedback.remindFeedback('ev1');
|
|
expect(out.message).toBe('Everyone who hasn\'t answered was sent the form or a reminder in the last 24 hours. Try again tomorrow.');
|
|
});
|
|
|
|
test('someone who answers while reminders go out isn\'t reminded', async () => {
|
|
mockDb.feedbackForm.findUnique.mockResolvedValue({ ...form(), invites: [] });
|
|
mockDb.feedbackInvite.findMany.mockResolvedValue([{ id: 'i4', userId: 'u4', user: person('u4', 'Dumi') }]);
|
|
mockDb.feedbackInvite.updateMany.mockResolvedValue({ count: 0 });
|
|
mockDb.feedbackInvite.count.mockResolvedValue(0);
|
|
expect((await feedback.remindFeedback('ev1')).reminded).toBe(0);
|
|
expect(mockMail).not.toHaveBeenCalled();
|
|
});
|
|
});
|
|
|
|
describe('the automatic reminder', () => {
|
|
test('still goes only to people never reminded, and counts it', async () => {
|
|
mockDb.feedbackForm.findUnique.mockResolvedValue(form());
|
|
mockDb.feedbackInvite.findMany.mockResolvedValue([{ id: 'i4', userId: 'u4', user: person('u4', 'Dumi') }]);
|
|
expect(await sendFeedbackReminders('form1')).toBe(1);
|
|
expect(mockDb.feedbackInvite.findMany.mock.calls[0][0].where).toEqual({ formId: 'form1', respondedAt: null, remindedAt: null });
|
|
expect(mockDb.feedbackInvite.updateMany.mock.calls[0][0].data.reminderCount).toEqual({ increment: 1 });
|
|
});
|
|
});
|
|
|
|
describe('overview', () => {
|
|
test('newest event first, with status, response rate, average rating and last reminder', async () => {
|
|
const older = { ...EVENT, id: 'ev0', title: 'Camp', startDate: new Date('2026-06-01T00:00:00Z') };
|
|
mockDb.feedbackForm.findMany.mockResolvedValue([
|
|
{ id: 'form0', event: older, sendAt: null, sentAt: null, anonymous: true, _count: { invites: 0, responses: 0 } },
|
|
{ id: 'form1', event: EVENT, sendAt: hoursAgo(72), sentAt: hoursAgo(72), anonymous: false, _count: { invites: 4, responses: 3 } },
|
|
]);
|
|
mockDb.feedbackAnswer.findMany.mockResolvedValue([{ value: '5', field: { formId: 'form1' } }, { value: '3', field: { formId: 'form1' } }]);
|
|
mockDb.feedbackInvite.groupBy.mockResolvedValue([{ formId: 'form1', _max: { remindedAt: hoursAgo(5) } }]);
|
|
const rows = await feedback.feedbackOverview({});
|
|
expect(rows.map((r: any) => [r.event.title, r.status, r.responseRate, r.averageRating])).toEqual([
|
|
['Men\'s Breakfast', 'sent', 75, 4],
|
|
['Camp', 'not_scheduled', null, null],
|
|
]);
|
|
expect(rows[0].lastReminderAt).toEqual(hoursAgo(5));
|
|
});
|
|
});
|