Fase 0 — Descubrimiento

Abax-Memory v2.1.0 — Discovery

Hardening & Optimización del Motor de Memoria Multi-Dominio

2026-05-05 · business-analyst · product-owner (pendiente de revisión)

Agenda

Qué vas a ver

Visión del Producto

Gap Analysis: v2.0.9 → v2.1.0

Gapv2.0.9 (estado actual)Meta v2.1.0Origen
Precisión top-1 ~0.75–0.80 (dense-only) ≥ 0.90 CE-01 NDCG@10 = 0.7771 (FAIL)
Latencia p95 ~2s oscilante ≤ 500ms Monitoreo post-deploy
Dos colecciones Qdrant v1 + v2 coexistiendo 1 colección F8v2-ISS-002
API/DX confusa search/hybrid redundantes, sin control grafo, sin DELETE ns API unificada + control granular F8v2-ISS-001, UAT-S08

Decisión del sponsor: v2.1.0 es hardening + optimización, no re-arquitectura. Stack inalterado. Backward compatibility.

Visión del Producto

10 Criterios de Éxito Medibles

IDCriterioLínea BaseMeta
CE-01Precisión top-1~0.78≥ 0.90 ⭐
CE-02Latencia p95 búsqueda~2s≤ 500ms ⭐
CE-03NDCG@10 SciFact0.7771 (FAIL)≥ 0.85 ⭐
CE-04Recall@10 SciFact0.9006 (PASS)≥ 0.90
CE-05Colecciones Qdrant21
CE-06/extract funcionalMockLlmServiceOpenAI real
CE-07search = semantic puroAmbiguo0 grafo
CE-08DELETE namespaceNo existeOperativo
CE-09X-Graph-StrategyNo existeFuncional
CE-10Unificar search/hybrid2 endpoints1 + deprecated
Visión del Producto

Usuarios Objetivo

Los mismos 5 roles de v2.0.0. El principal beneficiario de v2.1.0 es el Desarrollador Consumidor de la API (Memory Consumer).

RolImpacto de v2.1.0
Memory OperatorMayor precisión (top-1 ≥ 0.90). Menor latencia (p95 ≤ 500ms).
Memory ConsumerPrincipal beneficiario. API unificada, X-Graph-Strategy, DELETE namespace, /extract con OpenAI real.
Memory AdminEliminación de namespaces completos. Una sola colección Qdrant simplifica la administración.
Memory ReviewerSin cambios directos. Mejora de latencia beneficia el flujo de revisión.
Memory AuditorSin cambios directos. 100% de trazabilidad heredado de v2.0.0.
Épicas y Features

4 Épicas · 13 Features

ÉpicaFeaturePrioridad
EP-V21-001
Precisión
FT-001.1 — Reranker Cross-Encoder1
FT-001.2 — Búsqueda Semántica Pura (search sin grafo)2
FT-001.3 — Expansión Grafo Top-3 + entryPoints3
FT-001.4 — Fix POST /extract (OpenAI real)6
EP-V21-002
Velocidad
FT-002.1 — Optimización N+1 + Cache de Grafo7
FT-002.2 — Cold Start / Lock Qdrant8
FT-002.3 — Cache JWT Cliente4
EP-V21-003
Eficiencia
FT-003.1 — Diagnóstico Worker (Claimed=0)9
FT-003.2 — Unificar Colecciones Qdrant5
FT-003.3 — graphEntryStrategy Configurable10
EP-V21-004
API / DX
FT-004.1 — Header X-Graph-Strategy11
FT-004.2 — Unificar search/hybrid12
FT-004.3 — DELETE /admin/namespaces/{name}13

Cobertura: 13/13 features cubren los 10/10 criterios de éxito. Trazabilidad completa feature→CE en la matriz de trazabilidad del documento fuente.

Historias de Usuario

16 Historias · 5 Must · 3 Should · 8 Could

ÉpicaHistoriasMustShouldCould
EP-V21-001: Precisión 6 5 1 0
EP-V21-002: Velocidad 4 0 1 3
EP-V21-003: Eficiencia 3 0 1 2
EP-V21-004: API / DX 3 0 0 3

