PAN/UAP version 0.1 - Documentation des champs JSON

Proposition initiale de modèle de données pour l'enregistrement des observations de PAN/UAP ( version 0.1) ouverte à la discussion.

Fichier de référence avec exemples factices : uap_srm_v0.1.json

Par nature ce projet est ouvert aux spécialistes de multiples disciplines, aux associations, aux chercheurs et aux enquêteurs indépendants. Si vous êtes intéressés pour contribuer bénévolement à la progression de ce projet, que ce soit en tant que consultant occasionnel, ou en tant que contributeur régulier et actif, n'hésitez pas à nous contacter.

0. Métadonnées du modèle (model)

Nom du modèle : UAP Sighting Record Model.

Version du schéma (ici 0.1).

Statut du document (draft, review, stable, …).

URI du projet (https://uap-project.org).

Résumé du modèle.

1. Observations (sightings[])

Tableau racine des enregistrements d'observation PAN/UAP.

1.1 Identification et durée

Identifiant unique de l'observation dans le système producteur.

Date et heure de l'observation (UTC recommandé), ex. 2024-06-15T22:30:00Z.

Durée totale de l'observation en secondes.

1.2 Conditions environnementales (environmental_conditions)

Conditions météo (ex. clear, cloudy, rainy).

Visibilité (ex. clear, hazy, foggy).

Température ambiante en degrés Celsius.

1.3 Observateurs (observers[])

Identifiant unique de l'observateur dans l'enregistrement.

Prénom (soumis à anonymisation / consentement).

Nom (soumis à anonymisation / consentement).

Âge au moment de l'observation.

Profession ou activité (catégorie ou libellé).

Genre, si relevé et pertinent pour l'analyse.

Familiarité avec les phénomènes aéronautiques ou astronomiques (ex. novice, expert).

Réaction émotionnelle rapportée (ex. calm, frightened).

Date et heure de début pour cet observateur (start).

Position de l'observateur au début — voir champs location ci-dessous.

Date et heure de fin pour cet observateur (end).

Position de l'observateur à la fin — voir champs location ci-dessous.

Latitude WGS84 en degrés décimaux.

Longitude WGS84 en degrés décimaux.

Altitude de l'observateur en mètres.

Code pays ISO 3166-1 alpha-3 (ex. FRA, USA, BEL).

1.4 Cibles observées (targets[])

Un ou plusieurs objets ou phénomènes perçus.

Identifiant unique de la cible dans l'enregistrement.

Description libre du phénomène observé.

Forme apparente (ex. disc, sphere, cigar-shaped).

Couleur(s) perçue(s).

Mode de déplacement (ex. hovering, zigzagging, linear).

Vitesse estimée en km/h.

Altitude angulaire ou estimée au début (convention à préciser : degrés ou mètres).

Azimut initial en degrés (0–360).

Altitude angulaire ou estimée à la fin.

Azimut final en degrés (0–360).

Type d'émission (ex. light, sound).

Intensité perçue (ex. faint, bright, loud).

1.5 Événements liés (related_events[])

Recoupements avec d'autres observations ou détections. Cette section est destinée à accueillir les signalements/observations sur des cibles identiques. Est-ce utile de l'incorporer dans les permières versions ? Ou serait-il plus pertinent de développer une application dont la finalité serait de rechercher des signalements se rapportant à une cible unique ?

Identifiant de l'événement lié.

Type : sighting, radar_detection, other, …

Description courte du lien ou de l'événement associé.

Référence externe (identifiant ou URI).

1.6 Enquêtes (investigations[])

Processus d'analyse appliqué à l'observation. Séparé des faits rapportés par les témoins. Plusieurs enquêtes possibles par observation.

Cette section n'est peut être pas indispensable dans un premier temps.

Identifiant unique de l'enquête.

État : open, in_progress, closed, suspended.

Organisme menant l'enquête (ex. GEIPAN, nom d'association).

Date d'ouverture de l'enquête.

Dernière mise à jour.

Date de clôture ; null si enquête en cours.

Synthèse ou conclusion de l'enquête.

Identifiant de l'enquêteur.

Nom ou pseudonyme professionnel.

Rôle dans l'enquête (ex. field investigator, expert).

Identifiant de l'étape.

Type : desk_review, field_visit, cognitive_interview, expert_panel, other.

Date de l'étape.

Compte rendu succinct de l'étape.

Identifiant de l'hypothèse.

Énoncé de l'hypothèse explicative.

proposed, under_review, accepted, rejected.

Niveau de confiance associé (0.0–1.0), si utilisé.

Système de classification (ex. GEIPAN).

Catégorie retenue (ex. GEIPAN : A, B, C, D1, D2) ; null si enquête en cours.

true si la classification n'est pas définitive.

Origine de l'enregistrement d'enquête.

Niveau de confiance global sur les données d'enquête.

Date d'enregistrement de ces métadonnées.

1.7 Provenance du signalement (record_provenance)

Traçabilité de l'enregistrement d'observation lui-même (distinct de la provenance d'enquête). Ces informations sont indispensables pour sourcer l'origine du signalement.

Origine du signalement (formulaire web, GEIPAN, import, …).

Date de soumission du signalement.

Niveau de confiance sur la qualité du signalement initial.

1.8 Notes libres

Commentaires libres sur l'observation (hors conclusion d'enquête).

1.9 Extension (extension)

Entrée desitinée à accueillir éventuellement des données optionnelles supplémentaires.

(v0.1) Objet optionnel pour données additionnelles non couvertes par le socle. Clés libres, définies par le producteur ou un profil d'extension documenté. Peut être vide ({}) ou omis. Un seul point d'extension par enregistrement.

Exemple : "extension": {} ou "extension": { "geipan": { "case_ref": "…" } }.