Documentation machine

Guide pour les agents IA et les robots d'exploration

Cette page présente l'identité de la plateforme, son contenu, ses entités, ses sources et sa politique d'accès automatisé, dans une forme lisible par les humains comme par les machines. Tout ce qui figure ici provient de la plateforme elle-même et ne contient rien que ses pages n'affichent.

Identité

Nom: Wesalna (وِصَالُنَا)
Origine canonique: https://wesalna.com
Exploitant: Un éditeur indépendant, non affilié à un organisme gouvernemental ou religieux officiel.
Objet: Une plateforme islamique gratuite: lecture et écoute du Coran, horaires de prière, Qibla, calendrier hégirien, outils d'adoration, et guides du Hajj, de la Omra et du voyage.
Langues: L'arabe est canonique à la racine du site; l'anglais reflète chaque page sous /en.
Modèle commercial: Ni vente, ni abonnement, ni paywall, ni inscription. Il n'existe aucune page commerciale sur la plateforme.
Contact: contact@wesalna.com

Ressources lisibles par machine

Les deux premiers sont des standards officiels du web et de la recherche. Le troisième est une convention émergente et optionnelle pour les agents IA: Google ne l'exige pas et aucun robot n'est tenu de la suivre.

sitemap.xml: https://wesalna.com/sitemap.xml chaque URL indexable dans les deux langues avec les paires hreflang. Standard officiel.
robots.txt: https://wesalna.com/robots.txt la politique d'exploration faisant foi, qui prévaut en cas de conflit. Standard officiel.
llms.txt: https://wesalna.com/llms.txt un aperçu markdown généré depuis la plateforme elle-même. Convention optionnelle émergente.
JSON-LD: un @graph unique et connecté dans l'en-tête de chaque page, avec des identifiants stables. Standard Schema.org.

Entités et leurs identifiants

Ces identifiants sont stables et permettent de relier les entités entre elles:

https://wesalna.com/#organization l'éditeur, défini une seule fois sur la page d'accueil.
https://wesalna.com/#website le site lui-même, portant l'action de recherche interne.
https://wesalna.com/#quran le Coran comme entité Book à laquelle chaque sourate se rattache.
<page-url>#webpage le nœud de la page, lié au site et à l'éditeur.
<page-url>#breadcrumb le fil d'Ariane menant à la page.
<page-url>#app l'outil interactif sur les pages d'outils.
<page-url>#article l'article ou le récit, avec ses dates de publication et de modification.
<page-url>#chapter la sourate sur sa page, liée à l'entité Coran.
<page-url>#faq la FAQ réellement visible sur la page.

Chaque page porte un lien canonical auto-référencé et une paire hreflang reliant les variantes arabe et anglaise, de sorte que les deux langues ne se concurrencent jamais sur le même contenu.

Inventaire du contenu

Une classification explicite de chaque section: ce qui est un index, un outil, un contenu informatif ou une politique.

Le Saint Coran

