📝(project) add slides for lrs and ralph

First draft of slides presenting what is an LRS and Ralph.

slides.md

@@ -251,39 +251,371 @@ transition: fade-out
 5. Tenir une documentation utilisateur à jour (en complément du profil publié
    pour un profil officiel ou privée pour un profil non publiée)
 
+---
+layout: section
+transition: fade-out
+---
+
+# Le *Learning Record Store* (LRS)
+
+
+---
+transition: fade-out
+---
+
+# Comment stocker les traces d'apprentissages ?
+
+Dans une base de données ?
+
+Besoins de : 
+- **Centraliser** ces traces à un même endroit
+- Pouvoir les **rendre disponible** à d'autres services (outil de *data visualization*)
+
+<br>
+
+<div align="center">
+```mermaid {scale: 1}
+flowchart TD
+    lms("LMS 1 🎓") -- xAPI --> db["DB ?"]
+    lms2("LMS 2 🎓") -- xAPI --> db
+    marsha("Vidéo 🎬") -- xAPI --> db
+    ashley("Forum 💬") -- xAPI --> db
+    other("...") -- xAPI -->  db
+    db --> dataviz("Dataviz 📈") 
+```
+</div>
 ---
 transition: fade-out
 ---
 
 # Le standard LRS
 
+ADL avec la spécification xAPI, définit le Learning Record Store (LRS)
+
+<div align="center">
+
+```mermaid {scale: 1}
+flowchart TD
+    subgraph LRS
+        lrs("API HTTP") --> db[(DB)]
+    end
+
+    lms("LMS 1 🎓") -- xAPI --> LRS
+    lms2("LMS 2 🎓") -- xAPI --> LRS
+    marsha("Vidéo 🎬") -- xAPI --> LRS
+    ashley("Forum 💬") -- xAPI --> LRS
+    other("...") -- xAPI -->  LRS
+    LRS --> dataviz("Dataviz 📈") 
+```
+</div>
 
 ---
 transition: fade-out
 ---
 
-# Ralph, le serveur LRS opensource de FUN 
+# Le standard LRS (2)
+
+Le LRS est "un serveur (i.e. un système capable de recevoir et de traiter des requêtes web) qui est responsable de la réception, du stockage et de l'accès aux Learning Records." 
+
+<div class="grid grid-cols-2 gap-4">
+<div>
+
+Ce standard  définit :
+- l'authentification et les permissions
+- la validation des requêtes
+- la validation des données entrantes
+- la détection de conflits
+- la manière de filtrer et rechercher des *Learning Records*
+- le format de restitution
 
+Le LRS est généralement *headless*
+
+</div>
+
+<div>
+
+<br>
+<br>
+<img style="max-width: 60%; float: right" src="/images/public/qr-spec-lrs.png" />
+
+</div>
+</div>
 
 ---
 transition: fade-out
 ---
 
