Tutoriels guidés & prise en main

Où le trouver et de quoi il s'agit

Ouvrez Projet (la première entrée du rail de navigation de gauche, et l'onglet sur lequel l'application s'ouvre), puis faites défiler sous le navigateur de projets : la section Tutoriels interactifs liste chaque visite sous forme de carte. Il n'y a ni page de tutoriels ni entrée du rail dédiée ; l'ancienne adresse /tutorials fonctionne toujours et mène simplement à l'onglet Projet.

En haut de la section, vous verrez le titre Tutoriels interactifs et une explication d'une ligne : « Apprenez à utiliser pvSpline pas à pas. Chaque tutoriel explique tout en mode Guidé ; les tutoriels d’entraînement proposent aussi les modes Défi et Expert, chronométrés et notés. » Dessous se trouve l'étagère Badges : les badges que vous avez obtenus et un aperçu de la mascotte qui les porte (La mascotte et les badges).

En dessous, les cartes de tutoriel, une par visite disponible, sont dessinées comme les cartes de projet au-dessus d'elles et réparties en quatre sections étiquetées. La section est purement un lanceur : vous parcourez le catalogue ici, puis vous cliquez sur un bouton de lancement et la visite prend la main sur la page, pilotant les vues ordinaires de l'application.

Le catalogue de tutoriels

Les cartes sont regroupées, de haut en bas, en quatre parcours :

Premiers pas

L'unique visite de présentation générale, Votre première simulation. Suivez-la en premier : elle parcourt l'intégralité du flux de saisie de bout en bout afin que le reste de l'application prenne tout son sens.

Explorer les onglets

Une visite ciblée d'« exploration approfondie » par onglet du rail, dans l'ordre du rail : Onglet Projet, Onglet Consommation, Onglet Carte, Onglet Lots, Onglet Production, Onglet Schéma, Onglet 3D, Onglet Vidéo, Onglet Résultats, Le rapport et Onglet Catalogue. Chacune s'ouvre sur la vue correspondante et en explique les cartes et les contrôles.

Outils et compte

Les pages d'outils et votre compte, réglages compris : Outil de prédimensionnement et Compte et cloud.

Entraînement

Deux simulations complètes et réalistes que vous construisez vous-même (Simulation maison et Simulation usine) et Redonner le sourire à la mascotte, une courte visite où la mascotte se tient à côté de la bulle, aussi mal en point que son projet, et où vous la soignez, une correction par étape (La mascotte et les badges). Ce sont les visites notées : vous faites le travail avec un minimum d'aide et gagnez des étoiles.

Chaque visite est listée avec son nombre d'étapes, sa durée estimée et ses objectifs dans Référence des champs.

Lire une carte de tutoriel

Chaque carte affiche, en un coup d'œil :

• une icône : le glyphe du rail de l'onglet qu'une exploration approfondie enseigne, ou un emoji (un soleil, une équerre, une silhouette, une maison, une usine) pour les autres ;

• le titre et une description d'une ligne ;

• une pastille d'achèvement verte (une coche et Terminé) devant le titre une fois la visite terminée au moins une fois, ou un badge de progression orange tel que 4/11 si vous l'aviez commencée puis quittée en cours de route ;

• une ligne de métadonnées : le nombre d'étapes et une durée estimée, par ex. « 23 étapes · ~7 min ». Ce nombre est celui des étapes que vous montrerait un parcours lancé maintenant, comptées comme les compte sa bulle (Le compteur d'étapes) ;

