Skip to main content
Source snapshot: 13 October 2026. These pages describe the current implementation, including unfinished controls. See coverage and review notes.

Notification settings

Host: admin.<ROOT_DOMAIN> · Route: /[tenant]/settings/notifications

Purpose and access

Configure service/dues alerts, event reminders, and SMS-provider metadata.You need an account session and a resolved membership context in the selected Mahallu (including the API’s current platform elevation path). The API independently checks the requested operation’s permissions and feature availability.

Screen layout

The form has new-service-request and new-dues switches, event reminder days, SMS enablement, provider, and sender ID. Unsaved changes expose a save/reset bar.

Fields and displayed information

Fields and filters: Notification settings form

Actions

Interaction sequence

Change settings → review the unsaved-changes bar → save → patch notification settings and refresh; reset discards local edits.

States and rules

Saving provider metadata is not proof of SMS delivery integration. The route has a denied settings.view state. Numeric reminder values are checked by the form before submission.The rendered action controls bind loading indicators to pending state. Failed API saves keep their documented error/notification path; a loading indicator alone does not establish persistence.

Implementation references

Paths below are relative to the application repository. This is source-reviewed behavior, not a recorded browser test.
  • apps/web/src/app/sites/admin/[tenant]/settings/notifications/page.tsx
  • apps/web/src/features/tenants/notification-settings-form.tsx
  • apps/web/src/features/settings/unsaved-changes-bar.tsx
Data and access helpers: apps/web/src/lib/session.ts, apps/web/src/lib/server-api.ts, apps/web/src/lib/tenants.ts, apps/web/src/lib/notifications.ts, apps/web/src/lib/api-client.ts

API behavior references

  • apps/api/src/tenants/admins.controller.ts
  • apps/api/src/tenants/roles.controller.ts
  • apps/api/src/tenants/tenants.controller.ts
  • apps/api/src/structure/structure.controller.ts
  • apps/api/src/notifications/notifications.controller.ts
  • apps/api/src/finance/finance.controller.ts