Admin: People

The People tab manages the two core human-record types in the mustering system:

• Personnel — the employees and visitors being tracked and mustered
• Departments — organisational units that group personnel together

Navigate to Admin > People and use the sub-tabs (Personnel / Departments) to switch between sections.

Note: User account management (login accounts for system operators) has moved to the System tab. See System Settings for details.

---

Personnel

Personnel records represent the people being tracked and mustered — employees, contractors, or visitors who carry BLE beacons. Personnel are distinct from user accounts: a person can have a personnel record without a system login.

Screenshot placeholder: [Personnel table with employee ID, name, department, beacon MAC, status, and action buttons]

Viewing Personnel

The Personnel list shows:

Column	Description
Employee	Avatar, employee ID, name, and job title
Department	Assigned department
Beacon	The BLE beacon MAC address assigned to this person
Status	Active or Inactive
Actions	Edit, Onboard Device, Delete

Use the search bar to filter by name, employee ID, email, or department. The statistics cards at the top show total, active, inactive, and beacon-assigned counts.

Creating a Personnel Record

1. Click Add Personnel.
2. In the dialog, fill in the Identity section:
   • Employee ID (required) — unique identifier (e.g. EMP-001)
   • Full Name (required)
   • Email (optional)
   • Job Title (optional)
   • Phone Number (optional)
   • Department — select from the department dropdown
   • Active toggle
3. In the Beacon Assignment section:
   • Beacon MAC — select an unassigned beacon from the dropdown, or type the MAC address directly. Only beacons registered in the beacon registry appear here.
4. In the Emergency Contact section (optional):
   • Emergency contact name and phone number
   • Special needs notes (mobility, medical requirements relevant to mustering)
5. Click Add Personnel.

Tip: If the person's beacon is not yet registered, create the beacon first in Devices > Beacons, then return here to assign it. Alternatively, use the Onboard Device button after saving the record.

Editing a Personnel Record

1. Click the pencil (Edit) icon on the personnel row.
2. Update any fields as needed.
3. To reassign a beacon, select a different beacon from the Beacon MAC dropdown. The previous beacon is released and becomes available for reassignment.
4. Click Save Changes.

Onboarding a Beacon via BLE Scanner

If a person's beacon needs to be paired using the BLE scanner workflow:

1. Click the Onboard Device button (Bluetooth icon) on the personnel row, or within the Edit dialog.
2. You are redirected to the BLE Scanner page with the employee's details pre-filled.
3. Follow the on-screen instructions to scan and register the beacon.
4. After successful onboarding you are returned to the personnel list with the beacon assigned.

Deleting a Personnel Record

1. Click the Delete (trash) icon on the personnel row.
2. Confirm the deletion in the dialog.
3. The personnel record is removed. Any beacon previously assigned to this person is released back to the unassigned pool.

Warning: Deleting a personnel record also removes their position history and muster associations. This cannot be undone. Consider setting the record to Inactive instead if you want to retain historical data.

---

Departments

Departments are organisational units that group personnel together. Each department can have a name, a short code, and an optional manager assignment. Departments appear in personnel records, muster reports, and the floorplan view.

Screenshot placeholder: [Departments table showing department name, code, manager, and employee count badges]

Viewing Departments

The table shows each department with:

• Department name and abbreviated code (e.g. "Engineering / ENG")
• Assigned manager name and email
• Employee count (total / active)

The statistics cards at the top show: total departments, total employees across all departments, active employees, and departments that have a manager assigned.

Creating a Department

1. Click Add Department.
2. In the dialog, fill in:
   • Department Name (required) — e.g. Engineering
   • Department Code (required) — short abbreviation, e.g. ENG
   • Manager Name (optional) — the name of the responsible manager
   • Manager Email (optional) — must be a valid email if provided
3. Click Add Department.

Editing a Department

1. Click the pencil (Edit) icon on the department row.
2. Update the name, code, or manager details.
3. Click Save Changes.

Note: Changing a department code does not affect personnel already assigned to that department — they remain linked by the internal department ID.

Deleting a Department

1. Click the Delete (trash) icon on the department row.
2. If the department has employees assigned to it, the confirmation dialog warns you of this.
3. Confirm the deletion.
4. The department is removed. Personnel who were in this department will have their department field cleared.

Tip: Before deleting a department, reassign its personnel to another department to avoid orphaned records.

Exporting Departments

Click the Export button above the table to download a CSV containing department name, code, manager name, manager email, employee count, and active employee count.