832751d1ed
Auto Tag Develop / tag (push) Successful in 9s
## Contexte Certains comptes sont **partagés** par plusieurs personnes (ex. compte « Usine »), y compris depuis des smartphones. Le journal d'activité ne stockait que le `username` → impossible de distinguer les intervenants. Cette PR ajoute un **contexte forensique automatique** à chaque entrée du journal. ## Ce qui est ajouté (capté automatiquement, sans friction utilisateur) - **Adresse IP** de la requête - **User-Agent brut** (borné à 1024 caractères) - **Libellé appareil lisible** dérivé du User-Agent : `Type · OS · Navigateur` (ex. `Mobile · Android · Chrome`) - **Identifiant d'appareil persistant** envoyé par le front (header `X-Device-Id`, stocké en `localStorage`, borné à 64 car.) — distingue les **appareils** derrière un compte partagé ## Implémentation - `UserAgentParser` (service maison, sans dépendance) — détection ordonnée OS/navigateur, testée - 4 colonnes **nullable** sur `audit_logs` + migration réversible (pas de backfill, rétro-compatible) - Capture **centralisée** dans `AuditLogger::log()` via `RequestStack` — aucun processor modifié - Champs exposés dans l'API lecture (`AuditLogProvider` + DTO TS aligné) via `AuditLogReadRepositoryInterface` (suit le pattern existant des autres read-repos) - Front : `useDeviceId` + injection du header `X-Device-Id` dans `useApi` (sur toutes les requêtes, SSR-safe) - `framework.trusted_proxies` documenté (commenté) pour une IP correcte derrière un reverse proxy - Docs : `doc/audit-logging.md` + `CLAUDE.md` ## Hors périmètre (étapes suivantes) - **Écran du journal (`audit-logs.vue`) non modifié** — l'affichage des nouvelles colonnes fera l'objet d'une refonte séparée. Les données sont prêtes côté API. - La doc in-app (`documentation-content.ts`) n'est pas touchée : le journal est un outil caché `ROLE_SUPER_ADMIN` sans article existant ni niveau de doc super-admin. ## À noter pour le déploiement - L'IP n'est fiable derrière un reverse proxy qu'une fois `framework.trusted_proxies` activé (livré commenté). ## Tests `OK (249 tests, 533 assertions)` — sortie PHPUnit propre (aucune notice). 🤖 Generated with [Claude Code](https://claude.com/claude-code) Reviewed-on: #33 Co-authored-by: tristan <tristan@yuno.malio.fr> Co-committed-by: tristan <tristan@yuno.malio.fr>
113 lines
4.1 KiB
PHP
113 lines
4.1 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\State;
|
|
|
|
use ApiPlatform\Metadata\Operation;
|
|
use ApiPlatform\State\ProviderInterface;
|
|
use App\Repository\Contract\AuditLogReadRepositoryInterface;
|
|
use DateTimeImmutable;
|
|
use DateTimeZone;
|
|
use Symfony\Component\HttpFoundation\JsonResponse;
|
|
use Symfony\Component\HttpFoundation\RequestStack;
|
|
|
|
class AuditLogProvider implements ProviderInterface
|
|
{
|
|
private const DEFAULT_PER_PAGE = 10;
|
|
private const ALLOWED_PER_PAGE = [10, 25, 50, 100];
|
|
|
|
public function __construct(
|
|
private readonly RequestStack $requestStack,
|
|
private readonly AuditLogReadRepositoryInterface $auditLogRepository,
|
|
) {}
|
|
|
|
public function provide(Operation $operation, array $uriVariables = [], array $context = []): JsonResponse
|
|
{
|
|
$request = $this->requestStack->getCurrentRequest();
|
|
if (!$request) {
|
|
return new JsonResponse(['items' => [], 'total' => 0]);
|
|
}
|
|
|
|
$query = $request->query;
|
|
$all = $query->all();
|
|
|
|
$employeeId = $query->get('employeeId');
|
|
$from = $query->get('from');
|
|
$to = $query->get('to');
|
|
$page = max(1, (int) $query->get('page', '1'));
|
|
|
|
$perPage = (int) $query->get('perPage', (string) self::DEFAULT_PER_PAGE);
|
|
if (!in_array($perPage, self::ALLOWED_PER_PAGE, true)) {
|
|
$perPage = self::DEFAULT_PER_PAGE;
|
|
}
|
|
|
|
$entityTypes = $this->normalizeList($all['entityType'] ?? null);
|
|
$actions = $this->normalizeList($all['action'] ?? null);
|
|
$username = $this->normalizeString($query->get('username'));
|
|
$ip = $this->normalizeString($query->get('ip'));
|
|
$device = $this->normalizeString($query->get('device'));
|
|
$employee = $this->normalizeString($query->get('employee'));
|
|
|
|
$empId = $employeeId ? (int) $employeeId : null;
|
|
$fromDt = $from ? new DateTimeImmutable((string) $from) : null;
|
|
$toDt = $to ? new DateTimeImmutable((string) $to) : null;
|
|
$offset = ($page - 1) * $perPage;
|
|
|
|
$total = $this->auditLogRepository->countByFilters($empId, $fromDt, $toDt, $entityTypes, $actions, $username, $ip, $device, $employee);
|
|
$logs = $this->auditLogRepository->findByFilters($empId, $fromDt, $toDt, $entityTypes, $actions, $username, $ip, $device, $employee, $perPage, $offset);
|
|
|
|
$items = [];
|
|
foreach ($logs as $log) {
|
|
$employee = $log->getEmployee();
|
|
$employeeName = $employee
|
|
? trim(($employee->getLastName() ?? '').' '.($employee->getFirstName() ?? ''))
|
|
: null;
|
|
|
|
$items[] = [
|
|
'id' => $log->getId(),
|
|
'employeeName' => $employeeName,
|
|
'employeeId' => $employee?->getId(),
|
|
'username' => $log->getUsername(),
|
|
'action' => $log->getAction(),
|
|
'entityType' => $log->getEntityType(),
|
|
'description' => $log->getDescription(),
|
|
'changes' => $log->getChanges(),
|
|
'affectedDate' => $log->getAffectedDate()?->format('Y-m-d'),
|
|
'ipAddress' => $log->getIpAddress(),
|
|
'userAgent' => $log->getUserAgent(),
|
|
'deviceLabel' => $log->getDeviceLabel(),
|
|
'deviceId' => $log->getDeviceId(),
|
|
'createdAt' => $log->getCreatedAt()->setTimezone(new DateTimeZone('Europe/Paris'))->format('Y-m-d H:i:s'),
|
|
];
|
|
}
|
|
|
|
return new JsonResponse([
|
|
'items' => $items,
|
|
'total' => $total,
|
|
'page' => $page,
|
|
'perPage' => $perPage,
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* @return null|list<string>
|
|
*/
|
|
private function normalizeList(mixed $value): ?array
|
|
{
|
|
$list = array_values(array_filter(
|
|
(array) ($value ?? []),
|
|
static fn ($v): bool => is_string($v) && '' !== trim($v),
|
|
));
|
|
|
|
return [] === $list ? null : $list;
|
|
}
|
|
|
|
private function normalizeString(mixed $value): ?string
|
|
{
|
|
$trimmed = trim((string) ($value ?? ''));
|
|
|
|
return '' === $trimmed ? null : $trimmed;
|
|
}
|
|
}
|