`docker-compose.yml`](https://github.com/Lissy93/domain-locker/blob/main/docker-compose.yml) का उपयोग करें।

<details>
	<summary>विवरण</summary>

 
- **पूर्वापेक्षाएँ**:
  - Domain Locker को कंटेनर में चलाने के लिए डिज़ाइन किया गया है, इसलिए आपको अपने होस्ट सिस्टम पर Docker [स्थापित](https://docs.docker.com/engine/install/) होना चाहिए।
- **कंटेनर**:
  - हमारे पास [`lissy93/domain-locker`](https://hub.docker.com/r/lissy93/domain-locker) पर एक Docker इमेज प्रकाशित है।
  - आपको एक Postgres डेटाबेस की भी आवश्यकता होगी, जैसे [`postgres:15-alpine`](https://hub.docker.com/_/postgres?tab=tags&name=15-alpine) कंटेनर।
- **पर्यावरण**:
  - कंटेनर शुरू करते समय, कंटेनर में `3000` को अपने होस्ट `PORT` से बाँधें (डिफ़ॉल्ट `3000` है)।
  - फिर Postgres वेरिएबल निर्दिष्ट करें: `DL_PG_HOST`, `DL_PG_PORT`, `DL_PG_USER`, `DL_PG_PASSWORD` और `DL_PG_NAME`।
- **वॉल्यूम**:
  - अपने Postgres डेटा को स्थायी रखने के लिए `/var/lib/postgresql/data` पर एक वॉल्यूम माउंट करें।
- **क्रॉन**
  - `/api/domain-updater` - डोमेन डेटा को अद्यतित रखने और सूचनाएँ ट्रिगर करने के लिए प्रतिदिन निष्पादित करें।
  - `/api/domain-monitor` - वेबसाइट अपटाइम और प्रदर्शन की निगरानी के लिए हर 15 मिनट में निष्पादित करें।
  - `/api/cleanup-monitor-data` - पुराने मॉनिटरिंग डेटा को समेकित करने के लिए साप्ताहिक निष्पादित करें।

- **उदाहरण**:
  - सब कुछ एक साथ रखने के लिए, आप हमारी [`docker-compose.yml`](https://github.com/Lissy93/domain-locker/blob/main/docker-compose.yml) फ़ाइल का उपयोग कर सकते हैं।
  - अधिक विवरण के लिए, [स्व-होस्टिंग दस्तावेज़](https://domain-locker.com/about/self-hosting) देखें।


<details>
<summary>डॉकर आरेख</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

- **पूर्वापेक्षाएँ**
  - आपको अपने सिस्टम पर Git और Node स्थापित करने की आवश्यकता होगी।
- **कॉन्फ़िगरेशन**
  - उदाहरण `.env.sample` फ़ाइल में हमारे Supabase dev इंस्टेंस के लिए सार्वजनिक क्रेडेंशियल्स शामिल हैं
  - वैकल्पिक db का उपयोग करने के लिए, Postgres के साथ कॉन्फ़िगर करने हेतु नीचे [Database](#database) अनुभाग देखें
- **परिनियोजन**
  - आप `npm run build` के साथ कोड बना सकते हैं, फिर `npm start` के साथ चला सकते हैं
  - या, Docker के साथ कंटेनर बनाने के लिए `docker build -t domain-locker .`
  - उत्पादन में dev Supabase इंस्टेंस का उपयोग न करें, क्योंकि इसे बार-बार साफ़ किया जाता है

---

## ऐप आर्किटेक्चर

#### टेक स्टैक

डोमेन लॉकर एक ऐप, डेटाबेस और कुछ API एंडपॉइंट्स से बना है।
- **ऐप** Angular में बनाया गया है, जिसमें Analog+Nitro का उपयोग PrimeNg घटकों के साथ और Tailwind का उपयोग स्टाइलिंग के लिए किया गया है
- **सर्वर** Typescript फ़ंक्शंस के साथ Deno एंडपॉइंट्स की एक श्रृंखला है
- **डेटाबेस** Postgres या Supabase हो सकता है

जबकि स्व-होस्टेड इंस्टेंस को स्टैंड-अलोन तैनात करने का इरादा है, प्रबंधित संस्करण हालांकि कुछ अतिरिक्त तृतीय-पक्ष सेवाओं पर निर्भर करता है, जिन्हें आप नीचे देख सकते हैं, [जिनके दस्तावेज़ यहाँ हैं](https://domain-locker.com/about/developing/third-party-docs).

<details>
<summary>क्यों</summary>
Angular क्यों? भविष्य के मेरे लिए एक बीमार मजाक के रूप में, जिसे फिर इसका रखरखाव करना होगा।
</details>


<p align="center">
<img width="800" src="https://assets.kitploit.com/production/public/readmes/264/1449d16cb6a07bd766d3b86a8de608aaa4075270a0a634cd6f6af1f1a1d70c49.png" />
<br>
<span>आप उपयोग की गई प्रौद्योगिकियों और सेवाओं के दस्तावेज़ <a href="https://domain-locker.com/about/developing/third-party-docs">यहाँ</a> देख सकते हैं</span>
</p>


#### आर्किटेक्चर

आर्किटेक्चर काफी सरल है।
हमारे पास एक ऐप (एक फ्रंटएंड और API एंडपॉइंट्स से युक्त) है, जहाँ उपयोगकर्ता डेटाबेस (एडेप्टर के माध्यम से) से पढ़ और लिख सकता है। फिर एक क्रॉन सेवा समय-समय पर API एंडपॉइंट्स को कॉल करेगी ताकि डोमेन डेटा को अद्यतित रखा जा सके, परिवर्तनों को ट्रैक किया जा सके, स्वास्थ्य की निगरानी की जा सके, और कुछ परिवर्तनों (उपयोगकर्ता की प्राथमिकता के अनुसार) या आगामी समाप्ति से पहले सूचनाएँ ट्रिगर की जा सकें।```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>आप स्कीमा डाउनलोड कर सकते हैं <a href="https://github.com/Lissy93/domain-locker/blob/main/db/schema.sql"<code>db/schema.sql</code></a> से</sub></p>

---

### योगदान

किसी भी प्रकार के योगदान का हमेशा स्वागत है, और बहुत सराहना की जाती है! 💗

यदि आप Git में नए हैं, तो योगदान देने का सामान्य तरीका इस प्रकार है:
- रिपॉजिटरी को फोर्क करें, [यहां क्लिक करके](https://github.com/lissy93/domain-locker/fork)
- अपना फोर्क क्लोन करें (`git clone [email protected]:[आपका_उपयोगकर्ता_नाम]/domain-locker.git` के साथ)
- ऊपर दिए गए [प्रोजेक्ट सेटअप](#project-setup) का पालन करें, ताकि प्रोजेक्ट डेवलपमेंट मोड में चलाया जा सके।
- अपनी शानदार नई सुविधा या अद्भुत बग फिक्स लागू करें...
- एक ब्रांच चेकआउट करें, `git checkout -b feature-branch` के साथ, फिर अपने बदलावों को `git add` करें और conventional commits का उपयोग करके `git commit` करें, इससे पहले कि आप अपनी ब्रांच पर `git push` करें।
- GitHub पर वापस जाएं, और फिर आप हमारी `main` ब्रांच के विरुद्ध एक PR खोल सकते हैं। यह शामिल करना न भूलें कि आपने क्या बदला, क्यों, और किसी भी संबंधित मुद्दों से लिंक करें।
- हम तब समीक्षा, प्रतिक्रिया और मर्ज करेंगे, और एक बार रिलीज़ होने पर आपके बदलाव प्रोडक्शन में लाइव होंगे, साथ ही नवीनतम Docker इमेज में उपलब्ध होंगे।

<details>
	<summary>Git ब्रांच उदाहरण</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)"