Nucleo Docs

Sistema de documentación para el ecosistema Nucleo basado en Nuxt 4 con autenticación mediante Authentik Proxy Outpost.

Propósito

Este repositorio contiene la documentación del funcionamiento del sistema Nucleo, incluyendo:

• Arquitectura del sistema
• Guías de desarrollo
• Documentación de servicios
• Procedimientos operativos

Estructura del Proyecto

.
├── nuxt4/              # Aplicación Nuxt 4 con la documentación
├── docker-compose.yml  # Configuración de despliegue
└── .gitea/            # Gitea Actions CI/CD

Características

• ✅ Nuxt 4
• ✅ Autenticación con Authentik Proxy Outpost
• ✅ Docker y Docker Compose
• ✅ CI/CD con Gitea Actions
• ✅ Traefik para proxy reverso y SSL
• ✅ Claude Code hooks para monitoreo de Actions
• ✅ MCP Server Docker para gestión de contenedores

Servicios

Aplicación Principal (app)

Aplicación Nuxt 4 con la documentación del sistema Nucleo, expuesta mediante Traefik con autenticación Authentik.

MCP Docker Server (mcp-docker)

Servidor MCP de Docker (ckreiling/mcp-server-docker) que permite gestionar contenedores Docker mediante lenguaje natural. Este servicio:

• Usa el puerto 8080 para comunicación MCP
• Tiene acceso al socket de Docker del host (solo lectura)
• Se ejecuta en las redes principal y traefik-network
• Expuesto públicamente a través de Traefik SIN autenticación Authentik
• Accesible en el dominio configurado en MCP_DOMAIN
• Incluye soporte para operaciones de Docker mediante protocolo MCP

Desarrollo Local

cd nuxt4
npm install
npm run dev

Despliegue

El proyecto se despliega automáticamente en docs.nucleoriofrio.com mediante Gitea Actions cuando se hace push a la rama master.

Variables y secrets configurados correctamente en Gitea.

Licencia

MIT