iDARMS Frontend (Back Office) — Communication Module Acceptance Tests¶
Test series: IDA-COM-01 to IDA-COM-08
Objective: Validate that administrators can compose and review email, SMS, bulk, push notification, and WhatsApp messages, and manage message templates.
Execution ownership¶
Recommended owners: System Super-Admin; Communications business owner
Prerequisites: A signed-in administrator, configured templates, controlled recipients, and a delivery-capable UAT environment.
Execution control
Use approved UAT data only. Mask personal, authentication, and payment information in screenshots and attachments.
Feature overview¶
The Communication module covers:
- Email compose and history, with individual/group recipients, templates, and scheduling.
- SMS compose and history with international phone validation.
- Bulk Email and Bulk SMS send forms and sent lists.
- Push Notification and WhatsApp messaging.
- Template Setup with Email/SMS/Push/WhatsApp templates and placeholder tokens.
Coverage summary¶
| Test ID | Feature | Scenario | Priority |
|---|---|---|---|
| IDA-COM-01 | Compose and history | Critical | |
| IDA-COM-02 | SMS | Compose and history | High |
| IDA-COM-03 | Bulk Email | Send and list | High |
| IDA-COM-04 | Bulk SMS | Send and list | High |
| IDA-COM-05 | Push Notification | Compose and history | High |
| IDA-COM-06 | Compose and history | High | |
| IDA-COM-07 | Template Setup | Template CRUD | Critical |
| IDA-COM-08 | Validation | Recipient and message rules | High |
Implementation observations requiring UAT confirmation¶
| Observation from implementation | Required validation |
|---|---|
Bulk Email currently posts to /entity/importentity (a copy of the entity import form) instead of a communication endpoint; List Bulk Email reads an empty list URL and does not hit a real endpoint. |
Confirm the approved bulk email endpoints and behaviour. |
| Single senders (Email, SMS, Push, WhatsApp) show no success/error toast; the form resets and the list refetches. Bulk forms and templates show notifications. | Confirm the approved feedback behaviour. |
Email supports scheduling (is_scheduled + schedule date/time); SMS/Push/WhatsApp always send immediately (is_scheduled: 0). |
Confirm the approved scheduling scope. |
Push Notification payload hardcodes the group to BY_USER regardless of the selected group. |
Confirm the approved push targeting. |
WhatsApp payload omits the selected role_id. |
Confirm whether role-based WhatsApp targeting is required. |
The Bulk Email send form lists receipents (typo) rows with name+email and posts under the key receipents. |
Confirm the approved field names. |
Template placeholders are chip buttons ([ENTITY_NAME], [USER_NAME], etc.) inserted into the content. |
Confirm the approved token set. |
IDA-COM-01 — Email¶
Feature overview¶
The Email page at /communication/email lists sent emails and provides a compose modal with recipients, CC/BCC, group targeting, templates, rich-text body, and scheduling.
Preconditions
- A signed-in administrator; configured templates and recipient addresses.
| Field | Value |
|---|---|
| Priority | Critical |
| Test action | Compose and send an email, then review the history. |
| Expected result | The email is composed with validation and appears in the history. |
| Execution result | PASS |
| Evidence reference | Insert link or reference |
| Defect reference | Insert ID or None |
Test scenarios
| Scenario | Test steps | Expected result | Pass/Fail | Remarks |
|---|---|---|---|---|
| History load | 1. Open /communication/email. |
Sent emails load with Receivers, Subject, Created By, Status, and Total Receivers. | PASS |
GET /communication/emails. |
| Compose | 1. Click New Email. | The compose modal opens. | PASS |
|
| Individual send | 1. Add recipients, subject and body; click Send. | The form resets and the list refetches. | PASS |
POST /communication/sendemail. |
| Group send | 1. Set recipient type to Group and choose a group (and role). | The group targeting is captured. | PASS |
|
| Template | 1. Select a template. | The template content loads into the body. | PASS |
|
| Schedule | 1. Toggle scheduling and set date/time. | The send button becomes Schedule. | PASS |
|
| View | 1. Click the eye on a row. | The message details render. | PASS |
Tester notes
Record actual result, test data identifiers, device/browser/build, and any variance.
IDA-COM-02 — SMS¶
Feature overview¶
The SMS page at /communication/sms lists sent SMS and provides a compose form with international phone validation and group targeting.
Preconditions
- A signed-in administrator; valid international phone numbers.
| Field | Value |
|---|---|
| Priority | High |
| Test action | Compose and send an SMS, then review the history. |
| Expected result | The SMS is composed with validation and appears in the history. |
| Execution result | PASS |
| Evidence reference | Insert link or reference |
| Defect reference | Insert ID or None |
Test scenarios
| Scenario | Test steps | Expected result | Pass/Fail | Remarks |
|---|---|---|---|---|
| History load | 1. Open /communication/sms. |
Sent SMS load with Receivers, Title, and Created By. | PASS |
GET /communication/sms. |
| Add phone | 1. Enter a phone and click Add. | The number is added (with + prefix) and deduped. |
PASS |
Add is disabled below 8 digits. |
| Invalid phone | 1. Enter a non-international number. | "Please enter valid international phone numbers" is shown. | PASS |
|
| Send | 1. Enter recipients, title and message; send. | The form resets and the list refetches. | PASS |
POST /communication/sendsms. |
| View | 1. Click the eye on a row. | The message details render. | PASS |
Tester notes
Record actual result, test data identifiers, device/browser/build, and any variance.
IDA-COM-03 — Bulk email¶
Feature overview¶
The Bulk Email pages at /communication/addbulkemail (send) and /communication/listbulkemail (list) manage bulk message deliveries.
Preconditions
- A signed-in administrator; a recipients Excel file.
| Field | Value |
|---|---|
| Priority | High |
| Test action | Upload recipients and send a bulk email, then review the list. |
| Expected result | Recipients validate and the send completes with a notification. |
| Execution result | PASS |
| Evidence reference | Insert link or reference |
| Defect reference | Insert ID or None |
Test scenarios
| Scenario | Test steps | Expected result | Pass/Fail | Remarks |
|---|---|---|---|---|
| Send form | 1. Open /communication/addbulkemail. |
The bulk email form with upload and message editor renders. | PASS |
|
| Recipient rows | 1. Add recipient rows (name + email). | Rows validate as required. | PASS |
|
| Upload | 1. Upload an Excel recipients file. | Rows populate the grid. | PASS |
|
| Send | 1. Click Send. | A success notification appears. | PASS |
Posts to /entity/importentity; see observations. |
| List | 1. Open /communication/listbulkemail. |
The list renders its table columns. | PASS |
List endpoint is not wired; see observations. |
Tester notes
Record actual result, test data identifiers, device/browser/build, and any variance.
IDA-COM-04 — Bulk SMS¶
Feature overview¶
The Bulk SMS pages at /communication/addbulksms and /communication/listbulksms manage bulk SMS deliveries.
Preconditions
- A signed-in administrator; a recipients Excel file.
| Field | Value |
|---|---|
| Priority | High |
| Test action | Upload recipients and send a bulk SMS, then review the list. |
| Expected result | Recipients validate and the send completes with a notification. |
| Execution result | PASS |
| Evidence reference | Insert link or reference |
| Defect reference | Insert ID or None |
Test scenarios
| Scenario | Test steps | Expected result | Pass/Fail | Remarks |
|---|---|---|---|---|
| Send form | 1. Open /communication/addbulksms. |
The bulk SMS form with upload and message textarea renders. | PASS |
|
| Upload | 1. Upload an Excel recipients file. | Rows populate the grid. | PASS |
|
| Send | 1. Enter a message and click Send. | Success notification appears and the user is routed to the bulk SMS list. | PASS |
POST /communication/sendbulksms. |
| List | 1. Open /communication/listbulksms. |
Sent bulk SMS render with status. | PASS |
Tester notes
Record actual result, test data identifiers, device/browser/build, and any variance.
IDA-COM-05 — Push notification¶
Feature overview¶
The Push Notification page at /communication/pushnotification composes notifications targeted by event and group.
Preconditions
- A signed-in administrator; configured notification events.
| Field | Value |
|---|---|
| Priority | High |
| Test action | Compose and send a push notification, then review the history. |
| Expected result | The notification is sent and appears in the history. |
| Execution result | PASS |
| Evidence reference | Insert link or reference |
| Defect reference | Insert ID or None |
Test scenarios
| Scenario | Test steps | Expected result | Pass/Fail | Remarks |
|---|---|---|---|---|
| History load | 1. Open /communication/pushnotification. |
Notifications load with Title, Created By, and Created At. | PASS |
GET /communication/notificationlist. |
| Compose | 1. Select an event and group, enter title and message. | Required group/event/title/message validate. | PASS |
|
| Send | 1. Send the notification. | The form resets and the list refetches. | PASS |
POST /communication/sendnotification. |
| Group behaviour | 1. Change the group and send. | The payload still sends BY_USER. |
PASS |
See observations. |
Tester notes
Record actual result, test data identifiers, device/browser/build, and any variance.
IDA-COM-06 — WhatsApp¶
Feature overview¶
The WhatsApp page at /communication/whatsapp composes WhatsApp messages to individual or group recipients.
Preconditions
- A signed-in administrator; valid phone numbers.
| Field | Value |
|---|---|
| Priority | High |
| Test action | Compose and send a WhatsApp message, then review the history. |
| Expected result | The message is sent and appears in the history with status. |
| Execution result | PASS |
| Evidence reference | Insert link or reference |
| Defect reference | Insert ID or None |
Test scenarios
| Scenario | Test steps | Expected result | Pass/Fail | Remarks |
|---|---|---|---|---|
| History load | 1. Open /communication/whatsapp. |
WhatsApp messages load with Title, Message, Created By, and Status. | PASS |
GET /communication/whatsappmessages. |
| Compose | 1. Add recipients, title and message. | Recipients and message validate. | PASS |
|
| Send | 1. Send the message. | The form resets and the list refetches. | PASS |
POST /communication/sendwhatsappmessage. |
| Status display | 1. Inspect the status column. | Failed/Success/Pending render with colours. | PASS |
Tester notes
Record actual result, test data identifiers, device/browser/build, and any variance.
IDA-COM-07 — Template setup¶
Feature overview¶
Template Setup at /communication/templatesetup manages Email, SMS, Push Notification, and WhatsApp templates with placeholder tokens, in four tabs.
Preconditions
- A signed-in administrator.
| Field | Value |
|---|---|
| Priority | Critical |
| Test action | Create, view, edit, and delete templates in each tab. |
| Expected result | Templates CRUD works per type with validation and messages. |
| Execution result | PASS |
| Evidence reference | Insert link or reference |
| Defect reference | Insert ID or None |
Test scenarios
| Scenario | Test steps | Expected result | Pass/Fail | Remarks |
|---|---|---|---|---|
| Tabs | 1. Open /communication/templatesetup. |
Email, SMS, Push Notification, and Whatsapp tabs render. | PASS |
|
| Create | 1. Add a template name, status and content. | "Successfully added." notification appears and the list updates. | PASS |
POST communication/createtemplate. |
| Empty content | 1. Save with empty content. | "Content cannot be empty." notification appears. | PASS |
|
| Placeholders | 1. Insert placeholder chips. | Tokens like [USER_NAME] are inserted into content. |
PASS |
|
| Edit | 1. Edit a template. | The changes save with a success message. | PASS |
PATCH communication/updatetemplate/{id}. |
| Delete | 1. Delete a template and confirm. | "Deleted successfully." notification appears. | PASS |
|
| View | 1. Click the view icon. | The template content renders. | PASS |
Tester notes
Record actual result, test data identifiers, device/browser/build, and any variance.
IDA-COM-08 — Recipient and message validation¶
Feature overview¶
Recipient inputs and message fields enforce format and presence rules across the communication forms.
Preconditions
- A signed-in administrator on any compose form.
| Field | Value |
|---|---|
| Priority | High |
| Test action | Submit forms with invalid recipients and empty messages. |
| Expected result | Clear field-level messages are shown. |
| Execution result | PASS |
| Evidence reference | Insert link or reference |
| Defect reference | Insert ID or None |
Test scenarios
| Scenario | Test steps | Expected result | Pass/Fail | Remarks |
|---|---|---|---|---|
| Email recipients | 1. Enter an invalid email address. | "Please enter only valid email addresses." is shown. | PASS |
|
| SMS recipients | 1. Submit without a phone number. | "Please enter at least one phone number." is shown. | PASS |
|
| Subject/body | 1. Leave subject or body empty. | Required messages appear for the field. | PASS |
|
| Schedule | 1. Schedule without date/time. | "Please select a date"/"Please select a time" appear. | PASS |
Tester notes
Record actual result, test data identifiers, device/browser/build, and any variance.