# mofisam/cd.top architecture

> Architecture diagram of the GitHub repository mofisam/cd.top, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mofisam/cd.top
- Repository: https://github.com/mofisam/cd.top

## Overview

CheckDomain is a PHP domain-discovery and monitoring web application. A visitor checks availability from the homepage; the page sends the domain to an API endpoint, which applies rate limiting. The product also exposes WHOIS, suggestions, watchlists, alerts, backorders, brokerage and account/billing features, with a separate administrative area. The excerpts establish some page-to-API, authentication and email relationships; many feature implementations were not sampled, so those links are omitted rather than inferred.

Main entry points: [`lib/Auth.php`](https://github.com/mofisam/cd.top/blob/main/lib/Auth.php) (Authentication), [`index.php`](https://github.com/mofisam/cd.top/blob/main/index.php) (Domain search), [`admin/auth_check.php`](https://github.com/mofisam/cd.top/blob/main/admin/auth_check.php) (Admin authorization), [`admin/users.php`](https://github.com/mofisam/cd.top/blob/main/admin/users.php) (User administration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Domain discovery"]
  node_home["Domain search<br/>[index.php]"]
  node_checkapi["Availability API<br/>[checkingdomain.php]"]
  node_limiter["Rate limiting<br/>[rate_limiter.php]"]
  node_suggestions["Suggestions API<br/>[suggestions.php]"]
  node_tlds["Popular TLDs API<br/>[popular-tlds.php]"]
end

subgraph group_monitoring["Domain services"]
  node_whois["WHOIS lookup<br/>[whois.php]"]
  node_watchlist["Watchlist<br/>[watchlist.php]"]
  node_watchapi["Watchlist API"]
  node_alerts["Alerts<br/>[alerts.php]"]
  node_backorders["Backorders<br/>[backorders.php]"]
  node_dead_sites["Dead-site discovery<br/>[dead-sites.php]"]
  node_broker["Domain brokerage<br/>[broker.php]"]
end

subgraph group_accounts["Accounts and billing"]
  node_auth["Authentication<br/>[Auth.php]"]
  node_social_auth["Social sign-in"]
  node_verify["Email verification<br/>[verify.php]"]
  node_settings["Account settings"]
  node_billing_api["Billing API<br/>[billing.php]"]
  node_billing["Billing pages<br/>[billing.php]"]
  node_email["Email service<br/>[email.php]"]
end

subgraph group_admin["Administration"]
  node_admin_auth["Admin authorization<br/>[auth_check.php]"]
  node_admin_users["User administration<br/>[users.php]"]
  node_admin_plans["Plan administration<br/>[plan.php]"]
  node_admin_promos["Promo administration<br/>[promo-codes.php]"]
  node_admin_templates["Email templates"]
  node_admin_nav["Admin navigation<br/>[sidebar.php]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_home
node_home -->|"checks domain"| node_checkapi
node_checkapi -->|"applies limits"| node_limiter
node_home -->|"loads watchlist"| node_watchapi
node_home -->|"requests suggestions"| node_suggestions
node_home -.->|"requests TLDs"| node_tlds
node_settings -->|"uses"| node_auth
node_whois -->|"uses"| node_auth
node_watchapi -->|"uses"| node_auth
node_broker -->|"uses"| node_auth
node_dead_sites -->|"uses"| node_auth
node_social_auth -->|"authenticates with"| node_auth
node_verify -->|"verifies account"| node_auth
node_billing_api -->|"checks identity"| node_auth
node_admin_users -->|"checks access"| node_admin_auth
node_admin_plans -->|"checks access"| node_admin_auth
node_admin_promos -->|"checks access"| node_admin_auth
node_admin_templates -->|"checks access"| node_admin_auth
node_admin_templates -->|"uses"| node_email
node_admin_users -.->|"renders navigation"| node_admin_nav

click node_home "https://github.com/mofisam/cd.top/blob/main/index.php"
click node_checkapi "https://github.com/mofisam/cd.top/blob/main/api/checkingdomain.php"
click node_limiter "https://github.com/mofisam/cd.top/blob/main/includes/rate_limiter.php"
click node_suggestions "https://github.com/mofisam/cd.top/blob/main/api/suggestions.php"
click node_tlds "https://github.com/mofisam/cd.top/blob/main/api/popular-tlds.php"
click node_whois "https://github.com/mofisam/cd.top/blob/main/whois.php"
click node_watchlist "https://github.com/mofisam/cd.top/blob/main/watchlist.php"
click node_watchapi "https://github.com/mofisam/cd.top/blob/main/api/watchlist-domain.php"
click node_alerts "https://github.com/mofisam/cd.top/blob/main/alerts.php"
click node_backorders "https://github.com/mofisam/cd.top/blob/main/backorders.php"
click node_dead_sites "https://github.com/mofisam/cd.top/blob/main/dead-sites.php"
click node_broker "https://github.com/mofisam/cd.top/blob/main/broker.php"
click node_auth "https://github.com/mofisam/cd.top/blob/main/lib/Auth.php"
click node_social_auth "https://github.com/mofisam/cd.top/blob/main/auth/google-callback.php"
click node_verify "https://github.com/mofisam/cd.top/blob/main/auth/verify.php"
click node_settings "https://github.com/mofisam/cd.top/blob/main/account-settings.php"
click node_billing_api "https://github.com/mofisam/cd.top/blob/main/api/billing.php"
click node_billing "https://github.com/mofisam/cd.top/blob/main/billing.php"
click node_admin_auth "https://github.com/mofisam/cd.top/blob/main/admin/auth_check.php"
click node_admin_users "https://github.com/mofisam/cd.top/blob/main/admin/users.php"
click node_admin_plans "https://github.com/mofisam/cd.top/blob/main/admin/plan.php"
click node_admin_promos "https://github.com/mofisam/cd.top/blob/main/admin/promo-codes.php"
click node_admin_templates "https://github.com/mofisam/cd.top/blob/main/admin/email-templates.php"
click node_email "https://github.com/mofisam/cd.top/blob/main/includes/email.php"
click node_admin_nav "https://github.com/mofisam/cd.top/blob/main/admin/includes/sidebar.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_checkapi,node_limiter,node_suggestions,node_tlds toneBlue
class node_whois,node_watchlist,node_watchapi,node_alerts,node_backorders,node_dead_sites,node_broker toneAmber
class node_auth,node_social_auth,node_verify,node_settings,node_billing_api,node_billing,node_email toneMint
class node_admin_auth,node_admin_users,node_admin_plans,node_admin_promos,node_admin_templates,node_admin_nav toneRose
class node_visitor toneIndigo
```

## Components

### Domain discovery

- [Domain search](https://github.com/mofisam/cd.top/blob/main/index.php): `index.php`
- [Availability API](https://github.com/mofisam/cd.top/blob/main/api/checkingdomain.php): `api/checkingdomain.php`
- [Rate limiting](https://github.com/mofisam/cd.top/blob/main/includes/rate_limiter.php): `includes/rate_limiter.php`
- [Suggestions API](https://github.com/mofisam/cd.top/blob/main/api/suggestions.php): `api/suggestions.php`
- [Popular TLDs API](https://github.com/mofisam/cd.top/blob/main/api/popular-tlds.php): `api/popular-tlds.php`

### Domain services

- [WHOIS lookup](https://github.com/mofisam/cd.top/blob/main/whois.php): `whois.php`
- [Watchlist](https://github.com/mofisam/cd.top/blob/main/watchlist.php): `watchlist.php`
- [Watchlist API](https://github.com/mofisam/cd.top/blob/main/api/watchlist-domain.php): `api/watchlist-domain.php`
- [Alerts](https://github.com/mofisam/cd.top/blob/main/alerts.php): `alerts.php`
- [Backorders](https://github.com/mofisam/cd.top/blob/main/backorders.php): `backorders.php`
- [Dead-site discovery](https://github.com/mofisam/cd.top/blob/main/dead-sites.php): `dead-sites.php`
- [Domain brokerage](https://github.com/mofisam/cd.top/blob/main/broker.php): `broker.php`

### Accounts and billing

- [Authentication](https://github.com/mofisam/cd.top/blob/main/lib/Auth.php): `lib/Auth.php`
- [Social sign-in](https://github.com/mofisam/cd.top/blob/main/auth/google-callback.php): `auth/google-callback.php`
- [Email verification](https://github.com/mofisam/cd.top/blob/main/auth/verify.php): `auth/verify.php`
- [Account settings](https://github.com/mofisam/cd.top/blob/main/account-settings.php): `account-settings.php`
- [Billing API](https://github.com/mofisam/cd.top/blob/main/api/billing.php): `api/billing.php`
- [Billing pages](https://github.com/mofisam/cd.top/blob/main/billing.php): `billing.php`
- [Email service](https://github.com/mofisam/cd.top/blob/main/includes/email.php): `includes/email.php`

### Administration

- [Admin authorization](https://github.com/mofisam/cd.top/blob/main/admin/auth_check.php): `admin/auth_check.php`
- [User administration](https://github.com/mofisam/cd.top/blob/main/admin/users.php): `admin/users.php`
- [Plan administration](https://github.com/mofisam/cd.top/blob/main/admin/plan.php): `admin/plan.php`
- [Promo administration](https://github.com/mofisam/cd.top/blob/main/admin/promo-codes.php): `admin/promo-codes.php`
- [Email templates](https://github.com/mofisam/cd.top/blob/main/admin/email-templates.php): `admin/email-templates.php`
- [Admin navigation](https://github.com/mofisam/cd.top/blob/main/admin/includes/sidebar.php): `admin/includes/sidebar.php`

### Other components

- **Visitor**

## Connections

- Visitor → Domain search: opens (evidence: `index.php`)
- Domain search → Availability API: checks domain (evidence: `index.php`)
- Availability API → Rate limiting: applies limits (evidence: `api/checkingdomain.php`)
- Domain search → Watchlist API: loads watchlist (evidence: `index.php`)
- Domain search → Suggestions API: requests suggestions (evidence: `index.php`)
- Domain search → Popular TLDs API: requests TLDs
- Account settings → Authentication: uses (evidence: `account-settings.php`)
- WHOIS lookup → Authentication: uses (evidence: `whois.php`)
- Watchlist API → Authentication: uses (evidence: `api/watchlist-domain.php`)
- Domain brokerage → Authentication: uses (evidence: `broker.php`)
- Dead-site discovery → Authentication: uses (evidence: `dead-sites.php`)
- Social sign-in → Authentication: authenticates with (evidence: `auth/google-callback.php`)
- Email verification → Authentication: verifies account (evidence: `auth/verify.php`)
- Billing API → Authentication: checks identity (evidence: `api/billing.php`)
- User administration → Admin authorization: checks access (evidence: `admin/users.php`)
- Plan administration → Admin authorization: checks access (evidence: `admin/plan.php`)
- Promo administration → Admin authorization: checks access (evidence: `admin/promo-codes.php`)
- Email templates → Admin authorization: checks access (evidence: `admin/email-templates.php`)
- Email templates → Email service: uses (evidence: `admin/email-templates.php`)
- User administration → Admin navigation: renders navigation (evidence: `admin/users.php`)
