feat: add OpenAPI tags to various controllers for improved API documentation

src/Appointment/Controller/AppointmentSettingsController.php

@@ -21,7 +21,9 @@ 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;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'Appointment Settings')]
 #[IsGranted('IS_AUTHENTICATED_FULLY')]
 class AppointmentSettingsController extends BaseController
 {

src/Appointment/Controller/MyAppointmentsController.php

@@ -16,7 +16,9 @@ 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;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'My Appointments')]
 class MyAppointmentsController extends BaseController
 {
     public function __construct(

src/Auth/Controller/NotificationMobileController.php

@@ -15,7 +15,9 @@ 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;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'Auth')]
 #[IsGranted('IS_AUTHENTICATED_FULLY')]
 class NotificationMobileController extends BaseController
 {

src/Auth/Controller/PreRegistrationController.php

@@ -20,7 +20,9 @@ use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface;
 use Symfony\Component\Routing\Attribute\Route;
 use Symfony\Component\Security\Http\Attribute\IsGranted;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'Auth')]
 class PreRegistrationController extends BaseController
 {
     public function __construct(

src/Category/Controller/CategoryController.php

@@ -5,6 +5,7 @@ namespace App\Category\Controller;
 use App\Shared\Controller\BaseController;
 use Symfony\Component\HttpFoundation\JsonResponse;
 use Symfony\Component\Routing\Attribute\Route;
+use OpenApi\Attributes as OA;
 
 /**
  * Legacy stub — all endpoints migrated to domain-specific controllers:
@@ -14,6 +15,7 @@ use Symfony\Component\Routing\Attribute\Route;
  *   Insurances       → App\Insurance\Controller\InsuranceController
  *   Tags             → App\Tag\Controller\TagController
  */
+#[OA\Tag(name: 'Categories')]
 class CategoryController extends BaseController
 {
     #[Route('/api/v1/categorys/{bundle}', methods: ['GET'])]

src/ClinicInvitation/Controller/ClinicInvitationController.php

@@ -15,7 +15,9 @@ 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;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'Clinic Invitations')]
 class ClinicInvitationController extends BaseController
 {
     public function __construct(

src/ClinicService/Controller/ClinicServiceController.php

@@ -19,7 +19,9 @@ 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;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'Clinic Services')]
 #[IsGranted('IS_AUTHENTICATED_FULLY')]
 class ClinicServiceController extends BaseController
 {

src/Config/Controller/SiteConfigController.php

@@ -9,7 +9,9 @@ use Symfony\Component\HttpFoundation\JsonResponse;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\Routing\Attribute\Route;
 use Symfony\Component\Security\Http\Attribute\IsGranted;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'Config')]
 #[IsGranted('ROLE_ADMIN')]
 class SiteConfigController extends BaseController
 {

src/Dashboard/Controller/DashboardController.php

@@ -19,7 +19,9 @@ 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;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'Dashboard')]
 class DashboardController extends BaseController
 {
     public function __construct(

src/DoctorService/Controller/DoctorServiceController.php

@@ -11,7 +11,9 @@ use Symfony\Component\HttpFoundation\JsonResponse;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\Routing\Attribute\Route;
 use Symfony\Component\Security\Http\Attribute\IsGranted;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'Doctor Services')]
 class DoctorServiceController extends BaseController
 {
     public function __construct(

src/Insurance/Controller/InsuranceController.php

@@ -18,7 +18,9 @@ use Symfony\Component\Routing\Attribute\Route;
 use Symfony\Component\Security\Http\Attribute\CurrentUser;
 use Symfony\Component\Security\Http\Attribute\IsGranted;
 use Symfony\Component\Uid\Uuid;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'Insurance')]
 class InsuranceController extends BaseController
 {
     public function __construct(

src/Location/Controller/LocationController.php

@@ -12,7 +12,9 @@ use Symfony\Component\HttpFoundation\JsonResponse;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\Routing\Attribute\Route;
 use Symfony\Component\Security\Http\Attribute\IsGranted;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'Location')]
 class LocationController extends BaseController
 {
     public function __construct(

src/Patient/Controller/PatientController.php

@@ -21,7 +21,9 @@ 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;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'Patients')]
 #[IsGranted('IS_AUTHENTICATED_FULLY')]
 class PatientController extends BaseController
 {

src/Secretary/Controller/SecretaryController.php

@@ -17,7 +17,9 @@ use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface;
 use Symfony\Component\Routing\Attribute\Route;
 use Symfony\Component\Security\Http\Attribute\CurrentUser;
 use Symfony\Component\Security\Http\Attribute\IsGranted;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'Secretaries')]
 #[IsGranted('IS_AUTHENTICATED_FULLY')]
 class SecretaryController extends BaseController
 {

src/Sms/Controller/SmsWalletController.php

@@ -23,7 +23,9 @@ 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;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'SMS')]
 #[IsGranted('IS_AUTHENTICATED_FULLY')]
 class SmsWalletController extends BaseController
 {

src/Specialty/Controller/SpecialtyController.php

@@ -10,7 +10,9 @@ use Symfony\Component\HttpFoundation\JsonResponse;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\Routing\Attribute\Route;
 use Symfony\Component\Security\Http\Attribute\IsGranted;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'Specialties')]
 class SpecialtyController extends BaseController
 {
     public function __construct(

src/Staff/Controller/StaffController.php

@@ -14,7 +14,9 @@ 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;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'Staff')]
 #[IsGranted('IS_AUTHENTICATED_FULLY')]
 class StaffController extends BaseController
 {

src/Subscription/Controller/SubscriptionController.php

@@ -21,7 +21,9 @@ 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;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'Subscription')]
 class SubscriptionController extends BaseController
 {
     public function __construct(

src/Tag/Controller/TagController.php

@@ -10,7 +10,9 @@ use Symfony\Component\HttpFoundation\JsonResponse;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\Routing\Attribute\Route;
 use Symfony\Component\Security\Http\Attribute\IsGranted;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'Tags')]
 class TagController extends BaseController
 {
     public function __construct(

src/UserProfile/Controller/UserProfileController.php

@@ -12,7 +12,9 @@ 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;
+use OpenApi\Attributes as OA;
 
+#[OA\Tag(name: 'User Profile')]
 #[IsGranted('IS_AUTHENTICATED_FULLY')]
 class UserProfileController extends BaseController
 {