dépôt public pour mythoskolis

Author: lucas-mauger

README.md

@@ -1,79 +1,76 @@
-# 🏛️ Mythoskolis — mythologie grecque, fiches et généalogie interactive
+# Mythoskolis
 
-Mythoskolis est un site de médiation culturelle qui rend la mythologie grecque lisible : fiches synthétiques, récits structurés et un HoloGraph interactif pour visualiser les filiations.
+Bienvenue sur le dépôt **Mythoskolis**.
+
+Ce projet peut se lire de plusieurs manières selon votre profil et ce que vous cherchez à comprendre.  
+Plutôt que de proposer un README unique trop long ou trop spécialisé, ce dépôt adopte une approche **multi-entrées**.
+
+👉 Choisissez simplement le parcours qui vous correspond.
+
+---
+
+## 👀 Vous êtes recruteur·se / RH / manager
+
+Vous souhaitez comprendre rapidement :
+- ce que démontre ce projet,
+- quelles compétences il met en avant,
+- en quoi il est pertinent dans un contexte professionnel.
+
+➡️ **Lectures recommandées :**
+- 📄 `README_TLDR_RECRUTEURS.md` — *vue ultra-rapide (≈30 secondes)*
+- 📄 `README_RECRUTEURS.md` — *présentation structurée orientée recrutement*
+
+---
+
+## 🧑‍💻 Vous êtes technicien·ne / développeur·se généraliste
+
+Vous souhaitez :
+- comprendre l’architecture globale,
+- voir comment les données, le front et l’UX s’articulent,
+- parcourir le projet dans son ensemble.
+
+➡️ **Lecture recommandée :**
+- 📄 `README_TECH.md` — *README technique complet*
+
+---
+
+## 📊 Vous êtes data analyst / analytics engineer / data engineer
+
+Vous vous intéressez principalement :
+- à la modélisation du domaine,
+- au pipeline de transformation des données,
+- aux choix ETL, de qualité et d’exploitation.
+
+➡️ **Lectures recommandées :**
+- 📄 `README_DATA.md` — *présentation orientée data*
+- 📄 `README_DATA_SCHEMAS.md` — *version avec schémas et pseudo-structures*
+
+---
+
+## 🏛️ Vous êtes curieux·se, étudiant·e, enseignant·e ou structure culturelle
+
+Vous vous intéressez avant tout :
+- à la mythologie grecque,
+- à la démarche de médiation culturelle,
+- à la manière dont le site permet d’explorer les mythes.
+
+➡️ **Lecture recommandée :**
+- 📄 `README_CULTUREL.md` — *présentation éditoriale et culturelle*
+
+---
+
+## 🌐 Le projet en ligne
+
+👉 https://mythoskolis.com
+
+---
+
+## ℹ️ À propos de ce dépôt
+
+- Ce dépôt correspond à une **V1++ publique**.
+- Certains modules (notamment le graphe généalogique interactif *HoloGraph*) sont propriétaires et volontairement exclus.
+- Le projet est vivant et évolutif.
 
 ---
 
