Barghman
Einfacher HTTP-Server, der abonnierbare ICS-Kalenderfeeds für Stromausfallpläne im Iran bereitstellt. Enthält eine schöne Weboberfläche, die mit Tailwind CSS erstellt wurde, zum Anzeigen und Verwalten von Stromausfallplänen.
Hauptfunktionen
- Schöne Weboberfläche: Einfaches, intuitives Formular zum Eingeben von Rechnungs-ID und Auth-Token
- Ereignisansicht: Schöne Zeitleistenanzeige von Stromausfallereignissen
- Lokaler Speicher: Speichert Ihre Anmeldedaten automatisch für Bequemlichkeit
- Kalenderabonnement: Ein-Klick-Kopieren von URLs für jede Kalender-App
- Responsives Design: Perfekt auf Mobilgerät, Tablet und Desktop
- Blitzschnell: Erstellt mit Bun für maximale Leistung
- Einzelne Binärdatei: Bereitstellung ohne Abhängigkeiten
Tech-Stack
Barghman ist ein einfacher, aber leistungsstarker HTTP-Server, der abonnierbare ICS-Kalenderfeeds für Stromausfallpläne im Iran bereitstellt. Erstellt mit Bun für maximale Leistung, löst er ein reales Problem für iranische Einwohner, die über geplante Stromausfälle informiert bleiben müssen.
Das Projekt begann als einfacher API-Server, entwickelte sich aber weiter, um eine wunderschöne Weboberfläche zu enthalten, die mit Tailwind CSS erstellt wurde. Die Startseite verfügt über ein klares, intuitives Formular, in dem Benutzer ihre Rechnungs-ID und ihr Auth-Token eingeben können. Anmeldedaten werden automatisch im Browser-LocalStorage gespeichert, um Bequemlichkeit zu gewährleisten und die Notwendigkeit zu eliminieren, sie bei jedem Besuch erneut einzugeben.
Die Ereignisansicht ist besonders beeindruckend. Sie zeigt Stromausfallereignisse in einem schönen Zeitleistenformat an, wobei jeder Ausfall in attraktiven Karten angezeigt wird, die nach Datum gruppiert sind. Jede Ereigniskarte zeigt reichhaltige Details einschließlich Dauer, Adresse, Grund und Tracking-Codes. Wenn keine Ausfälle geplant sind, feiert die Oberfläche mit einer freundlichen leeren Zustandsnachricht.
Eine der nützlichsten Funktionen ist die Kalenderabonnement-Funktionalität. Benutzer können ICS-Kalender-URLs mit einem Klick generieren, die zu jeder Kalenderanwendung hinzugefügt werden können—Google Calendar, Apple Calendar, Outlook oder mobile Kalender-Apps. Der Kalender aktualisiert sich automatisch, wenn neue Ausfälle geplant werden, und hält Benutzer informiert, ohne manuelle Überprüfung.
Die technische Implementierung ist elegant. Erstellt mit Bun-Laufzeitumgebung für blitzschnelle Leistung, verwendet der Server saubere HTML-Vorlagen, die vom TypeScript-Code getrennt sind. Tailwind CSS bietet schönes responsives Design über CDN und stellt sicher, dass die Oberfläche auf Mobilgeräten, Tablets und Desktop-Geräten großartig aussieht.
Sicherheit und Datenschutz haben Priorität. Auth-Tokens werden niemals protokolliert oder preisgegeben, Benutzeranmeldedaten werden nur im Browser-LocalStorage gespeichert und keine Benutzerdaten werden auf dem Server gesammelt. Der Server ist HTTPS-ready und funktioniert nahtlos hinter Reverse-Proxies mit SSL.
Die Bereitstellung ist unkompliziert mit einer einzelnen Binärdatei ohne Abhängigkeiten. Der Server kann als einfache Binärdatei, systemd-Service oder Docker-Container bereitgestellt werden. Nginx-Reverse-Proxy-Konfiguration ist für Produktionsbereitstellungen enthalten.
Barghman demonstriert, wie eine einfache, fokussierte Lösung ein reales Problem elegant lösen kann. Durch die Kombination einer sauberen API mit einer schönen Weboberfläche macht es das Informiertbleiben über Stromausfälle für iranische Einwohner mühelos.