Fix: Docker issues resolved by updating documentation

Author: bmiguelbc16

.dockerignore

@@ -0,0 +1,58 @@
+# =============================================================================
+# Docker Build Context Optimization
+# Excluye archivos innecesarios para mejorar el rendimiento del build
+# =============================================================================
+
+# Control de versiones
+.git/
+.gitignore
+.gitattributes
+.gitmodules
+
+# Archivos de desarrollo y configuración
+.env*
+.vscode/
+.idea/
+.claude/
+*.log
+
+# Dependencias y builds
+node_modules/
+bower_components/
+vendor/
+composer.lock
+package-lock.json
+
+# Archivos temporales y cache
+storage/cache/
+storage/logs/
+tmp/
+*.tmp
+*.swp
+*.swo
+*~
+
+# Archivos de backup y tests
+*.backup
+test/
+wp-test/
+db_data/
+wordpress/
+
+# Archivos comprimidos y releases
+*.zip
+*.tar.gz
+*.rar
+antonella-framework-for-wp.zip
+
+# Archivos del sistema
+.DS_Store
+Thumbs.db
+
+# Documentación de desarrollo (mantener solo esenciales)
+PROBLEMAS_DE_INSTALACION.md
+
+# CLI tools
+wp-cli.phar
+antonella
+antonella2

docker-compose.yaml

@@ -1,5 +1,24 @@
+# =============================================================================
+# Antonella Framework for WordPress - Docker Compose Configuration
+# 
+# Entorno de desarrollo completo con:
+# - MySQL 8.0 con healthchecks
+# - WordPress con framework preconfigurado
+# - phpMyAdmin para gestión de BD
+# - WP-CLI para automatización
+#
+# Requisitos:
+# - Docker Desktop 4.53.0+ (compatibilidad ARM64/Windows)
+# - Docker Compose v2+
+#
+# Uso: docker compose up -d
+# =============================================================================
+
 services:
-  # Base de datos MySQL
+  # =============================================================================
+  # Base de datos MySQL 8.0
+  # Configurada con healthchecks para dependencias seguras
+  # =============================================================================
   mysql:
     container_name: mysql-antonella
     image: mysql:8.0
@@ -21,7 +40,10 @@ services:
       retries: 20
       start_period: 30s
 
-  # phpMyAdmin para gestión de base de datos
+  # =============================================================================
+  # phpMyAdmin - Gestión visual de base de datos
+  # Acceso: http://localhost:9000 (cambiar puerto si está ocupado)
+  # =============================================================================
   phpmyadmin:
     image: phpmyadmin/phpmyadmin:latest
     container_name: phpmyadmin-antonella
@@ -37,7 +59,12 @@ services:
     ports:
       - "9000:80"
 
-  # WordPress con configuración automática
+  # =============================================================================
+  # WordPress con Antonella Framework
+  # Configuración automática de desarrollo con inicialización completa
+  # Acceso: http://localhost:8080
+  # Admin: http://localhost:8080/wp-admin (test/test)
+  # =============================================================================
   wordpress:
     build:
       context: .
@@ -98,7 +125,10 @@ services:
         // Configuración de papelera
         define('EMPTY_TRASH_DAYS', 7);
 
-  # Servicio para ejecutar WP-CLI commands
+  # =============================================================================
+  # WP-CLI Container - Automatización y comandos WordPress
+  # Uso: docker compose exec wpcli wp <comando>
+  # =============================================================================
   wpcli:
     build:
       context: .
@@ -117,14 +147,22 @@ services:
       WORDPRESS_DB_NAME: wordpress
     command: tail -f /dev/null  # Mantener el contenedor activo
 
+# =============================================================================
 # Volúmenes persistentes
+# Mantienen datos entre reinicios de contenedores
+# =============================================================================
 volumes:
   mysql_data:
     driver: local
+    # Datos de MySQL (base de datos, configuraciones)
   wordpress_data:
     driver: local
