REDCap Dashboard

Dashboard SvelteKit pour collecter, actualiser et visualiser les logs d'audit REDCap.

L'application consomme @univ-lehavre/atlas-crf-logs pour lire les tokens projet, récupérer les logs REDCap, les enrichir et calculer des agrégations calendaires. Elle affiche des statistiques mensuelles et fournit une page d'actualisation avec progression, dates et statut détaillé.

Il affiche 4 graphiques:

• Utilisateurs loggés
• Projets actifs
• Actions totales
• Actions par catégorie

Le tableau de bord permet de filtrer l’affichage sur:

• les 6 derniers mois
• la dernière année
• tout l’historique

Il propose aussi une page dédiée à l’actualisation: /actualisation (spinner, progression, dates et état OK / WARN / ERROR).

Prérequis

• Node.js >= 24
• pnpm
• Monorepo Atlas cloné (ce package dépend de @univ-lehavre/atlas-crf-logs)

Installation

Depuis la racine du monorepo:

pnpm install

Configuration

1) Variables d'environnement

Dans apps/crf-dashboard/.env:

REDCAP_API_URL=https://redcap.univ-lehavre.fr/api/

Le fichier .env.example fournit ce même modèle.

2) Tokens projets REDCap

Le dashboard lit les tokens dans le fichier racine du repo:

/redcap-token.csv

Format CSV attendu:

project_id,token
123,xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
456,yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy

Lancer en développement

Depuis la racine du monorepo:

pnpm --filter @univ-lehavre/atlas-crf-dashboard dev

Puis ouvrir l'URL affichée par Vite (souvent http://localhost:5173).

Build et preview

pnpm --filter @univ-lehavre/atlas-crf-dashboard build
pnpm --filter @univ-lehavre/atlas-crf-dashboard preview

Scripts utiles

pnpm --filter @univ-lehavre/atlas-crf-dashboard lint
pnpm --filter @univ-lehavre/atlas-crf-dashboard check
pnpm --filter @univ-lehavre/atlas-crf-dashboard typecheck
pnpm --filter @univ-lehavre/atlas-crf-dashboard format

Fonctionnement de la collecte

• Le bouton "Actualiser depuis REDCap" ouvre un flux SSE sur GET /api/logs.
• La page /actualisation permet de suivre l’état global de la collecte et l’historique des dates importantes.
• Les projets sont collectés par lots (BATCH_SIZE = 3) et l'UI reçoit la progression en temps réel.
• Les données sont enrichies puis converties en série temporelle mensuelle (calendrier).
• Un cache local est utilisé dans le dossier courant de lancement: ./.crf-stats.json.
• TTL du cache: 24h. Si le cache est récent, l'API renvoie immédiatement l'état cached.

Types d'événements SSE émis:

• start
• progress
• cached
• done
• error

Notes

• Les tokens REDCap sont sensibles: ne pas versionner redcap-token.csv.
• Le dashboard fonctionne avec l'adapter Node (@sveltejs/adapter-node).