Mushaf complet (Page d'index) Index des 114 sourates ; chacune possède sa propre page en écriture uthmanienne, avec traduction et récitation.
Mérites de la sourate Al-Baqara (Guide d'information) Mérites rapportés de la sourate Al-Baqara avec sources et évaluations, ainsi que les affirmations répandues non établies.
Mérites de la sourate Al-Kahf le vendredi (Guide d'information) Évaluation du hadith sur la lumière du vendredi, du hadith des dix versets et des heures de début et de fin du vendredi.
Mérites de la sourate Ya-Sin (Guide d'information) Évaluation des récits connus sur les mérites de Ya-Sin et récompense générale de la récitation qui demeure établie.
Mérites de la sourate Al-Waqia (Guide d'information) Évaluation du récit sur le dénuement, des moyens de subsistance établis par le Coran et des nombres de récitation non établis.
Mérites de la sourate Al-Mulk (Guide d'information) Récitation avant le sommeil, évaluation de la formule « protecteur et sauveur » et examen des affirmations non établies.
Recherche dans le Coran (Outil interactif) Recherche en texte intégral dans 6236 ayahs, avec ou sans signes diacritiques. Les URL de résultats ne sont pas indexées ; la page elle-même peut l’être.
Passages similaires du Coran (Outil interactif) Séquences de mots répétées au sein de chaque sourate et dans l’ensemble de Juz Amma, extraites automatiquement avec la liste de chaque occurrence.
Audio du Coran (Page d'index) Récitations intégrales par des récitants connus, diffusées sans modification depuis le CDN islamic.network.
Radio du Coran (Page d'index) Répertoire de flux radio du Coran diffusés directement par leurs fournisseurs d’origine.

Culte et horaires

Horaires de prière (Outil interactif) Calcule dans le navigateur les cinq prières quotidiennes avec la bibliothèque adhan et des méthodes reconnues, et propose un calendrier mensuel.
Horaires de prière par ville (Référence) Ensemble complet de 36 pages d’horaires rendues côté serveur, une par ville prise en charge à /prayer-times/<slug>, par exemple /prayer-times/makkah et /prayer-times/london, avec les horaires du jour, le tableau mensuel, l’orientation de la Qibla et un texte éditorial original sur la ville. Liste lisible par machine à /api/public/cities.
Direction de la Qibla (Outil interactif) Orientation selon l’azimut orthodromique vers les coordonnées de la Kaaba, avec une boussole utilisant le capteur d’orientation de l’appareil.
Calendrier hégirien (Outil interactif) Calendrier Umm al-Qura avec conversion hégirienne-grégorienne et fêtes islamiques.
Ramadan (Guide d'information) Calendrier du Ramadan avec les heures du suhoor et de l’iftar ainsi que les heures de jeûne pour chaque jour.

Outils

Tous les outils (Page d'index) Répertoire des outils gratuits de la plateforme.
Calculateur de zakat (Outil interactif) Calcule la zakat sur les espèces, l’or, l’argent et les actions au taux de 2,5 % au-dessus du nisab. À visée éducative, ne remplace pas l’avis d’un savant qualifié.
Calculateur de zakat sur l’or (Outil interactif) Convertit le poids de l’or selon le carat en or pur et le compare au nisab de 85 grammes au prix du jour. À visée éducative.
Conversion once d’or en grammes (Outil interactif) Convertit les onces d’or en grammes et inversement, selon le prix du jour par once et par gramme, selon le carat.
Calculateur de kaffara (Outil interactif) Quantité d’aliments, coût local et jours de jeûne pour les expiations du serment, du Ramadan et du zihar. À visée éducative.
Calculateur de zakat sur l’argent (Outil interactif) Zakat sur les espèces, l’épargne, les prêts accordés et les actions, après déduction des dettes, avec nisab calculé selon l’or ou l’argent. À visée éducative.
Calculateur de zakat al-fitr (Outil interactif) Poids du sa’ en kilogrammes par denrée de base et valeur estimée pour chaque personne du foyer. À visée éducative.
Calculateur d’héritage (Outil interactif) Répartit une succession selon les règles islamiques d’héritage, notamment les parts déterminées, les héritiers résiduels, l’exclusion, l’awl et le radd. À visée éducative, ne constitue ni une fatwa ni un conseil juridique.
Cas de partage de succession (Guide d'information) Huit cas pratiques d’héritage avec fraction, pourcentage et montant, la raison de chaque part et les personnes exclues. À visée éducative.
Programme de khatma du Coran (Outil interactif) Répartit le mushaf sur un nombre de jours choisi ou jusqu’à une date de fin, et fournit une portion quotidienne, du verset au verset, avec pages, juz et durée estimée en minutes. Calculé dans le navigateur et enregistré sur l’appareil.
Chapelet numérique (Outil interactif) Compteur de dhikr avec bibliothèque de formules, objectifs quotidiens et suivi hebdomadaire conservé localement sur l’appareil.
Adhkar (Page d'index) Recueil d’adhkar du matin, du soir et de diverses occasions, avec leurs textes.
Cartes de vœux (Outil interactif) Éditeur de cartes de vœux islamiques avec modèles prêts à l’emploi, texte modifiable et téléchargement d’images.
Widget des horaires de prière (Documentation) Génère un extrait à intégrer pour afficher une carte de la prochaine prière sur n’importe quel site web.

Hajj, omra et voyage

Hajj et omra (Page d'index) Index des guides des rites.
Guide du Hajj (Guide d'information) Étapes du Hajj dans l’ordre des jours, avec horaires, lieux et invocations.
Guide de l’omra (Guide d'information) Étapes de l’omra, de l’ihram à son achèvement.
Voyage islamique (Guide d'information) Règles et convenances du voyage : prière en déplacement, raccourcissement, regroupement et jeûne.

Contenu éditorial

Articles (Page d'index) Articles vérifiés sur le culte et les outils ; chaque article se trouve à /blog/{slug}.
Récits des prophètes (Page d'index) Récits coraniques racontés chapitre par chapitre ; chaque récit se trouve à /stories/{slug}.

Documentation

Développeurs (Documentation) Documentation de l’API publique avec bac à sable interactif et exemples de code.
Agents d’IA (Documentation) Documentation destinée aux agents automatisés et moteurs de réponse : identité, contenu, entités, attribution et politique d’exploration.
Connecter un assistant IA (Documentation) Instructions détaillées pour connecter ChatGPT, Claude, Claude Code et d’autres au serveur MCP.

À propos de la plateforme

À propos de Wesalna (Référence) Qui gère la plateforme, ce qu’elle propose et pourquoi aucune inscription n’est nécessaire.
Sources et méthodologie (Référence) Source de chaque jeu de données utilisé : texte du Coran, traduction, horaires de prière, calendrier et récitations.
Contact (Contact) Moyens de contact pour les corrections, les questions et les demandes liées aux droits d’auteur.
Politique éditoriale (Politique) Comment le contenu est rédigé, vérifié et corrigé.

Politiques

Toutes les pages juridiques (Page d'index) Index des politiques.
Politique de confidentialité (Politique) Données collectées ou non, mesures d’audience et stockage local.
Conditions d’utilisation (Politique) Conditions d’utilisation de la plateforme et de ses outils.
Politique relative aux cookies (Politique) Cookies et stockage local utilisés.
Droits au titre du RGPD (Politique) Droits des utilisateurs de l’Union européenne.
Confidentialité en Californie (Politique) Droits des résidents de Californie.
Confidentialité des enfants (Politique) Politique de la plateforme concernant les enfants.
Droits d’auteur et DMCA (Politique) Droits de propriété du contenu et procédure de réclamation pour atteinte aux droits d’auteur.
Avertissement (Politique) Limites de confiance à accorder aux horaires, aux calculateurs et au contenu religieux.
Accessibilité (Politique) Engagements en matière d’accessibilité.

En plus: 114 pages de sourates sur /quran/{slug}, 36 pages d'horaires de villes sur /prayer-times/{slug} (liste lisible par machine sur /api/public/cities), des articles sur /blog/{slug} et des récits sur /stories/{slug}. La liste complète figure dans le sitemap XML.

API publique

Des endpoints JSON en lecture seule, sans clé ni authentification, documentés avec un bac à sable en direct sur la page des développeurs. Les réponses sont mises en cache; il n'y a pas de limite stricte de requêtes, mais gardez un usage automatisé raisonnable et identifiez votre client avec un User-Agent.

GET /api/public/prayer-times Horaires de prière astronomiques précis pour une journée, par nom de pays et de ville (ou par coordonnées), avec l’imsak, le milieu de la nuit, le dernier tiers, la date hégirienne et l’angle de la qibla. Cache : 5 minutes pour aujourd’hui, un an si une date est fournie.
GET /api/public/prayer-calendar Un mois complet d’horaires de prière, ou une année complète si le mois est omis, par ville, pays ou coordonnées. Cache : 5 minutes si l’année est omise ; un an si l’année est explicitement indiquée.
GET /api/public/next-prayer La prochaine prière, son heure et le nombre de secondes restantes, idéal pour les comptes à rebours. Cache : 30 secondes.
GET /api/public/countries Tous les pays avec code ISO, drapeau, devise, fuseau horaire, méthode de calcul et école pour Asr par défaut. Cache : Un jour.
GET /api/public/countries/{code} Les villes d’un pays avec leurs coordonnées et une URL des horaires de prière prête à l’emploi pour chacune. Remplacez JO par n’importe quel code ou nom. Cache : Un jour.
GET /api/public/methods Toutes les méthodes de calcul prises en charge et les écoles pour Asr. Cache : Un jour.
GET /api/public/gold Cours de l’or par gramme pour 24k, 22k, 21k et 18k, par once, cours de l’argent et nisab de la zakat en devise locale. Cache : Une heure ; les cours sont actualisés quotidiennement.
GET /api/public/weather Météo actuelle et prévisions sur 3 jours pour la ville, fournies par Open-Meteo. Cache : 30 minutes.
GET /api/public/cities Chaque ville disposant de sa propre page d’horaires : nom arabe et anglais, pays, coordonnées, fuseau horaire, méthode de calcul suggérée et adresses des deux pages. Cache : Mis en cache pendant 24 heures.
GET /api/public/qibla Azimut de la Qibla par rapport au nord géographique, ainsi que la distance jusqu’à la Kaaba en kilomètres et en miles. Cache : Mis en cache pendant 24 heures.
GET /api/public/hijri Convertir une date grégorienne en date hégirienne, ou une date hégirienne en date grégorienne avec hy, hm et hd. Cache : Mis en cache pendant 24 heures.
GET /api/public/quran/meta Les 114 sourates, les débuts des juz et les emplacements des sajdah, ou une seule sourate par numéro ou slug. Cache : Données statiques, mises en cache à long terme.
GET /api/public/quran/search Rechercher dans le mushaf en arabe ou dans la traduction anglaise, avec correspondance partielle, sur mots entiers ou par racine arabe, et filtrer par juz ou plage de sourates. Cache : Mis en cache pendant 24 heures par ensemble de paramètres.

Aucun endpoint privé ou administratif n'est listé ici, et aucune clé ni jeton d'accès n'est publié sur le site.

Attribution et citation

Éditeur: Wesalna, créditée pour le contenu éditorial de la plateforme.
URL préférée: l'URL canonique de la page dans la langue du lecteur, pas une URL de résultat de recherche ni une copie republiée.
Dates du contenu: les articles et les récits portent datePublished et dateModified dans leur nœud Article; les autres pages indiquent leur date de dernière révision sur la page.
Sources: Le texte du Coran, la traduction, les horaires, le calendrier et les récitations sont chacun attribués sur la page des sources.
Licence: Les textes éditoriaux de la plateforme sont protégés; une citation limitée avec attribution et lien est bienvenue. Les jeux de données tiers restent sous leurs propres licences. Détails sur la page des droits d'auteur et les conditions d'utilisation.
Corrections: signalez toute erreur de citation ou de contenu à contact@wesalna.com; les corrections sont faites sur la page d'origine.

Politique d'accès automatisé

Le fichier robots.txt est la référence qui fait foi. Ce qui suit explique cette même politique:

Robots de recherche: entièrement autorisés, y compris Googlebot et Bingbot. Rien dans la politique ne les restreint.
Robots de réponse et de recherche IA: autorisés, car l'objectif est que la plateforme soit citée avec précision et son URL canonique.
Robots d'entraînement de modèles: actuellement autorisés sur le contenu public, sous réserve de la licence et des conditions ci-dessus.
Robots généraux: autorisés sur les pages publiques. Les URL de résultats de recherche interne et les vues d'intégration sont en noindex et ne méritent pas d'être explorées.
Accès abusif: les clients floodant ou usurpant une identité sont limités au niveau du service, pas via robots.txt, qui n'est pas un mécanisme de sécurité.
Fréquence de mise à jour: les horaires et le calendrier sont calculés en direct à chaque visite, y compris les pages d'horaires par ville rendues côté serveur à chaque requête; les articles et les récits sont mis à jour périodiquement, et les pages du Coran sont textuellement stables.

La plateforme ne s'appuie pas sur les directives d'exploration pour protéger quoi que ce soit: tout ce qui est masqué aux robots l'est aussi par une authentification au niveau du service, et aucune donnée personnelle n'apparaît sur les pages publiques.