Worker Role
Workers are the construction laborers who participate in the attendance tracking system through self-verification. They do not have login accounts -- instead, they identify themselves using their NIC (National Identity Card) or Employee ID.
Identification
Each worker has two unique identifiers:
- NIC -- Their National Identity Card number (required, and must be unique)
- Employee ID -- A company-assigned ID (optional, but unique if one is provided)
Workers use either of these to check in and out of projects.
Worker Types
Every worker is assigned a Worker Type that determines how much they get paid:
- Daily Base Advance (the fixed daily cash advance they receive, if one is set up for their type)
- Regular Hourly Rate
- Overtime Hourly Rate
Some examples of worker types: Mason, Laborer, Carpenter, Electrician, and so on.
Pay rate overrides can be set on a per-worker, per-project basis. So if the same worker is on two different construction sites, they could be earning different rates at each one.
Self-Verification Flow
Workers verify their own attendance right at the construction site:
Check-In (Arrival)
- The worker picks the project they are reporting to
- They enter their NIC or Employee ID
- The system checks that they are registered and actually assigned to that project
- They submit their arrival time
- They can optionally upload a photo as evidence
- The system stamps the submission with a server-side timestamp
Check-Out (Departure)
- The worker selects the same project
- They enter their identifier again
- They submit their departure time
- They can optionally upload a departure photo
- The system records the departure submission
What Happens After Submission
- Pending Manager Review -- The submission lands in the manager's review queue
- The manager looks it over and approves (or rejects)
- Pending Admin Review -- If the manager approves, it moves to the admin
- The admin gives the final thumbs up (or rejects)
- Approved -- Once both have approved, an attendance record is automatically created
Status
A worker is either:
- Active -- Currently employed and eligible for attendance and payment
- Inactive -- No longer active; they cannot submit verifications or receive new attendance records
Payment Cycle
Each worker has a cycle start date that determines when their 15-day payment cycles begin. At the end of each cycle:
- All regular and overtime hours get totaled up
- Gross earnings are calculated using the worker's applicable rates
- Daily advances that were handed out during the cycle are subtracted
- Any approved special advances (loans) are deducted
- The resulting net amount is what the worker is owed (or what they owe, if their advances ended up being more than their earnings)
Loan Balance
Workers may carry a loan balance -- this is the total amount of special advances they have received that have not yet been taken out of their pay. This balance rolls forward from one payment cycle to the next until it is fully paid off.
Multi-Project Support
Workers can be assigned to multiple projects at the same time:
- Each project assignment can have its own rate overrides
- Attendance is tracked separately for each project
- Payment calculations pull together everything across all projects within a cycle
- The payment breakdown shows exactly how much came from each project