feat: Implement SMS sending functionality with KavehNegar and Rangineh providers

- Add SendSmsMessage class for encapsulating SMS message data.
- Create KavehNegarProvider and RanginehProvider classes implementing SmsProviderInterface for sending SMS.
- Implement SmsLogRepository and SmsTemplateRepository for managing SMS logs and templates.
- Develop SendSmsHandler for handling SMS sending messages.
- Create SmsService to manage SMS dispatching and logging.
- Add UserProfileController for managing user profiles with CRUD operations.
- Implement UserProfile entity and repository for user profile data management.
- Update symfony.lock and bootstrap.php for project dependencies and environment setup.

src/Blog/Controller/BlogController.php

@@ -0,0 +1,151 @@
+<?php
+
+namespace App\Blog\Controller;
+
+use App\Auth\Entity\User;
+use App\Blog\Entity\Blog;
+use App\Blog\Repository\BlogRepository;
+use App\Shared\Constant\ErrorCodes;
+use App\Shared\Controller\BaseController;
+use App\Shared\Service\FileValidatorService;
+use Symfony\Component\HttpFoundation\JsonResponse;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\Routing\Attribute\Route;
+use Symfony\Component\Security\Http\Attribute\CurrentUser;
+use Symfony\Component\Security\Http\Attribute\IsGranted;
+
+class BlogController extends BaseController
+{
+    public function __construct(
+        private readonly BlogRepository       $blogRepo,
+        private readonly FileValidatorService $fileValidator,
+        private readonly string               $projectDir,
+    ) {}
+
+    // ── Public list/detail ────────────────────────────────────────────────────
+
+    #[Route('/api/v1/blogs', methods: ['GET'])]
+    public function list(Request $request): JsonResponse
+    {
+        $page  = max(1, (int) $request->query->get('page', 1));
+        $limit = min(50, max(1, (int) $request->query->get('limit', 20)));
+
+        $blogs = array_map(fn(Blog $b) => $b->toListArray(), $this->blogRepo->findPublished($page, $limit));
+        $total = $this->blogRepo->countPublished();
+
+        return $this->paginated($blogs, $total, $page, $limit);
+    }
+
+    #[Route('/api/v1/blog/{slug}', methods: ['GET'])]
+    public function detail(string $slug): JsonResponse
+    {
+        $blog = $this->blogRepo->findBySlug($slug) ?? $this->blogRepo->findByUuid($slug);
+        if ($blog === null || $blog->getStatus() !== Blog::STATUS_PUBLISHED) {
+            return $this->error(ErrorCodes::ERR_NOT_FOUND_001, 'مقاله یافت نشد', 404);
+        }
+
+        return $this->success(['data' => $blog->toArray()]);
+    }
+
+    // ── Admin CRUD ────────────────────────────────────────────────────────────
+
+    #[IsGranted('ROLE_ADMIN')]
+    #[Route('/api/v1/blog', methods: ['POST'])]
+    public function create(Request $request, #[CurrentUser] User $user): JsonResponse
+    {
+        $data  = json_decode($request->getContent(), true) ?? [];
+        $title = trim($data['title'] ?? '');
+        $body  = trim($data['body'] ?? '');
+
+        if (empty($title) || empty($body)) {
+            return $this->error(ErrorCodes::ERR_VALIDATION_002, 'title و body الزامی است', 422);
+        }
+
+        $blog = new Blog($user, $title, $body);
+        if (!empty($data['summary']))  $blog->setSummary($data['summary']);
+        if (!empty($data['tags']))     $blog->setTags((array)$data['tags']);
+        if (!empty($data['status']))   $blog->setStatus($data['status']);
+
+        // Ensure slug uniqueness
+        if ($this->blogRepo->findBySlug($blog->getSlug()) !== null) {
+            $blog->setSlug($blog->getSlug() . '-' . substr(uniqid(), -4));
+        }
+
+        $this->blogRepo->save($blog);
+
+        return $this->success(['data' => $blog->toArray()], 201);
+    }
+
+    #[IsGranted('ROLE_ADMIN')]
+    #[Route('/api/v1/blog/{uuid}', methods: ['PATCH'])]
+    public function update(string $uuid, Request $request): JsonResponse
+    {
+        $blog = $this->blogRepo->findByUuid($uuid);
+        if ($blog === null) {
+            return $this->error(ErrorCodes::ERR_NOT_FOUND_001, 'مقاله یافت نشد', 404);
+        }
+
+        $data = json_decode($request->getContent(), true) ?? [];
+        if (array_key_exists('title', $data))   $blog->setTitle($data['title']);
+        if (array_key_exists('body', $data))    $blog->setBody($data['body']);
+        if (array_key_exists('summary', $data)) $blog->setSummary($data['summary']);
+        if (array_key_exists('tags', $data))    $blog->setTags((array)$data['tags']);
+        if (array_key_exists('status', $data))  $blog->setStatus($data['status']);
+
+        $this->blogRepo->save($blog);
+
+        return $this->success(['data' => $blog->toArray()]);
+    }
+
+    #[IsGranted('ROLE_ADMIN')]
+    #[Route('/api/v1/blog/{uuid}', methods: ['DELETE'])]
+    public function delete(string $uuid): JsonResponse
+    {
+        $blog = $this->blogRepo->findByUuid($uuid);
+        if ($blog === null) {
+            return $this->error(ErrorCodes::ERR_NOT_FOUND_001, 'مقاله یافت نشد', 404);
+        }
+
+        $this->blogRepo->remove($blog);
+        return $this->success(['message' => 'مقاله با موفقیت حذف شد']);
+    }
+
+    // ── Image upload ──────────────────────────────────────────────────────────
+
+    #[IsGranted('ROLE_ADMIN')]
+    #[Route('/file/upload/clinic_pro/blog/field_image', methods: ['POST'])]
+    public function uploadImage(Request $request): JsonResponse
+    {
+        $file     = $request->files->get('file');
+        $blogUuid = $request->request->get('blog_uuid', '');
+
+        if ($file === null) {
+            return $this->error(ErrorCodes::ERR_FILE_001, 'فایل ارسال نشده است', 422);
+        }
+
+        try {
+            $safeFilename = $this->fileValidator->validateUploadedFile($file);
+        } catch (\App\Shared\Exception\AppException $e) {
+            return $this->error($e->getErrorCode(), $e->getMessage(), $e->getHttpStatus());
+        }
+
+        $uploadDir = $this->projectDir . '/public/uploads/blogs/';
+        if (!is_dir($uploadDir)) mkdir($uploadDir, 0755, true);
+
+        $filename = uniqid('blog_') . '_' . $safeFilename;
+        $file->move($uploadDir, $filename);
+
+        $imageUrl  = '/uploads/blogs/' . $filename;
+        $imagePath = $uploadDir . $filename;
+
+        if (!empty($blogUuid)) {
+            $blog = $this->blogRepo->findByUuid($blogUuid);
+            if ($blog !== null) {
+                $blog->setImageUrl($imageUrl)->setImagePath($imagePath);
+                $this->blogRepo->save($blog);
+            }
+        }
+
+        return $this->success(['image_url' => $imageUrl, 'filename' => $filename]);
+    }
+}