tristan
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>
40 lines
1.3 KiB
TypeScript
40 lines
1.3 KiB
TypeScript
import type { AuditLog } from './dto/audit-log'
|
|
|
|
export type AuditLogFilters = {
|
|
employee?: string
|
|
from?: string
|
|
to?: string
|
|
entityType?: string[]
|
|
action?: string[]
|
|
username?: string
|
|
ip?: string
|
|
device?: string
|
|
page?: number
|
|
perPage?: number
|
|
}
|
|
|
|
export type AuditLogPage = {
|
|
items: AuditLog[]
|
|
total: number
|
|
page: number
|
|
perPage: number
|
|
}
|
|
|
|
export const fetchAuditLogs = async (filters: AuditLogFilters = {}): Promise<AuditLogPage> => {
|
|
const api = useApi()
|
|
const params: Record<string, string | string[]> = {}
|
|
|
|
if (filters.employee && filters.employee.trim() !== '') params.employee = filters.employee.trim()
|
|
if (filters.from) params.from = filters.from
|
|
if (filters.to) params.to = filters.to
|
|
if (filters.entityType && filters.entityType.length > 0) params['entityType[]'] = filters.entityType
|
|
if (filters.action && filters.action.length > 0) params['action[]'] = filters.action
|
|
if (filters.username && filters.username.trim() !== '') params.username = filters.username.trim()
|
|
if (filters.ip && filters.ip.trim() !== '') params.ip = filters.ip.trim()
|
|
if (filters.device && filters.device.trim() !== '') params.device = filters.device.trim()
|
|
if (filters.page) params.page = String(filters.page)
|
|
if (filters.perPage) params.perPage = String(filters.perPage)
|
|
|
|
return api.get<AuditLogPage>('/audit-logs', params, { toast: false })
|
|
}
|