Miftah Atlas — base de données historique (v0.1.0)
Corpus initial de https://atlas.institutmiftah.com : savants, ouvrages, événements, lieux, dynasties, disciplines et relations intellectuelles de l'islam, du Prophète ﷺ à l'époque mamelouke. Toutes les données centrales sont sourcées page par page dans la bibliothèque Shamela (101 pages distinctes, ~400 citations) et portent un niveau de vérification explicite.
Principe directeur : l'exactitude documentaire prime sur la quantité. Ce qui n'a pas été lu dans une source est marqué comme tel, jamais présenté comme un fait.
Contenu
| Fichier | Contenu | Nombre |
|---|---|---|
data/scholars.json |
Fiches savants (noms, dates hégiriennes, lieux, affiliations, disciplines, œuvres, divergences) | 40 |
data/works.json |
Ouvrages avec attribution sourcée, œuvre de base (šarḥ, nukat, muḫtaṣar) | 24 |
data/events.json |
Événements politiques, institutionnels, intellectuels | 25 |
data/places.json |
Lieux (10 grands centres + lieux biographiques), coordonnées indicatives | 32 |
data/relationships.json |
Relations typées entre savants (maître-élève, citation, commentaire, critique, parallèle…) | 29 |
data/concepts.json |
Dossier d'histoire intellectuelle : la théorie du ḫabar (al-Šāfiʿī → al-Zarkašī) | 1 |
data/sources.json |
Ouvrages-sources (classiques, éditoriaux, référence moderne) avec identifiant Shamela | 22 |
data/periods.json, intellectual_phases.json |
Périodisation politique et phases intellectuelles | 10 + 4 |
data/dynasties.json, disciplines.json |
Référentiels | 10 + 11 |
data/relationship_types.json, verification_levels.json |
Vocabulaires contrôlés | 12 + 6 |
data/modern_bibliography.json |
Travaux universitaires vérifiés (notices éditeur/catalogue) | 3 |
data/negative_findings.json |
Affirmations testées et non établies | 4 |
data/shamela_pages_index.json |
Liste des pages Shamela effectivement lues | 101 |
schemas/*.schema.json |
JSON Schema (draft 2020-12) | 6 |
scripts/validate.py |
Contrôle d'intégrité (ids, références croisées, citations, dates, schémas) | — |
tools/build/*.py |
Code source qui génère data/ et les rapports |
— |
docs/ |
Architecture, méthodologie, périodisation, rapport de vérification, dossier ḫabar | 5 |
Chaque fichier data/*.json a la forme {"meta": {...}, "items": [...]}.
Démarrage rapide (développeurs)
python3 scripts/validate.py # doit afficher « Erreurs : 0 »
python3 tools/build/build.py . # régénère data/ et docs/RAPPORT_VERIFICATION.md depuis les définitions
Les définitions éditables se trouvent dans tools/build/*_def.py (une fonction par type d'entité). Ne pas éditer data/*.json à la main : modifier les définitions puis régénérer, afin que rapport et index restent cohérents.
Identifiants stables
| Préfixe | Entité | Exemple |
|---|---|---|
sch_ |
savant | sch_zarkashi |
wrk_ |
ouvrage | wrk_tashnif |
evt_ |
événement | evt_ghazali_nizamiyya_484 |
plc_ |
lieu | plc_baghdad |
dyn_ |
dynastie | dyn_seljuk |
disc_ |
discipline | disc_usul |
per_ |
période | per_08_mamluk |
src_ |
source | src_wafayat |
rel_ |
relation | rel_0007 |
cpt_ |
concept / dossier | cpt_khabar |
Les identifiants sont des slugs ASCII stables : on ne les renomme jamais ; une entité supprimée est marquée obsolète plutôt qu'effacée.
Conventions historiques
Dates. La date de référence est hégirienne. Chaque date contient year / month / day, une precision (day | month | year | unknown) et un qualifier :
exact— attestée telle quelle ;disputed— divergence documentée ; les autres valeurs sont dansvariants[]avec leur auteur (attributed_to) et leur citation ;circa,before,after— approximations explicites de la source ;derived— calculée (p. ex. naissance = décès − âge) : à ne jamais afficher comme un fait ; pas de conversion grégorienne ;unknown— inconnue.
Le champ gregorian donne seulement la plage julienne couvrant l'année hégirienne (calendrier tabulaire, bornes ±1-2 jours). Ce n'est jamais une date exacte : l'interface doit afficher par exemple « 794 H / 1391-1392 ». Aucune date incertaine n'est convertie en date précise.
Noms. names.ar reproduit la forme de la source (non vocalisée sauf mention) ; ar_vocalized n'est rempli que si la vocalisation figure dans la source lue. Translittération de type Arabica (ḏ, ḫ, ġ, š, ǧ, ṯ, ʿ, ʾ). Les variantes de nom documentées sont listées.
Affiliations. Chaque affiliation (maḏhab, école de kalām) a un statut : verified_primary, reported_disputed, inferred (déduite, p. ex. des maîtres), à_sourcer, ou consensus_non_sourcé_ici (fait notoire, comme l'éponymie des écoles, non encore appuyé par un passage lu).
Relations intellectuelles. Une relation n'existe que si elle est typée et sourcée. Les types sont distincts et ne se confondent pas : teacher_student, textual_citation, commentary_on, abridgement_of, doctrinal_adherence, critique, scholarly_exchange, evaluation, classical_claim_of_dependence, doctrinal_parallel, influence_hypothesis, contemporaneity. La contemporanéité est calculée par l'application et n'implique jamais d'influence.
Sources
Sources primaires effectivement lues (texte Shamela) : Siyar aʿlām al-nubalāʾ (al-Ḏahabī), Taqrīb al-Tahḏīb, al-Durar al-kāmina, Inbāʾ al-ġumr (Ibn Ḥaǧar), Wafayāt al-aʿyān (Ibn Ḫallikān), Ṭabaqāt al-šāfiʿiyya al-kubrā (al-Subkī), Ṭabaqāt al-šāfiʿiyya (Ibn Qāḍī Šuhba), al-Ǧawāhir al-muḍiyya (al-Qurašī), Tāǧ al-tarāǧim (Ibn Quṭlūbuġā), Ṭabaqāt al-ḥuffāẓ (al-Suyūṭī), et pour le dossier ḫabar : al-Risāla, al-Kifāya, al-Mustaṣfā, la Muqaddima d'Ibn al-Ṣalāḥ, Tašnīf al-masāmiʿ et al-Nukat d'al-Zarkašī. Les introductions d'éditeurs modernes et al-Ziriklī sont typées secondary_* et ne servent jamais seules de preuve pour un fait central.
Chaque citation contient : source_id, shamela_book_id, shamela_page_id, printed_ref (volume/page imprimés affichés par Shamela), url (lien Shamela vérifié), excerpt_ar (extrait court), éventuellement speaker (locuteur rapporté) et note.
Éditions. Les numéros de volume/page sont ceux de l'édition numérisée par Shamela. Les détails bibliographiques complets (éditeur, lieu, année) restent à relever sur les pages de titre : voir edition_details_status dans sources.json.
Règles de qualité (non négociables)
- Aucune référence inventée : toute citation
checked: truecorrespond à une page réellement lue (shamela_pages_index.json). - Ce qui n'est pas vérifié est étiqueté (
unverified_in_corpus,à_sourcer,À vérifier), jamais lissé. - Les divergences entre sources sont conservées, avec leur attribution ; aucune n'est tranchée sans texte.
- On distingue ce que dit la source classique (
source_statement) de la lecture de l'historien (historian_reading) et des questions ouvertes. - Aucune influence n'est déduite de la seule proximité chronologique.
scripts/validate.pydoit passer sans erreur avant toute publication.
État du corpus et prochaines étapes
Voir docs/RAPPORT_VERIFICATION.md (généré) pour la liste complète vérifié / discuté / non vérifié. Priorités :
- sourcer les dates des événements marqués
unverified_in_corpus(Hégire, Ṣiffīn, Karbalāʾ, 132, 145, Miḥna, 656) ; - contrôler le décès d'al-Nawawī (676/677) et la naissance d'al-Ḏahabī ;
- relever les éditions complètes des 22 sources ;
- étendre le dossier ḫabar à al-Baḥr al-muḥīṭ d'al-Zarkašī et aux uṣūl d'al-Bāqillānī et d'al-Ǧuwaynī ;
- ajouter les maîtres hors corpus (al-Bulqīnī, al-ʿIrāqī, al-Mizzī…) comme entités à part entière.