Josep Piguillem
c2b5291a74
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>
44 lines
1.5 KiB
PHP
44 lines
1.5 KiB
PHP
<?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));
|
|
}
|
|
}
|