HR & Payroll Management System — Local UAT Start Here
Project: HRPAY-BMD-20260911-01
Version: v0.39.4-dev Consolidated

Recommended Windows sequence (order পরিবর্তন করবেন না):
1. ZIP একটি NEW/short folder-এ extract করুন; পুরনো UAT folder/database overwrite করবেন না।
2. Run 00-PREFLIGHT-LOCAL-UAT-WINDOWS.bat. Blocking FAIL হলে থামুন।
3. Run 00-FREEZE-MIGRATIONS-WINDOWS.bat on this exact reviewed source. Expected: MIGRATION-FREEZE-RESULT.txt -> RESULT: PASS.
4. Generated backend\apps\*\migrations\*.py files ও freeze result সংরক্ষণ করুন।
5. Prepare a FRESH PostgreSQL hrpay_uat database using DATABASE-POSTGRESQL-SETUP.txt.
6. Run 01-SETUP-LOCAL-UAT-WINDOWS.bat and choose PostgreSQL.
7. Run 03-CHECK-LOCAL-UAT-WINDOWS.bat. Expected: LOCAL-UAT-RUNTIME-CHECK-RESULT.txt -> RESULT: PASS.
8. Run 04-RUN-SMOKE-TESTS-WINDOWS.bat. Expected: LOCAL-UAT-SMOKE-RESULT.txt -> SMOKE TEST RESULT: PASS.
9. Start with 02-START-LOCAL-UAT-WINDOWS.bat (server) or 02B-START-LOCAL-UAT-LAN-WINDOWS.bat (private LAN testing).
10. Use docs/HRPAY_User_Manual_BN.pdf during functional testing and LOCAL-UAT-SMOKE-TEST-SCENARIOS.csv for scenario evidence.
11. Use FO-M1-LIVE-PUNCH-TEST.csv for ZKTeco FO-M1 practical testing.
12. Use PARALLEL-PAYROLL-RECONCILIATION.csv to compare manual/Excel payroll with software payroll.
13. Run 05-COLLECT-RUNTIME-RESULTS-WINDOWS.bat and return HRPAY-RUNTIME-RESULTS.zip + screenshots.

Never send backend/.env.local, PostgreSQL passwords, SECRET_KEY or other credentials. The result collector intentionally excludes .env.local.

Final release gates: reviewed frozen migrations, PostgreSQL runtime PASS, functional UAT PASS, backup/restore proof, FO-M1 practical test, parallel payroll reconciliation and closure of critical/high runtime defects.