As a Super Admin,

I want to quickly search and filter Countries and Cities,

So that I can easily find and manage destination records without browsing the entire list.

---

Business Background¶

As the number of Countries and Cities grows, manually locating a destination becomes time-consuming. Search and filter options should help administrators quickly find the required records.

---

Functional Requirements¶

1. Search Countries¶

The system shall provide a search box above the Country list.

The Super Admin shall be able to search using:

• Country Name

The search shall update the displayed list as the user types.

Search shall not be case-sensitive.

Leading and trailing spaces shall be ignored.

---

2. Search Cities¶

The system shall provide a search box above the City list.

The Super Admin shall be able to search using:

• City Name

The search shall not be case-sensitive.

Leading and trailing spaces shall be ignored.

---

3. Filter Countries¶

The system shall allow filtering Countries by:

• Active
• Inactive
• All (Default)

Only matching Countries shall be displayed.

---

4. Filter Cities¶

The system shall allow filtering Cities by:

• Active
• Inactive
• All (Default)

---

5. Combined Search & Filter¶

The search and filter options shall work together.

Example:

Search

Dubai

Status

Active

Result

Only Active Cities named Dubai shall be displayed.

---

6. Clear Search¶

The search field shall include a clear option.

When cleared,

The complete list shall be displayed.

---

7. Reset Filters¶

The system shall provide a Reset Filters button.

When selected,

• Search text is cleared.
• Status filter resets to All.
• Complete list is displayed.

---

8. No Search Results¶

If no matching records are found,

Display

No matching records found.

Display a secondary message

Try changing your search or filter criteria.

---

9. Empty List¶

If no Countries or Cities have been created,

Display

No records available.

---

User Messages¶

No Results¶

No matching records found.

Try changing your search or filter criteria.

---

Empty List¶

No records available.

---

Acceptance Criteria¶

Scenario 1¶

Given multiple Countries exist,

When the administrator searches by Country Name,

Then only matching Countries shall be displayed.

---

Scenario 2¶

Given multiple Cities exist,

When the administrator searches by City Name,

Then only matching Cities shall be displayed.

---

Scenario 3¶

Given Active and Inactive records exist,

When the administrator selects Active,

Then only Active records shall be displayed.

---

Scenario 4¶

Given both search and filter are applied,

When matching records exist,

Then only records satisfying both conditions shall be displayed.

---

Scenario 5¶

Given no matching records exist,

When searching,

Then display

No matching records found.

---

In Scope¶

• Search Countries
• Search Cities
• Status Filters
• Reset Filters
• Clear Search
• Combined Search & Filter
• Empty State

---

Out of Scope¶

• Advanced Search
• Saved Filters
• Sorting
• Bulk Actions
• Export Search Results

---