+    # Instalación completa de WordPress (core, themes, uploads)
 
+# =============================================================================
 # Red personalizada
+# Permite comunicación entre servicios con nombres de host
+# =============================================================================
 networks:
   default:
     name: antonella-network

docker/Dockerfile.wordpress

@@ -1,18 +1,35 @@
+# =============================================================================
+# Antonella Framework - WordPress Development Container
+# 
+# Builds a WordPress environment with:
+# - WP-CLI for automation
+# - Custom initialization scripts
+# - Development tools and dependencies
+#
+# Compatible with: linux/amd64, linux/arm64
+# =============================================================================
+
 FROM wordpress:latest
 
-# Instalar dependencias necesarias
+# =============================================================================
+# Install system dependencies and development tools
+# =============================================================================
 RUN apt-get update && apt-get install -y \
     curl \
     less \
     default-mysql-client \
     && rm -rf /var/lib/apt/lists/*
 
-# Instalar WP-CLI
+# =============================================================================
+# Install WP-CLI for WordPress automation
+# =============================================================================
 RUN curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar \
     && chmod +x wp-cli.phar \
     && mv wp-cli.phar /usr/local/bin/wp
 
-# Crear directorio para scripts
+# =============================================================================
+# Setup custom scripts directory and initialization
+# =============================================================================
 RUN mkdir -p /docker-scripts
 
 # Copiar script de inicialización
@@ -23,5 +40,9 @@ RUN chmod +x /docker-scripts/init-wordpress.sh
 COPY docker/entrypoint.sh /docker-scripts/
 RUN chmod +x /docker-scripts/entrypoint.sh
 
+# =============================================================================
+# Configure container startup
+# =============================================================================
+
 ENTRYPOINT ["/docker-scripts/entrypoint.sh"]
 CMD ["apache2-foreground"]

readme.md

@@ -34,11 +34,20 @@
 ---
 
 ## 📋 Requirements
+
+### **Core Requirements**
 - **PHP**: 8.0 or higher
 - **Composer**: Latest version
 - **Git**: For version control
 - **WordPress**: 5.0 or higher
 
+### **Docker Development Environment**
+- **Docker Desktop**: 4.53.0+ (⚠️ **Required for ARM64/Windows compatibility**)
+- **Docker Compose**: v2.0+ 
+- **Available Ports**: 8080 (WordPress), 3306 (MySQL), 9000 (phpMyAdmin)
+
+> **💡 Note**: For optimal ARM64 compatibility on Windows/Mac, ensure Docker Desktop is updated to version 4.53.0 or higher. Earlier versions may experience container startup issues.
+
 ---
 
 ## 🚀 Quick Installation
@@ -66,8 +75,38 @@ php antonella updateproject
 ```
 
 ### 3. Start Development
+
+#### **Option A: Traditional WordPress Development**
 Your plugin is now ready! Upload to WordPress and start developing.
 
+#### **Option B: Docker Development Environment**
+For a complete development setup with database and admin interface:
+
+```bash
+# Start the development environment
+php antonella serve
+# or manually with Docker Compose
+docker compose up -d
+
+# Access your development site
+# WordPress: http://localhost:8080
+# Admin Panel: http://localhost:8080/wp-admin (test/test)
+# phpMyAdmin: http://localhost:9000
+```
+
+**🐳 Docker Environment Includes:**
+- WordPress with automatic framework activation
+- MySQL 8.0 with persistent data
+- phpMyAdmin for database management
+- WP-CLI for command automation
+- Development plugins (Query Monitor, Debug Bar)
+
+**📋 Default Credentials:**
+- **WordPress Admin**: `test` / `test`
+- **MySQL**: `wordpress` / `wordpress`
+
+> **🔧 Troubleshooting**: If containers fail to start, ensure Docker Desktop is updated to 4.53.0+ and required ports (8080, 3306, 9000) are available.
+
 ---
 
 ## 🎯 Core Features