✨ feature: Cleanup features (#174)

* 🚧 wip

* ✨ feat: Cleanup Features

* 🧼 format & lint

---------

Co-authored-by: Tade Strehk <[email protected]>

Author: Strehk

schema.graphql

@@ -1557,6 +1557,10 @@ type Mutation {
   createOnePaymentTransaction(conferenceId: ID!, paymentFor: [ID!]!, userId: ID!): PaymentTransaction!
   createOneRoleApplication(delegationId: ID!, nationId: ID, nonStateActorId: ID): RoleApplication!
   createOneSingleParticipant(conferenceId: ID!, experience: String, motivation: String, roleId: ID!, school: String): SingleParticipant!
+  deleteDeadDelegationMembers(conferenceId: ID!): [DelegationMember!]!
+  deleteDeadSingleParticipants(conferenceId: ID!): [SingleParticipant!]!
+  deleteDeadSupervisors(conferenceId: ID!): [ConferenceSupervisor!]!
+  deleteEmptyDelegations(conferenceId: ID!): [Delegation!]!
   deleteOneCommittee(where: CommitteeWhereUniqueInput!): Committee
   deleteOneConference(where: ConferenceWhereUniqueInput!): Conference
   deleteOneConferenceParticipantStatus(where: ConferenceParticipantStatusWhereUniqueInput!): ConferenceParticipantStatus

src/api/resolvers/modules/conferenceSupervisor.ts

@@ -185,3 +185,49 @@ builder.mutationFields((t) => {
 		})
 	};
 });
+
+builder.mutationFields((t) => {
+	return {
+		// dead = not assigned to any role
+		deleteDeadSupervisors: t.prismaField({
+			type: ['ConferenceSupervisor'],
+			args: {
+				conferenceId: t.arg.id()
+			},
+			resolve: async (query, root, args, ctx) => {
+				return db.$transaction(async (tx) => {
+					const where = {
+						conferenceId: args.conferenceId,
+						OR: [
+							{
+								delegations: {
+									none: {}
+								}
+							},
+							{
+								delegations: {
+									every: {
+										assignedNation: null,
+										assignedNonStateActor: null
+									}
+								}
+							}
+						],
+						AND: [ctx.permissions.allowDatabaseAccessTo('delete').ConferenceSupervisor]
+					};
+
+					const res = await tx.conferenceSupervisor.findMany({
+						...query,
+						where
+					});
+
+					await db.conferenceSupervisor.deleteMany({
+						where
+					});
+
+					return res;
+				});
+			}
+		})
+	};
+});

src/api/resolvers/modules/delegation.ts

@@ -378,3 +378,37 @@ builder.queryFields((t) => {
 		})
 	};
 });
+
+builder.mutationFields((t) => {
+	return {
+		// empty = no members
+		deleteEmptyDelegations: t.prismaField({
+			type: ['Delegation'],
+			args: {
+				conferenceId: t.arg.id()
+			},
+			resolve: async (query, root, args, ctx) => {
+				return db.$transaction(async (tx) => {
+					const where = {
+						members: {
+							none: {}
+						},
+						conferenceId: args.conferenceId,
+						AND: [ctx.permissions.allowDatabaseAccessTo('delete').Delegation]
+					};
+
+					const res = await tx.delegation.findMany({
+						...query,
+						where
+					});
+
+					await db.delegation.deleteMany({
+						where
+					});
+
+					return res;
+				});
+			}
+		})
+	};
+});

src/api/resolvers/modules/delegationMember.ts

@@ -268,3 +268,39 @@ builder.mutationFields((t) => {
 		})
 	};
 });
+
+builder.mutationFields((t) => {
+	return {
+		// dead = not assigned to any role
+		deleteDeadDelegationMembers: t.prismaField({
+			type: ['DelegationMember'],
+			args: {
+				conferenceId: t.arg.id()
+			},
+			resolve: async (query, root, args, ctx) => {
+				return db.$transaction(async (tx) => {
+					const where = {
+						assignedCommittee: null,
+						delegation: {
+							assignedNation: null,
+							assignedNonStateActor: null
+						},
+						conferenceId: args.conferenceId,
+						AND: [ctx.permissions.allowDatabaseAccessTo('delete').DelegationMember]
+					};
+
+					const res = await tx.delegationMember.findMany({
+						...query,
+						where
+					});
+
+					await db.delegationMember.deleteMany({
+						where
+					});
+
+					return res;
+				});
+			}
+		})
+	};
+});

src/api/resolvers/modules/singleParticipant.ts

@@ -251,3 +251,35 @@ builder.mutationFields((t) => {
 		})
 	};
 });
