HR & Payroll Software — PC Runtime Verification Package
Project: HRPAY-BMD-20260911-01
Build under test: v0.39.4-dev Consolidated
Purpose: Complete the real Django + PostgreSQL runtime gate before the first Local UAT release.

গুরুত্বপূর্ণ
- এটি Production installation নয়। এটি একটি dedicated TEST/UAT PC-তে চালাবেন।
- সম্ভব হলে Windows 10/11 64-bit ব্যবহার করুন।
- এই software-এর database PostgreSQL; Microsoft SQL Server ব্যবহার করবেন না।
- প্রথম dependency install-এর সময় internet প্রয়োজন হতে পারে।
- Real company data এখন import করবেন না; sample/demo UAT data ব্যবহার করুন।

যা আগে Install/Ready থাকবে
1. Python 3.13 64-bit (python.org version; installation-এর সময় Add Python to PATH/py launcher enabled রাখা ভালো)
2. PostgreSQL + pgAdmin (PostgreSQL 16/17 family suitable for UAT)
3. Internet access for Python packages, unless an offline wheelhouse is supplied
4. Local Administrator access helpful for software installation; HRPAY scripts themselves normal user context-এ চালানো যায়

TEST SEQUENCE — order পরিবর্তন করবেন না
STEP 1: ZIP একটি short path-এ extract করুন, যেমন C:\HRPAY-UAT\
STEP 2: 00-PREFLIGHT-LOCAL-UAT-WINDOWS.bat চালান
        Expected: LOCAL-UAT-PREFLIGHT-RESULT.txt তৈরি হবে। Blocking FAIL থাকলে থামুন।
STEP 3: 00-FREEZE-MIGRATIONS-WINDOWS.bat চালান
        এটি reviewed models থেকে Django migration snapshot তৈরি করবে।
        Expected: MIGRATION-FREEZE-RESULT.txt শেষে RESULT: PASS থাকবে।
STEP 4: DATABASE-POSTGRESQL-SETUP.txt অনুসরণ করে fresh database/user তৈরি করুন:
        Database: hrpay_uat
        User/Owner: hrpay_uat
        Strong password: আপনারা নিজে নির্ধারণ করবেন
STEP 5: 01-SETUP-LOCAL-UAT-WINDOWS.bat চালান
        Database mode: 1 = PostgreSQL
        Host: সাধারণত 127.0.0.1
        Port: সাধারণত 5432
        Setup migration apply + sample/UAT data + Django checks চালাবে।
STEP 6: 03-CHECK-LOCAL-UAT-WINDOWS.bat চালান
        Expected: LOCAL-UAT-RUNTIME-CHECK-RESULT.txt শেষে RESULT: PASS
STEP 7: 04-RUN-SMOKE-TESTS-WINDOWS.bat চালান
        Expected: LOCAL-UAT-SMOKE-RESULT.txt-এ SMOKE TEST RESULT: PASS
STEP 8: 02-START-LOCAL-UAT-WINDOWS.bat চালান
        Browser: http://127.0.0.1:8000/login/
        Login page এবং Dashboard-এর screenshot নিন।
STEP 9: একই LAN থেকে test প্রয়োজন হলে server বন্ধ করে 02B-START-LOCAL-UAT-LAN-WINDOWS.bat ব্যবহার করুন।
STEP 10: 05-COLLECT-RUNTIME-RESULTS-WINDOWS.bat চালান
         এটি HRPAY-RUNTIME-RESULTS.zip বানাবে। সেই ZIP ChatGPT-কে দিন।

যদি কোনো STEP FAIL করে
- পরের STEP চালাবেন না।
- Error window-এর screenshot নিন।
- 05-COLLECT-RUNTIME-RESULTS-WINDOWS.bat চালানোর চেষ্টা করুন।
- HRPAY-RUNTIME-RESULTS.zip + screenshot দিন।
- Database password, .env.local, SECRET KEY বা অন্য secret screenshot/ZIP-এ পাঠাবেন না। Collector .env.local নেয় না।

প্রথম runtime gate-এ আমাদের প্রয়োজনীয় evidence
- LOCAL-UAT-PREFLIGHT-RESULT.txt
- MIGRATION-FREEZE-RESULT.txt
- generated migration .py files
- LOCAL-UAT-RUNTIME-CHECK-RESULT.txt
- LOCAL-UAT-SMOKE-RESULT.txt
- login/dashboard screenshot
- error screenshot (যদি থাকে)

Runtime Gate PASS হওয়ার পরে ChatGPT source/migrations/results review করে প্রথম Complete Local UAT ZIP প্রস্তুত করবে।