SEO Growth Engine¶

Estado del proyecto¶

Ultima revision local documentada: 2026-05-18

1. Resumen ejecutivo¶

SEO Growth Engine es una aplicacion web construida sobre Django con una capa de UI server-rendered y una integracion progresiva de Vue 3 + TypeScript en la zona autenticada.

El proyecto ya cubre:

• gestion de sitios y clientes
• ejecucion de analisis SEO
• generacion de reportes HTML
• historico de runs
• colas de trabajo con Redis + RQ
• una via de arranque local completa con Docker
• una arquitectura de publicacion que contempla NGINX en VPS

2. Arquitectura actual¶

Backend Django¶

Archivos principales:

• main/settings.py
• main/urls.py
• main/asgi.py
• main/wsgi.py
• dashboard/web/views.py
• dashboard/web/forms.py
• dashboard/api/views.py

Cola y ejecucion de tareas¶

Archivos clave:

• dashboard/tasks/queue.py
• dashboard/tasks/jobs.py
• dashboard/tasks/services.py
• dashboard/management/commands/runworker.py

Motor SEO¶

La logica de analisis y generacion de artefactos sigue en engine/:

• engine/runner.py
• engine/report_data.py
• engine/gsc.py
• engine/ga4.py
• engine/ai_visibility.py

Frontend y UI compartida¶

• frontend/
• frontend/src/views/DashboardView.vue
• shared/templates/web/base.html
• shared/static/css/design-system.css
• shared/static/css/dashboard.css

3. Configuracion de entorno¶

Archivos relevantes:

• .env.example
• .gitignore
• docs/local-stack.md

Estado actual:

• .env.example cubre desarrollo local y arranque con Docker
• .gitignore excluye .env, bases locales, virtualenvs, node_modules, output y staticfiles
• el proyecto sigue permitiendo un modo minimo con SQLite y otro completo con PostgreSQL + Redis

4. Docker y despliegue¶

Archivos relevantes:

• Dockerfile
• docker-compose.yml
• deploy/entrypoint.sh
• deploy/nginx/seo-growth-engine.conf
• docs/docker.md
• docs/deployment.md
• docs/deployment-evidence.md

Estado actual:

• el stack Docker local quedo validado el 2026-05-18
• web, worker, db y redis arrancan correctamente
• la aplicacion responde en http://127.0.0.1:8000/
• el repo conserva la configuracion de NGINX
• la arquitectura presentada ya contempla NGINX en VPS

5. Incidencias recientes corregidas¶

• Se elimino de templates/report.html la dependencia de una ruta absoluta de otra maquina para mostrar comparativas de runs.
• Se corrigio la portabilidad de deploy/entrypoint.sh para entornos Windows al construir la imagen Docker.
• Se fijo docker-compose.yml para que el worker use siempre RQ y Redis dentro del stack Docker aunque el .env local use thread.
• Limpiamos enlaces absolutos y referencias desactualizadas en la documentacion.
• Reforzamos la presentacion Zensical para explicar mejor cliente, servidor, despliegue, negocio, gestion y sostenibilidad.

6. Documentacion util¶

• Documentacion general
• Arranque local paso a paso
• Guia Docker
• Guia de despliegue
• Evidencias de despliegue
• Checklist de produccion
• Resumen del despliegue

7. Siguiente nivel de mejora¶

• automatizar mas el despliegue
• cerrar dominio, HTTPS y observabilidad segun el entorno final
• seguir madurando documentacion operativa, tecnica y de contexto empresarial

8. Conclusiones¶

El proyecto ya no esta solo "preparado" para Docker: el arranque local con contenedores ha sido validado y la presentacion ya integra una publicacion con NGINX en VPS. El siguiente paso seria completar automatizaciones, observabilidad y configuracion de produccion con mas detalle.