# 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

```bash
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