# Admin Panel Production Blueprint & Checklist

> **Audit date:** 2026-09-30 · **Stack verified:** Laravel 13.24.0 · Filament 3.3.54 · Livewire 3 · PHP 8.5.4 · MySQL 8 (`promptery_db`) · Vite 8.2
> **Baseline:** `php artisan test` → **14 passed (136 assertions)** · `php artisan route:list --path=admin` → **19 routes**
> এই ডকুমেন্ট কোনো জেনেরিক থিওরি নয় — বর্তমান ওয়ার্কিং ট্রির ফাইল, মাইগ্রেশন, মডেল, রুট এবং লাইভ ডেটাবেজ (`promptery_db`) স্ক্যান করে তৈরি। যেখানে এই ডকুমেন্ট আর কোড ভিন্ন হবে, **কোড জিতবে** — তখন দুটোই আপডেট করুন (`README.md`-এর কনভেনশন অনুসারে)।

---

## 0. Audit Method (কীভাবে ভেরিফাই করা হয়েছে)

| ধাপ | কমান্ড / ফাইল |
| :--- | :--- |
| রুট ইনভেন্টরি | `php artisan route:list --path=admin`, `routes/web.php` |
| স্কিমা | `database/migrations/*` (30টি), `SHOW COLUMNS FROM users/products/orders/reviews/tickets` |
| ডেটা স্ন্যাপশট | `DB::table(...)->count()` per টেবিল |
| প্যানেল কনফিগ | `app/Providers/Filament/AdminPanelProvider.php`, `User::canAccessPanel()` |
| ইউআই সারফেস | `app/Filament/Resources/*` (7টি), `app/Filament/Pages/*` (2টি) |
| সিকিউরিটি | `app/Http/Controllers/AuthController.php`, `app/Http/Controllers/StripeWebhookController.php`, `app/Http/Middleware/EnsureVendorIsVerified.php` |
| গ্যাপ স্ক্যান | `grep -rln 'Gate::\|extends Policy\|hasRole\|hasPermission\|RateLimiter\|throttle\|SoftDeletes\|Log::' app/` → **কোনো ম্যাচ নেই** |

**লাইভ ডেটা (`promptery_db`, 2026-09-30):** `users`=6 (admin 1 / vendor 3 / customer 2) · `products`=52 · `orders`=4 (paid 2) · `reviews`=1 · `tickets`=1 · `ticket_messages`=2 · `vendor_payouts`=0 · `vendor_settings`=3 · `coupons`=0 · `categories`=**1514** · `follows`=2 · `favorites`=3 · `payout_methods`=1 · `site_settings`=4 · `notifications`=6 · `jobs`=9 · `failed_jobs`=0 · `sessions`=8

---

## 1. Project & Schema Analysis

### 1.1 Core Entities (Domain Model) ও তাদের Admin Coverage

| # | Table | Model | আজ অ্যাডমিন প্যানেলে আছে? | অবস্থান |
| :-- | :--- | :--- | :--- | :--- |
| 1 | `users` | `App\Models\User` | ✅ Full CRUD + KYC + Ban + Manual Payout + DM | `/admin/users` |
| 2 | `products` | `App\Models\Product` | ✅ Approve/Reject/Edit/Delete | `/admin/products` |
| 3 | `orders` | `App\Models\Order` | ⚠️ Read-only list + 3 actions (`markPaid`/`openDispute`/`refund`) | `/admin/orders` |
| 4 | `reviews` | `App\Models\Review` | ✅ Moderation (approve/reject/edit/delete) | `/admin/reviews` |
| 5 | `categories` | `App\Models\Category` | ✅ 1514 rows, single modal page | `/admin/categories` |
| 6 | `tickets` + `ticket_messages` | `App\Models\Ticket`, `TicketMessage` | ✅ View/Edit thread | `/admin/tickets` |
| 7 | `vendor_payouts` | `App\Models\VendorPayout` | ⚠️ Approve/Reject/Edit (bulk = শুধু Delete) | `/admin/payouts` |
| 8 | `vendor_settings` | `App\Models\VendorSetting` | ❌ নেই — শুধু 3টি `Placeholder` (country/city/address/zip) `UserResource`-এ; **storefront policies, announcement, vacation_mode অ্যাডমিন দেখতেই পারে না** | — |
| 9 | `payout_methods` | `App\Models\PayoutMethod` | ❌ **কোনো UI নেই** (bank/card/crypto/paypal + `identifier` + `details` JSON) | — |
| 10 | `coupons` | `App\Models\Coupon` | ❌ **কোনো UI নেই** — অ্যাডমিন coupon abuse/fraud দেখতে পারে না | — |
| 11 | `follows` | `App\Models\Follow` | ❌ নেই | — |
| 12 | `favorites` | `App\Models\Favorite` | ❌ নেই | — |
| 13 | `site_settings` | `App\Models\SiteSetting` | ⚠️ শুধু ৪টি key (telegram/discord/community title+description) | `/admin/site-settings` |
| 14 | `notifications` | (Filament DB notifications) | ⚠️ শুধু Bell — outgoing/সব ইউজারের মেসেজ অডিট করার UI নেই | — |
| 15 | `jobs`, `failed_jobs` | infra | ❌ queue monitor নেই (৯টি job পড়ে আছে, `QUEUE_CONNECTION=sync`) | — |
| 16 | `sessions` | infra | ❌ active session / force-logout UI নেই | — |

> **অনুপস্থিত পুরো ফিচার-ডোমেইন:** `roles/permissions`, `audit_logs`, `login_attempts`/`admin_sessions`, `webhook_events` (Stripe event log), `refunds`/`disputes` লেজার, `wallet_transactions`, `announcements`/`banners`, `email_templates`, `product_view_logs` (analytics), queue-monitor।

### 1.2 Entity Relations (মাইগ্রেশন থেকে ভেরিফাইড)

```
                          ┌───────────────────────────┐
                          │  users (role, is_banned)  │
                          └────┬───────┬───────┬──────┘
        products.user_id (CASCADE)│       │       │ vendor_settings.user_id (1:1, CASCADE)
                    ┌─────────────┘       │       └──────────► vendor_settings
                    ▼                     │                     (country, nid_no, payout_details,
              ┌───────────┐               │                      store_banner, announcement,
              │ products  │               │                      vacation_mode, policies)
              └─┬───┬───┬─┘               │       │ vendor_payouts.user_id (CASCADE) ─► vendor_payouts
 orders.product_id│  │   │reviews.product_id      │ payout_methods.user_id  (CASCADE) ─► payout_methods
   (CASCADE!) ⚠️ │   │   │  (CASCADE)      │       │ coupons.user_id      (CASCADE) ─► coupons
                ▼   │   ▼                 ▼       │ tickets.user_id      (CASCADE) ─► tickets
           ┌────────┐ │ ┌─────────┐  ┌─────────────────────┐
           │ orders │ │ │ reviews │  │ follows (user_id,   │  UNIQUE(user_id, vendor_id)
           └────────┘ │ └─────────┘  │  vendor_id) → users  │  favorites (user_id, product_id)
                      │              └─────────────────────┘  UNIQUE(user_id, product_id)
                      ▼
              ┌──────────────────┐        ┌────────────────┐
              │ favorites (P×U)  │        │   categories   │ self-ref parent_id (CASCADE)
              └──────────────────┘        │ main→sub→class │  1514 rows
                                          └────────────────┘
   ⚠️ products.category / sub_category / class_category = VARCHAR (STRING), NOT a foreign key ❌
      (Product::category → categories.slug/name এর সাথে loose string matching — `Category::products()` দেখুন)
```

**Eloquent রিলেশন ম্যাপ (`app/Models/`):** `User`: `vendorSetting()` hasOne · `vendorPayouts()` hasMany · `payoutMethods()` hasMany · `products()` hasMany · `orders()` hasMany · `followers()`/`following()` hasMany(Follow) · `favoriteProducts()` belongsToMany · `reviewsGiven()`/`reviewsReceived()` hasMany(Review) · `tickets()`/`ticketMessages()` hasMany
`Product`: `user()` belongsTo · `orders()` hasMany · `reviews()` hasMany · `favoritedBy()` belongsToMany
`Order`: `product()`, `user()` belongsTo · `Review`: `user()`, `product()`, `vendor()` · `Ticket`: `user()`, `messages()`, `latestMessage()` · `Category`: `parent()`, `children()`, `subCategories()`, `classCategories()`, `products()`

### 1.3 বর্তমান Admin Surface (১৯টি রুট — `php artisan route:list --path=admin`)

| রুট | ক্লাস | ক্যাননিক্যাল ক্যাপাবিলিটি |
| :--- | :--- | :--- |
| `/admin` | `Filament\Pages\Dashboard` | ⚠️ **শুধু `AccountWidget` + `FilamentInfoWidget`** — `app/Filament/Widgets/` ডিরেক্টরিটি **অস্তিত্বই নেই**, তাই অ্যাডমিন ড্যাশবোর্ডে একটিও KPI/চার্ট নেই |
| `/admin/products` | `ProductResource` | List + Create + Edit; per-row Approve/Reject (reason সহ)/Delete; bulk = **শুধু Delete** |
| `/admin/categories` | `CategoryResource` | Single page `ManageCategories`; auto-slug; parent/type; bulk Delete |
| `/admin/users` | `UserResource` | Full CRUD; KYC review modal; Ban/Unban; Balance & Manual Payout; Direct Message; bulk **শুধু Delete** |
| `/admin/orders` | `OrderResource` | `canCreate/canEdit/canDelete = false`; `recordUrl(null)`; actions: Mark Paid / Open Dispute / Refund; `bulkActions([])` |
| `/admin/payouts` | `PayoutResource` | List + Edit; Approve/Reject/Pending actions; bulk **শুধু Delete** |
| `/admin/reviews` | `ReviewResource` | Approve/Reject/Edit/Delete; bulk Delete |
| `/admin/tickets` | `TicketResource` | View (`ViewTicket`) / Edit; filters (status/priority/category); nav badge (open count); bulk Delete |
| `/admin/site-settings` | `ManageSiteSettings` | ৪টি key, `canAccess()` = admin only |

**এখনকার authorization প্যাটার্ন:** প্রতিটি Resource/Page-এ হার্ডকোড `canViewAny()`/`canAccess()` → `auth()->user()?->isAdmin() ?? false`; Panel লেভেলের gate হলো `User::canAccessPanel()` (`role === 'admin'`)। **কোনো `Policy`, `Gate`, `Role`/`Permission` টেবিল, middleware alias বা `throttle` নেই** (`grep -rln 'Gate::\|extends Policy\|hasRole\|RateLimiter\|throttle' app/ routes/ bootstrap/` → শুধু `bootstrap/cache/services.php`)।

