BGI HRMS Payroll & Attendance - Phase 8
Staff Lifecycle + Documents + HR Letters + Exit/FNF

PHASE 8 ADDED MODULES
1. Staff Document Vault
2. Staff Document Verification
3. Staff Self Document Upload
4. HR Letter Template Builder
5. Appointment / Experience / Relieving / Warning Letter
6. Staff Letter Generation and Print
7. Staff Self Portal Letter View
8. Staff ID Card Settings and Print
9. Exit / Resignation Request
10. Exit Approval Status
11. Exit Clearance Checklist
12. Salary Blocking Clearance Rules
13. Full & Final Settlement
14. FNF Approval / Paid Status
15. FNF CSV Export Report
16. Staff Card JSON API
17. Pending Exit Alert Cron
18. Phase 8 Responsive Theme CSS

INSTALLATION
1. Phase 1 to Phase 7 should already be installed.
2. Take a full database backup.
3. Import phase8_schema.sql in the same ERP database.
4. Upload folders from this ZIP to the project root.
5. Open: /admin/hrms/phase8_dashboard.php
6. Open Exit Clearance and verify default clearance items.
7. Open ID Cards and save institution name/address.
8. Open Letter Templates and modify templates as needed.

OPTIONAL CRON
php cron/hrms_phase8_pending_exit_alerts.php

MAIN ADMIN FILES
admin/hrms/phase8_dashboard.php
admin/hrms/staff_documents.php
admin/hrms/letter_templates.php
admin/hrms/generate_letter.php
admin/hrms/id_cards.php
admin/hrms/exit_requests.php
admin/hrms/exit_clearance.php
admin/hrms/fnf_settlement.php
admin/hrms/fnf_report.php

STAFF PORTAL FILES
staff/hrms/documents.php
staff/hrms/letters.php
staff/hrms/exit_apply.php

API
api/hrms/staff_card.php?staff_id=1

DOCUMENT UPLOAD PATH
uploads/hrms_documents/

IMPORTANT FLOW
Staff document upload -> Admin verification -> HR letter / ID card -> Exit request -> Clearance -> FNF settlement -> Paid.

SAFETY NOTES
- FNF approval is blocked when salary-blocking clearance items are still pending.
- Raw Phase 1 attendance and Phase 3 salary records are not modified by this patch.
- This patch adds lifecycle data only and keeps previous phases intact.
- PHP code is written in English and PHP 5.6 compatible style.
