┌─────────────────────────────────────────────────────────────────────┐
│                        HS-PANEL CONTROL PLANE                       │
│                                                                     │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────────────┐   │
│  │ Admin UI │  │ User UI  │  │ Guest UI │  │ API Clients/CLI  │   │
│  │ :2086    │  │ :2082    │  │ :80/443  │  │ hsctl            │   │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └────────┬─────────┘   │
│       │              │              │                  │             │
│       └──────────────┴──────────────┴──────────────────┘             │
│                              │                                      │
│                    ┌─────────▼──────────┐                           │
│                    │   hs-srvd (Perl)   │  ← HTTP Daemon            │
│                    │   Ports 2082/2086  │                           │
│                    └─────────┬──────────┘                           │
│                              │                                      │
│              ┌───────────────┼───────────────┐                      │
│              │               │               │                      │
│    ┌─────────▼─────┐ ┌──────▼──────┐ ┌─────▼──────────┐           │
│    │ HS::* Modules │ │ Task Queue  │ │ Config Engine  │           │
│    │ (Perl Libs)   │ │ hs-taskd    │ │ /var/hspanel/  │           │
│    └───────┬───────┘ └──────┬──────┘ └──────┬─────────┘           │
│            │                │                │                      │
│    ┌───────▼────────────────▼────────────────▼──────────┐          │
│    │          C Wrappers (setuid binaries)               │          │
│    │          /usr/local/hspanel/bin/                     │          │
│    └───────┬────────────────┬────────────────┬──────────┘          │
└────────────┼────────────────┼────────────────┼──────────────────────┘
             │                │                │
┌────────────▼────────────────▼────────────────▼──────────────────────┐
│                     LINUX SYSTEM SERVICES                           │
│                                                                     │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌─────────┐ │
│  │  Apache  │ │ Postfix  │ │  Bind9   │ │ MariaDB  │ │  Pure-  │ │
│  │  Nginx   │ │ Dovecot  │ │ PowerDNS │ │ Postgres │ │  FTPd   │ │
│  │  OLS     │ │ SpamAsn  │ │          │ │          │ │         │ │
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └─────────┘ │
│                                                                     │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐             │
│  │ PHP-FPM  │ │ OpenDKIM │ │ certbot  │ │ iptables │             │
│  │ pools    │ │          │ │ acme.sh  │ │ firewalld│             │
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘             │
│                                                                     │
│  ┌─────────────────────────────────────────────────────────────┐   │
│  │                    Linux Filesystem                          │   │
│  │  /home/users/   /var/mail/   /var/named/   /etc/            │   │
│  └─────────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────────┘

Browser → DNS Resolver → Bind9/PowerDNS → IP Resolution
                                              ↓
Browser ──HTTP/HTTPS──→ Apache/Nginx/OLS (:80/:443)
                              ↓
                     Virtual Host Matching
                              ↓
                     PHP-FPM (unix socket)
                              ↓
                     /home/user/public_html/
                              ↓
                     MariaDB (if dynamic)
                              ↓
                     Response → Browser

Sender MTA ──SMTP:25──→ Postfix (MTA)
                            ↓
                     SpamAssassin (spamc)
                            ↓
                     OpenDKIM (verify/sign)
                            ↓
                     Virtual Transport Map
                            ↓
                     Dovecot LDA → /var/mail/vhosts/domain/user/
                            ↓
User Client ──IMAP:993──→ Dovecot → Mailbox → Response
User Client ──POP3:995──→ Dovecot → Mailbox → Response

Client Query → Recursive Resolver → Root NS
                                       ↓
                              TLD NS (.com)
                                       ↓
                              Authoritative NS (Bind9)
                                       ↓
                     Zone File: /var/named/domain.com.db
                                       ↓
                              A Record → IP Address
                                       ↓
                              Response → Client

Admin Action (e.g., "Create Account")
         ↓
    Browser POST → hs-srvd (:2086)
         ↓
    JWT Auth Validation
         ↓
    HS::Account->create($params)
         ↓
    ┌────────────────────────────────────────┐
    │ Configuration Engine writes:           │
    │   /var/hspanel/userdata/username/      │
    │   /var/hspanel/users/username.json     │
    └────────────┬───────────────────────────┘
                 ↓
    ┌────────────────────────────────────────┐
    │ System Actions (via C wrappers):       │
    │   useradd → Linux user                 │
    │   mkdir   → /home/username/            │
    │   quota   → disk quota                 │
    └────────────┬───────────────────────────┘
                 ↓
    ┌────────────────────────────────────────┐
    │ Service Rebuilds (Bash scripts):       │
    │   rebuild_httpd.sh  → Apache vhosts    │
    │   rebuild_dns.sh    → Bind zone        │
    │   rebuild_ftp.sh    → FTP config       │
    └────────────┬───────────────────────────┘
                 ↓
    ┌────────────────────────────────────────┐
    │ Service Reloads:                       │
    │   systemctl reload apache2             │
    │   rndc reload                          │
    │   systemctl reload pure-ftpd           │
    └────────────────────────────────────────┘