← Documentation

Qu'est-ce qu'un dossier ufologique ?

Dans UFO@home, un dossier réunit tout ce que l'on sait d'un événement : ce qui a été vu, par qui, comment on peut l'expliquer, ce que les témoins ont dit quand on les a interrogés. Un dossier est ce dont parle une enquête : une nuit, un lieu, un titre. Il ne décrit pas l'événement lui-même. Il liste ce qui s'est passé autour, sous forme d'événements, chacun étant un document à part. Personne n'a à tous les écrire : un dossier peut n'être qu'une observation, et grandir.

Les événements d'un dossier#

Un dossier contient trois sortes d'événements.

  • Des observations. Généralement au moins une : le compte rendu d'un témoin, qu'UFO@home rejoue. Un dossier peut en contenir d'autres, d'autres témoins du même événement, chacun avec son propre compte rendu, qui peuvent diverger.
    • Des interprétations. Une explication alternative de ce qui a été vu : un cerf-volant, une planète, un avion, un canular. C'est elle-même une observation, rejouée à côté de celle du témoin, pour que les deux se comparent.
  • Des interviews. Une conversation menée avec un témoin, qui fixe ce qu'il a dit quand on l'a interrogé. Elle n'est pas rejouée.

Les événements d'un dossier peuvent être liés#

Un événement est rarement seul : une interprétation est une interprétation de quelque chose, une interview est menée avec quelqu'un. Ces renvois sont ce que suit un lecteur de l'un à l'autre.

De → VersComment
Une interprétation → une observationUne interprétation nomme l'observation primaire qu'elle explique : le compte rendu du témoin dont elle est une autre interprétation. On ne peut la comprendre sans elle.
Une interview → une observationUne interview nomme l'observation du témoin avec qui elle a eu lieu, ou celle de chaque témoin quand ils étaient plusieurs.
Une observation → une interviewDans l'autre sens : un passage d'une interview peut dire de quel moment de l'observation il parle. L'observation liste alors, à ce moment, les passages qui la racontent, chacun un lien en retour vers l'interview.

Un événement est désigné par un id qui lui est propre dans le dossier et nulle part ailleurs. Seul un événement auquel on renvoie en a besoin.

Dans l'éditeur de dossier#

L'éditeur de dossier : le sélecteur des événements du dossier, et le + qui en ajoute un.
L'éditeur de dossier : le sélecteur des événements du dossier, et le + qui en ajoute un.
Le groupe Fichier de l'éditeur de dossier : le fichier de dossier en texte, complété d'après son propre schéma.
Le groupe Fichier de l'éditeur de dossier : le fichier de dossier en texte, complété d'après son propre schéma.

L'éditeur ouvre un dossier comme un sélecteur de ses événements (« Observation de Q. B. », « Interview de Q. B. »), celui choisi s'ouvrant dessous. Le + ajoute un événement du type choisi, et le groupe Fichier montre le dossier en texte.

  • Ouvrir un dossier. Chargez un case.json depuis un fichier ou une adresse, ou partez d'un enregistrement et choisissez « Ajouter à un dossier ».
  • Le sélecteur liste les événements (« Observation de Q. B. », une interprétation, « Interview de Q. B. »). Celui que vous choisissez s'ouvre dessous, dans son propre éditeur : l'éditeur d'observation pour une observation ou une interprétation, l'éditeur d'interview pour une interview. Ce que vous avez changé dans les autres est conservé.
  • L'identifiant à côté du sélecteur est l'id de l'événement, par lequel les autres événements le désignent. Donnez-en un à un événement auquel vous voulez renvoyer ; l'éditeur en propose un, et en donne un à l'observation avec laquelle une interview a eu lieu.
  • + ajoute un événement : une observation (vierge, depuis un fichier ou une adresse), une interprétation d'une observation, ou une interview (avec qui elle a eu lieu, un titre, qui l'a menée, par quel moyen). La corbeille retire l'événement affiché.
  • Les deux groupes du dossier : les Événements, le sélecteur et l'événement affiché, et le Fichier, le case.json en texte, complété d'après son propre schéma, à modifier, charger et sauver. Les deux disent la même chose : ce qui change dans l'un change dans l'autre.
  • Sauver télécharge le dossier avec ses fichiers (un zip quand il y en a plusieurs). Jusque-là le dossier n'est modifié que dans la page, et l'éditeur prévient avant ce qui serait perdu.