### 1.4 Gap Matrix — "ব্যাকএন্ডে আছে, অ্যাডমিন প্যানেলে নেই"

| ব্যাকএন্ড ডেটা | বর্তমান অবস্থা | ব্যবসায়িক ঝুঁকি |
| :--- | :--- | :--- |
| `payout_methods`, `vendor_settings.payout_details` (bank/IBAN/wallet) | **0 visibility** | ❌ Ad-hoc payout verification ও KYC-vs-bank mismatch ধরা যায় না |
| `coupons` (vendor-created) | **0 visibility** | ❌ Unlimited/infinite coupon দিয়ে margin ধ্বংস হলেও টের পাবেন না |
| `vendor_settings.vacation_mode / announcement / refund_policy / license_policy` | **0 visibility** | ❌ Storefront dispute-এ সাপোর্টের কাছে কোনো evidence নেই |
| `orders.stripe_session_id`, `access_token` | Table-এ নেই | ❌ Refund ও buyer-support verification অসম্ভব |
| `products.prompt_text / prompt_file / views_count / license_type / rejection_reason` | Table-এ নেই (শুধু Edit form) | ❌ "কপিরাইটেড কনটেন্ট" moderation ও reach বিশ্লেষণ কষ্টকর |
| `reviews.vendor_reply / replied_at` | Table-এ নেই | ❌ Public vendor reply-এর admin oversight নেই |
| `sessions`, `notifications`, `jobs`, `failed_jobs` | **0 visibility** | ❌ Incident-এ ভেতরের কাউকে force-logout করার উপায় নেই |
| `users.email_verified_at`, login history | App-এ concept-ই নেই | ❌ Fraud/abuse detection-এর কোনো ভিত্তি নেই |
| `orders` (financial record) | Read-only, **export নেই** | ❌ Accounting/CSV reconciliation অসম্ভব — অথচ Vendor প্যানেলে `VendorSalesExporter` আগেই আছে (pattern reuse করা যায়) |
| `follows` / `favorites` | 0 visibility | 🟡 Low priority, তবে engagement analytics-এ লাগবে |

---

## 2. Must-Have Core Features & Functionalities

### 2.1 প্রায়োরিটি ডেফিনিশন

| Tier | মানে | উদাহরণ |
| :--- | :--- | :--- |
| **P0 / Critical** | এটা ছাড়া production-এ যাওয়া = টাকা/ডেটা/কমপ্লায়েন্স ক্ষতি | Audit log, Stripe refund, hard-delete বন্ধ, RBAC, login protection |
| **P1 / Operations** | দৈনিক অপারেশন চালানোর জন্য লাগবে | Bulk approve, exporter, payout verification, coupon oversight, queue monitor |
| **P2 / Analytics & Growth** | সিদ্ধান্ত নেওয়ার জন্য | GMV funnel, vendor leaderboard, retention, coupon ROI |

### 2.2 P0 — Critical (Release Blocker)

1. **Financial Integrity: Orders কখনো হারানো যাবে না**
   `orders.product_id` FK = `cascadeOnDelete()`, `products.user_id` = `onDelete('cascade')`, এবং `UserResource`-এ bulk delete আছে → একজন user মুছলে তার সব `products` → সেই products-এর **সব `orders` (sales/earnings history) CASCADE-এ মুছে যায়**। P0 fix: `orders` FK → `restrictOnDelete()`, আর `products`/`users`/`reviews`/`coupons`-এ `SoftDeletes`।
2. **Real Stripe Refund** — `OrderResource`-এর `refund` অ্যাকশন শুধু `status = 'refunded'` করে; **কোথাও `Stripe\Refund::create()` কল নেই** (`grep -rn 'Refund' app/` → ফাঁকা)। টাকা buyer-এর কাছে ফেরত যায় না, কিন্তু vendor earning বাদ হয়ে যায় → লেজার অমিল। P0: `StripeRefundService` + `refunded_at`,`refund_amount`,`refund_reason`,`stripe_refund_id` কলাম + partial refund + `charge.refunded` webhook।
3. **Webhook Event Log + Idempotency** — `StripeWebhookController` শুধু `checkout.session.completed` হ্যান্ডেল করে; `charge.refunded`, `charge.dispute.created`, `payment_intent.payment_failed` **হ্যান্ডেল করে না**, কোনো event ledger নেই, এবং `webhook_secret` খালি হলে **raw payload-কেই trusted ধরে** (insecure fallback)। P0: `webhook_events` টেবিল (unique `stripe_event_id`) + বাকি ইভেন্ট + read-only অ্যাডমিন ভিউ।
4. **Audit Logging** — `grep 'Log::' app/` = **0 ম্যাচ**। কে কখন কোন order refund করল, কে commission/status বদলাল, কে user ban করল — কোথাও রেকর্ড নেই (Filament notifications user-facing ও ক্ষণস্থায়ী)। P0: `audit_logs` টেবিল + `Auditable` trait + read-only Filament resource।
5. **RBAC** — সব কিছু `isAdmin()`-এ আটকানো; Support/Finance/Moderator আলাদার উপায় নেই → একই পাসওয়ার্ড শেয়ার হবে = কমপ্লায়েন্স ফেইল।
6. **Admin Login Hardening** — `/admin/login` → `AuthController@adminLogin`-এ কোনো `throttle`, rate limit, 2FA বা email-verification নেই; বরং `remember` cookie দেওয়া হয় (`Auth::attempt($credentials, $request->boolean('remember'))`)।
7. **Ban/Session Enforcement** — `is_banned` শুধু লগইনের সময় চেক হয়; প্যানেলের `authMiddleware`-এ প্রতি রিকোয়েস্টে `is_banned`/`role` রি-চেক করার কেউ নেই → **ব্যান করা ইউজারের চালু সেশন কাজ করতে থাকে**। `User::canAccessPanel()`-এও admin চেক `is_banned` দেখে না।
8. **Soft Delete + Restore** — কোনো মডেলে `SoftDeletes` নেই; `DeleteBulkAction` hard delete করে (products/users/reviews/categories) এবং restore করার কোনো উপায় নেই।

### 2.3 P1 — Operations (দৈনিক কাজ চালানোর জন্য)

- **Bulk moderation:** `ProductResource` → BulkApprove / BulkReject(reason) / BulkToggleActive·Featured; `ReviewResource` → BulkApprove/Reject; `PayoutResource` → **BulkMarkCompleted** (reference no সহ)।
- **Exporter:** `OrdersExporter`, `PayoutsExporter`, `UsersExporter`, `CouponsExporter`, `PayoutMethodsExporter` — `app/Filament/Vendor/Resources/VendorSalesExporter.php` প্যাটার্ন হুবহু কপি (`ExportBulkAction` + `Filament\Actions\Exports\Exporter`)।
- **নতুন Resource:** `CouponResource` (monitor + kill-switch), `PayoutMethodResource` (masked identifier + verify flag), `VendorSettingResource` (storefront/policy inspector), `WebhookEventResource`, `AdminNotificationResource` (announcement broadcast)।
- **Ticket ops:** assignee, SLA first-response due, canned replies, internal notes, bulk close/reopen।
- **Category ops:** merge/rename propagation (`products.category` string rewrite), parent move guard (own descendant-এ move আটকানো), bulk activate/deactivate, "orphan category" report।
- **Settings expansion:** `ManageSiteSettings`-এ file group — vendor commission rate, `min_withdrawal`, KYC required on/off, maintenance banner। এখন এগুলো `config/marketplace.php` + `.env`-এ হার্ডকোড।
- **Queue/Monitoring:** `jobs`/`failed_jobs` retry-delete UI; queue worker + **scheduler** চালু (`routes/console.php`-এ এখন কোনো `Schedule::` নেই)।
- **User ops:** impersonate (audit-logged), force-logout all sessions, reset 2FA, resend verification।


### 2.4 প্রতিটি মডেলের CRUD স্পেসিফিকেশন

| Model | Create | Read | Update | Delete | Bulk Action | Export / Import |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| `User` | ✅ admin | ✅ + KYC modal | ✅ role/approve/ban/verify | **Soft delete** (restore; `forceDelete` শুধু super-admin, audit-logged) | Bulk Ban/Unban, BulkVerify, BulkRoleAssign; **Bulk Delete বন্ধ** | Export CSV (email masked) · Import ❌ |
| `Product` | ✅ | ✅ + prompt payload preview | ✅ + `is_featured`, `license_type`, `compare_price` | **Soft delete**; `forceDelete` ❌ by default | BulkApprove / BulkReject(reason) / BulkFeature / BulkActivate | Export CSV/XLSX · Import ❌ |
| `Order` | ❌ (checkout/webhook বানায়) | ✅ + `stripe_session_id`, `access_token` (masked), coupon, commission breakdown | শুধু status-transition অ্যাকশন দিয়ে — **amount কখনো edit নয়** | **কখনো না** (financial; `restrictOnDelete`) | BulkExport (accounting), bulk dispute close | **Export CSV/XLSX (P0)** · Import ❌ |
| `Review` | ❌ | ✅ + vendor reply | ✅ moderation | Soft delete (spam) | BulkApprove / BulkReject | Export CSV |
| `Category` | ✅ | ✅ tree view | ✅ name/slug/type/parent/sort/icon | Soft delete + **"products affected" count** confirmation | Bulk activate/deactivate, BulkMove parent | Export CSV + **Import CSV** (1514 rows-এর একমাত্র বাস্তব উপায়) |
| `Ticket` / `TicketMessage` | ❌ (vendor বানায়) | ✅ thread | status/priority/assignee | Soft delete ticket (GDPR request) | Bulk close / assign | Export CSV (SLA report) |
| `VendorPayout` | ✅ manual adjustment (`UserResource`-এ আছে) | ✅ + destination snapshot | status + `admin_notes` + `reference_no` | **কখনো না** (financial) | **BulkApprove (P0)**, bulk batch export | Export CSV/XLSX (bank batch file) |
| `VendorSetting` | auto (vendor) | ✅ (এখন নেই → P1) | `vacation_mode` override, policy moderation | ❌ | Bulk vacation-mode toggle | ❌ |
| `PayoutMethod` | vendor বানায় | ✅ (এখন নেই → P1, `identifier` masked) | `is_verified`, `is_default` | Soft delete | BulkVerify | ❌ (PII) |
| `Coupon` | ❌ (vendor) | ✅ (এখন নেই → P1) | `is_active` kill-switch | Soft delete | BulkDisable | Export CSV (coupon ROI) |
| `Follow` / `Favorite` | ❌ | ✅ analytics view | ❌ | ❌ | — | Export (engagement) |
| `SiteSetting` | ✅ key/value | ✅ | ✅ | ✅ | — | ❌ |
| `AuditLog` (নতুন) | auto | ✅ read-only; filter by actor/model/action/date | ❌ immutable | ❌ (retention job prune করবে) | Export CSV (compliance evidence) | Export only |
| `WebhookEvent` (নতুন) | auto (Stripe) | ✅ + Replay action | ❌ | ❌ | BulkExport | Export only |

