BGI HRMS Payroll & Attendance - Phase 9
Compliance + Advanced Biometrics + Analytics + Notification Bridge

PHASE 9 ADDED MODULES
1. Compliance Settings Center
2. Payroll Compliance CSV Export
3. PF / ESI / Professional Tax / TDS configuration base
4. WhatsApp / Email / SMS Notification Bridge
5. Notification Queue Monitor
6. Secureye Biometric Reconciliation
7. Missing Mapping / One Punch / Duplicate Punch Summary
8. Campus Lock / Geo Attendance Settings
9. Staff Geo Attendance Self Punch Request
10. Geo Attendance Approval
11. Policy Exception Matrix
12. Attendance Analytics Dashboard
13. HRMS KPI Snapshot Report
14. API for Geo Attendance Push
15. API for Notification Status
16. Notification Dispatch Cron
17. Biometric Reconciliation Cron
18. KPI Snapshot Cron
19. Phase 9 Responsive Theme CSS
20. Sample CSV Templates

INSTALLATION
1. Phase 1 to Phase 8 should already be installed.
2. Take a full database backup.
3. Import phase9_schema.sql in the same ERP database.
4. Upload folders from this ZIP to the project root.
5. Open: /admin/hrms/phase9_dashboard.php
6. Open Compliance Center and save institution compliance settings.
7. Open Notification Bridge and configure channel names.
8. Open Campus Lock Settings and save campus radius/time rules.
9. Run Biometric Reconciliation for a date range.
10. Run KPI Snapshot once after installation.

OPTIONAL CRON
php cron/hrms_phase9_notification_dispatch.php
php cron/hrms_phase9_biometric_reconcile.php
php cron/hrms_phase9_kpi_snapshot.php

MAIN ADMIN FILES
admin/hrms/phase9_dashboard.php
admin/hrms/compliance_center.php
admin/hrms/payroll_compliance_export.php
admin/hrms/notification_bridge.php
admin/hrms/attendance_analytics.php
admin/hrms/biometric_reconciliation.php
admin/hrms/campus_lock_settings.php
admin/hrms/geo_attendance_approvals.php
admin/hrms/policy_exception_matrix.php
admin/hrms/hrms_kpi_report.php

STAFF PORTAL FILES
staff/hrms/geo_attendance.php

API FILES
api/hrms/geo_attendance_push.php
api/hrms/notification_status.php

IMPORTANT FLOW
Attendance / Salary data -> Analytics / Compliance -> Notification Queue -> Campus lock / Geo approvals -> KPI snapshot -> Management report.

SAFETY NOTES
- This patch does not delete or overwrite previous phase data.
- Notification dispatch is a safe placeholder bridge. Connect it to the existing WhatsApp/email gateway as per your project gateway files.
- Campus lock uses latitude/longitude distance calculation and approval flow. It does not force-delete attendance.
- PHP code is written in English and PHP 5.6 compatible style.
