🚀 ai-niku-tech-laravel

Este proyecto Docker configura un entorno completo de análisis estático para proyectos Laravel y Vue.js utilizando un servidor MCP (Multi-Component Processor), Redis y Nginx.

---

📂 Estructura del Proyecto

ai-niku-tech-laravel/
├── .env.dist                   # Plantilla de configuración
├── .gitignore                  # Archivos ignorados por Git
├── docker-compose.yml          # Configuración de Docker
├── mcp-server/                 # Código del servidor MCP
│   ├── cache/                  # Caché de análisis
│   ├── logs/                   # Registros del servidor
│   ├── reports/                # Reportes generados
│   └── src/                    # Código fuente
└── nginx/                      # Configuración web
    ├── html/
    │   └── index.html          # Página de inicio
    └── nginx.conf              # Configuración Nginx

---

🧠 Servicios Incluidos

1. mcp-laravel-server

Servidor MCP para analizar proyectos Laravel y Vue.js. Incluye análisis con:

• PHPStan
• PHP CS Fixer
• ESLint
• Laravel Pint
• Composer y NPM
• Soporte opcional para Psalm

2. redis

Usado para cachear los resultados de los análisis y mejorar el rendimiento.

3. nginx

Servidor web para mostrar reportes de análisis y servir una página de inicio opcional.

---

⚙️ Configuración de Variables

Copia .env.dist a .env y ajusta LARAVEL_PROJECT_PATH para que apunte a tu proyecto Laravel:

cp .env.dist .env

LARAVEL_PROJECT_PATH=./ruta-a-tu-proyecto-laravel

---

🚀 Levantar el entorno

docker compose up -d

Esto iniciará el servidor MCP, Redis y Nginx. Puedes acceder:

• MCP Server: http://localhost:8080
• Nginx (reportes): http://localhost:8081

---

🔍 Características de Análisis

• Auto-detección de rutas y configuraciones Laravel y Vue.js.
• Análisis estático de PHP, JS y Vue.
• Reportes detallados generados en /mcp-server/reports.

---

📁 Volúmenes Persistentes

Volumen	Propósito
redis_data	Almacena la data de Redis
composer_cache	Cache de Composer
node_cache	Cache de NPM/Node.js
analysis_cache	Cache de análisis

---

🩺 Healthcheck

El servicio mcp-laravel-server incluye una verificación de salud que valida la disponibilidad del servidor en http://localhost:8080/health.

---

🧹 Detener y Limpiar

docker compose down

Para limpiar volúmenes:

docker compose down -v

---

✍️ Autor

Configura por Francis Gonzales.

---