**Soft-delete vs Hard-delete সিদ্ধান্তের নিয়ম:** (a) আর্থিক রেকর্ড (`orders`, `vendor_payouts`) = **কখনোই delete নয়**; (b) ইউজার-জেনারেটেড কনটেন্ট (`products`, `reviews`, `categories`, `coupons`, `payout_methods`, `tickets`) = **soft delete**; (c) লগ (`audit_logs`, `webhook_events`) = **append-only** (retention policy দিয়ে prune)।


---

## 3. Security & Access Control (Production Readiness)

### 3.1 RBAC ডিজাইন (নতুন ডিপেন্ডেন্সি ছাড়া, কোর Laravel + Filament দিয়ে)

বর্তমান `users.role` (`admin|vendor|customer`) কে **অপরিবর্তিত রেখে** তার উপরে staff sub-role যোগ করুন — এতে `User::canAccessPanel()`, `AuthController`-এর তিনটি লগইন ফ্লো এবং `VendorRegister` ভাঙবে না।

**নতুন ৪টি টেবিল (মাইগ্রেশন):** `roles`, `permissions`, `permission_role`, `role_user`

```php
// database/migrations/2026_10_01_000001_create_rbac_tables.php  (নমুনা স্কিমা)
Schema::create('roles', function (Blueprint $t) {
    $t->id();
    $t->string('name')->unique();          // owner, admin, finance, moderator, support, analyst
    $t->string('label');
    $t->json('permissions')->nullable();   // denormalized cache: ["products.approve","orders.refund"]
    $t->boolean('is_system')->default(false);
    $t->timestamps();
});
Schema::create('permissions', function (Blueprint $t) {
    $t->id(); $t->string('key')->unique(); // "products.approve", "payouts.approve", "users.ban"
    $t->string('group')->index(); $t->string('label'); $t->timestamps();
});
Schema::create('permission_role', fn (Blueprint $t) => [
    $t->foreignId('permission_id')->constrained()->cascadeOnDelete(),
    $t->foreignId('role_id')->constrained()->cascadeOnDelete(),
    $t->unique(['permission_id', 'role_id']),
]);
Schema::create('role_user', function (Blueprint $t) {
    $t->foreignId('role_id')->constrained()->cascadeOnDelete();
    $t->foreignId('user_id')->constrained()->cascadeOnDelete();
    $t->foreignId('assigned_by')->nullable()->constrained('users')->nullOnDelete();
    $t->timestamp('expires_at')->nullable();   // temporary access
    $t->unique(['role_id', 'user_id']);
});
```

**Permission naming convention (resource.action):** `products.view|approve|reject|edit|delete` · `orders.view|refund|dispute` · `payouts.view|approve|reject|create` · `users.view|edit|ban|verify|impersonate` · `coupons.view|disable` · `categories.manage` · `settings.manage` · `audit.view` · `system.monitor`

**Role → Permission ম্যাট্রিক্স (প্রস্তাবিত baseline):**

| Permission group | owner | admin | finance | moderator | support | analyst |
| :--- | :---: | :---: | :---: | :---: | :---: | :---: |
| `products.*` | ✅ | ✅ | — | approve/reject | view | view |
| `orders.*` | ✅ | ✅ | ✅ | view | view | view |
| `payouts.*` | ✅ | ✅ | ✅ | — | view | view |
| `users.*` (ban/impersonate) | ✅ | ✅ | view | view | view | view |
| `coupons.*`, `categories.*` | ✅ | ✅ | — | ✅ | — | view |
| `settings.manage` | ✅ | — | — | — | — | — |
| `audit.view` | ✅ | ✅ | ✅ | view | — | ✅ |
| `system.monitor` | ✅ | ✅ | — | — | — | ✅ |

**ইমপ্লিমেন্টেশন পয়েন্ট (কোথায় হুক করবেন):**

1. `app/Models/Role.php` + `User::roles()` belongsToMany + `User::hasPermission(string $key): bool` (roles cached per-request, `Cache::remember("user_perms_{$id}", 300, ...)` — `Category`/`SiteSetting`-এর ক্যাশ প্যাটার্ন একই)।
2. `app/Providers/AppServiceProvider::boot()`-এ একটি গ্লোবাল গেট:
   ```php
   Gate::before(fn (User $u, string $ability) => $u->hasPermission($ability) ? true : null);
   ```
3. **`User::canAccessPanel()` আপডেট (P0):**
   ```php
   if ($panel->getId() === 'admin') {
       return in_array($this->role, ['admin'], true)
           && ! $this->isBanned()
           && $this->hasAnyPermission(['products.view','orders.view','payouts.view','users.view']);
   }
   ```
4. **প্রতিটি Resource-এর `canViewAny/canCreate/canEdit/canDelete`-কে `hasPermission(...)`-এ বদলান** — বর্তমানে ৭টি resource + ১টি page-এ হার্ডকোড `isAdmin()` আছে; এগুলো একে একে migrate করুন। উদাহরণ (ProductResource):
   ```php
   public static function canViewAny(): bool   { return auth()->user()?->hasPermission('products.view'); }
   public static function canDelete($record): bool { return auth()->user()?->hasPermission('products.delete'); }
   public static function canDeleteAny(): bool { return auth()->user()?->hasPermission('products.delete'); }
   ```
   Row-level scoping দরকার হলে `ProductResource::getEloquentQuery()`-এ ভেন্ডর-মালিকানা বা region ফিল্টার যোগ হবে (Vendor resources-এ ঠিক এই প্যাটার্নেই `where('user_id', auth()->id())` করা আছে — `security.md` §1A দেখুন)।
5. **Action visibility-ও permission-driven করুন:** `OrderResource`-এর `markPaid`/`refund`/`openDispute`, `PayoutResource`-এর `approvePayout`/`rejectPayout`, `UserResource`-এর `ban`/`manageBalance` — প্রতিটিতে `->visible(fn () => auth()->user()->hasPermission('payouts.approve'))` যোগ হবে। এখন শুধু `isAdmin()`-নির্ভর ভিজিবিলিটি।
6. নতুন `RoleResource` (`/admin/roles`) — শুধু `owner` role অ্যাক্সেস পাবে, permission checkbox matrix + `role_user` অ্যাসাইনমেন্ট (expiry সহ)।


### 3.2 Admin Route Protection (লেয়ার-বাই-লেয়ার)

বর্তমানে `/admin` সুরক্ষিত শুধু Filament-এর `Authenticate` middleware + `User::canAccessPanel()` দিয়ে। Production-এ ৬টি লেয়ার দরকার:

| লেয়ার | কী করতে হবে | ফাইল |
| :--- | :--- | :--- |
| **1. Network** | `/admin` Cloudflare Access / IP allowlist / VPN-এর পিছনে; `.env`-এ `ADMIN_ALLOWED_IPS=` | নতুন `app/Http/Middleware/RestrictAdminByIp.php`, `AdminPanelProvider::middleware()`-এর শুরুতে |
| **2. Rate limit** | `/admin/login` POST-এ `throttle:5,1` + per-email lockout (`RateLimiter::attempt`); বর্তমানে শূন্য throttle | `routes/web.php`-এ `->middleware('throttle:5,1')` + `AuthController@adminLogin`-এ `RateLimiter` |
| **3. Credential** | min 12-char password policy, 2FA (TOTP), `email_verified_at` বাধ্যতামূলক (বর্তমানে এটি কোনোদিন সেট হয় না → কলাম null-ই থাকে) | `AuthController` + `users.two_factor_secret / two_factor_confirmed_at / recovery_codes` মাইগ্রেশন |
| **4. Session revalidation (P0)** | প্রতি রিকোয়েস্টে `is_banned`, `role`, password-changed-at রি-চেক → ব্যান/রোল-চেঞ্জ হলে সেশন সাথে সাথে বাতিল | নতুন `app/Http/Middleware/RevalidateAdminSession.php`, `AdminPanelProvider::authMiddleware()`-এ `Authenticate::class`-এর পরে |
| **5. Authorization** | §3.1 RBAC + policy-enforced resource gates | `app/Policies/*` + নতুন `AuthServiceProvider` |
| **6. Audit** | প্রতিটি write ও sensitive read লগ | §3.3 |

> `VendorPanelProvider`-এ `App\Http\Middleware\EnsureVendorIsVerified` আগেই এই প্যাটার্নে বসানো আছে — Admin-এ ঠিক একইভাবে panel-level `authMiddleware()`-এ বসাবেন (`bootstrap/app.php`-এ alias না দিয়ে — এটাই `security.md` §1A-এর ডকুমেন্টেড কনভেনশন)।

**Active Session Management:** `sessions` টেবিল (লাইভে 8 rows) ব্যবহার করে `SessionResource` — user, IP, user_agent, `last_activity` দেখিয়ে **Terminate** অ্যাকশন (session row delete + `Auth::logoutOtherDevices`)।
**Impersonation:** শুধু `owner`/`admin`; শুরু ও শেষ দুটোই `audit_logs`-এ `impersonation.start/stop` লেখা বাধ্যতামূলক। Filament v3-এ বিল্ট-ইন impersonate নেই → কাস্টম middleware + `auth()->loginUsingId()` + session flag।


### 3.3 Audit Logging Architecture (P0)

**মাইগ্রেশন `2026_10_01_000002_create_audit_logs_table.php`:**

```php
Schema::create('audit_logs', function (Blueprint $t) {
    $t->id();
    $t->foreignId('actor_id')->nullable()->constrained('users')->nullOnDelete();
    $t->string('actor_name')->nullable();       // denormalized: actor delete হলেও থাকে
    $t->string('actor_role')->nullable();
    $t->string('event', 40)->index();           // created|updated|deleted|restored|login|logout|refund|payout.approved|exported
    $t->string('auditable_type')->nullable()->index();
    $t->unsignedBigInteger('auditable_id')->nullable()->index();   // polymorphic, FK নয় (delete-প্রুফ)
    $t->string('auditable_label')->nullable();  // "Prompt: Minimalist Logo Pack (PRD-482913)"
    $t->json('old_values')->nullable();
    $t->json('new_values')->nullable();
    $t->json('changed_keys')->nullable();       // ["status","is_active"]
    $t->string('ip_address', 45)->nullable();
    $t->text('user_agent')->nullable();
    $t->string('url', 2048)->nullable();
    $t->string('method', 10)->nullable();
    $t->string('panel', 20)->nullable();        // admin|vendor
    $t->boolean('is_sensitive')->default(false); // refund/ban/role-change → আলাদা retention
    $t->timestamps();
    $t->index(['auditable_type', 'auditable_id', 'created_at'], 'audit_target_time_idx');
    $t->index(['actor_id', 'created_at'], 'audit_actor_time_idx');
});
```