-🔗 Démo : https://mythoskolis.com
-
-## 1. Fonctionnalités principales
-- Fiches entités (dieux, titans, héros, créatures) en Markdown + frontmatter.
-- Récits narratifs avec métadonnées (YAML) et filtre de recherche (titres + thématiques, insensible à la casse/accents).
-- HoloGraph interactif : graphe généalogique généré depuis `data/genealogie.yaml` → JSON statique.
-- Thème clair/sombre avec toggle persistant.
-- Pages éditoriales (ressources, à propos).
-
-## 2. Stack technique
-- Astro (site statique)
-- Tailwind CSS (design system `mk-*`)
-- Markdown + frontmatter YAML (collections Astro)
-- Scripts de génération JSON (généalogie)
-- Déploiement Cloudflare Pages (build Astro)
-
-## 3. Modélisation des données
-- `data/genealogie.yaml` = source de vérité des relations ; export JSON auto via `scripts/generate-genealogie-json-new.mjs` (hooké sur `predev` / `prebuild`).
-- Collections éditoriales dans `src/content/` (entités, récits, ressources) avec IDs stables ; l’ego-graph et les fiches partagent les mêmes IDs.
-- Médias préfixés par culture/ID (`public/faces/grecque-*.webp`, `public/images/`, `public/videos/`) avec fallback vidéo > image > placeholder.
-- Encarts/boutons HoloGraph affichés uniquement si l’ID existe dans le YAML ; HoloGraph isolé (CSS/JS d’origine, sans Tailwind).
-
-## 4. Installation locale
-```bash
-npm install
-npm run dev
-# ou pour expliciter l’hôte/port :
-# npm run dev -- --host --port XXXX dans le cas de tests -même distants- sur mobile via Tailscale
-```
-
-## 5. Organisation du projet
-```
-mythoskolis/
-├── data/                 # YAML généalogie (source unique)
-├── public/               # Médias statiques (faces/, images/, videos/)
-├── src/
-│   ├── components/       # Header, Footer, EgoGraph, etc.
-│   ├── content/          # Fiches entités/récits/ressources (MD + FM)
-│   ├── lib/              # Lecture/transformations généalogie
-│   ├── pages/            # Pages Astro
-│   └── styles/           # Styles globaux (Tailwind, mk-*)
-├── scripts/              # Génération JSON généalogie
-└── tools/                # Inspecteurs YAML/MD (maintenance locale)
-```
-
-## 6. Scripts utiles
-```bash
-npm run dev        # serveur de dev
-npm run build      # build statique (dist/)
-npm run preview    # prévisualiser le build
-npm run format     # Prettier
-npm run yaml:tool:new  # inspecteur YAML (relations, nouvelles structures)
-npm run md:tool    # inspecteur Markdown (frontmatter + corps)
-```
-
-## 7. Roadmap (extrait)
-- ✔️ Graphe généalogique interactif + encarts/boutons conditionnels sur les fiches.
-- ✔️ Filtre récits sur titres + thématiques (case/accents insensibles).
-- ✔️ HoloGraph isolé (CSS/JS d’origine, pas de Tailwind/design system).
-- ✔️ Accessibilité/SEO (alts, aria, contrastes AA).
-- ✔️ Filtres/badges nature/panthéon sur la liste des entités.
-- ✔️ Enrichir `source_texts` / variantes ; médias préfixés (ancienne arbo à trancher).
-- ✔️ QA/CI : lint/format auto, tests YAML, visuels ego-graph, CI build PR ; ☐ section portfolio à ajouter.
-- ☐ V2 : navigation ego-graph avec variantes, multi-cultures, packaging du module.
-
-## 8. Valeur pour recruteurs/lecteurs
-- Stack moderne Astro + Tailwind v4, design system maison (`mk-*`).
-- Modélisation et pipelines : YAML → JSON → Astro, fallback médias, IDs partagés entre front et graphe.
-- UX mobile avec thème clair/sombre, filtres, cartes cohérentes.
-- Maintenance sans CMS : inspecteurs YAML/MD, scripts de génération intégrés au build.
-
-## 9. Licence
-Unlicensed / All rights reserved
+Bonne exploration.

README_CULTUREL.md

