# JA Square Hosting Manager (M3)
**Author:** Salim Nazir
**Version:** 1.0.0 (2026-01-01)
**Powered By:** JA Square

A custom, full-stack Hosting Management System (WHM/cPanel Lite) featuring automated Linux user provisioning, Apache VirtualHost generation, and a Material Design 3 (M3) interface.

---

## 🚀 Features
- **WHM Module:** Create hosting tiers (Packages) and provision domain accounts.
- **cPanel Module:** User-facing dashboard with resource monitoring and File Manager.
- **Automation:** Automated `useradd`, home directory creation, and Apache `.conf` generation.
- **Security:** Prepared statements, BCrypt password hashing, and shell injection protection.



---

## 📂 Project Structure

├── config/
│ ├── db_connect.php # Database credentials
│ ├── db_setup.php # Drop/Create table logic (Self-Seeding)
│ └── vhost_template.conf # Apache VirtualHost blueprint
├── core/
│ ├── AccountHandler.php # Account & VHost logic
│ └── PackageHandler.php # Tier management logic
├── public/
│ ├── api/ # Backend bridges (Upload, Save, Auth)
│ ├── assets/ # CSS (m3-theme.css) & Icons
│ ├── cpanel/ # User dashboard & File Manager
│ └── whm/ # Admin manager & Diagnostics
├── scripts/
│ └── create_linux_user.sh # Root-level bash provisioning
└── logout.php # Centralized session destruction