Must (5) — Bloqueantes para el éxito:

Cobertura: 13/13 features cubiertas por al menos 1 historia. Trazabilidad completa historia → feature → criterio de éxito.

Backlog & MVP

Dashboard Priorizado — Top 7 del MVP

#IDHistoriaPrioridadEsfuerzoRelease
1HU-V21-001Cross-Encoder en Pipeline Two-StageMustLR1
2HU-V21-002Verificar Mejora Benchmark SciFactMustMR1
3HU-V21-003Aislar Búsqueda Semántica del GrafoMustMR1
4HU-V21-004Expandir Grafo desde Top-3 NodosMustLR1
5HU-V21-005Soportar Entry Points ExplícitosMustMR1
6HU-V21-010Cachear Validación JWT BackendShouldSR1
7HU-V21-012Unificar Colecciones QdrantShouldMR1
8HU-V21-006Extracción con OpenAI RealShouldLR2
9HU-V21-009Mitigar Latencia Anómala QdrantCouldLR2
10-16VariasN+1, Cache grafo, Worker, Estrategias, Header, search/hybrid, DELETE nsCouldS-MR2

Esfuerzo total estimado: R1-MVP = 6 story points (2L + 4M + 1S) · R2 = 5.5 story points (2L + 5M + 2S)

Backlog & MVP

R1-MVP vs R2 · Dependencias Clave

R1-MVP: Precisión Core + Quick Wins

  • 7 historias: 5 Must de Precisión + 2 Should
  • Cumple 5/10 criterios de éxito completamente, 1 parcialmente
  • Gate: Verificar CE-01, CE-03, CE-05, CE-07 antes de R2
  • Si R1-MVP es exitoso, el sponsor decide si R2 sigue o se difiere a v2.2.0

R2: Robustez, DX y Deuda Residual

  • 9 historias: Fix /extract, Qdrant, cache grafo, worker, estrategias, header, unificación, DELETE ns
  • Completa los 4 criterios restantes (CE-06, CE-08, CE-09, CE-10) + CE-02 completo

Dependencias fuertes

DependenciaImpacto en planificación
HU-002 → HU-001No se puede medir el benchmark sin el cross-encoder implementado. HU-001 debe ser la primera historia en construirse.
HU-008 → HU-004El cache de grafo necesita saber qué entry points y depth cachear.
HU-014 → HU-013El header HTTP es la interfaz; el backend debe entender las estrategias primero.
HU-007 → HU-004La verificación N+1 debe ejecutarse sobre la nueva lógica de expansión.
Próximos pasos

Roadmap Cascada v2.1.0 (F0 → F9)

FaseResponsableEntregables clave
F0 — Descubrimientobusiness-analyst✅ Visión, Épicas/Features, Historias, Backlog, Presentación
F1 — Inicioproject-managerActa de Constitución, Matriz de Riesgos, Cronograma, Work Packages
F2 — Análisis Funcionalbusiness-analystEspecificación Funcional, Criterios de Aceptación Given/When/Then, Matriz de Trazabilidad
F3 — Diseño Técnicosolution-architectDocumento de Arquitectura, ADRs, Diseño de Componentes
F4 — ConstruccióndevelopersCódigo fuente R1-MVP (7 historias) → Gate → R2 (9 historias)
F5 — QA Funcionalqa-leadCasos de prueba, Ejecución, Reporte de defectos
F6 — UATqa-functionalVerificación 10 criterios de éxito, Benchmarks SciFact + Multi-dominio
F7-9 — Cierredevops / pmEstabilización, Despliegue, Informe de Cierre

Hito inmediato: Validación del sponsor (HOY) → si se aprueba, arranca F1-Inicio.

Decisión solicitada

¿Refleja correctamente tu necesidad?

Aprobado — Avanzamos a Fase 1 · Necesito ajustes · Volver a discutir

Abax-Memory v2.1.0 — Discovery · 2026-05-05 · business-analyst · docs/entregables/v2.1/fase-0-descubrimiento/