+
+builder.mutationFields((t) => {
+	return {
+		// dead = not assigned to any role
+		deleteDeadSingleParticipants: t.prismaField({
+			type: ['SingleParticipant'],
+			args: {
+				conferenceId: t.arg.id()
+			},
+			resolve: async (query, root, args, ctx) => {
+				return db.$transaction(async (tx) => {
+					const where = {
+						assignedRole: null,
+						conferenceId: args.conferenceId,
+						AND: [ctx.permissions.allowDatabaseAccessTo('delete').SingleParticipant]
+					};
+
+					const res = await tx.singleParticipant.findMany({
+						...query,
+						where
+					});
+
+					await db.singleParticipant.deleteMany({
+						where
+					});
+
+					return res;
+				});
+			}
+		})
+	};
+});

src/i18n/de.json

@@ -570,6 +570,25 @@
 	"general": "Allgemeines",
 	"communication": "Kommunikation",
 	"conferenceStatusDescription": "<p>Der Konferenzstatus bestimmt, was die Teilnehmenden in der App sehen und tun können. Er sollte immer nur \"vorwärts\" geändert werden. Auch wenn bei einem Rückschritt keine Daten verloren gehen, kann es doch einerseits zu Verwirrungen bei den Teilnehmenden führen und andererseits in der App zu unerwartetem Verhalten führen.</p><p>Der Konferenzstatus orientiert sich an den Phasen einer Konferenz. Die Möglichkeiten sind:</p><ul><li><strong>Vor Anmeldestart</strong>: Die Konferenz wurde angelegt,die Anmeldephase aber noch nicht gestartet. Es können alle Vorbereitungen getroffen werden, die Anmeldung ist aber noch nicht möglich und die Konferenz nach außen hin auch noch nicht sichtbar.</li><li><strong>Anmeldephase</strong>: Die Anmeldung ist möglich, bis das Datum für das Ende der Anmeldung erreicht ist. Dann wird die Anmeldephase automatisch beendet. Nun kann die Zuteilung vorgenommen und auch schon angewendet werden. Solange der Konferenzstatus noch \"Anmeldephase\"ist,können die Teilnehmenden ihre Zuweisung noch nicht sehen.</li><li><strong>Vorbereitung</strong>: Wenn die Zuteilung abgeschlossen istundmandie Ergebnisse bekannt geben möchte, kann der Konferenz status auf \"Vorbereitung\" gesetzt werden. Dieser Status sollte bis zu Beginnder Konferenz bestehen bleiben. Die Teilnehmenden bekommen Informationen zur postalischen Anmeldung und der Beitragszahlung angezeigt und können auf Materialien und Infos (weiter unten) zugreifen.</li><li><strong>Aktive Konferenz</strong>: Dieser Status sollte kurz vor Beginnder Konferenz gesetzt werden.</li><li><strong>Nach der Konferenz</strong>: Nach der Konferenz kann der Status auf \"Nach der Konferenz\" gesetzt werden. Vorher sollte eingetragen werden, wer von den Teilnehmenden anwesend war und ein Zertifikat erhalten soll. Mit diesem Status können die Teilnehmenden ihre Zertifikate herunterladen.</li></ul>",
+	"cleanup": "Aufräumen",
+	"cleanupDescription": "Auf dieser Seite kannst du Karteileichen aus den Datenbanken löschen, um einen besseren Überblick über die tatsächlichen Anmeldeverhältnisse zu bekommen.",
+	"cleanupDelegationMembers": "Delegationsmitglieder aufräumen",
+	"cleanupDelegationMembersDescription": "Mit einem Klick auf den unteren Button werden alle Delegationsmitglieder, deren Delegationen keine zugewiesenen Rollen haben, aus der Delegation entfernt.",
+	"cleanupDelegationMembersButton": "Delegationsmitglieder aufräumen",
+	"cleanupDelegationMembersSuccess": "Delegationsmitglieder wurden erfolgreich aufgeräumt.",
+	"cleanupIndividualParticipants": "Einzelteilnehmende aufräumen",
+	"cleanupIndividualParticipantsDescription": "Mit einem Klick auf den unteren Button werden alle Einzelteilnehmende, die keine zugewiesenen Rollen haben, aus der Konferenz entfernt.",
+	"cleanupIndividualParticipantsButton": "Einzelteilnehmende aufräumen",
+	"cleanupIndividualParticipantsSuccess": "Einzelteilnehmende wurden erfolgreich aufgeräumt.",
+	"cleanupDelegations": "Delegationen aufräumen",
+	"cleanupDelegationsDescription": "Mit einem Klick auf den unteren Button werden alle Delegationen, die keine Mitglieder haben, gelöscht und damit aus der Konferenz entfernt.",
+	"cleanupDelegationsButton": "Delegationen aufräumen",
+	"cleanupDelegationsSuccess": "Delegationen wurden erfolgreich aufgeräumt.",
+	"cleanupSupervisors": "Betreuende aufräumen",
+	"cleanupSupervisorsDescription": "Mit einem Klick auf den unteren Button werden alle Betreuende, die nicht mindestens eine Delegation mit einer zugewiesenen Rolle betreuen, aus der Konferenz entfernt.",
+	"cleanupSupervisorsButton": "Betreuende aufräumen",
+	"cleanupSupervisorsSuccess": "Betreuende wurden erfolgreich aufgeräumt.",
+	"deleted": "Gelöscht",
 	"downloadCommitteeData": "Daten für das Gremium \"{committee}\" herunterladen",
 	"alpha3Code": "ISO Alpha 3 Code"
 }

