# 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 personalizado construido con TypeScript que expone operaciones Docker a través del protocolo MCP sobre HTTP. Este servicio:
- Implementa 13 herramientas Docker seguras usando dockerode
- Usa el puerto 3000 para comunicación HTTP
- Tiene acceso al socket de Docker del host (solo lectura)
- Se ejecuta en las redes `principal` y `traefik-network`
- **Expuesto públicamente en `APP_DOMAIN/mcp` SIN autenticación Authentik**
- Prioridad 200 en Traefik para evitar conflictos con otros routers
- Endpoints disponibles:
  - `POST /mcp` - Protocolo MCP para operaciones Docker
  - `GET /mcp/health` - Health check del servicio

## 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