**`app/Support/Audit/Auditable.php` trait** — `bootAuditable()`-এ `static::created/updated/deleted/restored` হুক; `getAuditExclude()` দিয়ে `password`, `remember_token`, `prompt_text`, `id_document*` অটো-বাদ; `updated`-এ `$model->getChanges()` থেকে `changed_keys` (এতে `Order`-এর status transition, `User::is_banned`, `Product::status` সব ধরা পড়বে)। **traits বসান:** `Product`, `Order`, `User`, `VendorPayout`, `PayoutMethod`, `Coupon`, `Category`, `Review`, `VendorSetting`, `Role`।

**Admin action log:** `Auditable::logAction('refund', $record, ['reason' => ...])` হেল্পার কল হবে Filament `Action`-এর `->action(function ($record, array $data) { ... })`-এর ভিতরে — অর্থাৎ বর্তমানে যে জায়গাগুলোতে `Notification::make()` লেখা আছে (`OrderResource`-এর `markPaid`/`openDispute`/`refund`, `PayoutResource`-এর `approvePayout`/`rejectPayout`/`pendingPayout`, `UserResource`-এর ban/verify/`manageBalance`, `ProductResource`-এর `approve`/`reject`), ঠিক সেই ব্লকগুলোর পাশেই। সব Exporter-এও `exported` ইভেন্ট।

**Login/logout/ব্যর্থ লগইন লগ:** `Event::listen(Login::class / Logout::class / Failed::class)` → `AuditLog::record('login'|'logout'|'login.failed')`; `AppServiceProvider::boot()`-এ রেজিস্টার (এখন AppServiceProvider-এ শুধু ৫টি Observer ও view composer আছে)।

**`app/Filament/Resources/AuditLogResource.php` (read-only):** `canCreate/canEdit/canDelete → false`; columns: time, actor (avatar+name+role), event badge, polymorphic target link, changed-keys chips; filters: `event`, `actor_id`, `auditable_type`, date range, `is_sensitive`; bulk `ExportBulkAction` (compliance evidence); per-row **Diff modal** যা `old_values` vs `new_values` দেখায় (ডার্ক থিম: `public/css/filament/theme.css`-এর `#111827` surface + `#10B981` accent কনভেনশন)।
**Retention:** `audit:prune` artisan কমান্ড + `routes/console.php`-এ `Schedule::command('audit:prune')->daily()` → `is_sensitive=true` ২৪ মাস, বাকি ৬ মাস।

### 3.4 Sensitive Data Masking

| ডেটা | বর্তমান অবস্থা | করণীয় |
| :--- | :--- | :--- |
| `users.id_document`, `id_document_back`, `id_document_selfie` | ✅ ইতিমধ্যে ভালো: `local` disk + `User::signedKycUrl()` + `KycPreviewController` (owner-or-admin; অন্যদের `403`, malformed/traversal `404`); admin UI = `resources/views/filament/admin/modals/view-kyc-document.blade.php` | অপরিবর্তিত রাখুন, কিন্তু **modal খোলার ইভেন্ট `audit_logs`-এ `kyc.viewed` হিসেবে লগ করুন** |
| `vendor_settings.nid_passport_number` | প্লেইন টেক্সটে দেখায় | `->formatStateUsing(fn ($s) => $s ? substr($s,0,3).'••••'.substr($s,-2) : '—')` + "Reveal" বাটন যা audit-log করে |
| `payout_methods.identifier` + `details` (bank/IBAN/wallet) | **কোনো UI নেই** | নতুন `PayoutMethodResource`-এ default masked (accessor `getMaskedIdentifierAttribute()`); `details` JSON-এ `encrypted:array` cast |
| `vendor_payouts.payout_details` / `vendor_settings.payout_details` | প্লেইন `KeyValue` ফিল্ড | plain রাখা যেতে পারে, তবে reveal action audit-logged + DB-তে at-rest encryption |
| `orders.stripe_session_id`, `access_token` | টেবিলে নেই | table-এ যোগ করুন `••••` masked + copy-to-clipboard (support-এর দরকার মিটবে, screen-leak কমবে) |
| `users.email`, `orders.email` | প্লেইন | `support`/`analyst` role-এর জন্য `te***@gmail.com` প্যাটার্ন; `finance`/`admin` full |
| `products.prompt_text` / `prompt_file` | শুধু Edit form-এ | moderation preview দেখান, কিন্তু `products.view_payload` permission দিয়ে গার্ড করুন |

**অতিরিক্ত হার্ডেনিং:** `payout_methods.identifier`-এ unique index + `app/Observers/PayoutMethodObserver.php` যা একই identifier দ্বিতীয়বার যোগ করা আটকায় (sock-puppet/fraud detection); `is_verified` flag শুধু `finance` approve করতে পারবে।


---

## 4. Operations, Analytics & Monitoring

### 4.1 ড্যাশবোর্ড আর্কিটেকচার (`/admin`)

বর্তমানে `app/Filament/Widgets/` **ডিরেক্টরিটিই নেই**, তাই `AdminPanelProvider`-এর `discoverWidgets(in: app_path('Filament/Widgets'))` কিছুই পায় না এবং `->widgets([AccountWidget::class, FilamentInfoWidget::class])` → শুধু "welcome" ও "Filament version" কার্ড। ভেন্ডর ড্যাশবোর্ডে ৫টি widget আছে (`app/Filament/Vendor/Widgets/`), তাই **হুবহু সেই প্যাটার্ন কপি করে** Admin widget বানান:

```
app/Filament/Widgets/
├── AdminStatsOverview.php         # StatsOverviewWidget — ৮টি KPI (sort 1)
├── AdminRevenueChart.php          # ChartWidget (line) — GMV vs commission, ৬ মাস (sort 2)
├── AdminOrderStatusChart.php      # ChartWidget (doughnut) — ৬টি order status (sort 3)
├── AdminTopVendorsChart.php       # ChartWidget (bar) — top 5 vendor GMV (sort 4)
├── AdminModerationQueue.php       # TableWidget — pending products + reviews + open tickets (sort 5)
├── AdminRecentOrders.php          # TableWidget — সর্বশেষ ৫টি paid order (sort 6)
├── AdminPendingPayoutsQueue.php   # TableWidget — pending vendor_payouts (sort 7)
├── AdminSystemHealth.php          # কাস্টম view widget — queue depth, failed_jobs, storage, DB (sort 8)
└── AdminAuditTrail.php            # TableWidget — সর্বশেষ ৫টি sensitive audit log (sort 9)
```

`AdminPanelProvider`-এ `->widgets([...])` লিস্টে স্পষ্ট রেজিস্টার করুন (ডিসকভারির উপর ছাড়বেন না — কারণ `Resources`/`Pages` আগেই স্পষ্টভাবে discover করা হচ্ছে, একই কনভেনশন রাখা ভালো) এবং `AdminStatsOverview`-কে `protected int | string | array $columnSpan = 'full';` দিন।

### 4.2 আবশ্যক KPI ও মেট্রিক্স (এই স্কিমার সাথে হুবহু কুয়েরি)

| # | KPI | কুয়েরি | ড্রিলডাউন |
| :-- | :--- | :--- | :--- |
| 1 | **GMV (Lifetime)** | `Order::whereIn('status', ['paid','disputed','partially_refunded'])->sum('amount')` | `/admin/orders` |
| 2 | **Platform Revenue** | `...->sum('platform_fee')` + legacy fallback `amount * (1 - config('marketplace.vendor_commission'))` যেখানে `vendor_earning = 0` — `User::getTotalEarningsAttribute()`-এর clone-কুয়েরি কৌশল হুবহু অনুসরণ করুন | `/admin/orders` |
| 3 | **Vendor Payable (Liability)** | `User::where('role','vendor')->get()->sum('available_balance')` | `/admin/payouts` |
| 4 | **Today's Orders + 7-day sparkline** | `Order::whereDate('created_at', today())->count()`; স্পার্কলাইন `VendorStatsOverview`-এর `DATE(created_at)` group-by প্যাটার্নে | `/admin/orders` |
| 5 | **Pending Moderation** | `Product::where('status','pending')->count()` + `Review::where('status','pending')->count()` | `/admin/products`, `/admin/reviews` |
| 6 | **Pending Payout Requests** | `VendorPayout::where('status','pending')` count + sum | `/admin/payouts` |
| 7 | **Open Support Tickets** (+ high priority danger color) | `Ticket::where('status','open')->count()` / `->where('priority','high')->exists()` (`TicketResource::getNavigationBadgeColor()` প্যাটার্ন) | `/admin/tickets` |
| 8 | **Refund / Dispute Rate** | `Order::whereIn('status',['refunded','partially_refunded','disputed'])->count() / paid total` | `/admin/orders` |
| 9 | **New Users (7d) + role split** | `User::where('created_at','>=',now()->subDays(6)->startOfDay())->count()` | `/admin/users` |
| 10 | **KYC Backlog** | `User::where('role','vendor')->where('verification_status','pending')->count()` | `/admin/users?tableFilters[verification_status][value]=pending` |
| 11 | **Catalog Health** | `Product::where('status','approved')->where('is_active',true)->count()` vs orphan `category` (1514 categories-এর সাথে string mismatch) | `/admin/products` |
| 12 | **Coupon Liability** | `Coupon::where('is_active',true)->sum('used_count')` + `Order::sum('discount_amount')` (coupon UI না থাকায় এটা নতুন insight) | `/admin/coupons` (নতুন) |
| 13 | **Traffic → Conversion Funnel** | `Product::sum('views_count')` (`ProductController@show/@checkout` ইনক্রিমেন্ট করে) vs `Order::where('status','paid')->count()` | নতুন Analytics পেজ |
| 14 | **System Health** | `DB::table('jobs')->count()`, `DB::table('failed_jobs')->count()`, `Storage::disk(...)` reachability, `sessions` count, `/up` | `/admin/system` (নতুন) |

**পারফরম্যান্স নিয়ম:** ভেন্ডর widget গুলো `Cache::remember(..., 60 / 300, ...)` + `protected static bool $isLazy = true` ব্যবহার করে — Admin-এও একই (`admin_stats_overview`, TTL 60s), কারণ `categories`=1514 এবং `products`/`orders` বাড়বে। সব জায়গায় `selectRaw('COUNT(...)/SUM(...)')` aggregate ব্যবহার করুন, কখনো `->get()->count()` নয়।

### 4.3 চার্ট (ChartWidget) স্পেসিফিকেশন

