Guides de création

Les Guides de création sont des tutoriels pas-à-pas, publiés sur le portail Bookings. Chaque guide décrit comment utiliser une ressource : machine à bois, imprimante 3D, salle de créativité, etc. Vos membres les consultent à l'adresse https://<votre site>/bookings-ui/creation-guides.

Activer les guides de création

1. Ouvrez les Paramètres de réservation de ressources, onglet Portail client, section Paramètres avancés.
2. Cochez Activer le guide de création. La case est cochée par défaut.
3. Enregistrez.

Cette case affiche le lien Guides de création dans le menu du portail. Elle ne masque pas les guides dans le bureau, et ne bloque pas l'adresse /bookings-ui/creation-guides.

Créer un guide

Depuis le bureau Dokos

1. Dans la barre de recherche, tapez « Guide de création de réservation » et ouvrez la liste.
2. Cliquez sur Ajouter.
3. Renseignez les informations principales :

4. Associez les Ressources concernées par ce guide (par exemple : Fraiseuse CNC, Imprimante laser).
5. Listez les Fournitures avec, si besoin, des fichiers joints (gabarits, plans…).
6. Ajoutez des Co-éditeurs pour permettre à d'autres utilisateurs de modifier le guide.

Depuis le portail

Un utilisateur qui a le droit de créer des guides voit le bouton Nouveau guide dans la liste des guides du portail. Par défaut, ce droit est donné aux rôles System Manager, Fablab Manager et Customer : vos clients connectés au portail peuvent donc créer des guides. Retirez ce droit dans le gestionnaire de rôles si vous ne le souhaitez pas.

L'auteur, les co-éditeurs et les rôles System Manager et Fablab Manager voient le bouton Modifier sur la page du guide. Si le guide est Ouvert aux modifications communautaires, les autres membres connectés peuvent proposer des modifications. L'auteur, les co-éditeurs et ces rôles les acceptent ou les refusent depuis le bouton Suggestions de l'éditeur.

Publier ou dépublier

Changez le Statut du guide. Pour publier, le guide doit avoir un Résumé, au moins une partie et au moins une étape. À la première publication, Dokos renseigne le champ Publié le.

Un guide au statut Brouillon ou Archivé n'est pas visible par les membres. Seuls son auteur, ses co-éditeurs et les rôles System Manager et Fablab Manager le voient sur le portail.

Structurer le contenu d'un guide

Chaque guide est organisé en grandes parties qui contiennent des étapes détaillées.

      
flowchart TD
    G[Guide] --> S1[Partie 1 : Préparation]
    G --> S2[Partie 2 : Utilisation de la machine]
    G --> S3[Partie 3 : Nettoyage]
    S1 --> E1[Étape 1 : Vérifier les EPI]
    S1 --> E2[Étape 2 : Préparer le matériau]
    S2 --> E3[Étape 3 : Régler la vitesse]
    S2 --> E4[Étape 4 : Lancer l'usinage]
    S3 --> E5[Étape 5 : Aspirer les copeaux]

    

Pour chaque étape, vous pouvez ajouter :

• du texte enrichi (instructions, conseils de sécurité) ;
• des images illustrant l'opération ;
• des pièces jointes.

Consulter les guides sur le portail

Liste des guides

La liste affiche les guides publiés. Le membre peut :

• rechercher un guide par son texte ;
• filtrer par Difficulté et par ressource (Filtrer par ressource) ;
• n'afficher que ses guides favoris (Mes favoris) ;
• trier les guides : Les plus récents, Les plus consultés, Les plus favoris ou Alphabétique.

Page d'une ressource

Sur la fiche d'une ressource dans le portail, la section Guides de création liste les guides publiés associés à cette ressource. Un lien ouvre la liste des guides filtrée sur cette ressource.

Lecture d'un guide

La page d'un guide affiche :

• une barre de progression des étapes terminées ;
• un bouton par étape pour la marquer comme terminée, si le membre est connecté ;
• les ressources associées et les fournitures nécessaires ;
• un compteur de favoris : un clic sur le cœur ajoute le guide aux favoris du membre connecté.

Mode diaporama

Le bouton Diaporama affiche le guide en plein écran. Chaque partie commence par une diapositive de titre, puis chaque étape a sa diapositive. Une étape trop longue est répartie sur plusieurs diapositives. Les flèches du clavier permettent de passer d'une diapositive à l'autre. Le bouton Quitter ferme le diaporama.

Ce mode sert par exemple à projeter les instructions à côté d'une machine pendant un atelier.

Télécharger un guide en PDF

Sur la page du guide, le bouton Imprimer génère un PDF au format A4 dans le navigateur, puis le télécharge.

• Le PDF est fait de captures d'image de la page. Le texte n'est pas sélectionnable.
• Dokos place chaque bloc (couverture, résumé, ressources, fournitures, chaque partie) entier sur une page. Un bloc plus haut qu'une page A4 peut être tronqué : découpez les parties trop longues.
• Si des fichiers sont joints aux fournitures, le téléchargement produit une archive .zip. Elle contient le PDF et un dossier Files avec les fichiers des fournitures.

Flux complet

      
sequenceDiagram
    participant Admin
    participant Dokos
    participant Portail
    participant Membre

    

Questions fréquentes

Peut-on avoir plusieurs auteurs sur un guide ? Oui. Ajoutez des co-éditeurs dans la table Co-éditeurs. Ils peuvent modifier le guide depuis le bureau ou le portail.

Un guide archivé est-il encore accessible ? Seuls les guides au statut Publié sont visibles par les membres. Les guides Archivés restent visibles dans le bureau, et sur le portail pour leur auteur et leurs co-éditeurs.

Peut-on associer un guide à plusieurs ressources ? Oui. La table Ressources du guide accepte plusieurs lignes. Le guide apparaît sur la fiche de chacune de ces ressources.