# Structure détaillées ## 1. **Classe Abstraite : `M5lib`** Classe de base commune à tous les types de M5. Elle définit les fonctionnalités fondamentales. #### Fonctions membres
FonctionRôle
`setupstd()`Effectue l'initialisation matérielle commune : écran, Wi-Fi, RFID, UHF. Attention : la fonction est lboquante tant que le M5 n'est pas connecté au réseau prédéfinit.
`reducejson(String json)`Réduit et structure le JSON de réponse de l’API TimeTonic pour simplifier l’accès aux champs utiles. Ne garde que le contenu de "fields" (endroit où est stocké entre autres les données demandées) et "rowInfos" (qui contient notamment le rowId des informations demandées)
`scancard()`Scanne une carte RFID classique, retourne l’UID du tag sous forme de String. Contient une UI intégrée. Attention : la fonction est bloquante tant qu'elle n'a pas lu une carte.
`scanuhf(String* urfid)`Scanne les tags RFID UHF via le module UHF externe, remplit le tableau passé en paramètre avec les EPC lues (max 200 EPC, ce qui est le max supporté par le module RFID UHF). Fonction actuellement inutilisée dans le code.
`showchoice(String choices[])`Affiche sur l’écran un menu de sélection contenant les String du tableau passé en paramètre : l’utilisateur peut naviguer puis valider un choix(jusqu’à 9 options), qui est retourné sous forme de String.
`virtual int uploadlog(String card, String action, String other) = 0`Méthode virtuelle pure pour uploader un log dans la table correspondante au type de M5. Prend en paramètre une carte lue, l'action effectuée par l'utilisateur et un agument optionnel (au choix, le motif de la visite, l'ordinateur ou l'outil emprunté).
`virtual int changestatus() = 0`Méthode virtuelle pure pour changer le statut d'emprunt/de présence (obsolète pour le moment car remplacé par automatisation TimeTonic).
`getuser(String* user)`Lance un scan RFID (avec scancard() ), puis interroge l’API TimeTonic pour récupérer le nom, prénom, et rowId de l'utilisateur scanné. Peuple ensuite le tableau passé en paramètre : \[nom, prénom, tag RFID, rowId\].
`borrow()`Gère tout le cycle d’emprunt et retour d’un matériel/machine/ordinateur : identification (avec un appel getuser() ), log (avec un appel uploadlog() ), et contrôle utilisateur (gestion par l'utilisateur de la durée de son emprunt, avec à nouveau un scan de carte et un upload de log à la fin de l'emprunt. Boucles if/else à chaque étape du cycle pour gérer chaque type d'erreur (API, utilisateur inconnu, etc...).
##### Attributs - `user[4]` : tableau de String contenant toutes les informations d'un utilisateur : \[nom, prénom, tag RFID, rowId\]. - `urfid[200]` : tableau de String pouvant contenir jusqu'à 200 EPC. - `sesskey` : permet de modifier simplement et directement la clé d'API pour toutes les requêtes de la bibliothèques (en cas d'expiration par exemple) ## 2. **Classes Dérivées** Chaque classe dérivée apporte des fonctionnalités propres à chaque typologie de M5 dans le FabLab. #### a. **Classe : `accueil`** Ajoute des méthodes spécifiques à la gestion d’accueil.
FonctionRôle
`int uploadlog(...) override`Upload des logs d’accueil à l’API avec les bons id (table, champs...).
`int changestatus() override`Change le statut d’accueil (placeholder : actuellement valeur fixe pour compatibilité).
`void entree()`Gère la procédure d’entrée : identification (avec getuser), choix du motif de visite (avec showchoice), upload du log d’arrivée (avec uploadlog)
`void sortie()`Gère la sortie d’un utilisateur (avec getuser) et log cet évènement (avec uploadlog).
`void regcard()`Enregistre une nouvelle carte RFID (avec un scancard puis une requete d'API spécifique) pour un utilisateur après inscription sur Timetonic (liaison rangée TimeTonic <-> badge RFID). La requête d'API récupère la dernière rangée créée avec une vue filtrée (vue chronologique dans TimeTonic), il faut donc faire l'association de carte immédiatement après l'inscription.
##### Attributs spécifiques `String motifs[9]`: Liste des motifs de visite disponibles à la sélection (préremplie pour plus de simplicité).`String name` : nom du M5, permet de définir l'action d'accueil effectuée : entrée, sortie ou 1ère inscription. #### b. **Classe : `servante`** Pour la traçabilité de l’usage des servantes.
FonctionRôle
`int uploadlog(...) override`Upload des logs liés à l’utilisation d’une servante (carte, action, ""). L'argument other ne sert pas pour les servantes.
`int changestatus() override`Change le statut de la servante (obsolète, pour compatibilité).
##### Attributs spécifiques - `String rowid`: id de la rangée de cette servante dans la table Servantes du book Inventaire dans TimeTonic (unique à chaque servante, et donc chaque appareil, voir table d'équivalence dans la doc privée). - `String name` : nom du M5, permet de définir la servante concernée dans les logs. #### c. **Classe : `machine`** Gère l’utilisation des machines/outils fixes.
FonctionRôle
`int uploadlog(...) override`Upload logs liés à l’utilisation d’une machine (carte utilisateur, action).
##### Attributs spécifiques - `String rowid`: id de la rangée de cette machine dans la table Machines du book Inventaire dans TimeTonic (unique à chaque machinr, et donc chaque appareil, voir table d'équivalence dans la doc privée). - `String name` : nom du M5, permet de définir la machine concernée dans les logs. #### d. **Classe : `ordinateur`** Gère le suivi de l'emprunt des ordinateurs portables.
FonctionRôle
`int uploadlog(...) override`Upload logs spécifiques à l’usage d’un ordinateur (par exemple : session ouverte/fermée).
##### Attributs spécifiques - WIP #### e. **Classe : `materiel`** Gère les cycles d’emprunt et de retour d’outillage ou matériel divers.
FonctionRôle
`int uploadlog(...) override`Upload logs liés à l’utilisation (emprunt/retour) de matériels.
##### Attributs spécifiques - WIP ## 3. **Utilisation de méthodes virtual / override** Les méthodes `uploadlog` et `changestatus` sont définies comme `virtual` dans la base, et nécessaires à la personnalisation du comportement selon chaque situation FabLab : chaque classe dérivée implémente les appels API avec les bons identifiants et formats de données. Avec cette structure, chaque fonction de **M5lib** remplit un rôle précis dans la gestion, la traçabilité, l’ajout de dispositifs et l’intégration back-end dans l’écosystème du FabLab.