688 lines
29 KiB
PHP
688 lines
29 KiB
PHP
<?php
|
|
|
|
namespace App\Repository;
|
|
|
|
use App\Entity\Assignment;
|
|
use App\Entity\Disposition;
|
|
use App\Entity\Teamer;
|
|
use App\Entity\Upload;
|
|
use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
|
|
use Doctrine\ORM\Query;
|
|
use Doctrine\ORM\Query\Expr\Join;
|
|
use Doctrine\ORM\Query\Expr\Orx;
|
|
use Doctrine\ORM\QueryBuilder;
|
|
use Doctrine\Persistence\ManagerRegistry;
|
|
|
|
/**
|
|
* @extends ServiceEntityRepository<Disposition>
|
|
*
|
|
* @method Disposition|null find($id, $lockMode = null, $lockVersion = null)
|
|
* @method Disposition|null findOneBy(array $criteria, array $orderBy = null)
|
|
* @method Disposition[] findAll()
|
|
* @method Disposition[] findBy(array $criteria, array $orderBy = null, $limit = null, $offset = null)
|
|
*/
|
|
class DispositionRepository extends ServiceEntityRepository
|
|
{
|
|
public function __construct(ManagerRegistry $registry)
|
|
{
|
|
parent::__construct($registry, Disposition::class);
|
|
}
|
|
|
|
public function getUpcomingDispositionsByTeamerQuery(Teamer $teamer): Query
|
|
{
|
|
$qb = $this->createQueryBuilder('disposition');
|
|
|
|
return $qb
|
|
->select('disposition', 'assignment', 'job_profile', 'destination')
|
|
->innerJoin('disposition.assignment', 'assignment')
|
|
->innerJoin('assignment.jobProfile', 'job_profile')
|
|
->innerJoin('assignment.destination', 'destination')
|
|
->where($qb->expr()->andX(
|
|
$qb->expr()->eq('disposition.teamer', ':teamer'),
|
|
$qb->expr()->neq('assignment.status', ':assignmentStatus'),
|
|
$qb->expr()->neq('disposition.status', ':dispositionStatus'),
|
|
$qb->expr()->orX(
|
|
$qb->expr()->andX(
|
|
$qb->expr()->isNull('assignment.dateTo'),
|
|
$qb->expr()->gte('destination.dateTo', ':date')
|
|
),
|
|
$qb->expr()->andX(
|
|
$qb->expr()->isNotNull('assignment.dateTo'),
|
|
$qb->expr()->gte('assignment.dateTo', ':date')
|
|
)
|
|
)
|
|
))
|
|
->setParameter('teamer', $teamer)
|
|
->setParameter('assignmentStatus', Assignment::STATUS_CALLED_OFF)
|
|
->setParameter('dispositionStatus', Disposition::STATUS_CALLED_OFF)
|
|
->setParameter('date', new \DateTimeImmutable())
|
|
->getQuery()
|
|
;
|
|
}
|
|
|
|
public function getUpcomingDispositionsByTeamer(Teamer $teamer, int $limit = 5): array
|
|
{
|
|
return $this
|
|
->getUpcomingDispositionsByTeamerQuery($teamer)
|
|
->setMaxResults($limit)
|
|
->getResult()
|
|
;
|
|
}
|
|
|
|
public function getRecentDispositionsByTeamerQuery(Teamer $teamer): Query
|
|
{
|
|
$qb = $this->createQueryBuilder('disposition');
|
|
|
|
return $qb
|
|
->select('disposition', 'assignment', 'job_profile', 'destination', 'feedback')
|
|
->innerJoin('disposition.assignment', 'assignment')
|
|
->innerJoin('assignment.jobProfile', 'job_profile')
|
|
->innerJoin('assignment.destination', 'destination')
|
|
->leftJoin('disposition.feedback', 'feedback')
|
|
->where($qb->expr()->andX(
|
|
$qb->expr()->eq('disposition.teamer', ':teamer'),
|
|
$qb->expr()->neq('assignment.status', ':assignmentStatus'),
|
|
$qb->expr()->neq('disposition.status', ':dispositionStatus'),
|
|
$qb->expr()->orX(
|
|
$qb->expr()->andX(
|
|
$qb->expr()->isNull('assignment.dateTo'),
|
|
$qb->expr()->lte('destination.dateTo', ':date')
|
|
),
|
|
$qb->expr()->andX(
|
|
$qb->expr()->isNotNull('assignment.dateTo'),
|
|
$qb->expr()->lte('assignment.dateTo', ':date')
|
|
)
|
|
)
|
|
))
|
|
->setParameter('teamer', $teamer)
|
|
->setParameter('assignmentStatus', Assignment::STATUS_CALLED_OFF)
|
|
->setParameter('dispositionStatus', Disposition::STATUS_CALLED_OFF)
|
|
->setParameter('date', new \DateTimeImmutable())
|
|
->getQuery()
|
|
;
|
|
}
|
|
|
|
public function findCurrentDispositionsByAssignment(Assignment $assignment): array
|
|
{
|
|
$qb = $this->createQueryBuilder('disposition');
|
|
|
|
return $qb
|
|
->select('disposition', 'teamer', 'user', 'feedback')
|
|
->innerJoin('disposition.teamer', 'teamer')
|
|
->leftJoin('teamer.user', 'user')
|
|
->leftJoin('teamer.feedback', 'feedback')
|
|
->where($qb->expr()->eq('disposition.assignment', ':assignment'))
|
|
->setParameter('assignment', $assignment)
|
|
->getQuery()
|
|
->getResult()
|
|
;
|
|
}
|
|
|
|
public function findRecentDispositionsByTeamer(Teamer $teamer, int $limit = 5): array
|
|
{
|
|
$qb = $this->createQueryBuilder('disposition');
|
|
|
|
return $qb
|
|
->select('disposition', 'assignment', 'destination', 'feedback')
|
|
->innerJoin('disposition.assignment', 'assignment')
|
|
->innerJoin('assignment.destination', 'destination')
|
|
->leftJoin('disposition.feedback', 'feedback')
|
|
->where($qb->expr()->andX(
|
|
$qb->expr()->eq('disposition.teamer', ':teamer'),
|
|
$qb->expr()->neq('assignment.status', ':assignmentStatus'),
|
|
$qb->expr()->neq('disposition.status', ':dispositionStatus')
|
|
))
|
|
->setParameter('teamer', $teamer)
|
|
->setParameter('assignmentStatus', Assignment::STATUS_CALLED_OFF)
|
|
->setParameter('dispositionStatus', Disposition::STATUS_CALLED_OFF)
|
|
->orderBy('destination.dateFrom', 'DESC')
|
|
->setMaxResults($limit)
|
|
->getQuery()
|
|
->getResult()
|
|
;
|
|
}
|
|
|
|
public function findCurrentDispositionsByTeamer(Teamer $teamer): array
|
|
{
|
|
$qb = $this->createQueryBuilder('disposition');
|
|
|
|
return $qb
|
|
->select('disposition', 'assignment', 'destination')
|
|
->innerJoin('disposition.assignment', 'assignment')
|
|
->innerJoin('assignment.destination', 'destination')
|
|
->where($qb->expr()->andX(
|
|
$qb->expr()->eq('disposition.teamer', ':teamer'),
|
|
$qb->expr()->in('disposition.status', ':status')
|
|
))
|
|
->setParameter('teamer', $teamer)
|
|
->setParameter('status', [
|
|
Disposition::STATUS_NEW,
|
|
Disposition::STATUS_CONFIRMED,
|
|
])
|
|
->orderBy('destination.dateFrom', 'ASC')
|
|
->getQuery()
|
|
->getResult()
|
|
;
|
|
}
|
|
|
|
public function findNewDispositionsByHotelCodes(mixed $hotelCode): array
|
|
{
|
|
$hotelCodes = (array) $hotelCode;
|
|
|
|
$qb = $this->createQueryBuilder('disposition');
|
|
|
|
return $qb
|
|
->select('disposition', 'assignment', 'job_profile', 'destination')
|
|
->innerJoin('disposition.assignment', 'assignment')
|
|
->innerJoin('assignment.jobProfile', 'job_profile')
|
|
->innerJoin('assignment.destination', 'destination')
|
|
->where($qb->expr()->andX(
|
|
$qb->expr()->orX(
|
|
$qb->expr()->in($qb->expr()->substring('destination.hotelCode', 1, 3), ':hotelCodes'),
|
|
$qb->expr()->in($qb->expr()->substring('destination.hotelCode', -3, 3), ':hotelCodes'),
|
|
),
|
|
$qb->expr()->gte('destination.dateTo', ':dateTo'),
|
|
$qb->expr()->eq('disposition.status', ':status')
|
|
))
|
|
->orderBy('destination.dateFrom', 'ASC')
|
|
->setParameter('hotelCodes', $hotelCodes)
|
|
->setParameter('dateTo', new \DateTimeImmutable())
|
|
->setParameter('status', Disposition::STATUS_CONFIRMED)
|
|
->getQuery()
|
|
->getResult()
|
|
;
|
|
}
|
|
|
|
public function getDispositionsWithPendingFeedbackQuery(mixed $hotelCode = null, ?int $offsetDays = null): Query
|
|
{
|
|
$hotelCodes = (array) $hotelCode;
|
|
|
|
$qb = $this->createQueryBuilder('disposition');
|
|
|
|
$qb
|
|
->select('disposition', 'assignment', 'job_profile', 'destination', 'feedback', 'teamer', 'user')
|
|
->innerJoin('disposition.assignment', 'assignment')
|
|
->innerJoin('assignment.jobProfile', 'job_profile')
|
|
->innerJoin('disposition.teamer', 'teamer')
|
|
->innerJoin('teamer.user', 'user')
|
|
->innerJoin('assignment.destination', 'destination')
|
|
->leftJoin('disposition.feedback', 'feedback')
|
|
->where($qb->expr()->andX(
|
|
$qb->expr()->notIn('assignment.status', ':status'),
|
|
$qb->expr()->orX(
|
|
$qb->expr()->andX(
|
|
$qb->expr()->isNotNull('assignment.dateTo'),
|
|
$qb->expr()->lte('assignment.dateTo', ':dateTo')
|
|
),
|
|
$qb->expr()->lte('destination.dateTo', ':dateTo')
|
|
),
|
|
$qb->expr()->isNull('feedback')
|
|
))
|
|
->setParameter('status', [Assignment::STATUS_CALLED_OFF, Assignment::STATUS_DELETED])
|
|
;
|
|
|
|
$dateTo = new \DateTimeImmutable();
|
|
if (null !== $offsetDays) {
|
|
$dateTo = $dateTo->modify('-'.$offsetDays.' days');
|
|
}
|
|
$qb->setParameter('dateTo', $dateTo);
|
|
|
|
if (null !== $hotelCode) {
|
|
$qb
|
|
->andWhere($qb->expr()->orX(
|
|
$qb->expr()->in($qb->expr()->substring('destination.hotelCode', 1, 3), ':hotelCodes'),
|
|
$qb->expr()->in($qb->expr()->substring('destination.hotelCode', -3, 3), ':hotelCodes'),
|
|
))
|
|
->setParameter('hotelCodes', $hotelCodes)
|
|
;
|
|
}
|
|
|
|
return $qb->getQuery();
|
|
}
|
|
|
|
public function findDispositionsWithOverdueFeedback(?int $offsetDays = null): array
|
|
{
|
|
return $this
|
|
->getDispositionsWithPendingFeedbackQuery(null, $offsetDays)
|
|
->getResult()
|
|
;
|
|
}
|
|
|
|
public function findDispositionsWithPendingFeedbackByHotelCodes(mixed $hotelCode): array
|
|
{
|
|
return $this
|
|
->getDispositionsWithPendingFeedbackQuery($hotelCode)
|
|
->getResult()
|
|
;
|
|
}
|
|
|
|
/**
|
|
* @return Disposition[]|array
|
|
*/
|
|
public function findEndedDispositions(): array
|
|
{
|
|
$qb = $this->createQueryBuilder('disposition');
|
|
|
|
return $qb
|
|
->innerJoin('disposition.assignment', 'assignment')
|
|
->innerJoin('assignment.destination', 'destination')
|
|
->where($qb->expr()->andX(
|
|
$qb->expr()->in('disposition.status', ':status'),
|
|
$qb->expr()->orX(
|
|
$qb->expr()->andX(
|
|
$qb->expr()->isNotNull('assignment.dateTo'),
|
|
$qb->expr()->lte('assignment.dateTo', ':dateTo')
|
|
),
|
|
$qb->expr()->lte('destination.dateTo', ':dateTo')
|
|
)
|
|
))
|
|
->setParameter('status', [
|
|
Disposition::STATUS_NEW,
|
|
Disposition::STATUS_CHECKING_CONTRACT,
|
|
Disposition::STATUS_CONFIRMED,
|
|
])
|
|
->setParameter('dateTo', new \DateTimeImmutable())
|
|
->getQuery()
|
|
->getResult()
|
|
;
|
|
}
|
|
|
|
public function getNew(int $limit = 5): array
|
|
{
|
|
$qb = $this->createQueryBuilder('disposition');
|
|
|
|
return $qb
|
|
->select('disposition', 'assignment', 'destination', 'job_profile')
|
|
->innerJoin('disposition.assignment', 'assignment')
|
|
->innerJoin('assignment.destination', 'destination')
|
|
->innerJoin('assignment.jobProfile', 'job_profile')
|
|
->where($qb->expr()->gt('destination.dateFrom', ':dateFrom'))
|
|
->orderBy('disposition.createdAt', 'DESC')
|
|
->setParameter('dateFrom', new \DateTimeImmutable())
|
|
->setMaxResults($limit)
|
|
->getQuery()
|
|
->getResult()
|
|
;
|
|
}
|
|
|
|
/**
|
|
* Returns feedback statistics per hotel for dispositions with status 'ended' or 'completed'.
|
|
*
|
|
* @return array<int, array{
|
|
* hotelCode: string,
|
|
* hotel: string,
|
|
* totalDispositions: int,
|
|
* providedFeedbacks: int,
|
|
* missingFeedbacks: int,
|
|
* percentageProvided: float
|
|
* }>
|
|
*/
|
|
public function getFeedbackStatisticsByHotel(
|
|
?\DateTimeImmutable $dateFrom = null,
|
|
?\DateTimeImmutable $dateTo = null,
|
|
): array {
|
|
$qb = $this->createQueryBuilder('disposition');
|
|
|
|
$qb
|
|
->select(
|
|
'destination.hotelCode AS hotelCode',
|
|
'destination.hotel AS hotel',
|
|
'COUNT(disposition.id) AS totalDispositions',
|
|
'SUM(CASE WHEN disposition.feedback IS NOT NULL THEN 1 ELSE 0 END) AS providedFeedbacks'
|
|
)
|
|
->innerJoin('disposition.assignment', 'assignment')
|
|
->innerJoin('assignment.destination', 'destination')
|
|
->leftJoin('disposition.feedback', 'feedback')
|
|
->where($qb->expr()->in('disposition.status', ':statuses'))
|
|
->setParameter('statuses', [
|
|
Disposition::STATUS_ENDED,
|
|
Disposition::STATUS_PAID,
|
|
Disposition::STATUS_COMPLETED,
|
|
])
|
|
->groupBy('destination.hotelCode', 'destination.hotel')
|
|
->orderBy('destination.hotel', 'ASC')
|
|
;
|
|
|
|
// Filter by effective date range (assignment date or fallback to destination date)
|
|
if (null !== $dateFrom) {
|
|
$qb
|
|
->andWhere($qb->expr()->orX(
|
|
$qb->expr()->andX(
|
|
$qb->expr()->isNotNull('assignment.dateFrom'),
|
|
$qb->expr()->gte('assignment.dateFrom', ':dateFrom')
|
|
),
|
|
$qb->expr()->andX(
|
|
$qb->expr()->isNull('assignment.dateFrom'),
|
|
$qb->expr()->gte('destination.dateFrom', ':dateFrom')
|
|
)
|
|
))
|
|
->setParameter('dateFrom', $dateFrom)
|
|
;
|
|
}
|
|
|
|
if (null !== $dateTo) {
|
|
$qb
|
|
->andWhere($qb->expr()->orX(
|
|
$qb->expr()->andX(
|
|
$qb->expr()->isNotNull('assignment.dateTo'),
|
|
$qb->expr()->lte('assignment.dateTo', ':dateTo')
|
|
),
|
|
$qb->expr()->andX(
|
|
$qb->expr()->isNull('assignment.dateTo'),
|
|
$qb->expr()->lte('destination.dateTo', ':dateTo')
|
|
)
|
|
))
|
|
->setParameter('dateTo', $dateTo)
|
|
;
|
|
}
|
|
|
|
$results = $qb->getQuery()->getResult();
|
|
|
|
// Calculate missing feedbacks and percentage
|
|
return array_map(function (array $row): array {
|
|
$total = (int) $row['totalDispositions'];
|
|
$provided = (int) $row['providedFeedbacks'];
|
|
$missing = $total - $provided;
|
|
$percentage = $total > 0 ? round(($provided / $total) * 100, 1) : 0.0;
|
|
|
|
return [
|
|
'hotelCode' => $row['hotelCode'],
|
|
'hotel' => $row['hotel'],
|
|
'totalDispositions' => $total,
|
|
'providedFeedbacks' => $provided,
|
|
'missingFeedbacks' => $missing,
|
|
'percentageProvided' => $percentage,
|
|
];
|
|
}, $results);
|
|
}
|
|
|
|
/**
|
|
* Returns feedback statistics grouped by normalized hotel code (base 3-char code).
|
|
*
|
|
* @return array<int, array{
|
|
* hotelCode: string,
|
|
* totalDispositions: int,
|
|
* providedFeedbacks: int,
|
|
* missingFeedbacks: int,
|
|
* percentageProvided: float
|
|
* }>
|
|
*/
|
|
public function getFeedbackStatisticsByNormalizedHotelCode(
|
|
?\DateTimeImmutable $dateFrom = null,
|
|
?\DateTimeImmutable $dateTo = null,
|
|
): array {
|
|
$qb = $this->createQueryBuilder('disposition');
|
|
|
|
// Normalize hotel code: strip SER prefix to get base 3-char code
|
|
$normalizedHotelCode = "CASE WHEN destination.hotelCode LIKE 'SER%' THEN SUBSTRING(destination.hotelCode, 4, 3) ELSE SUBSTRING(destination.hotelCode, 1, 3) END";
|
|
|
|
$qb
|
|
->select(
|
|
$normalizedHotelCode.' AS hotelCode',
|
|
'COUNT(disposition.id) AS totalDispositions',
|
|
'SUM(CASE WHEN disposition.feedback IS NOT NULL THEN 1 ELSE 0 END) AS providedFeedbacks'
|
|
)
|
|
->innerJoin('disposition.assignment', 'assignment')
|
|
->innerJoin('assignment.destination', 'destination')
|
|
->leftJoin('disposition.feedback', 'feedback')
|
|
->where($qb->expr()->in('disposition.status', ':statuses'))
|
|
->setParameter('statuses', [
|
|
Disposition::STATUS_ENDED,
|
|
Disposition::STATUS_PAID,
|
|
Disposition::STATUS_COMPLETED,
|
|
])
|
|
->groupBy('hotelCode')
|
|
->orderBy('hotelCode', 'ASC')
|
|
;
|
|
|
|
if (null !== $dateFrom) {
|
|
$qb
|
|
->andWhere($qb->expr()->orX(
|
|
$qb->expr()->andX(
|
|
$qb->expr()->isNotNull('assignment.dateFrom'),
|
|
$qb->expr()->gte('assignment.dateFrom', ':dateFrom')
|
|
),
|
|
$qb->expr()->andX(
|
|
$qb->expr()->isNull('assignment.dateFrom'),
|
|
$qb->expr()->gte('destination.dateFrom', ':dateFrom')
|
|
)
|
|
))
|
|
->setParameter('dateFrom', $dateFrom)
|
|
;
|
|
}
|
|
|
|
if (null !== $dateTo) {
|
|
$qb
|
|
->andWhere($qb->expr()->orX(
|
|
$qb->expr()->andX(
|
|
$qb->expr()->isNotNull('assignment.dateTo'),
|
|
$qb->expr()->lte('assignment.dateTo', ':dateTo')
|
|
),
|
|
$qb->expr()->andX(
|
|
$qb->expr()->isNull('assignment.dateTo'),
|
|
$qb->expr()->lte('destination.dateTo', ':dateTo')
|
|
)
|
|
))
|
|
->setParameter('dateTo', $dateTo)
|
|
;
|
|
}
|
|
|
|
$results = $qb->getQuery()->getResult();
|
|
|
|
return array_map(function (array $row): array {
|
|
$total = (int) $row['totalDispositions'];
|
|
$provided = (int) $row['providedFeedbacks'];
|
|
$missing = $total - $provided;
|
|
$percentage = $total > 0 ? round(($provided / $total) * 100, 1) : 0.0;
|
|
|
|
return [
|
|
'hotelCode' => $row['hotelCode'],
|
|
'totalDispositions' => $total,
|
|
'providedFeedbacks' => $provided,
|
|
'missingFeedbacks' => $missing,
|
|
'percentageProvided' => $percentage,
|
|
];
|
|
}, $results);
|
|
}
|
|
|
|
/**
|
|
* Dispositions to remind about a missing contract, on the day the upload period runs out.
|
|
*
|
|
* Anchored on the creation of the disposition, which is what the upload period counts
|
|
* from. The range is a half-open day rather than an equality: disposition.createdAt is a
|
|
* timestamp, and the cron runs at 01:00, so "=" would only ever match a disposition that
|
|
* happened to be created at that exact second.
|
|
*
|
|
* @param int $deadlineDays %contract_upload_deadline_days%
|
|
*/
|
|
public function findDispositionsForContractReminder(int $deadlineDays): array
|
|
{
|
|
return $this->getContractReminderQuery($deadlineDays)->getResult();
|
|
}
|
|
|
|
public function getContractReminderQuery(int $deadlineDays): Query
|
|
{
|
|
$today = new \DateTimeImmutable('today');
|
|
$dayStart = $today->modify(sprintf('-%d days', $deadlineDays));
|
|
$tomorrow = $today->modify('+1 day');
|
|
|
|
$qb = $this->createQueryBuilder('disposition');
|
|
|
|
// A short-notice assignment can end before the normal $deadlineDays window would even
|
|
// start (DispositionWorkflowGuardSubscriber::guardUploadContract blocks uploads from
|
|
// assignment.end - 1 day on). For those, remind on the block day instead of the normal
|
|
// day, which would otherwise fall on or after the block and describe an upload that is
|
|
// already refused. isContractDue() caps the same way.
|
|
$normalDay = $qb->expr()->andX(
|
|
$qb->expr()->gte('disposition.createdAt', ':dayStart'),
|
|
$qb->expr()->lt('disposition.createdAt', ':dayEnd'),
|
|
$this->effectiveDateToGreaterThan($qb, ':tomorrow'),
|
|
);
|
|
$shortNoticeDay = $qb->expr()->andX(
|
|
$this->effectiveDateToEquals($qb, ':tomorrow'),
|
|
$qb->expr()->gte('disposition.createdAt', ':dayStart'),
|
|
);
|
|
|
|
return $qb
|
|
->select('disposition', 'assignment', 'destination', 'teamer')
|
|
->innerJoin('disposition.assignment', 'assignment')
|
|
->innerJoin('assignment.destination', 'destination')
|
|
// restricted to the contract, so an unrelated upload does not suppress the reminder
|
|
->leftJoin('disposition.documents', 'document', Join::WITH, 'document.type = :documentType')
|
|
->innerJoin('disposition.teamer', 'teamer')
|
|
->where($qb->expr()->andX(
|
|
$qb->expr()->isNull('document'),
|
|
// deleted teamers are excluded here rather than when sending, so that the
|
|
// count the caller reports stays truthful
|
|
$qb->expr()->isNull('teamer.deletedAt'),
|
|
$qb->expr()->eq('disposition.status', ':dispositionStatus'),
|
|
$qb->expr()->notIn('assignment.status', ':assignmentStatus'),
|
|
$qb->expr()->orX($normalDay, $shortNoticeDay),
|
|
))
|
|
->setParameter('documentType', Upload::TYPE_CONTRACT)
|
|
->setParameter('dispositionStatus', Disposition::STATUS_NEW)
|
|
->setParameter('assignmentStatus', [Assignment::STATUS_CALLED_OFF, Assignment::STATUS_DELETED])
|
|
->setParameter('dayStart', $dayStart)
|
|
->setParameter('dayEnd', $dayStart->modify('+1 day'))
|
|
// bound as date strings, not DateTimeImmutable: both columns are DATE, and
|
|
// Doctrine would otherwise bind 'Y-m-d H:i:s', which a DATE never equals
|
|
->setParameter('tomorrow', $tomorrow->format('Y-m-d'))
|
|
->getQuery()
|
|
;
|
|
}
|
|
|
|
/**
|
|
* Dispositions to remind about a missing invoice, for assignments ending on one given day.
|
|
*
|
|
* Both sends - the day after the assignment ends and again on the last day of the upload
|
|
* period - come through here with a different $endDate, which is what keeps each of them
|
|
* a one-shot without needing a record of what has already been sent.
|
|
*
|
|
* Anchored on the end date rather than Disposition::STATUS_ENDED on purpose: there is no
|
|
* column recording when a disposition ended, and DispositionStatusService runs after the
|
|
* reminders in CronCommand, so a status-based rule would always be one run late.
|
|
*/
|
|
public function findDispositionsForInvoiceReminder(\DateTimeImmutable $endDate): array
|
|
{
|
|
return $this->getInvoiceReminderQuery($endDate)->getResult();
|
|
}
|
|
|
|
public function getInvoiceReminderQuery(\DateTimeImmutable $endDate): Query
|
|
{
|
|
$qb = $this->createQueryBuilder('disposition');
|
|
|
|
return $qb
|
|
->select('disposition', 'assignment', 'destination', 'teamer')
|
|
->innerJoin('disposition.assignment', 'assignment')
|
|
->innerJoin('assignment.destination', 'destination')
|
|
->leftJoin('disposition.documents', 'document', Join::WITH, 'document.type = :documentType')
|
|
->innerJoin('disposition.teamer', 'teamer')
|
|
->where($qb->expr()->andX(
|
|
$qb->expr()->isNull('document'),
|
|
$qb->expr()->isNull('teamer.deletedAt'),
|
|
$qb->expr()->notIn('disposition.status', ':dispositionStatus'),
|
|
$qb->expr()->notIn('assignment.status', ':assignmentStatus'),
|
|
$this->effectiveDateToEquals($qb, ':endDate'),
|
|
))
|
|
->setParameter('documentType', Upload::TYPE_INVOICE)
|
|
->setParameter('dispositionStatus', [Disposition::STATUS_CALLED_OFF, Disposition::STATUS_COMPLETED])
|
|
->setParameter('assignmentStatus', [Assignment::STATUS_CALLED_OFF, Assignment::STATUS_DELETED])
|
|
// bound as a date string, not as a DateTimeImmutable: both columns are DATE, and
|
|
// Doctrine would otherwise bind 'Y-m-d H:i:s', which a DATE never equals
|
|
->setParameter('endDate', $endDate->format('Y-m-d'))
|
|
->getQuery()
|
|
;
|
|
}
|
|
|
|
/**
|
|
* Compares the assignment's end date against $parameter, falling back to the destination's
|
|
* when the assignment does not override it.
|
|
*
|
|
* The fallback is guarded on both sides - without the isNull() on the second branch an
|
|
* assignment that moves the end date into the future would still match on the
|
|
* destination's date. Kept in one place because the per-assignment date override is due to
|
|
* be removed (docs/remove-assignment-date-override.md), and this then collapses to a plain
|
|
* comparison on destination.dateTo.
|
|
*/
|
|
private function effectiveDateToEquals(QueryBuilder $qb, string $parameter): Orx
|
|
{
|
|
return $qb->expr()->orX(
|
|
$qb->expr()->andX(
|
|
$qb->expr()->isNotNull('assignment.dateTo'),
|
|
$qb->expr()->eq('assignment.dateTo', $parameter)
|
|
),
|
|
$qb->expr()->andX(
|
|
$qb->expr()->isNull('assignment.dateTo'),
|
|
$qb->expr()->eq('destination.dateTo', $parameter)
|
|
),
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Same fallback as effectiveDateToEquals(), but for "later than $parameter".
|
|
*/
|
|
private function effectiveDateToGreaterThan(QueryBuilder $qb, string $parameter): Orx
|
|
{
|
|
return $qb->expr()->orX(
|
|
$qb->expr()->andX(
|
|
$qb->expr()->isNotNull('assignment.dateTo'),
|
|
$qb->expr()->gt('assignment.dateTo', $parameter)
|
|
),
|
|
$qb->expr()->andX(
|
|
$qb->expr()->isNull('assignment.dateTo'),
|
|
$qb->expr()->gt('destination.dateTo', $parameter)
|
|
),
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Dispositions whose contract upload period has run out, for the admin dashboard.
|
|
*
|
|
* @param int $deadlineDays %contract_upload_deadline_days%, so this list marks a
|
|
* disposition overdue on the same day the reminder mail goes out
|
|
*/
|
|
public function findOverdueContracts(int $deadlineDays): array
|
|
{
|
|
return $this->getOverdueContractsQuery($deadlineDays)->getResult();
|
|
}
|
|
|
|
public function getOverdueContractsQuery(int $deadlineDays): Query
|
|
{
|
|
// anchored on midnight, like getContractReminderQuery()'s dayStart/dayEnd: a
|
|
// now()-relative anchor would disagree with the reminder query for part of each day.
|
|
// +1 day so a disposition is included from the same calendar day its reminder mail
|
|
// goes out, matching that query's dayStart (== reminderDay), not the day after it.
|
|
$reminderDay = (new \DateTimeImmutable('today'))->modify(sprintf('-%d days', $deadlineDays));
|
|
$dueDate = $reminderDay->modify('+1 day');
|
|
|
|
$qb = $this->createQueryBuilder('disposition');
|
|
|
|
return $qb
|
|
->select('disposition', 'assignment', 'job_profile', 'destination', 'document', 'teamer', 'user')
|
|
->innerJoin('disposition.assignment', 'assignment')
|
|
->innerJoin('assignment.jobProfile', 'job_profile')
|
|
->innerJoin('assignment.destination', 'destination')
|
|
// the join is restricted to the contract, so that an unrelated upload - a
|
|
// driver's licence, say - does not hide a disposition from this list
|
|
->leftJoin('disposition.documents', 'document', Join::WITH, 'document.type = :documentType')
|
|
->innerJoin('disposition.teamer', 'teamer')
|
|
->innerJoin('teamer.user', 'user')
|
|
->where($qb->expr()->andX(
|
|
$qb->expr()->lt('disposition.createdAt', ':dueDate'),
|
|
$qb->expr()->eq('disposition.status', ':status'),
|
|
$qb->expr()->isNull('document'),
|
|
// kept in sync with getContractReminderQuery(), so the dashboard and the
|
|
// reminder mail agree on which dispositions are overdue
|
|
$qb->expr()->isNull('teamer.deletedAt'),
|
|
$qb->expr()->notIn('assignment.status', ':assignmentStatus'),
|
|
))
|
|
->setParameter('documentType', Upload::TYPE_CONTRACT)
|
|
->setParameter('dueDate', $dueDate)
|
|
->setParameter('status', Disposition::STATUS_NEW)
|
|
->setParameter('assignmentStatus', [Assignment::STATUS_CALLED_OFF, Assignment::STATUS_DELETED])
|
|
->orderBy('disposition.createdAt', 'ASC')
|
|
->getQuery()
|
|
;
|
|
}
|
|
}
|