@@ -0,0 +1,130 @@
+# Mythoskolis — Explorer la mythologie grecque autrement
+
+Mythoskolis est un projet de **médiation culturelle** consacré à la mythologie grecque.  
+Il s’adresse aux curieux, passionnés, étudiants ou simples visiteurs qui souhaitent **comprendre les mythes grecs sans se perdre**, tout en respectant leur richesse et leur complexité.
+
+Ici, pas de version unique ou définitive des mythes.  
+Mythoskolis propose une autre approche : **montrer comment les récits et les généalogies s’entrelacent, se contredisent parfois, et évoluent selon les sources**.
+
+---
+
+## Pourquoi Mythoskolis ?
+
+La mythologie grecque est souvent présentée :
+- sous forme de récits isolés,
+- ou comme un arbre généalogique figé et simplifié.
+
+Or, dans les sources antiques :
+- les filiations varient,
+- les traditions locales divergent,
+- les récits se superposent et se contredisent.
+
+**Mythoskolis part de ce constat** :  
+la complexité n’est pas un défaut à corriger, mais une richesse à rendre lisible.
+
+---
+
+## Ce que vous pouvez explorer sur Mythoskolis
+
+### Les entités mythologiques
+
+Dieux, déesses, Titans, nymphes, créatures ou figures abstraites disposent de fiches dédiées :
+- identité et rôle mythologique,
+- domaines, symboles, attributs,
+- relations familiales et alliances,
+- liens vers les récits associés.
+
+Chaque fiche est pensée comme une **porte d’entrée**, pas comme une encyclopédie exhaustive.
+
+---
+
+### Les récits mythologiques
+
+Les grands mythes (naissances divines, conflits cosmiques, descentes aux Enfers, métamorphoses…) sont présentés sous forme de récits structurés :
+- contextualisés,
+- reliés aux figures mythologiques concernées,
+- accompagnés de leurs sources antiques.
+
+Les récits servent à **donner chair aux données** et à relier la généalogie à la narration.
+
+---
+
+## Comprendre la généalogie sans se perdre
+
+La généalogie est souvent l’aspect le plus déroutant de la mythologie grecque.  
+Mythoskolis propose une approche progressive et visuelle pour l’explorer.
+
+### Le graphe généalogique (HoloGraph)
+
+Un graphe interactif permet de visualiser :
+- les parents,
+- les fratries,
+- les unions,
+- les descendances.
+
+Dans le mode avancé du module, certaines relations peuvent apparaître en plusieurs versions lorsqu’elles diffèrent selon les sources.  
+Plutôt que de trancher arbitrairement, Mythoskolis **montre ces variantes** et les signale clairement.
+
+---
+
+## Lire sans quitter la page
+
+Mythoskolis intègre un outil de **lecture contextualisée**.
+
+Lors de la lecture :
+- certains termes ou noms sont expliqués directement dans le texte,
+- des rappels contextuels apparaissent sans changer de page,
+- la densité d’informations peut être ajustée selon le confort de lecture.
+
+L’objectif est simple :  
+**éviter les allers-retours incessants** et favoriser une lecture fluide et continue.
+
+---
+
+## Une démarche éditoriale assumée
+
+Mythoskolis n’est :
+- ni un manuel scolaire,
+- ni un travail universitaire,
+- ni une encyclopédie exhaustive.
+
+C’est un projet de **médiation culturelle** qui cherche un équilibre entre :
+- rigueur des sources,
+- clarté pédagogique,
+- plaisir de l’exploration.
+
+Les choix éditoriaux sont assumés :
+- les sources majeures sont privilégiées,
+- les variantes sont signalées,
+- les contradictions sont exposées, pas effacées.
+
+---
+
+## À qui s’adresse Mythoskolis ?
+
+- Aux curieux qui veulent comprendre sans simplifier à l’excès.
+- Aux passionnés de mythologie.
+- Aux étudiants et enseignants en quête d’un support clair.
+- À toute personne qui aime explorer des récits complexes autrement.
+
+---
+
+## Statut du projet
+
+Mythoskolis est un projet vivant, en évolution constante.  
+De nouveaux récits, entités et outils sont ajoutés progressivement.
+
+Le site est pensé comme un **espace d’exploration**, pas comme un catalogue figé.
+
+---
+
+## Accéder au site
+
+👉 https://mythoskolis.com
+
+---
+
+## Licence
+
+Projet personnel et indépendant.  
+Textes, données et outils sont protégés selon les choix éditoriaux du projet.