2026-05-05 · business-analyst · product-owner (pendiente de revisión)
| Gap | v2.0.9 (estado actual) | Meta v2.1.0 | Origen |
|---|---|---|---|
| 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.
| ID | Criterio | Línea Base | Meta |
|---|---|---|---|
| CE-01 | Precisión top-1 | ~0.78 | ≥ 0.90 ⭐ |
| CE-02 | Latencia p95 búsqueda | ~2s | ≤ 500ms ⭐ |
| CE-03 | NDCG@10 SciFact | 0.7771 (FAIL) | ≥ 0.85 ⭐ |
| CE-04 | Recall@10 SciFact | 0.9006 (PASS) | ≥ 0.90 |
| CE-05 | Colecciones Qdrant | 2 | 1 |
| CE-06 | /extract funcional | MockLlmService | OpenAI real |
| CE-07 | search = semantic puro | Ambiguo | 0 grafo |
| CE-08 | DELETE namespace | No existe | Operativo |
| CE-09 | X-Graph-Strategy | No existe | Funcional |
| CE-10 | Unificar search/hybrid | 2 endpoints | 1 + deprecated |
Los mismos 5 roles de v2.0.0. El principal beneficiario de v2.1.0 es el Desarrollador Consumidor de la API (Memory Consumer).
| Rol | Impacto de v2.1.0 |
|---|---|
| Memory Operator | Mayor precisión (top-1 ≥ 0.90). Menor latencia (p95 ≤ 500ms). |
| Memory Consumer | Principal beneficiario. API unificada, X-Graph-Strategy, DELETE namespace, /extract con OpenAI real. |
| Memory Admin | Eliminación de namespaces completos. Una sola colección Qdrant simplifica la administración. |
| Memory Reviewer | Sin cambios directos. Mejora de latencia beneficia el flujo de revisión. |
| Memory Auditor | Sin cambios directos. 100% de trazabilidad heredado de v2.0.0. |
| Épica | Feature | Prioridad |
|---|---|---|
| EP-V21-001 Precisión | FT-001.1 — Reranker Cross-Encoder | 1 |
| FT-001.2 — Búsqueda Semántica Pura (search sin grafo) | 2 | |
| FT-001.3 — Expansión Grafo Top-3 + entryPoints | 3 | |
| FT-001.4 — Fix POST /extract (OpenAI real) | 6 | |
| EP-V21-002 Velocidad | FT-002.1 — Optimización N+1 + Cache de Grafo | 7 |
| FT-002.2 — Cold Start / Lock Qdrant | 8 | |
| FT-002.3 — Cache JWT Cliente | 4 | |
| EP-V21-003 Eficiencia | FT-003.1 — Diagnóstico Worker (Claimed=0) | 9 |
| FT-003.2 — Unificar Colecciones Qdrant | 5 | |
| FT-003.3 — graphEntryStrategy Configurable | 10 | |
| EP-V21-004 API / DX | FT-004.1 — Header X-Graph-Strategy | 11 |
| FT-004.2 — Unificar search/hybrid | 12 | |
| 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.
| Épica | Historias | Must | Should | Could |
|---|---|---|---|---|
| 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.
| # | ID | Historia | Prioridad | Esfuerzo | Release |
|---|---|---|---|---|---|
| 1 | HU-V21-001 | Cross-Encoder en Pipeline Two-Stage | Must | L | R1 |
| 2 | HU-V21-002 | Verificar Mejora Benchmark SciFact | Must | M | R1 |
| 3 | HU-V21-003 | Aislar Búsqueda Semántica del Grafo | Must | M | R1 |
| 4 | HU-V21-004 | Expandir Grafo desde Top-3 Nodos | Must | L | R1 |
| 5 | HU-V21-005 | Soportar Entry Points Explícitos | Must | M | R1 |
| 6 | HU-V21-010 | Cachear Validación JWT Backend | Should | S | R1 |
| 7 | HU-V21-012 | Unificar Colecciones Qdrant | Should | M | R1 |
| 8 | HU-V21-006 | Extracción con OpenAI Real | Should | L | R2 |
| 9 | HU-V21-009 | Mitigar Latencia Anómala Qdrant | Could | L | R2 |
| 10-16 | Varias | N+1, Cache grafo, Worker, Estrategias, Header, search/hybrid, DELETE ns | Could | S-M | R2 |
Esfuerzo total estimado: R1-MVP = 6 story points (2L + 4M + 1S) · R2 = 5.5 story points (2L + 5M + 2S)
| Dependencia | Impacto en planificación |
|---|---|
| HU-002 → HU-001 | No se puede medir el benchmark sin el cross-encoder implementado. HU-001 debe ser la primera historia en construirse. |
| HU-008 → HU-004 | El cache de grafo necesita saber qué entry points y depth cachear. |
| HU-014 → HU-013 | El header HTTP es la interfaz; el backend debe entender las estrategias primero. |
| HU-007 → HU-004 | La verificación N+1 debe ejecutarse sobre la nueva lógica de expansión. |
| Fase | Responsable | Entregables clave |
|---|---|---|
| F0 — Descubrimiento | business-analyst | ✅ Visión, Épicas/Features, Historias, Backlog, Presentación |
| F1 — Inicio | project-manager | Acta de Constitución, Matriz de Riesgos, Cronograma, Work Packages |
| F2 — Análisis Funcional | business-analyst | Especificación Funcional, Criterios de Aceptación Given/When/Then, Matriz de Trazabilidad |
| F3 — Diseño Técnico | solution-architect | Documento de Arquitectura, ADRs, Diseño de Componentes |
| F4 — Construcción | developers | Código fuente R1-MVP (7 historias) → Gate → R2 (9 historias) |
| F5 — QA Funcional | qa-lead | Casos de prueba, Ejecución, Reporte de defectos |
| F6 — UAT | qa-functional | Verificación 10 criterios de éxito, Benchmarks SciFact + Multi-dominio |
| F7-9 — Cierre | devops / pm | Estabilización, Despliegue, Informe de Cierre |
Hito inmediato: Validación del sponsor (HOY) → si se aprueba, arranca F1-Inicio.
Abax-Memory v2.1.0 — Discovery · 2026-05-05 · business-analyst · docs/entregables/v2.1/fase-0-descubrimiento/