feat(logging): implement log pruning functionality

- Add LogPruneService to handle the deletion of old logs based on retention settings.
- Create PruneLogsCommand to provide a console command for log pruning.
- Introduce PruneLogsMessage and PruneLogsHandler for message handling related to log pruning.
- Update the AST cache with new classes and their relationships.

src/Shared/Logging/AppLogRepository.php

@@ -8,4 +8,24 @@ use Doctrine\Persistence\ManagerRegistry;
 class AppLogRepository extends ServiceEntityRepository
 {
     public function __construct(ManagerRegistry $registry) { parent::__construct($registry, AppLog::class); }
+
+    /** حذف همه‌ی لاگ‌ها؛ تعداد ردیف‌های حذف‌شده را برمی‌گرداند. */
+    public function deleteAll(): int
+    {
+        return (int) $this->createQueryBuilder('l')
+            ->delete()
+            ->getQuery()
+            ->execute();
+    }
+
+    /** حذف لاگ‌های قدیمی‌تر از timestamp داده‌شده؛ تعداد حذف‌شده را برمی‌گرداند. */
+    public function deleteOlderThan(int $timestamp): int
+    {
+        return (int) $this->createQueryBuilder('l')
+            ->delete()
+            ->where('l.createdAt < :ts')
+            ->setParameter('ts', $timestamp)
+            ->getQuery()
+            ->execute();
+    }
 }

src/Shared/Logging/Command/PruneLogsCommand.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Shared\Logging\Command;
+
+use App\Shared\Logging\LogPruneService;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Output\OutputInterface;
+
+#[AsCommand(name: 'app:prune-logs', description: 'حذف لاگ‌های قدیمی‌تر از مدت نگهداری تنظیم‌شده')]
+final class PruneLogsCommand extends Command
+{
+    public function __construct(private readonly LogPruneService $pruneService)
+    {
+        parent::__construct();
+    }
+
+    protected function execute(InputInterface $input, OutputInterface $output): int
+    {
+        $deleted = $this->pruneService->pruneByRetention();
+        $output->writeln(sprintf('%d لاگ حذف شد.', $deleted));
+
+        return Command::SUCCESS;
+    }
+}

src/Shared/Logging/LogPruneService.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace App\Shared\Logging;
+
+use App\Config\Repository\SiteConfigRepository;
+
+/**
+ * حذف لاگ‌های قدیمی‌تر از مدت نگهداری تنظیم‌شده (`log_retention_days`).
+ * مقدار ۰ یا نامعتبر یعنی نگهداری نامحدود — چیزی حذف نمی‌شود.
+ */
+class LogPruneService
+{
+    public function __construct(
+        private readonly AppLogRepository     $logRepo,
+        private readonly SiteConfigRepository $configRepo,
+    ) {}
+
+    /** تعداد لاگ‌های حذف‌شده را برمی‌گرداند. */
+    public function pruneByRetention(): int
+    {
+        $days = (int) ($this->configRepo->get('log_retention_days') ?? 0);
+        if ($days <= 0) {
+            return 0;
+        }
+
+        $cutoff = time() - ($days * 86400);
+
+        return $this->logRepo->deleteOlderThan($cutoff);
+    }
+}

src/Shared/Logging/Message/PruneLogsMessage.php

@@ -0,0 +1,7 @@
+<?php
+
+namespace App\Shared\Logging\Message;
+
+class PruneLogsMessage
+{
+}

src/Shared/Logging/MessageHandler/PruneLogsHandler.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace App\Shared\Logging\MessageHandler;
+
+use App\Shared\Logging\LogPruneService;
+use App\Shared\Logging\Message\PruneLogsMessage;
+use Symfony\Component\Messenger\Attribute\AsMessageHandler;
+
+#[AsMessageHandler]
+final class PruneLogsHandler
+{
+    public function __construct(private readonly LogPruneService $pruneService) {}
+
+    public function __invoke(PruneLogsMessage $message): void
+    {
+        $this->pruneService->pruneByRetention();
+    }
+}