User Story #925
openEPIC #670: Package Catalogue Management - 2 days front end and 2 days backend
Feature #924: Halal Facilities Management
frontend configure halal-related facilities
0%
Description
As a Super Admin, I want to configure halal-related facilities for each travel package so that Muslim travellers can easily identify packages that meet their religious and lifestyle requirements.
Business Background¶
Halal-friendly travel is the primary differentiator of Halal Travels Club. Every package should clearly indicate the halal facilities available at the destination or within the package. This information enables customers to make informed travel decisions and improves trust in the platform.
For the MVP, only the most commonly requested halal facilities will be managed. Additional facility types and certifications can be introduced in later releases.
Business Objective¶
Allow administrators to:
- Configure halal facilities for a package.
- Maintain consistent halal information.
- Display halal features on the customer package details page.
- Ensure mandatory halal information is available before publishing.
Preconditions¶
- User is authenticated.
- User has Package Management permission.
- Package exists.
- Package is in Draft or Editable status.
Screen Name¶
Manage Halal Facilities
Accessible from:
Package Details → Halal Facilities
UI Components Inventory¶
| Component | Description |
|---|---|
| Halal Facilities Form | Configure halal-related information |
| Toggle Controls | Enable/Disable facility availability |
| Text Area | Additional halal notes |
| Save Button | Save configuration |
| Cancel Button | Return without saving |
Screen Layout¶
Section 1 – Core Halal Facilities¶
Administrator shall configure the following:
- Halal Food Available
- Prayer Facility Available
- Nearby Mosque Available
- Alcohol-Free Environment
Each field shall be displayed as:
- Yes
- No
(using Toggle Switch or Radio Button)
Section 2 – Additional Notes¶
Field
Additional Halal Information
Example
Prayer room available in hotel lobby.
Halal restaurants located within walking distance.
Maximum Length
1000 characters
User Interface Behaviour¶
- Existing values shall be preloaded.
- Toggle changes are immediately visible.
- Notes support multi-line text.
- Unsaved changes warning displayed before leaving.
- Read-only mode when user lacks edit permission.
Validation Rules¶
| Field | Validation |
|---|---|
| Halal Food | Required |
| Prayer Facility | Required |
| Mosque Nearby | Required |
| Alcohol-Free | Required |
| Additional Notes | Maximum 1000 characters |
Button Actions¶
Save¶
- Validate mandatory fields.
- Save configuration.
- Display success message.
Save & Continue¶
- Save current information.
- Navigate back to Package Details.
Cancel¶
- Prompt confirmation if unsaved changes exist.
Business Rules Matrix¶
| Rule | Behaviour |
|---|---|
| Every package | Must have halal configuration |
| Boolean values | Yes/No only |
| Notes | Optional |
| Draft package | Can be edited |
| Published package | Changes follow publish workflow |
Analytics & Tracking Events¶
| Event | Trigger |
|---|---|
| Halal Facilities Opened | Screen opened |
| Halal Facilities Updated | Save successful |
| Halal Notes Updated | Notes modified |
Responsive Behaviour¶
Desktop
- Two-column layout.
Tablet
- Single-column grouped layout.
Mobile
- Vertical responsive layout.
Accessibility¶
- Keyboard accessible.
- Screen-reader labels.
- Visible focus indicators.
- Accessible toggle controls.
Success Messages¶
| Scenario | Message |
|---|---|
| Save | Halal facilities updated successfully. |
User-facing Error Messages¶
| Scenario | Message |
|---|---|
| Mandatory value missing | Please complete all required halal facility information. |
| Save failed | Unable to save halal facilities. Please try again. |
Acceptance Criteria¶
AC-1¶
Given an editable package
When the Halal Facilities page is opened
Then the current halal information shall be displayed.
AC-2¶
Given required fields are completed
When Save is selected
Then the halal facilities shall be updated successfully.
AC-3¶
Given the user leaves the page with unsaved changes
When Cancel is selected
Then a confirmation dialog shall be displayed.
AC-4¶
Given the package is viewed by customers
When halal information exists
Then the configured facilities shall be displayed on the package details page.
In Scope¶
- Configure halal facilities
- Additional halal notes
- Validation
- Save and update
- Customer display
Out of Scope (MVP)¶
- Halal certificate upload
- Women-only facilities
- Qibla direction
- Ramadan services
- Facility ratings
- Third-party halal verification
Dependencies¶
- Package Master
- Package Details
- Customer Package Details
Edge Cases¶
- Package published while editing.
- Session timeout.
- Concurrent administrator updates.
- Long notes reaching maximum length.
Definition of Done¶
- Halal facilities configurable.
- Validation completed.
- Customer display verified.
- Acceptance criteria passed.
- Product Owner approval obtained.
No data to display