Actúa como un desarrollador Full-Stack Senior e Ingeniero DevOps experto en Linux (Ubuntu) y Apache2. Necesito que desarrolles una aplicación web ligera y segura para gestionar dinámicamente todos los subdominios de mi dominio principal (`elingejose.com`) en mi VPS. ### 1. Contexto de Infraestructura del VPS (Obligatorio respetar) - **Sistema Operativo:** Ubuntu Server con solo **1 GB de RAM** (el backend y el frontend deben ser extremadamente ligeros y sin procesos pesados). - **Servidor Web:** Apache2 nativo de Ubuntu (`/etc/apache2/sites-available/` y `/etc/apache2/sites-enabled/`). No usar Nginx ni Docker. - **Usuario operativo:** El servidor corre servicios bajo el usuario `ggc` (con permisos `sudo` sin contraseña en `/etc/sudoers.d/ggc`) y el servidor web usa el usuario/grupo `www-data`. - **Stack ya instalado en el servidor:** Node.js v22 LTS + PM2, Python 3 (`venv`/`pip`), Apache2 con módulos `proxy`, `proxy_http`, `rewrite`, `headers` activos, y Gitea en el puerto `3000` (`git.elingejose.com`). - **DNS:** Ya existe o existirá un registro comodín `*.elingejose.com` apuntando a la IP del VPS (`201.32.134.58`), por lo que la aplicación solo debe gestionar la capa de Apache y el sistema de archivos local. ### 2. Requerimientos Funcionales de la Aplicación Web Crea una aplicación web completa (puede ser un backend ligero en **Node.js + Express** o **Python + FastAPI/Flask** con una interfaz web limpia en HTML/CSS/JS o Tailwind CDN sin build pesado) que permita: 1. **Autenticación básica segura:** - Pantalla de login protegida por usuario y contraseña definidos en un archivo `.env` (con sesión por cookie `HttpOnly` o JWT) para que nadie externo pueda modificar la configuración del servidor. 2. **Dashboard / Listado de Subdominios Activos:** - Leer los archivos `.conf` actuales en `/etc/apache2/sites-available/` (ignorando `000-default.conf` y `default-ssl.conf`, y marcando como protegidos los del sistema como `git.conf` para evitar borrarlos por accidente). - Mostrar para cada subdominio: nombre completo (`subdominio.elingejose.com`), tipo (**Estático/PHP** o **Proxy Inverso por Puerto**), ruta de carpeta o puerto destino, estado (`Habilitado` / `Deshabilitado` según exista en `sites-enabled/`), y botones para **Activar/Desactivar**, **Editar** o **Eliminar**. 3. **Creación Automática de Nuevo Subdominio (Dos modos):** - **Validación estricta de entrada:** El nombre del subdominio solo debe aceptar caracteres alfanuméricos y guiones (`^[a-z0-9-]+$`) para evitar inyección de comandos en la shell. - **Modo A — Proyecto Web / Estático / PHP (Carpeta):** 1. Crea automáticamente el directorio `/var/www/`. 2. Crea un archivo `index.html` inicial de bienvenida indicando que el subdominio está listo para desplegar. 3. Asigna permisos exactos para que el usuario `ggc` pueda desplegar por Git/SSH/SFTP sin usar `sudo` y Apache pueda leerlo: - `sudo chown -R ggc:www-data /var/www/` - `sudo chmod -R 2775 /var/www/` 4. Genera `/etc/apache2/sites-available/.conf` con el `` apuntando a `DocumentRoot /var/www/`, con `AllowOverride All`, `Options -Indexes +FollowSymLinks` y `Require all granted`. - **Modo B — Aplicación por Puerto / Proxy Inverso (Node.js, Python, etc.):** 1. Recibe el nombre del subdominio y un número de puerto válido (`1024-65535`, verificando que no choque con puertos reservados como `22`, `80`, `443`, `3000`, `3306`, `5101`, `5432`). 2. Genera `/etc/apache2/sites-available/.conf` con ``, `ProxyPreserveHost On`, `AllowEncodedSlashes NoDecode`, `ProxyPass / http://127.0.0.1:/ nocanon` y `ProxyPassReverse / http://127.0.0.1:/`. - **Activación y Validación Segura en Apache (para ambos modos):** 1. Ejecuta `sudo a2ensite .conf`. 2. Ejecuta `sudo apache2ctl configtest`. 3. **Rollback automático:** Si `apache2ctl configtest` falla, deshabilita y elimina el `.conf` recién creado y devuelve el error exacto al frontend sin tumbar Apache. Si devuelve `Syntax OK`, ejecuta `sudo systemctl reload apache2`. 4. **Eliminación Segura:** - Permite deshabilitar (`sudo a2dissite .conf`), eliminar el archivo `.conf` y, opcionalmente (mediante checkbox explícito), borrar la carpeta `/var/www/` antes de recargar Apache. ### 3. Entregables que debes generar 1. Estructura completa de carpetas y código fuente listo para ejecutar (backend + frontend). 2. Archivo `.env.example` con variables configurables (`PORT`, `BASE_DOMAIN=elingejose.com`, `WEB_ROOT=/var/www`, `SYSTEM_USER=ggc`, `ADMIN_USER`, `ADMIN_PASS`, `PROTECTED_SITES=000-default.conf,default-ssl.conf,git.conf`). 3. Archivo de configuración de **PM2** (`ecosystem.config.js`) limitado en memoria (`max_memory_restart: '120M'`) para correr en segundo plano en el puerto `3005`. 4. Configuración del VirtualHost de Apache para exponer este mismo panel en `panel.elingejose.com` (o `subdominios.elingejose.com`). 5. Guía breve de instalación y despliegue en el VPS usando el usuario `ggc`.