add family logic

routes/api.php

@@ -306,6 +306,26 @@ Route::prefix('v1')->group(function () {
             Route::post('send', [CommunicationController::class, 'send']);
         });
 
+        Route::prefix('family-admin')->group(function () {
+            Route::get('/', [FamilyAdminController::class, 'index']);
+            Route::get('search', [FamilyAdminController::class, 'search']);
+            Route::get('card', [FamilyAdminController::class, 'card']);
+            Route::post('compose-email', [FamilyAdminController::class, 'composeEmail']);
+        });
+
+        Route::prefix('families')->group(function () {
+            Route::get('by-student/{studentId}', [FamilyController::class, 'familiesByStudent']);
+            Route::get('{familyId}/guardians', [FamilyController::class, 'guardiansByFamily']);
+            Route::post('bootstrap', [FamilyController::class, 'bootstrap']);
+            Route::post('attach-second/by-user', [FamilyController::class, 'attachSecondByUser']);
+            Route::post('attach-second/by-email', [FamilyController::class, 'attachSecondByEmail']);
+            Route::post('set-primary-home', [FamilyController::class, 'setPrimaryHome']);
+            Route::post('set-guardian-flags', [FamilyController::class, 'setGuardianFlags']);
+            Route::post('unlink-guardian', [FamilyController::class, 'unlinkGuardian']);
+            Route::post('unlink-student', [FamilyController::class, 'unlinkStudent']);
+            Route::post('import-legacy-second-parents', [FamilyController::class, 'importSecondParentsFromLegacy']);
+        });
+
         Route::prefix('competition-scores')->group(function () {
             Route::get('/', [CompetitionScoresController::class, 'index']);
             Route::get('{id}', [CompetitionScoresController::class, 'edit']);

routes/web.php

@@ -2,6 +2,7 @@
 
 use Illuminate\Support\Facades\Route;
 use App\Http\Controllers\View\DashboardRedirectController;
+use App\Services\Docs\OpenApiRouteExporter;
 
 Route::redirect('/', '/api/docs')->name('docs.home');
 Route::view('/api/docs', 'docs.swagger')->name('docs.swagger');
@@ -11,8 +12,10 @@ Route::get('/api/documentation/swagger.json', function () {
     $path = resource_path('docs/openapi.json');
     abort_unless(is_file($path), 404);
 
-    return response()->file($path, [
+    $spec = app(OpenApiRouteExporter::class)->exportFromFile($path);
+
+    return response()->json($spec, 200, [
         'Content-Type' => 'application/json',
-        'Cache-Control' => 'public, max-age=300',
+        'Cache-Control' => 'no-store, max-age=0',
     ]);
 })->name('docs.swagger-json');