bySince
DOCUMENTATION

BySince - Principes d'organisation et de structuration

Ce document présente les grands principes d'organisation de l'application BySince : comment les contenus sont structurés, quels sont les différents niveaux hiérarchiques et comment ils s'articulent entre eux.


Vue d'ensemble de la hiérarchie

L'application est organisée selon une arborescence à 6 niveaux :

Organisation
  └── Contexte 
        └── Thème
              └── Fiche d'activité
                    └── Sous-activité
                          └── Mode opératoire

Chaque niveau contient le suivant. Cette structure permet d'organiser les contenus de manière logique, du plus général au plus détaillé.


1. L'Organisation

L'Organisation est le niveau le plus haut. Elle représente l'entreprise ou la structure cliente.

Chaque organisation possède :

  • Un nom et une description
  • Un logo et une image de couverture
  • Des couleurs personnalisées (couleur principale, secondaire, complémentaire) qui définissent l'identité graphique de l'application
  • Ses propres utilisateurs, contenus et paramètres

Point clé : Chaque organisation est indépendante. Les contenus d'une organisation ne sont pas visibles par les autres.


2. Les Contextes

Un Contexte est le premier niveau de classement à l'intérieur d'une organisation. Il permet de regrouper les thèmes par domaine.

Caractéristiques :

  • Un contexte possède un nom
  • Les contextes peuvent être hiérarchiques : un contexte peut avoir des sous-contextes (contextes enfants)
  • Un contexte contient un ou plusieurs thèmes

Exemple : Une petite entreprise pourrait avoir les contextes "RESSOURCES HUMAINES", "COMMUNICATION". On pourrait supposer qu'il peut y avoir un deuxiéme niveau de contexte, (ex: COMMUNICATION INTERNE, COMMUNICATION EXTERNE)

Exemple de contextes

3. Les Thèmes

Un Thème regroupe des fiches d'activité autour d'un même sujet.

Caractéristiques :

  • Un thème possède un nom, une description, une image et une couleur
  • Les thèmes sont numérotés pour définir leur ordre d'affichage
  • Un même thème peut appartenir à plusieurs contextes
  • Chaque thème contient une ou plusieurs fiches d'activité

Exemple : Dans le contexte "COMMUNICATION INTERNE", on pourrait avoir les thèmes "Réseaux Sociaux", "Evénenements".

Exemple de thèmes

4. Les Fiches d'activité

La Fiche d'activité est l'élément central de BySince. C'est le document principal que les collaborateurs consultent et sur lequel ils progressent.

Caractéristiques :

  • Une fiche possède un nom, un objectif, un public cible ("pour qui"), un savoir-faire et des médias
  • Une fiche peut être en brouillon (non publiée) ou publiée (visible par les collaborateurs)
  • Une fiche possède un ordre d'affichage au sein de son thème
  • Le système de verrouillage empêche deux personnes de modifier la même fiche simultanément
  • Des propriétaires peuvent être désignés pour restreindre l'édition

Chaque fiche d'activité contient une ou plusieurs sous-activités.

Exemple de fiche d'activité

5. Les Sous-activités

Une Sous-activité découpe la fiche d'activité en étapes ou parties logiques.

Caractéristiques :

  • Une sous-activité possède un nom
  • Les sous-activités sont ordonnées par position au sein de la fiche
  • Chaque sous-activité contient un ou plusieurs modes opératoires

Exemple : Pour l'activité "Préparer un recrutement", les sous-activités pourraient être "Préparer une offre d'emploi", ...


6. Les Modes opératoires

Le Mode opératoire est le niveau le plus détaillé. Il décrit une action ou une procédure précise.

Caractéristiques :

  • Un mode opératoire possède un nom, un objectif ("pourquoi"), des astuces et des erreurs à éviter
  • Il peut contenir un média : image, vidéo ou PDF
  • Les modes opératoires sont ordonnés par position au sein de la sous-activité
  • C'est à ce niveau que la progression de l'apprenant est enregistrée

Les Ressources

Les Ressources sont des documents ou liens complémentaires (fichiers PDF, liens web, vidéos...) qui peuvent être attachés à différents niveaux :

  • À une fiche d'activité
  • À une sous-activité
  • À un mode opératoire

Caractéristiques :

  • Une ressource possède un libellé, une description, une URL ou un fichier et une source
  • Les ressources sont gérées de manière centralisée au niveau de l'organisation
  • Une même ressource peut être partagée entre plusieurs fiches

Les Composants personnalisés

Les Composants permettent d'ajouter des contenus personnalisés au-delà des champs standards. Ils peuvent être ajoutés à trois niveaux :

  • Sur une fiche d'activité
  • Sur une sous-activité
  • Sur un mode opératoire

Les types de composants disponibles et leurs attributs sont configurables par l'administrateur.


Les Parcours d'apprentissage

Un Parcours d'apprentissage permet d'organiser un ensemble de fiches d'activité dans un ordre précis, à destination d'un ou plusieurs apprenants.

