Verwenden Sie den obigen Einzeiler oder nutzen Sie die [`docker-compose.yml`](https://github.com/Lissy93/domain-locker/blob/main/docker-compose.yml)

<details>
	<summary>Details</summary>

 
- **Voraussetzungen**:
  - Domain Locker ist für den Betrieb in einem Container vorgesehen, daher benötigen Sie Docker, das auf Ihrem Host-System [installiert](https://docs.docker.com/engine/install/) ist.
- **Container**:
  - Wir haben ein Docker-Image unter [`lissy93/domain-locker`](https://hub.docker.com/r/lissy93/domain-locker) veröffentlicht.
  - Sie benötigen außerdem eine Postgres-Datenbank, z. B. den Container [`postgres:15-alpine`](https://hub.docker.com/_/postgres?tab=tags&name=15-alpine).
- **Umgebung**:
  - Beim Starten des Containers binden Sie `3000` im Container an Ihren Host-`PORT` (Standard: `3000`).
  - Geben Sie dann die Postgres-Variablen an: `DL_PG_HOST`, `DL_PG_PORT`, `DL_PG_USER`, `DL_PG_PASSWORD` und `DL_PG_NAME`.
- **Volumes**:
  - Mounten Sie ein Volume auf `/var/lib/postgresql/data`, um Ihre Postgres-Daten dauerhaft zu speichern.
- **Crons**:
  - `/api/domain-updater` – Führen Sie dies täglich aus, um die Domaindaten aktuell zu halten und Benachrichtigungen auszulösen.
  - `/api/domain-monitor` – Führen Sie dies alle 15 Minuten aus, um die Verfügbarkeit und Leistung der Website zu überwachen.
  - `/api/cleanup-monitor-data` – Führen Sie dies wöchentlich aus, um alte Überwachungsdaten zu aggregieren.

- **Beispiel**:
  - Alles zusammen: Sie können unsere [`docker-compose.yml`](https://github.com/Lissy93/domain-locker/blob/main/docker-compose.yml)-Datei verwenden.
  - Weitere Details finden Sie in der [Self-Hosting-Dokumentation](https://domain-locker.com/about/self-hosting).


<details>
<summary>Docker-Diagramm</summary>```mermaid
flowchart TB
  subgraph Volume Mounts
    direction TB
    Vpostgresdata([📦 postgres_data]) x-. /var/lib/postgresql/data .-x postgres[(🐘 PostgreSQL DB)]
    Vdbschemasql{{📄 ./db/schema.sql}} -. Mounted on Init .-> postgres
  end

  subgraph Network
    direction TB
    domainlockernetwork[/🌐 domain_locker_network/]
  end

  postgres -.- domainlockernetwork

  subgraph app[⚙️ App Container]
    SSR[HTTP Server]
    CLIENT[Client App]
    API[API Endpoints]
    SSR --> CLIENT
    SSR --> API
  end

  app -.- domainlockernetwork

- **Voraussetzungen**
  - Sie benötigen Git und Node auf Ihrem System installiert.
- **Konfiguration**
  - Die Beispiel-Datei `.env.sample` enthält die öffentlichen Anmeldeinformationen für unsere Supabase-Entwicklungsinstanz.
  - Um eine alternative Datenbank zu verwenden, lesen Sie den Abschnitt [Datenbank](#database) weiter unten zur Konfiguration mit Postgres.
- **Bereitstellung**
  - Sie können den Code mit `npm run build` erstellen und dann mit `npm start` ausführen.
  - Oder mit Docker, indem Sie den Container mit `docker build -t domain-locker .` erstellen.
  - Verwenden Sie die Entwicklungs-Supabase-Instanz nicht in der Produktion, da sie häufig zurückgesetzt wird.

---

## App-Architektur

#### Technologie-Stack

Domain Locker besteht aus einer Anwendung, einer Datenbank und einigen API-Endpunkten.
- **Die App** ist mit Angular erstellt, unter Verwendung von Analog+Nitro mit PrimeNg-Komponenten und Tailwind für das Styling.
- **Der Server** ist eine Reihe von Deno-Endpunkten mit TypeScript-Funktionen.
- **Die Datenbank** kann entweder Postgres oder Supabase sein.

Während die selbst gehostete Instanz als eigenständige Bereitstellung gedacht ist, hängt die verwaltete Version jedoch von einigen zusätzlichen Drittanbieterdiensten ab, die Sie unten sehen können; [die Dokumentation dazu finden Sie hier](https://domain-locker.com/about/developing/third-party-docs).

<details>
<summary>Warum</summary>
Warum Angular? Als eine Art kranker Scherz für mein zukünftiges Ich, das dies dann warten muss.
</details>


<p align="center">
<img width="800" src="https://assets.kitploit.com/production/public/readmes/264/1449d16cb6a07bd766d3b86a8de608aaa4075270a0a634cd6f6af1f1a1d70c49.png" />
<br>
<span>Sie können die Dokumentation für die verwendeten Technologien und Dienste <a href="https://domain-locker.com/about/developing/third-party-docs">hier</a> einsehen</span>
</p>


#### Architektur

Die Architektur ist recht einfach.
Wir haben eine App (bestehend aus einem Frontend und API-Endpunkten), in der der Benutzer Daten aus der Datenbank lesen und in sie schreiben kann (über Adapter). Ein Cron-Dienst ruft dann regelmäßig API-Endpunkte auf, um Domain-Daten aktuell zu halten, Änderungen zu verfolgen, den Zustand zu überwachen und bei bestimmten Änderungen (gemäß Benutzereinstellungen) oder vor einem bevorstehenden Ablauf Benachrichtigungen auszulösen.```mermaid
graph TD;
    subgraph User Interactions
        User[👤 User] -->|Enter domain| WebApp[🌐 Frontend];
        WebApp -->|Send API request| API[⚙️ Nitro API];
        API -->|Auth Check| Auth[🔐 Auth Service];
        API -->|Store domain info| Database[🗄️ PostgreSQL / Supabase];
    end

    subgraph Automated Cron Jobs
        CronService[⏳ Cron Service] -->|Trigger Updates| EdgeFunctions[⚡ Edge Functions];
        EdgeFunctions -->|Fetch WHOIS, DNS, SSL| ExternalAPIs[🌎 Analysis Services];
        EdgeFunctions -->|Store Data| Database;
        
        CronService -->|Monitor Uptime| WebsiteMonitor[📡 Uptime Monitor];
        WebsiteMonitor -->|Store Metrics| Database;

        CronService -->|Check Expirations| ExpiryChecker[📆 Expiration Check];
        ExpiryChecker -->|Update Status| Database;
        
        CronService -->|Send Notifications| NotificationService[🔔 Notification System];
        NotificationService -->|Email| Resend[📧 Resend];
        NotificationService -->|SMS| Twilio[📱 Twilio];
    end

    Database -->|Serve Data| WebApp;

<p align="center"><sub>Sie können das Schema herunterladen von <a href="https://github.com/Lissy93/domain-locker/blob/main/db/schema.sql"<code>db/schema.sql</code></a></sub></p>

---

### Mitwirken

Beiträge jeglicher Art sind jederzeit willkommen und sehr geschätzt! 💗

Wenn Sie neu bei Git sind, ist der allgemeine Ablauf für Beiträge wie folgt:
- Forken Sie das Repository, indem Sie [hier klicken](https://github.com/lissy93/domain-locker/fork)
- Klonen Sie Ihren Fork (mit `git clone [email protected]:[Ihr_Benutzername]/domain-locker.git`)
- Folgen Sie der [Projekt-Einrichtung](#project-setup) oben, um das Projekt im Entwicklungsmodus zum Laufen zu bringen
- Implementieren Sie Ihre großartige neue Funktion oder Ihren erstaunlichen Bugfix...
- Wechseln Sie zu einem Branch mit `git checkout -b feature-branch`, dann `git add` Sie Ihre Änderungen und `git commit` Sie mit konventionellen Commits, bevor Sie mit `git push` auf Ihren Branch pushen
- Gehen Sie zurück zu GitHub und öffnen Sie dann einen PR gegen unseren `main`-Branch. Vergessen Sie nicht, anzugeben, was Sie geändert haben, warum und verlinken Sie zugehörige Issues.
- Wir werden dann überprüfen, Feedback geben und zusammenführen. Sobald die Änderungen veröffentlicht sind, werden sie in der Produktion live gehen und auch im neuesten Docker-Image verfügbar sein.

<details>
	<summary>Git Branch Beispiel</summary>```mermaid
%%{init: {"theme": "default"}}%%
gitGraph
    commit id: "Initial commit"
    branch trunk
    commit id: "Feature A"
    commit id: "Feature B"
    commit id: "v1.0.0 (Tag)"
    branch demo
    checkout main
    commit id: "Feature C"
    commit id: "v1.1.0 (Tag)"
    checkout demo
    merge main id: "Merge main into demo"
    checkout main
    commit id: "Feature D"
    commit id: "v1.2.0 (Tag)"
    checkout demo
    merge main id: "Merge main into demo (v1.2.0)"
    checkout main
    branch feature-branch-1
    commit id: "Contributor Feature 1"
    checkout main
    merge feature-branch-1 id: "Merge contributor feature 1"
    commit id: "v1.3.0 (Tag)"
    checkout demo
    merge main id: "Merge main into demo (v1.3.0)"
    checkout main
    branch feature-branch-2
    commit id: "Contributor Feature 2"
    checkout main
    merge feature-branch-2 id: "Merge contributor feature 2"
    commit id: "v1.4.0 (Tag)"
    checkout demo
    merge main id: "Merge main into demo (v1.4.0)"