🏠 Overview › 🎯 Features ›🎯 Notification Scenarios

Notification Scenarios

Feature Detail

medium complexity extracted Notifications Confidence: 100%
2
Components
2
Shared
0
User Stories
Yes
Analyzed

Description

Notification Scenarios is a server-side configuration system that defines named, parameterized notification triggers (e.g. new-assignment, expense-approved, certificate-expiring, 10-day-assignment-followup). Each scenario specifies channels (push/email/SMS), recipient role rules, message templates, throttling, and per-organization overrides. Organization admins can enable, disable, and tune scenarios from the admin portal without code changes, matching HLF's stated need for scenario-based push messaging.

Sources & reasoning

HLF explicitly requests 'scenariobaserte push-meldinger' (line 74) and Blindeforbundet requires the 10-day automated reminder (line 57). Both demand a configurable scenario engine rather than hard-coded triggers. Belongs in Core Product alongside the channels that deliver it.

  • Oppfølging av likepersoner: 40 % var ikke fornøyd med oppfølgingen i spørreundersøkelse. Scenariobaserte push-meldinger og kalendersynkronisering.
  • Automatisk pĂĄminnelse etter 10 dager dersom kontakt ikke er opprettet.

Analysis

Business Value

HLF explicitly identifies scenario-based push as a follow-up tool after 40% of likepersoner reported dissatisfaction with current follow-up. Blindeforbundet needs an automatic 10-day reminder when assignment contact has not been made. Without a configurable scenario layer, each new trigger requires a code release - blocking the rapid iteration the four organizations need during pilot. Centralizing scenarios also lets each tenant tune frequency to match their volunteer culture, avoiding notification fatigue that would push users to disable notifications entirely.

Implementation Notes

Scenarios are persisted in a notification_scenarios table keyed by organization with a YAML-like definition (trigger event, audience predicate, channel set, template ref, throttle window). A Scenario Config Service evaluates incoming domain events (activity logged, assignment dispatched, certificate expiring) against active scenarios and enqueues notification jobs. The admin Scenario Config UI lives under Organization Management → Notifications. Per-tenant overrides extend platform defaults rather than replacing them. Scheduling for time-based triggers (10-day reminder, certificate expiry) reuses the same job scheduler as Certificate Reminder Service to avoid duplicate cron infrastructure.

Quality Assurance

Organization Administrator (primary) · Global Administrator (support access, same flow)
1
Scenarios
5
UAT Steps
13
A11y Annotations
3
Role Boundaries
Organization Administrator

Organization Administrator

Quick UAT

  1. Logg inn i Admin-portalen som Organisasjonsadministrator og åpne Organisasjon → Varslingsscenarier.
  2. Trykk Nytt scenario, velg utløser 'Ny aktivitet til godkjenning' og mal 'Aktivitet venter på godkjenning'.
  3. Velg kanaler Push og E-post, og mĂĄlgruppe Koordinator.
  4. Trykk Lagre og bekreft at scenariet vises i listen som Aktivt.
  5. Trykk Deaktiver pĂĄ samme rad og bekreft at status endres til Inaktiv.

Quick UAT — Accessibility

  1. Logg inn i Admin-portalen som Organisasjonsadministrator og åpne Organisasjon → Varslingsscenarier.
    • Screen reader Sideoverskrift 'Varslingsscenarier' annonseres; tabell annonseres med antall rader.
    • Keyboard / focus Tab-rekkefølge: hovedmeny → undermeny → 'Nytt scenario'-knapp → tabell.
    • Focus visibility Synlig fokusring pĂĄ alle interaktive elementer; sidemeny-element markert som aktivt.
  2. Trykk Nytt scenario, velg utløser 'Ny aktivitet til godkjenning' og mal 'Aktivitet venter på godkjenning'.
    • Screen reader Dialog/skjema annonseres; nedtrekksfelt leses opp med tilgjengelige valg.
    • Keyboard / focus Nedtrekksvelgere ĂĄpnes med Enter/Mellomrom; piltaster navigerer alternativer.
    • Focus visibility Fokus flyttes inn i dialogen og fanges der til Lagre eller Avbryt.
  3. Velg kanaler Push og E-post, og mĂĄlgruppe Koordinator.
    • Keyboard / focus Avkrysningsbokser nĂĄs med Tab; Mellomrom veksler tilstand.
    • Touch target Avkrysningsbokser og etiketter er ≥ 24Ă—24 CSS-piksler i klikkbart omrĂĄde.
    • Contrast Valgt tilstand er markert med bĂĄde hake og tekst, ikke kun farge (4.5:1 kontrast).
  4. Trykk Lagre og bekreft at scenariet vises i listen som Aktivt.
    • Focus visibility Fokus returnerer til den nye raden i tabellen etter lukking av dialog.
    • Live region 'Scenario lagret. Aktivt.' annonseres via polite live region.
  5. Trykk Deaktiver pĂĄ samme rad og bekreft at status endres til Inaktiv.
    • Live region 'Scenario deaktivert. Status: Inaktiv.' annonseres via polite live region.
    • Contrast Statusbadge bruker tekst (Aktiv/Inaktiv) i tillegg til farge.

Role Boundaries

3 role(s) must NOT access this feature
  • Peer Mentor (Likeperson)

    Varslingsscenarier finnes ikke i mobilappens navigasjon; deep-link til admin-URL returnerer 403.

  • Coordinator (Koordinator)

    Koordinator mottar varsler men har ingen tilgang til scenario-konfigurasjon; skjerm ikke i navigasjon, deep-link returnerer 403.

  • Prospective Buyer

    Salgsnettstedet har ingen pĂĄlogging; ingen tilgang til varslingsscenarier overhodet.

Expected End State

Et nytt varslingsscenario er lagret i organisasjonens Scenario Store med utløser, mal, kanaler og målgruppe, og kan aktiveres/deaktiveres uten kodeendring; deaktivering stopper umiddelbart utsending av varsler tilknyttet utløseren.

Components (4)

Service Layer (1)

service Scenario Config Service medium

Data Layer (1)

data Scenario Store medium

Shared Components

These components are reused across multiple features

User Stories

No user stories have been generated for this feature yet.