feat: assign coalition points when donating points to the pool

Author: FreekBes

prisma/schema.prisma

@@ -53,7 +53,7 @@ model CodamCoalition {
 
 // Fixed type of score for the coalition system
 model CodamCoalitionFixedType {
-	type             String   @id // should not contain spaces. e.g. "project", "eval", "logtime", "exam", "basic_event", "intermediate_event", "advanced_event"
+	type             String   @id // should not contain spaces. e.g. "project", "eval", "point_donated", "logtime", "exam", "basic_event", "intermediate_event", "advanced_event"
 	description      String
 	point_amount     Int
 

src/routes/hooks.ts

@@ -3,6 +3,7 @@ import { Express, Response } from 'express';
 import { handleLocationCloseWebhook, Location } from './hooks/locations';
 import { handleProjectsUserUpdateWebhook, ProjectUser } from './hooks/projects_users';
 import { handleScaleTeamUpdateWebhook, ScaleTeam } from './hooks/scale_teams';
+import { handlePointGivenWebhook, PointGiven } from './hooks/pools';
 
 export interface WebhookHeaders {
 	modelType: string;
@@ -79,6 +80,9 @@ export const setupWebhookRoutes = function(app: Express, prisma: PrismaClient):
 				case "scale_team": // scale team (evaluation) update
 					const scaleTeam: ScaleTeam = req.body as ScaleTeam;
 					return await handleScaleTeamUpdateWebhook(prisma, scaleTeam, res, webhookHeaders.deliveryId);
+				case "pool": // pool point_given
+					const pointGiven: PointGiven = req.body as PointGiven;
+					return await handlePointGivenWebhook(prisma, pointGiven, res, webhookHeaders.deliveryId);
 				default:
 					console.warn("Unknown model type", webhookHeaders.modelType);
 					return await respondWebHookHandledStatus(prisma, webhookHeaders.deliveryId, res, WebhookHandledStatus.Error);

src/routes/hooks/pools.ts

@@ -0,0 +1,59 @@
+import { Response } from 'express';
+import { PrismaClient } from '@prisma/client';
+import { WebhookHandledStatus, respondWebHookHandledStatus } from '../hooks';
+import { handleFixedPointScore } from '../../handlers/points';
+
+export interface PointGiven {
+	id: number;
+	campus_id: number;
+	cursus_id: number;
+	given_by: {
+		id: number;
+		first_name: string;
+		last_name: string;
+		usual_first_name: string | null;
+		email: string;
+		login: string;
+		correction_points: number;
+	} | null;
+	points: {
+		old: number;
+		current: number;
+	},
+	max_points: number;
+};
+
+export const handlePointGivenWebhook = async function(prisma: PrismaClient, pointGiven: PointGiven, res: Response | null = null, webhookDeliveryId: string | null = null): Promise<Response | null> {
+	try {
+		// Get fixed point type
+		const fixedPointType = await prisma.codamCoalitionFixedType.findFirst({
+			where: {
+				type: 'point_donated',
+			},
+		});
+		if (!fixedPointType || fixedPointType.point_amount === 0) {
+			console.warn("No fixed point type found for point_donated or point amount is set to 0, skipping...");
+			return (res ? respondWebHookHandledStatus(prisma, webhookDeliveryId, res, WebhookHandledStatus.Skipped) : null);
+		}
+		if (!pointGiven.given_by) {
+			return (res ? respondWebHookHandledStatus(prisma, webhookDeliveryId, res, WebhookHandledStatus.Skipped) : null);
+		}
+
+		// Calculate the score
+		const actualPointsGiven = pointGiven.points.current - pointGiven.points.old;
+		const points = actualPointsGiven * fixedPointType.point_amount;
+
+		// Create a score
+		const score = await handleFixedPointScore(prisma, fixedPointType, pointGiven.id, pointGiven.given_by.id, points,
+			`Donated ${actualPointsGiven} points to the pool`);
+		if (!score) {
+			console.warn("Refused or failed to create score, skipping...");
+			return (res ? respondWebHookHandledStatus(prisma, webhookDeliveryId, res, WebhookHandledStatus.Skipped) : null);
+		}
+		return (res ? respondWebHookHandledStatus(prisma, webhookDeliveryId, res, WebhookHandledStatus.Ok) : null);
+	}
+	catch (error) {
+		console.error("Failed to handle pool point_given webhook", error);
+		return (res ? respondWebHookHandledStatus(prisma, webhookDeliveryId, res, WebhookHandledStatus.Error) : null);
+	}
+};

src/sync/fixed_point_types.ts

@@ -29,6 +29,11 @@ export const initCodamCoalitionFixedTypes = async function(): Promise<void> {
 			desc: "Each evaluation given will grant the student with this amount of points",
 			points: 20, // recommended
 		},
+		{
+			type: "point_donated",
+			desc: "Each point donated to the pool will grant the student with this amount of points",
+			points: 20, // recommended (to be the same as evaluation)
+		},
 		{
 			type: "logtime",
 			desc: "Every logtime hour will grant the student with this amount of points",