Caractéristiques :

  • Un parcours possède un nom et une description
  • Il contient une liste ordonnée de fiches d'activité (qui peuvent provenir de thèmes différents)
  • Il peut être activé ou désactivé
  • Il peut être archivé
  • Des apprenants sont inscrits avec une date de début et une date de fin optionnelle

Le suivi de la progression se fait au niveau de chaque mode opératoire avec 4 états possibles :

État Signification
À faire L'apprenant n'a pas encore traité ce point
Maîtrisé L'apprenant maîtrise ce point
Compris L'apprenant a compris mais doit encore pratiquer
À revoir L'apprenant doit revoir ce point

Les Utilisateurs et les Rôles

Rôles principaux

Les utilisateurs de BySince sont organisés selon une hiérarchie de rôles :

Rôle Description
Collaborateur Consulte les fiches d'activité et progresse dans les parcours
Consultation Consulte l'intégralité de la plateforme en lecture seule (thèmes, activités y compris les brouillons) sans pouvoir modifier ni administrer
Admin Gère les contenus (fiches, thèmes, parcours) et les utilisateurs de son organisation
Super Admin Accès complet à toutes les fonctionnalités d'administration

Identification

  • Chaque utilisateur possède un identifiant unique
  • L'email est optionnel et peut être partagé entre plusieurs comptes
  • La connexion se fait par identifiant + mot de passe

Sécurité

  • Le mot de passe doit être changé tous les 2 mois
  • L'authentification à deux facteurs (2FA) peut être activée (via application TOTP ou par email)
  • Les appareils de confiance peuvent être enregistrés pour simplifier la connexion

Profils et Droits

Au-delà des rôles, un système de profils et de droits permet un contrôle fin des permissions :

  • Un profil regroupe un ensemble de droits (permissions fonctionnelles)
  • Chaque utilisateur peut avoir un ou plusieurs profils
  • Les droits sont vérifiés pour chaque action dans l'application

Les Groupes d'utilisateurs

Les Groupes permettent de regrouper des utilisateurs pour faciliter la gestion des accès et des inscriptions aux parcours.


Schéma récapitulatif

┌─────────────────────────────────────────────────────┐
│                   ORGANISATION                      │
│                                                     │
│  ┌─────────────┐  ┌─────────────┐  ┌────────────┐   │
│  │  Contexte 1 │  │  Contexte 2 │  │ Contexte 3 │   │
│  └──────┬──────┘  └──────┬──────┘  └─────┬──────┘   │
│         │                │               │          │
│    ┌────┴────┐     ┌─────┴────┐    ┌─────┴────┐     │
│    │ Thème A │     │ Thème B  │    │ Thème C  │     │
│    └────┬────┘     └────┬─────┘    └────┬─────┘     │
│         │               │               │           │
│   ┌─────┴─────┐   ┌────┴─────┐   ┌─────┴─────┐      │
│   │ Activité 1│   │Activité 2│   │ Activité 3│      │
│   └─────┬─────┘   └────┬─────┘   └─────┬─────┘      │
│         │               │               │           │
│  ┌──────┴──────┐  ┌─────┴─────┐  ┌──────┴──────┐    │
│  │Sous-activité│  │Sous-activ.│  │Sous-activité│    │
│  └──────┬──────┘  └─────┬─────┘  └──────┬──────┘    │
│         │               │               │           │
│  ┌──────┴──────┐  ┌─────┴─────┐  ┌──────┴──────┐    │
│  │   Mode de   │  │  Mode de  │  │   Mode de   │    │
│  │fonctionnem. │  │fonctionn. │  │fonctionnem. │    │
│  └─────────────┘  └───────────┘  └─────────────┘    │
│                                                     │
│  ┌──────────────────────────────────────────────┐   │
│  │           Parcours d'apprentissage           │   │
│  │  Activité 1 → Activité 3 → Activité 2        │   │
│  │    Apprenant A (du 01/03 au 30/06 )          |   |
│  │    Apprenant B (du 15/03 au 15/07)           |   │
│  └──────────────────────────────────────────────┘   │
│                                                     │
│  ┌──────────┐  ┌──────────┐  ┌──────────────────┐   │
│  │Ressources│  │Utilisat. │  │Profils & Droits  │   │
│  │partagées │  │& Groupes │  │                  │   │
│  └──────────┘  └──────────┘  └──────────────────┘   │
└─────────────────────────────────────────────────────┘

Principes clés à retenir

  1. Hiérarchie stricte : chaque élément appartient à un parent (sauf l'Organisation qui est au sommet)
  2. Multi-langue : tous les contenus (contextes, thèmes, fiches, sous-activités, modes opératoire) supportent la traduction
  3. Isolation des données : chaque organisation est un espace indépendant
  4. Ressources transversales : les ressources sont gérées au niveau de l'organisation et peuvent être attachées à n'importe quel niveau de contenu
  5. Parcours personnalisés : les parcours d'apprentissage permettent de créer des itinéraires sur mesure en combinant des fiches de thèmes différents
  6. Progression granulaire : le suivi de progression se fait au niveau le plus fin (mode opératoire)