Personnel Directory

The Personnel Directory is the central registry for all employees tracked by the NISC Mustering System. It lets you search the employee list, manage records, assign BLE beacons to individuals, export data, and print ID badges.

---

Navigating to Personnel

1. Log in to the NISC Mustering System.
2. In the left navigation menu, click Personnel.
3. The Personnel Directory page loads, showing a summary of your workforce and a searchable list of all employees.

---

Understanding the Summary Cards

At the top of the page, three summary cards give you an at-a-glance count of your workforce:

Card	What it shows
Total Personnel	All registered employees
Active	Employees with an Active status
Inactive	Employees marked as Inactive

Tip: The counts update each time the page loads or you press the Refresh button. They reflect the current state of the registry, not live BLE presence.

---

Searching and Filtering

Global Search

1. In the toolbar, click the Search personnel... input box.
2. Type any part of a name, employee ID, department, or beacon MAC address.
3. The list filters in real time as you type.

Column-Level Filters (Table View)

When in Table view, each column header has a filter row beneath it:

• Beacon MAC — type a partial MAC address
• Employee ID — type the start of an ID number
• Name — type any part of a name
• Department — select a department from the dropdown
• Status — select Active, Inactive, or Suspended

Clearing Filters

Click the Clear Filters button (funnel with a slash icon) in the top-right of the toolbar to reset all search inputs at once.

---

Switching View Modes

The toolbar contains three view-mode buttons in the top right:

Button	Mode	Best for
Grid icon	Table	Sorting, filtering, bulk selection, large datasets
Card icon	Card	Browsing photos and quick status at a glance
List icon	List	Compact scrolling through many records

Click any mode button to switch. Your preference is saved between sessions.

Note: Bulk selection and per-column filters are only available in Table view.

---

Adding a New Employee

You need the Create permission for Personnel to see the Add Employee button.

1. Click Add Employee in the top-right of the page.
2. A form modal opens. Fill in the required fields:
   • Full name
   • Employee ID
   • Department
   • Job title
   • Email address
   • Phone number
3. Optionally fill in emergency contact details.
4. Click Save to create the record.

The new employee appears in the directory immediately. To assign a BLE beacon, edit the record after creation (see below).

---

Editing an Employee Record

You need the Update permission for Personnel to edit records.

From the directory list:

1. Locate the employee using search or scrolling.
2. Click the pencil (Edit) icon on their row.
3. The edit form modal opens with the current data pre-filled.
4. Make your changes and click Save.

From the detail page:

1. Click the employee's name to open their detail page.
2. Click Edit in the top-right of the detail page.
3. The inline edit form appears. Update any field and click Save.

---

Assigning a BLE Beacon

Each employee can be linked to one BLE beacon tag. The beacon MAC address is how the system tracks the employee's location on the floor plan.

1. Open the employee's edit form (see Editing above).
2. In the Beacon MAC field, enter the MAC address of the BLE tag being assigned to this employee (format: AA:BB:CC:DD:EE:FF).
3. Click Save.

Important: A BLE beacon MAC address can only be assigned to one person at a time. If the MAC is already in use, the system will warn you. Remove it from the current assignment before reassigning.

---

Bulk Editing

Bulk actions let you activate, deactivate, or delete multiple employees at once.

Bulk actions require the Bulk permission for Personnel and are only available in Table view.

1. Switch to Table view using the view toggle buttons.
2. Check the checkboxes on the left of each row you want to include. To select all visible rows, check the header checkbox.
3. A bulk-actions bar appears above the table showing how many records are selected:
   • Activate — sets selected employees to Active status
   • Deactivate — sets selected employees to Inactive status (requires confirmation)
   • Delete — permanently removes selected employees (requires confirmation)
4. Click the desired action button.
5. For Deactivate and Delete, a confirmation dialog appears. Click Yes to proceed.
6. Click the X button in the bulk-actions bar to clear your selection without taking action.

Warning: Bulk delete is permanent and cannot be undone. Double-check your selection before confirming.

---

Exporting Data

Four export options are available in the page header:

Button	What it produces
Export CSV	Downloads all personnel as a CSV file
Export PDF	Generates a landscape PDF report of all personnel
Export Selected	Downloads only the currently selected rows as CSV
Print Badges	Opens a print dialog with badge cards for selected employees

Exporting All Personnel

1. Click Export CSV or Export PDF in the header.
2. Your browser will download the file or open a print/save dialog.

The export includes: Beacon MAC, Employee ID, Name, Department, Status, and Last Seen.

Exporting Selected Employees

1. Switch to Table view and select the employees you want.
2. Click Export Selected to download a CSV of the selected rows only.

---

Printing Badges

Badges are printed for selected employees and include the employee's name, employee ID, department, and beacon MAC address.

1. Switch to Table view and select the employees whose badges you want to print.
2. Click Print Badges in the header.
3. A print-formatted page opens in a new browser window with one badge card per employee.
4. Use your browser's print dialog to send to a printer.

Tip: Badge cards are sized at 3.5 in x 2 in (standard credit-card width). For best results, use a printer that supports color and set page margins to minimum.

---

Refreshing the List

Click the Refresh button (circular arrow icon) in the toolbar to reload the personnel list from the server. A brief loading indicator appears during the refresh.

---

Personnel Detail Page

Click any employee's name in the directory to open their full detail page. This page shows:

Profile Information

Field	Description
Name	Full display name
Employee ID	Internal identifier
Department	Assigned department
Job Title	Role or position
Email	Work email address
Phone	Work phone number
Emergency Contact	Name and phone of emergency contact
Beacon MAC	Assigned BLE tag MAC address
Status	Active or Inactive

Screenshot placeholder: Personnel detail page — profile section

Location Information

Field	Description
Current Floor	The floor where the employee was last detected
Current Building	The building where they were last detected
Last Seen	How long ago the beacon was last heard
Battery Level	BLE beacon battery percentage (Critical / Low / Medium / Good)

Location History

Below the profile cards, a table shows the employee's recent movement history:

• Timestamp — date and time of the location event
• Floor — floor detected on
• Building — building detected in
• RSSI — signal strength at detection (lower negative numbers = closer to gateway)

Editing from the Detail Page

If you have edit permission, an Edit button appears in the top-right of the detail page. Click it to enter inline edit mode. All fields except Beacon MAC can be updated here. Click Save to confirm or Cancel to discard changes.

---

Mobile View

On phones and tablets, the Personnel Directory switches to a mobile-optimised layout:

• Summary chips at the top show total, active, and inactive counts.
• The employee list is displayed as scrollable cards.
• Tap any employee card to view their full details.
• An Add Employee button appears for users with create permission.
• A search bar lets you filter by name or type.

The detail view on mobile shows profile fields, location stats (floor, building, battery), and a compact location details section. Tap the back arrow to return to the list.

---

Permission Summary

Action	Required Permission
View directory	Personnel: Read
Add employee	Personnel: Create
Edit employee	Personnel: Update
Delete employee	Personnel: Delete
Bulk activate/deactivate/delete	Personnel: Bulk

Contact your system administrator if a button you expect to see is missing.