melabidi/alrahma_sunday_school_api
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Fix Pint formatting

Browse Source
This commit is contained in:
root
2026-06-09 01:25:14 -04:00
parent 6be4875c5e
commit 20a0b6c4e5
1485 changed files with 11318 additions and 10273 deletions
Download Patch File Download Diff File Expand all files Collapse all files
app/Services/Parents/AuthorizedUsersManagementService.php
+2 -1
View File
@@ -2,6 +2,7 @@
namespace App\Services\Parents;
use App\Controllers\View\AuthorizedUsersController;
use App\Models\AuthorizedUser;
use App\Models\User;
use App\Services\ApplicationUrlService;
@@ -9,7 +10,7 @@ use App\Services\Email\EmailDispatchService;
use Illuminate\Support\Facades\DB;
/**
* legacy {@see \App\Controllers\View\AuthorizedUsersController} parity.
* legacy {@see AuthorizedUsersController} parity.
*/
class AuthorizedUsersManagementService
{
app/Services/Parents/ParentAttendanceReportCalendarService.php
+7 -7
View File
@@ -6,9 +6,7 @@ use Illuminate\Support\Facades\DB;
class ParentAttendanceReportCalendarService
{
public function __construct(private ParentConfigService $configService)
{
}
public function __construct(private ParentConfigService $configService) {}
/**
* @return array{0: array<int, array{value:string,label:string}>, 1: string}
@@ -33,7 +31,7 @@ class ParentAttendanceReportCalendarService
$dates = [];
for ($i = $weeksBefore; $i >= 1; $i--) {
$dates[] = $thisSunday->copy()->modify('-' . $i . ' week');
$dates[] = $thisSunday->copy()->modify('-'.$i.' week');
}
$cursor = $thisSunday->copy();
@@ -72,13 +70,13 @@ class ParentAttendanceReportCalendarService
$filtered = [];
foreach ($dates as $d) {
$ymd = $d->format('Y-m-d');
if (!isset($noSchool[$ymd]) && $d >= $today && $d <= $cap) {
if (! isset($noSchool[$ymd]) && $d >= $today && $d <= $cap) {
$filtered[] = $d;
}
}
$defaultYmd = $default->format('Y-m-d');
if (!empty($filtered)) {
if (! empty($filtered)) {
$defaultYmd = $filtered[0]->format('Y-m-d');
}
@@ -101,8 +99,10 @@ class ParentAttendanceReportCalendarService
}
if (preg_match('/^(\\d{1,2}):(\\d{2})$/', $raw, $m)) {
$hh = str_pad((string) ((int) $m[1]), 2, '0', STR_PAD_LEFT);
return $hh . ':' . $m[2];
return $hh.':'.$m[2];
}
return $default;
}
app/Services/Parents/ParentAttendanceReportService.php
+34 -31
View File
@@ -2,12 +2,14 @@
namespace App\Services\Parents;
use App\Controllers\View\ParentAttendanceReportController;
use App\Http\Controllers\Api\Reports\FilesController;
use App\Models\AttendanceData;
use App\Models\AttendanceRecord;
use App\Models\ClassSection;
use App\Models\EarlyDismissalSignature;
use App\Models\ParentAttendanceReport;
use App\Models\Student;
use App\Models\ClassSection;
use App\Services\SemesterRangeService;
use Illuminate\Http\UploadedFile;
use Illuminate\Support\Facades\DB;
@@ -18,8 +20,7 @@ class ParentAttendanceReportService
private ParentConfigService $configService,
private ParentAttendanceReportCalendarService $calendarService,
private SemesterRangeService $semesterRangeService
) {
}
) {}
public function formData(int $parentId): array
{
@@ -90,7 +91,7 @@ class ParentAttendanceReportService
}
$type = (string) ($payload['type'] ?? '');
if (!in_array($type, ['absent', 'late', 'early_dismissal'], true)) {
if (! in_array($type, ['absent', 'late', 'early_dismissal'], true)) {
throw new \RuntimeException('Invalid report type.');
}
@@ -104,8 +105,8 @@ class ParentAttendanceReportService
foreach ($rawDates as $entry) {
$dt = \DateTime::createFromFormat('Y-m-d', $entry);
if (!$dt) {
throw new \RuntimeException('Invalid date selected: ' . $entry);
if (! $dt) {
throw new \RuntimeException('Invalid date selected: '.$entry);
}
if ((int) $dt->format('w') !== 0) {
throw new \RuntimeException('Please select Sunday dates only.');
@@ -119,10 +120,10 @@ class ParentAttendanceReportService
$validDates[$entry] = $dt;
}
if ($type === 'late' && (!is_string($arrivalTime) || $arrivalTime === '')) {
if ($type === 'late' && (! is_string($arrivalTime) || $arrivalTime === '')) {
throw new \RuntimeException('Please provide an expected arrival time for late reporting.');
}
if ($type === 'early_dismissal' && (!is_string($dismissTime) || $dismissTime === '')) {
if ($type === 'early_dismissal' && (! is_string($dismissTime) || $dismissTime === '')) {
throw new \RuntimeException('Please provide a dismissal time for early dismissal.');
}
if ($type !== 'early_dismissal') {
@@ -147,7 +148,7 @@ class ParentAttendanceReportService
->first();
$classSectionId = $sectionRow->class_section_id ?? null;
$student = Student::query()->select('firstname', 'lastname')->find($sid);
$studentName = $student ? trim($student->firstname . ' ' . $student->lastname) : ('Student #' . $sid);
$studentName = $student ? trim($student->firstname.' '.$student->lastname) : ('Student #'.$sid);
$classLabel = $this->resolveClassSectionLabel($classSectionId);
foreach ($validDates as $reportDate => $_dt) {
@@ -163,7 +164,7 @@ class ParentAttendanceReportService
->whereIn('type', ['absent', 'late'])
->first();
if ($existingAL) {
$blocked[] = $studentName . ' (' . $reportDate . ')';
$blocked[] = $studentName.' ('.$reportDate.')';
} else {
$existingED = (clone $qb)->where('type', 'early_dismissal')->first();
if ($existingED) {
@@ -195,7 +196,7 @@ class ParentAttendanceReportService
->whereIn('type', ['absent', 'late', 'early_dismissal'])
->first();
if ($existingAny) {
$blocked[] = $studentName . ' (' . $reportDate . ')';
$blocked[] = $studentName.' ('.$reportDate.')';
} else {
ParentAttendanceReport::query()->create([
'parent_id' => $parentId,
@@ -242,8 +243,8 @@ class ParentAttendanceReportService
}
if ($inserted <= 0) {
$err = !empty($blocked)
? ('Already submitted and cannot be changed for: ' . implode(', ', array_slice($blocked, 0, 5)) . (count($blocked) > 5 ? '…' : ''))
$err = ! empty($blocked)
? ('Already submitted and cannot be changed for: '.implode(', ', array_slice($blocked, 0, 5)).(count($blocked) > 5 ? '…' : ''))
: 'Could not save your report. Please try again.';
throw new \RuntimeException($err);
}
@@ -278,7 +279,7 @@ class ParentAttendanceReportService
})));
$type = (string) ($payload['type'] ?? '');
if (empty($dateValues) || !in_array($type, ['absent', 'late', 'early_dismissal'], true)) {
if (empty($dateValues) || ! in_array($type, ['absent', 'late', 'early_dismissal'], true)) {
throw new \RuntimeException('Invalid date or type.');
}
@@ -312,7 +313,7 @@ class ParentAttendanceReportService
if ($sid <= 0) {
continue;
}
if (!isset($map[$sid])) {
if (! isset($map[$sid])) {
$map[$sid] = [
'student_id' => $sid,
'firstname' => (string) ($row['firstname'] ?? ''),
@@ -326,7 +327,7 @@ class ParentAttendanceReportService
}
$map[$sid]['dates'][$dVal] = $map[$sid]['dates'][$dVal] ?? [];
$t = (string) ($row['type'] ?? '');
if ($t !== '' && !in_array($t, $map[$sid]['dates'][$dVal], true)) {
if ($t !== '' && ! in_array($t, $map[$sid]['dates'][$dVal], true)) {
$map[$sid]['dates'][$dVal][] = $t;
}
}
@@ -337,7 +338,7 @@ class ParentAttendanceReportService
public function updateReport(int $parentId, int $reportId, array $payload): void
{
$row = ParentAttendanceReport::query()->find($reportId);
if (!$row || (int) $row->parent_id !== $parentId) {
if (! $row || (int) $row->parent_id !== $parentId) {
throw new \RuntimeException('Report not found.');
}
@@ -347,7 +348,7 @@ class ParentAttendanceReportService
$tzName = (string) (config('School')->attendance['timezone'] ?? 'UTC');
$tz = new \DateTimeZone($tzName ?: 'UTC');
$cutoff = new \DateTime($row->report_date . ' 09:00:00', $tz);
$cutoff = new \DateTime($row->report_date.' 09:00:00', $tz);
$now = new \DateTime('now', $tz);
if ($now >= $cutoff) {
throw new \RuntimeException('Editing window closed at 9:00 AM on the report date.');
@@ -363,13 +364,13 @@ class ParentAttendanceReportService
];
if ($type === 'late' && $arrival !== '') {
if (!preg_match('/^\\d{2}:\\d{2}(:\\d{2})?$/', $arrival)) {
if (! preg_match('/^\\d{2}:\\d{2}(:\\d{2})?$/', $arrival)) {
throw new \RuntimeException('Invalid arrival time format.');
}
$update['arrival_time'] = $arrival;
}
if ($type === 'early_dismissal' && $dismiss !== '') {
if (!preg_match('/^\\d{2}:\\d{2}(:\\d{2})?$/', $dismiss)) {
if (! preg_match('/^\\d{2}:\\d{2}(:\\d{2})?$/', $dismiss)) {
throw new \RuntimeException('Invalid dismissal time format.');
}
$update['dismiss_time'] = $dismiss;
@@ -385,7 +386,7 @@ class ParentAttendanceReportService
/**
* Staff index: early dismissal rows grouped by date (+ signature metadata per date).
*
* Parity with legacy {@see \App\Controllers\View\ParentAttendanceReportController::earlyDismissals}.
* Parity with legacy {@see ParentAttendanceReportController::earlyDismissals}.
*
* @return array{groups: array<string, array<int, array<string, mixed>>>, school_year: string, semester: string, signature_by_date: array<string, array<string, mixed>>}
*/
@@ -467,7 +468,7 @@ class ParentAttendanceReportService
}
/**
* Parity with legacy {@see \App\Controllers\View\ParentAttendanceReportController::addEarlyDismissalForm}.
* Parity with legacy {@see ParentAttendanceReportController::addEarlyDismissalForm}.
*
* @return array{students: array<int, array<string, mixed>>, default_date: string, school_year: string, semester: string}
*/
@@ -505,7 +506,7 @@ class ParentAttendanceReportService
}
/**
* Parity with legacy {@see \App\Controllers\View\ParentAttendanceReportController::saveEarlyDismissal}.
* Parity with legacy {@see ParentAttendanceReportController::saveEarlyDismissal}.
*/
public function saveStaffEarlyDismissal(int $studentId, string $reportDate, string $dismissTime, string $reason): void
{
@@ -573,8 +574,8 @@ class ParentAttendanceReportService
}
/**
* Parity with legacy {@see \App\Controllers\View\ParentAttendanceReportController::uploadEarlyDismissalSignature}.
* Files live under {@see storage_path('uploads/early_dismissal_signatures')} (same as {@see \App\Http\Controllers\Api\Reports\FilesController::earlyDismissalSignature}).
* Parity with legacy {@see ParentAttendanceReportController::uploadEarlyDismissalSignature}.
* Files live under {@see storage_path('uploads/early_dismissal_signatures')} (same as {@see FilesController::earlyDismissalSignature}).
*/
public function storeEarlyDismissalSignature(
UploadedFile $file,
@@ -644,7 +645,7 @@ class ParentAttendanceReportService
$oldFile = (string) ($existing->filename ?? '');
$existing->update($payload);
if ($oldFile !== '' && $oldFile !== $filename) {
@unlink($targetDir . DIRECTORY_SEPARATOR . $oldFile);
@unlink($targetDir.DIRECTORY_SEPARATOR.$oldFile);
}
} else {
EarlyDismissalSignature::query()->create($payload);
@@ -680,7 +681,7 @@ class ParentAttendanceReportService
return;
}
if (!$classSectionId) {
if (! $classSectionId) {
$row = DB::table('student_class')
->select('class_section_id')
->where('student_id', $studentId)
@@ -703,19 +704,19 @@ class ParentAttendanceReportService
$reasonParts = ['Parent-reported'];
if ($type === 'late' && $arrivalTime) {
$reasonParts[] = 'ETA ' . substr($arrivalTime, 0, 5);
$reasonParts[] = 'ETA '.substr($arrivalTime, 0, 5);
}
if (!empty($reason)) {
if (! empty($reason)) {
$reasonParts[] = trim($reason);
}
$reasonText = implode(' — ', $reasonParts);
if (!$existing) {
if (! $existing) {
$classId = ClassSection::query()
->where('class_section_id', $classSectionId)
->value('class_id');
$schoolId = Student::query()->whereKey($studentId)->value('school_id');
if (!$classId || !$schoolId) {
if (! $classId || ! $schoolId) {
return;
}
AttendanceData::query()->create([
@@ -730,6 +731,7 @@ class ParentAttendanceReportService
'school_year' => $schoolYear,
]);
$this->bumpAttendanceRecord($studentId, $classSectionId, $schoolId, $status, $semester, $schoolYear);
return;
}
@@ -771,6 +773,7 @@ class ParentAttendanceReportService
$updates['total_late']++;
}
$record->update($updates);
return;
}
app/Services/Parents/ParentAttendanceService.php
+1 -3
View File
@@ -6,9 +6,7 @@ use Illuminate\Support\Facades\DB;
class ParentAttendanceService
{
public function __construct(private ParentConfigService $configService)
{
}
public function __construct(private ParentConfigService $configService) {}
public function listAttendance(int $parentId, ?string $schoolYear = null): array
{
app/Services/Parents/ParentEmergencyContactService.php
+1 -2
View File
@@ -10,8 +10,7 @@ class ParentEmergencyContactService
public function __construct(
private ParentConfigService $configService,
private PhoneFormatterService $phoneFormatter
) {
}
) {}
public function list(int $parentId): array
{
app/Services/Parents/ParentEnrollmentService.php
+6 -8
View File
@@ -10,9 +10,7 @@ use Illuminate\Support\Facades\DB;
class ParentEnrollmentService
{
public function __construct(private ParentConfigService $configService)
{
}
public function __construct(private ParentConfigService $configService) {}
public function overview(int $parentId, ?string $schoolYear = null): array
{
@@ -26,11 +24,11 @@ class ParentEnrollmentService
->get()
->map(function ($student) use ($selectedYear) {
$classSections = StudentClass::getClassSectionsByStudentId($student->id, $selectedYear, true);
$student->class_section = !empty($classSections)
$student->class_section = ! empty($classSections)
? implode(', ', $classSections)
: 'Class not Assigned';
$isArabicClass = !empty($classSections) && array_reduce(
$isArabicClass = ! empty($classSections) && array_reduce(
$classSections,
static fn ($carry, $name) => $carry || (is_string($name) && stripos($name, 'arabic') === 0),
false
@@ -181,7 +179,7 @@ class ParentEnrollmentService
->where('is_withdrawn', 0)
->first();
if (!$enrollment) {
if (! $enrollment) {
continue;
}
@@ -206,7 +204,7 @@ class ParentEnrollmentService
if ($refund) {
$refund->update([
'reason' => 'Withdrawal under review for student ID ' . $studentId,
'reason' => 'Withdrawal under review for student ID '.$studentId,
'note' => null,
'updated_by' => $parentId,
]);
@@ -217,7 +215,7 @@ class ParentEnrollmentService
'requested_at' => now(),
'school_year' => $schoolYear,
'status' => Refund::STATUS_PENDING,
'reason' => 'Withdrawal under review for student ID ' . $studentId,
'reason' => 'Withdrawal under review for student ID '.$studentId,
'request' => 'new',
'semester' => $semester,
'refund_paid_amount' => 0.0,
app/Services/Parents/ParentEventParticipationService.php
+4 -4
View File
@@ -2,9 +2,9 @@
namespace App\Services\Parents;
use App\Models\Enrollment;
use App\Models\Event;
use App\Models\EventCharges;
use App\Models\Enrollment;
use App\Models\Student;
use App\Services\Invoices\InvoiceGenerationService;
@@ -13,8 +13,7 @@ class ParentEventParticipationService
public function __construct(
private ParentConfigService $configService,
private InvoiceGenerationService $invoiceGeneration
) {
}
) {}
public function overview(int $parentId): array
{
@@ -27,7 +26,7 @@ class ParentEventParticipationService
$charges = [];
foreach ($chargesList as $charge) {
$key = $charge['student_id'] . ':' . $charge['event_id'];
$key = $charge['student_id'].':'.$charge['event_id'];
$charges[$key] = [
'participation' => $charge['participation'],
'date' => $charge['updated_at'] ?? $charge['created_at'],
@@ -107,6 +106,7 @@ class ParentEventParticipationService
if ($existing) {
$existing->delete();
}
continue;
}
app/Services/Parents/ParentProfileService.php
+1
View File
@@ -9,6 +9,7 @@ class ParentProfileService
public function getProfile(int $parentId): ?array
{
$user = User::query()->find($parentId);
return $user ? $user->toArray() : null;
}
app/Services/Parents/ParentProgressQueryService.php
+7 -4
View File
@@ -2,13 +2,16 @@
namespace App\Services\Parents;
use App\Controllers\ParentProgressController;
use App\Http\Resources\ClassProgress\ClassProgressReportResource;
use App\Models\ClassProgressReport;
use App\Services\ClassProgress\ClassProgressQueryService;
use Carbon\CarbonInterface;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\DB;
/**
* legacy {@see \App\Controllers\ParentProgressController} read-side logic.
* legacy {@see ParentProgressController} read-side logic.
*/
class ParentProgressQueryService
{
@@ -133,7 +136,7 @@ class ParentProgressQueryService
$statusLabel = $statusOptions[$row->status] ?? 'Unknown';
$row->setAttribute('status_label', $statusLabel);
$weekStart = $row->week_start instanceof \Carbon\CarbonInterface
$weekStart = $row->week_start instanceof CarbonInterface
? $row->week_start->format('Y-m-d')
: (string) $row->week_start;
$sectionId = (int) $row->class_section_id;
@@ -145,7 +148,7 @@ class ParentProgressQueryService
if (! isset($reportGroups[$key])) {
$reportGroups[$key] = [
'week_start' => $weekStart,
'week_end' => $row->week_end instanceof \Carbon\CarbonInterface
'week_end' => $row->week_end instanceof CarbonInterface
? $row->week_end->format('Y-m-d')
: (string) ($row->week_end ?? ''),
'class_section_name' => $row->class_section_name ?? '',
@@ -159,7 +162,7 @@ class ParentProgressQueryService
continue;
}
$reportGroups[$key]['reports'][$subject] = (new \App\Http\Resources\ClassProgress\ClassProgressReportResource($row))->toArray(request());
$reportGroups[$key]['reports'][$subject] = (new ClassProgressReportResource($row))->toArray(request());
}
return $reportGroups;
app/Services/Parents/ParentRegistrationService.php
+6 -4
View File
@@ -15,8 +15,7 @@ class ParentRegistrationService
public function __construct(
private ParentConfigService $configService,
private SchoolIdService $schoolIdService
) {
}
) {}
public function overview(int $parentId): array
{
@@ -39,6 +38,7 @@ class ParentRegistrationService
$kids = $kids->map(function ($kid) use ($allergies, $conditions) {
$kid->allergies = ($allergies[$kid->id] ?? collect())->pluck('allergy')->all();
$kid->medical_conditions = ($conditions[$kid->id] ?? collect())->pluck('condition_name')->all();
return $kid->toArray();
})->all();
@@ -105,6 +105,7 @@ class ParentRegistrationService
'dob' => $student['dob'],
'reason' => 'already_registered',
];
continue;
}
@@ -115,7 +116,7 @@ class ParentRegistrationService
'age' => $this->calculateAge($student['dob'], $ageReference),
'gender' => $student['gender'],
'registration_grade' => $student['registration_grade'] ?? null,
'photo_consent' => !empty($student['photo_consent']) ? 1 : 0,
'photo_consent' => ! empty($student['photo_consent']) ? 1 : 0,
'parent_id' => $parentId,
'year_of_registration' => (string) date('Y'),
'school_year' => $schoolYear,
@@ -186,7 +187,7 @@ class ParentRegistrationService
'age' => $this->calculateAge($payload['dob'], $ageReference),
'gender' => $payload['gender'],
'registration_grade' => $payload['registration_grade'] ?? null,
'photo_consent' => !empty($payload['photo_consent']) ? 1 : 0,
'photo_consent' => ! empty($payload['photo_consent']) ? 1 : 0,
]);
StudentMedicalCondition::query()->where('student_id', $studentId)->delete();
@@ -234,6 +235,7 @@ class ParentRegistrationService
try {
$dobObj = new \DateTimeImmutable($dob);
$refObj = new \DateTimeImmutable($referenceDate);
return (int) $dobObj->diff($refObj)->y;
} catch (\Throwable $e) {
return 0;
app/Services/Parents/ParentReportCardService.php
+5 -4
View File
@@ -2,14 +2,15 @@
namespace App\Services\Parents;
use App\Controllers\ParentReportCardController;
use App\Models\Configuration;
use App\Services\ApplicationUrlService;
use App\Models\ReportCardAcknowledgement;
use App\Models\User;
use App\Services\ApplicationUrlService;
use Illuminate\Support\Facades\DB;
/**
* legacy {@see \App\Controllers\ParentReportCardController} parity (read + acknowledgement).
* legacy {@see ParentReportCardController} parity (read + acknowledgement).
*/
class ParentReportCardService
{
@@ -85,7 +86,7 @@ class ParentReportCardService
}
/**
* @param list<int> $studentIds
* @param list<int> $studentIds
* @return array<int, array<string, mixed>>
*/
public function acknowledgementMap(int $primaryParentUserId, array $studentIds, string $schoolYear, string $semester): array
@@ -117,7 +118,7 @@ class ParentReportCardService
}
/**
* @param array<string, mixed> $values viewed_at, signed_at, signed_name, signer_ip, …
* @param array<string, mixed> $values viewed_at, signed_at, signed_name, signer_ip, …
*/
public function touchAcknowledgement(
int $primaryParentUserId,
app/Services/Parents/PrimaryParentUserResolver.php
+5 -3
View File
@@ -2,13 +2,15 @@
namespace App\Services\Parents;
use App\Controllers\ParentReportCardController;
use App\Models\Student;
use App\Models\User;
use Illuminate\Support\Facades\DB;
/**
* Maps the logged-in parent-family account to the primary parent's user id
* (stored on {@see \App\Models\Student::$parent_id}), matching legacy
* {@see \App\Controllers\ParentReportCardController::resolvePrimaryParentId}.
* (stored on {@see Student::$parent_id}), matching legacy
* {@see ParentReportCardController::resolvePrimaryParentId}.
*/
final class PrimaryParentUserResolver
{
@@ -22,7 +24,7 @@ final class PrimaryParentUserResolver
}
/**
* @param int $userId Session user id (may be secondary/tertiary login).
* @param int $userId Session user id (may be secondary/tertiary login).
*/
public function resolveFromCredentials(int $userId, string $userType): ?int
{