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.
This commit is contained in:
hamed
2026-06-14 22:10:28 +03:30
parent dcd631f503
commit b0244f28f5
53 changed files with 4434 additions and 40 deletions
@@ -0,0 +1,114 @@
<?php
namespace App\Subscription\Entity;
use App\Payment\Entity\Payment;
use App\Subscription\Repository\ClinicSubscriptionRepository;
use Doctrine\ORM\Mapping as ORM;
use Symfony\Component\Uid\Uuid;
#[ORM\Entity(repositoryClass: ClinicSubscriptionRepository::class)]
#[ORM\Table(name: 'clinic_subscriptions')]
#[ORM\Index(columns: ['entity_type', 'entity_id', 'expires_at'], name: 'idx_subscription_entity_expires')]
class ClinicSubscription
{
#[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\ManyToOne(targetEntity: SubscriptionPlan::class)]
#[ORM\JoinColumn(nullable: false)]
private SubscriptionPlan $plan;
#[ORM\ManyToOne(targetEntity: SubscriptionPeriod::class)]
#[ORM\JoinColumn(nullable: false)]
private SubscriptionPeriod $period;
#[ORM\ManyToOne(targetEntity: Payment::class)]
#[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
private ?Payment $payment = null;
#[ORM\Column(name: 'is_trial', type: 'boolean')]
private bool $isTrial = false;
#[ORM\Column(name: 'starts_at', type: 'integer')]
private int $startsAt;
#[ORM\Column(name: 'expires_at', type: 'integer', nullable: true)]
private ?int $expiresAt = null;
#[ORM\Column(name: 'created_at', type: 'integer')]
private int $createdAt;
public function __construct(
string $entityType,
int $entityId,
SubscriptionPlan $plan,
SubscriptionPeriod $period,
bool $isTrial = false,
?int $expiresAt = null,
?Payment $payment = null
) {
$this->uuid = Uuid::v4()->toRfc4122();
$this->entityType = $entityType;
$this->entityId = $entityId;
$this->plan = $plan;
$this->period = $period;
$this->isTrial = $isTrial;
$this->startsAt = time();
$this->expiresAt = $expiresAt;
$this->payment = $payment;
$this->createdAt = time();
}
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 getPlan(): SubscriptionPlan { return $this->plan; }
public function getPeriod(): SubscriptionPeriod { return $this->period; }
public function getPayment(): ?Payment { return $this->payment; }
public function isTrial(): bool { return $this->isTrial; }
public function getStartsAt(): int { return $this->startsAt; }
public function getExpiresAt(): ?int { return $this->expiresAt; }
public function getCreatedAt(): int { return $this->createdAt; }
public function isActive(): bool
{
return $this->expiresAt === null || $this->expiresAt > time();
}
public function getDaysRemaining(): ?int
{
if ($this->expiresAt === null) {
return null;
}
$remaining = $this->expiresAt - time();
return max(0, (int) ceil($remaining / 86400));
}
public function toArray(): array
{
return [
'uuid' => $this->uuid,
'plan' => $this->plan->toArray(),
'period' => $this->period->toArray(),
'is_trial' => $this->isTrial,
'starts_at' => $this->startsAt,
'expires_at' => $this->expiresAt,
'days_remaining' => $this->getDaysRemaining(),
'is_active' => $this->isActive(),
'created_at' => $this->createdAt,
];
}
}
@@ -0,0 +1,92 @@
<?php
namespace App\Subscription\Entity;
use App\Subscription\Repository\SubscriptionPeriodRepository;
use Doctrine\ORM\Mapping as ORM;
use Symfony\Component\Uid\Uuid;
#[ORM\Entity(repositoryClass: SubscriptionPeriodRepository::class)]
#[ORM\Table(name: 'subscription_periods')]
class SubscriptionPeriod
{
#[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: SubscriptionPlan::class, inversedBy: 'periods')]
#[ORM\JoinColumn(nullable: false)]
private SubscriptionPlan $plan;
#[ORM\Column(type: 'string', length: 50)]
private string $label;
#[ORM\Column(name: 'duration_months', type: 'smallint')]
private int $durationMonths;
#[ORM\Column(name: 'price_rials', type: 'integer')]
private int $priceRials = 0;
#[ORM\Column(name: 'is_trial', type: 'boolean')]
private bool $isTrial = false;
#[ORM\Column(type: 'boolean')]
private bool $active = true;
#[ORM\Column(name: 'sort_order', type: 'smallint')]
private int $sortOrder = 0;
#[ORM\Column(name: 'created_at', type: 'integer')]
private int $createdAt;
#[ORM\Column(name: 'updated_at', type: 'integer')]
private int $updatedAt;
public function __construct(SubscriptionPlan $plan, string $label, int $durationMonths, int $priceRials, bool $isTrial = false)
{
$this->uuid = Uuid::v4()->toRfc4122();
$this->plan = $plan;
$this->label = $label;
$this->durationMonths = $durationMonths;
$this->priceRials = $priceRials;
$this->isTrial = $isTrial;
$this->createdAt = time();
$this->updatedAt = time();
}
public function getId(): ?int { return $this->id; }
public function getUuid(): string { return $this->uuid; }
public function getPlan(): SubscriptionPlan { return $this->plan; }
public function getLabel(): string { return $this->label; }
public function getDurationMonths(): int { return $this->durationMonths; }
public function getPriceRials(): int { return $this->priceRials; }
public function isTrial(): bool { return $this->isTrial; }
public function isActive(): bool { return $this->active; }
public function getSortOrder(): int { return $this->sortOrder; }
public function getCreatedAt(): int { return $this->createdAt; }
public function getUpdatedAt(): int { return $this->updatedAt; }
public function setLabel(string $label): self { $this->label = $label; $this->updatedAt = time(); return $this; }
public function setDurationMonths(int $v): self { $this->durationMonths = $v; $this->updatedAt = time(); return $this; }
public function setPriceRials(int $v): self { $this->priceRials = $v; $this->updatedAt = time(); return $this; }
public function setActive(bool $active): self { $this->active = $active; $this->updatedAt = time(); return $this; }
public function setSortOrder(int $order): self { $this->sortOrder = $order; $this->updatedAt = time(); return $this; }
public function toArray(): array
{
return [
'uuid' => $this->uuid,
'plan_uuid' => $this->plan->getUuid(),
'label' => $this->label,
'duration_months'=> $this->durationMonths,
'price_rials' => $this->priceRials,
'is_trial' => $this->isTrial,
'active' => $this->active,
'sort_order' => $this->sortOrder,
];
}
}
@@ -0,0 +1,101 @@
<?php
namespace App\Subscription\Entity;
use App\Subscription\Repository\SubscriptionPlanRepository;
use Doctrine\Common\Collections\ArrayCollection;
use Doctrine\Common\Collections\Collection;
use Doctrine\ORM\Mapping as ORM;
use Symfony\Component\Uid\Uuid;
#[ORM\Entity(repositoryClass: SubscriptionPlanRepository::class)]
#[ORM\Table(name: 'subscription_plans')]
class SubscriptionPlan
{
#[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: 30, unique: true)]
private string $name;
#[ORM\Column(type: 'smallint')]
private int $level;
#[ORM\Column(name: 'max_secretaries', type: 'smallint')]
private int $maxSecretaries = 1;
#[ORM\Column(type: 'json')]
private array $features = [];
#[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: SubscriptionPeriod::class, mappedBy: 'plan')]
private Collection $periods;
public function __construct(string $name, int $level, int $maxSecretaries, array $features)
{
$this->uuid = Uuid::v4()->toRfc4122();
$this->name = $name;
$this->level = $level;
$this->maxSecretaries = $maxSecretaries;
$this->features = $features;
$this->createdAt = time();
$this->updatedAt = time();
$this->periods = new ArrayCollection();
}
public function getId(): ?int { return $this->id; }
public function getUuid(): string { return $this->uuid; }
public function getName(): string { return $this->name; }
public function getLevel(): int { return $this->level; }
public function getMaxSecretaries(): int { return $this->maxSecretaries; }
public function getFeatures(): array { return $this->features; }
public function isActive(): bool { return $this->active; }
public function getCreatedAt(): int { return $this->createdAt; }
public function getUpdatedAt(): int { return $this->updatedAt; }
public function getPeriods(): Collection { return $this->periods; }
public function setName(string $name): self { $this->name = $name; $this->updatedAt = time(); return $this; }
public function setLevel(int $level): self { $this->level = $level; $this->updatedAt = time(); return $this; }
public function setMaxSecretaries(int $v): self { $this->maxSecretaries = $v; $this->updatedAt = time(); return $this; }
public function setFeatures(array $features): self { $this->features = $features; $this->updatedAt = time(); return $this; }
public function setActive(bool $active): self { $this->active = $active; $this->updatedAt = time(); return $this; }
public function hasFeature(string $feature): bool
{
return (bool) ($this->features[$feature] ?? false);
}
public function toArray(bool $withPeriods = false): array
{
$data = [
'uuid' => $this->uuid,
'name' => $this->name,
'level' => $this->level,
'max_secretaries' => $this->maxSecretaries,
'features' => $this->features,
'active' => $this->active,
];
if ($withPeriods) {
$data['periods'] = array_map(
fn(SubscriptionPeriod $p) => $p->toArray(),
$this->periods->filter(fn(SubscriptionPeriod $p) => $p->isActive())->toArray()
);
}
return $data;
}
}