Initial commit: OAuth IAM Laravel application

Laravel-based OAuth/IAM service with Passport, Vue 3 frontend, and
Docker Compose setup for local and production deployment.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

app/Http/Controllers/Api/AnalyticsController.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Controllers\Controller;
+use App\Support\AnalyticsSummary;
+use Illuminate\Http\Request;
+use Illuminate\Routing\Controllers\HasMiddleware;
+use Illuminate\Routing\Controllers\Middleware;
+use Laravel\Passport\Http\Middleware\CheckToken;
+use OpenApi\Attributes as OA;
+
+class AnalyticsController extends Controller implements HasMiddleware
+{
+    public static function middleware(): array
+    {
+        return [new Middleware(CheckToken::using('users:read'))];
+    }
+
+    #[OA\Get(
+        path: '/analytics/summary',
+        summary: 'Métricas de uso: logins por día, por app, usuarios más activos y actividad reciente',
+        description: 'Requiere el permiso users.view (o un token client_credentials, que actúa como servicio de confianza).',
+        security: [['oauth2' => ['users:read']]],
+        tags: ['Analytics'],
+        parameters: [
+            new OA\Parameter(name: 'days', in: 'query', required: false, description: 'Ventana en días (7-90, default 30)', schema: new OA\Schema(type: 'integer')),
+        ],
+        responses: [
+            new OA\Response(response: 200, description: 'Resumen de analíticas'),
+            new OA\Response(response: 403, description: 'Sin permiso users.view'),
+        ]
+    )]
+    public function summary(Request $request)
+    {
+        $actor = $request->user('api');
+        abort_if($actor && ! $actor->can('users.view'), 403);
+
+        $days = min(max((int) $request->integer('days', 30), 7), 90);
+
+        return response()->json(AnalyticsSummary::build($days));
+    }
+}