ডকুমেন্টেশন টেস্ট কভারেজ
প্রতিটি ডকুমেন্টেড ফিচার অটোমেটেড টেস্ট দ্বারা সমর্থিত। এই পেজটি ডকুমেন্টেশনকে টেস্টের সাথে ম্যাপ করে, যাতে আপনি যাচাই করতে পারেন সবকিছু ঠিকভাবে কাজ করছে।
টেস্ট চালানোর নিয়ম
# Run all tests
vendor/bin/pest
# Run only fast unit tests (class existence checks)
vendor/bin/pest tests/Unit/
# Run feature tests (need database)
vendor/bin/pest tests/Feature/
টেস্ট কভারেজ ম্যাপ
ইউনিট টেস্ট (দ্রুত, ডাটাবেজের প্রয়োজন নেই)
এই টেস্টগুলো যাচাই করে যে ডকুমেন্টেশনে উল্লেখিত প্রতিটি ক্লাস, মেথড এবং ফিচার সোর্স কোডে বাস্তবেই বিদ্যমান আছে কিনা। এগুলো প্রায় ১ সেকেন্ডে রান হয়।
| ডকুমেন্টেশন পেজ | টেস্ট ফাইল | যা যাচাই করা হয় |
|---|---|---|
| ফর্ম ফিল্ড | tests/Unit/ClassExistsTest.php | ৫০+ ফর্ম ফিল্ড ক্লাস বিদ্যমান আছে |
| গ্রিড ফিল্টার | tests/Unit/ClassExistsTest.php | Equal, Like, Between, In, Where, Scope ফিল্টার |
| গ্রিড অ্যাকশন | tests/Unit/ClassExistsTest.php | Actions, DropdownActions ডিসপ্লেয়ার |
| ডেটা এক্সপোর্ট | tests/Unit/ClassExistsTest.php | CsvExporter ক্লাস |
| পারমিশন | tests/Unit/ClassExistsTest.php | পারমিশন check/allow/deny মেথড, সব Auth মডেল |
| কমান্ড | tests/Unit/ClassExistsTest.php | সব ৯টি কনসোল কমান্ড |
| উইজেট | tests/Unit/WidgetsTest.php | Box, Tab, Table, InfoBox, Collapse, Alert, Callout, Carousel, Form |
ফিচার টেস্ট (ইন্টিগ্রেশন, ডাটাবেজ প্রয়োজন)
এই টেস্টগুলো সম্পূর্ণ Laravel অ্যাপ্লিকেশন বুট করে এবং প্রকৃত CRUD অপারেশন এন্ড-টু-এন্ড কাজ করছে কিনা তা যাচাই করে।
| ডকুমেন্টেশন পেজ | টেস্ট ফাইল | যা যাচাই করা হয় |
|---|---|---|
| ইনস্টলেশন | tests/Feature/InstallTest.php | Admin ডিরেক্টরি তৈরি হয়েছে |
| ইনস্টলেশন | tests/Feature/ConsoleCommandsTest.php | কমান্ড, টেবিল, সিড ডেটা |
| কুইক স্টার্ট | tests/Feature/LaravelTest.php | Laravel অ্যাপ বুট হয় |
| কমান্ড | tests/Feature/ConsoleCommandsTest.php | সব কনসোল কমান্ড রেজিস্টার্ড আছে |
| কনফিগারেশন | tests/Feature/ConfigurationTest.php | সব কনফিগ অপশন |
| কনফিগারেশন | tests/Feature/UserSettingTest.php | সেটিংস পেজ লোড হয় |
| মডেল গ্রিড | tests/Feature/UserGridTest.php | কলামসহ গ্রিড রেন্ডার হয় |
| মডেল গ্রিড | tests/Feature/GridDisplayTest.php | গ্রিড কনস্ট্রাকশন, অপশন |
| গ্রিড কলাম | tests/Feature/GridColumnTest.php | কলাম ডিসপ্লেয়ার, অ্যাকশন |
| গ্রিড কলাম | tests/Feature/GridColumnConfigTest.php | কলামের প্রস্থ, রং, অ্যাট্রিবিউট |
| কলাম ডিসপ্লে | tests/Feature/GridColumnDisplayMethodsTest.php | সব ডিসপ্লে মেথড |
| গ্রিড অ্যাকশন | tests/Feature/GridActionsTest.php | রো/ব্যাচ অ্যাকশন, ডিসপ্লেয়ার |
| গ্রিড ফিল্টার | tests/Feature/GridFilterTest.php | ফিল্টার টাইপ, কন্ডিশন |
| ইনলাইন এডিটিং | tests/Feature/GridInlineEditTest.php | এডিটেবল, সুইচ, সিলেক্ট |
| গ্রিড এক্সপোর্ট | tests/Feature/GridExportTest.php | CsvExporter, এক্সপোর্ট অপশন |
| গ্রিড টুলস | tests/Feature/GridToolsTest.php | Header, footer, quickSearch, selector |
| মডেল ফর্ম | tests/Feature/UserFormTest.php | ক্রিয়েট ফর্ম লোড হয় |
| ফর্ম ফিল্ড | tests/Feature/FormFieldsTest.php | বেসিক ফিল্ড টাইপ |
| ফর্ম ফিল্ড | tests/Feature/FormFieldTypesTest.php | সব ৬০+ ফিল্ড টাইপ |
| ফর্ম ভ্যালিডেশন | tests/Feature/FormValidationTest.php | Rules, creationRules, updateRules |
| ফর্ম কলব্যাক | tests/Feature/FormCallbacksTest.php | Saving, saved, deleting হুক |
| ফর্ম লেআউট | tests/Feature/FormLayoutTest.php | ট্যাব, কলাম, রো, fieldset |
| ফর্ম আপলোড | tests/Feature/FormUploadFieldsTest.php | Image, file, multipleImage |
| ফর্ম আপলোড | tests/Feature/FileUploadTest.php | ফাইল আপলোড ফর্ম লোড হয় |
| ফর্ম আপলোড | tests/Feature/ImageUploadTest.php | ইমেজ আপলোড ফর্ম লোড হয় |
| মডেল শো | tests/Feature/ShowBuilderTest.php | Show কনস্ট্রাকশন, ফিল্ড |
| মডেল শো | tests/Feature/ShowFieldsTest.php | ফিল্ড ডিসপ্লে মেথড, প্যানেল |
| মডেল ট্রি | tests/Feature/ModelTreeTest.php | Tree selectOptions কাজ করে |
| মডেল ট্রি | tests/Feature/TreeBuilderTest.php | ট্রি কনস্ট্রাকশন, টুলস |
| পারমিশন | tests/Feature/PermissionsTest.php | পারমিশন পেজ লোড হয় |
| পারমিশন | tests/Feature/RolesTest.php | রোল পেজ লোড হয় |
| পারমিশন | tests/Feature/UsersTest.php | ইউজার পেজ লোড হয় |
| RBAC | tests/Feature/RbacTest.php | সম্পূর্ণ RBAC সিস্টেম টেস্ট |
| এক্সটেনশন | tests/Feature/ExtensionsTest.php | এক্সটেনশন রেজিস্ট্রেশন |
| ফ্রন্টএন্ড | tests/Feature/FrontendAssetsTest.php | CSS, JS, script, style |
| টেমপ্লেট | tests/Feature/FrontendAssetsTest.php | টেমপ্লেট কনফিগ |
| n/a | tests/Feature/AdminClassTest.php | Admin ফ্যাসাড মেথড |
| n/a | tests/Feature/AdminCrudTest.php | User/Role/Permission CRUD |
| n/a | tests/Feature/AuthSettingsTest.php | Auth সেটিংস পেজ |
| n/a | tests/Feature/AuthTest.php | লগইন ফর্ম, অথেন্টিকেশন |
| n/a | tests/Feature/ContentLayoutTest.php | কন্টেন্ট লেআউট বিল্ডার |
| n/a | tests/Feature/IndexTest.php | ড্যাশবোর্ড লোড হয় |
| n/a | tests/Feature/MenuTest.php | মেনু পেজ লোড হয় |
| n/a | tests/Feature/MiddlewareTest.php | মিডলওয়্যার ক্লাস |
| n/a | tests/Feature/OperationLogTest.php | অপারেশন লগ পেজ লোড হয় |
| n/a | tests/Feature/ServiceProviderTest.php | সার্ভিস প্রোভাইডার, রাউট |
| n/a | tests/BasicAuthTest.php | সম্পূর্ণ লগইন/লগআউট ফ্লো |
CI ব্যাজ যুক্ত করা
টেস্ট স্ট্যাটাস পাবলিকলি দেখানোর জন্য, একটি GitHub Actions ওয়ার্কফ্লো যুক্ত করুন:
# .github/workflows/tests.yml
name: Tests
on: [push, pull_request]
jobs:
test:
runs-on: ubuntu-latest
strategy:
matrix:
php: [8.2, 8.3, 8.4]
laravel: [10.*, 11.*, 12.*, 13.*]
steps:
- uses: actions/checkout@v4
- uses: shivammathur/setup-php@v2
with:
php-version: ${{ matrix.php }}
- run: composer install --no-interaction
- run: vendor/bin/pest
এরপর আপনার README-এ এই ব্যাজটি যুক্ত করুন:
