‏Laravel Brain: نقشه زنده معماری اپلیکیشن لاراولت

Laravel Brain یه پکیج لاراوله که بعد از نصب، اپلیکیشنت رو اسکن می‌کنه و یه گراف تعاملی از معماریش می‌سازه. این گراف نشون می‌ده که درخواست‌ها چطور از روت‌ها رد می‌شن، به کنترلرها می‌رسن، از سرویس‌ها و ریپازیتوری‌ها رد می‌شن و به مدل‌ها، جاب‌ها، ایونت‌ها و کانال‌های برادکست ختم می‌شن. همه اینا توی یه صفحه واحد و به‌صورت نودهای رنگی با فلش‌هایی که جریان داده رو نشون می‌دن قابل مشاهده‌ست.

گراف از طریق آدرس /_laravel-brain مستقیم توی خود اپلیکیشن لاراولت سرو می‌شه و نیازی به دیپلوی جداگانه یا ابزار خارجی نداری. می‌تونی روی هر نود کلیک کنی، کد سورسش رو ببینی، یا فلوچارت منطق داخلی متدش رو بررسی کنی. روت‌ها هم توی تب‌های جداگانه‌ان که بتونی روی یه اندپوینت خاص تمرکز کنی.

یکی از قابلیت‌های کاربردی، خروجی گرفتن کانتکست برای ابزارهای هوش مصنوعیه. با یه کلیک یا از طریق دستور آرتیزان، یه اسنپ‌شات Markdown از هر نود می‌گیری که شامل روت، زنجیره فراخوانی تا سه سطح عمق، عملیات دیتابیس، اسنیپت‌های کد و لیست وابستگی‌های composer.json و package.json هست؛ آماده برای پیست کردن توی هر ابزار AI:

# خلاصه کل پروژه
php artisan brain:export-context

# فقط برای یه روت خاص
php artisan brain:export-context --route="GET /users" --budget=4000

قابلیت دیگه‌ای که خیلی به درد می‌خوره، تولید فایل‌های rules برای ابزارهای AI کدنویسیه. پکیج می‌تونه از روی داده‌های واقعی معماری پروژه‌ات، فایل‌های کانتکست برای هفت ابزار مختلف بسازه؛ از جمله Claude Code، Cursor، Windsurf، Copilot، Junie، Aider و AGENTS.md. به‌جای boilerplate عمومی، این فایل‌ها بر اساس ساختار واقعی پروژه‌ات پر می‌شن:

php artisan brain:generate-rules --target=claude --target=cursor

یه feature جالب دیگه‌اش stress testing روت‌هاست. می‌تونی مستقیم از روی گراف، لود تست همزمان روی هر روت بزنی، concurrency و هدرها و بادی رو تنظیم کنی و percentile‌های زمانی رو همزمان با انیمیشن گراف ببینی.

حالت Watch Mode هم داره که وقتی فایل‌های PHP پروژه‌ات تغییر می‌کنن، به‌صورت خودکار اسکن رو دوباره اجرا می‌کنه. ضمناً یه سیستم تشخیص «کلاس‌های چاق» داره که کنترلرها یا سرویس‌هایی با بیش از ۳۰۰ خط یا ۱۰ متد رو به‌عنوان نقاط پیچیدگی علامت‌گذاری می‌کنه تا سریع بفهمی کجای کدت نیاز به refactor داره.

خروجی گرافیکی هم محدود نیست؛ می‌تونی گراف رو به فرمت PNG یا دیاگرام Mermaid اکسپورت کنی و از چند layout مختلف مثل dagre سلسله‌مراتبی، force-directed، breadth-first، دایره‌ای یا گرید استفاده کنی. تم روشن و تاریک هم داره.

نکات کلیدی:

• گراف تعاملی از کل چرخه درخواست لاراول، از روت تا مدل و جاب و ایونت
• قابل دسترس از /_laravel-brain بدون نیاز به راه‌اندازی جداگانه
• اکسپورت کانتکست Markdown برای پیست کردن توی ابزارهای AI
• تولید فایل rules برای هفت ابزار AI کدنویسی از جمله Claude و Cursor
• استرس تست روت‌ها با نمایش live روی گراف
• تشخیص کلاس‌های چاق برای بررسی سلامت کد
• Watch Mode برای اسکن خودکار بعد از هر تغییر در فایل‌های PHP