After an incident, or at the end of a day, the managers want the debriefing: what was detected, what r-io suite deduced and deployed, who did what, what the field sent back and what the actors said to each other. The historical report freezes all of it for a period of the use case, in one large box, and exports it.
01
Two ways in
The alert box that opens when the supervision raises an alert has a Generate Historical Report button at the bottom left, next to the adaptations it offers.
The ≡ menu of the toolbar, under the view choice (Unified Map, Map Comparison, Table Comparison), has a Reports section: Generate historical report and Reports history.
02
Choose the period
Generate historical report first asks how far back to go: 3 hours, 6 hours, 12 hours, 24 hours, 2 days, 7 days, 1 month, 3 months or 6 months, ending now on the clock of the use case. The history of that period is drawn on a blue timeline, one lane per kind of moment: Actualities (appeared, ended), Risks (changed), Deductions (started, found, failed) and Supervisions (deployed, ended), each lane with its count.
A blue handle starts on the left. Drag it, or click a moment, to start the report there: the report goes from the handle to the end of the timeline, and the box says how many moments it keeps. Whole period puts the handle back at the start. When nothing happened, the box asks for a longer period. Generate report builds the report and opens it.
03
The report
The title bar gives the period, its length, the date of the report and its author. A row of counters follows: incidents, risks, deductions (and how many failed), processes, tasks (and how many were done), actors, photos and chat messages. Then one tab per part:
Summary: the text of the debriefing (see below) and the timeline of the period.
Incidents: each actuality (incident) and risk with its type, when it was detected and ended (or still open), how long it lasted, its probability and the number of changes of a risk.
Deductions: start, end, duration, mode, situation, result (found, failed, dropped or running) and message; a failed deduction appears here even though it left nothing else in the model.
Processes: each supervision with its status, dates, duration, strategy, number of tasks and expected indicators (a precise value or an interval).
Actors: one row per actor and supervision, with the tasks of the actor, their status and their outputs; a photo sent from the field is shown and opens full size.
Tasks: each task with its supervision, actors, status, dates, indicators (expected → measured) and outputs, an error message under a task in error.
Chat: the messages of the use-case chat in the period, all groups together, with their time, group, author, text and attachments (photos shown).
04
Summary from the facts, or by the AI
The report always opens with a summary written from the facts of the period: the incidents and the risks that changed, how many were closed, the deductions and their mean duration, the processes deployed for which objectives and how many were cancelled, the actors, the tasks done, in error or not done, the photos, and the chat messages by group and author.
Write with AI sends the facts of the report (incidents, deductions, processes, tasks with their actors and outputs, chat messages) to the AI provider of the project, possibly a paid external service, and asks for a few paragraphs of plain prose stating only those facts: what happened, how r-io suite answered, who did what, what the actors said that matters, what is still open, and the lessons. If the key of the provider of the project is refused, OpenAI then Albert are tried. The AI summary is kept with the report; From the facts and AI summary switch between the two texts, and Write again with AI asks for a new one.
05
Exports
The Export menu of the title bar offers:
PDF: the report in a printable page; the print box of the browser offers Save as PDF.
Word: a web archive that Word opens as a document, with the photos inside; the timeline is left out.
Excel: one workbook with one sheet per detailed table (events of the timeline, processes deployed, tasks, actors by supervision, chat messages): bold frozen header with filters, numbers as numbers, dates as Excel dates.
CSV: one of the five tables, or All five; the cells are separated by semicolons and the file is UTF-8 with its mark, as a French Excel expects.
06
Reports history
Reports history lists the reports generated for the use case, the last one first, with an icon when the summary was written by the AI. Each one opens again as it was generated, or is deleted after a confirmation. The period box and the history lead to each other.
07
What is kept, and where
A report is the period frozen at once: generating it again later gives the facts as they are then. The reports, and the traces of the deductions r-iota sends, are kept by the server per use case (collaboration and knowledge space): they stay when the runtime state of the use case is cleaned and are not part of a project export. All dates are those of the clock of the use case.
Après un incident, ou en fin de journée, les responsables veulent le retour d’expérience : ce qui a été détecté, ce que r-io suite a déduit et déployé, qui a fait quoi, ce que le terrain a renvoyé et ce que les acteurs se sont dit. Le rapport historique fige tout cela pour une période du cas d’usage, dans une grande boîte, et l’exporte.
01
Deux entrées
La boîte d’alerte qui s’ouvre quand la supervision lève une alerte a un bouton Generate Historical Report en bas à gauche, à côté des adaptations qu’elle propose.
Le menu ≡ de la barre d’outils, sous le choix de la vue (Unified Map, Map Comparison, Table Comparison), a une rubrique Reports : Generate historical report et Reports history.
02
Choisir la période
Generate historical report demande d’abord jusqu’où remonter : 3 hours, 6 hours, 12 hours, 24 hours, 2 days, 7 days, 1 month, 3 months ou 6 months, jusqu’à maintenant sur l’horloge du cas d’usage. L’histoire de cette période est tracée sur une frise bleue, un couloir par sorte de moment : Actualities (apparues, terminées), Risks (modifiés), Deductions (lancées, trouvées, en échec) et Supervisions (déployées, terminées), chaque couloir avec son compte.
Une poignée bleue part de la gauche. La faire glisser, ou cliquer un moment, fait commencer le rapport là : le rapport va de la poignée à la fin de la frise, et la boîte dit combien de moments il garde. Whole period remet la poignée au début. Quand rien ne s’est passé, la boîte demande une période plus longue. Generate report construit le rapport et l’ouvre.
03
Le rapport
La barre de titre donne la période, sa durée, la date du rapport et son auteur. Suit une ligne de compteurs : incidents, risques, déductions (et combien ont échoué), processus, tâches (et combien ont été faites), acteurs, photos et messages du chat. Puis un onglet par partie :
Summary : le texte du retour d’expérience (voir plus bas) et la frise de la période.
Incidents : chaque actualité (incident) et chaque risque avec son type, sa détection et sa fin (ou still open), sa durée, sa probabilité et le nombre de changements d’un risque.
Deductions : début, fin, durée, mode, situation, résultat (trouvée, en échec, abandonnée ou en cours) et message ; une déduction en échec apparaît ici même si elle n’a rien laissé d’autre dans le modèle.
Processes : chaque supervision avec son statut, ses dates, sa durée, sa stratégie, son nombre de tâches et ses indicateurs attendus (une valeur précise ou un intervalle).
Actors : une ligne par acteur et par supervision, avec les tâches de l’acteur, leur statut et leurs sorties ; une photo envoyée du terrain est affichée et s’ouvre en grand.
Tasks : chaque tâche avec sa supervision, ses acteurs, son statut, ses dates, ses indicateurs (attendu → mesuré) et ses sorties, un message d’erreur sous une tâche en erreur.
Chat : les messages du chat du cas d’usage dans la période, tous groupes confondus, avec leur heure, leur groupe, leur auteur, leur texte et leurs pièces jointes (photos affichées).
04
Résumé d’après les faits, ou par l’IA
Le rapport s’ouvre toujours sur un résumé écrit d’après les faits de la période : les incidents et les risques qui ont changé, combien ont été clos, les déductions et leur durée moyenne, les processus déployés pour quels objectifs et combien ont été annulés, les acteurs, les tâches faites, en erreur ou non faites, les photos, et les messages du chat par groupe et par auteur.
Write with AI envoie les faits du rapport (incidents, déductions, processus, tâches avec leurs acteurs et leurs sorties, messages du chat) au fournisseur d’IA du projet, éventuellement un service externe payant, et demande quelques paragraphes de prose simple qui n’énoncent que ces faits : ce qui s’est passé, comment r-io suite a répondu, qui a fait quoi, ce que les acteurs se sont dit d’important, ce qui reste ouvert, et les enseignements. Si la clé du fournisseur du projet est refusée, OpenAI puis Albert sont essayés. Le résumé de l’IA est gardé avec le rapport ; From the facts et AI summary passent d’un texte à l’autre, et Write again with AI en demande un nouveau.
05
Exports
Le menu Export de la barre de titre propose :
PDF : le rapport dans une page imprimable ; la boîte d’impression du navigateur propose Enregistrer au format PDF.
Word : une archive web que Word ouvre comme un document, photos comprises ; la frise n’y figure pas.
Excel : un classeur avec un onglet par table détaillée (événements de la frise, processus déployés, tâches, acteurs par supervision, messages du chat) : en-tête en gras figé avec filtres, nombres en nombres, dates en dates Excel.
CSV : l’une des cinq tables, ou All five ; les cellules sont séparées par des points-virgules et le fichier est en UTF-8 avec sa marque, comme l’attend un Excel français.
06
Historique des rapports
Reports history liste les rapports générés pour le cas d’usage, le dernier en premier, avec une icône quand le résumé a été écrit par l’IA. Chacun se rouvre tel qu’il a été généré, ou se supprime après confirmation. La boîte de période et l’historique mènent l’une à l’autre.
07
Ce qui est gardé, et où
Un rapport est la période figée d’un coup : le générer à nouveau plus tard donne les faits tels qu’ils sont alors. Les rapports, et les traces des déductions qu’envoie r-iota, sont gardés par le serveur par cas d’usage (collaboration et espace de connaissance) : ils restent quand l’état d’exécution du cas d’usage est nettoyé et ne font pas partie d’un export de projet. Toutes les dates sont celles de l’horloge du cas d’usage.