// معرفة دورة الحياة تساعدك في تصحيح الأخطاء هكذا:
// 1. التحقق من وجود الربط
app()->bound('payment.gateway');
// 2. التحقق من أي مزود سجّله
app()->getBindings()['payment.gateway']['concrete'];
// 3. تتبع ترتيب تنفيذ الوسائط
app()->make(\Illuminate\Foundation\Http\Kernel::class)->getMiddlewarePriority();

# التحقق من مزودي الخدمات المسجلين
php artisan about --only=providers
# القائمة: AppServiceProvider، AuthServiceProvider، إلخ

# التحقق من خط أنابيب الوسائط
php artisan route:list --columns=method,uri,middleware
# GET /dashboard ← auth, tenant.resolve, verified

# التحقق من الخدمات المرتبطة في الحاوية
php artisan tinker
# app()->getBindings()
# يعرض جميع روابط الحاوية المسجلة

# تم تنفيذ الأمر بنجاح

// bootstrap/app.php — تهيئة ملف واحد في Laravel 11
return Application::configure(basePath: dirname(__DIR__))
    ->withRouting(
        web: __DIR__.'/../routes/web.php',
        api: __DIR__.'/../routes/api.php',
        commands: __DIR__.'/../routes/console.php',
        health: '/up',
    )
    ->withMiddleware(function (Middleware $middleware) {
        $middleware->appendToGuestList([
            '/api/*',
        ]);
        $middleware->alias([
            'tenant.resolve' => \App\Http\Middleware\TenantResolve::class,
        ]);
    })
    ->withExceptions(function (Exceptions $exceptions) {
        //
    })->create();

// bootstrap/app.php
->withMiddleware(function (Middleware $middleware) {
    // إضافة وسيط عام (يعمل على كل طلب)
    $middleware->append([
        \App\Http\Middleware\SetLocale::class,
    ]);

    // إزالة وسيط عام افتراضي
    $middleware->remove([
        \Illuminate\Foundation\Http\Middleware\TrimStrings::class,
    ]);

    // تسجيل اسم مستعار لوسيط المسار
    $middleware->alias([
        'tenant' => \App\Http\Middleware\TenantResolve::class,
        'role' => \App\Http\Middleware\CheckRole::class,
    ]);
})

// تم التنفيذ بنجاح

// app/Providers/AppServiceProvider.php
public function register(): void
{
    // ربط الواجهة بالتنفيذ
    $this->app->bind(
        PaymentGatewayInterface::class,
        StripeGateway::class,
    );

    // ربط بإغلاق (تحكم كامل)
    $this->app->bind('analytics.service', function ($app) {
        return new AnalyticsService(
            $app->make(CacheManager::class),
            $app['config']->get('analytics.ttl'),
        );
    });

    // Singleton — نفس النسخة في كل مرة
    $this->app->singleton(ShopMetricsConfig::class, function ($app) {
        return new ShopMetricsConfig(
            $app['config']->get('shopmetrics'),
        );
    });
}

// حل تلقائي عبر تلميح النوع
class OrderController extends Controller
{
    public function __construct(
        private PaymentGatewayInterface $gateway, // يُحل تلقائياً
    ) {}
}

// حل يدوي
$gateway = app(PaymentGatewayInterface::class);
$gateway = app()->make(PaymentGatewayInterface::class);
$analytics = resolve('analytics.service');

// app/Providers/AppServiceProvider.php
public function register(): void
{
    $this->app->bind(
        \App\Contracts\ReportGeneratorInterface::class,
        \App\Services\PdfReportGenerator::class,
    );

    $this->app->singleton(
        \App\Services\TenantManager::class,
        fn ($app) => new TenantManager(
            $app->make(\App\Models\Tenant::class),
        ),
    );

    $this->app->when(ShopController::class)
        ->needs(\App\Contracts\FileStorageInterface::class)
        ->give(\App\Services\S3StorageService::class);
}

