diff --git a/docs/API_RAG.md b/docs/API_RAG.md index 385abd9..c0a9c82 100644 --- a/docs/API_RAG.md +++ b/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 | diff --git a/docs/AVISO_MIGRACION_REPO.md b/docs/AVISO_MIGRACION_REPO.md index fb375a5..c444c84 100644 --- a/docs/AVISO_MIGRACION_REPO.md +++ b/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` \ No newline at end of file +- Documentacion de despliegue base: `docs/DESPLIEGUE_EASYPANEL.md` diff --git a/docs/DESPLIEGUE_EASYPANEL.md b/docs/DESPLIEGUE_EASYPANEL.md index 930a7a1..8410bd3 100644 --- a/docs/DESPLIEGUE_EASYPANEL.md +++ b/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 --- diff --git a/docs/HISTORIAL_SESIONES.md b/docs/HISTORIAL_SESIONES.md index 74d0eed..ab09d7b 100644 --- a/docs/HISTORIAL_SESIONES.md +++ b/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. diff --git a/docs/PENDIENTES_RAG.md b/docs/PENDIENTES_RAG.md index ec150dd..f7317f7 100644 --- a/docs/PENDIENTES_RAG.md +++ b/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. diff --git a/docs/SISTEMA_RAG_BASE.md b/docs/SISTEMA_RAG_BASE.md index 8df82b7..de571a0 100644 --- a/docs/SISTEMA_RAG_BASE.md +++ b/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 diff --git a/docs/STACK_TECNICO_V1.md b/docs/STACK_TECNICO_V1.md index 5993abc..9dacd26 100644 --- a/docs/STACK_TECNICO_V1.md +++ b/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. ---