src/i18n/en.json

@@ -514,6 +514,25 @@
 	"conferenceStatusParticipantRegistration": "Registration Phase",
 	"conferenceStatusPreparation": "Preparation Phase",
 	"conferenceStatusDescription": "<p>The conference status determines what participants can see and do in the app.It should only ever be changed \"forward\". Even though no data is lost whentaking a step back, it can lead to confusion among participants andpotentially cause unexpected behavior in the app.</p><p>The conference status is oriented around the phases of a conference. Thepossibilities are:</p><ul><li><strong>Before registration starts</strong>: The conference has been created,but the registration phase has not yet started. All preparations can bemade, but registration is not yet possible, and the conference is not yetvisible externally.</li><li><strong>Registration Phase</strong>: Registration is possible until the enddate for registration is reached. Then the registration phase isautomatically ended. Now allocation can be made and also already applied. Aslong as the conference status is still \"Registration Phase\", participantscannot yet see their assignment.</li><li><strong>Preparation Phase</strong>: When the allocation is complete and you wantto announce the results, the conference status can be set to \"Preparation Phase\".This status should remain until the beginning of the conference.Participants will be shown information about postal registration andcontribution payment and can access materials and information.</li><li><strong>Active Conference</strong>: This status should be set shortly beforethe start of the conference.</li><li><strong>After the Conference</strong>: After the conference, the status canbe set to \"After the Conference\". Before this, it should be recorded whoamong the participants was present and should receive a certificate. Withthis status, participants can download their certificates.</li></ul>",
+	"cleanup": "Cleanup",
+	"cleanupDescription": "On this page you can delete inactive accounts from the databases to get a better overview of the actual registration situation.",
+	"cleanupDelegationMembers": "Clean up Delegation Members",
+	"cleanupDelegationMembersDescription": "By clicking on the button below, all delegation members whose delegations do not have assigned roles will be removed from the delegation.",
+	"cleanupDelegationMembersButton": "Clean up delegation members",
+	"cleanupDelegationMembersSuccess": "Delegation members have been cleaned up successfully.",
+	"cleanupIndividualParticipants": "Single Participants Cleanup",
+	"cleanupIndividualParticipantsDescription": "By clicking on the button below, all single participants who do not have assigned roles will be removed from the conference.",
+	"cleanupIndividualParticipantsButton": "Clean up single participants",
+	"cleanupIndividualParticipantsSuccess": "Single participants have been cleaned up successfully.",
+	"cleanupDelegations": "Clean up Delegations",
+	"cleanupDelegationsDescription": "By clicking on the button below, all delegations that have no members will be deleted and thus removed from the conference.",
+	"cleanupDelegationsButton": "Clean up delegations",
+	"cleanupDelegationsSuccess": "Delegations have been cleaned up successfully.",
+	"cleanupSupervisors": "Clean up Supervisors",
+	"cleanupSupervisorsDescription": "By clicking on the button below, all supervisors who do not supervise at least one delegation with an assigned role will be removed from the conference.",
+	"cleanupSupervisorsButton": "Clean up supervisors",
+	"cleanupSupervisorsSuccess": "Supervisors have been cleaned up successfully.",
+	"deleted": "Deleted",
 	"downloadCommitteeData": "Download committee data for the {committee}",
 	"alpha3Code": "ISO Alpha 3 Code"
 }

src/routes/(authenticated)/Breadcrumbs.svelte

@@ -87,11 +87,11 @@
 		},
 		supervisors: {
 			translation: m.supervisors(),
-			icon: 'eye'
+			icon: 'chalkboard-user'
 		},
 		plausibility: {
 			translation: m.adminPlausibility(),
-			icon: 'question'
+			icon: 'shield-check'
 		},
 		seats: {
 			translation: m.seats(),
@@ -128,6 +128,10 @@
 		payments: {
 			translation: m.payment(),
 			icon: 'money-bill-transfer'
+		},
+		cleanup: {
+			icon: 'broom',
+			translation: m.cleanup()
 		}
 	};
 

src/routes/(authenticated)/management/[conferenceId]/+layout.svelte

