update project

This commit is contained in:
root
2026-05-30 01:11:35 -04:00
parent 3a0628ecc7
commit 2225f6bc72
9743 changed files with 1122482 additions and 59 deletions
@@ -0,0 +1,457 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Api\Integration;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Routing\Controller;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Carbon;
use Illuminate\Support\Str;
use Symfony\Component\HttpFoundation\Response;
final class SchoolWorkflowController extends Controller
{
public function storeSchool(Request $request): JsonResponse
{
$data = $request->validate([
'name' => ['required', 'string', 'max:255'],
'code' => ['nullable', 'string', 'max:64'],
'timezone' => ['nullable', 'string', 'max:64'],
'locale' => ['nullable', 'string', 'max:16'],
'currency' => ['nullable', 'string', 'size:3'],
'domain_profile' => ['nullable', 'string', 'max:64'],
]);
$id = (int) DB::table('schools')->insertGetId([
'name' => $data['name'],
'code' => $data['code'] ?? null,
'timezone' => $data['timezone'] ?? 'UTC',
'locale' => $data['locale'] ?? 'en',
'currency' => strtoupper($data['currency'] ?? 'USD'),
'domain_profile' => $data['domain_profile'] ?? 'standard_school',
'active' => true,
'created_at' => now(),
'updated_at' => now(),
]);
return $this->ok($this->schoolPayload($id), Response::HTTP_CREATED, 'School created.');
}
public function showSchool(int $school): JsonResponse
{
return $this->ok($this->schoolPayload($school));
}
public function storeStudent(Request $request, int $school): JsonResponse
{
$this->assertSchoolExists($school);
$data = $request->validate([
'first_name' => ['required', 'string', 'max:255'],
'last_name' => ['required', 'string', 'max:255'],
'student_number' => ['nullable', 'string', 'max:128'],
'school_id_number' => ['nullable', 'string', 'max:128'],
'grade_level' => ['nullable', 'string', 'max:64'],
'status' => ['nullable', 'string', 'max:64'],
]);
$studentNumber = $data['student_number'] ?? $data['school_id_number'] ?? null;
$id = (int) DB::table('students')->insertGetId([
'school_id' => $school,
'school_id_number' => $studentNumber,
'student_identifier' => $studentNumber,
'first_name' => $data['first_name'],
'last_name' => $data['last_name'],
'status' => $data['status'] ?? 'active',
'profile_metadata' => json_encode(['grade_level' => $data['grade_level'] ?? null], JSON_THROW_ON_ERROR),
'metadata' => json_encode(['grade_level' => $data['grade_level'] ?? null], JSON_THROW_ON_ERROR),
'created_at' => now(),
'updated_at' => now(),
]);
return $this->ok($this->studentPayload($school, $id), Response::HTTP_CREATED, 'Student created.');
}
public function showStudent(int $school, int $student): JsonResponse
{
return $this->ok($this->studentPayload($school, $student));
}
public function storeAttendanceScan(Request $request, int $school): JsonResponse
{
$this->assertSchoolExists($school);
$data = $request->validate([
'student_number' => ['required_without:student_id', 'string', 'max:128'],
'student_id' => ['required_without:student_number', 'integer'],
'scanned_at' => ['nullable', 'date'],
'source' => ['nullable', 'string', 'max:64'],
'station_id' => ['nullable', 'string', 'max:128'],
]);
$student = $this->findStudentByScanInput($school, $data);
$scannedAt = isset($data['scanned_at']) ? Carbon::parse($data['scanned_at']) : now();
$sessionId = $this->resolveDailySession($school, $scannedAt);
$existing = DB::table('attendance_records')
->where('school_id', $school)
->where('attendance_session_id', $sessionId)
->where('subject_type', 'student')
->where('subject_id', $student->id)
->first();
if ($existing) {
DB::table('attendance_records')->where('id', $existing->id)->update([
'last_seen_at' => $scannedAt,
'updated_at' => now(),
]);
$recordId = (int) $existing->id;
$statusResult = 'duplicate';
} else {
$recordId = (int) DB::table('attendance_records')->insertGetId([
'school_id' => $school,
'attendance_session_id' => $sessionId,
'attendance_date' => $scannedAt->toDateString(),
'subject_type' => 'student',
'subject_id' => $student->id,
'status' => 'present',
'source' => $data['source'] ?? 'scan',
'first_seen_at' => $scannedAt,
'last_seen_at' => $scannedAt,
'metadata' => json_encode(['student_number' => $student->school_id_number], JSON_THROW_ON_ERROR),
'created_at' => now(),
'updated_at' => now(),
]);
$statusResult = 'recorded';
}
$scanId = (int) DB::table('attendance_scan_logs')->insertGetId([
'school_id' => $school,
'attendance_record_id' => $recordId,
'subject_type' => 'student',
'subject_id' => $student->id,
'station_id' => $data['station_id'] ?? null,
'scan_action' => 'check_in',
'scan_source' => $data['source'] ?? 'scan',
'scanned_at' => $scannedAt,
'status_result' => $statusResult,
'raw_payload_json' => json_encode($data, JSON_THROW_ON_ERROR),
'created_at' => now(),
'updated_at' => now(),
]);
return $this->ok([
'scan_id' => $scanId,
'attendance_record_id' => $recordId,
'student_id' => (int) $student->id,
'status' => $statusResult,
], $statusResult === 'recorded' ? Response::HTTP_CREATED : Response::HTTP_OK, 'Attendance scan processed.');
}
public function previewCommunication(Request $request, int $school): JsonResponse
{
$this->assertSchoolExists($school);
$data = $request->validate([
'template_key' => ['required', 'string', 'max:128'],
'student_id' => ['required', 'integer'],
'channel' => ['nullable', 'string', 'max:32'],
]);
$student = $this->findStudent($school, (int) $data['student_id']);
$template = $this->findTemplate($school, $data['template_key'], $data['channel'] ?? null);
return $this->ok([
'template_key' => $template->template_key,
'subject' => $this->renderTemplate($template->subject, $student),
'body' => $this->renderTemplate($template->body, $student),
'student_id' => (int) $student->id,
]);
}
public function sendCommunication(Request $request, int $school): JsonResponse
{
$this->assertSchoolExists($school);
$data = $request->validate([
'template_key' => ['required', 'string', 'max:128'],
'student_id' => ['required', 'integer'],
'channel' => ['required', 'string', 'max:32'],
]);
$student = $this->findStudent($school, (int) $data['student_id']);
$template = $this->findTemplate($school, $data['template_key'], $data['channel']);
$messageId = (int) DB::table('communication_messages')->insertGetId([
'school_id' => $school,
'actor_user_id' => null,
'channel' => $data['channel'],
'message_category' => $template->message_category ?? 'general',
'priority' => 'normal',
'subject' => $this->renderTemplate($template->subject, $student),
'body_snapshot' => $this->renderTemplate($template->body, $student),
'template_id' => $template->id,
'template_version' => $template->version ?? '1',
'status' => 'queued',
'created_at' => now(),
'updated_at' => now(),
]);
$recipientId = (int) DB::table('communication_message_recipients')->insertGetId([
'message_id' => $messageId,
'school_id' => $school,
'recipient_type' => 'student',
'recipient_id' => $student->id,
'channel' => $data['channel'],
'status' => 'queued',
'created_at' => now(),
'updated_at' => now(),
]);
return $this->ok([
'message_id' => $messageId,
'recipient_id' => $recipientId,
'status' => 'queued',
], Response::HTTP_ACCEPTED, 'Communication queued.');
}
public function uploadPaymentFile(Request $request, int $school): JsonResponse
{
$this->assertSchoolExists($school);
$request->validate(['file' => ['required', 'file']]);
$file = $request->file('file');
$rows = array_map('str_getcsv', file($file->getRealPath()) ?: []);
$headers = array_map(static fn ($value): string => trim((string) $value), $rows[0] ?? []);
$required = ['student_number', 'amount', 'paid_at', 'reference'];
if (array_diff($required, $headers) !== []) {
return $this->fail('Invalid payment file.', Response::HTTP_UNPROCESSABLE_ENTITY, [
'file' => ['CSV must include student_number, amount, paid_at, and reference columns.'],
]);
}
$imported = [];
try {
return DB::transaction(function () use ($school, $headers, $rows, &$imported): JsonResponse {
foreach (array_slice($rows, 1) as $row) {
if ($row === [null] || $row === false || count(array_filter($row, static fn ($value) => $value !== null && $value !== '')) === 0) {
continue;
}
$record = array_combine($headers, array_pad($row, count($headers), null));
if (! $record || empty($record['student_number']) || ! is_numeric($record['amount']) || empty($record['paid_at']) || empty($record['reference'])) {
throw new \InvalidArgumentException('Invalid payment row.');
}
$student = DB::table('students')
->where('school_id', $school)
->where('school_id_number', $record['student_number'])
->first();
if (! $student) {
throw new \InvalidArgumentException('Payment row references an unknown student.');
}
$paymentId = (int) DB::table('payments')->insertGetId([
'school_id' => $school,
'student_id' => $student->id,
'amount_minor' => (int) round(((float) $record['amount']) * 100),
'currency' => 'USD',
'payment_method' => 'file_import',
'payment_date' => $record['paid_at'],
'reference_number' => $record['reference'],
'status' => 'recorded',
'metadata' => json_encode(['source' => 'payment_file'], JSON_THROW_ON_ERROR),
'created_at' => now(),
'updated_at' => now(),
]);
$imported[] = $paymentId;
}
return $this->ok([
'imported_count' => count($imported),
'payment_ids' => $imported,
], Response::HTTP_CREATED, 'Payment file imported.');
});
} catch (\InvalidArgumentException $exception) {
return $this->fail('Invalid payment file.', Response::HTTP_UNPROCESSABLE_ENTITY, [
'file' => [$exception->getMessage()],
]);
}
}
public function dailyReport(Request $request, int $school): JsonResponse
{
$this->assertSchoolExists($school);
$date = (string) $request->query('date', now()->toDateString());
return $this->ok([
'date' => $date,
'attendance' => [
'present_count' => DB::table('attendance_records')
->where('school_id', $school)
->where('attendance_date', $date)
->where('status', 'present')
->count(),
],
'finance' => [
'total_payments' => (int) DB::table('payments')
->where('school_id', $school)
->where('payment_date', $date)
->where('status', '!=', 'reversed')
->sum('amount_minor'),
],
]);
}
private function schoolPayload(int $school): array
{
$row = DB::table('schools')->where('id', $school)->first();
abort_if(! $row, Response::HTTP_NOT_FOUND, 'School not found.');
return [
'id' => (int) $row->id,
'name' => $row->name,
'code' => $row->code ?? null,
'timezone' => $row->timezone,
'locale' => $row->locale,
'currency' => $row->currency,
];
}
private function studentPayload(int $school, int $student): array
{
$row = $this->findStudent($school, $student);
$metadata = json_decode((string) ($row->profile_metadata ?? $row->metadata ?? '{}'), true) ?: [];
return [
'id' => (int) $row->id,
'school_id' => (int) $row->school_id,
'first_name' => $row->first_name,
'last_name' => $row->last_name,
'student_number' => $row->school_id_number ?? $row->student_identifier,
'grade_level' => $metadata['grade_level'] ?? null,
'status' => $row->status,
];
}
private function assertSchoolExists(int $school): void
{
abort_if(! DB::table('schools')->where('id', $school)->exists(), Response::HTTP_NOT_FOUND, 'School not found.');
}
private function findStudent(int $school, int $student): object
{
$row = DB::table('students')->where('school_id', $school)->where('id', $student)->first();
abort_if(! $row, Response::HTTP_NOT_FOUND, 'Student not found.');
return $row;
}
private function findStudentByScanInput(int $school, array $data): object
{
$query = DB::table('students')->where('school_id', $school);
if (isset($data['student_id'])) {
$query->where('id', $data['student_id']);
} else {
$query->where('school_id_number', $data['student_number']);
}
$row = $query->first();
abort_if(! $row, Response::HTTP_NOT_FOUND, 'Student not found.');
return $row;
}
private function resolveDailySession(int $school, \DateTimeInterface $scannedAt): int
{
$date = $scannedAt->format('Y-m-d');
$existing = DB::table('attendance_sessions')
->where('school_id', $school)
->whereDate('starts_at', $date)
->where('session_type', 'daily')
->first();
if ($existing) {
return (int) $existing->id;
}
return (int) DB::table('attendance_sessions')->insertGetId([
'school_id' => $school,
'name' => 'Daily attendance '.$date,
'session_type' => 'daily',
'starts_at' => $date.' 00:00:00',
'ends_at' => $date.' 23:59:59',
'timezone' => 'UTC',
'status' => 'open',
'created_at' => now(),
'updated_at' => now(),
]);
}
private function findTemplate(int $school, string $templateKey, ?string $channel): object
{
$query = DB::table('communication_templates')
->where(function ($query) use ($school): void {
$query->where('school_id', $school)->orWhereNull('school_id');
})
->where('template_key', $templateKey)
->where('status', '!=', 'archived')
->orderByDesc('school_id')
->orderByDesc('version');
if ($channel !== null) {
$query->where('channel', $channel);
}
$row = $query->first();
abort_if(! $row, Response::HTTP_NOT_FOUND, 'Communication template not found.');
return $row;
}
private function renderTemplate(?string $template, object $student): ?string
{
if ($template === null) {
return null;
}
return Str::of($template)
->replace('{{ student.first_name }}', (string) $student->first_name)
->replace('{{student.first_name}}', (string) $student->first_name)
->replace('{{ student.last_name }}', (string) $student->last_name)
->replace('{{student.last_name}}', (string) $student->last_name)
->toString();
}
private function ok(array $data, int $status = Response::HTTP_OK, ?string $message = null): JsonResponse
{
return response()->json([
'success' => true,
'data' => $data,
'message' => $message,
'errors' => null,
], $status);
}
private function fail(string $message, int $status, array $errors): JsonResponse
{
return response()->json([
'success' => false,
'data' => null,
'message' => $message,
'errors' => $errors,
], $status);
}
}
@@ -0,0 +1,22 @@
<?php declare(strict_types=1);
namespace App\Http\Controllers\Api\V2\Attendance;
use App\Domain\SchoolCore\Attendance\Contracts\ScannerServiceContract;
use App\Domain\SchoolCore\Context\SchoolContextStore;
use App\Http\Requests\Attendance\ProcessScanRequest;
use App\Http\Resources\V2\Attendance\ScanResultResource;
use App\Support\Api\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Routing\Controller;
final class ScanController extends Controller
{
public function __construct(private readonly SchoolContextStore $context, private readonly ScannerServiceContract $scanner) {}
public function store(ProcessScanRequest $request): JsonResponse
{
$result = $this->scanner->processScan($this->context->current(), $request->toDTO());
return ApiResponse::success((new ScanResultResource($result))->resolve($request), 'Scan processed.');
}
}
@@ -0,0 +1,29 @@
<?php declare(strict_types=1);
namespace App\Http\Controllers\Api\V2;
use App\Domain\SchoolCore\Context\SchoolContext;
use App\Domain\SchoolCore\Context\SchoolContextStore;
use App\Support\Api\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Routing\Controller;
abstract class BaseApiController extends Controller
{
public function __construct(protected readonly SchoolContextStore $schoolContext) {}
protected function context(): SchoolContext
{
return $this->schoolContext->current();
}
protected function ok(mixed $data = null, ?string $message = null, array $meta = []): JsonResponse
{
return ApiResponse::success($data, $message, $meta);
}
protected function created(mixed $data = null, ?string $message = null, array $meta = []): JsonResponse
{
return ApiResponse::success($data, $message, $meta, 201);
}
}
@@ -0,0 +1,22 @@
<?php declare(strict_types=1);
namespace App\Http\Controllers\Api\V2\Communication;
use App\Domain\SchoolCore\Communication\Contracts\CommunicationServiceContract;
use App\Domain\SchoolCore\Context\SchoolContextStore;
use App\Http\Requests\Communication\BulkSendMessageRequest;
use App\Http\Resources\V2\Communication\MessageResource;
use App\Support\Api\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Routing\Controller;
final class BulkSendController extends Controller
{
public function __construct(private readonly SchoolContextStore $context, private readonly CommunicationServiceContract $communication) {}
public function store(BulkSendMessageRequest $request): JsonResponse
{
$result = $this->communication->sendBulkMessage($this->context->current(), $request->toDTO());
return ApiResponse::success((new MessageResource($result))->resolve($request), 'Bulk message accepted.');
}
}
@@ -0,0 +1,22 @@
<?php declare(strict_types=1);
namespace App\Http\Controllers\Api\V2\Communication;
use App\Domain\SchoolCore\Communication\Contracts\RecipientPreviewServiceContract;
use App\Domain\SchoolCore\Context\SchoolContextStore;
use App\Http\Requests\Communication\RecipientPreviewRequest;
use App\Http\Resources\V2\Communication\RecipientPreviewResource;
use App\Support\Api\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Routing\Controller;
final class RecipientPreviewController extends Controller
{
public function __construct(private readonly SchoolContextStore $context, private readonly RecipientPreviewServiceContract $previews) {}
public function store(RecipientPreviewRequest $request): JsonResponse
{
$result = $this->previews->preview($this->context->current(), $request->toDTO());
return ApiResponse::success((new RecipientPreviewResource($result))->resolve($request), 'Recipient preview created.', [], 201);
}
}
@@ -0,0 +1,35 @@
<?php declare(strict_types=1);
namespace App\Http\Controllers\Api\V2\Finance;
use App\Domain\SchoolCore\Context\SchoolContextStore;
use App\Domain\SchoolCore\Finance\Contracts\PaymentServiceContract;
use App\Http\Requests\Finance\EditPaymentRequest;
use App\Http\Requests\Finance\RecordPaymentRequest;
use App\Http\Resources\V2\Finance\PaymentResource;
use App\Support\Api\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Routing\Controller;
final class PaymentController extends Controller
{
public function __construct(private readonly SchoolContextStore $context, private readonly PaymentServiceContract $payments) {}
public function store(RecordPaymentRequest $request): JsonResponse
{
$result = $this->payments->recordPayment($this->context->current(), $request->toDTO());
return ApiResponse::success((new PaymentResource($result))->resolve($request), 'Payment recorded.', [], 201);
}
public function update(EditPaymentRequest $request, int $payment): JsonResponse
{
$result = $this->payments->editPayment($this->context->current(), $payment, $request->toDTO());
return ApiResponse::success((new PaymentResource($result))->resolve($request), 'Payment updated.');
}
public function reverse(EditPaymentRequest $request, int $payment): JsonResponse
{
$result = $this->payments->reversePayment($this->context->current(), $payment, (string) $request->validated('edit_reason', 'Reversed through API'));
return ApiResponse::success((new PaymentResource($result))->resolve($request), 'Payment reversed.');
}
}
@@ -0,0 +1,19 @@
<?php declare(strict_types=1);
namespace App\Http\Controllers\Api\V2\Finance;
use App\Domain\SchoolCore\Context\SchoolContextStore;
use App\Domain\SchoolCore\Finance\Contracts\FinanceFileServiceContract;
use App\Http\Requests\Finance\DownloadPaymentFileRequest;
use Illuminate\Routing\Controller;
use Symfony\Component\HttpFoundation\BinaryFileResponse;
final class PaymentFileController extends Controller
{
public function __construct(private readonly SchoolContextStore $context, private readonly FinanceFileServiceContract $files) {}
public function show(DownloadPaymentFileRequest $request, int $payment): BinaryFileResponse
{
return $this->files->downloadPaymentFile($this->context->current(), $payment, (string) $request->validated('mode', 'download'));
}
}
@@ -0,0 +1,23 @@
<?php declare(strict_types=1);
namespace App\Http\Controllers\Api\V2\IslamicSundaySchool;
use App\Domain\SchoolCore\Context\SchoolContextStore;
use App\Domain\SchoolCore\Reporting\Contracts\ReportRunnerContract;
use App\Domain\SchoolCore\Reporting\DTO\ReportRequestData;
use App\Http\Resources\V2\IslamicSundaySchool\QuranProgressReportResource;
use App\Support\Api\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Routing\Controller;
final class QuranProgressController extends Controller
{
public function __construct(private readonly SchoolContextStore $context, private readonly ReportRunnerContract $reports) {}
public function index(): JsonResponse
{
$data = new ReportRequestData('islamic.quran_progress', [], null, null, null, null, false, null, null, false, []);
$result = $this->reports->run($this->context->current(), $data);
return ApiResponse::success((new QuranProgressReportResource($result))->resolve(request()));
}
}
@@ -0,0 +1,36 @@
<?php declare(strict_types=1);
namespace App\Http\Controllers\Api\V2\Reporting;
use App\Domain\SchoolCore\Context\SchoolContextStore;
use App\Domain\SchoolCore\Reporting\Contracts\ReportRegistryContract;
use App\Domain\SchoolCore\Reporting\Contracts\ReportRunnerContract;
use App\Http\Requests\Reporting\ListReportsRequest;
use App\Http\Requests\Reporting\RunReportRequest;
use App\Http\Resources\V2\Reporting\ReportResultResource;
use App\Support\Api\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Routing\Controller;
final class ReportController extends Controller
{
public function __construct(private readonly SchoolContextStore $context, private readonly ReportRegistryContract $registry, private readonly ReportRunnerContract $runner) {}
public function index(ListReportsRequest $request): JsonResponse
{
$reports = array_map(fn ($report) => [
'key' => $report->key(),
'name' => $report->name(),
'category' => $report->category()->value,
'visibility' => $report->visibility()->value,
], $this->registry->availableReports($this->context->current()));
return ApiResponse::success($reports);
}
public function run(RunReportRequest $request): JsonResponse
{
$result = $this->runner->run($this->context->current(), $request->toDTO());
return ApiResponse::success((new ReportResultResource($result))->resolve($request));
}
}
@@ -0,0 +1,22 @@
<?php declare(strict_types=1);
namespace App\Http\Controllers\Api\V2\Reporting;
use App\Domain\SchoolCore\Context\SchoolContextStore;
use App\Domain\SchoolCore\Reporting\Contracts\ReportExportServiceContract;
use App\Http\Requests\Reporting\ExportReportRequest;
use App\Http\Resources\V2\Reporting\ReportExportResource;
use App\Support\Api\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Routing\Controller;
final class ReportExportController extends Controller
{
public function __construct(private readonly SchoolContextStore $context, private readonly ReportExportServiceContract $exports) {}
public function store(ExportReportRequest $request): JsonResponse
{
$result = $this->exports->export($this->context->current(), $request->toDTO());
return ApiResponse::success((new ReportExportResource($result))->resolve($request), 'Report export created.');
}
}
@@ -0,0 +1,50 @@
<?php declare(strict_types=1);
namespace App\Http\Controllers\Api\V2\Students;
use App\Domain\SchoolCore\Context\SchoolContextStore;
use App\Domain\SchoolCore\Students\Contracts\StudentReadServiceContract;
use App\Domain\SchoolCore\Students\Contracts\StudentServiceContract;
use App\Http\Requests\Students\CreateStudentRequest;
use App\Http\Requests\Students\StudentSearchRequest;
use App\Http\Requests\Students\StudentStatusTransitionRequest;
use App\Http\Requests\Students\UpdateStudentRequest;
use App\Http\Resources\V2\Students\StudentResource;
use App\Support\Api\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Routing\Controller;
final class StudentController extends Controller
{
public function __construct(private readonly SchoolContextStore $context, private readonly StudentServiceContract $students, private readonly StudentReadServiceContract $reader) {}
public function index(StudentSearchRequest $request): JsonResponse
{
$result = $this->reader->search($this->context->current(), $request->toDTO());
return ApiResponse::success($result);
}
public function store(CreateStudentRequest $request): JsonResponse
{
$result = $this->students->createStudent($this->context->current(), $request->toDTO());
return ApiResponse::success((new StudentResource($result))->resolve($request), 'Student created.', [], 201);
}
public function show(int $student): JsonResponse
{
$result = $this->students->getStudent($this->context->current(), $student);
return ApiResponse::success((new StudentResource($result))->resolve(request()));
}
public function update(UpdateStudentRequest $request, int $student): JsonResponse
{
$result = $this->students->updateStudent($this->context->current(), $student, $request->toDTO());
return ApiResponse::success((new StudentResource($result))->resolve($request), 'Student updated.');
}
public function transition(StudentStatusTransitionRequest $request, int $student): JsonResponse
{
$result = $this->students->transitionStatus($this->context->current(), $student, $request->toDTO());
return ApiResponse::success((new StudentResource($result))->resolve($request), 'Student status changed.');
}
}
@@ -0,0 +1,25 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Attendance;
use App\Domain\SchoolCore\Attendance\Contracts\ScannerServiceContract;
use App\Domain\SchoolCore\Context\SchoolContext;
use App\Http\Requests\Attendance\ProcessScanRequest;
use Illuminate\Routing\Controller;
final class ScannerController extends Controller
{
public function __construct(private ScannerServiceContract $scanner) {}
public function __invoke(ProcessScanRequest $request)
{
/** @var SchoolContext $context */
$context = $request->attributes->get(SchoolContext::class);
$result = $this->scanner->processScan($context, $request->toDTO());
return response()->json($result->toArray());
}
}
@@ -0,0 +1,24 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Attendance;
use App\Domain\SchoolCore\Attendance\Contracts\StaffAttendanceServiceContract;
use App\Domain\SchoolCore\Context\SchoolContext;
use App\Http\Requests\Attendance\RecordStaffAttendanceRequest;
use Illuminate\Routing\Controller;
final class StaffAttendanceController extends Controller
{
public function __construct(private StaffAttendanceServiceContract $staff) {}
public function store(RecordStaffAttendanceRequest $request)
{
/** @var SchoolContext $context */
$context = $request->attributes->get(SchoolContext::class);
$result = $this->staff->recordStaffAttendance($context, $request->toDTO());
return response()->json(['data' => $result]);
}
}
@@ -0,0 +1,24 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Attendance;
use App\Domain\SchoolCore\Attendance\Contracts\StudentAttendanceServiceContract;
use App\Domain\SchoolCore\Context\SchoolContext;
use App\Http\Requests\Attendance\RecordStudentAttendanceRequest;
use Illuminate\Routing\Controller;
final class StudentAttendanceController extends Controller
{
public function __construct(private StudentAttendanceServiceContract $students) {}
public function store(RecordStudentAttendanceRequest $request)
{
/** @var SchoolContext $context */
$context = $request->attributes->get(SchoolContext::class);
$result = $this->students->recordStudentAttendance($context, $request->toDTO());
return response()->json(['data' => $result]);
}
}
@@ -0,0 +1 @@
<?php declare(strict_types=1); namespace App\Http\Controllers\Communication; use Illuminate\Routing\Controller; use App\Domain\SchoolCore\Communication\Contracts\CommunicationServiceContract; final class BulkMessageController extends Controller { public function __construct(private CommunicationServiceContract $messages) {} public function send(): array { return ['status'=>'delegated']; } }
@@ -0,0 +1 @@
<?php declare(strict_types=1); namespace App\Http\Controllers\Communication; use Illuminate\Routing\Controller; use App\Domain\SchoolCore\Communication\Contracts\MessageTemplateServiceContract; final class MessageTemplateController extends Controller { public function __construct(private MessageTemplateServiceContract $templates) {} public function store(): array { return ['status'=>'delegated']; } }
@@ -0,0 +1 @@
<?php declare(strict_types=1); namespace App\Http\Controllers\Communication; use Illuminate\Routing\Controller; use App\Domain\SchoolCore\Communication\Contracts\RecipientPreviewServiceContract; final class RecipientPreviewController extends Controller { public function __construct(private RecipientPreviewServiceContract $previews) {} public function store(): array { return ['status'=>'preview-required']; } }
@@ -0,0 +1,20 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Finance;
use App\Domain\SchoolCore\Context\SchoolContext;
use App\Domain\SchoolCore\Finance\Contracts\FinanceFileServiceContract;
use App\Http\Requests\Finance\DownloadPaymentFileRequest;
final class PaymentFileController
{
public function __construct(private readonly FinanceFileServiceContract $files) {}
public function show(DownloadPaymentFileRequest $request, int $payment)
{
/** @var SchoolContext $context */
$context = $request->attributes->get(SchoolContext::class);
return $this->files->downloadPaymentFile($context, $payment, $request->mode());
}
}
@@ -0,0 +1,28 @@
<?php declare(strict_types=1);
namespace App\Http\Controllers\Reporting;
use App\Domain\SchoolCore\Context\SchoolContext;
use App\Domain\SchoolCore\Reporting\Contracts\ReportRegistryContract;
use App\Domain\SchoolCore\Reporting\Contracts\ReportRunnerContract;
use App\Http\Requests\Reporting\RunReportRequest;
use Illuminate\Routing\Controller;
final class ReportController extends Controller
{
public function __construct(private readonly ReportRunnerContract $runner, private readonly ReportRegistryContract $registry) {}
public function index(RunReportRequest $request): array
{
/** @var SchoolContext $context */
$context = $request->attributes->get(SchoolContext::class);
return ['reports' => array_map(fn ($report) => ['key' => $report->key(), 'name' => $report->name()], $this->registry->availableReports($context))];
}
public function run(RunReportRequest $request): array
{
/** @var SchoolContext $context */
$context = $request->attributes->get(SchoolContext::class);
$result = $this->runner->run($context, $request->toDTO());
return ['data' => $result];
}
}
@@ -0,0 +1,18 @@
<?php declare(strict_types=1);
namespace App\Http\Controllers\Reporting;
use App\Domain\SchoolCore\Context\SchoolContext;
use App\Domain\SchoolCore\Reporting\Contracts\ReportExportServiceContract;
use App\Http\Requests\Reporting\ExportReportRequest;
use Illuminate\Routing\Controller;
final class ReportExportController extends Controller
{
public function __construct(private readonly ReportExportServiceContract $exports) {}
public function export(ExportReportRequest $request): array
{
/** @var SchoolContext $context */
$context = $request->attributes->get(SchoolContext::class);
return ['export' => $this->exports->export($context, $request->toDTO())];
}
}
@@ -0,0 +1,18 @@
<?php declare(strict_types=1);
namespace App\Http\Controllers\Reporting;
use App\Domain\SchoolCore\Context\SchoolContext;
use App\Domain\SchoolCore\Reporting\Contracts\ScheduledReportServiceContract;
use App\Http\Requests\Reporting\ScheduleReportRequest;
use Illuminate\Routing\Controller;
final class ScheduledReportController extends Controller
{
public function __construct(private readonly ScheduledReportServiceContract $scheduled) {}
public function store(ScheduleReportRequest $request): array
{
/** @var SchoolContext $context */
$context = $request->attributes->get(SchoolContext::class);
return ['scheduled_report' => $this->scheduled->schedule($context, $request->toDTO())];
}
}
@@ -0,0 +1,25 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers;
use App\Domain\SchoolCore\Context\SchoolContext;
use App\Domain\SchoolCore\Contracts\StudentServiceContract;
use App\Domain\SchoolCore\Students\Data\CreateStudentData;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
final class StudentCreateController
{
public function __construct(private readonly StudentServiceContract $students) {}
public function __invoke(Request $request): JsonResponse
{
/** @var SchoolContext $context */
$context = $request->attributes->get(SchoolContext::class);
$student = $this->students->create($context, new CreateStudentData(method_exists($request, 'validated') ? $request->validated() : $request->all()));
return response()->json($student->attributes, 201);
}
}
@@ -0,0 +1,5 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Students;
use App\Domain\SchoolCore\Context\SchoolContext; use App\Domain\SchoolCore\Students\Contracts\AssignmentServiceContract; use App\Http\Requests\Students\AssignmentRequest; use Illuminate\Http\Request; use Illuminate\Routing\Controller;
final class AssignmentController extends Controller { public function __construct(private readonly AssignmentServiceContract $assignments){} public function store(AssignmentRequest $request): array { $context=$request->attributes->get(SchoolContext::class); return ['data'=>$this->assignments->assignStudent($context,$request->toDTO())]; } public function destroy(Request $request,int $assignment): array { $context=$request->attributes->get(SchoolContext::class); return ['data'=>$this->assignments->unassignStudent($context,$assignment,(string)$request->input('reason','unassign student'))]; } }
@@ -0,0 +1,5 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Students;
use App\Domain\SchoolCore\Context\SchoolContext; use App\Domain\SchoolCore\Students\Contracts\EnrollmentServiceContract; use App\Http\Requests\Students\EnrollmentRequest; use Illuminate\Http\Request; use Illuminate\Routing\Controller;
final class EnrollmentController extends Controller { public function __construct(private readonly EnrollmentServiceContract $enrollments){} public function store(EnrollmentRequest $request): array { $context=$request->attributes->get(SchoolContext::class); return ['data'=>$this->enrollments->enrollStudent($context,$request->toDTO())]; } public function withdraw(Request $request,int $student): array { $context=$request->attributes->get(SchoolContext::class); return ['data'=>$this->enrollments->withdrawStudent($context,$student,(string)$request->input('reason','withdrawal'))]; } }
@@ -0,0 +1,5 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Students;
use App\Domain\SchoolCore\Context\SchoolContext; use App\Domain\SchoolCore\Students\Contracts\GuardianServiceContract; use App\Http\Requests\Students\CreateGuardianRequest; use App\Http\Requests\Students\LinkGuardianRequest; use Illuminate\Http\Request; use Illuminate\Routing\Controller;
final class GuardianController extends Controller { public function __construct(private readonly GuardianServiceContract $guardians){} public function store(CreateGuardianRequest $request): array { $context=$request->attributes->get(SchoolContext::class); return ['data'=>$this->guardians->createGuardian($context,$request->toDTO())]; } public function link(LinkGuardianRequest $request): array { $context=$request->attributes->get(SchoolContext::class); return ['data'=>$this->guardians->linkGuardianToStudent($context,$request->toDTO())]; } public function unlink(Request $request,int $student,int $guardian): array { $context=$request->attributes->get(SchoolContext::class); return ['data'=>$this->guardians->unlinkGuardianFromStudent($context,$student,$guardian,(string)$request->input('reason','unlink guardian'))]; } }
@@ -0,0 +1,5 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Students;
use App\Domain\IslamicSundaySchool\Students\Services\IslamicSundaySchoolStudentProfileService; use App\Domain\SchoolCore\Context\SchoolContext; use App\Http\Requests\Students\IslamicSundaySchoolStudentProfileRequest; use Illuminate\Routing\Controller;
final class IslamicSundaySchoolStudentProfileController extends Controller { public function __construct(private readonly IslamicSundaySchoolStudentProfileService $profiles){} public function store(IslamicSundaySchoolStudentProfileRequest $request): array { $context=$request->attributes->get(SchoolContext::class); return ['data'=>$this->profiles->save($context,$request->toDTO())]; } }
@@ -0,0 +1,5 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Students;
use App\Domain\SchoolCore\Context\SchoolContext; use App\Domain\SchoolCore\Students\Contracts\PromotionServiceContract; use App\Http\Requests\Students\BulkPromotionRequest; use App\Http\Requests\Students\PromotionRequest; use Illuminate\Http\Request; use Illuminate\Routing\Controller;
final class PromotionController extends Controller { public function __construct(private readonly PromotionServiceContract $promotions){} public function evaluate(Request $request,int $student): array { $context=$request->attributes->get(SchoolContext::class); return ['data'=>$this->promotions->evaluatePromotion($context,$student)]; } public function promote(PromotionRequest $request): array { $context=$request->attributes->get(SchoolContext::class); return ['data'=>$this->promotions->promoteStudent($context,$request->toDTO())]; } public function bulk(BulkPromotionRequest $request): array { $context=$request->attributes->get(SchoolContext::class); return ['data'=>$this->promotions->bulkPromote($context,$request->toDTO())]; } }
@@ -0,0 +1,5 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Students;
use App\Domain\SchoolCore\Context\SchoolContext; use App\Domain\SchoolCore\Students\Contracts\StudentReadServiceContract; use App\Domain\SchoolCore\Students\Contracts\StudentServiceContract; use App\Http\Requests\Students\CreateStudentRequest; use App\Http\Requests\Students\StudentSearchRequest; use App\Http\Requests\Students\StudentStatusTransitionRequest; use App\Http\Requests\Students\UpdateStudentRequest; use Illuminate\Routing\Controller;
final class StudentLifecycleController extends Controller { public function __construct(private readonly StudentServiceContract $students, private readonly StudentReadServiceContract $reads){} public function store(CreateStudentRequest $request): array { $context=$request->attributes->get(SchoolContext::class); return ['data'=>$this->students->createStudent($context,$request->toDTO())]; } public function show(CreateStudentRequest $request,int $student): array { $context=$request->attributes->get(SchoolContext::class); return ['data'=>$this->students->getStudent($context,$student)]; } public function update(UpdateStudentRequest $request,int $student): array { $context=$request->attributes->get(SchoolContext::class); return ['data'=>$this->students->updateStudent($context,$student,$request->toDTO())]; } public function transition(StudentStatusTransitionRequest $request,int $student): array { $context=$request->attributes->get(SchoolContext::class); return ['data'=>$this->students->transitionStatus($context,$student,$request->toDTO())]; } public function index(StudentSearchRequest $request): array { $context=$request->attributes->get(SchoolContext::class); return ['data'=>$this->reads->search($context,$request->toDTO())]; } }