NEO Project Labor Tracker

Purpose

NEO is a construction labor tracking system built for managing daily attendance, worker verification, payments, and project oversight across construction sites in Sri Lanka.

At its heart, the system tackles a straightforward but critical problem: figuring out who showed up, how long they worked, and what they should get paid -- and making sure there's real accountability baked into every step through a dual-approval process.

Key Business Goals

1. Accurate Attendance Records -- Get rid of disputes about hours worked by capturing timestamps on the server side and requiring two levels of approval before anything counts
2. Fair Payment Calculations -- Automatically break down regular and overtime hours using configurable rates that can vary by worker type
3. Financial Transparency -- Keep track of daily advances, special advances (basically loans), and net payment calculations for each worker in every payment cycle
4. Multi-Project Support -- Workers can be assigned to several construction projects at the same time, and their pay rates can be different on each one
5. Accountability Chain -- Every attendance record has to pass through a Worker, then a Manager, then an Admin before it counts toward payment

Core Workflow

Here is how things flow from start to finish:

1. The worker self-verifies by checking in and out at the site
2. The project manager reviews and approves (first-level approval)
3. The company admin gives final approval (second-level approval)
4. An attendance record is created and marked as verified
5. At the end of every 15-day payment cycle, the system calculates what the worker is owed
6. Net Payment = Gross Earnings minus Daily Advances minus Special Advances

System Roles

Role	Description
Company Admin	Has full access to everything. They are the final approval authority and manage projects, workers, managers, payments, and system settings.
Project Manager	Assigned to one or more projects. They handle first-level approval for attendance and verifications. They can also declare stoppages and request special advances.
Worker	The construction labor force. Workers self-verify their attendance by checking in and out, and they can view their own attendance history and payment records.

Currency

All monetary values throughout the system are in Sri Lankan Rupees (LKR).

Timezone

Everything runs on Sri Lanka Standard Time (UTC+5:30) for all date and time calculations.