docs: record API discovery deployment

docs/API_RAG.md

@@ -4,7 +4,7 @@
 **Modulo:** RAG  
 **Ultima actualizacion:** 2026-09-08
 **Ultima modificacion por:** Agente RAG 2
-**Estado:** Operativa en produccion; endpoints de descubrimiento pendientes de despliegue
+**Estado:** Operativa y validada en produccion
 
 Esta guia explica como descubrir y consumir la API. El contrato tecnico completo y canonico se publica en OpenAPI 3.1.1; este documento prioriza el camino rapido, las decisiones de uso y los ejemplos habituales.
 
@@ -16,8 +16,6 @@ Base URL de produccion:
 https://rag.por-correo.com
 ```
 
-Cuando se despliegue esta mejora:
-
 | Recurso | URL | Uso |
 |---|---|---|
 | Ayuda resumida | `GET /help` | Descubrimiento rapido para personas y agentes |

docs/AVISO_MIGRACION_REPO.md

@@ -1,5 +1,7 @@
 # Aviso: migracion del repo a RAG como raiz
 
+**Estado del despliegue:** Verificado el 2026-09-08 con build context `/` en EasyPanel.
+
 **Fecha:** 2026-07-21
 **Originado por:** Agente SerpBot API (ses_07a0ef286ffepXsTZOrCVa95nc) en `serpbot-api/`
 **Commit de migracion:** `b9a37f2 Restructure repo: move RAG content to repo root`
@@ -85,11 +87,13 @@ Antes de la migracion, el `Dockerfile` estaba commiteado en el repo como `RAG/Do
 
 ## Pendiente concreto para el agente de RAG
 
-1. Verificar y ajustar la configuracion de build de EasyPanel para `rag-service` segun lo descrito arriba.
-2. Hacer un deploy de prueba tras ajustar los paths del Dockerfile si fue necesario.
-3. Confirmar que `health`, `retrieve` y `answer` siguen respondiendo en produccion.
-4. Si todo va bien, borrar el backup `/tmp/opencode/rag-git-backup-1784664617`.
-5. Registrar la verificacion en `RAG/docs/HISTORIAL_SESIONES.md` cuando quede cerrado.
+Los puntos de configuracion y despliegue quedaron resueltos el 2026-09-08. EasyPanel debe mantener `Ruta de compilacion` en `/` y usar el `Dockerfile` de la raiz.
+
+1. Se ajusto el build context de EasyPanel de `/RAG` a `/`.
+2. El deploy del commit `f1cd87c` finalizo correctamente.
+3. Se validaron en produccion `health`, playground, sources, retrieve, `/help` y `/openapi.json`.
+4. El backup `/tmp/opencode/rag-git-backup-1784664617` se conserva hasta que el usuario decida eliminarlo.
+5. La verificacion queda registrada en `RAG/docs/HISTORIAL_SESIONES.md`.
 
 ---
 
@@ -99,4 +103,4 @@ Antes de la migracion, el `Dockerfile` estaba commiteado en el repo como `RAG/Do
 - Remote: `ssh://git@git.por-correo.com:2222/paco/rag-service.git`
 - Backup del `.git` pre-migracion: `/tmp/opencode/rag-git-backup-1784664617`
 - Sesion que origino la migracion: `ses_07a0ef286ffepXsTZOrCVa95nc` (Agente SerpBot API, en `propios/serpbot-api/`).
-- Documentacion de despliegue base: `docs/DESPLIEGUE_EASYPANEL.md`
+- Documentacion de despliegue base: `docs/DESPLIEGUE_EASYPANEL.md`

docs/DESPLIEGUE_EASYPANEL.md

@@ -142,6 +142,8 @@ Estado actual ya conseguido:
 - el repo `paco/rag-service` ya existe en Forgejo
 - el workspace local ya esta conectado al remote `origin`
 - la rama `main` ya fue subida correctamente
+- desde la migracion `b9a37f2`, el repositorio tiene `Dockerfile`, `src/` y `package.json` en su raiz
+- en EasyPanel, `Ruta de compilacion` debe ser `/`; el valor anterior `/RAG` provoca que el build busque una carpeta inexistente
 
 ---
 

docs/HISTORIAL_SESIONES.md

@@ -81,7 +81,12 @@ Dar continuidad al RAG en `RAG/` a partir del estado actual documentado.
 - Correccion del estado obsoleto de playground, logs, cleanup, stack y documentos de diseño.
 - Correccion de la metodologia: local se limita a compilacion y comprobaciones estaticas; los flujos HTTP se validan tras publicar en produccion.
 - Validacion satisfactoria con `npm run check`, `npm run build`, comprobacion de referencias OpenAPI y contraste automatico entre rutas implementadas y documentadas.
+- Deteccion del build context obsoleto `/RAG` en EasyPanel tras la migracion del repositorio.
+- Ajuste por el usuario de `Ruta de compilacion` a `/` y despliegue satisfactorio del commit `f1cd87c`.
+- Validacion en produccion de health, Qdrant, playground, sources, `/help` y `/openapi.json`.
+- Regresion satisfactoria de retrieval sobre FacturaTech: 6 resultados, cero fugas de scope y coincidencias `504` en los primeros resultados.
 
 **Estado final:**
-- Pendiente 1 implementado en local.
-- Pendiente commit, push, despliegue y validacion en `https://rag.por-correo.com` antes de marcarlo completado.
+- Pendiente 1 completado y validado en `https://rag.por-correo.com`.
+- La API dispone de descubrimiento rapido y contrato OpenAPI para sus 16 operaciones.
+- Siguiente prioridad: ciclo de vida del conocimiento.

docs/PENDIENTES_RAG.md

@@ -8,7 +8,7 @@ Este documento es la fuente canonica del orden de trabajo pendiente del modulo R
 
 ## 1. Documentacion y descubrimiento de la API
 
-**Estado:** Implementado; pendiente de publicacion y validacion en produccion.
+**Estado:** Completado y validado en produccion el 2026-09-08.
 
 - Implementar `/help` o una especificacion OpenAPI consultable.
 - Actualizar documentos desfasados que todavia muestran como pendientes funciones ya desplegadas, como playground, logs y cleanup.

docs/SISTEMA_RAG_BASE.md

@@ -98,7 +98,7 @@ Estado confirmado:
 - soporte funcional para `documental` y `codigo`
 - API HTTP operativa con ingesta, upload, cleanup, retrieval, answer, chat, catalogo de fuentes/modelos y logs de evaluacion
 - playground web operativo en `/playground`
-- contrato OpenAPI y ayuda de descubrimiento implementados, pendientes de despliegue
+- contrato OpenAPI y ayuda de descubrimiento operativos en produccion
 
 Pruebas funcionales ya superadas:
 - consulta documental sobre pendientes del workspace

docs/STACK_TECNICO_V1.md

@@ -177,7 +177,7 @@ Endpoints funcionales actuales:
 - `POST /logs/manual`
 - `PATCH /logs/:id`
 
-`/help` y `/openapi.json` estan implementados en codigo y quedaran disponibles en produccion tras el siguiente despliegue.
+`/help` y `/openapi.json` estan operativos y validados en produccion.
 
 ---