Al-Aziz Workforce OS
Workforce system2026
Attendance hardware, payroll rules and human exceptions — reconciled into one number a manager can sign off.
Workforce management for a charcoal-grill restaurant in Gulberg, Lahore, built for a single manager account with complete access. Face-recognition terminals feed an attendance rules engine; its verdicts flow into a payroll run that reconciles to the payslip.
The hard part was never the CRUD. It was the exceptions — an overnight shift that crosses midnight, a missed punch, approved overtime, Ramadan hours, a loan instalment due this month. The rules engine is configurable and explains how it reached each outcome, so a disputed day can be answered rather than argued.
- An attendance rules engine covering overnight and split shifts, grace periods, early leave, overtime with approval, breaks, missing punches, half-days, holidays and Ramadan hours
- Payroll staged draft → review → approved → paid, with advances and loans on instalment plans recovered automatically, so the ledger and the payslip always agree
- Ships empty by default — the seed creates one manager account and system settings, and nothing else. No fabricated staff, no demo numbers on a live deploy
- Deterministic fixtures seeded by a PRNG rather than Math.random or Date.now, so server and client renders always agree and there are no hydration mismatches
- Next.js 15
- React 19
- TypeScript
- Tailwind v4
- NestJS
- Prisma
- PostgreSQL

People
- Employee directory with a permanent business-facing ID, salary bands and reporting lines
- Profiles carrying salary history, shift assignment, documents and CNIC scans
- Leave requests, approval queue, entitlement balances and a month calendar
Attendance
- Live check-in feed from face-recognition terminals, with a device fleet panel
- Configurable rules engine: overnight and split shifts, grace, overtime approval, breaks, missing punches, holidays, Ramadan hours
- Correction queue for disputed days, with every manual fix logged
Payroll
- Runs staged draft → review → approved → paid, with holds and manual adjustments
- Advances and loans on instalment plans, recovered automatically against salary
- Printable payslips and a bank-file export that reconciles to the ledger
Operations
- Seven standard reports with filters, charts, CSV/JSON export and print
- Offline-first sync dashboard with pending, failed and conflict counts
- Command palette for navigation and people search across the whole app

