Push Notification Service - Meander - Peer Mentor Platform

Description

Backend Next.js service that dispatches push notifications to user devices via the FCM HTTP v1 API. Constructs typed action payloads for Flutter deep-link routing, applies per-tenant organization label overrides to notification content, and persists notification records to the database for inbox retrieval.

Feature: Push Notifications

push-notification-service

Responsibilities

Dispatch push notifications via FCM HTTP v1 API to one or multiple devices
Construct typed action payloads so the Flutter client can deep-link to the correct screen
Apply organization label overrides to notification display strings via the labels system
Persist notification records to the notifications table after dispatch
Log delivery status and classify token invalidation errors for cleanup

Interfaces

sendNotification(userId, type, payload)

sendBulkNotifications(userIds, type, payload)

sendToDevice(token, notification, data)

getDeliveryStatus(notificationId)

resolveOrganizationLabels(organizationId, content)

Relationships

Dependencies (3)

Components this component depends on

infrastructure FCM Integration data Notifications Table data Push Tokens Table

Dependents (6)

Components that depend on this component

ui Notification Inbox Screen ui Course Sign-up Screen service Course Service infrastructure Enrollment Reminder Scheduler service Certificate Expiry Background Job service Expense Approval Service

Related Data Entities (12)

Data entities managed by this component

Assignment 19 fields core Confidentiality Declaration 17 fields core Course 20 fields core Course Enrollment 15 fields core Event 18 fields core Event Participant 14 fields core Notification 18 fields core Notification Settings 16 fields configuration Organization Membership 18 fields core User 24 fields core User Achievement 13 fields core User Role 13 fields core