• une ligne Vous allez apprendre : qui résume les objectifs, séparés par des points (survolez-la pour la liste complète lorsqu'elle est tronquée) ;

• un bandeau inférieur, Démarrer :, avec un bouton de lancement par difficulté prise en charge, précédé, sur une visite quittée en cours de route, de Reprendre · étape N, qui reprend la visite là où vous vous êtes arrêté et, sur une visite proposée à plusieurs difficultés, nomme celle à laquelle il reprend, comme dans Reprendre · étape 5 · Défi (Lancement, relecture et suivi de la progression).

Pour les visites notées, le bouton de lancement de chaque difficulté porte aussi sa propre coche d'achèvement et votre meilleur score sur 100 (par exemple Défi 85/100), afin de voir d'un coup d'œil où vous pouvez progresser. Survoler un bouton de lancement indique ce que fait cette difficulté.

Comment fonctionne une visite guidée

Lorsque vous lancez une visite, un voile assombri recouvre la page et une série d'étapes se déroule. Chaque étape est de l'un des quatre types suivants :

Une étape de leçon

Un projecteur (une découpe lumineuse dans l'arrière-plan assombri, avec une bordure lumineuse et pulsante) désigne un contrôle réel, et une bulle de dialogue, dont la flèche désigne le contrôle, explique ce que vous avez sous les yeux. Vous la lisez, puis cliquez sur Suivant pour continuer. L'assombrissement est purement visuel : vous pouvez toujours survoler le contrôle éclairé et cliquer au travers, jusqu'au vrai bouton situé dessous. La visite navigue vers la bonne vue à votre place lorsqu'une étape de leçon se trouve ailleurs.

Une étape de navigation

Le projecteur se pose sur une entrée du rail et la bulle vous demande de cliquer dessus. Il n'y a pas de Suivant : c'est l'arrivée sur cette vue qui valide l'étape.

Une étape d'action

Le projecteur se pose sur un contrôle (une ligne de graphique dans la liste, une carte de thème, un onglet de l'inspecteur du schéma) et la visite avance dès que vous cliquez dessus. Là encore, il n'y a pas de Suivant ; lorsque le contrôle est absent de la page depuis 1,2 seconde, la bulle propose à la place Passer cette étape, qui avance sans le clic.

Une étape de checkpoint

La bulle énonce un objectif et Suivant reste désactivé tant que le projet ne le satisfait pas réellement. Un checkpoint qui attend qu'une chose s'ouvre ou s'affiche (un projet, un formulaire, un résultat) ne laisse rien à confirmer à Suivant : il avance de lui-même dès qu'il est atteint.

Le projecteur et la bulle suivent leur cible : le voile remesure le contrôle en surbrillance environ quatre fois par seconde, ainsi qu'à chaque défilement ou redimensionnement de la fenêtre, de sorte que la découpe reste sur le bon contrôle lorsque les panneaux défilent, se déplacent ou se réagencent ; la cible est amenée dans le champ de vision à l'ouverture de l'étape, par son haut lorsqu'elle dépasse la hauteur de la fenêtre, de sorte qu'une longue carte s'ouvre sur son titre. La bulle se place sous, au-dessus ou à côté de sa cible, là où elle tient entière, de sorte que ses boutons restent toujours à l'écran, sa flèche sur le bord tourné vers le contrôle. Sur une cible qui remplit la fenêtre (la carte, le rapport), elle se pose plutôt dans le coin inférieur gauche de la cible, à l'écart des barres d'outils et des panneaux du haut, et n'a pas de flèche.

Lorsque le contrôle que désigne une étape n'est pas sur la page, une étape qui prévoit un remplaçant met celui-ci en lumière (le contrôle qui fait apparaître la cible, ou la carte où elle apparaît), et son texte dit quoi y faire. Sinon, la bulle se centre et, une fois le contrôle absent depuis 1,2 seconde (une page encore en cours d'affichage n'est pas un contrôle manquant), ajoute une note discrète. Cette note ne vous envoie jamais chercher le contrôle, car ce qui manque dépend du projet tel qu'il est réglé. Sur une étape de leçon, elle indique « Ce contrôle n'apparaît pas avec le projet tel qu'il est réglé — lisez l'explication, puis continuez avec Suivant. » ; sur un checkpoint pas encore atteint, « Ce contrôle n'apparaît pas encore — l'explication ci-dessus dit comment le faire apparaître. » (en Défi et en Expert, qui n’affichent pas d’explication, « Ce contrôle n’apparaît pas encore : relisez la consigne, ou prenez un indice pour savoir comment le faire apparaître. ») ; sur une étape d'action, « Ce contrôle n'est pas à l'écran pour l'instant. S'il n'apparaît pas, passez cette étape. », à côté de Passer cette étape.

Une étape laisse la page sans voile : l'étape « Placez les coins » de la visite Onglet Carte entoure le bandeau de dessin au bas de la carte et garde sa bulle au-dessus, pour que la toiture que vous tracez reste lisible.

Plusieurs visites construisent leur état au fil du parcours : la visite Lots lance une petite étude pour que ses étapes de résultats aient quelque chose à montrer, et la visite Prédimensionnement calcule un dimensionnement avant de lire le tableau mensuel. Vous cliquez sur le vrai contrôle, l'étape attend ce qu'il produit (les résultats du lot, le résultat du prédimensionnement) et avance d'elle-même, puis la leçon suivante met en lumière ce qui est apparu.

Les checkpoints

Une étape de checkpoint affiche son état sur une ligne à l'intérieur de la bulle :

• « Étape à valider : faites ce qui est demandé ci-dessus pour continuer. » (une case vide, en gris) signifie que l'objectif n'est pas encore atteint ;

• « Étape validée — cliquez sur Suivant pour continuer. » (une coche verte) signifie que l'objectif est atteint.

La condition est réévaluée automatiquement environ toutes les 0,6 seconde pendant que vous travaillez : la ligne passe au vert en direct pendant que vous saisissez ou faites glisser, et peut repasser au gris si vous annulez la modification. Suivant reste grisé tant qu'elle n'est pas validée.

Certains checkpoints n'attendent pas Suivant. L'étape « Ouvrez un projet » par laquelle commence une visite qui travaille sur un projet avance dès qu'un projet est ouvert, que vous ayez ouvert un projet enregistré ou que vous en ayez créé un avec Nouveau projet, qui ouvre le projet qu'il crée. D'autres attendent ce que l'on vous a demandé de provoquer : l'ouverture du formulaire de composant dans la visite Catalogue, chaque résultat de prédimensionnement et le passage au pompage solaire dans la visite Prédimensionnement, les résultats d'un lot dans la visite Lots.

Les checkpoints lisent le projet tel que l’écran le montre : les valeurs des cartes au fil de la saisie, avant que l’onglet ne les écrive. Ils contrôlent donc les valeurs, pas vos frappes au clavier, et un checkpoint passe au vert dès que la dernière valeur est juste. Ainsi, la visite Simulation maison ne vous laissera pas quitter son checkpoint « Paramètres de simulation » tant que le Type de système n’est pas Autoconsommation + revente avec le tarif de revente de la fiche mission ; son checkpoint « Paramètres financiers » attend un coût d’installation de 8 500–9 500 €, le taux de TVA à 5,5 % d’une maison de moins de 9 kWc, une indexation de l’électricité de 1,5–2,5 % par an et un emprunt de 19–21 ans avec le financement par emprunt coché, au taux de la fiche mission. Les tolérances sont volontairement larges : on vous demande un projet réaliste, pas une transcription exacte.

Si vous quittez la page

Vous êtes libre de cliquer un peu partout pendant une visite. Si vous quittez la page sur laquelle vit une étape, la visite ne s'interrompt pas : la bulle devient Cette étape est sur un autre onglet, met en lumière l'entrée du rail de cet onglet et indique « Cliquez sur l'onglet en surbrillance pour y revenir — rien n'est perdu. » Dès votre retour, la véritable étape reprend exactement où elle en était. Tant que cette bulle est affichée, Suivant, Indice et les propositions propres à l'étape (Passer cette étape, Remplir pour moi, Ouvrir le projet de démonstration) sont retirés : revenir est la seule façon d'avancer, même si Retour et Quitter restent disponibles.

La bulle propose aussi Retour à partir de la deuxième étape, qui rejoue la leçon précédente. Les étapes qu'un parcours saute en avançant sont aussi sautées en revenant (une étape de navigation déjà validée, une étape « Ouvrez un projet » une fois un projet ouvert, une étape qui ne s'applique pas) : Retour vous ramène donc à la dernière explication réellement reçue, au lieu de vous renvoyer aussitôt en avant.

Le compteur d'étapes

Le compteur de la bulle, n / N, ne numérote que les étapes que le parcours vous montre. Une étape que le parcours saute n'est pas numérotée : une étape de navigation vers l'onglet où vous êtes déjà, une étape « Ouvrez un projet » déjà satisfaite à l'arrivée (un projet déjà ouvert, ou un projet que la visite ouvre elle-même), et une étape qui ne s'applique pas au projet ouvert ou à votre session, comme une carte que masque le type de système du projet. Les numéros se suivent donc 1, 2, 3 sans trou, et à la dernière étape que le parcours montrera, Suivant devient Terminer.

Le total est établi d'après l'application telle qu'elle est à chaque étape atteinte : il peut donc changer en route quand ce dont dépend une étape change. Connectez-vous pendant la visite Compte et cloud, et ses cartes de compte rejoignent le parcours ; ouvrez un projet dont le type de système masque une carte que couvre la visite Onglet Projet, et l'étape de cette carte sort du compte. Le nombre d'étapes d'une carte et sa pastille de progression suivent la même règle, appliquée à l'application telle qu'elle est quand vous regardez les cartes.

Ce qu'une visite modifie dans votre projet

Rien dans votre dos. Les visites pilotent l'application réelle avec le projet que vous avez ouvert et le lisent pour évaluer les checkpoints ; ce qui y change, c'est ce que vous y faites. Une visite apporte quelque chose qui lui est propre à trois endroits :

• L'étape « Ouvrez un projet » de la visite Premiers pas propose Ouvrir le projet de démonstration : une petite maison à Bordeaux, prête à calculer, qui s'ouvre sans être enregistrée, comme un fichier importé. Elle est seulement proposée : rien ne s'ouvre si vous ne cliquez pas.

• Les deux simulations d'entraînement ouvrent leur propre projet quand vous cliquez sur Suivant à leur accueil (Maison Lefèvre (tutoriel) ou Usine TechnoSud (tutoriel)), et Redonner le sourire à la mascotte ouvre Maison Mascotte dès son lancement. Ces projets s'ouvrent sans être enregistrés, et vos propres projets restent tels quels.

• Lors d'un parcours d'entraînement Guidé, Remplir pour moi saisit dans le projet d'entraînement les valeurs d'une étape, tirées du cahier des charges du client, en une seule modification que vous pouvez annuler (Cibles des checkpoints des visites Entraînement).

Sur le cloud, le calcul d'un projet sans sauvegarde cloud le classe parmi vos projets sous son nom (Où s'exécute le calcul), et les projets des visites ne font pas exception : une fois calculée, la maison de démonstration apparaît parmi vos projets sous Maison de démonstration, un projet d'entraînement sous son propre nom et la maison de la mascotte sous Maison Mascotte. Un compte Direction ou Admin peut en supprimer un depuis sa carte de l'onglet Projet (L'onglet Projet).

Tout le reste de ce qu'une visite vous fait faire s'applique au projet que vous avez ouvert, et y reste. La visite Lots lance réellement la petite étude qu'elle construit : comme tout lot lancé depuis l'onglet Lots, cette exécution enregistre son étude dans le projet ouvert, à la place de toute étude par lots que le projet contenait, celle qu'imprime son rapport PDF. La source qu'ajoute la visite Onglet Consommation et le polygone que la visite Onglet Carte vous fait dessiner restent aussi, jusqu'à ce que vous les supprimiez : le × de l'onglet de la source, Supprimer sur la fiche du polygone.

Niveaux de difficulté

Chaque visite est rédigée une seule fois ; la difficulté que vous choisissez ne change que la façon dont ce même contenu est présenté et noté. Les visites de pure leçon (la présentation générale, les explorations approfondies et les visites des pages d'outils) ne proposent que Guidé. Les deux visites Entraînement proposent les trois, avec Défi par défaut.

Seules les visites Entraînement comportent des indices : sur les quatorze visites de leçon, le bouton Indice n'apparaît jamais.

L'affichage tête haute des sessions notées

Lors des sessions Défi et Expert, un affichage tête haute coiffe la bulle : une rangée sous sa barre de titre qui montre, en temps réel :

• un chronomètre (une icône d’horloge et MM:SS) qui compte votre temps écoulé. Il s’arrête pendant que le serveur travaille pour vous (un calcul en file ou en cours, et la météo du site récupérée avant un premier calcul) et affiche en pause pendant ce temps : ce temps n’est pas le vôtre ;

• un compteur d'indices : le nombre d'indices déjà dévoilés dans la session, sur le nombre que propose toute la visite ;

• votre Score courant sur 100, coloré en vert (≥ 80), orange (50–79) ou rouge (< 50).

Notation et étoiles

La notation est volontairement simple : vous partez de 100 et chaque indice dévoilé retire le coût d'indice de la difficulté (5 en Défi, 10 en Expert), sans jamais descendre sous zéro. Le temps est affiché mais ne réduit pas votre score. À la fin d'une session notée, un panneau de résultats affiche :

• une note en étoiles : trois étoiles pour un score de 80 ou plus, deux étoiles pour 50–79 et une étoile en dessous de 50, les seuils étant rappelés en dessous ;

• la difficulté, le temps total en minutes et secondes, et les indices utilisés sur le total de la visite, avec les points qu’ils ont coûtés entre parenthèses, s’il y en a ;

• votre score final (Score : N / 100) ;

• votre Record personnel pour cette visite et cette difficulté, dès que vous disposez d'un parcours antérieur à comparer ;

• Nouveau badge ! avec le nom et la récompense du badge, lorsque la session en a rapporté un (La mascotte et les badges) ; sinon, les badges qui restent à gagner.

Cliquez sur Terminer pour fermer le panneau. Seule une amélioration par rapport à votre meilleur score précédent est enregistrée : rejouer une visite peut donc augmenter votre record, mais jamais le diminuer. Une session Guidé n'est pas notée et se termine sans panneau de résultats : à la dernière étape, Suivant devient Terminer et ferme simplement le voile.

Lancement, relecture et suivi de la progression

Achèvement et progression.

Les cartes enregistrent, pour chaque visite : si vous l'avez terminée (la pastille d'achèvement devant le titre, et une coche par difficulté sur chaque bouton de lancement), votre meilleur score par difficulté, et, si vous avez quitté une visite en cours de route, l'étape la plus avancée atteinte, sous forme d'un badge orange reached/total. Le badge disparaît une fois la visite terminée. Terminer une visite à n'importe quelle difficulté coche également son bouton Guidé.

Reprendre une visite.

Une visite quittée en cours de route garde sa place, même si l'onglet du navigateur est fermé : sa carte ouvre alors son bandeau de lancement par Reprendre · étape N. Reprendre relance le parcours à cette étape, à sa difficulté, avec les indices utilisés et le temps écoulé : quitter ne permet pas d'effacer la pénalité d'un parcours noté. Démarrer recommence à l'étape 1. Sur une visite proposée à plusieurs difficultés, le bouton nomme celle à laquelle il reprend, comme dans Reprendre · étape 5 · Défi. Reprendre vérifie d'abord chaque checkpoint qui précède cette étape : si l'un n'est plus rempli (aucun projet ouvert, pour une visite qui travaille sur un projet), il s'y arrête, avec une note qui dit où il retourne, et une fois la condition remplie (le projet ouvert) la visite revient directement à l'étape quittée. Terminer la visite efface sa place.

La mascotte et les badges

La mascotte pvSpline (un petit panneau solaire avec un visage, une maison au bout d'un fil et une batterie à ses pieds) n'apparaît que dans une seule visite : Redonner le sourire à la mascotte, dans la section Entraînement. Elle y est le patient. La visite ouvre un projet à elle, une maison à Lyon mal en point, et la mascotte se tient à côté de la bulle, exactement aussi mal en point que ce projet :

• sans aucune consommation saisie, le fil vers sa maison est coupé et crépite, la fenêtre est sombre, le panneau gris et affaissé ; une année qu’aucun foyer ne consomme (moins de 2 000 ou plus de 14 000 kWh, un profil tertiaire ou industriel choisi pour la maison) barre aussi la ligne Maison de la fiche ;

• avec une toiture déséquilibrée par rapport à la maison (plus du triple de sa consommation), la jauge LOSS se remplit et la batterie goutte ; une toiture couvrant moins du quart des besoins de la maison fait au contraire rougir la fenêtre, le fil s'emballant ;

• avec un système à stockage et aucune batterie choisie, l'écran de la batterie est vide et rouge, et la maison tire sur le réseau chaque soir ;

• une fois toutes les corrections faites, elle rayonne, et un calcul terminé du projet lui vaut un saut de victoire.

À côté de la mascotte pend sa fiche, placée à l’écart de la bulle et du contrôle mis en évidence : cinq lignes (Maison, Toiture, Équilibre, Batterie, Simulation), chacune avec une coche ou une croix et les chiffres derrière (combien de kWh la maison consomme, combien de fois la toiture produit cela, etc.). Chaque étape de la visite est l’une de ces lignes : l’étape passe au vert dès que le projet est corrigé, et la mascotte saute. La fiche reprend une partie des règles des pastilles de validation colorées du rail de navigation, et c’est la leçon sous-jacente : quand un de vos projets fait passer une pastille au rouge ou à l’orange, les lignes de la mascotte sont un premier endroit où regarder ; les pastilles en surveillent davantage, dont le schéma électrique.

C'est aussi un personnage avec lequel jouer : ses yeux suivent le pointeur, un clic la fait sauter et cligner de l'œil, un double-clic déclenche une éruption solaire, et laissée seule elle bâille, s'étire ou reçoit la visite d'un oiseau. Elle montre le ciel du site du projet (endormie après le coucher du soleil là-bas, lunettes de soleil autour du midi solaire, sous les nuages quand les données météo du projet disent que la saison est couverte), et elle ne se met jamais en travers de votre chemin : elle se tient à l'écart de la commande mise en lumière (et, à l'étape qui demande un profil de consommation, de la grille mensuelle que ce choix remplit), et quand elle ne trouve pas une telle place, les clics passent à travers elle. Quitter la visite la renvoie aussitôt.

Badges

L'étagère Badges, au-dessus des cartes de tutoriels, liste sept badges, avec un compteur tel que 2 / 7 obtenus. Un badge pas encore obtenu affiche un cadenas ; survolez n'importe quel badge pour lire ce qui le rapporte et ce qu'il donne à porter à la mascotte :

Un badge est annoncé dès qu'une session le rapporte, sur le panneau de résultats d'une session notée ou dans une courte note après une session Guidé (à côté de la mascotte dans sa propre visite, sinon dans le coin de la fenêtre), et sa récompense est portée aussitôt si l'emplacement est libre. La mascotte porte un objet par emplacement (tête, cou, poitrine, dos) : cliquez sur un badge obtenu de l'étagère pour lui mettre sa récompense ou la lui retirer. Les badges que votre historique prouve déjà, comme les visites terminées avant que l'étagère n'existe, apparaissent d'eux-mêmes.

Quel tutoriel pour quel objectif

Référence des champs

Les cartes de tutoriel (le lanceur)

Bulle d'instruction (tous types d'étapes)

Affichage tête haute des sessions notées (Défi / Expert)

Une rangée en tête de la bulle.

Panneau de résultats (fin d'une session notée)

Étagère de badges et mascotte

Tutoriels disponibles

Les nombres d'étapes sont ceux qu'affichent les cartes sur l'onglet Projet sans projet ouvert, connecté à votre compte (Le compteur d'étapes).

Cibles des checkpoints des visites Entraînement

Les deux simulations acceptent une plage autour de chaque cible, pour qu'un projet réaliste passe sans reproduire exactement les chiffres de référence. Chaque checkpoint lit les cartes des onglets Projet et Consommation au fil de la saisie : une étape passe au vert à la frappe qui l'atteint, et dans Redonner le sourire à la mascotte, la mascotte y répond aussi.

La fiche mission de chaque simulation (l’adresse, le contrat et ses prix, le tarif de revente, les coûts, l’emprunt, la consommation et la toiture) s’ouvre d’un bouton en bas de la bulle, Fiche mission, à chaque étape et à tous les niveaux, et ne coûte rien : Défi et Expert évaluent ce que vous faites des chiffres, pas votre mémoire, si bien que leurs indices payants disent comment faire une étape, jamais avec quoi. Lors d’un parcours Guidé, les bulles citent aussi les chiffres dont chaque étape a besoin, et les cinq étapes dont les valeurs sont les plus longues à saisir proposent Remplir pour moi, qui écrit la réponse de la fiche mission dans le projet d’entraînement en une seule modification que vous pouvez annuler : la fiche client, les paramètres de simulation, les plages horaires, les paramètres financiers, et la saisie mensuelle (la maison) ou le profil industriel (l’usine). La fiche client remplie place le site comme le ferait la recherche d’adresse.

À l’étape de la toiture, la carte cercle l’adresse du client : la toiture doit être dessinée sur ce bâtiment, pas sur un autre plus loin dans la rue.