add family logic

2026-03-10 17:52:47 -04:00
parent a82f7aedbc
commit 17d73e2f92
37 changed files with 2611 additions and 2 deletions
@@ -0,0 +1,102 @@
+<?php
+
+namespace App\Http\Controllers\Api\Family;
+
+use App\Http\Controllers\Api\BaseApiController;
+use App\Http\Requests\Families\FamilyAdminCardRequest;
+use App\Http\Requests\Families\FamilyAdminIndexRequest;
+use App\Http\Requests\Families\FamilyAdminSearchRequest;
+use App\Http\Requests\Families\FamilyComposeEmailRequest;
+use App\Http\Resources\Families\FamilyResource;
+use App\Http\Resources\Families\FamilySearchItemResource;
+use App\Models\Configuration;
+use App\Services\Families\FamilyNotificationService;
+use App\Services\Families\FamilyQueryService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Support\Facades\Log;
+use Symfony\Component\HttpFoundation\Response;
+
+class FamilyAdminController extends BaseApiController
+{
+    public function __construct(
+        private FamilyQueryService $queryService,
+        private FamilyNotificationService $notificationService
+    ) {
+        parent::__construct();
+    }
+
+    public function index(FamilyAdminIndexRequest $request): JsonResponse
+    {
+        $payload = $request->validated();
+        $schoolYear = trim((string) (Configuration::getConfig('school_year') ?? ''));
+
+        $data = $this->queryService->adminIndexData(
+            $payload['student_id'] ?? null,
+            $payload['guardian_id'] ?? null,
+            $schoolYear
+        );
+
+        return $this->success([
+            'student' => $data['student'],
+            'families' => FamilyResource::collection($data['families']),
+            'guardians' => $data['guardians'],
+            'students' => $data['students'],
+            'searchStudents' => $data['searchStudents'],
+            'searchGuardians' => $data['searchGuardians'],
+            'resolved_student_id' => $data['resolved_student_id'],
+        ]);
+    }
+
+    public function search(FamilyAdminSearchRequest $request): JsonResponse
+    {
+        $payload = $request->validated();
+        $items = $this->queryService->searchSuggestions(
+            (string) $payload['q'],
+            (int) ($payload['limit'] ?? 8)
+        );
+
+        return $this->success([
+            'items' => FamilySearchItemResource::collection($items),
+        ]);
+    }
+
+    public function card(FamilyAdminCardRequest $request): JsonResponse
+    {
+        $payload = $request->validated();
+        $schoolYear = trim((string) (Configuration::getConfig('school_year') ?? ''));
+
+        $family = $this->queryService->familyCard(
+            $payload['student_id'] ?? null,
+            $payload['guardian_id'] ?? null,
+            $payload['family_id'] ?? null,
+            $schoolYear
+        );
+
+        if (!$family) {
+            return $this->error('Family not found.', Response::HTTP_NOT_FOUND);
+        }
+
+        return $this->success(new FamilyResource($family));
+    }
+
+    public function composeEmail(FamilyComposeEmailRequest $request): JsonResponse
+    {
+        $payload = $request->validated();
+
+        $ok = $this->notificationService->sendComposeEmail(
+            (string) $payload['recipient'],
+            (string) $payload['subject'],
+            (string) $payload['html_message'],
+            $payload['profile'] ?? null,
+            $payload['reply_to_email'] ?? null,
+            $payload['reply_to_name'] ?? null
+        );
+
+        if (!$ok) {
+            Log::warning('Compose email failed for family admin', ['recipient' => $payload['recipient']]);
+            return $this->error('Unable to send email.', Response::HTTP_INTERNAL_SERVER_ERROR);
+        }
+
+        return $this->success(['recipient' => $payload['recipient']], 'Email sent.');
+    }
+}