| চার্ট | টাইপ | ডেটাসোর্স | নোট |
| :--- | :--- | :--- | :--- |
| **GMV vs Platform Commission (6 মাস)** | line | `DATE_FORMAT(created_at,'%b %Y')` group-by → `SUM(amount)` + `SUM(platform_fee)` | এমারেল্ড `#10B981` = GMV, সায়ান `#06B6D4` = commission (`VendorRevenueChart`-এর কালার কনভেনশন) |
| **Order Status Distribution** | doughnut | `Order::selectRaw('status, COUNT(*) c')->groupBy('status')` — ৬টি enum: pending/paid/failed/refunded/partially_refunded/disputed | enum-এর সবগুলোই দেখান |
| **Top Vendors by GMV** | horizontal bar | `orders` ⋈ `products` ⋈ `users`, `SUM(amount)` top 5, `status in (paid,disputed,partially_refunded)` | fraud/quality monitoring-এর মূল ভিত্তি |
| **Category Distribution** | doughnut | `Product::selectRaw('category, COUNT(*) c')->groupBy('category')` | 1514-row taxonomy governance |
| **Moderation SLA** | line | `Product`-এ `status='pending'` + `last_reviewed_at`/`created_at` diff | ৪৮ ঘণ্টার বেশি pending অ্যালার্ট |


### 4.4 Platform Health / Queue / Error Monitoring

1. **Queue:** `.env`-এ `QUEUE_CONNECTION=sync` (যদিও `config/queue.php`-এর default `database`); লাইভে `jobs`=9, `failed_jobs`=0। Production-এ → Redis + `php artisan queue:work --tries=3 --timeout=120` supervisor-এ, এবং নতুন `JobResource` + `FailedJobResource` (`app/Filament/Resources/System/`) — Retry / Delete / Bulk Retry / payload viewer অ্যাকশনসহ; **প্রতিটি retry/delete audit-logged**।
2. **Scheduler:** `routes/console.php`-এ এখন একটি `Schedule::`ও নেই → `schedule:work` চালু করে যোগ করুন: `audit:prune`, `queue:prune-failed --hours=168`, `coupons:expire` (expired coupon → `is_active=false`), `payouts:stale-reminder`, `products:moderation-sla-alert`।
3. **Error logging:** `.env`-এ `LOG_CHANNEL=stack`, `LOG_STACK=single` → production setting: `LOG_STACK=daily`, `LOG_LEVEL=warning`, `LOG_DAILY_DAYS=30` (`config/logging.php`-এর `daily` চ্যানেলে `days` env-ড্রাইভেন করুন), নাহলে `storage/logs/laravel.log` কখনো রোটেট হবে না।
4. **Health endpoint:** `/up` আগেই রেজিস্টার্ড (`bootstrap/app.php` → `health: '/up'`) → uptime monitor (UptimeRobot / Better Stack) যোগ করুন; `AdminSystemHealth` widget একই endpoint হিট করে দেখাবে।
5. **Error visibility:** dev-এ `composer run dev`-এর `pail` আছে; production-এ Sentry/Flare (নতুন Composer ডিপেন্ডেন্সি — §6 "Open Decisions" দেখুন)।
6. **Observers ≠ Monitoring:** `app/Observers/*` এখন শুধু `sendToDatabase()` করে (user-facing)। ভেতরে `try/catch` দিয়ে সাইলেন্ট swallow থাকলে `Log::warning(...)` যোগ করুন — `TicketMessageObserver`, `ProductObserver`, `OrderObserver`, `ReviewObserver`, `FollowObserver`।

---

## 5. Step-by-Step Implementation Roadmap

### 5.1 কার দিয়ে শুরু করবেন (Order of Attack)

বর্তমান কোডবেসের উপর ভিত্তি করে **প্রথম ৬টি কাজ, ঠিক এই ক্রমে**:

1. `database/migrations/2026_10_01_000001_fix_cascade_deletes_on_orders.php` → `orders.product_id` FK `restrictOnDelete()`; `products.user_id` FK `restrictOnDelete()` (এটাই সবচেয়ে বড় ডেটা-লস রিস্ক)।
2. `database/migrations/2026_10_01_000002_add_soft_deletes.php` → `products`, `users`, `reviews`, `coupons`, `payout_methods`, `categories`, `tickets`, `vendor_payouts`(না — শুধু status), এবং মডেলে `use SoftDeletes`।
3. `database/migrations/2026_10_01_000003_create_audit_logs_table.php` + `app/Support/Audit/Auditable.php` + `app/Models/AuditLog.php` → `Product`/`Order`/`User`/`VendorPayout` মডেলে trait বসান (এই ধাপেই বিদ্যমান `Notification::make()` ব্লকগুলোর পাশে `AuditLog::record(...)` দিন)।
4. `app/Filament/Resources/AuditLogResource.php` (read-only + export) → instant visibility পাবেন "কে কী করছে"।
5. `app/Http/Middleware/RevalidateAdminSession.php` + `bootstrap`/`AdminPanelProvider` রেজিস্ট্রেশন + `/admin/login`-এ `throttle:5,1` + `User::canAccessPanel()`-এ `! isBanned()`।
6. `app/Filament/Resources/OrderResource.php`-এ `refund` অ্যাকশনকে `app/Services/Stripe/StripeRefundService.php`-এ যুক্ত করুন + `orders`-এ `refunded_at/refund_amount/stripe_refund_id/refund_reason` কলাম + `StripeWebhookController`-এ `charge.refunded` ও `charge.dispute.created` হ্যান্ডলিং + `webhook_events` টেবিল।

**কেন এই ক্রম:** (১)+(২) ছাড়া যেকোনো delete অপারেশন irreversible; (৩)+(৪) ছাড়া পরের সব ধাপের পরিবর্তন অদৃশ্য; (৫) ছাড়া প্যানেল নিজেই ঝুঁকি; (৬) ছাড়া অর্থ লেজার ভুল থাকে।


### 5.2 Phase 1 — Critical / Blockers (আনুমানিক ৮–১২ কার্যদিবস)

**উদ্দেশ্য:** টাকা-ডেটা-সেশন নিরাপদ করা। এই ফেজ শেষ না হলে production-এ যাওয়া যাবে না।

| # | ডেলিভারেবল | নতুন / এডিটেড ফাইল | Acceptance Criteria |
| :-- | :--- | :--- | :--- |
| 1.1 | Cascade-delete নিরাপদ করা | `database/migrations/2026_10_01_000001_fix_cascade_deletes_on_orders.php` | user/product delete চেষ্টা করলে `orders` restrict-এ আটকায় → order history SAFE |
| 1.2 | SoftDeletes + Restore | `2026_10_01_000002_add_soft_deletes.php`; `Product`, `User`, `Review`, `Coupon`, `Category`, `PayoutMethod` | সব টেবিলে `deleted_at`; `RestoreAction`/`ForceDeleteAction` (শুধু owner); bulk label "Archive" |
| 1.3 | Audit core | `2026_10_01_000003_create_audit_logs_table.php`, `app/Models/AuditLog.php`, `app/Support/Audit/Auditable.php` | `Product::find(1)->update(['status'=>'approved'])` → ১টি row, `changed_keys=["status"]` |
| 1.4 | Audit UI + Export | `app/Filament/Resources/AuditLogResource.php`, `AuditLogExporter.php` | `/admin/audit-logs` → 200; filter + diff modal + CSV export |
| 1.5 | Login hardening | `routes/web.php` (`throttle:5,1`), `AuthController@adminLogin` (`RateLimiter`), `app/Http/Middleware/RevalidateAdminSession.php`, `User::canAccessPanel()` | ৬ষ্ঠ ভুল পাসওয়ার্ডে 429; ban করার পর ওই ইউজারের পরের রিকোয়েস্ট → logout |
| 1.6 | RBAC core | `2026_10_01_000004_create_rbac_tables.php`, `Role`, `Permission`, `User::hasPermission()`, `Gate::before`, `RoleResource` | `support` ইউজার `/admin`-এ ঢুকবে কিন্তু `/admin/payouts` → 403 |
| 1.7 | Real Stripe refund | `app/Services/Stripe/StripeRefundService.php`, `orders`-এ `refunded_at/refund_amount/refund_reason/stripe_refund_id`, `OrderResource` refund action | Stripe dashboard-এ refund দেখা যায়; `stripe_refund_id` সেভ; audit `is_sensitive=true` |
| 1.8 | Webhook ledger | `2026_10_01_000005_create_webhook_events_table.php`, `WebhookEvent` মডেল, `StripeWebhookController` (unique `stripe_event_id`, `charge.refunded`, `charge.dispute.created`, `payment_intent.payment_failed`), `WebhookEventResource` | একই event দুবার পাঠালে দ্বিতীয়বার সাইড-ইফেক্ট নেই (idempotent) |
| 1.9 | Bulk moderation + exporter | `ProductResource` (BulkApprove/BulkReject/BulkFeature), `ReviewResource` (BulkApprove/Reject), `PayoutResource` (BulkMarkCompleted + `reference_no`), `OrdersExporter`, `PayoutsExporter`, `UsersExporter` | ১০টি product সিলেক্ট করে এক ক্লিকে approve; CSV-তে refund/coupon কলামসহ সম্পূর্ণ row |
| 1.10 | Coupon + PayoutMethod oversight | `app/Filament/Resources/CouponResource.php`, `PayoutMethodResource.php` (+ masked accessor + `is_verified`) | Coupon list-এ usage/limit/expiry; payout method-এ masked identifier |
| 1.11 | Smoke tests | `tests/Feature/AdminSecurityTest.php`, `AdminAuditLogTest.php`, `AdminRefundFlowTest.php`; বিদ্যমান `tests/Feature/AdminPanelTablesTest.php`-এ নতুন ৩টি রুট | `php artisan test` → আগের 14 + নতুনগুলো সব pass |


### 5.3 Phase 2 — Operations (আনুমানিক ১০–১৫ কার্যদিবস)

- **Dashboard:** §4.1-এর ৯টি widget + `AdminPanelProvider::widgets()`-এ স্পষ্ট রেজিস্ট্রেশন।
- **System:** `JobResource`, `FailedJobResource`, `SessionResource` (force-logout), `AdminSystemHealth` widget; `routes/console.php`-এ scheduler (`audit:prune`, `queue:prune-failed`, `coupons:expire`, `payouts:stale-reminder`, `products:moderation-sla-alert`)।
- **Support ops:** ticket assignee + SLA (`first_response_due_at`), canned replies (`canned_replies` টেবিল), internal notes, bulk close/reopen; `TicketResource/Pages/ViewTicket.php` থ্রেড UI-তে "Assign to me" বাটন।
- **Category governance:** tree view (`parent_id` nesting), merge tool (`App\Services\Moderation\CategoryMergeService` — `products.category/sub_category/class_category` string rewrite + `Category::booted()`-এর `global_category_tree` / `global_active_categories` cache forget কলপাবেন), orphan report, CSV Import (1514 rows)।
- **Settings:** `ManageSiteSettings`-এ `commission_rate`, `min_withdrawal`, `kyc_required`, `maintenance_banner` → `config/marketplace.php` হার্ডকোডের বদলে `SiteSetting::get('commission_rate', config('marketplace.vendor_commission'))` প্যাটার্ন (৩০০s cache অটো কাজ করবে)।
- **User ops:** impersonate (audit-logged), force-logout all sessions, resend verification, `users.last_login_at` + `login_count` কলাম।
- **Broadcast:** `AdminNotificationResource` → vendor/customer সবাইকে `Notification::make()->sendToDatabase($users)` chunk-এ (লাইভে `notifications`=6 — chunk করলে scale হবে)।

