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 oficial de Docker (docker:cli) que permite gestionar contenedores Docker mediante lenguaje natural. Este servicio:

• Usa el MCP Gateway en modo streaming (puerto 8080)
• 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 WebSocket y streaming

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