How Staff Attendance Works in Plinth (Step by Step)

How staff attendance works in Plinth

Admins maintain one staff roster, mark today's attendance, export monthly reports, and guards mark in/out at the gate — all on the same audited roster.

Step 1: Build the staff roster

1. Open Admin → Helpdesk → Staff & vendors (/admin/helpdesk/staff).
2. On the Staff tab, add each team member: name, optional phone, role, and optional department.
3. Supported roles: facility manager, security supervisor, guard, housekeeping manager, housekeeping, technician, accountant, and general.
4. Active staff appear in helpdesk Assign dropdowns and on the attendance board.

The roster is shared — you do not maintain separate lists for helpdesk and attendance.

Step 2: Mark today's attendance (admin)

1. Open Admin → Staff attendance (/admin/staff-attendance).
2. On the Today tab, review active staff for today's date.
3. For each person, tap: Present, Absent, In, or Out.
4. Each mark calls mark_staff_attendance — one summary row per staff per day, plus an append-only attendance log entry.

Step 3: Guards mark in/out at gate

1. Open Gate desk (/admin/gate) → Society staff tab.
2. Tap In or Out for guards and housekeeping on duty.
3. Gate marks use the same RPC with source gate — visible on the admin board immediately.

Guard guide

Step 4: Reports, payroll period, and export

1. On Staff attendance, open Reports.
2. Pick a date range or tap This payroll period (configure start day in Settings).
3. See present, absent, in/out counts, and paired hours per staff member.
4. Export Daily CSV or Event log CSV for committee or payroll reconciliation.

Committee members use Staff reports (/committee/staff-attendance) for the same exports without write access.

Step 5: Staff portal and vendor staff

• Staff portal: Admin links a member email → staff opens My attendance from profile menu.
• Vendor staff: On the staff form, choose Vendor-supplied and pick a vendor from Helpdesk.
• Visitor pass link: Admins creating a kind=staff visitor pass can link the roster row — gate entry/exit also marks society staff in/out when matched.

Attendance states explained

Use in / out when you track shift boundaries; use present / absent for a simple daily headcount.

Admin roster guide · Mark attendance guide · FAQ.