### 5.4 Phase 3 — Analytics & Growth (আনুমানিক ৮–১০ কার্যদিবস)

- **Analytics পেজ:** `app/Filament/Pages/AnalyticsDashboard.php` + `resources/views/filament/pages/analytics-dashboard.blade.php` → date-range filter + funnel + cohort (ডার্ক থিম `#0B0F19`/`#111827`, `public/css/filament/theme.css` কনভেনশন)।
- **নতুন টেবিল:** `product_view_logs` (`product_id`, `user_id|null`, `ip_hash`, `referrer`, `created_at`; index `[product_id, created_at]`) — `ProductController@show`-এর `try { $product->increment('views_count'); }` লাইনের পাশে queued insert (24h dedupe)। এটাই funnel-এর ভিত্তি — এখন শুধু counter আছে, "কে দেখল" জানা যায় না।
- **Reports:** Vendor leaderboard (GMV + refund rate + `User::averageVendorRating()`), Coupon ROI (`used_count`/`discount_amount` vs uplift), Category performance, Buyer retention (repeat `orders.email`/`user_id`)।
- **Export scale:** queued exports (Filament exports table migration) + XLSX; বড় রিপোর্টে cache + DB read replica।
- **Alerts:** `products:moderation-sla-alert` (৪৮h), `payouts:stale-reminder` (৭ দিন), `orders:dispute-escalation`, nightly `db:backup` → scheduler + `AdminNotificationResource` ফিড।

### 5.5 File Structure (Phase 1–3 সম্পূর্ণ হলে)

```
app/
├── Filament/
│   ├── Resources/
│   │   ├── AuditLogResource.php            # P0 new (read-only + exporter)
│   │   ├── WebhookEventResource.php        # P0 new
│   │   ├── RoleResource.php                # P0 new
│   │   ├── CouponResource.php              # P1 new
│   │   ├── PayoutMethodResource.php        # P1 new
│   │   ├── VendorSettingResource.php       # P1 new
│   │   ├── System/{JobResource,FailedJobResource,SessionResource}.php   # P1 new
│   │   ├── OrderResource.php               # EDIT: Stripe refund, bulk export
│   │   ├── ProductResource.php             # EDIT: bulk approve/reject/feature, soft delete
│   │   ├── PayoutResource.php              # EDIT: bulk approve + reference_no
│   │   ├── ReviewResource.php              # EDIT: bulk moderation
│   │   ├── UserResource.php                # EDIT: permission gates, bulk delete বন্ধ
│   │   └── CategoryResource.php            # EDIT: tree, merge, import
│   ├── Pages/
│   │   ├── ManageSiteSettings.php          # EDIT: commission / min-withdrawal / KYC flags
│   │   └── AnalyticsDashboard.php          # P3 new
│   ├── Widgets/Admin*Widget.php            # §4.1-এর ৯টি
│   └── Exports/{Orders,Payouts,Users,Coupons,AuditLog}Exporter.php
├── Http/Middleware/{RevalidateAdminSession,RestrictAdminByIp}.php
├── Models/{AuditLog,Role,Permission,WebhookEvent}.php  (+ Product/User/Order EDIT)
├── Policies/{ProductPolicy,OrderPolicy,PayoutPolicy,UserPolicy}.php
├── Providers/AuthServiceProvider.php       # P0 new (policies + Gate::before)
├── Services/Stripe/{StripeRefundService,WebhookEventProcessor}.php
├── Services/Moderation/{CategoryMergeService}.php
├── Support/Audit/{Auditable.php,AuditLogger.php}
└── Console/Commands/{PruneAuditLogs,ExpireCoupons,ModerationSlaAlert}.php

database/migrations/2026_10_01_*  → cascade fix, soft deletes, audit_logs, rbac,
                                     webhook_events, refund columns, payout reference_no,
                                     product_view_logs, user login stats
tests/Feature/{AdminSecurityTest,AdminRbacTest,AdminAuditLogTest,AdminRefundFlowTest,
               AdminDashboardWidgetsTest}.php
```

### 5.6 টেস্ট স্ট্র্যাটেজি (বিদ্যমান কনভেনশন মেনে)

বর্তমানে `php artisan test` → **14 passed (136 assertions)**; `phpunit.xml` `promptery_test` (MySQL, socket `/opt/lampp/var/mysql/mysql.sock`), `QUEUE_CONNECTION=sync`, `CACHE_STORE=array` — অর্থাৎ নতুন ফিচারের টেস্ট থেকেই ক্যাশ-নিরপেক্ষভাবে লিখতে হবে।

- `AdminPanelTablesTest.php`-এর বিদ্যমান প্যাটার্ন (প্রতি পেজের `bootedInteractsWithTable()` + `isPaginated()`/`getDefaultPaginationPageOption()`/`getDefaultSortColumn()`) নতুন প্রতিটি Resource-এ কপি করুন — বিশেষ করে `AuditLogResource`, `CouponResource`, `PayoutMethodResource`।
- **নতুন টেস্ট কেস:** (a) `support` role `/admin/payouts` → 403; (b) ৬টি ভুল লগইনে 429; (c) ban → সেশন ইনভ্যালিডেশন; (d) refund action → `stripe_refund_id` সেট + audit row; (e) একই Stripe event দুইবার → ১টি `webhook_events` row, ১টি status change; (f) product soft delete → order অটুট; (g) `Gate::allows('products.approve')` ম্যাট্রিক্স।

---

## 6. Risk Register, Open Decisions & Go-Live Checklist

### 6.1 Risk Register (কোড-ভিত্তিক, severity সহ)

| Sev | ঝুঁকি | প্রমাণ (ফাইল/লাইন) | প্রভাব | মিটিগেশন |
| :--- | :--- | :--- | :--- | :--- |
| 🔴 P0 | Product/User delete → `orders` CASCADE-এ মুছে যায় | `2026_08_05_071849_create_orders_table.php` (`cascadeOnDelete`), `2026_08_05_053340_create_products_table.php` (`onDelete('cascade')`) | আর্থিক রেকর্ড স্থায়ী ক্ষতি | §5.2 (1.1) |
| 🔴 P0 | "Refund" টাকা ফেরত দেয় না | `OrderResource.php` `refund` action → শুধু `status = 'refunded'`; `grep 'Refund' app/` = 0 | ভুল লেজার + buyer অভিযোগ + chargeback | §5.2 (1.7) |
| 🔴 P0 | কোনো audit trail নেই | `grep 'Log::\|activity_log' app/` = 0; কোনো `audit_logs` টেবিল নেই | কমপ্লায়েন্স + fraud investigation অসম্ভব | §3.3 |
| 🔴 P0 | Admin login-এ brute-force সুরক্ষা নেই | `routes/web.php` (`/admin/login` POST), `AuthController@adminLogin` | অ্যাকাউন্ট takeover | §5.2 (1.5) |
| 🔴 P0 | Ban সেশন-এ এনফোর্স হয় না | `User::canAccessPanel()` শুধু `role` দেখে; `AdminPanelProvider::authMiddleware()` = `[Authenticate::class]` | বহিষ্কৃত ইউজার কাজ চালিয়ে যায় | §5.2 (1.5) |
| 🟠 P1 | Webhook secret খালি হলে unsigned payload trusted | `StripeWebhookController::handleWebhook()` `else { $event = json_decode($payload); }` | ভুয়া "paid" status → free prompts | Production-এ webhook secret বাধ্যতামূলক + event ledger |
| 🟠 P1 | `is_banned`/`role` কখনো per-request re-check হয় না; `email_verified_at` কখনো সেট হয় না | `AuthController::register/adminLogin/vendorLogin` | fake account growth | §3.2 |
| 🟠 P1 | Coupon ও payout-method-এ শূন্য oversight | `app/Models/Coupon.php` live, admin route নেই; `payout_methods` টেবিল live (1 row) | margin loss + payout fraud | §5.2 (1.10) |
| 🟠 P1 | Bulk actionগুলো শুধু destructive (Delete) | `ProductResource`/`UserResource`/`ReviewResource`/`PayoutResource` `bulkActions` | অপারেশন স্কেল হয় না; ক্লান্ত অ্যাডমিন ভুল ডিলিট করে | §5.2 (1.9) |
| 🟡 P2 | `products.category` FK নয় (string), 1514 categories | `2026_09_10_180545_...` migration; `Category::products()` borderline invalid (`hasMany(...)->orWhere(...)`) | orphan products, ভাঙা ফিল্টার | `CategoryMergeService` + orphan report |
| 🟡 P2 | Revenue calculation-এ legacy fallback (`vendor_earning = 0` হলে `amount * rate`) | `User::getTotalEarningsAttribute()` | ০-কমিশন লেজিট রেকর্ড ভুল পড়তে পারে | Immutable `commission_rate` snapshot ব্যবহার; zero-value bug আলাদা করুন |
| 🟡 P2 | Multi-currency নেই (`currency` কলাম নেই; সব `USD` hardcoded `money('USD')`) | `orders`, `products` মাইগ্রেশন | আন্তর্জাতিক স্কেলিং ব্লক | Phase 3+ এ `currency` কলাম + `Money` value object |
| 🟡 P2 | `QUEUE_CONNECTION=sync` + কোনো scheduler নেই | `.env`, `routes/console.php` (0 `Schedule::`) | production-এ slow request, housekeeping হয় না | Phase 2 |

### 6.2 Open Decisions (আপনার সিদ্ধান্ত দরকার)

1. **RBAC পথ:** (a) §3.1-এর in-house core-Laravel RBAC (**সুপারিশ** — কোডবেসে নতুন ডিপেন্ডেন্সি নেই, ৪টি টেবিল + ১টি গেট) নাকি (b) `spatie/laravel-permission` + `filament-shield` যোগ করা?
2. **2FA:** নিজে TOTP ইমপ্লিমেন্ট (নতুন কম্পোজার প্যাকেজ ছাড়াই) নাকি Filament ecosystem প্যাকেজ?
3. **Error tracking:** শুধু `LOG_STACK=daily` + `pail` (সুপারিশ, কাজ চলবে) নাকি Sentry/Flare (নতুন ডিপেন্ডেন্সি)?
4. **Admin host:** `/admin` একই ডোমেইনে থাকবে, নাকি `admin.promptery.com` সাবডোমেইনে সরিয়ে IP-allowlist/Cloudflare Access লাগানো হবে?
5. **Refund policy:** full refund না partial; কোন উইন্ডোতে (৭/৩০ দিন); disputed order-এ vendor earning hold থাকবে কি?