// تم التنفيذ بنجاح

// استخدام الواجهة — موجز
use Illuminate\Support\Facades\Cache;

public function getShopStats(int $shopId): array
{
    return Cache::remember("shop.stats.{$shopId}", 3600, function () use ($shopId) {
        return Shop::findOrFail($shopId)->getStats();
    });
}

// استخدام حقن التبعيات — صريح، أسهل في الاختبار
public function __construct(
    private CacheManager $cache,
) {}

public function getShopStats(int $shopId): array
{
    return $this->cache->remember("shop.stats.{$shopId}", 3600, function () use ($shopId) {
        return Shop::findOrFail($shopId)->getStats();
    });
}

// تم التنفيذ بنجاح

يصل الطلب
  ← مرحلة التسجيل: تُستدعى register() لجميع المزودين (بدون بدء بعد)
  ← مرحلة البدء: تُستدعى boot() لجميع المزودين (جميع الروابط متاحة)
  ← التطبيق جاهز

// app/Providers/PaymentServiceProvider.php
class PaymentServiceProvider extends ServiceProvider
{
    protected bool $defer = true;

    public function register(): void
    {
        $this->app->singleton(StripeGateway::class, function ($app) {
            return new StripeGateway(config('services.stripe'));
        });
    }

    public function provides(): array
    {
        return [StripeGateway::class];
    }
}

// app/Providers/ShopMetricsServiceProvider.php
class ShopMetricsServiceProvider extends ServiceProvider
{
    public function register(): void
    {
        $this->app->bind(
            ReportGeneratorInterface::class,
            PdfReportGenerator::class,
        );

        $this->app->singleton(TenantManager::class);
    }

    public function boot(): void
    {
        // تسجيل اسم مستعار للوسيط
        $this->app->make(\Illuminate\Routing\Router::class)
            ->aliasMiddleware('tenant', TenantResolve::class);

        // تسجيل ملحن العرض
        View::composer('dashboard.*', NavigationComposer::class);

        // تسجيل مستمعي الأحداث
        Event::listen(OrderPlaced::class, SendOrderNotification::class);
    }
}

// تم التنفيذ بنجاح

// ============================================
// شامل: تتبع طلب ShopMetrics
// يغطي: دورة الحياة، الحاوية، الواجهات، المزود
// ============================================

// 1. public/index.php — نقطة الدخول
// $app = require_once __DIR__.'/../bootstrap/app.php';
// $app->handleRequest();

// 2. bootstrap/app.php — تهيئة النواة
// return Application::configure(basePath: dirname(__DIR__))
//     ->withRouting(web: ..., api: ...)
//     ->withMiddleware(fn ($m) => $m->append([SetLocale::class]))
//     ->create();

// 3. AppServiceProvider — تسجيل الروابط
// public function register(): void
// {
//     $this->app->singleton(TenantManager::class);
//     $this->app->bind(PaymentGatewayInterface::class, StripeGateway::class);
// }

// 4. المسار: GET /{tenant}/dashboard
// Route::middleware(['auth', 'tenant'])->get('/{tenant}/dashboard', [DashboardController::class, 'index']);

// 5. المتحكم — استخدام حقن التبعيات والواجهات
class DashboardController extends Controller
{
    public function __construct(
        private TenantManager $tenantManager, // يُحل عبر حقن التبعيات
    ) {}

    public function index(Request $request): View
    {
        $tenant = $this->tenantManager->current();
        $stats = Cache::remember("dashboard.{$tenant->id}", 300, function () use ($tenant) {
            return [
                'revenue' => $tenant->shops()->sum('revenue'),
                'orders' => $tenant->orders()->count(),
                'shops' => $tenant->shops()->active()->count(),
            ];
        });

        return view('dashboard.index', compact('tenant', 'stats'));
    }
}

// 6. إرسال الاستجابة ← تشغيل الوسائط القابلة للإنهاء ← اكتمال الطلب