Despliegue con Dokploy

La documentacion se compila como un sitio estatico y se sirve con Nginx. No necesita variables de entorno, base de datos ni acceso a la API para arrancar. Se publica en la raiz de api-fito.fitosanitariosmartinpaez.com.

Estructura publica

El Nginx principal del VPS reparte las rutas entre dos servicios:

Ruta	Servicio
/	Documentacion Starlight.
/api/v1/	API REST FastAPI.
/docs, /redoc, /openapi.json	Referencia OpenAPI de FastAPI.
/health, /status	Endpoints de sistema de FastAPI.

Asi, la documentacion es la primera pagina que ve quien visita el dominio sin cambiar la URL base de las integraciones existentes.

Crear la aplicacion

1. En Dokploy, crea una aplicacion de tipo Application desde el repositorio paez28/api-mapya.
2. Selecciona la rama main.
3. Configura Root Directory como documentation.
4. Configura el tipo de build como Dockerfile y el puerto interno como 80.
5. Despliega.

Dokploy detectara documentation/Dockerfile, compilara Starlight y expondra el contenido generado en el puerto 80. Nginx dirige la raiz del dominio hacia esta aplicacion y conserva las rutas de API en FastAPI.

Verificacion

Tras el despliegue, comprueba la documentacion, una ruta interna y la API:

curl -I https://api-fito.fitosanitariosmartinpaez.com/
curl -I https://api-fito.fitosanitariosmartinpaez.com/referencia/productos/
curl -I https://api-fito.fitosanitariosmartinpaez.com/health

Las tres peticiones deben responder 200.