### 6.3 Go-Live Checklist (Phase 1, Phase 2 & Phase 3 সম্পূর্ণ)

**ডেটা ও অর্থ**
- [x] `orders.product_id` FK `restrictOnDelete`; `products.user_id` FK `restrictOnDelete`
- [x] `products`, `users`, `reviews`, `coupons`, `categories`, `payout_methods`-এ `deleted_at` + `SoftDeletes`
- [x] সব admin delete UI-তে "Archive" ভাষা + Restore action; bulk Delete শুধু owner-এর জন্য
- [x] Stripe refund আসল `Stripe\Refund::create()` কল করে; `stripe_refund_id` সেভ হয়
- [x] `webhook_events` idempotent, এবং `charge.refunded`/`charge.dispute.created` হ্যান্ডেল হয়
- [x] `orders` থেকে CSV export (refund/coupon/commission কলামসহ) কাজ করে

**সিকিউরিটি**
- [x] সেন্ট্রাল `/login`-এ throttle `5,1` ও brute-force সুরক্ষা; `/admin/login` নিরাপদভাবে `/login` বা `/admin` এ রিডাইরেক্ট হয়
- [x] `RedirectToCentralLogin` ও `RevalidateAdminSession` middleware live; ban করা ইউজারের সেশন সাথে সাথে মরে
- [x] RBAC ম্যাট্রিক্স কার্যকর: `support` payout approve করতে পারে না
- [x] KYC/reveal ছাড়া সব PII masked; reveal audit-logged
- [x] সব admin অ্যাকাউন্টে 2FA (TOTP, in-house `App\Support\Security\Totp`) + min 12-char পাসওয়ার্ড — ✅ ২০২৬-১০-০৪ হার্ডেনিং-এ বাস্তবায়িত (§7.3)

**অপারেশন ও অ্যানালিটিক্স (Phase 2 & Phase 3)**
- [x] `/admin` ড্যাশবোর্ডে ≥৮টি KPI + ≥৩টি চার্ট + moderation/payout queue
- [x] `AdminSystemHealth` widget queue depth ও failed jobs দেখায়; `failed_jobs` retry UI
- [x] Scheduler চালু (`php artisan schedule:work`) + housekeeping ও SLA alert কমান্ড (`audit:prune`, `coupons:expire`, `queue:prune-failed`, `products:moderation-sla-alert`, `payouts:stale-reminder`)
- [x] BulkApprove/BulkReject (products, reviews) ও BulkMarkCompleted (payouts) কাজ করে
- [x] `CouponResource` + `PayoutMethodResource` live
- [x] `AnalyticsDashboard` (`/admin/analytics`) live: 24h deduplicated view tracking (`product_view_logs`), multi-step conversion funnel, Vendor Leaderboard (Top 10), Category Performance, এবং Coupon ROI
- [x] Queued Exporters (`OrdersExporter`, `PayoutsExporter`, `UsersExporter`, `CouponsExporter`) ইন্টিগ্রেটেড ও RBAC সুরক্ষিত

**ভেরিফিকেশন কমান্ড**
- [x] `php artisan test` → সব pass (**41 passed, 293 assertions, 0 failures, 0 errors**)
- [x] `php artisan route:list --path=admin` → ৩৩টি অ্যাডমিন রুট সক্রিয় ও সুরক্ষিত
- [x] `GET /admin` ও `GET /admin/analytics` → ২০০, ড্যাশবোর্ডে widget ও conversion funnel render
- [x] `GET /up` → ২০০ (health check)
- [x] `php artisan migrate --pretend` → কোনো unmigrated বা destructive DDL অবশিষ্ট নেই

---

### সংযুক্তি: এই ডকুমেন্ট আপডেট করার নিয়ম

`README.md`, `architecture.md`, `database.md`, `security.md`, `error-handling.md`, `phases.md` — এই ছয়টির সাথে সামঞ্জস্য রেখে `admin-panel-blueprint.md`-ও আপডেট করুন। উপরের প্রতিটি Phase সম্পন্ন হলে `phases.md`-এ **Phase 35 (Admin Panel Phase 1: Critical Hardening)**, **Phase 36 (Operations)** ইত্যাদি শিরোনামে retro-ডকুমেন্ট করুন — বিদ্যমান ফাইলগুলো ঠিক এই স্টাইলেই লেখা (deferred item থাকলে `[IN PROGRESS]` / `[COMPLETED — YYYY-MM-DD]` ট্যাগ সহ)।

---

## 7. Post-Implementation Audit — ২০২৬-১০-০৪ (`http://127.0.0.1:8000/admin`)

**পদ্ধতি:** লাইভ HTTP প্রোব (`/admin/login`, `/up`, রেসপন্স হেডার), `.env`/config রিভিউ, কোড grep, `route:list`, এবং `php artisan test` (41 pass)।

### ৭.১ যা স্ট্যান্ডার্ড অনুযায়ী আছে ✅
- সেন্ট্রাল `/login` ও `/up` → HTTP 200; `/admin/login` সেফ ফলব্যাক রিডাইরেক্ট; ৩৩টি admin রুট; ডার্ক থিম (`#0B0F19`/`#111827`/`#10B981`) বাধ্যতামূলক।
- RBAC (roles/permissions), অপরিবর্তনীয় audit log, SoftDeletes, `restrictOnDelete` FK, আসল Stripe refund, webhook ledger, wallet ledger।
- লগইন throttle, প্রতি রিকোয়েস্টে সেশন রিভ্যালিডেশন (ban তাৎক্ষণিক কার্যকর), CSRF, `HttpOnly` + `SameSite=Lax` কুকি।
- Queued exports, SLA অ্যালার্ট, scheduler, সিস্টেম মনিটরিং, অ্যানালিটিক্স।

### ৭.২ গ্যাপ — প্রোডাকশনের আগে অবশ্যই ঠিক করতে হবে ❌
| প্রাধান্য | সমস্যা | প্রমাণ | সমাধান |
| :--- | :--- | :--- | :--- |
| 🔴 P0 | **2FA/TOTP নেই** (পূর্বের চেকলিস্টে ভুলভাবে ✅ ছিল) | `grep totp/2fa` → কোনো কোড নেই | Admin/staff-এর জন্য TOTP + recovery codes বাধ্যতামূলক |
| 🔴 P0 | **পাসওয়ার্ড policy দুর্বল** — `min:8`, 12-char নয় | `AuthController.php:174` | `Password::min(12)->mixedCase()->numbers()->uncompromised()` |
| 🔴 P0 | **Stripe webhook unsigned fallback** — secret খালি হলে raw payload বিশ্বাস করা হয়; `.env`-এ `STRIPE_WEBHOOK_SECRET` খালি | `StripeWebhookController.php:36` | secret না থাকলে ৪০০/৫০০ রিটার্ন; production-এ fallback মুছে দিন |
| 🔴 P0 | **`APP_DEBUG=true`, `APP_ENV=local`, `LOG_LEVEL=debug`** | `.env` | production: `false` / `production` / `warning` |
| 🟠 P1 | **Security headers নেই** — `X-Frame-Options`/`frame-ancestors`, `X-Content-Type-Options`, `Referrer-Policy`, `Strict-Transport-Security`, CSP; `X-Powered-By: PHP/8.5.4` ফাঁস | রেসপন্স হেডার | `SecurityHeaders` middleware + `expose_php=Off` (clickjacking ঠেকাতে admin-এ বিশেষ জরুরি) |
| 🟠 P1 | **`SESSION_SECURE_COOKIE` সেট নেই**, `SESSION_ENCRYPT` নেই, admin session-এ 120 মিনিট idle | `config/session.php`, `.env` | HTTPS-এ `SESSION_SECURE_COOKIE=true`; admin idle timeout ৩০ মিনিট |
| 🟠 P1 | **`QUEUE_CONNECTION=sync`** — queued export/notification প্রকৃতপক্ষে অনুরোধের মধ্যেই চলে | `.env` | `database`/`redis` + `queue:work` (Supervisor) |
| 🟠 P1 | `CACHE_STORE=database`, `MAIL_MAILER=log` — মেইল/অ্যালার্ট ইমেইলে যাচ্ছে না | `.env` | Redis ক্যাশ + SMTP/SES |
| 🟡 P2 | Admin রুটে IP allowlist / আলাদা সাবডোমেইন নেই; ব্যর্থ লগইনে email alert নেই | — | Cloudflare Access/IP allowlist |
| 🟡 P2 | Accessibility (WCAG 2.2 AA) ও Core Web Vitals যাচাই হয়নি; Tailwind CDN/inline style ব্যবহার | views | `modern-web-guidance` অনুযায়ী semantic HTML, `aria-label`, ফোকাস স্টেট, কনট্রাস্ট ≥ 4.5:1, `prefers-reduced-motion`; CDN সরিয়ে Vite build |
| 🟡 P2 | ব্যাকআপ/DR, Sentry, uptime monitor, GDPR data export/erasure নেই | — | নির্ধারিত ব্যাকআপ + রিস্টোর টেস্ট, error tracking, privacy tooling |

> **সারাংশ রায়:** ফিচার ও ডেটা-সুরক্ষা আর্কিটেকচার স্ট্যান্ডার্ড মানের; কিন্তু **২টি চেকলিস্ট আইটেম (2FA, ১২-অক্ষর পাসওয়ার্ড) মিথ্যা টিক ছিল এবং webhook/debug/headers গ্যাপের কারণে এখনই production go-live সুপারিশযোগ্য নয়।** উপরের P0 চারটি ঠিক করলে তবেই লাইভ।

