Maintainer Email Service

Modern, biztonságos és könnyen bővíthető webalkalmazás Uptime Kuma és Authentik integrációhoz.

Főbb Funkciók

• Uptime Kuma Integráció:
  • Valós idejű: Webhook fogadása karbantartási eseményekről.
  • Ütemezett: Socket.io API-n keresztül lekéri a jövőbeli karbantartásokat.
• Authentik Szinkronizáció: Felhasználók és csoportok lekérése API-n keresztül.
• Fejlett Csoport Mappolás:
  • Many-to-Many kapcsolat Uptime Kuma monitor csoportok és Authentik felhasználói csoportok között.
• Automatikus Értesítések:
  • Azonnali: Amikor egy szolgáltatás karbantartás alá kerül.
  • Emlékeztetők: Konfigurálható időpontokban (alapértelmezetten 24 órával és 1 órával a kezdés előtt).
• Hírlevél Modul: Prémium HTML emailek küldése kiválasztott csoportoknak.
• Felhasználókezelés: Munkatársak meghívása és fiókok adminisztrálása.

Telepítés (Docker Compose)

docker compose up -d

Konfiguráció

1. Uptime Kuma

• Állítsa be a KUMA_URL, KUMA_USER, KUMA_PASS adatokat a Beállítások menüben.
• A Webhook URL-t (/api/webhook) adja hozzá az Uptime Kuma értesítésekhez.

2. Ütemezett Feladatok (Cron)

A jövőbeli karbantartási emlékeztetők küldéséhez egy külső cron jobnak vagy időzítőnek meg kell hívnia az alábbi végpontot (ajánlott percenként): GET https://maintainer.gyurus.hu/api/cron

3. Authentik Meghívók

Az Authentik meghívó flow-t a Beállítások menüben konfigurálhatja. A "Meghívás" gomb a megadott URL-re irányítja a munkatársakat (pl. az Authentik regisztrációs oldalára).

Fejlesztés

npm install
npx prisma migrate dev
npm run dev