HR & Payroll Software — Local UAT First-Run Package
Version: v0.39.4-dev Consolidated
Project: HRPAY-BMD-20260911-01

মূল Local Trial PostgreSQL দিয়েই করার পরামর্শ:
1) ZIP Extract করুন।
2) 00-PREFLIGHT-LOCAL-UAT-WINDOWS.bat চালান। LOCAL-UAT-PREFLIGHT-RESULT.txt-এ PC readiness দেখা যাবে।
3) docs\HRPAY_Installation_Maintenance_Guide_BN.pdf পড়ুন।
4) প্রথমে 00-FREEZE-MIGRATIONS-WINDOWS.bat চালান। এটি reviewed source থেকে migration files তৈরি করবে এবং MIGRATION-FREEZE-RESULT.txt-এ SHA-256 evidence লিখবে।
5) Freeze result PASS হলে generated migration files ও result log সংরক্ষণ করুন/Developer review-এর জন্য দিন।
6) DATABASE-POSTGRESQL-SETUP.txt অনুসরণ করে একটি FRESH PostgreSQL hrpay_uat database/user তৈরি করুন। পুরনো v0.37.x ad-hoc migration database-এ এই source সরাসরি চালাবেন না।
7) 01-SETUP-LOCAL-UAT-WINDOWS.bat ডাবল-ক্লিক করুন এবং Database mode হিসেবে 1 = PostgreSQL নির্বাচন করুন।
8) Setup-এর সময় প্রথম Super Admin username/password আপনি নিজে দেবেন।
9) Setup শেষ হলে 03-CHECK-LOCAL-UAT-WINDOWS.bat চালান।
10) এরপর 04-RUN-SMOKE-TESTS-WINDOWS.bat চালান।
11) Server PC-তে 02-START-LOCAL-UAT-WINDOWS.bat চালান।
12) একই Private LAN-এর colleague-রা test করলে 02B-START-LOCAL-UAT-LAN-WINDOWS.bat ব্যবহার করুন।
13) Browser URL: http://127.0.0.1:8000/login/ ; LAN হলে server IP দিয়ে port 8000 ব্যবহার হবে।

Demo accounts (Local UAT only):
uat.hr / uat.accounts / uat.payroll / uat.it / uat.employee / uat.employee2
Password: UAT-ChangeMe-2026!
Production-এ এগুলো ব্যবহার করা যাবে না।

এই package-এ Shohoj Shop Clothing Ltd. master data, sample employees/salary/leave এবং ZKTeco FO-M1 sample mapping তৈরি করার ব্যবস্থা আছে।

SQLite option শুধু দ্রুত smoke test-এর fallback। Final-এর মতো Trial করতে PostgreSQL ব্যবহার করুন।

গুরুত্বপূর্ণ:
- প্রথম setup-এ Python dependencies install করার জন্য internet প্রয়োজন হতে পারে, যদি আগে থেকে offline wheelhouse না থাকে।
- এই build-এ migration generation setup-এর ভিতরে হবে না। আগে explicit freeze script চালিয়ে migration files review/hash করতে হবে; setup শুধু frozen migrations drift-check করে apply করবে।
- Real office data import-এর আগে sample UAT data দিয়ে workflow test করুন।
- FO-M1-এর physical direct connector Local UAT-এ verify করতে হবে; CSV/USB punch import path প্রস্তুত আছে।
- Problem হলে screenshot-এর সাথে BUG-LOG-TEMPLATE.csv-এর Bug ID দিন।