meridian-Dokumentation
Anleitungen zu Dashboard, Abonnements und API-Verhalten.
Erste Schritte
meridian ist ein Wetter-Dashboard für mehrere Orte gleichzeitig. Suchen Sie eine Stadt, öffnen Sie ihre Seite, heften Sie sie unter Ihre Orte an und behalten Sie Temperatur, Bedingungen und kurze Prognosen im Blick. Sie brauchen kein Konto. Ihre angehefteten Städte und die meisten Einstellungen bleiben auf diesem Gerät.
Dashboard
Von oben nach unten: 1. Hero — Willkommenstext, Suche und eine schnelle Wetterprüfung für Ihren Standort. 2. Ihre Orte — Wetterkarten für die angehefteten Orte. 3. In der Nähe & beliebt — zwei Spalten: In Ihrer Nähe und Beliebte Suchen. 4. Eine Dashboard-Anzeige unter Ihre Orte (Platzhalter oder AdSense). 5. Journal — Artikelkarussell. Mit NEXT_PUBLIC_SHOW_HOME_STRETCH=0 lassen sich Anzeige und Journal ausblenden.
Stadt-Detail
Suchergebnisse und Startkarten öffnen eine Seite für diesen Ort. Sie müssen eine Stadt nicht anheften, um sie anzusehen. Anheften fügt sie nur zu Ihre Orte auf der Startseite hinzu. Einige Showcase-Städte und der Seite bereits bekannte Orte öffnen immer; unbekannte Adressen zeigen einen hilfreichen Leerzustand oder 404.
Abonnements
Sie können meridian bitten, Ihnen E-Mails zu senden — ohne Anmeldung. Wählen Sie einen Newsletter über das Produkt, einen wöchentlichen Digest für eine angeheftete Stadt und/oder Wetterwarnungen, wenn Bedingungen Ihren Kriterien entsprechen. Alles ist Opt-in; jede E-Mail enthält eine Möglichkeit zum Abbestellen.
Monetarisierung & Einwilligung
meridian läuft als kostenlose Wetterseite. Es gibt keinen funktionierenden Premium-Checkout oder bezahlten Plan, der Werbung entfernt. Werbung erscheint nur, wenn Sie Werbeeinwilligung erteilen und der Betreiber Google AdSense konfiguriert hat.
Wetter-Icons
Wetterbilder auf Karten und Prognosen sind klare Linien-/Füll-Icons (Meteocons von Bas Milius, MIT-Lizenz). Sie zeigen Sonne, Wolken, Regen, Schnee, Nebel und ähnliche Bedingungen neben der Textbeschreibung — der Text trägt die Bedeutung, falls ein Bild nicht lädt.
In der Nähe & beliebt
Unter Ihre Orte zeigt die Startseite zwei kurze Ortslisten. In Ihrer Nähe — vorgeschlagene Orte nahe Ihrem Zuhause oder Ihrer Region, mit Live-Bedingungen. Das ist kein privates Protokoll aller Ihrer Suchen. Beliebte Suchen — Orte, die auf dieser Seite oft gesucht werden. Auch das ist seitenweit, nicht „Ihr persönlicher Verlauf“.
Prognosen & Cache
Alltagsbesucher können diese Seite überspringen. Sie erklärt, wie die Seite Wetterdaten speichert und aktualisiert — für Betreiber oder Integratoren von meridian. Kurz: Ihr Browser merkt sich eine aktuelle Messung; der Server merkt sich gemeinsame Messungen, damit wir nicht bei jedem Klick den Wetteranbieter aufrufen.
API-Limits
Diese Seite richtet sich an Seitenbetreiber. Besuchte Wetterdaten werden geteilt und cache-freundlich gehalten, damit OpenWeather-Free-Tier-Limits (Standard 1000 Aufrufe/Tag) seltener verbrannt werden.
API-Referenz
Diese Seite richtet sich an Entwickler und Betreiber, die meridian-APIs integrieren — Alltagsbesucher können sie überspringen. Alle API-Routen sind Next.js App Router Handler unter src/app/api/. Wetter und Geocode brauchen OPENWEATHER_API_KEY. Cron-Routen brauchen Authorization: Bearer CRON_SECRET. Admin-Routen brauchen authentifiziertes Admin-Session-Cookie (meridian_admin_session) nach Anmeldung unter /login, außer ALLOW_DEV_ADMIN_BYPASS greift in der Entwicklung.
Deployment & Umgebung
Diese Seite richtet sich an Personen, die meridian deployen. Alltagsbesucher brauchen diese Einstellungen nicht. Eine funktionierende Demo braucht nur OPENWEATHER_API_KEY; alles andere ist optionaler Stretch.