Architecture scientifique et modèle de données
1. Analyse des exigences
Les sept questions du projet (époque, contemporains, contexte, maîtres/élèves, œuvres, influences, postérité) imposent trois exigences historiographiques qui structurent tout le modèle :
- Toute donnée est une assertion attribuée. Une date de décès n'est pas « la » date, mais ce qu'affirme telle source à telle page, éventuellement contredite par une autre. D'où : chaque date porte ses citations et ses variantes attribuées.
- L'incertitude est une donnée, pas un défaut. Les dates disputées (Sībawayh : 161, 177, 180, 188 ou 194), inconnues (al-Rāmahurmuzī : « après 350 ? »), dérivées (naissance = décès − âge) ou entachées d'un doute d'édition (al-Nawawī : 676/677) sont représentées comme telles.
- Les liens intellectuels sont typés et prouvés. « Maître de », « cite », « commente », « critique », « formule un parallèle » et « est contemporain de » sont des relations différentes ; la dernière n'est jamais stockée comme lien d'influence.
2. Couches de connaissance
┌──────────────────────────────────────────────┐
│ Couche 4 — Histoire des concepts (concepts) │ étapes, énoncés de source vs lectures de l'historien
├──────────────────────────────────────────────┤
│ Couche 3 — Réseau (relationships) │ relations typées + niveau de vérification
├──────────────────────────────────────────────┤
│ Couche 2 — Entités (scholars, works, events) │ fiches structurées, citations au niveau du champ
├──────────────────────────────────────────────┤
│ Couche 1 — Référentiels │ places, dynasties, disciplines, periods, sources
└──────────────────────────────────────────────┘
Socle : citations Shamela (source_id + page + extrait)
3. Entités et champs
Savant (scholars.json)
| Champ | Rôle |
|---|---|
names |
ar (forme de la source), ar_vocalized (si attestée), fr_usual, translit, variants[], name_status, citations[] |
birth, death |
objets Date (voir §4) |
places |
birth, activity[], death, burial (ids plc_), citations[], note |
affiliations[] |
type (madhhab/kalam/spiritual), value, status, citations[] |
disciplines[], works[], events[], periods[], relationships[] |
références croisées |
contributions[] |
text_fr, status (verified_primary / classical_claim), citations[] |
teachers_students_outside_corpus[] |
maîtres/élèves cités mais pas encore modélisés comme entités |
verification |
overall, divergences[], open_questions[] |
Ouvrage (works.json)
title_ar, title_translit, title_fr, author, disciplines[], genre (matn, sharh, mukhtasar, nukat, collection, tarajim), composition_date (Date ou null), base_work (œuvre commentée/abrégée), shamela_book_id_of_text, attribution_citations[], attribution_status.
Événement (events.json)
label_fr, kind (political / institutional / intellectual), date, places[], dynasties[], scholars[], citations[], verification (verified_primary, verified_primary_indirect, verified_primary_undated, verified_secondary, unverified_in_corpus).
Relation (relationships.json)
source → target (ou target_external hors corpus), type, verification, works[], citations[], note. Sens : la source est l'antérieur / le maître / l'auteur commenté ; la cible est l'élève / le commentateur / celui qui cite.
Concept (concepts.json)
stages[] ordonnées (savant, œuvre, date, thème) contenant des claims[] de type source_statement (citation obligatoire), historian_reading ou open_question ; documented_links[] vers les relations ; rules_applied[].
Référentiels
places: coordonnées modernes indicatives (precision: approx_modern_site) ounullsi non localisé ;is_major_center.dynasties: bornes conventionnelles (dates_status) + citations lorsque la dynastie est nommée dans une source lue.disciplines: hiérarchie (parent) ettimeline[]d'œuvres-jalons pour les frises superposables.periods/intellectual_phases: voirPERIODISATION.md.
4. Objet Date
{ "calendar": "hijri", "year": 794, "month": 7, "month_name": "raǧab", "day": null,
"precision": "month", "qualifier": "exact",
"variants": [],
"gregorian": { "from": "1391-11-29", "to": "1392-11-16", "calendar": "julian",
"method": "tabular_islamic_year_span", "note": "Plage… PAS une date exacte." },
"citations": [ … ], "note": "…" }
Règles d'affichage recommandées : exact → « 794 H (1391-92) » ; disputed → « 180 H ? (var. 161, 177, 188, 194) » ; derived → ne pas afficher, ou « v. 150 (calculé) » en grisé ; unknown → « date inconnue ».
5. Frises et cartographie
- Frise générale :
periods+events(filtrables parkind) + barres de vie des savants (datesexact/disputed/circaseulement ; lesderiveden pointillé). - Frises disciplinaires superposables : filtrer
scholars.disciplinesetdisciplines[].timeline. - Contemporains : calcul côté application par chevauchement des intervalles de vie, avec avertissement si une borne est dérivée ou disputée. Aucune relation n'est créée.
- Carte :
places(coordonnées indicatives) × lieux biographiques × relations ; les lieux sans coordonnées sont listés hors carte. - Réseau : graphe orienté de
relationships, couleurs partype, opacité parverification.
6. Recherche multilingue
Indexer names.ar (normalisé : suppression des voyelles, unification ا/أ/إ/آ, ى/ي, ة/ه), names.translit (normalisé sans diacritiques), names.fr_usual, names.variants, et les titres d'œuvres en arabe et translittérés.