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,134 @@
+<?php
+
+namespace App\Appointment\Entity;
+
+use App\Auth\Entity\User;
+use App\Doctor\Entity\Doctor;
+use Doctrine\ORM\Mapping as ORM;
+use Symfony\Component\Uid\Uuid;
+
+#[ORM\Entity]
+#[ORM\Table(name: 'appointments')]
+#[ORM\Index(columns: ['doctor_id', 'slot_start'], name: 'idx_appointments_doctor_slot')]
+#[ORM\Index(columns: ['user_id', 'status'],       name: 'idx_appointments_user_status')]
+class Appointment
+{
+    // Status machine: pending → confirmed → completed
+    //                        ↘ cancelled_by_doctor / cancelled_by_user
+    //                 pending → expired (cron)
+    //                 confirmed → no_show
+    public const STATUS_PENDING              = 'pending';
+    public const STATUS_CONFIRMED            = 'confirmed';
+    public const STATUS_COMPLETED            = 'completed';
+    public const STATUS_CANCELLED_BY_DOCTOR  = 'cancelled_by_doctor';
+    public const STATUS_CANCELLED_BY_USER    = 'cancelled_by_user';
+    public const STATUS_EXPIRED              = 'expired';
+    public const STATUS_NO_SHOW              = 'no_show';
+
+    public const ALLOWED_TRANSITIONS = [
+        self::STATUS_PENDING   => [self::STATUS_CONFIRMED, self::STATUS_CANCELLED_BY_DOCTOR, self::STATUS_CANCELLED_BY_USER, self::STATUS_EXPIRED],
+        self::STATUS_CONFIRMED => [self::STATUS_COMPLETED, self::STATUS_CANCELLED_BY_DOCTOR, self::STATUS_CANCELLED_BY_USER, self::STATUS_NO_SHOW],
+    ];
+
+    // Optimistic locking
+    #[ORM\Version]
+    #[ORM\Column(type: 'integer')]
+    private int $version = 1;
+
+    #[ORM\Id]
+    #[ORM\GeneratedValue]
+    #[ORM\Column(type: 'integer')]
+    private ?int $id = null;
+
+    #[ORM\Column(type: 'string', length: 36, unique: true)]
+    private string $uuid;
+
+    #[ORM\ManyToOne(targetEntity: Doctor::class)]
+    #[ORM\JoinColumn(name: 'doctor_id', referencedColumnName: 'id', nullable: false, onDelete: 'RESTRICT')]
+    private Doctor $doctor;
+
+    #[ORM\ManyToOne(targetEntity: User::class)]
+    #[ORM\JoinColumn(name: 'user_id', referencedColumnName: 'id', nullable: false, onDelete: 'RESTRICT')]
+    private User $user;
+
+    #[ORM\Column(name: 'slot_start', type: 'integer')]
+    private int $slotStart;
+
+    #[ORM\Column(name: 'slot_end', type: 'integer')]
+    private int $slotEnd;
+
+    #[ORM\Column(type: 'string', length: 30)]
+    private string $status = self::STATUS_PENDING;
+
+    #[ORM\Column(type: 'string', length: 255, nullable: true)]
+    private ?string $note = null;
+
+    #[ORM\Column(name: 'created_at', type: 'integer')]
+    private int $createdAt;
+
+    #[ORM\Column(name: 'updated_at', type: 'integer')]
+    private int $updatedAt;
+
+    public function __construct(Doctor $doctor, User $user, int $slotStart, int $slotEnd)
+    {
+        $this->uuid      = Uuid::v4()->toRfc4122();
+        $this->doctor    = $doctor;
+        $this->user      = $user;
+        $this->slotStart = $slotStart;
+        $this->slotEnd   = $slotEnd;
+        $this->createdAt = time();
+        $this->updatedAt = time();
+    }
+
+    public function getId(): ?int      { return $this->id; }
+    public function getUuid(): string  { return $this->uuid; }
+    public function getDoctor(): Doctor { return $this->doctor; }
+    public function getUser(): User    { return $this->user; }
+    public function getSlotStart(): int { return $this->slotStart; }
+    public function getSlotEnd(): int   { return $this->slotEnd; }
+    public function getStatus(): string { return $this->status; }
+    public function getNote(): ?string  { return $this->note; }
+    public function getVersion(): int   { return $this->version; }
+
+    public function setNote(?string $v): self { $this->note = $v; return $this; }
+
+    public function canTransitionTo(string $newStatus): bool
+    {
+        return in_array($newStatus, self::ALLOWED_TRANSITIONS[$this->status] ?? [], true);
+    }
+
+    public function transitionTo(string $newStatus): self
+    {
+        if (!$this->canTransitionTo($newStatus)) {
+            throw new \LogicException(sprintf(
+                'Cannot transition appointment from "%s" to "%s"',
+                $this->status, $newStatus
+            ));
+        }
+        $this->status    = $newStatus;
+        $this->updatedAt = time();
+        return $this;
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'uuid'       => $this->uuid,
+            'doctor'     => [
+                'uuid' => $this->doctor->getUuid(),
+                'name' => $this->doctor->getName(),
+            ],
+            'user'       => [
+                'uuid'   => $this->user->getUuid(),
+                'mobile' => $this->user->getMobileNumber(),
+            ],
+            'slot_start' => $this->slotStart,
+            'slot_end'   => $this->slotEnd,
+            'status'     => $this->status,
+            'note'       => $this->note,
+            'version'    => $this->version,
+            'created_at' => $this->createdAt,
+            'updated_at' => $this->updatedAt,
+        ];
+    }
+}