# Attendance & Payroll — সিরিয়াল বিল্ড সিকোয়েন্স **কার্ডের বিস্তারিত (source of truth):** [ATTENDANCE_PAYROLL_TASK_CARDS.md](./ATTENDANCE_PAYROLL_TASK_CARDS.md) **ডোমেইন রুলস (source of truth):** [ATTENDANCE_PAYROLL_MODULE_SPEC.md](./ATTENDANCE_PAYROLL_MODULE_SPEC.md) **টিম বণ্টন:** [DEV_TASK_DISTRIBUTION.md](./DEV_TASK_DISTRIBUTION.md) · **Docs index:** [../README.md](../README.md) এই ফাইল task cards **প্রতিস্থাপন করে না**। শুধু cards-এর **`Start after` / `Also needs`** অনুযায়ী **merge dependency** দিয়ে সাজায় — story number অনুযায়ী নয়। **Last verified against branch work:** 13 Sep 2026 — ✅ **CORS local+server (card নয়).** `CorsOriginResolver`: local `localhost`/`127.0.0.1` FE ports + server public host `:3010`/`:3011` from `VITE_API_URL`; prod healthcheck + deploy preflight. · 13 Sep 2026 — ✅ **Production CORS fix (card নয়).** `CorsOriginResolver` merges `VITE_API_URL` host → `:3010` Origin; prod php-fpm healthcheck; deploy CORS preflight gate; `.env` still never regenerated by CI/CD. · 10 Sep 2026 — ✅ **CI/CD deploy branch → `development` (card নয়).** `main` আর deploy trigger নয়; push to `development` → green CI → SHA deploy; fail after checkout → automatic previous-SHA rollback (no migrate rollback). `.github/workflows/ci.yml` · `scripts/deploy-production.sh` · [ops/CICD.md](../ops/CICD.md). · 6 Sep 2026 — ✅ **`AttendanceCorrectionExecutor` missing_in/out supersede existing punches (card নয়).** When an in/out already exists, approve supersedes it (same as incorrect_time) so consecutive-type check passes. · 6 Sep 2026 — ✅ **CI/CD (GitHub Actions + SHA deploy, card নয়).** `.github/workflows/ci.yml` · `scripts/deploy-production.sh` · [ops/CICD.md](../ops/CICD.md). · 6 Sep 2026 — ✅ **PHPUnit 31-failure cleanup (CI baseline, card নয়)।** Queue jobs `$this->onQueue('long')` · weekday test 1=Sunday · `specific_user` resolver + shift-span check restored · employment own-profile route · bKash/Nagad provider guard · payroll run tests without `Company::factory()` · PHPUnit 12 `#[DataProvider]` · monthly bulk-approve queued contract। Targeted 133 tests green; full `make test` re-run this pass. · 25 Aug 2026 — ✅ **`8.3b-FE` Disbursement UI done।** `/payroll/disbursement-batches` · channel summary + readiness · bank/mobile vs cash/cheque detail · A4 register print · nav Payroll › Disbursement। **Wave 6 বন্ধ: 228 pts / 54 cards, বাকি 0।** · 25 Aug 2026 — ✅ **`8.3b-BE` Multi-Channel Disbursement done।** `disbursement_batches` / `disbursement_batch_items` · allocation-driven disburse · channel-aware readiness · send/confirm/retry · cash/cheque acknowledge · export · `PayslipPaid`/`PayrollRunPaid` · **18** test green। **Wave progress: 223 pts / 53 cards, বাকি 5 pts / 1 card।** পরের spine **`8.3b-FE`**। · 25 Aug 2026 — ✅ **`8.3a-FE` Run Approval UI done।** `/payroll/payroll-runs/{id}/approval` · `approval-summary` · platform approve/reject · `ApprovalStatusBadge` + steps trail · Net Pay≠Net Payable · flagged payslips · settlement confirm · disbursement link stub। **Wave progress: 215 pts / 52 cards, বাকি 13 pts / 2 cards।** পরের spine **`8.3b-BE`**। · 25 Aug 2026 — ✅ **`8.3a-BE` Run Approval & Advance Settlement done।** `PayrollRunExecutor` · generation→`pending_approval` · paid→settled · carry-forward · `approval-summary` · **9** test green। **Wave progress: 210 pts / 51 cards, বাকি 18 pts / 3 cards।** পরের spine **`8.3b-BE`**। · 24 Aug 2026 (পঞ্চম যাচাই) — ✅ **`8.2-FE` Payslips UI done।** Run payslips list + generate/poll/retry · detail (settlement ৩ লাইন, frozen allocations, carry-forward) · My Payslips · PDF download · regenerate draft। Nav **My Payslips** · run detail **View Payslips**। **Wave progress: 205 pts / 50 cards, বাকি 23 pts / 4 cards।** পরের spine **`8.3a-BE`**। · 24 Aug 2026 (চতুর্থ যাচাই) — ✅ **`8.2b-BE` Advance Settlement & Payment Allocation done।** `PayslipFinaliser` paid advance নেট করে; `PaymentAllocator` `payslip_payment_allocations` freeze; `GET …/allocations`; PDF settlement + channel breakdown। Draft generation `salary_advances` ছোঁয় না। **Wave progress: 197 pts / 49 cards, বাকি 31 pts / 5 cards।** পরের spine **`8.3a-BE`**। **`8.3b-এর আগে এই card merge করতেই হবে`।** · 24 Aug 2026 (তৃতীয় যাচাই) — ✅ **`8.2a-BE` Payslip Generation done।** `payslips` টেবিল (advance কলাম সহ) · queued `generate-payslips` · generation-status · list/show/me · regenerate · PDF download · `PayslipFinaliser` pass-through (`net_payable = net_pay`, `advance_paid = 0`)। Attendance শুধু snapshot। **Wave progress: 192 pts / 48 cards, বাকি 36 pts / 6 cards।** পরের spine **`8.2b-BE`**। ⚠ GitHub PR **#228** আগের মতোই 8.0-FE polish — এই card আলাদা। · 24 Aug 2026 (দ্বিতীয় যাচাই) — ⚠ **`8.2a-BE` complete নয়** ছিল — `HEAD` তখন merge PR **#228** (`pay-8-2a-be-payslip-generation`), কিন্তু diff = snapshot/freeze FE। · 24 Aug 2026 — `8.0-FE` polish: list “Attendance divergence detected” + diagnostic copy; snapshot vs live visual contrast; freeze list `employee_id` filter (existing `/payroll/monthly-freeze` route)। · 23 Aug 2026 (তৃতীয় পাস) — ✅ **`8.0-FE` Snapshot UI done।** Run-scoped list/detail, draft-only build, freeze 409/404 pre-flight, diagnostic divergence; আলাদা nav item নেই। **Wave progress: 184 pts / 47 cards, বাকি 44 pts / 7 cards।** পরের spine **`8.2a-BE` Payslip Generation**। · 23 Aug 2026 (দ্বিতীয় পাস) — ✅ **`8.0-BE` Attendance Snapshot done।** `attendance_snapshots` — timestamp-বিহীন, immutable (model-level update/delete guard), `unique(payroll_run_id, employee_id)`। চারটে endpoint: build (draft-only, `payroll.run-create`) · list · show · divergence (diagnostic, read-only)। Frozen monthly approval থেকে হুবহু কপি, কিছু পুনর্গণনা হয় না; rebuild idempotent; off-cycle run নতুন সেট পায়, পুরনোটা অক্ষত। **Wave progress তখন: 182 pts / 46 cards, বাকি 46 pts / 8 cards।** `8.0-FE` তখনো খোলা ছিল। **`8.2a-BE` Payslip Generation** spine-এর পরের ধাপ। ⚠ **Payslip integration করা যায়নি — payslip generation কোডবেসে এখনো নেই** (`8.2a-BE` pending); তার বদলে payroll attendance-এর একমাত্র উৎস হিসেবে `getPayrollAttendanceForRun()` ঘোষিত, সাথে guard test যা প্রমাণ করে ওই path-এ `attendance_records`/`monthly_attendance_approvals`-এর কোনো query যায় না। ১৭টা নতুন test সবুজ; suite **36 failed / 626 passed** — ফেল-তালিকা baseline-এর সাথে হুবহু এক, কোনো regression নেই। বিস্তারিত ফাইলের শেষে। · 23 Aug 2026 — ✅ **তিনটে card done, Wave 5 বন্ধ, Wave 6 শুরু।** `6.2-FE` Freeze UI (`1a93334f` + fix `36d66df6`) · **`8.1-BE`** Payroll Run Creation (`6fcd9218`, fix PR #215) · **`8.1-FE`** Payroll Run UI (PR #209)। **Wave progress: 177 pts / 45 cards, বাকি 51 pts / 9 cards — বাকিটা পুরো Wave 6।** এতে **`8.0-BE` Attendance Snapshot unlock হলো** (`8.1-BE` + `6.2-BE` দুটোই লাগত), এখন critical path। ⚠ **দুটো gate-ই আগের চেয়ে অনেক বেশি লাল** — `php artisan test` **36 failed / 609 passed** (ছিল 1 failed) ১০টা class জুড়ে, আর `tsc -b --force` **৩৫ error** (ছিল ১৫)। এর মধ্যে **`8.1-BE`-র নিজের দুটো test ফাইলের একটাও চলে না** (`Company::factory()` নেই · PHPUnit 12-তে `@dataProvider` docblock উপেক্ষিত) আর **`8.1-FE` ১০টা নতুন tsc error** এনেছে — পঞ্চম FE card যেটা লাল build নিয়ে merge হলো। এর বাইরে PR #208 · #210–#214 · #216–#219 সবই Employee/Platform-এর কাজ ও bug fix, **card নয়, points অপরিবর্তিত**। বিস্তারিত ফাইলের শেষে। · 20 Aug 2026 — 🎨 **UI design pass** (card নয়, points অপরিবর্তিত; branch `design-change-based-on-gemini`, 62 ফাইল · +226/−278): breadcrumb বাদ · `PageHeader`-এর subtitle ৫২টা call site থেকে বাদ ও উচ্চতা ~82px→~60px · header-এর অ্যাকশন বাটন `md`→`sm` (৫৪ জায়গা) · `DataTable`-এর row **40px→28px** (`py-1.5` + 12px font, ৬৫টা পেজে) · Employee list-এ select bar আর টেবিল ঠেলে না · company switch-এ blocking overlay + `Switched to X` toast। **Attendance/Payroll-এর business logic ছোঁয়া হয়নি**, কিন্তু `PageHeader`/`DataTable` প্রায় প্রতিটা স্ক্রিনে বসে — screenshot মেলাতে গেলে জানা দরকার। Gate: `tsc -b` **১৫ error, baseline-এর সাথে হুবহু এক** (একটাও নতুন নয়), `oxlint` অপরিবর্তিত, `vite build` সবুজ; `check-style-boundary.sh` 🔴 তবে **আগে থেকেই** — `JobStatusPanel.tsx:87`-এর hard-coded `text-[10px]`, clean HEAD-এ যাচাই করা, আর **`npm run build` ওখানেই আটকায়**। বিস্তারিত ফাইলের শেষে। · 18 Aug 2026 (দ্বিতীয় পাস) — **`6.1-FE` Monthly Approval UI merged (PR #198, Bablu)** ⚠ **দুটো gate-ই ভেঙে**: `tsc -b` **১৫ error** (তাই `npm run build` লাল) আর `php artisan test` **1 failed / 452 passed** — bulk-approve-এর response contract queued batch-এ বদলেছে কিন্তু `6.1-BE`-র নিজের `MonthlyAttendanceApprovalServiceTest` আপডেট হয়নি। **Wave progress: 167 pts / 42 cards, বাকি 61 pts / 12 cards।** কার্ডের কয়েকটা মূল rule-ও আসেনি — **detail page-এর Approve সবসময় `override: true` পাঠায়**, unlock reason hardcoded, reject action নেই, day-by-day breakdown placeholder, আর unresolved popover কেবল একটা সাধারণ বাক্য দেখায় (blocker list বা deep link নেই, API-ও ওটা দেয় না)। বিস্তারিত ফাইলের শেষে। · 18 Aug 2026 — **`9.4-FE` Attendance Jobs UI merged (PR #197, Munna)**, তাই Wave 5-এর jobs track শেষ। **Wave progress: 162 pts / 41 cards, বাকি 66 pts / 13 cards** (উপরের হিসাবটা `6.1-BE` ও `6.2-BE` দুটো card পিছিয়ে ছিল, Seq সারি থেকে গুনে মেলানো হয়েছে)। **আগের তিনটে blocker-ই এখন শেষ** — `php artisan test` **453 passed / 1438 assertions** (fatal নেই, ছয় executor-এই `reject()` আছে, `phpunit.xml`-এ `Modules` testsuite declare করা), `Modules/Attendance/tests` **79 passed**, `tsc -b --force` ০ error, `vite build` সবুজ। তবে `9.4-FE` চারটে ঋণ নিয়ে ঢুকেছে — **"Fix Assignment" link আসলে কিছুই filter করে না**, timezone hardcoded `Asia/Dhaka`, status panel unfiltered activity log পড়ে, আর `JobStatusPanel.tsx` dead code; বিস্তারিত ফাইলের শেষে। · 17 Aug 2026 (তৃতীয় পাস) — **`5.5-FE` Correction Approval UI merged (PR #189)** ⚠ `tsc -b` ভেঙে, আর **`9.2-BE` Leave Accrual & Carry-Forward merged (PR #190)**। এতে **Wave 4 বন্ধ (25/25)** আর **`9.4-FE` unlock হলো**। **Wave progress: 148 pts / 38 cards, বাকি 80 pts / 16 cards।** এই পাসে তিনটে blocker যাচাই করা হয়েছে, যার একটা আগে কোথাও লেখাই ছিল না — `phpunit.xml`-এ module testsuite declare করা নেই বলে **`Modules/Attendance`-এর ৬০টা test `php artisan test`-এ কোনোদিন চলেই না**; explicit path দিলে **20 failed / 40 passed**। বাকি দুটো: executor `reject()` fatal (অপরিবর্তিত) আর `npm run build` লাল। সাথে **PR #191 — platform company context** (card নয়, points অপরিবর্তিত)। · 17 Aug 2026 — 🐛 **Platform module-এ দুটো infinite-render loop সারানো** (`UserRolesDrawer`, `RolePermissionsDrawer`) — "Maximum update depth exceeded"; বিস্তারিত এই ফাইলের শেষে। **Attendance/Payroll-এর কোনো card এগোয়নি, points অপরিবর্তিত।** · 17 Aug 2026 — ✅ **`5.3-FE`-র build-ঋণ শোধ:** `npm run build` আবার সবুজ (`tsc -b` ০ error, `vite build` পাস), আর stale-balance banner-এর **"Refresh Balance" button এখন render হয়** (`Alert`-এ `tone`/`actions`)। সাথে একটা **নতুন bug ধরা পড়েছে যা আগের নোটে উল্টো লেখা ছিল** — per-day breakdown runtime-এ কাজ করছিল **না**, কারণ `leaveRequestApi.normalizeRequest` `days` ফেলে দিচ্ছিল; এখন carry করে। নিচের নোট দেখুন। · 17 Aug 2026 — **`5.3-FE` Leave Approvals UI merged (PR #188)**, তাই **Wave 4-এ এখন শুধু `5.5-FE` বাকি**। ⚠ কিন্তু ঐ PR-এ `npm run build` ভেঙে গেছে (`tsc -b` ১৬ error) আর একটা card rule চুপচাপ কাজ করছে না — নিচের নোট দেখুন। **Wave progress টেবিলটা সাতটা merged card পিছিয়ে ছিল, এখন গুনে ঠিক করা হয়েছে: 140 pts / 36 cards, বাকি 88 pts / 18 cards** (আগে ভুল করে 114/29 লেখা ছিল)। · 17 Aug 2026 — Employee module-এ ছয়টা কাজ শেষ (contact-এ user email/mobile default · emergency phone rule · address geo cascade · contact update-এর "already in use" bug · salary tab-এ `*` · dropdown deselect bug); প্রতিটার বিস্তারিত এই ফাইলের শেষে। **Attendance/Payroll-এর কোনো card এগোয়নি, points অপরিবর্তিত।** তবে suite চালাতে গিয়ে **একটা hard blocker বেরিয়েছে যা এতদিন কোথাও লেখা ছিল না** — নিচের "Next" দেখুন। · 13 Aug 2026 (দ্বিতীয় পাস) — **`5.3a-BE`** (PR #180) · **`5.4-FE`** (PR #181) merged, আর **`5.3b-BE`-র কাজটাও 5.3a-র PR-এই ঢুকে গেছে** (আসল `LeaveDayResolverService` bind + R2 branch live) — তবে তিনটে DoD-ঋণ সহ, দেখুন "5.3b-এর ঋণ" অংশ। · 13 Aug 2026 — **`2.2-FE`** Applied Policy Panel (PR #182) merged; snapshot-এর পুরো ফিল্ড সেট + Recalculate split control এসেছে, তাই **Story 2.2 ও Wave 3 দুটোই সম্পূর্ণ** (43/43 pts)। · 11 Aug 2026 — **Story 5.2 সম্পূর্ণ** (`5.2-BE` PR-পরবর্তী fix + `5.2-FE`, PR #164), **`5.4-BE`** Correction Request (PR #163), **`3.2-FE`** Daily Summary / Records (PR #165) merged। `2.2-FE`-র read-only panel 3.2-FE-র detail view-তে ঢুকেছে, কিন্তু recalculate control এখনো নেই — **partial**। · 10 Aug 2026 (recheck) — **3.1-BE** Punches · **3.1-FE** Punch UI · **3.2-BE** Daily Summary · **7.4-BE** Deductions & Loans · **7.0-FE** Settings UI · **7.3-FE** Tax Slabs UI সব merged (PR #150–#155)। Earlier same day: **7.2-FE** · **7.2-BE** · **4.1-FE** · **5.1-BE** · **5.1-FE**. এর পর merge হয়েছে **7.4-FE** Deductions & Loans UI (PR #157) ও **10.2-BE** Bank Account Validation। **Story 7.5 সম্পূর্ণ merged — `7.5-BE` (PR #160) ও `7.5-FE` (PR #161)।** · 24 Aug 2026 — `8.0-FE` polish: list “Attendance divergence detected” + diagnostic copy; snapshot vs live visual contrast; freeze list `employee_id` filter (existing `/payroll/monthly-freeze` route)। · 23 Aug 2026 (তৃতীয় পাস) — ✅ **`8.0-FE` Snapshot UI done।** Run-scoped list/detail, draft-only build, freeze 409/404 pre-flight, diagnostic divergence; আলাদা nav item নেই। **Wave progress: 184 pts / 47 cards, বাকি 44 pts / 7 cards।** পরের spine **`8.2a-BE` Payslip Generation**। · 23 Aug 2026 (দ্বিতীয় পাস) — ✅ **`8.0-BE` Attendance Snapshot done।** `attendance_snapshots` — timestamp-বিহীন, immutable (model-level update/delete guard), `unique(payroll_run_id, employee_id)`। চারটে endpoint: build (draft-only, `payroll.run-create`) · list · show · divergence (diagnostic, read-only)। Frozen monthly approval থেকে হুবহু কপি, কিছু পুনর্গণনা হয় না; rebuild idempotent; off-cycle run নতুন সেট পায়, পুরনোটা অক্ষত। **Wave progress তখন: 182 pts / 46 cards, বাকি 46 pts / 8 cards।** `8.0-FE` তখনো খোলা ছিল। **`8.2a-BE` Payslip Generation** spine-এর পরের ধাপ। ⚠ **Payslip integration করা যায়নি — payslip generation কোডবেসে এখনো নেই** (`8.2a-BE` pending); তার বদলে payroll attendance-এর একমাত্র উৎস হিসেবে `getPayrollAttendanceForRun()` ঘোষিত, সাথে guard test যা প্রমাণ করে ওই path-এ `attendance_records`/`monthly_attendance_approvals`-এর কোনো query যায় না। ১৭টা নতুন test সবুজ; suite **36 failed / 626 passed** — ফেল-তালিকা baseline-এর সাথে হুবহু এক, কোনো regression নেই। বিস্তারিত ফাইলের শেষে। · 23 Aug 2026 — ✅ **তিনটে card done, Wave 5 বন্ধ, Wave 6 শুরু।** `6.2-FE` Freeze UI (`1a93334f` + fix `36d66df6`) · **`8.1-BE`** Payroll Run Creation (`6fcd9218`, fix PR #215) · **`8.1-FE`** Payroll Run UI (PR #209)। **Wave progress: 177 pts / 45 cards, বাকি 51 pts / 9 cards — বাকিটা পুরো Wave 6।** এতে **`8.0-BE` Attendance Snapshot unlock হলো** (`8.1-BE` + `6.2-BE` দুটোই লাগত), এখন critical path। ⚠ **দুটো gate-ই আগের চেয়ে অনেক বেশি লাল** — `php artisan test` **36 failed / 609 passed** (ছিল 1 failed) ১০টা class জুড়ে, আর `tsc -b --force` **৩৫ error** (ছিল ১৫)। এর মধ্যে **`8.1-BE`-র নিজের দুটো test ফাইলের একটাও চলে না** (`Company::factory()` নেই · PHPUnit 12-তে `@dataProvider` docblock উপেক্ষিত) আর **`8.1-FE` ১০টা নতুন tsc error** এনেছে — পঞ্চম FE card যেটা লাল build নিয়ে merge হলো। এর বাইরে PR #208 · #210–#214 · #216–#219 সবই Employee/Platform-এর কাজ ও bug fix, **card নয়, points অপরিবর্তিত**। বিস্তারিত ফাইলের শেষে। · 20 Aug 2026 — 🎨 **UI design pass** (card নয়, points অপরিবর্তিত; branch `design-change-based-on-gemini`, 62 ফাইল · +226/−278): breadcrumb বাদ · `PageHeader`-এর subtitle ৫২টা call site থেকে বাদ ও উচ্চতা ~82px→~60px · header-এর অ্যাকশন বাটন `md`→`sm` (৫৪ জায়গা) · `DataTable`-এর row **40px→28px** (`py-1.5` + 12px font, ৬৫টা পেজে) · Employee list-এ select bar আর টেবিল ঠেলে না · company switch-এ blocking overlay + `Switched to X` toast। **Attendance/Payroll-এর business logic ছোঁয়া হয়নি**, কিন্তু `PageHeader`/`DataTable` প্রায় প্রতিটা স্ক্রিনে বসে — screenshot মেলাতে গেলে জানা দরকার। Gate: `tsc -b` **১৫ error, baseline-এর সাথে হুবহু এক** (একটাও নতুন নয়), `oxlint` অপরিবর্তিত, `vite build` সবুজ; `check-style-boundary.sh` 🔴 তবে **আগে থেকেই** — `JobStatusPanel.tsx:87`-এর hard-coded `text-[10px]`, clean HEAD-এ যাচাই করা, আর **`npm run build` ওখানেই আটকায়**। বিস্তারিত ফাইলের শেষে। · 18 Aug 2026 (দ্বিতীয় পাস) — **`6.1-FE` Monthly Approval UI merged (PR #198, Bablu)** ⚠ **দুটো gate-ই ভেঙে**: `tsc -b` **১৫ error** (তাই `npm run build` লাল) আর `php artisan test` **1 failed / 452 passed** — bulk-approve-এর response contract queued batch-এ বদলেছে কিন্তু `6.1-BE`-র নিজের `MonthlyAttendanceApprovalServiceTest` আপডেট হয়নি। **Wave progress: 167 pts / 42 cards, বাকি 61 pts / 12 cards।** কার্ডের কয়েকটা মূল rule-ও আসেনি — **detail page-এর Approve সবসময় `override: true` পাঠায়**, unlock reason hardcoded, reject action নেই, day-by-day breakdown placeholder, আর unresolved popover কেবল একটা সাধারণ বাক্য দেখায় (blocker list বা deep link নেই, API-ও ওটা দেয় না)। বিস্তারিত ফাইলের শেষে। · 18 Aug 2026 — **`9.4-FE` Attendance Jobs UI merged (PR #197, Munna)**, তাই Wave 5-এর jobs track শেষ। **Wave progress: 162 pts / 41 cards, বাকি 66 pts / 13 cards** (উপরের হিসাবটা `6.1-BE` ও `6.2-BE` দুটো card পিছিয়ে ছিল, Seq সারি থেকে গুনে মেলানো হয়েছে)। **আগের তিনটে blocker-ই এখন শেষ** — `php artisan test` **453 passed / 1438 assertions** (fatal নেই, ছয় executor-এই `reject()` আছে, `phpunit.xml`-এ `Modules` testsuite declare করা), `Modules/Attendance/tests` **79 passed**, `tsc -b --force` ০ error, `vite build` সবুজ। তবে `9.4-FE` চারটে ঋণ নিয়ে ঢুকেছে — **"Fix Assignment" link আসলে কিছুই filter করে না**, timezone hardcoded `Asia/Dhaka`, status panel unfiltered activity log পড়ে, আর `JobStatusPanel.tsx` dead code; বিস্তারিত ফাইলের শেষে। · 17 Aug 2026 (তৃতীয় পাস) — **`5.5-FE` Correction Approval UI merged (PR #189)** ⚠ `tsc -b` ভেঙে, আর **`9.2-BE` Leave Accrual & Carry-Forward merged (PR #190)**। এতে **Wave 4 বন্ধ (25/25)** আর **`9.4-FE` unlock হলো**। **Wave progress: 148 pts / 38 cards, বাকি 80 pts / 16 cards।** এই পাসে তিনটে blocker যাচাই করা হয়েছে, যার একটা আগে কোথাও লেখাই ছিল না — `phpunit.xml`-এ module testsuite declare করা নেই বলে **`Modules/Attendance`-এর ৬০টা test `php artisan test`-এ কোনোদিন চলেই না**; explicit path দিলে **20 failed / 40 passed**। বাকি দুটো: executor `reject()` fatal (অপরিবর্তিত) আর `npm run build` লাল। সাথে **PR #191 — platform company context** (card নয়, points অপরিবর্তিত)। · 17 Aug 2026 — 🐛 **Platform module-এ দুটো infinite-render loop সারানো** (`UserRolesDrawer`, `RolePermissionsDrawer`) — "Maximum update depth exceeded"; বিস্তারিত এই ফাইলের শেষে। **Attendance/Payroll-এর কোনো card এগোয়নি, points অপরিবর্তিত।** · 17 Aug 2026 — ✅ **`5.3-FE`-র build-ঋণ শোধ:** `npm run build` আবার সবুজ (`tsc -b` ০ error, `vite build` পাস), আর stale-balance banner-এর **"Refresh Balance" button এখন render হয়** (`Alert`-এ `tone`/`actions`)। সাথে একটা **নতুন bug ধরা পড়েছে যা আগের নোটে উল্টো লেখা ছিল** — per-day breakdown runtime-এ কাজ করছিল **না**, কারণ `leaveRequestApi.normalizeRequest` `days` ফেলে দিচ্ছিল; এখন carry করে। নিচের নোট দেখুন। · 17 Aug 2026 — **`5.3-FE` Leave Approvals UI merged (PR #188)**, তাই **Wave 4-এ এখন শুধু `5.5-FE` বাকি**। ⚠ কিন্তু ঐ PR-এ `npm run build` ভেঙে গেছে (`tsc -b` ১৬ error) আর একটা card rule চুপচাপ কাজ করছে না — নিচের নোট দেখুন। **Wave progress টেবিলটা সাতটা merged card পিছিয়ে ছিল, এখন গুনে ঠিক করা হয়েছে: 140 pts / 36 cards, বাকি 88 pts / 18 cards** (আগে ভুল করে 114/29 লেখা ছিল)। · 17 Aug 2026 — Employee module-এ ছয়টা কাজ শেষ (contact-এ user email/mobile default · emergency phone rule · address geo cascade · contact update-এর "already in use" bug · salary tab-এ `*` · dropdown deselect bug); প্রতিটার বিস্তারিত এই ফাইলের শেষে। **Attendance/Payroll-এর কোনো card এগোয়নি, points অপরিবর্তিত।** তবে suite চালাতে গিয়ে **একটা hard blocker বেরিয়েছে যা এতদিন কোথাও লেখা ছিল না** — নিচের "Next" দেখুন। · 13 Aug 2026 (দ্বিতীয় পাস) — **`5.3a-BE`** (PR #180) · **`5.4-FE`** (PR #181) merged, আর **`5.3b-BE`-র কাজটাও 5.3a-র PR-এই ঢুকে গেছে** (আসল `LeaveDayResolverService` bind + R2 branch live) — তবে তিনটে DoD-ঋণ সহ, দেখুন "5.3b-এর ঋণ" অংশ। · 13 Aug 2026 — **`2.2-FE`** Applied Policy Panel (PR #182) merged; snapshot-এর পুরো ফিল্ড সেট + Recalculate split control এসেছে, তাই **Story 2.2 ও Wave 3 দুটোই সম্পূর্ণ** (43/43 pts)। · 11 Aug 2026 — **Story 5.2 সম্পূর্ণ** (`5.2-BE` PR-পরবর্তী fix + `5.2-FE`, PR #164), **`5.4-BE`** Correction Request (PR #163), **`3.2-FE`** Daily Summary / Records (PR #165) merged। `2.2-FE`-র read-only panel 3.2-FE-র detail view-তে ঢুকেছে, কিন্তু recalculate control এখনো নেই — **partial**। · 10 Aug 2026 (recheck) — **3.1-BE** Punches · **3.1-FE** Punch UI · **3.2-BE** Daily Summary · **7.4-BE** Deductions & Loans · **7.0-FE** Settings UI · **7.3-FE** Tax Slabs UI সব merged (PR #150–#155)। Earlier same day: **7.2-FE** · **7.2-BE** · **4.1-FE** · **5.1-BE** · **5.1-FE**. এর পর merge হয়েছে **7.4-FE** Deductions & Loans UI (PR #157) ও **10.2-BE** Bank Account Validation। **Story 7.5 সম্পূর্ণ merged — `7.5-BE` (PR #160) ও `7.5-FE` (PR #161)।** **বেসলাইন (ইতোমধ্যে শেষ):** Part 0 · Part A (1.1–1.4) · 2.1-BE · 2.1-FE · 2.2-BE **Story 2.2 সম্পূর্ণ** — `2.2-FE` merged (PR #182)। Snapshot-এর পুরো ফিল্ড সেট আর Recalculate split control দুটোই এসেছে (দেখুন Seq 27)। **Wave 3 বন্ধ।** ### এখনকার বোর্ড (25 Aug 2026, কোডবেস যাচাই) Waves **1–6 বন্ধ**। Wave 6 **59/59 pts** (`8.1-BE` · `8.1-FE` · `8.0-BE` · `8.0-FE` · `8.2a-BE` · `8.2b-BE` · `8.2-FE` · `8.3a-BE` · `8.3a-FE` · `8.3b-BE` · **`8.3b-FE`**). | খোলা এখন | Pts | কোডবেস | |---|---|---| | — | — | Attendance/Payroll spine complete | সিরিয়াল: `8.2a-BE` → `8.2b-BE` → `8.3a-BE` → `8.3b-BE` → `8.3b-FE`। **`8.2b` আগে, তারপর `8.3b`।** Payslip attendance source (ইতিমধ্যে বেঁধে দেওয়া): `AttendanceSnapshotServiceInterface::getPayrollAttendanceForRun()` — `attendance_records` নয়। ### এখন পর্যন্ত Wave progress | Done | Pts | Evidence (short) | | ------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------ | | **3.1-BE** Multi-Punch Check-In/Out | 5 | `attendance_punches` (append-only) + `PunchService`; `/attendance/punch` · `/punches`; `PunchCreated` | | **3.1-FE** Punch UI | 3 | `PunchWidget` + Employee Punch page; `punchApi.ts` | | **3.2-BE** Daily Attendance Summary | 8 | `attendance_records` + calculation/recalculation service; today/list/show/punches/export; null LeaveDayResolver | | **4.1-BE** Approval Integration | 5 | 5 executor stubs + registry; demo `approval_settings` seeder; bypass/workflow tests | | **4.1-FE** Approval Settings Exposure | 3 | Core › Approval Settings filters + New highlight; shared badge/pending action; requests list reuse | | **5.1-BE** Leave Balances | 5 | `leave_balances` + ledger; `/attendance/leave-balances` list/me/history/adjust | | **5.1-FE** Leave Balance UI | 3 | Attendance › Leave › Balances; employee history; adjust modal; Dashboard My Balances | | **7.0-BE** Payroll Settings | 3 | `/payroll/settings` API | | **7.0-FE** Payroll Settings UI | 3 | Payroll › Config › Settings (`ready: true`) + worked-example panel | | **7.1-BE** Salary Structures | 3 | `/payroll/salary-structures` API | | **7.1-FE** Salary Structures UI | 2 | Payroll › Configuration › Salary Structures | | **7.2-BE** Structure Components | 5 | `salary_structure_components` + nested CRUD/reorder/preview; shared calculator | | **7.2-FE** Structure Components UI | 5 | Payroll › Config › Salary Structures — stacked Offcanvas builder + preview; `salaryStructureComponentApi.ts` | | **7.3-BE** Tax Slabs | 3 | `/payroll/tax-slabs` API (+ calculate) | | **7.3-FE** Tax Slabs UI | 3 | Payroll › Config › Tax Slabs list + form (`ready: true`) | | **7.4-BE** Deductions & Loans | 5 | `employee_deductions` + `_entries` (unique per run); ৬টা endpoint; idempotent `applyInstallment` + review flag | | **7.4-FE** Deductions & Loans UI | 3 | Payroll › Config › Deductions & Loans (`ready: true`); list + detail page; `employeeDeductionApi.ts` | | **7.5-BE** Salary Advances | 8 | `salary_advances` + ৮ endpoint; frozen `basis_gross`; মাস-total ceiling; executor + দুই approval path (PR #160) | | **7.5-FE** Salary Advances UI | 5 | Payroll › Salary Advances — single screen, সব operation stacked Offcanvas-এ; `salaryAdvanceApi.ts` (PR #161) | | **7.6-BE** Payment Mode Split | 5 | `/payroll/employee-salaries/{id}/payment-modes` | | **7.6-FE** Payment Mode Split UI | 3 | Employees › Salary › Payment split panel | | **10.1-BE** Salary Field Validation | 1 | currency/frequency/active-structure 422 + tests | | **10.2-BE** Bank Account Validation | 1 | OR-method rule + single-primary (model-level) + partial-update fix; 36 tests green | | **9.3-BE** Default Data Seeders | 3 | ১১ system type + default shift, per company; `Company::created` provisioning hook; re-run/customisation test | | **10.3-BE** Missing Payment Method Report | 3 | `/employee/employees/without-primary-payment-method`; একটাই `NOT EXISTS` query, 8.3b readiness এটাই resolve করবে; 17 tests green | | **5.2-BE** Leave Application | 5 | `leave_requests` + ৫ endpoint; এক `evaluate()` path preview ও store-এ; ISO working-day count; IDOR বন্ধ; 25 tests green | | **5.2-FE** Leave Application UI | 5 | Attendance › Leave › Requests — apply form (debounced preview, live day count + before/after balance), list, detail, cancel | | **3.2-FE** Daily Summary / Records | 5 | Attendance › Attendance Records — record grid + detail view; applied-policy snapshot panel detail-এ embedded (PR #165) | | **5.4-BE** Correction Request | 3 | `correction_requests` + store/index/show/cancel; duplicate guard; policy + approval executor; 7 tests green (PR #163) | | **2.2-FE** Applied Policy Panel | 2 | Snapshot-এর পুরো ফিল্ড সেট + Recalculate split control (PR #182) | | **5.3a-BE** Leave Approval | 5 | `LeaveRequestExecutor` — lockForUpdate, execution-time balance পুনঃযাচাই, ledger + `leave_request_days` (PR #180) | | **5.4-FE** Correction Request UI | 3 | Attendance › Corrections — submit + list + detail + cancel (PR #181) | | **5.3b-BE** Punch Voids Leave | 3 | তিনটে DoD-ঋণ শোধ; `PunchLeaveVoidTest` 7 test green (PR #186) | | **5.5-BE** Correction Approval | 5 | Executor + supersede + locked-month override (PR #185) ⚠ cross-lane gate ভেঙে merged | | **9.1-BE** Nightly Attendance Close | 5 | `ScheduleCloseDayCommand` — এক hourly cron, per-company timezone; query-তেই idempotent (PR #187) ⚠ ৩ DoD-ঋণ | | **5.3-FE** Leave Approvals UI | 3 | Queue + detail + reject modal; fresh balance, stale-approve guard (PR #188) ✅ build-ঋণ শোধ — `tsc -b` সবুজ, Refresh button render হয়, day breakdown সত্যিই আসে | | **5.5-FE** Correction Approval UI | 3 | HR queue + detail + day comparison + reject modal + locked-month banner (PR #189) ⚠ `tsc -b` ভেঙে merged | | **9.2-BE** Leave Accrual & Carry-Forward | 5 | দুটো scheduled command + chunk job + manual trigger endpoint; `LeaveAccrualJobTest` green (PR #190) | | **6.1-BE** Monthly Attendance Approval | 8 | HR মাস বন্ধ করে — ৯টা endpoint; suite 452/452 (PR #192) | | **6.2-BE** Monthly Freeze | 3 | Finance lock — `MonthlyAttendanceFreezeService` + freeze/unfreeze endpoint + `MonthFrozen` event (PR #195) | | **9.4-FE** Attendance Jobs UI | 3 | Attendance › Jobs — unassigned report + তিন-tab manual trigger + batch progress (`sessionStorage` + `?batch=`); সাথে accrual-এ annual cap guard (PR #197) ⚠ ৪ DoD-ঋণ | | **6.1-FE** Monthly Approval UI | 5 | Attendance › Monthly Approval — grid + filter/search + build drawer + bulk approve (queued batch, live progress) + detail (PR #198) ⚠ build ও suite দুটোই ভেঙে merged | | **6.2-FE** Freeze UI | 2 | Payroll › Monthly Freeze — `MonthlyFreezePage.tsx` (`1a93334f`), পরে list-না-দেখানোর fix (`36d66df6`) — **Wave 5 বন্ধ** | | **8.1-BE** Payroll Run Creation | 5 | `payroll_runs` টেবিল + `PayrollRun`/`PayrollRunService` + run index/store/readiness/show (`6fcd9218`, fix PR #215) ⚠ নিজের দুটো test ফাইলই চলে না | | **8.1-FE** Payroll Run UI | 3 | Payroll › Payroll Runs — list/create/detail + `payrollRunApi.ts` (PR #209) ⚠ tsc-তে ১০ নতুন error | | **8.0-BE** Attendance Snapshot | 5 | `attendance_snapshots` (immutable, timestamp-বিহীন) + build/list/show/divergence; payroll attendance-এর একমাত্র উৎস, ১৭ test সবুজ | | **8.0-FE** Snapshot UI | 2 | run detail → snapshots; draft-only build; freeze pre-flight; diagnostic divergence; list copy + snapshot/live contrast; freeze `employee_id` query | | **8.2a-BE** Payslip Generation | 8 | payslips pipeline + generate/status/list/me/regenerate/PDF (earlier card) | | **8.2b-BE** Advance Settlement | 5 | Finaliser net + PaymentAllocator freeze | | **8.2-FE** Payslips UI | 8 | Run payslips + My Payslips + detail | | **8.3a-BE** Run Approval & Settlement | 5 | Executor · paid→settled · carry-forward · approval-summary | | **8.3a-FE** Run Approval UI | 5 | `/payroll/payroll-runs/{id}/approval` decision screen · platform approve/reject | | **8.3b-BE** Multi-Channel Disbursement | 8 | batches/items · send/confirm/retry/ack · export · 18 test | | **8.3b-FE** Disbursement UI | 5 | `/payroll/disbursement-batches` · channel summary + readiness · register vs transmitted detail · A4 print | | **মোট Wave done** | **228** | 54 cards | **Wave breakdown:** Wave 1 done **39/39 pts** · Wave 2 done **31/31 pts** · Wave 3 done **43/43 pts** · **Wave 4 done 25/25 pts — বন্ধ** · **Wave 5 done 31/31 pts — বন্ধ** (`9.1-BE` · `9.2-BE` · `6.1-BE` · `6.2-BE` · `9.4-FE` · `6.1-FE` · `6.2-FE`) · **Wave 6 done 59/59** (`8.1-BE` · `8.1-FE` · `8.0-BE` · `8.0-FE` · `8.2a-BE` · `8.2b-BE` · `8.2-FE` · `8.3a-BE` · `8.3a-FE` · `8.3b-BE` · `8.3b-FE`) — **বন্ধ**। **বাকি:** 0 card · **0 pts** — Attendance/Payroll spine complete। > এই টেবিলটা 16 Aug পর্যন্ত সাতটা merged card পিছিয়ে ছিল (114/29 লেখা ছিল)। 17 Aug 2026-এ Seq সারিগুলোর status থেকে গুনে মেলানো হয়েছে — **যেকোনো অমিলে Seq সারিই সঠিক ধরুন**, ওগুলো card-ভিত্তিক। **টেস্ট gap (merge হয়েছে, DoD পুরোপুরি হয়নি):** **7.4-BE** — CRUD/422/409 feature test আছে (`backend/tests/Feature/EmployeeDeductionTest.php`), কিন্তু DoD-এর idempotency test (generate + ২ বার regenerate = একটাই decrement) ও negative-net-pay skip test নেই। **3.2-BE** — status-ladder branch এখন ঢাকা (নিচের ফিক্স দেখুন), কিন্তু session-pairing ও visibility-scoping test এখনো নেই। **8.2a-BE** ধরার আগে বাকিটা ঢাকা উচিত। > ### ✅ 3.2-BE — `calculateDaily`-র shift resolution ঠিক করা হয়েছে (10 Aug 2026, Siam) > > **যা ভাঙা ছিল:** `AssignmentResolutionService` `ResolvedContext::$shift`-এ **`Assignment` row** বসায় (`assignable_type='shift'`, `assignable_id=`) — আসল `Shift` কখনো load হতো না। `AttendanceRecordService` ওটাকে shift ধরে `start_time` · `grace_minutes` · `working_hours` · `min_hours_present` · `min_hours_half_day` · `working_days` পড়ত, যার একটাও `assignments`-এ নেই। ফলে **weekend ও holiday কখনো resolve হতো না**, সব shift parameter fallback default-এ চলত, আর `attendance_records.shift_id`-তে assignment id বসত। > > **ফিক্স:** `AttendanceRecordService` এখন assignment থেকে আসল `Shift` ও holiday `AttendancePolicy` load করে — ঠিক যেভাবে `PunchService` আগে থেকেই করত। `ResolvedContext`-এর আকার বদলানো হয়নি, তাই `PunchService` / resolution controller / recalculation service অক্ষত। `isWorkingDay()` এখন ISO day number (1=Mon … 7=Sun) মেলায়, `isHoliday()` policy config পড়ে ও recurring holiday একই month/day-তে মেলায় (1.3-BE-র রুল)। > > **সাথে আরেকটা bug:** `AttendancePunchRepository` `where('attendance_date', $date)` করত, কিন্তু model তারিখটা time-সহ persist করে। MySQL DATE কলামে truncate হয় বলে prod-এ চলত, **SQLite-এ কখনোই মিলত না** — এ কারণেই 3.2-BE-র calculation test কোনোদিন লেখা যায়নি। এখন `whereDate()`, দুই driver-এই সঠিক। > > **টেস্ট:** `AttendanceDailyCalculationTest` — weekend · working day · holiday · recurring holiday · non-recurring অন্য বছরে না মেলা · grace-এর ভিতরে present · grace-এর বাইরে late (shift-এর নিজের 15 মিনিট) · shift-এর নিজের 3-ঘণ্টা half-day threshold · `shift_id` ও snapshot-এ আসল shift। **9 test green।** > > এতে 3.2-BE-র টেস্ট-ঋণের status-ladder অংশটা ঢাকা পড়েছে; **session-pairing ও visibility-scoping test এখনো বাকি**। ### ⚠ Employee module-এর দুটো পরিবর্তন যা **সব lane-কে ছোঁয়** (17 Aug 2026) এই দফার ছয়টা কাজের বিস্তারিত ফাইলের শেষে। তার মধ্যে দুটো নিজের module-এ আটকে নেই — attendance/payroll-এ কাজ করলেও গায়ে লাগবে: | কী | কাকে ছোঁয় | |---|---| | **`BangladeshGeoSeeder` এখন `DatabaseSeeder`-এ** — নতুন `geo_divisions` / `geo_districts` / `geo_post_offices` টেবিল, ১৩৩০ row | **যে কোনো test যা `$this->seed()` ডাকে** এখন এই row গুলোও seed করে। পাঁচটা bulk `upsert` statement বলে খরচ নগণ্য, কিন্তু `migrate:fresh` ছাড়া পুরনো DB-তে নতুন migration চালানো লাগবে | | **শেয়ার্ড `Select`-এ deselect fix** — placeholder এখন optional field-এ selectable | **৭৬টা ফাইল `` ছিল — ctrl-click দিয়ে set বানানো একটা পরিচিত ফাঁদ (এক ক্লিকে আগের সব নির্বাচন চলে যায়), আর drawer-এর ভিতরে scroll করার সময় সেটা আরও খারাপ। এখন scroll করা একটা checkbox তালিকা; নির্বাচন যোগ-বিয়োগ হয়, হারায় না। **Step-এর move up / move down / remove — icon button + tooltip।** `step_order` প্রতিটা কাঠামোগত বদলের পর নতুন করে গোনা হয়, কারণ backend index নয়, ঐ সংখ্যাটা ধরেই step চালায়। **Version-এর কথাটা এখন যেখানে দরকার সেখানেই।** "steps বদলালে নতুন version হয়, চলমান request অক্ষত থাকে" — এটা আগে page subtitle-এ ছিল, যেখানে কাজ শুরু করার আগেই চোখে পড়ত; এখন edit drawer-এর ভিতরে alert হিসেবে, ঠিক যেখানে step বদলানো হচ্ছে। --- ## Platform › Approval Settings + Requests → new design (13 Aug 2026) Approvals menu-র বাকি দুটোই শেষ। `ApprovalRequestDetail.tsx` (৩৩৯ লাইন page) মুছে `components/ApprovalRequestDrawer.tsx`, list থেকেই `?request=` দিয়ে খোলে; পুরনো route redirect হয়। Settings আর Requests list দুটোই Tailwind। platform-এর ১৭টা ফাইল এখন gate-এর ভিতরে (মোট ৩০টা path) — বাকি শুধু Actions · Activity logs · OTP। **`ApprovalStatusBadge` Tailwind-এ এসেছে, আর এটা একটা চুপচাপ ফাঁক বন্ধ করল।** ওটা `modules/core/components`-এ থাকে, gate-এর বাইরে — কিন্তু ব্যবহারকারী attendance (৪), payroll (২) আর platform (৩), অর্থাৎ **সবগুলোই migrated module**। ফলে Tailwind screen-এর ভিতরে `badge bg-label-*` মার্কআপ বসত আর gate সেটা ধরত না, কারণ call site-এ কেবল `` লেখা থাকে। এখন ওটা `ui/StatusBadge`-এর পাতলা মোড়ক: চেহারা বাকি সব badge-এর সঙ্গে এক, আর কেবল approval-এর শব্দভাণ্ডার — বড় status set আর "Pending approval" ভাষাটা — ওখানে থাকে। `PendingApprovalAction`-এর `d-inline-block`-ও সঙ্গে গেছে। দুটো ফাইলই এখন gate-এ তালিকাভুক্ত। কোনো Bootstrap-side caller নেই, তাই পুরনো মার্কআপ ধরে রাখার দরকারও ছিল না। **`ui/StatusBadge`-এ `title` prop যোগ হয়েছে** — pending badge-এ hover করলে "Pending approval" দেখানোটা approval badge-এর পুরনো আচরণ, সেটা হারাতে দেওয়া হয়নি। **Request detail drawer-এ পাঁচটা action একসাথে থাকে** — approve · reject · delegate · cancel · comment। প্রথমে ওগুলো একটা helper দিয়ে বানানো হয়েছিল যেটা ভিতরে `useMutation` ডাকত; hook order স্থির থাকলেও **সেটা rules-of-hooks ভাঙে** (helper-টা component নয়, hook-ও নয়), তাই পাঁচটা `useMutation` আলাদা করে লেখা হয়েছে আর কেবল success/error handler দুটো factory-তে রাখা হয়েছে। কোডটা কিছুটা লম্বা, কিন্তু নিয়ম মানে। **যে কাজ করা যাবে না, সেটা এখন বলে দেয়।** আগের page-এ approver না হলে বোতামগুলো কেবল উধাও হয়ে যেত। এখন একটা লাইন থাকে — "আপনি এই step-এর approver নন, তাই কেবল comment করতে পারবেন" বা "request বন্ধ, কেবল comment যোগ হবে"। **Settings-এর workflow select কেন approval চালু থাকলে locked** — লিংকটা toggle-এর সঙ্গেই commit হয়, তাই চালু অবস্থায় নীরবে workflow বদলালে live routing বদলে যেত। আচরণটা আগেও এমনই ছিল; এখন কারণটা কোডে লেখা আছে। --- ## Activity Log + Onboarding Policies → new design (13 Aug 2026) Gate এখন **৩৪টা path** পাহারা দেয়। platform-এ বাকি কেবল **Actions (list + form) আর OTP log** — ঐ তিনটে হলে পুরো module directory হিসেবে বসানো যাবে, ফাইল ধরে ধরে নয়। ### Activity Log Detail-এর Modal সরে drawer হয়েছে, আর `ActivityLogPropertiesViewer` Tailwind-এ। Viewer-টার তিন স্তরের গঠন অপরিবর্তিত — employee module যে status-change লেখে সেটা আগে, তারপর যে কোনো before/after diff, শেষে সাদামাটা key/value dump; শেষেরটা থাকার কারণেই নতুন কোনো event type এলে ফাঁকা না দেখিয়ে অন্তত ডেটাটা দেখায়। **এই drawer-টা ইচ্ছাকৃতভাবে URL-driven নয়** — বাকি সবগুলো যেখানে `?param=` ধরে খোলে। কারণ একটামাত্র log আনার কোনো endpoint নেই (`activityLogsApi`-তে আছে শুধু `list` আর `exportCsv`), তাই share করা লিংক এমন একটা সারিতে গিয়ে পড়ত যেটা list-এর প্রথম page-এ না-ও থাকতে পারে। ফাইলে কারণ লেখা আছে। **হাতে লেখা pagination সরিয়ে `DataTable`-এর `pagination`/`onPageChange` ব্যবহার করা হয়েছে** — response-এর `meta` সরাসরি পাস হয়, তাই Previous/Next-এর নিজস্ব কোড আর নেই। ### Onboarding Policies `OnboardingPolicyForm.tsx` (২৩৮ লাইন page) মুছে `components/OnboardingPolicyFormDrawer.tsx`; URL — `?mode=create` আর `?mode=edit&policy=`, পুরনো দুটো route redirect হয়। **onboarding module-এর কেবল এই দুটো ফাইল migrated**, বাকিগুলো (OTP · password · documents — ওগুলো onboarding shell-এর নিজস্ব layout) Bootstrap-side, তাই gate-এ ফাইল ধরে তালিকাভুক্ত। **Delete-এ confirmation যোগ হয়েছে।** এই list-টাই একমাত্র ছিল যেখানে row-এর Delete সরাসরি চলত, কোনো প্রশ্ন ছাড়াই। Policy ঠিক করে কাকে জোর করে onboarding করানো হবে — বাকি সবার মতো একটা confirm step ওটারও প্রাপ্য। **Step form-এ চারটে flag ফিরে এসেছে।** `is_required` · `is_blocking` · `allow_skip` · `is_active` — চারটেই API payload-এ যেত আর `defaultStep()`-এ hard-code করা ছিল, কিন্তু ফর্মে কোনো field ছিল না, তাই তৈরির পর আর কখনো বদলানো যেত না। (`EmployeeGradeForm`-এর `grade_code`-এর মতোই ফাঁক।) **Saved step মোছা যায় না, নিষ্ক্রিয় করা যায়।** API-তে policy step delete করার endpoint নেই, তাই যে step একবার save হয়েছে তাকে UI থেকে "সরালে" সেটা আসলে থেকেই যেত — নীরবে। এখন কেবল যে step এখনো save হয়নি তার Remove বোতাম থাকে; save হওয়া step-এ লেখা থাকে "untick Active to retire it"। --- ## Qbits migration: COMPLETE (13 Aug 2026) **পুরো frontend Tailwind-এ।** Gate এখন ফাইল ধরে ধরে নয়, **দশটা গোটা ডিরেক্টরি** পাহারা দেয়: ``` src/shared/components/ui src/shared/context src/modules/auth src/modules/employee src/modules/attendance src/modules/payroll src/modules/configuration src/modules/platform src/modules/core src/modules/onboarding ``` ### শেষ ধাপে যা হলো **Platform-এর বাকি তিনটে।** `ActionForm.tsx` page মুছে `components/ActionFormDrawer.tsx` (`?mode=create`) — create-only, কারণ API-তে action update করার endpoint নেই আর catalogue-টার মালিক `config/actions.php`; ফাইলে সেটা লেখা আছে। `ActionList` তিনটে section-সহ Tailwind-এ। `OtpLogPage`-এর হাতে লেখা table `DataTable` হয়েছে আর OTP code-টা বড় monospace-এই থাকল — ঐটাই তো screen-টার পুরো কাজ। **`OtpLogPage`-এর দুটো dev-leftover সরানো হয়েছে:** `queryFn`-এর ভিতরে একটা `console.log` প্রতিটা refetch-এ OTP সহ পুরো response browser console-এ ফেলত (১০ সেকেন্ড অন্তর), আর একটা "Debug:" strip ঐ একই মান UI-তে দেখাত। "Show raw" বোতামটা ইচ্ছাকৃত feature, সেটা আছে — ঐ দুটোর কাজ ওটাই করে। **Onboarding।** চারটে step page (mobile OTP · email OTP · password · documents) Sneat-এর `authentication-wrapper` ছেড়ে নতুন `components/OnboardingCard.tsx`-এ বসেছে — **login screen-এর হুবহু একই lockup**, কারণ ব্যবহারকারী sign-in-এর ঠিক পরেই এই পর্দাগুলো দেখে, আর সেখানে অন্যরকম দেখতে পাতা মানে অন্য একটা product। `AppBrand.tsx` মুছে গেছে; ওর একমাত্র কাজ ছিল এই চারটেকে brand দেখানো, এখন `BrandMark` করে। Route guard দুটো (`OnboardingRoute` · `RequirePermissionRoute`) আর `DocumentWarningBanner`-ও সঙ্গে গেছে। **Password পাতায় একটা ছোট আচরণ যোগ হয়েছে** — দুটো password না মিললে এখন field-এ লেখা ওঠে আর Save নিষ্ক্রিয় থাকে। আগে দুটো আলাদা মান নিয়েই submit হতো, আর ভুলটা জানা যেত server-এর উত্তর আসার পর। ### `shared/components/common/*` এখন সম্পূর্ণ অব্যবহৃত বারোটা ফাইল — `DataTable` · `Modal` · `Offcanvas` · `FormInput` · `FormSelect` · `PageHeader` · `StatusBadge` · `EmptyState` · `ConfirmDialog` · `TextDivider` · `IconPicker` · `offcanvasStack` — **কোনো ফাইল আর এগুলো import করে না** (`rg "components/common/"` ফাঁকা)। পুরো Bootstrap-side component library এখন মৃত কোড। **মোছা হয়নি।** cleanup আলাদা কাজ, আর সেটা বলার আগে শুরু না করার নির্দেশ আছে। এখানে কেবল রেকর্ড করা হলো যে ওটা এখন নিরাপদে মোছা যায়: `bootstrap` / `bootstrap-icons` npm dependency, `erpflow.scss`-এর Bootstrap import, `check-bootstrap.sh`, আর `useLayoutHtmlClass('auth')`-এর মতো Sneat-যুগের hook-গুলোও ঐ একই কাজের অংশ হবে। --- ## style-boundary gate কোনোদিন চলেনি — এখন চলে (13 Aug 2026) Bootstrap সরানোর পরিকল্পনা করতে গিয়ে ধরা পড়ল: **`scripts/check-style-boundary.sh` একটা কাজও করেনি।** স্ক্রিপ্টটা `rg` (ripgrep) ডাকত, আর **frontend container-এ `rg` ইনস্টল করা নেই** — যেখানে `npm run build` ওটা চালায়: ``` $ docker compose exec -T frontend sh -c 'command -v rg' → কিছু না ``` প্রতিটা `rg` call ব্যর্থ হতো, `2>/dev/null` stderr গিলে ফেলত, তাই `report()`-এর `if OUT=$(rg …)` সবসময় false আর rule 3-এর `UNPREFIXED` সবসময় ফাঁকা। এরপর স্ক্রিপ্ট ছাপত `✓ style boundary clean (N path(s) checked)` — **path সংখ্যাটা আসল** (`[ -e "$d" ]` দিয়ে গোনা, তাই migration-এর সঙ্গে সঙ্গে বাড়ত আর বিশ্বাসযোগ্য দেখাত), **চারটে rule-ই ভুয়া**। Host-এও একই: shebang `#!/usr/bin/env sh`, আর `sh`-এর PATH-এ `rg` নেই। মানে এই migration-এর প্রতিটা ধাপে "gate clean" বলে যা রিপোর্ট করা হয়েছে, তার কোনোটাই প্রমাণ ছিল না। ### ফাঁকটা আসলে কতটা খরচ করাল — প্রায় কিছুই চারটে rule হাতে চালিয়ে (python, দশটা ডিরেক্টরির ৩০৩টা ফাইলে) যা পাওয়া গেল: | Rule | হিট | |---|---| | Bootstrap class | **০** | | Hard-coded `tw:z-[…]` | **০** | | `bi bi-` | ২টা, দুটোই doc comment (`attendance/utils/attendanceTypeIcon.ts:120`, `platform/utils/moduleIcon.ts:58` — "Tolerates both the `bi bi-foo` and bare `bi-foo` forms") | | Unprefixed token | **১টা আসল bug** | migration নিজে সত্যিই পরিষ্কার ছিল — gate না থাকা সত্ত্বেও। **আসল bug-টা:** `last:tw:border-b-0`, `attendance/components/corrections/CorrectionRequestForm.tsx:66` আর `attendance/pages/corrections/CorrectionRequestDetailPage.tsx:35`-এ। Tailwind v4-এ prefix সবার বাইরে বসতে হয় (`tw:last:border-b-0`), নইলে কোনো CSS emit হয় না — শেষ সারির border কখনো যেত না। **নতুন gate ওটা তার প্রথম run-এই ধরেছে**, যেটাই সবচেয়ে ভালো প্রমাণ যে এখন সত্যি চলছে। ### যা বদলাল **POSIX tool ছাড়া কিছু নয়।** `rg` → `find` + `grep -nHE`। BusyBox grep-এ `-H` · `-o` · `-E` · ERE-র `\b` সবই আছে, container-এ যাচাই করা। **চুপচাপ ব্যর্থ হওয়ার তিনটে পথ বন্ধ:** - `require()` — `find grep sed sort tr wc`-এর একটাও না পেলে বার্তা দিয়ে `exit 1` - `2>/dev/null` সরানো; grep-এর non-zero exit এখন `|| true` দিয়ে সামলানো, তাই "কোনো hit নেই" আর "চলেইনি" আলাদা - ফাইল তালিকা ফাঁকা হলে **clean বলতে অস্বীকার করে** — `refusing to report clean`, exit 1 **Summary line এখন ফাইল সংখ্যাও বলে** — `10 path(s), 303 file(s) checked`। শূন্য-scan আর চোখ এড়াবে না; আগের লাইনটায় কেবল path গোনা হতো বলেই ভাঙা অবস্থাটা এত দিন বিশ্বাসযোগ্য দেখিয়েছে। **Rule 2 এখন `className=` দিয়ে anchored** — markup পড়ে, prose নয়। আগে গোটা লাইনে `bi bi-` খুঁজত, তাই দুই icon resolver-এর ব্যাখ্যামূলক comment violation হিসেবে ধরা পড়ত। ### যাচাই Dashboard-এ একটা করে ভুল class ঢুকিয়ে চারটে rule আলাদাভাবে fire করানো হয়েছে, প্রতিবার ফাইল restore করে (`git diff` ফাঁকা): | ঢোকানো | কে ধরল | |---|---| | `d-flex` | rule 1 | | `col-md-6` | rule 1 | | `bi bi-star` | rule 2 | | `tw:z-[9999]` | rule 3 | | `flex` | rule 4 | Missing-tool পথ: `require rg` → বার্তা সহ `exit 1`। শেষে `npm run build` → pass। ### শিক্ষা একটা গেট যা ব্যর্থ হলে সবুজ দেখায়, সেটা গেট নয় — সাজসজ্জা। নতুন কোনো build check লিখলে **ভাঙা অবস্থাটা আগে দেখে নিতে হবে**: ইচ্ছে করে একটা violation ঢুকিয়ে লাল হতে দেখা, তারপরই সবুজটাকে বিশ্বাস করা। --- ## Bootstrap + Sneat সরানো হয়েছে (13 Aug 2026) Frontend এখন **কেবল Tailwind**। Branch: `remove-bootstrap`। ### ফল | | আগে | পরে | |---|---|---| | `dist/assets/*.css` | 443,989 B | **50,957 B** (−88%) | | JS bundle | 1,804,960 B | **1,714,895 B** (−90 KB, `bootstrap.bundle.min.js`) | | Icon font | 314 KB (woff + woff2) | **০** — একটাও glyph render হতো না | | CSS-এ Bootstrap selector | ২,৪৮৪ | **০** | ### কী কী গেল **Dead code:** `shared/components/common/` (১২ ফাইল, ০ importer) · `useLayoutHtmlClass.ts` + ৬টা call site (যে `` class সেট করত তার কোনো CSS selector আর পৌঁছাত না) · `src/assets/sneat/` (৩৯টা unreferenced ছবি) · তিনটে কখনো import না হওয়া `sneat/pages/*.scss`। **Bootstrap নিজে:** `main.tsx`-এর দুটো import · `app.scss` · `erpflow.scss` · `src/styles/sneat/` (৮৭ ফাইল, ৭,৪৮৫ লাইন) · `index.html`-এর Sneat `` attribute আর bootstrap-icons CDN link · `vite.config.ts`-এর পুরো scss preprocessor block · `package.json`-এর `bootstrap` · `bootstrap-icons` · `@popperjs/core` · `sass` আর `overrides` block · `check-bootstrap.sh` আর `docker-entrypoint.dev.sh`-এ তার call। ### `tw:` prefix গেছে — ১৯০ ফাইলে ৭,০৬২ জায়গা Prefix-টা **কেবল** Bootstrap-এর সঙ্গে class-name সংঘর্ষের জন্য ছিল (Bootstrap-এর `px-4` = 1.5rem, Tailwind-এর 1rem, আর Bootstrap তার utility-তে `!important` দিত)। সংঘর্ষটাই নেই, তাই prefix-ও নেই। `cn.ts`-এর `extendTailwindMerge({ prefix: 'tw' })` সরিয়ে সাধারণ `twMerge` হয়েছে — নইলে tailwind-merge আর conflicting class চিনত না। ### Reboot → preflight — এটাই ছিল আসল ঝুঁকি `tailwind.css` preflight import করত না, কারণ Bootstrap Reboot base reset-এর কাজ করত; তার বদলে হাতে লেখা একটা "scoped preflight" block (`element:where([class*='tw:'])`) ঘাটতি পোষাত। এখন `@import 'tailwindcss'` পুরোটা আনে — theme + preflight + utilities, layered — আর ঐ হাতে লেখা block মুছে গেছে। **এতে প্রতিটা element-এর default বদলায়**, তাই manual pass লাগবে (নিচে দেখুন)। ### z-index scale ছোট করা হয়েছে Token-গুলো Bootstrap-এর stacking range (modal 1055, আর `app.scss` backdrop-কে 1090-এ ঠেলত) পেরোনোর জন্য 1200–1600-এ বসানো ছিল। এখন 100–600। `overlayStack.ts`-এর hard-coded base দুটোও (1320/1325 → 320/325) সঙ্গে নামানো হয়েছে — সম্পর্কগুলো অবিকল একই। ### Gate-টা বদলেছে, ওঠেনি `check-style-boundary.sh` এখন **পুরো `src`** দেখে (আগে ১০টা ডিরেক্টরির তালিকা), আর rule 3 (prefix) অবসরে গেছে। বাকি তিনটে থাকল কারণ ওগুলোর কাজ বদলায়নি: পুরনো snippet git history · বন্ধ PR · task card থেকে copy হয়ে ফেরে, আর pasted `class="btn btn-primary"` এখন **নীরবে unstyled text** হবে, জোরে ভাঙবে না। z-index rule-ও থাকল। ### বাকি যা ইচ্ছাকৃতভাবে রইল - `modules.icon` আর attendance type-এর `bi-*` **নাম** DB-তে আছে — render-time-এ lucide-তে map হয় (`moduleIcon.ts` · `attendanceTypeIcon.ts`)। **কোনো data migration লাগেনি**, font সরানোয় কিছু বদলায়নি। - দুটো doc comment (`useOnClickOutside` · `Dropdown`) বলে ওরা `bootstrap.bundle.js`-এর কোন আচরণের বদলি — কেন component-টা আছে সেটার ব্যাখ্যা, তাই রইল। - `public/assets/sneat/` → **`public/assets/illustrations/`** নাম বদলেছে; Dashboard-এর একমাত্র ছবিটা ওখানেই। ### যাচাই `npm run build` pass — `tsc -b` ০ error, style check clean (৩১৫ ফাইল), vite build ✓। `oxlint src` — ০ error, ২৫টা warning, সবগুলোই আগে থেকেই ছিল। **Manual pass এখনো বাকি** — frontend-এ কোনো test suite নেই, আর preflight পুরো app-এর element default বদলায়। দেখতে হবে: login → onboarding step → dashboard → employee profile drawer → attendance records → payroll salary structure → configuration list + drawer → platform roles + permission drawer। বিশেষ করে typography scale · list bullet · `
` divider · button reset · table spacing। আর ID card preview-র print check (ওর scoped `