4 de mayo de 2026 · Responsable: project-manager · Audiencia: Sponsor
v2.0.0 en GHCR y GitHub| Componente | Tecnologia | Version |
|---|---|---|
| Backend | Quarkus (Java 21) | 3.21+ |
| Base de datos | PostgreSQL | 16-alpine |
| Vector Search | Qdrant | v1.17.1 |
| Autenticacion | Keycloak (OIDC) | 26.1.0 |
| IA / Embeddings | OpenAI API | text-embedding-3-large + gpt-4o-mini |
| Despliegue | Docker Compose | localhost:8080 |
| CI/CD | GitHub Actions + GHCR | — |
Aceptacion formal registrada
| ID | Escenario | Resultado |
|---|---|---|
| UAT-S01 | CRUD de memorias | Aprobado |
| UAT-S02 | Busqueda semantica | Aprobado |
| UAT-S03 | Busqueda hibrida | Aprobado |
| UAT-S04 | Extraccion automatica | Aprobado |
| UAT-S05 | Dashboard | Aprobado |
| UAT-S06 | Estados y ciclo de vida | Aprobado |
| UAT-S07 | Multi-tenancy | Aprobado |
| UAT-S08 | Auditoria | Aprobado |
| UAT-S09 | Rate limiting | Aprobado* |
| UAT-S10 | Performance baseline | Aprobado |
* Con condicion: ajustar umbral a 100 req/min en produccion
| Metrica | Valor |
|---|---|
| Pruebas funcionales | 63 |
| Pruebas de integracion | 18 |
| Pruebas de regresion | 15 |
| Defectos mayores abiertos | 0 |
| Defectos menores (cerrados) | 3 |
QA sign-off registrado. Sin bloqueantes para go-live.
ghcr.io/breisnerlopez/abax-memory:v2.0.0mvn clean package + docker build sin errores| Parametro | Valor |
|---|---|
| RTO | ≤ 5 minutos |
| Procedimiento | 5 pasos: detener v2 → verificar v1 → desplegar v1 → verificar → notificar |
| Comando rapido | docker compose down && docker tag v1.0.0 v2.0.0 && docker compose up -d |
| Triggers automaticos | Error rate > 5%, p95 > 2s, health DOWN, readiness DOWN |
| Verificacion post-rollback | Checklist de 7 items (health, BD, Qdrant, CRUD, logs, volumenes) |
Documento completo: docs/entregables/v2/fase-7-despliegue/plan-de-rollback.md
Plan revisado y listo para ejecucion. Procedimiento de 5 pasos con verificacion y comunicacion al sponsor.
| Componente | Endpoint / Herramienta |
|---|---|
| Health agregado | GET /q/health → {"status": "UP"} |
| Liveness probe | GET /q/health/live |
| Readiness (BD + Qdrant + OpenAI) | GET /q/health/ready |
| Metricas Prometheus | GET /q/metrics — latencia, error rate, throughput, memoria |
| Logs | docker compose logs -f backend |
| Qdrant health | GET :6333/healthz |
| PostgreSQL health | pg_isready |
Rate limiting activo. Umbral recomendado para produccion: 100 req/min.
indexed_vectors_count > 0).env configurado con OPENAI_API_KEY validadocker compose config sin erroresChecklist completo en 00-plan-despliegue.md
| Termino | Definicion |
|---|---|
| GHCR | GitHub Container Registry — repositorio de imagenes Docker del proyecto |
| OIDC | OpenID Connect — protocolo de autenticacion sobre OAuth 2.0 usado por Keycloak |
| RTO | Recovery Time Objective — tiempo maximo aceptable para restaurar el servicio (≤ 5 min) |
| p95 | Percentil 95 — el 95% de las requests se completan por debajo de este umbral |
| Smoke test | Prueba superficial post-deploy que verifica que las funcionalidades criticas funcionan |