documentation meridian
Guides pour le tableau de bord, les abonnements et le comportement de l’API.
Premiers pas
meridian est un tableau de bord météo pour plusieurs lieux à la fois. Recherchez une ville, ouvrez sa page, épinglez-la dans Vos lieux et suivez température, conditions et courtes prévisions. Aucun compte requis. Vos villes épinglées et la plupart des préférences restent sur cet appareil.
Tableau de bord
De haut en bas : 1. Hero — texte de bienvenue, recherche et vérification météo rapide de votre position. 2. Vos lieux — cartes météo pour les endroits épinglés. 3. À proximité et populaire — deux colonnes : Près de vous et Recherches populaires. 4. Une publicité sous Vos lieux (placeholder ou AdSense). 5. Journal — carrousel d’articles. Masquer l’annonce et le Journal avec NEXT_PUBLIC_SHOW_HOME_STRETCH=0.
Détail de la ville
Les résultats de recherche et les cartes d’accueil ouvrent une page pour ce lieu. Vous n’avez pas besoin d’épingler une ville pour la consulter. L’épinglage l’ajoute seulement à Vos lieux sur l’accueil. Quelques villes vitrine et les lieux déjà connus du site s’ouvrent toujours ; les adresses inconnues affichent un état vide utile ou une 404.
Abonnements
Vous pouvez demander à meridian de vous envoyer des e-mails — sans connexion. Choisissez une newsletter sur le produit, un récapitulatif hebdomadaire pour une ville épinglée et/ou des alertes météo quand les conditions correspondent à ce qui vous intéresse. Tout est sur inscription volontaire ; chaque e-mail inclut un moyen de se désabonner.
Monétisation et consentement
meridian fonctionne comme un site météo gratuit. Il n’y a pas de paiement Premium fonctionnel ni de forfait payant supprimant les annonces. La publicité n’apparaît que si vous autorisez le consentement publicitaire et que l’opérateur a configuré Google AdSense.
Icônes météo
Les images météo sur les cartes et prévisions sont des icônes ligne/remplissage claires (Meteocons par Bas Milius, licence MIT). Elles montrent soleil, nuages, pluie, neige, brouillard et conditions similaires à côté de la description écrite — le texte porte le sens si une image ne charge pas.
À proximité et populaire
Sous Vos lieux, l’accueil affiche deux courtes listes de lieux. Près de vous — lieux suggérés près de votre domicile ou région, avec conditions en direct. Ce n’est pas un journal privé de tout ce que vous avez recherché. Recherches populaires — lieux souvent recherchés sur ce site. Là aussi, c’est à l’échelle du site, pas « votre historique personnel ».
Prévisions et cache
Les visiteurs quotidiens peuvent ignorer cette page. Elle explique comment le site stocke et rafraîchit les données météo pour ceux qui exploitent ou intègrent meridian. En termes simples : votre navigateur retient un relevé récent ; le serveur retient aussi des relevés partagés pour ne pas appeler le fournisseur météo à chaque clic.
Limites API
Cette page s’adresse aux personnes qui gèrent le site. Les données météo consultées sont partagées et favorables au cache pour que les limites OpenWeather gratuites (défaut 1000 appels/jour) soient moins souvent épuisées.
Référence API
Cette page s’adresse aux développeurs et opérateurs intégrant les API meridian — les visiteurs quotidiens peuvent l’ignorer. Toutes les routes API sont des handlers Next.js App Router sous src/app/api/. Météo et geocode nécessitent OPENWEATHER_API_KEY. Les routes cron nécessitent Authorization: Bearer CRON_SECRET. Les routes admin nécessitent un cookie de session admin authentifié (meridian_admin_session) après connexion sur /login, sauf ALLOW_DEV_ADMIN_BYPASS en développement.
Déploiement et environnement
Cette page s’adresse aux personnes déployant meridian. Les visiteurs quotidiens n’ont pas besoin de ces réglages. Une démo fonctionnelle ne nécessite que OPENWEATHER_API_KEY ; tout le reste est du stretch optionnel.