Feat/messaging/role based email messages

README.md

@@ -46,6 +46,21 @@ bun run dev:server # starts the actual dev server (vite&sveltekit)
 bunx lefthook install
 ```
 
+## Running on Windows
+
+Some `package.json` scripts in this repository assume a Unix-like shell (bash) and may not work out of the box on Windows `cmd.exe` or PowerShell. If you develop on Windows, consider one of the options below:
+
+- **Use WSL or Git Bash:** Install Windows Subsystem for Linux (WSL) or Git for Windows and run the development commands from there. This is the easiest option when scripts use shell operators (like `&&`, `rm`, or `sed`).
+- **Modify `package.json` scripts for PowerShell / cmd:** Replace Unix-only commands with cross-platform equivalents or use Node-based packages.
+
+if you are running on windows then change copy the following script tags and replace the cooresponding script tags in package.json
+
+```bash
+"dev": "concurrently \"bun run dev:server\" \"bun run dev:docker\"",
+"dev:docker": "docker compose -f ./dev.docker-compose.yml up",
+"dev:server": "bunx tsx -e \"const {spawn}=require('child_process'); const sleep=(ms)=>new Promise(r=>setTimeout(r,ms)); const run=(cmd,args)=>new Promise(res=>{const p=spawn(cmd,args,{stdio:'inherit',shell:process.platform==='win32'}); p.on('exit',c=>res(c??0));}); (async()=>{for(;;){let c=await run('bunx',['svelte-kit','sync']); if(c!==0){console.log('🔄 sync failed, retrying...'); await sleep(1000); continue;} c=await run('bunx',['vite']); console.log('🔄 Server exited, restarting...'); await sleep(1000);}})();\"",
+```
+
 ## Deployment
 
 The easiest way to deploy delegator on your own hardware is to use our provided [docker images](https://hub.docker.com/r/deutschemodelunitednations/delegator). You can find an example docker compose file in the [example](./example/) directoy. Please note that delegator relies on an [OIDC](https://auth0.com/intro-to-iam/what-is-openid-connect-oidc) issuer to be connected and properly configured. We recommend [ZITADEL](https://zitadel.com/) but any issuer of your choice will work. There are some additional instructions on this topic to be found in the example compose file.

messages/de.json

@@ -48,6 +48,7 @@
 	"allNations": "Alle Nationen",
 	"allPiecesCollected": "Alle Puzzlestücke wurden gesammelt!",
 	"allRightsReservedby": "Alle Rechte vorbehalten von",
+	"allowDelegationMailer": "Delegations-E-Mails erlauben",
 	"alpha3Code": "ISO Alpha 3 Code",
 	"alphabetical": "Alphabetisch",
 	"alreadRegistered": "Bereits angemeldet",
@@ -228,6 +229,8 @@
 	"committeesAndAgendaItems": "Gremien und Themen",
 	"committeesSucessfullyAssigned": "Gremien wurden erfolgreich verteilt.",
 	"communication": "Kommunikation",
+	"communicationPreferences": "Kommunikationseinstellungen",
+	"communicationPreferencesDescription": "Wähle, welche Updates du zu deiner Delegation erhalten möchtest.",
 	"compareVersion": "Mit einer anderen Version vergleichen",
 	"compareVersions": "Versionen vergleichen",
 	"complete": "abgeschlossen",
@@ -556,6 +559,60 @@
 	"mediaConsentStatus": "Fotostatus",
 	"members": "Mitglieder",
 	"membersPerDelegation": "Plätze pro Delegation",
+	"messageCancelButton": "Abbrechen",
+	"messageCompose": "Verfassen",
+	"messageComposeAnnouncement": "Ankündigung verfassen",
+	"messageComposeMessage": "Nachricht verfassen",
+	"messageDraft": "Entwurf",
+	"messageDraftAMessage": "Eine neue Nachricht entwerfen",
+	"messageHistory": "Verlauf",
+	"messageMessageBody": "Nachricht",
+	"messageMessagePlaceholder": "Teile wichtige Details, Aufgaben und Fristen hier...\n\nHalte es klar und prägnant. Du kannst Links für weitere Informationen hinzufügen.",
+	"messageNoMessagesSent": "Noch keine Nachrichten versendet. Sende deine erste Nachricht von der Verfassen-Seite.",
+	"messageRecipient": "Empfänger*in",
+	"messageRecipientNotEnabled": "Empfänger*in hat Messaging nicht aktiviert.",
+	"messageReviewDeliveryStatus": "Überprüfe den Zustellungsstatus und die Nachrichtenaktivität für diese Konferenz.",
+	"messageReviewSent": "Gesendete überprüfen",
+	"messageSendButton": "Nachricht senden",
+	"messageSendToParticipants": "Eine Nachricht an Konferenzteilnehmende senden",
+	"messageSent": "Nachricht gesendet.",
+	"messageSentLog": "Sendelog",
+	"messageStatusDelivered": "Zugestellt",
+	"messageSubject": "Betreff",
+	"messageSubjectPlaceholder": "z.B. Gremienagenda-Sperrung - 18:00 CET",
+	"messagingCenter": "Nachrichtenzentrale",
+	"messagingCheckDeliveryStatus": "Zustellungsstatus prüfen",
+	"messagingClearActionDeadlines": "Fristen bei Bedarf angeben",
+	"messagingConferenceMessaging": "Konferenznachrichten",
+	"messagingDeliveryLog": "Zustellungsprotokoll",
+	"messagingDescription": "Erreiche Delegationen und Teilnehmende schnell. Verfasse Ankündigungen, verfolge die Zustellung und halte die Konferenz auf dem Laufenden.",
+	"messagingDisabledForAccount": "Messaging ist für dein Konto deaktiviert.",
+	"messagingEnableInSettings": "In den Einstellungen aktivieren",
+	"messagingGuidelineDeadlines": "Verwende klare Handlungsaufforderungen und Fristen, um Hin und Her zu reduzieren.",
+	"messagingGuidelineOptIn": "Sende nur an Empfänger*innen, die zugestimmt haben, und vermeide Duplikate.",
+	"messagingGuidelineShort": "Halte Betreffzeilen kurz und spezifisch, um die Sichtbarkeit zu verbessern.",
+	"messagingGuidelines": "Richtlinien",
+	"messagingKeepConcise": "Halte es prägnant und handlungsorientiert",
+	"messagingLogsStored": "Nachrichtenprotokolle werden zur Prüfung und Compliance gespeichert.",
+	"messagingMessageDetails": "Nachrichtendetails",
+	"messagingMessaging": "Nachrichten",
+	"messagingNewMessage": "Neue Nachricht",
+	"messagingNoEligibleRecipients": "Keine geeigneten Empfänger*innen gefunden",
+	"messagingNoReplyWarning": "Du kannst keine Antworten erhalten.",
+	"messagingOnlyEnabledUsers": "Nur Nutzer*innen, die Messaging aktiviert haben, werden in dieser Liste angezeigt",
+	"messagingOverview": "Übersicht",
+	"messagingQuickActions": "Schnellaktionen",
+	"messagingRecipientLabel": "Empfänger*in",
+	"messagingRecipientRequired": "Empfänger*in auswählen...",
+	"messagingSavedInHistory": "Diese Nachricht wird im Zustellungsverlauf gespeichert",
+	"messagingSelectRecipient": "Empfänger*in auswählen...",
+	"messagingSent": "Gesendet",
+	"messagingSentHistory": "Sendverlauf",
+	"messagingStartTargetedMessage": "Starte eine gezielte Nachricht an Delegationen, Gremien oder einzelne Teilnehmende.",
+	"messagingStatus": "Status",
+	"messagingTipSubjectLine": "Tipp: Verwende klare Betreffzeilen wie \"Gremienagenda-Sperrung - 18:00\", um die Rücklaufquote zu verbessern",
+	"messagingUnableToLoadRecipients": "Empfänger*in konnte nicht geladen werden",
+	"messagingVerifyRecipient": "Empfänger*in und Konferenz überprüfen",
 	"missingInformation": "Fehlende Informationen",
 	"motivation": "Motivation",
 	"myAccount": "Mein Konto",

messages/en.json

@@ -48,6 +48,7 @@
 	"allNations": "All Nations",
 	"allPiecesCollected": "All puzzle pieces have been collected!",
 	"allRightsReservedby": "All rights reserved by",
+	"allowDelegationMailer": "Allow delegation emails",
 	"alpha3Code": "ISO Alpha 3 Code",
 	"alphabetical": "alphabetical",
 	"alreadRegistered": "Already registered",
@@ -228,6 +229,8 @@
 	"committeesAndAgendaItems": "Committees and Agenda Items",
 	"committeesSucessfullyAssigned": "Committees successfully assigned",
 	"communication": "Communication",
+	"communicationPreferences": "Communication preferences",
+	"communicationPreferencesDescription": "Choose which updates you want to receive about your delegation.",
 	"compareVersion": "Compare with another version",
 	"compareVersions": "Compare Versions",
 	"complete": "complete",
@@ -556,6 +559,60 @@
 	"mediaConsentStatus": "Media Status",
 	"members": "Members",
 	"membersPerDelegation": "Seats per Delegation",
+	"messageCancelButton": "Cancel",
+	"messageCompose": "Compose",
+	"messageComposeAnnouncement": "Compose announcement",
+	"messageComposeMessage": "Compose Message",
+	"messageDraft": "Draft",
+	"messageDraftAMessage": "Draft a new message",
+	"messageHistory": "History",
+	"messageMessageBody": "Message",
+	"messageMessagePlaceholder": "Share key details, action items, and deadlines here...\n\nKeep it clear and concise. You can include links for additional information.",
+	"messageNoMessagesSent": "No messages sent yet. Send your first update from the compose page.",
+	"messageRecipient": "Recipient",
+	"messageRecipientNotEnabled": "Recipient has not enabled messaging.",
+	"messageReviewDeliveryStatus": "Review delivery status and message activity for this conference.",
+	"messageReviewSent": "Review sent",
+	"messageSendButton": "Send Message",
+	"messageSendToParticipants": "Send a message to conference participants",
+	"messageSent": "Message sent.",
+	"messageSentLog": "Sent log",
+	"messageStatusDelivered": "Delivered",
+	"messageSubject": "Subject",
+	"messageSubjectPlaceholder": "e.g., Committee agenda lock - 18:00 CET",
+	"messagingCenter": "Messaging Center",
+	"messagingCheckDeliveryStatus": "Check delivery status",
+	"messagingClearActionDeadlines": "Include deadlines when applicable",
+	"messagingConferenceMessaging": "Conference Messaging",
+	"messagingDeliveryLog": "Delivery log",
+	"messagingDescription": "Reach delegations and participants quickly. Compose announcements, track delivery, and keep the conference aligned.",
+	"messagingDisabledForAccount": "Messaging is disabled for your account.",
+	"messagingEnableInSettings": "Enable it in settings",
+	"messagingGuidelineDeadlines": "Use clear actions and deadlines to reduce back-and-forth.",
+	"messagingGuidelineOptIn": "Send only to opt-in recipients and avoid duplicates.",
+	"messagingGuidelineShort": "Keep subject lines short and specific to improve visibility.",
+	"messagingGuidelines": "Guidelines",
+	"messagingKeepConcise": "Keep it concise and actionable",
+	"messagingLogsStored": "Messaging logs are stored for auditing and compliance.",
+	"messagingMessageDetails": "Message Details",
+	"messagingMessaging": "Messaging",
+	"messagingNewMessage": "New message",
+	"messagingNoEligibleRecipients": "No eligible recipients found",
+	"messagingNoReplyWarning": "You cannot receive replies.",
+	"messagingOnlyEnabledUsers": "Only users who have enabled messaging will appear in this list",
+	"messagingOverview": "Overview",
+	"messagingQuickActions": "Quick actions",
+	"messagingRecipientLabel": "Recipient",
+	"messagingRecipientRequired": "Select a recipient...",
+	"messagingSavedInHistory": "This message will be saved in delivery history",
+	"messagingSelectRecipient": "Select a recipient...",
+	"messagingSent": "Sent",
+	"messagingSentHistory": "Sent history",
+	"messagingStartTargetedMessage": "Start a targeted message to delegations, committees, or individual participants.",
+	"messagingStatus": "Status",
+	"messagingTipSubjectLine": "Tip: Use clear subject lines like \"Committee agenda lock - 18:00\" to improve response rates",
+	"messagingUnableToLoadRecipients": "Unable to load recipient",
+	"messagingVerifyRecipient": "Verify recipient and conference",
 	"missingInformation": "Missing information",
 	"motivation": "Motivation",
 	"myAccount": "My Account",

prisma/migrations/20260111130406_schema_for_messages_between_delegates_in_conference/migration.sql

@@ -0,0 +1,30 @@
+-- CreateEnum
+CREATE TYPE "MessageStatus" AS ENUM ('SENT', 'FAILED', 'BLOCKED');
+
+-- AlterTable
+ALTER TABLE "User" ADD COLUMN     "canReceiveDelegationMail" BOOLEAN NOT NULL DEFAULT false;
+
+-- CreateTable
+CREATE TABLE "MessageAudit" (
+    "id" TEXT NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "subject" TEXT NOT NULL,
+    "body" TEXT NOT NULL,
+    "senderUserId" TEXT NOT NULL,
+    "recipientUserId" TEXT NOT NULL,
+    "conferenceId" TEXT NOT NULL,
+    "messageId" TEXT,
+    "status" "MessageStatus" NOT NULL DEFAULT 'SENT',
+
+    CONSTRAINT "MessageAudit_pkey" PRIMARY KEY ("id")
+);
+
+-- AddForeignKey
+ALTER TABLE "MessageAudit" ADD CONSTRAINT "MessageAudit_senderUserId_fkey" FOREIGN KEY ("senderUserId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "MessageAudit" ADD CONSTRAINT "MessageAudit_recipientUserId_fkey" FOREIGN KEY ("recipientUserId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "MessageAudit" ADD CONSTRAINT "MessageAudit_conferenceId_fkey" FOREIGN KEY ("conferenceId") REFERENCES "Conference"("id") ON DELETE CASCADE ON UPDATE CASCADE;

prisma/schema.prisma

@@ -86,8 +86,9 @@ model Conference {
   WaitingListEntry             WaitingListEntry[]
   papers                       Paper[]
 
-  createdAt DateTime @default(now())
-  updatedAt DateTime @default(now()) @updatedAt
+  createdAt     DateTime       @default(now())
+  updatedAt     DateTime       @default(now()) @updatedAt
+  messageAudits MessageAudit[]
 }
 
 /// A committee in a conference. E.g. the human rights council
@@ -188,6 +189,9 @@ model User {
   papers                        Paper[]
   paperReviews                  PaperReview[]
   reviewerSnippets              ReviewerSnippet[]
+  canReceiveDelegationMail      Boolean                             @default(false)
+  sentDelegationMessages        MessageAudit[]                      @relation("SentMessages")
+  receivedDelegationMessages    MessageAudit[]                      @relation("ReceivedMessages")
 
   createdAt DateTime @default(now())
   updatedAt DateTime @default(now()) @updatedAt
@@ -624,3 +628,34 @@ model TeamMember {
 
   @@unique([conferenceId, userId])
 }
+
+model MessageAudit {
+  id String @id @default(nanoid())
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @default(now()) @updatedAt
+
+  subject String
+  body    String
+
+  //tracibility
+  senderUserId String
+  senderUser   User   @relation("SentMessages", fields: [senderUserId], references: [id], onDelete: Cascade)
+
+  recipientUserId String
+  recipientUser   User   @relation("ReceivedMessages", fields: [recipientUserId], references: [id], onDelete: Cascade)
+
+  conferenceId String
+  conference   Conference @relation(fields: [conferenceId], references: [id], onDelete: Cascade)
+
+  // Technical meta-data
+  messageId String? // The ID from the email provider
+  status    MessageStatus @default(SENT)
+}
+
+/// Status for message audit entries
+enum MessageStatus {
+  SENT
+  FAILED
+  BLOCKED
+}

prisma/seed/dev/conferenceSupervisor.ts

@@ -4,14 +4,14 @@ import { faker } from '@faker-js/faker';
 export function makeSeedConferenceSupervisor(
 	options: Pick<ConferenceSupervisor, 'conferenceId' | 'userId'> &
 		Partial<{
-			delegations: { connect: { id: string }[] };
-			postAssignmentDelegeationMembers: { connect: { id: string }[] };
+			supervisedDelegationMembers: { connect: { id: string }[] };
 		}>
 ): ConferenceSupervisor {
 	return {
 		...options,
 		id: faker.database.mongodbObjectId(),
 		plansOwnAttendenceAtConference: faker.datatype.boolean(),
+		connectionCode: faker.string.numeric(6),
 		createdAt: faker.date.past(),
 		updatedAt: faker.date.past()
 	};