+# Plusieurs APIs
+
+Un LRS définit plusieurs API (ou endpoints)
+
+L'endpoint principal :
+
+- `statements` pour les traces d'apprentissages au format xAPI
+
+D'autres endpoints permettent de stocker des documents, afin d'enrichir ces traces :
+- `agents` et `agents/profile` : informations identifiantes d'un agent
+- `activities`, `activities/profile` et `activities/state` : description d'une activité, de l'état d'un agent sur une activité
+- `about` : informations sur le LRS
+- `extensions/"votreextension"` : pour d'autres ressources non définies par la spécification 
+
+---
+transition: fade-out
+---
+
+# Total Learning Architecture (TLA)
+
+L'apprentissage est un processus permanent : il doit se faire partout, sous toutes ses formes et tout au long de la vie
+
+<div class="grid grid-cols-2 gap-4">
+<div>
+
+### La TLA, c'est :
+- les traces d'apprentissages (**xAPI et LRS**)
+- un index des activités pédagogiques (**XI**)
+- un référentiel de compétences
+- un profil apprenant
+
+<br>
+
+### 3 types de LRS :
+1. *Noisy LRS*
+2. *Transactional LRS*
+3. *Authoritative LRS*
+
+</div>
+<div>
+
+### 5 niveaux de maturité :
+1. adoption locale d'xAPI
+2. xAPI à plus grande échelle
+3. activités pédagogiques <-> compétences 
+4. apprenants <-> compétences (LRS transactionnel et LRS d'autorité)
+5. valorisation des données apprenants
+
+</div>
+</div>
+
+---
+layout: section
+transition: fade-out
+---
+
+# Ralph, le LRS de FUN
+
+---
+transition: fade-out
+---
+
+# Ralph : le contexte  
+
+<div align="center">
+
+```mermaid {scale: 1}
+flowchart TB
+    openedx(Open edX - LMS 🎓) -- edX --> graylog
+    openedx -- edX --> swift
+    subgraph legacy
+    swift[(Swift)]
+    ll(Learning Locker - LRS) -- xAPI --> mongo[(MongoDB)]
+    end
+    marsha(Marsha 🎬) -- xAPI --> graylog[(Graylog)]
+    marsha -- xAPI --> ll
+    ashley(Ashley 💬) -- xAPI --> graylog
+```
+
+</div>
+
+---
+transition: fade-out
+---
+
+# Le plan
+
+- Mise en place d'un *data lake* basé sur Elasticsearch, dédié *learning analytics*
+- Développer un outil Python capable de récupérer et de transformer des données à partir de différents backends
+- Développer un outil qui tient la charge importante chez FUN (bonne scalabilité)
+
+---
+transition: fade-out
+---
+
+# Avancement actuel
+
+<br>
+
+<div align="center">
+
+```mermaid
+flowchart LR
+    openedx(Open edX - LMS) -- edX --> graylog
+    marsha(Marsha 🎬) -- xAPI --> graylog
+    ashley(Ashley 💬) -- xAPI --> graylog
+    graylog[(Graylog)] -- GELF --> ralph(Ralph) -- xAPI --> es[(Elasticsearch)]
+```
+
+```mermaid
+flowchart LR
+    openedx(Moodle - LMS) -- xAPI --> ralph(Ralph)
+    ralph -- xAPI --> es[(Elasticsearch)]
+```
+
+</div>
+
+---
+transition: fade-out
+---
+
+# Ralph LRS
+
+Les caractéristiques de Ralph :
+
+- Entièrement open source
+- Basé sur [FastAPI](https://fastapi.tiangolo.com/)
+- Backends compatibles  : Elasticsearch, MongoDB, ClickHouse
+- Support du *forwarding* des traces
+- Bonne scalabilité
+- Support de HTTP Basic Auth et OpenIDConnect
+- Choix de ne pas développer tous les aspects de la spécification LRS
+- *headless*, sans interface graphique, et sans *data visualization*
+
+---
+transition: fade-out
+---
+
+#  Ralph CLI
+
+
+- Validation ou conversion des traces dans différents standards
+- Lecture/Ecriture des traces dans différentes bases de données/serveurs
+- Aide à la configuration du LRS
+
+<br>
+
+<div class="grid grid-cols-2 gap-4">
+<div>
+
+```
+Usage: ralph [OPTIONS] COMMAND [ARGS]...
+
+  The cli is a stream-based tool to play with your logs.
+
+Commands:
+  auth       Generate credentials for LRS HTTP basic authentication.
+  convert    Convert input events to a given format.
+  extract    Extract input events from a container format using a...
+  list       List available documents from a configured data backend.
+  read       Read records matching the QUERY (json or string) from a...
+  runserver  Run the API server for the development environment.
+  validate   Validate input events of given format.
+  write      Write an archive to a configured backend.
+```
+
+</div>
+
+<div>
+
+
+Exemple : afficher le top 100 des agents qui ont générés le plus d'évènements 
+
+```
+ralph read --backend swift 20231023.xapi.gz | \
+    jq .actor.account.name | \
+    sort | \
+    uniq -c | \
+    sort -rn | \
+    head -n 100
+```
+
+</div>
+</div>
+
+---
+transition: fade-out
+---
+
+# Ralph - Librairie
+
+Un outil CLI c'est pratique, mais écrire du code Python c'est mieux !
+
+Dans quel but ?
+- Facilite l'intégration/l'adoption des développeurs
+- Maintenabilité
+- Utilisable dans des notebooks Jupyter
+
+<br>
+
+#### Modèles xAPI et edX
+
+- intégrable dans les *Learning Record Providers*, facilite la génération de traces
+- utilisation des convertisseurs de modèles (edX en xAPI)
+
+<br>
+
+#### Backend LRS
+
+- intégrable dans les *Learning Record Consumer*, comme les outils de *data visualization* : Warren 📈
+---
+transition: fade-out
+---
+
+## Ralph v4
+
+Released en 01/2024 🎉
+
+- Ajout support du multitenant
+- Unification des backends
+- Refonte de la documentation
+- Ajout de nouveaux profils xAPI
+- Ajout de nouveaux convertisseurs format edX en format xAPI
+- Ajout d'un backend "LRS", pour requêter facilement un LRS depuis Python (utilisé dans Warren 📈)
+
+## Ralph v5 - pour 2024.3
+
+- Architecture plugin : flexibilité pour l'ajout de nouveau backend
+- Utilisation de Pydantic v2 pour les modèles
+
+---
+layout: full
+transition: fade-out
+---
+
 # Merci de votre attention !
 
-<!-- <div class="grid grid-cols-2 gap-4 credits">
+<br>
+
+<div class="grid grid-cols-3 gap-4 credits">
   <div>
+    🎓
     <a href="https://openfun.github.io/2024-dne-xapi-la-stack/">
       Slides
     </a>
     <br/>
-    <img src="" />
+    <img style="max-width: 95%;" src="/images/public/qr-slides.png" />
+  </div>
+  <div>
+    <logos-github-icon />
+    <a href="https://github.com/openfun/ralph">
+      openfun/ralph
+    </a>
+    <img src="/images/public/qr-repo-ralph.png" />
   </div>
   <div>
     <logos-discord-icon />
-    <a href="https://discord.com/invite/vYx6YWxJCS">
+    <a href="https://discord.gg/yzaGJ4r6">
       OpenFUN
     </a>
-    <img src="/images/openfun-discord-invite.png" alt="OpenFUN Discord invitation"/>
+    <img src="/images/public/openfun-discord-invite.png" alt="OpenFUN Discord invitation"/>
   </div>
-</div> -->
+</div>
+
+<style>
+.credits {
+  margin-top: 1rem;
+  text-align: center;
+}
+.logo {
+  display: block;
+  margin: 1rem auto 0;
+}
+</style>