Partie technique : le fichier de dossier#

Un dossier est un case.json, dont case.schema.json est le schéma : un titre, une date, et ses events. Chaque événement a un eventType (sighting, interpretation ou interview), et une url quand il a un fichier à lui, relative au dossier. Les renvois sont interpretationOf et interviewOf, chacun un id ou une liste.

Chaque extrait ci-dessous est en lecture seule, et chacun connaît le format : placez le curseur dans un objet et faites Ctrl+Espace (⌥+I sur Mac) pour lister toutes les clés qui pourraient y figurer, avec ce que le modèle dit de chacune.

Un exemple#

{
  "id": "SaintLo2026",
  "title": "Saint-Lô",
  "time": "2026-08-11 02:30",
  "events": [
    { "type": "event", "eventType": "sighting", "id": "qb", "time": "2026-08-11 02:30", "title": "Q. B.", "url": "observer-saint-lo.json" },
    { "type": "event", "eventType": "sighting", "id": "kite", "interpretationOf": "qb", "title": "A kite", "url": "interpretation-kite.json" },
    { "type": "event", "eventType": "interview", "id": "interview-qb-1", "interviewOf": "qb", "time": "2026-10-13 21:27",
      "medium": "video", "by": [{ "people": "BeauJerome" }], "url": "interview-qb-1.json" }
  ]
}

Le dossier#

ChampSignification
idL'identifiant du dossier. Sur rr0.org, c'est le nom du répertoire du dossier
titleLe nom du dossier
summaryUne phrase ou deux, dans autant de langues qu'on veut : ce que dit d'un dossier un lien qui y mène quand on le partage
imageUne image qui représente le dossier là où il n'est que lié
timeQuand cela s'est passé, comme RR0 écrit une date ("1948-07-24 02:45", "1954")
eventsCe qui s'est passé autour, dans l'ordre (voir plus bas)

Les événements#

ChampSignification
type, eventType"event", et le genre : sighting (une observation, ou une interprétation), interview. Un dossier peut avoir des genres à lui (article, image, book…), qu'UFO@home laisse de côté
idCe par quoi les autres événements le désignent, unique parmi les événements du dossier. Seul un événement auquel on renvoie en a besoin
urlLe fichier propre de l'événement (l'enregistrement d'une observation, la transcription d'une interview), relatif au dossier
time, place, title, summary, byQuand, où, son nom, ce qu'il a établi, qui l'a fait ({ "people": "…" } ou { "org": "…" })
interpretationOfD'une interprétation : l'id, ou les ids, des observations primaires dont elle est une interprétation
interviewOfD'une interview : l'id, ou les ids, des observations des témoins avec qui elle a eu lieu
mediumD'une interview : in-person, phone, video, chat, email, letter ou other

Tout le reste d'un dossier (sa classification, son lieu, ses sources) est à RR0 de le définir et traverse UFO@home sans être lu. Ce qu'UFO@home rejoue d'un dossier, ce sont ses observations ; il montre ses interprétations à côté, et garde ses interviews.

<rr0-case-editor>

L'éditeur de dossier : le sélecteur de ses événements, chacun ouvert dans l'éditeur de son genre, et le fichier de dossier en texte.

<script type="module" src="https://ufoathome.org/lib/rr0-sighting-editor.mjs"></script>
<rr0-case-editor src="/cases/saint-lo/case.json"></rr0-case-editor>

Le module de l'éditeur d'enregistrement l'enregistre, avec le <rr0-sighting-editor> qu'il contient. L'éditeur d'interview est chargé la première fois qu'une interview est montrée.

MembreGenreCe qu'il fait
srcattributL'adresse d'un dossier (case.json), ou d'un seul enregistrement, qu'il propose alors d'ajouter à un dossier.
trackattributL'adresse de l'enregistrement à ouvrir d'abord, relative au dossier ; par défaut celui du premier observateur.
sightingDatapropriétéL'enregistrement affiché, comme objet simple.
sightingEditorpropriétéLe <rr0-sighting-editor> qui le contient, pour qui a besoin de plus que ce que cet élément offre.
caseSessionpropriétéLe dossier en cours d'édition, quand un est ouvert.
dirtypropriétéVrai quand le dossier, ou l'un de ses enregistrements, a des modifications non sauvées.