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.
2026-06-09 22:00:34 +03:30
commit de1a78a235
222 changed files with 36388 additions and 0 deletions
@@ -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]);
+    }
+}
@@ -0,0 +1,135 @@
+<?php
+
+namespace App\Blog\Entity;
+
+use App\Auth\Entity\User;
+use Doctrine\ORM\Mapping as ORM;
+use Symfony\Component\Uid\Uuid;
+
+#[ORM\Entity]
+#[ORM\Table(name: 'blogs')]
+#[ORM\Index(columns: ['status', 'created_at'], name: 'idx_blogs_status')]
+class Blog
+{
+    public const STATUS_DRAFT     = 'draft';
+    public const STATUS_PUBLISHED = 'published';
+    public const STATUS_ARCHIVED  = 'archived';
+
+    #[ORM\Id]
+    #[ORM\GeneratedValue]
+    #[ORM\Column(type: 'integer')]
+    private ?int $id = null;
+
+    #[ORM\Column(type: 'string', length: 36, unique: true)]
+    private string $uuid;
+
+    #[ORM\Column(type: 'string', length: 255)]
+    private string $title;
+
+    #[ORM\Column(type: 'string', length: 255, unique: true)]
+    private string $slug;
+
+    #[ORM\Column(type: 'text')]
+    private string $body;
+
+    #[ORM\Column(type: 'string', length: 500, nullable: true)]
+    private ?string $summary = null;
+
+    #[ORM\Column(type: 'string', length: 500, nullable: true)]
+    private ?string $imageUrl = null;
+
+    #[ORM\Column(name: 'image_path', type: 'string', length: 500, nullable: true)]
+    private ?string $imagePath = null;
+
+    #[ORM\ManyToOne(targetEntity: User::class)]
+    #[ORM\JoinColumn(name: 'author_id', referencedColumnName: 'id', nullable: false, onDelete: 'RESTRICT')]
+    private User $author;
+
+    #[ORM\Column(type: 'json')]
+    private array $tags = [];
+
+    #[ORM\Column(type: 'string', length: 20)]
+    private string $status = self::STATUS_DRAFT;
+
+    #[ORM\Column(name: 'created_at', type: 'integer')]
+    private int $createdAt;
+
+    #[ORM\Column(name: 'updated_at', type: 'integer')]
+    private int $updatedAt;
+
+    public function __construct(User $author, string $title, string $body)
+    {
+        $this->uuid      = Uuid::v4()->toRfc4122();
+        $this->author    = $author;
+        $this->title     = $title;
+        $this->slug      = $this->generateSlug($title);
+        $this->body      = $body;
+        $this->createdAt = time();
+        $this->updatedAt = time();
+    }
+
+    public function getId(): ?int       { return $this->id; }
+    public function getUuid(): string   { return $this->uuid; }
+    public function getTitle(): string  { return $this->title; }
+    public function getSlug(): string   { return $this->slug; }
+    public function getBody(): string   { return $this->body; }
+    public function getSummary(): ?string { return $this->summary; }
+    public function getImageUrl(): ?string { return $this->imageUrl; }
+    public function getImagePath(): ?string { return $this->imagePath; }
+    public function getAuthor(): User   { return $this->author; }
+    public function getTags(): array    { return $this->tags; }
+    public function getStatus(): string { return $this->status; }
+
+    public function setTitle(string $v): self    { $this->title = $v; $this->touch(); return $this; }
+    public function setSlug(string $v): self     { $this->slug = $v; $this->touch(); return $this; }
+    public function setBody(string $v): self     { $this->body = $v; $this->touch(); return $this; }
+    public function setSummary(?string $v): self { $this->summary = $v; $this->touch(); return $this; }
+    public function setImageUrl(?string $v): self  { $this->imageUrl = $v; $this->touch(); return $this; }
+    public function setImagePath(?string $v): self { $this->imagePath = $v; $this->touch(); return $this; }
+    public function setTags(array $v): self      { $this->tags = $v; $this->touch(); return $this; }
+    public function setStatus(string $v): self   { $this->status = $v; $this->touch(); return $this; }
+
+    private function touch(): void { $this->updatedAt = time(); }
+
+    private function generateSlug(string $title): string
+    {
+        $slug = mb_strtolower(trim($title));
+        $slug = preg_replace('/\s+/', '-', $slug);
+        $slug = preg_replace('/[^a-z0-9\-\p{Arabic}]/u', '', $slug);
+        return $slug . '-' . substr(str_replace('-', '', $this->uuid), 0, 8);
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'uuid'       => $this->uuid,
+            'title'      => $this->title,
+            'slug'       => $this->slug,
+            'summary'    => $this->summary,
+            'body'       => $this->body,
+            'image_url'  => $this->imageUrl,
+            'tags'       => $this->tags,
+            'status'     => $this->status,
+            'author'     => [
+                'uuid'   => $this->author->getUuid(),
+                'name'   => $this->author->getRealName(),
+            ],
+            'created_at' => $this->createdAt,
+            'updated_at' => $this->updatedAt,
+        ];
+    }
+
+    public function toListArray(): array
+    {
+        return [
+            'uuid'       => $this->uuid,
+            'title'      => $this->title,
+            'slug'       => $this->slug,
+            'summary'    => $this->summary,
+            'image_url'  => $this->imageUrl,
+            'tags'       => $this->tags,
+            'status'     => $this->status,
+            'created_at' => $this->createdAt,
+        ];
+    }
+}
@@ -0,0 +1,39 @@
+<?php
+
+namespace App\Blog\Repository;
+
+use App\Blog\Entity\Blog;
+use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
+use Doctrine\Persistence\ManagerRegistry;
+
+class BlogRepository extends ServiceEntityRepository
+{
+    public function __construct(ManagerRegistry $registry) { parent::__construct($registry, Blog::class); }
+
+    public function findByUuid(string $uuid): ?Blog { return $this->findOneBy(['uuid' => $uuid]); }
+    public function findBySlug(string $slug): ?Blog { return $this->findOneBy(['slug' => $slug]); }
+
+    /** @return Blog[] published, newest first */
+    public function findPublished(int $page = 1, int $limit = 20): array
+    {
+        return $this->createQueryBuilder('b')
+            ->where('b.status = :status')
+            ->setParameter('status', Blog::STATUS_PUBLISHED)
+            ->orderBy('b.createdAt', 'DESC')
+            ->setFirstResult(($page - 1) * $limit)
+            ->setMaxResults($limit)
+            ->getQuery()->getResult();
+    }
+
+    public function countPublished(): int
+    {
+        return (int) $this->createQueryBuilder('b')
+            ->select('COUNT(b.id)')
+            ->where('b.status = :status')
+            ->setParameter('status', Blog::STATUS_PUBLISHED)
+            ->getQuery()->getSingleScalarResult();
+    }
+
+    public function save(Blog $e, bool $flush = true): void { $this->getEntityManager()->persist($e); if ($flush) $this->getEntityManager()->flush(); }
+    public function remove(Blog $e, bool $flush = true): void { $this->getEntityManager()->remove($e); if ($flush) $this->getEntityManager()->flush(); }
+}