@@ -76,6 +76,12 @@
 				title={m.payment()}
 				expanded={navbarExpanded}
 			/>
+			<NavMenuButton
+				href="/management/{data.conferenceId}/cleanup"
+				icon="fa-broom"
+				title={m.cleanup()}
+				expanded={navbarExpanded}
+			/>
 		</NavMenuDetails>
 	</NavMenu>
 </SideNavigationDrawer>

src/routes/(authenticated)/management/[conferenceId]/cleanup/+page.svelte

@@ -0,0 +1,127 @@
+<script lang="ts">
+	import { graphql } from '$houdini';
+	import * as m from '$lib/paraglide/messages';
+	import Modal from './Modal.svelte';
+	import Section from './Section.svelte';
+	import type { ModalData } from './types';
+
+	let { data } = $props();
+
+	let modalData = $state<ModalData>();
+
+	const cleanupDelegationMembers = graphql(`
+		mutation CleanupDelegationMembers($conferenceId: ID!) {
+			deleteDeadDelegationMembers(conferenceId: $conferenceId) {
+				id
+				user {
+					given_name
+					family_name
+				}
+			}
+		}
+	`);
+
+	const cleanupIndividualParticipants = graphql(`
+		mutation CleanupIndividualParticipants($conferenceId: ID!) {
+			deleteDeadSingleParticipants(conferenceId: $conferenceId) {
+				id
+				user {
+					given_name
+					family_name
+				}
+			}
+		}
+	`);
+
+	const cleanupDelegations = graphql(`
+		mutation CleanupDelegations($conferenceId: ID!) {
+			deleteEmptyDelegations(conferenceId: $conferenceId) {
+				id
+			}
+		}
+	`);
+
+	const cleanupSupervisors = graphql(`
+		mutation CleanupSupervisors($conferenceId: ID!) {
+			deleteDeadSupervisors(conferenceId: $conferenceId) {
+				id
+				user {
+					given_name
+					family_name
+				}
+			}
+		}
+	`);
+
+	function createModalData(
+		message: string,
+		result: { user?: { given_name: string; family_name: string }; id?: string }[] | undefined
+	) {
+		if (!result) return { message: 'Error - No result', count: 0, detailArray: [] };
+		return {
+			message,
+			count: result.length,
+			detailArray:
+				result
+					.map((item) => (item.user ? `${item.user.given_name} ${item.user.family_name}` : item.id))
+					.filter((item) => item !== undefined) ?? []
+		};
+	}
+</script>
+
+<div class="flex w-full flex-col flex-wrap gap-8 p-10">
+	<div class="flex flex-col gap-2">
+		<h2 class="text-2xl font-bold">{m.cleanup()}</h2>
+		<p>{@html m.cleanupDescription()}</p>
+	</div>
+	<Section
+		title={m.cleanupDelegationMembers()}
+		description={m.cleanupDelegationMembersDescription()}
+		btnText={m.cleanupDelegationMembersButton()}
+		action={async () => {
+			modalData = createModalData(
+				m.cleanupDelegationMembersSuccess(),
+				(await cleanupDelegationMembers.mutate({ conferenceId: data.conferenceId }))?.data
+					?.deleteDeadDelegationMembers
+			);
+		}}
+	/>
+	<Section
+		title={m.cleanupIndividualParticipants()}
+		description={m.cleanupIndividualParticipantsDescription()}
+		btnText={m.cleanupIndividualParticipantsButton()}
+		action={async () => {
+			modalData = createModalData(
+				m.cleanupIndividualParticipantsSuccess(),
+				(await cleanupIndividualParticipants.mutate({ conferenceId: data.conferenceId }))?.data
+					?.deleteDeadSingleParticipants
+			);
+		}}
+	/>
+	<Section
+		title={m.cleanupDelegations()}
+		description={m.cleanupDelegationsDescription()}
+		btnText={m.cleanupDelegationsButton()}
+		action={async () => {
+			modalData = createModalData(
+				m.cleanupDelegationsSuccess(),
+				(await cleanupDelegations.mutate({ conferenceId: data.conferenceId }))?.data
+					?.deleteEmptyDelegations
+			);
+		}}
+	/>
+	<Section
+		title={m.cleanupSupervisors()}
+		description={m.cleanupSupervisorsDescription()}
+		btnText={m.cleanupSupervisorsButton()}
+		action={async () => {
+			modalData = createModalData(
+				m.cleanupSupervisorsSuccess(),
+				(await cleanupSupervisors.mutate({ conferenceId: data.conferenceId }))?.data
+					?.deleteDeadSupervisors
+			);
+		}}
+	/>
+</div>
+
+<Modal {modalData} open={!!modalData} closeModal={() => (modalData = undefined)} />