feat: implement staff management and subscription system

- Added StaffController for managing clinic staff, including listing, creating, updating, and toggling staff status. - Created ClinicStaff entity and repository for staff data handling. - Developed SubscriptionController to manage subscription plans and periods, including trial subscriptions. - Introduced SubscriptionPlan, SubscriptionPeriod, and ClinicSubscription entities for subscription management. - Implemented SubscriptionService for handling subscription logic, including trial activation and subscription creation from payments. - Added necessary repositories for subscription entities to facilitate data access and manipulation.
2026-06-14 22:10:28 +03:30
parent dcd631f503
commit b0244f28f5
53 changed files with 4434 additions and 40 deletions
@@ -0,0 +1,241 @@
+<?php
+
+namespace App\ClinicService\Controller;
+
+use App\Auth\Entity\User;
+use App\ClinicService\Entity\ServiceItem;
+use App\ClinicService\Entity\ServiceSection;
+use App\ClinicService\Repository\ServiceItemRepository;
+use App\ClinicService\Repository\ServiceSectionRepository;
+use App\Clinic\Repository\ClinicRepository;
+use App\Doctor\Repository\DoctorRepository;
+use App\Shared\Constant\ErrorCodes;
+use App\Shared\Controller\BaseController;
+use App\Shared\Exception\AppException;
+use App\Staff\Repository\ClinicStaffRepository;
+use App\Subscription\Service\SubscriptionService;
+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;
+
+#[IsGranted('IS_AUTHENTICATED_FULLY')]
+class ClinicServiceController extends BaseController
+{
+    public function __construct(
+        private readonly ServiceSectionRepository $sectionRepo,
+        private readonly ServiceItemRepository    $itemRepo,
+        private readonly ClinicStaffRepository    $staffRepo,
+        private readonly SubscriptionService      $subscriptionService,
+        private readonly DoctorRepository         $doctorRepo,
+        private readonly ClinicRepository         $clinicRepo,
+    ) {}
+
+    // ── Service Sections ─────────────────────────────────────────────────────
+
+    #[Route('/api/v1/service-sections', methods: ['GET'])]
+    public function listSections(#[CurrentUser] User $user): JsonResponse
+    {
+        [$entityType, $entityId] = $this->resolveEntity($user);
+        $this->assertServicesGate($entityType, $entityId);
+
+        $sections = array_map(
+            fn(ServiceSection $s) => $s->toArray(),
+            $this->sectionRepo->findByEntity($entityType, $entityId)
+        );
+
+        return $this->success($sections);
+    }
+
+    #[Route('/api/v1/service-section', methods: ['POST'])]
+    public function createSection(Request $request, #[CurrentUser] User $user): JsonResponse
+    {
+        [$entityType, $entityId] = $this->resolveEntity($user);
+        $this->assertServicesGate($entityType, $entityId);
+
+        $data = json_decode($request->getContent(), true) ?? [];
+        $name = trim($data['name'] ?? '');
+
+        if ($name === '') {
+            return $this->error(ErrorCodes::ERR_VALIDATION_001, 'name الزامی است', 422);
+        }
+
+        $section = new ServiceSection($entityType, $entityId, $name);
+        $this->sectionRepo->save($section);
+
+        return $this->success($section->toArray(), 201);
+    }
+
+    #[Route('/api/v1/service-section/{uuid}', methods: ['PATCH'])]
+    public function updateSection(string $uuid, Request $request, #[CurrentUser] User $user): JsonResponse
+    {
+        [$entityType, $entityId] = $this->resolveEntity($user);
+        $this->assertServicesGate($entityType, $entityId);
+
+        $section = $this->sectionRepo->findByUuid($uuid);
+        if ($section === null || !$this->ownsSection($section, $entityType, $entityId)) {
+            return $this->error(ErrorCodes::ERR_SERVICE_NOT_FOUND, ErrorCodes::message(ErrorCodes::ERR_SERVICE_NOT_FOUND), 404);
+        }
+
+        $data = json_decode($request->getContent(), true) ?? [];
+        if (isset($data['name']) && trim($data['name']) !== '') {
+            $section->setName(trim($data['name']));
+        }
+        if (isset($data['active'])) {
+            $section->setActive((bool) $data['active']);
+        }
+
+        $this->sectionRepo->save($section);
+
+        return $this->success($section->toArray());
+    }
+
+    #[Route('/api/v1/service-section/{uuid}', methods: ['DELETE'])]
+    public function deleteSection(string $uuid, #[CurrentUser] User $user): JsonResponse
+    {
+        [$entityType, $entityId] = $this->resolveEntity($user);
+        $this->assertServicesGate($entityType, $entityId);
+
+        $section = $this->sectionRepo->findByUuid($uuid);
+        if ($section === null || !$this->ownsSection($section, $entityType, $entityId)) {
+            return $this->error(ErrorCodes::ERR_SERVICE_NOT_FOUND, ErrorCodes::message(ErrorCodes::ERR_SERVICE_NOT_FOUND), 404);
+        }
+
+        $this->sectionRepo->remove($section);
+
+        return $this->success(['message' => 'بخش حذف شد']);
+    }
+
+    // ── Service Items ────────────────────────────────────────────────────────
+
+    #[Route('/api/v1/service-items/{sectionUuid}', methods: ['GET'])]
+    public function listItems(string $sectionUuid, #[CurrentUser] User $user): JsonResponse
+    {
+        [$entityType, $entityId] = $this->resolveEntity($user);
+
+        $section = $this->sectionRepo->findByUuid($sectionUuid);
+        if ($section === null || !$this->ownsSection($section, $entityType, $entityId)) {
+            return $this->error(ErrorCodes::ERR_SERVICE_NOT_FOUND, ErrorCodes::message(ErrorCodes::ERR_SERVICE_NOT_FOUND), 404);
+        }
+
+        $items = array_map(
+            fn(ServiceItem $i) => $i->toArray(),
+            $this->itemRepo->findBySection($section)
+        );
+
+        return $this->success($items);
+    }
+
+    #[Route('/api/v1/service-item', methods: ['POST'])]
+    public function createItem(Request $request, #[CurrentUser] User $user): JsonResponse
+    {
+        [$entityType, $entityId] = $this->resolveEntity($user);
+        $this->assertServicesGate($entityType, $entityId);
+
+        $data        = json_decode($request->getContent(), true) ?? [];
+        $sectionUuid = $data['section_uuid'] ?? '';
+        $name        = trim($data['name'] ?? '');
+
+        if ($name === '' || $sectionUuid === '') {
+            return $this->error(ErrorCodes::ERR_VALIDATION_001, 'section_uuid و name الزامی هستند', 422);
+        }
+
+        $section = $this->sectionRepo->findByUuid($sectionUuid);
+        if ($section === null || !$this->ownsSection($section, $entityType, $entityId)) {
+            return $this->error(ErrorCodes::ERR_SERVICE_NOT_FOUND, 'بخش یافت نشد', 404);
+        }
+
+        $item = new ServiceItem($section, $name, (int) ($data['price_rials'] ?? 0));
+
+        if (!empty($data['staff_uuid'])) {
+            $staff = $this->staffRepo->findByUuid($data['staff_uuid']);
+            if ($staff !== null) {
+                $item->setStaff($staff);
+            }
+        }
+
+        $this->itemRepo->save($item);
+
+        return $this->success($item->toArray(), 201);
+    }
+
+    #[Route('/api/v1/service-item/{uuid}', methods: ['PATCH'])]
+    public function updateItem(string $uuid, Request $request, #[CurrentUser] User $user): JsonResponse
+    {
+        [$entityType, $entityId] = $this->resolveEntity($user);
+
+        $item = $this->itemRepo->findByUuid($uuid);
+        if ($item === null || !$this->ownsSection($item->getSection(), $entityType, $entityId)) {
+            return $this->error(ErrorCodes::ERR_SERVICE_NOT_FOUND, ErrorCodes::message(ErrorCodes::ERR_SERVICE_NOT_FOUND), 404);
+        }
+
+        $data = json_decode($request->getContent(), true) ?? [];
+
+        if (isset($data['name']) && trim($data['name']) !== '')  { $item->setName(trim($data['name'])); }
+        if (isset($data['price_rials']))                          { $item->setPriceRials((int) $data['price_rials']); }
+        if (isset($data['active']))                               { $item->setActive((bool) $data['active']); }
+        if (array_key_exists('staff_uuid', $data)) {
+            $staff = $data['staff_uuid'] ? $this->staffRepo->findByUuid($data['staff_uuid']) : null;
+            $item->setStaff($staff);
+        }
+
+        $this->itemRepo->save($item);
+
+        return $this->success($item->toArray());
+    }
+
+    #[Route('/api/v1/service-item/{uuid}', methods: ['DELETE'])]
+    public function deleteItem(string $uuid, #[CurrentUser] User $user): JsonResponse
+    {
+        [$entityType, $entityId] = $this->resolveEntity($user);
+
+        $item = $this->itemRepo->findByUuid($uuid);
+        if ($item === null || !$this->ownsSection($item->getSection(), $entityType, $entityId)) {
+            return $this->error(ErrorCodes::ERR_SERVICE_NOT_FOUND, ErrorCodes::message(ErrorCodes::ERR_SERVICE_NOT_FOUND), 404);
+        }
+
+        try {
+            $this->itemRepo->remove($item);
+        } catch (\Doctrine\DBAL\Exception\ForeignKeyConstraintViolationException) {
+            return $this->error(ErrorCodes::ERR_SERVICE_ITEM_IN_USE, ErrorCodes::message(ErrorCodes::ERR_SERVICE_ITEM_IN_USE), 409);
+        }
+
+        return $this->success(['message' => 'سرویس حذف شد']);
+    }
+
+    // ── Helpers ──────────────────────────────────────────────────────────────
+
+    private function resolveEntity(User $user): array
+    {
+        if ($user->hasRole('ROLE_DOCTOR')) {
+            $doctor = $this->doctorRepo->findByUser($user);
+            return $doctor !== null ? ['doctor', $doctor->getId()] : ['doctor', null];
+        }
+
+        if ($user->hasRole('ROLE_CLINIC')) {
+            $clinic = $this->clinicRepo->findByUser($user);
+            return $clinic !== null ? ['clinic', $clinic->getId()] : ['clinic', null];
+        }
+
+        return ['unknown', null];
+    }
+
+    private function assertServicesGate(string $entityType, ?int $entityId): void
+    {
+        if ($entityId === null) {
+            throw new AppException(ErrorCodes::ERR_FORBIDDEN_001, null, 403);
+        }
+
+        if (!$this->subscriptionService->hasFeature($entityType, $entityId, 'services')) {
+            throw new AppException(ErrorCodes::ERR_SUBSCRIPTION_REQUIRED, null, 403);
+        }
+    }
+
+    private function ownsSection(ServiceSection $section, string $entityType, ?int $entityId): bool
+    {
+        return $entityId !== null
+            && $section->getEntityType() === $entityType
+            && $section->getEntityId() === $entityId;
+    }
+}
@@ -0,0 +1,84 @@
+<?php
+
+namespace App\ClinicService\Entity;
+
+use App\ClinicService\Repository\ServiceItemRepository;
+use App\Staff\Entity\ClinicStaff;
+use Doctrine\ORM\Mapping as ORM;
+use Symfony\Component\Uid\Uuid;
+
+#[ORM\Entity(repositoryClass: ServiceItemRepository::class)]
+#[ORM\Table(name: 'service_items')]
+class ServiceItem
+{
+    #[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: ServiceSection::class, inversedBy: 'items')]
+    #[ORM\JoinColumn(nullable: false, onDelete: 'CASCADE')]
+    private ServiceSection $section;
+
+    #[ORM\ManyToOne(targetEntity: ClinicStaff::class)]
+    #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
+    private ?ClinicStaff $staff = null;
+
+    #[ORM\Column(type: 'string', length: 200)]
+    private string $name;
+
+    #[ORM\Column(name: 'price_rials', type: 'integer')]
+    private int $priceRials = 0;
+
+    #[ORM\Column(type: 'boolean')]
+    private bool $active = true;
+
+    #[ORM\Column(name: 'created_at', type: 'integer')]
+    private int $createdAt;
+
+    #[ORM\Column(name: 'updated_at', type: 'integer')]
+    private int $updatedAt;
+
+    public function __construct(ServiceSection $section, string $name, int $priceRials = 0)
+    {
+        $this->uuid       = Uuid::v4()->toRfc4122();
+        $this->section    = $section;
+        $this->name       = $name;
+        $this->priceRials = $priceRials;
+        $this->createdAt  = time();
+        $this->updatedAt  = time();
+    }
+
+    public function getId(): ?int              { return $this->id; }
+    public function getUuid(): string          { return $this->uuid; }
+    public function getSection(): ServiceSection { return $this->section; }
+    public function getStaff(): ?ClinicStaff   { return $this->staff; }
+    public function getName(): string          { return $this->name; }
+    public function getPriceRials(): int       { return $this->priceRials; }
+    public function isActive(): bool           { return $this->active; }
+    public function getCreatedAt(): int        { return $this->createdAt; }
+    public function getUpdatedAt(): int        { return $this->updatedAt; }
+
+    public function setStaff(?ClinicStaff $staff): self  { $this->staff = $staff; $this->updatedAt = time(); return $this; }
+    public function setName(string $name): self           { $this->name = $name; $this->updatedAt = time(); return $this; }
+    public function setPriceRials(int $price): self       { $this->priceRials = $price; $this->updatedAt = time(); return $this; }
+    public function setActive(bool $active): self         { $this->active = $active; $this->updatedAt = time(); return $this; }
+
+    public function toArray(): array
+    {
+        return [
+            'uuid'         => $this->uuid,
+            'section_uuid' => $this->section->getUuid(),
+            'staff_uuid'   => $this->staff?->getUuid(),
+            'staff_name'   => $this->staff?->getFullName(),
+            'name'         => $this->name,
+            'price_rials'  => $this->priceRials,
+            'active'       => $this->active,
+            'created_at'   => $this->createdAt,
+            'updated_at'   => $this->updatedAt,
+        ];
+    }
+}
@@ -0,0 +1,80 @@
+<?php
+
+namespace App\ClinicService\Entity;
+
+use App\ClinicService\Repository\ServiceSectionRepository;
+use Doctrine\Common\Collections\ArrayCollection;
+use Doctrine\Common\Collections\Collection;
+use Doctrine\ORM\Mapping as ORM;
+use Symfony\Component\Uid\Uuid;
+
+#[ORM\Entity(repositoryClass: ServiceSectionRepository::class)]
+#[ORM\Table(name: 'service_sections')]
+#[ORM\Index(columns: ['entity_type', 'entity_id'], name: 'idx_service_section_entity')]
+class ServiceSection
+{
+    #[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(name: 'entity_type', type: 'string', length: 10)]
+    private string $entityType;
+
+    #[ORM\Column(name: 'entity_id', type: 'integer')]
+    private int $entityId;
+
+    #[ORM\Column(type: 'string', length: 200)]
+    private string $name;
+
+    #[ORM\Column(type: 'boolean')]
+    private bool $active = true;
+
+    #[ORM\Column(name: 'created_at', type: 'integer')]
+    private int $createdAt;
+
+    #[ORM\Column(name: 'updated_at', type: 'integer')]
+    private int $updatedAt;
+
+    #[ORM\OneToMany(targetEntity: ServiceItem::class, mappedBy: 'section', cascade: ['remove'])]
+    private Collection $items;
+
+    public function __construct(string $entityType, int $entityId, string $name)
+    {
+        $this->uuid       = Uuid::v4()->toRfc4122();
+        $this->entityType = $entityType;
+        $this->entityId   = $entityId;
+        $this->name       = $name;
+        $this->createdAt  = time();
+        $this->updatedAt  = time();
+        $this->items      = new ArrayCollection();
+    }
+
+    public function getId(): ?int          { return $this->id; }
+    public function getUuid(): string      { return $this->uuid; }
+    public function getEntityType(): string { return $this->entityType; }
+    public function getEntityId(): int     { return $this->entityId; }
+    public function getName(): string      { return $this->name; }
+    public function isActive(): bool       { return $this->active; }
+    public function getCreatedAt(): int    { return $this->createdAt; }
+    public function getUpdatedAt(): int    { return $this->updatedAt; }
+
+    public function setName(string $name): self   { $this->name = $name; $this->updatedAt = time(); return $this; }
+    public function setActive(bool $active): self { $this->active = $active; $this->updatedAt = time(); return $this; }
+
+    public function toArray(): array
+    {
+        return [
+            'uuid'        => $this->uuid,
+            'entity_type' => $this->entityType,
+            'entity_id'   => $this->entityId,
+            'name'        => $this->name,
+            'active'      => $this->active,
+            'created_at'  => $this->createdAt,
+            'updated_at'  => $this->updatedAt,
+        ];
+    }
+}
@@ -0,0 +1,43 @@
+<?php
+
+namespace App\ClinicService\Repository;
+
+use App\ClinicService\Entity\ServiceItem;
+use App\ClinicService\Entity\ServiceSection;
+use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
+use Doctrine\Persistence\ManagerRegistry;
+
+class ServiceItemRepository extends ServiceEntityRepository
+{
+    public function __construct(ManagerRegistry $registry)
+    {
+        parent::__construct($registry, ServiceItem::class);
+    }
+
+    public function findByUuid(string $uuid): ?ServiceItem
+    {
+        return $this->findOneBy(['uuid' => $uuid]);
+    }
+
+    public function findBySection(ServiceSection $section): array
+    {
+        return $this->createQueryBuilder('i')
+            ->where('i.section = :section')
+            ->setParameter('section', $section)
+            ->orderBy('i.name', 'ASC')
+            ->getQuery()
+            ->getResult();
+    }
+
+    public function save(ServiceItem $item): void
+    {
+        $this->getEntityManager()->persist($item);
+        $this->getEntityManager()->flush();
+    }
+
+    public function remove(ServiceItem $item): void
+    {
+        $this->getEntityManager()->remove($item);
+        $this->getEntityManager()->flush();
+    }
+}
@@ -0,0 +1,44 @@
+<?php
+
+namespace App\ClinicService\Repository;
+
+use App\ClinicService\Entity\ServiceSection;
+use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
+use Doctrine\Persistence\ManagerRegistry;
+
+class ServiceSectionRepository extends ServiceEntityRepository
+{
+    public function __construct(ManagerRegistry $registry)
+    {
+        parent::__construct($registry, ServiceSection::class);
+    }
+
+    public function findByUuid(string $uuid): ?ServiceSection
+    {
+        return $this->findOneBy(['uuid' => $uuid]);
+    }
+
+    public function findByEntity(string $entityType, int $entityId): array
+    {
+        return $this->createQueryBuilder('s')
+            ->where('s.entityType = :type')
+            ->andWhere('s.entityId = :id')
+            ->setParameter('type', $entityType)
+            ->setParameter('id', $entityId)
+            ->orderBy('s.name', 'ASC')
+            ->getQuery()
+            ->getResult();
+    }
+
+    public function save(ServiceSection $section): void
+    {
+        $this->getEntityManager()->persist($section);
+        $this->getEntityManager()->flush();
+    }
+
+    public function remove(ServiceSection $section): void
+    {
+        $this->getEntityManager()->remove($section);
+        $this->getEntityManager()->flush();
+    }
+}