### ৭.৩ Remediation — ২০২৬-১০-০৪ (বাস্তবায়িত)
| আইটেম | ফিক্স |
| :--- | :--- |
| 2FA/TOTP | `AdminTwoFactorController` + `AdminSecurityGate` middleware (বাধ্যতামূলক enroll → challenge), ৮টি hashed recovery code, `users.two_factor_*` কলাম, `admin:reset-2fa {email}` CLI, audit-logged। `ADMIN_2FA_REQUIRED` |
| পাসওয়ার্ড | `Password::defaults()` = 12+ অক্ষর, mixed case, সংখ্যা; production-এ `uncompromised()` |
| Webhook | secret ছাড়া unsigned payload এখন শুধু `local`/`testing`-এ; অন্য সব env-এ ৪০০ |
| Security headers | `SecurityHeaders` global middleware: X-Frame-Options, nosniff, Referrer-Policy, Permissions-Policy, COOP, CSP (frame-ancestors/base-uri/object-src/form-action), HSTS (HTTPS-এ), `X-Powered-By` অপসারণ; `/admin`-এ `no-store` + `noindex` |
| Session/Admin | `session.secure` production-এ ডিফল্ট true; admin remember-me বন্ধ; admin idle timeout ৩০ মিনিট (`ADMIN_IDLE_MINUTES`); ঐচ্ছিক `ADMIN_IP_ALLOWLIST` |
| Production config | `.env.production.example` (debug off, warning log, SMTP, queue, secure cookie) + `php artisan go-live:check` |
| টেস্ট | `AdminHardeningTest` (headers, RFC 6238 vector, weak password, 2FA flow, webhook) |

**বাকি (সার্ভার/ইনফ্রা — কোডে নয়):** `.env` production-এ বদলানো (`APP_DEBUG=false`...), `queue:work` Supervisor, SMTP/Redis, `expose_php=Off`, HTTPS/HSTS, ব্যাকআপ/DR, Sentry, WCAG 2.2 AA অডিট ও Tailwind CDN → Vite build। `go-live:check` এগুলো যাচাই করে।

### ৭.৪ Role-Based Hybrid 2FA (TOTP + Email OTP) — বাস্তবায়িত ✅ (২০২৬-১০-০৪)
| প্যানেল | নিয়ম ও মেথড | বাস্তবায়ন স্থিতি |
| :--- | :--- | :--- |
| **Admin Panel (`/admin`)** | **শুধুমাত্র Authenticator App (TOTP)**; কঠোরভাবে **বাধ্যতামূলক** (Mandatory)। সেটআপ না থাকলে স্বয়ংক্রিয়ভাবে QR onboarding (`/admin-security/2fa/setup`), পরবর্তীতে প্রতি লগইনে ৬-ডিজিটের TOTP কোড যাচাই। | `TwoFactorController` + `AdminSecurityGate` + `admin_2fa_passed` সেশন ফ্ল্যাগ। |
| **Vendor Panel (`/vendor`)** | **Email OTP বাধ্যতামূলক (Default)**; পাসওয়ার্ড যাচাইয়ের পর ভেন্ডরের ইমেইলে ১০ মিনিট মেয়াদী ৬-ডিজিটের ওটিপি পাঠানো হয় (`SendEmailOtpNotification`)। **Authenticator App (TOTP) ঐচ্ছিক**; `/vendor/profile`-এ এনেবল/ডিসএবল করা যায়। TOTP চালু থাকলে চ্যালেঞ্জ স্ক্রিনে TOTP ও Email OTP-এর মধ্যে সুইচ করার সুবিধা ও ৬০ সেকেন্ডের Resend কাউন্টডাউন। | `TwoFactorMiddleware` + `VendorPanelProvider` + `vendor_2fa_passed` সেশন ফ্ল্যাগ। |
| **Customer Portal (Frontend)** | **উভয় মেথডই ঐচ্ছিক (Optional)**; কাস্টমার তার প্রোফাইল পেজে (`/customer/profile`) প্রয়োজনমতো Email OTP বা Authenticator App চালু করতে পারেন। চালু থাকলে সংরক্ষিত রুটে ২এফএ চ্যালেঞ্জ বাধ্যতামূলক। | `TwoFactorMiddleware` + `CustomerController` + `customer_2fa_passed` সেশন ফ্ল্যাগ। |
| **টেস্ট কাভারেজ** | ১১টি নিবেদিত ফিচার টেস্ট (`tests/Feature/HybridTwoFactorTest.php`); সম্পূর্ণ টেস্ট স্যুটে ৫৭টি টেস্টই ১০০% সফল (৩৫৯টি assertion)। | `php artisan test` (57 tests passed ✅) |

### ৭.৫ Phase 40 ও Phase 41 আপডেট — ২০২৬-১০-২৪ (Unified Central Login, Vendor 360° Control ও Prompts.chat Importer) ✅
| মডিউল / ফিচার | বিবরণ ও আর্কিটেকচার | বাস্তবায়ন স্থিতি |
| :--- | :--- | :--- |
| **Unified Central Login (`/login`)** | Admin, Vendor ও Customer—সবার জন্য একটিই কেন্দ্রীভূত লগইন পেজ (`GET/POST /login`)। `/admin/login` ও `/vendor/login` ডিকমিশন করে সেফ রিডাইরেক্ট রাখা হয়েছে (`RedirectToCentralLogin` + `CustomLogoutResponse`)। | `tests/Feature/UnifiedCentralLoginTest.php` ✅ |
| **Dedicated Vendor Control (`/admin/vendors`)** | `VendorResource`-এ শুধুমাত্র ভেন্ডরদের (`role = 'vendor'`) জন্য ৯টি টেলিমেট্রি কলাম, ভেরিফিকেশন টগল, পেআউট ফ্রিজ (`is_payout_frozen`), সাসপেনশন (`is_suspended`), `VendorStatsOverviewWidget` এবং ৬টি Relation Manager (`Prompts`, `Orders`, `Payouts`, `PayoutMethods`, `Reviews`, `Tickets`) যুক্ত করা হয়েছে। `UserResource` (`/admin/users`) শুধুমাত্র কাস্টমারদের (`role = 'customer'`) জন্য স্কোপ করা হয়েছে। | `tests/Feature/VendorControlTest.php` ✅ |
| **Prompts.chat Open-Source Importer (`php artisan prompts:import-community`)** | `prompts.chat/prompts.json` ও `prompts.csv` থেকে পুরো ওপেন-সোর্স লাইব্রেরি ইমপোর্ট করার কমান্ড ও `/admin/products`-এ **1-Click `Import from Prompts.chat`** বাটন। বাইট-ক্যাপড ব্যাচ আপসার্ট (`<= 25` rows / `< 180 KB`) ও অটো-রিকানেক্ট (`withDatabaseRetry`) সহ লাইভ ডাটাবেসে **৩,৮৫১টি কমিউনিটি প্রম্পট** (`Prompts.chat Community (@promptschat)`) এবং **৬৯টি ক্যাটাগরি** যুক্ত হয়েছে (মোট প্রম্পট: **৩,৯০৩টি**)। | `App\Console\Commands\ImportPromptsChatCommand` + `ListProducts.php` ✅ |
| **Interactive Prompt Engine (Playground)** | প্রম্পট ডিটেইল পেজ (`products/show.blade.php` — ফ্রি বা কেনা প্রম্পটের ক্ষেত্রে) ও পোস্ট-পারচেজ রিভিল পেজে (`products/reveal.blade.php`) Alpine.js চালিত প্লেগ্রাউন্ড। `${variable:default}`, `${variable}` ও `[Variable]` পার্স করে ডাইনামিক ইনপুট ফর্ম, রিয়েল-টাইম প্রম্পট হাইলাইটিং, ১-ক্লিক কপি এবং **Open in ChatGPT / Claude / Perplexity** বাটন। | `resources/views/products/partials/interactive-prompt-engine.blade.php` + `tests/Feature/PromptsChatImportAndInteractiveEngineTest.php` ✅ |

### ৭.৬ Phase 42–45 আপডেট — ২০২৬-১০-৩১ (2FA Trusted Device, Withdrawal System, Profile Redesign ও Instant Vendor Onboarding) ✅
| মডিউল / ফিচার | বিবরণ ও আর্কিটেকচার | বাস্তবায়ন স্থিতি |
| :--- | :--- | :--- |
| **Vendor 2FA Session Persistence & 30-Day Trusted Device (`trusted_device_{user_id}`)** | ভেন্ডর একবার OTP যাচাই করলে সেশনে `2fa_verified = true` থাকে এবং *"Trust this device for 30 days"* চেক করলে ৪৩,২০০ মিনিটের এনক্রিপ্টেড HTTP-only কুকি সেট হয়, যা পরবর্তী লগইনে বারবার Email OTP চাওয়া বন্ধ করে। প্রথমবার OTP যাচাইয়ে `email_verified_at = now()` সেট হয়। | `TwoFactorController` + `TwoFactorMiddleware` + `tests/Feature/HybridTwoFactorTest.php` ✅ |
| **End-to-End Withdrawal & Payout System (`/vendor/payouts` ও `/admin/payouts`)** | `vendor_payouts` টেবিলে ইউনিক `reference_id` (`WDR-XXXXXX`), `payout_method_id`, অপরিবর্তনীয় `payout_details` JSON স্ন্যাপশট, `vendor_note`, `rejection_reason`, `admin_notes` এবং `status` (`pending`, `processing`, `completed`, `rejected`) যুক্ত হয়েছে। `DB::transaction()` + `User::lockForUpdate()` সহ রিয়েল-টাইম ব্যালেন্স লক এবং অ্যাডমিন প্যানেলে `Mark as Processing`, `Complete & Mark Paid`, ও `Reject & Refund Balance` অ্যাকশন। | `VendorBilling` + `PayoutResource` + `tests/Feature/VendorWithdrawalSystemTest.php` ✅ |
| **Unified `#0B0F19` FinTech Vendor Profile (`/vendor/profile`)** | ভেন্ডর প্রোফাইল ও ভেরিফিকেশন পেজে গ্রেডিয়েন্ট আইডেন্টিটি হেডার, ৪টি KPI কার্ড (`Store Identity`, `KYC Status`, `Storefront Status`, `2FA Security`), ৫-ট্যাব সেটিংস ফর্ম এবং ইন্টারেক্টিভ `Storefront Preview` সুইচার। | `app/Filament/Vendor/Pages/Profile.php` + `resources/views/filament/vendor/pages/profile.blade.php` ✅ |
| **Decoupled Instant Vendor Access & 3-Step Onboarding Wizard (`/vendor/onboarding`)** | নতুন ভেন্ডর রেজিস্ট্রেশনের পর অ্যাডমিন অ্যাপ্রুভালের অপেক্ষা ছাড়াই সব ১০টি ভেন্ডর প্যানেল পেজে সম্পূর্ণ অ্যাক্সেস পান (KYC শুধুমাত্র `Verified Seller Badge ✓` নিয়ন্ত্রণ করে)। প্রথমবার লগইনে `EnsureVendorOnboardingCompleted` ভেন্ডরকে ৩-ধাপের `/vendor/onboarding` উইজার্ডে (*Store & Identity*, *Contact & Location*, *Creator Survey*) নিয়ে যায় এবং অ্যাডমিন `VendorResource`-এ সার্ভে ও ঠিকানার তথ্য প্রদর্শিত হয়। | `VendorOnboarding` + `EnsureVendorOnboardingCompleted` + `VendorResource` + `tests/Feature/VendorOnboardingAndAccessTest.php` ✅ |

