hadii / laramina

1.2.2 2026-09-17 16:39 UTC

Requires

• php: ^8.1
• laravel/framework: ^10.0|^11.0|^12|^13

Requires (Dev)

• laravel/pint: ^1.30
• orchestra/testbench: ^10.0
• phpunit/phpunit: ^11.0

MIT

• hadii

Published on Packagist.org on 2026-09-17 16:39 UTC

README

ابزار تولید جدول و CRUD ماژولار برای لاراول — استانداردسازی و حذف کدهای تکراری

✨ چرا Laramina؟

در پروژه‌های لاراول، معمولاً برای هر جدول باید کدهای تکراری زیادی بنویسید. Laramina این مشکل را حل می‌کند! 🎯

💡 مزیت‌های کلیدی

• 🚫 حذف کدهای تکراری — هر جدول فقط یک بار تعریف می‌شود
• 📏 استانداردسازی — تمام جدول‌ها ساختار یکسانی دارند
• ⚡ سرعت توسعه — کاهش ۷۰٪ کدنویسی CRUD
• 🔧 نگهداری آسان — تغییر در یک جا، اعمال در همه جا
• 🎯 سبک و سریع — بدون وابستگی سنگین
• 🌐 چندزبانه — پشتیبانی کامل از فارسی و انگلیسی
• 📅 تاریخ شمسی — سازگاری با Verta (Jalali)
• 🔐 نقش و دسترسی — سازگاری با Spatie Permission

🚀 شروع سریع

۱. نصب

composer require hadii/laramina

۲. انتشار دارایی‌ها

php artisan vendor:publish --tag=laramina-config
php artisan vendor:publish --tag=laramina-assets
php artisan vendor:publish --tag=laramina-lang
php artisan vendor:publish --tag=laramina-views

۳. ایجاد جدول CRUD برای مدل مورد نظر برای مثال مدل user

php artisan laramina:make-ui User --force

۴. اجرا

php artisan serve

مرورگر: http://localhost:8000/users

⚠️ نکته: مدل باید از قبل وجود داشته باشد. برای جزییات بیشتر INSTALL.md را مطالعه کنید.

🖼️ نمایش و نمونه ها

🎥 ویدیوی آموزشی

⚡ پیشنمایش سریع

📖 مستندات کامل

برای راهنمای گام‌به‌گام، فایل INSTALL.md را مطالعه کنید:

بخش	توضیح	لینک
نصب و انتشار	نصب پکیج و انتشار دارایی‌ها	مشاهده
تنظیمات اولیه	لایه‌اوت، Tailwind، مسیرها	مشاهده
ایجاد ماژول	روش خودکار و دستی	مشاهده
تنظیمات ماژول	کانفیگ، جدول، فرم، اکشن‌ها	مشاهده
پکیج‌های مکمل	Verta و Spatie Permission	مشاهده
نقش و دسترسی	با/بدون Spatie Permission	مشاهده
API و مسیرها	endpointها و پارامترها	مشاهده
امنیت	اعتبارسنجی و محافظت	مشاهده
عیب‌یابی	مشکلات رایج و راه‌حل‌ها	مشاهده
تست‌ها	اجرای تست‌های خودکار	مشاهده

🇬🇧 English

What is Laramina?

Laramina is a modular CRUD generator for Laravel that helps you eliminate repetitive code, standardize your project, and speed up development by 70%.

Features

• 🎯 Auto CRUD Generation — Generate tables with a single command
• 🔍 Advanced Search — Multi-column search with AJAX
• 📊 Smart Filtering — Filter by any column
• 🔄 Sorting — Sort by single or multiple columns
• 📄 Pagination — Built-in pagination with customizable per-page
• ✏️ Inline Editing — Toggle status without page reload
• 🌐 Multilingual — Full Persian (Farsi) and English support
• 🔐 Role-Based Access — Compatible with Spatie Permission
• 📅 Persian Dates — Full support for Verta (Jalali dates)

Quick Start

composer require hadii/laramina

php artisan vendor:publish --tag=laramina-config
php artisan vendor:publish --tag=laramina-assets
php artisan vendor:publish --tag=laramina-lang
php artisan vendor:publish --tag=laramina-views

php artisan laramina:make-ui User --force

php artisan serve

For detailed setup instructions, see INSTALL.md.

Package Integrations

Package	Purpose	Status
Verta	Persian/Jalali dates	✅ Supported
Spatie Permission	Role & Permission	✅ Supported

📁 ساختار پکیج

laramina/
├── config/laramina.php              # کانفیگ پیش‌فرض
├── src/
│   ├── LaraminaServiceProvider.php  # Service Provider
│   ├── Console/Commands/            # دستورات Artisan
│   ├── Contracts/AdminModule.php    # رابط ماژول
│   ├── Controllers/                 # کنترلرهای پیش‌فرض
│   ├── Services/                    # سرویس‌ها
│   ├── Support/                     # پشتیبانی ماژول‌ها
│   └── Traits/AdminTableTrait.php   # Trait اصلی جدول
├── resources/
│   ├── js/laramina/                 # فرانت‌اند ماژولار
│   ├── lang/fa/ & en/               # ترجمه‌ها
│   └── views/                       # ویوهای Blade
└── tests/                           # تست‌های خودکار (PHPUnit)

🧪 تست‌ها

composer install
php vendor/bin/phpunit

این پکیج دارای ۶۴ تست خودکار PHPUnit است. برای جزییات بیشتر بخش تست‌ها را ببینید.

📊 مقایسه با سایر ابزارها

ویژگی	Laramina	Laravel Nova	Filament	Voyager
نوع	CRUD Generator	Admin Panel	Admin Panel	Admin Panel
داشبورد	❌	✅	✅	✅
سایدبار	❌	✅	✅	✅
تولید CRUD	✅	✅	✅	✅
استانداردسازی	✅	✅	❌	❌
سبک	✅	❌	❌	❌
رایگان	✅	❌	✅	✅
چندزبانه فارسی	✅	❌	✅	❌
نیاز به Node.js	❌	✅	❌	❌

💡 Laramina: ابزار سبک و سریع برای استانداردسازی CRUD در لاراول

🗺️ نقشه راه

برای مشاهده نقشه راه کامل پکیج، فایل ROADMAP.md را مطالعه کنید.

خلاصه نقشه راه

Phase	زمان	ویژگی‌های اصلی
Phase ۱	ماه ۱-۳	فرم پیشرفته، داشبورد، فیلتر پیشرفته
Phase ۲	ماه ۴-۶	Media Library, Activity Log, Soft Delete
Phase ۳	ماه ۷-۹	Plugin System, API Docs, Workflow
Phase ۴	ماه ۱۰-۱۲	Marketplace, Team Management, AI Features

🔄 تغییرات نسخه ۱.۰.۰

• ✅ اضافه شدن ۶۴ تست خودکار
• ✅ رفع باگ صفحه‌بندی در AdminTableTrait
• ✅ پشتیبانی از Laravel 10/11/12/13
• ✅ معماری ماژولار فرانت‌اند

📋 مشاهده تاریخچه تغییرات

📄 License

MIT License

Copyright (c) 2026 Hadii