src/ApiBundle/Controller/JobOfferController.php line 84

Open in your IDE?
  1. <?php
  3. declare(strict_types=1);
  5. namespace ApiBundle\Controller;
  7. use AppBundle\MobileJobOffer\DTO\MobileJobOfferDetailsDTO;
  8. use AppBundle\MobileJobOffer\Request\MobileJobOfferSearchRequest;
  9. use AppBundle\MobileJobOffer\Service\InterestSubmissionService;
  10. use AppBundle\MobileJobOffer\Service\MobileJobOfferSearchService;
  11. use AppBundle\Repository\MobileJobOfferRepository;
  12. use Exception;
  13. use OpenApi\Attributes as OA;
  14. use Pimcore\Model\DataObject\MobileJobOffer;
  15. use Symfony\Component\HttpFoundation\JsonResponse;
  16. use Symfony\Component\HttpFoundation\Request;
  17. use Symfony\Component\HttpFoundation\Response;
  18. use Symfony\Component\Routing\Annotation\Route;
  20. class JobOfferController extends ApiController
  21. {
  22.     private MobileJobOfferSearchService $mobileJobOfferSearchService;
  23.     private MobileJobOfferRepository $mobileJobOfferRepository;
  24.     private InterestSubmissionService $interestSubmissionService;
  26.     public function __construct(MobileJobOfferSearchService $mobileJobOfferSearchService, MobileJobOfferRepository $mobileJobOfferRepository, InterestSubmissionService $interestSubmissionService, string $apiKey)
  27.     {
  28.         $this->mobileJobOfferSearchService = $mobileJobOfferSearchService;
  29.         $this->mobileJobOfferRepository = $mobileJobOfferRepository;
  30.         $this->interestSubmissionService = $interestSubmissionService;
  32.         parent::__construct($apiKey);
  33.     }
  35.     #[Route('/api/job-offers', name: 'api_job_offers_list', methods: ['GET'])]
  36.     #[OA\Get(path: '/api/job-offers', description: 'Zwraca listę ofert pracy z możliwością filtrowania po mieście, stanowisku, rodzaju umowy, lokalizacji GPS, dacie oraz stronnicowaniem.', summary: 'Lista ofert pracy z filtrami i paginacją', tags: ['Job Offers'])]
  37.     #[OA\Parameter(name: 'X-API-KEY', description: 'Klucz API wymagany do autoryzacji', in: 'header', required: true, schema: new OA\Schema(type: 'string', example: 'your-api-key'))]
  38.     #[OA\Parameter(name: 'cityIds', description: 'Lista ID miast, oddzielone przecinkami (np. 1,2,3)', in: 'query', required: false, schema: new OA\Schema(type: 'string', example: '1,2,3'))]
  39.     #[OA\Parameter(name: 'positionIds', description: 'Lista ID stanowisk, oddzielone przecinkami (np. 1,2,3)', in: 'query', required: false, schema: new OA\Schema(type: 'string', example: '1,2,5'))]
  40.     #[OA\Parameter(name: 'contractTypeIds', description: 'Lista ID rodzajów umów, oddzielone przecinkami (np. 1,3)', in: 'query', required: false, schema: new OA\Schema(type: 'string', example: '1,3'))]
  41.     #[OA\Parameter(name: 'gpsPoints', description: "Tablica punktów GPS w formacie 'lat,lon'. Użyj gpsPoints[]=52.2297,21.0122&gpsPoints[]=50.06143,19.93658", in: 'query', required: false, schema: new OA\Schema(
  42.         type: 'array',
  43.         items: new OA\Items(description: 'Format: latitude,longitude', type: 'string', example: '52.2297,21.0122'),
  44.     ), example: ['52.2297,21.0122', '50.06143,19.93658'], style: 'form', explode: true)]
  45.     #[OA\Parameter(name: 'gpsRadius', description: 'Promień w kilometrach wokół punktu GPS do filtrowania ofert', in: 'query', required: false, schema: new OA\Schema(type: 'number', format: 'float', example: 10))]
  46.     #[OA\Parameter(name: 'dateFrom', description: 'Początkowa data zakresu w formacie YYYY-MM-DD', in: 'query', required: false, schema: new OA\Schema(type: 'string', format: 'date', example: '2025-09-01'))]
  47.     #[OA\Parameter(name: 'dateTo', description: 'Końcowa data zakresu w formacie YYYY-MM-DD', in: 'query', required: false, schema: new OA\Schema(type: 'string', format: 'date', example: '2025-09-30'))]
  48.     #[OA\Parameter(name: 'limit', description: 'Ilość ofert do zwrócenia na stronie (stronnicowanie)', in: 'query', required: false, schema: new OA\Schema(type: 'integer', default: 20, example: 20))]
  49.     #[OA\Parameter(name: 'offset', description: 'Przesunięcie wyników (ilość ofert do pominięcia) dla stronnicowania', in: 'query', required: false, schema: new OA\Schema(type: 'integer', default: 0, example: 0))]
  50.     #[OA\Response(
  51.         response: 200,
  52.         description: 'Lista ofert pracy',
  53.         content: new OA\JsonContent(
  54.             properties: [
  55.                 new OA\Property(property: 'success', type: 'boolean', example: true),
  56.                 new OA\Property(
  57.                     property: 'data',
  58.                     properties: [
  59.                         new OA\Property(property: 'hasMore', description: 'Czy są kolejne strony wyników', type: 'boolean', example: true),
  60.                         new OA\Property(property: 'totalCount', description: 'Całkowita liczba ofert spełniających kryteria', type: 'integer', example: 42),
  61.                         new OA\Property(
  62.                             property: 'offers',
  63.                             type: 'array',
  64.                             items: new OA\Items(
  65.                                 properties: [
  66.                                     new OA\Property(property: 'id', type: 'integer', example: 7423),
  67.                                     new OA\Property(property: 'nameFirstLine', type: 'string', example: 'Magisterka farmacji'),
  68.                                     new OA\Property(property: 'nameSecondLine', type: 'string', example: 'Magister farmacji'),
  69.                                     new OA\Property(property: 'cityId', type: 'integer', example: 1),
  70.                                     new OA\Property(property: 'cityName', type: 'string', example: 'Kraków'),
  71.                                     new OA\Property(property: 'hourlyRateSummary', type: 'string', example: '25-30 zł/h'),
  72.                                     new OA\Property(property: 'publicationDate', type: 'string', format: 'date-time', example: '2025-09-10T12:00:00Z'),
  73.                                 ],
  74.                                 type: 'object',
  75.                             ),
  76.                         ),
  77.                     ],
  78.                     type: 'object',
  79.                 ),
  80.             ],
  81.             type: 'object',
  82.         ),
  83.     )]
  84.     public function list(Request $request): JsonResponse
  85.     {
  86.         if (!$this->validateApiKey($request)) {
  87.             return $this->returnInvalidApiKeyError();
  88.         }
  90.         try {
  91.             $searchRequest = MobileJobOfferSearchRequest::fromRequest($request);
  92.             $offer = $this->mobileJobOfferSearchService->searchOffer($searchRequest);
  94.             return new JsonResponse([
  95.                 'success' => true,
  96.                 'data' => $offer,
  97.             ]);
  98.         } catch (Exception $e) {
  99.             return new JsonResponse([
  100.                 'success' => false,
  101.                 'error' => $e->getMessage(),
  102.             ], Response::HTTP_BAD_REQUEST);
  103.         }
  104.     }
  106.     #[Route('/api/job-offers/{id}', name: 'api_job_offers_details', methods: ['GET'])]
  107.     #[OA\Get(path: '/api/job-offers/{id}', description: 'Endpoint zwraca szczegółowe informacje o konkretnej ofercie pracy na podstawie jej ID.', summary: 'Szczegóły oferty pracy', tags: ['Job Offers'])]
  108.     #[OA\Parameter(name: 'X-API-KEY', description: 'Klucz API wymagany do autoryzacji', in: 'header', required: true, schema: new OA\Schema(type: 'string', example: 'your-api-key'))]
  109.     #[OA\Parameter(name: 'id', description: 'ID oferty pracy', in: 'path', required: true, schema: new OA\Schema(type: 'integer', example: 7423))]
  110.     #[OA\Response(
  111.         response: 200,
  112.         description: 'Szczegóły oferty pracy',
  113.         content: new OA\JsonContent(
  114.             properties: [
  115.                 new OA\Property(property: 'success', type: 'boolean', example: true),
  116.                 new OA\Property(
  117.                     property: 'data',
  118.                     properties: [
  119.                         new OA\Property(property: 'id', type: 'integer', example: 7423),
  120.                         new OA\Property(property: 'nameFirstLine', type: 'string', example: 'Magisterka farmacji'),
  121.                         new OA\Property(property: 'nameSecondLine', type: 'string', example: 'Magister farmacji'),
  122.                         new OA\Property(property: 'cityId', type: 'integer', example: 1),
  123.                         new OA\Property(property: 'cityName', type: 'string', example: 'Kraków'),
  124.                         new OA\Property(property: 'hourlyRateSummary', type: 'string', example: '25-30 zł/h'),
  125.                         new OA\Property(
  126.                             property: 'gpsPoint',
  127.                             properties: [
  128.                                 new OA\Property(property: 'lat', type: 'number', format: 'float', example: 50.0514238),
  129.                                 new OA\Property(property: 'lng', type: 'number', format: 'float', example: 19.9415525),
  130.                             ],
  131.                             type: 'object',
  132.                         ),
  133.                         new OA\Property(
  134.                             property: 'sections',
  135.                             description: 'Sekcje opisu oferty, każda z tytułem i treścią',
  136.                             type: 'array',
  137.                             items: new OA\Items(
  138.                                 properties: [
  139.                                     new OA\Property(property: 'title', type: 'string', example: 'Opis stanowiska'),
  140.                                     new OA\Property(property: 'descriptions', type: 'string', example: 'Opis szczegółowy stanowiska pracy...'),
  141.                                 ],
  142.                                 type: 'object',
  143.                             ),
  144.                         ),
  145.                     ],
  146.                     type: 'object',
  147.                 ),
  148.             ],
  149.             type: 'object',
  150.         ),
  151.     )]
  152.     public function details(Request $request, int $id): JsonResponse
  153.     {
  154.         if (!$this->validateApiKey($request)) {
  155.             return $this->returnInvalidApiKeyError();
  156.         }
  158.         $mobile = $this->mobileJobOfferRepository->find($id);
  160.         if (!$mobile instanceof MobileJobOffer) {
  161.             return new JsonResponse([
  162.                 'success' => false,
  163.                 'message' => 'Offer not found',
  164.             ], Response::HTTP_NOT_FOUND);
  165.         }
  167.         $data = MobileJobOfferDetailsDTO::createFromMobileJobOffer($mobile);
  169.         return new JsonResponse([
  170.             'success' => true,
  171.             'data' => $data,
  172.         ]);
  173.     }
  175.     #[Route('/api/job-offers/interest', name: 'api_job_offers_interest', methods: ['POST'])]
  176.     #[OA\Post(path: '/api/job-offers/interest', description: 'Przyjmuje zgłoszenie zainteresowania ofertą pracy z wybranymi terminami oraz danymi kontaktowymi użytkownika.', summary: 'Zgłoś zainteresowanie ofertą pracy na wybrane terminy', tags: ['Job Offers'])]
  177.     #[OA\Parameter(name: 'X-API-KEY', description: 'Klucz API wymagany do autoryzacji', in: 'header', required: true, schema: new OA\Schema(type: 'string', example: 'your-api-key'))]
  178.     #[OA\RequestBody(
  179.         required: true,
  180.         content: new OA\JsonContent(
  181.             required: ['offerId', 'selectedDateIds', 'phone'],
  182.             properties: [
  183.                 new OA\Property(property: 'offerId', description: 'ID oferty pracy', type: 'integer', example: 7423, nullable: false),
  184.                 new OA\Property(
  185.                     property: 'selectedDateIds',
  186.                     description: 'Tablica ID terminów, którymi użytkownik jest zainteresowany',
  187.                     type: 'array',
  188.                     items: new OA\Items(type: 'integer'),
  189.                     minItems: 1,
  190.                     example: [0, 2],
  191.                 ),
  192.                 new OA\Property(property: 'phone', description: 'Numer telefonu kontaktowego', type: 'string', example: '+48123456789', nullable: false),
  193.                 new OA\Property(property: 'futureContactConsent', description: 'Zgoda na przyszły kontakt', type: 'boolean', example: true, nullable: false),
  194.             ],
  195.             type: 'object',
  196.         ),
  197.     )]
  198.     #[OA\Response(
  199.         response: 200,
  200.         description: 'Potwierdzenie przyjęcia zgłoszenia zainteresowania',
  201.         content: new OA\JsonContent(
  202.             properties: [
  203.                 new OA\Property(property: 'success', type: 'boolean', example: true),
  204.                 new OA\Property(property: 'message', type: 'string', example: 'The submission has been accepted.'),
  205.             ],
  206.             type: 'object',
  207.         ),
  208.     )]
  209.     #[OA\Response(
  210.         response: 404,
  211.         description: 'Błąd walidacji danych wejściowych',
  212.         content: new OA\JsonContent(
  213.             properties: [
  214.                 new OA\Property(property: 'success', type: 'boolean', example: false),
  215.                 new OA\Property(property: 'message', type: 'string', example: 'Selected offer does not exist.'),
  216.             ],
  217.             type: 'object',
  218.         ),
  219.     )]
  220.     public function submitInterest(Request $request): JsonResponse
  221.     {
  222.         if (!$this->validateApiKey($request)) {
  223.             return $this->returnInvalidApiKeyError();
  224.         }
  226.         $data = json_decode($request->getContent(), true);
  228.         $offer = $this->mobileJobOfferSearchService->offerExists($data['offerId']);
  229.         if (!$offer) {
  230.             return new JsonResponse([
  231.                 'success' => false,
  232.                 'message' => 'Selected offer does not exist.',
  233.             ], Response::HTTP_NOT_FOUND);
  234.         }
  236.         if (isset($data['selectedDateIds']) && !$this->mobileJobOfferSearchService->datesExist($data['offerId'], $data['selectedDateIds'])) {
  237.             return new JsonResponse([
  238.                 'success' => false,
  239.                 'message' => 'At least one of the selected dates does not exist.',
  240.             ], Response::HTTP_NOT_FOUND);
  241.         }
  243.         $this->interestSubmissionService->submitInterest($data);
  245.         return new JsonResponse([
  246.             'success' => true,
  247.             'message' => 'The submission has been accepted.',
  248.         ]);
  249.     }
  250. }