feat: change structure

api/README.md

@@ -0,0 +1,132 @@
+# LXD Proxy API (Slim Framework)
+
+This is a PHP-based API using the **Slim 4 Framework** that dynamically manages and proxies traffic to LXD containers based on subdomain mappings.
+
+---
+
+## 🧩 Features
+
+- CAPTCHA validation for provisioning
+- Proxies requests to containerized environments
+- Persists domain-to-container mapping
+- Waits for container service to be ready before forwarding
+- Logs last access per container
+
+---
+
+## 📁 Project Structure
+
+api/
+│ ├── src/
+│ │ ├── Controllers/
+│ │ │ └── ProxyController.php
+│ │ ├── Services/
+│ │ │ └── LxdService.php
+│ │ └── Utils/
+│ │ └── SubdomainHelper.php
+│ ├── vendor/ # Composer dependencies
+│ ├── public/
+│ │ └── last-access-logs/
+│ ├── config.json # Domain-to-container mappings
+│ └── index.php # Slim entry point
+├── composer.json
+└── README.md
+
+
+---
+
+## ⚙️ Requirements
+
+- PHP 8.4+
+- LXD installed and configured
+- PHP-FPM + NGINX
+- Composer
+- `slim/slim`
+- `slim/psr7`
+- `guzzlehttp/guzzle`
+- `vlucas/phpdotenv`
+
+---
+
+## 🚀 Setup Instructions
+
+1. **put the folder in /var/www/html**
+
+2. **Install dependencies**
+    ```bash
+    composer install
+
+
+3. **Ensure PHP and NGINX are configured**
+
+NGINX config example:
+    ```bash
+    Please check nginx.conf file in root
+
+
+4. **Map domain in /etc/hosts**
+    ```bash
+    127.0.0.1   testone.lxdapp.local
+
+5. **Make sure LXD is working**
+    ```bash
+    lxc list
+
+6. **🔐 CAPTCHA Protection**
+
+    The /api/ POST endpoint expects a field panswer with the correct CAPTCHA.
+
+    You can configure PCaptcha class for custom logic.
+   
+
+7. **🧪 API Usage**
+
+    POST /api
+
+    **Request Body:**
+    ```bash
+    {
+    "source": "login",
+    "panswer": "abc123"
+    }
+
+    **Headers:**
+
+    Origin: http://testone.lxdapp.local
+
+    **Response:**
+    ```bash
+    {
+    "status": "success",
+    "ip": "10.210.189.24"
+    }
+
+
+**🧠 Notes** 
+
+    Container names are auto-generated using the subdomain prefix.
+
+    All containers are mapped in config.json.
+
+    If a container does not yet exist, it's created, started, and software is installed.
+
+    The system waits for the container to expose port 80 before proxying.
+
+
+**🪵 Logs**
+
+    Last access logs for containers are saved in:
+    public/last-access-logs/container-*.txt
+
+    NGINX error logs (for debugging):
+    ```bash
+    tail -f /var/log/nginx/error.log
+
+
+**👨‍💻 Development**
+
+    Codebase follows PSR-4 autoloading (App\ namespace).
+
+    To add new functionality, work within app/src/Controllers or Services.
+
+