From ae5a6f595958697b25badf3bed88475f44b5ce25 Mon Sep 17 00:00:00 2001
From: Mathieu Vergez <mathieu.cj.vergez@gmail.com>
Date: Tue, 25 Aug 2026 15:38:40 +0200
Subject: [PATCH] =?UTF-8?q?docs(architecture):=20ajout=20mod=C3=A8le=20de?=
 =?UTF-8?q?=20donn=C3=A9es=20constellations?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ARCHITECTURE.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index 18ddfbe..c2e2b98 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -103,6 +103,33 @@ hip_id;ra_deg;dec_deg;magnitude;proper_name
 
 > Note d'implémentation : les valeurs décimales ci-dessus utilisent un point comme séparateur (format attendu par `float()` en Python / `pandas.read_csv` par défaut), à ne pas confondre avec la notation à virgule utilisée à l'oral pendant la conception.
 
+## Modèle de données - constellations
+
+**Fichier** : `dataset_constellations.json`
+**Format** : JSON, liste d'objets
+
+Chaque constellation référence ses étoiles via leur `hip_id` (clé commune avec `dataset_hipparcos.csv`), sans duplication des données d'étoiles. La structure ne conserve qu'une liste de `liaisons` (paires d'étoiles reliées) - la liste des étoiles composant la constellation est dérivable de cette liste, ce qui évite toute redondance/désynchronisation entre deux champs qui porteraient la même information.
+
+L'identifiant `id` suit la nomenclature standardisée de l'Union Astronomique Internationale (abréviation à 3 lettres, ex. `UMa` pour la Grande Ourse) plutôt qu'un identifiant arbitraire propre au projet, pour rester compatible avec toute source de données externe (Stellarium, autres catalogues) qui utiliserait la même convention.
+
+```json
+[
+    {
+        "id": "UMa",
+        "nom": "Grande Ourse",
+        "liaisons": [
+            [54061, 53910],
+            [53910, 58001],
+            [58001, 59774],
+            [59774, 54061],
+            [59774, 62956],
+            [62956, 65378],
+            [65378, 67301]
+        ]
+    }
+]
+```
+
 ## Décisions techniques actées
 
 - Catalogue source : Hipparcos, pré-traité offline via `astropy` en CSV propre (RA, Dec, magnitude, nom) plutôt que parsé à la volée dans l'application