Fase 0 — Descubrimiento · 2026-05-03

Abax-Memory v2.0.0

Motor de Memoria Genérico Multi-Dominio con IA

Presentación de Descubrimiento · Business Analyst · Audiencia: Sponsor

Agenda

Qué vas a ver

  1. Propósito y diferencial competitivo — por qué evolucionar de v1 a v2 y cómo nos posicionamos frente a Mem0, Zep y Letta
  2. Usuario objetivo y roles del sistema — 5 roles dominio-agnósticos + 3 perfiles de dominio
  3. Visión del producto y épicas del MVP — 7 épicas Must, 3 épicas diferidas
  4. Cifras clave y MVP definido — 10 épicas, 85+ features, 69 historias, 66 Must, Quick Wins
  5. Criterios de éxito, alcance y próximos pasos — 13 criterios medibles, lo que entra y no entra, y la decisión que necesitamos
Propósito

¿Por qué evolucionar de v1 a v2?

v1.0.0 (PMOA) demostró que el ranking semántico, la extracción de entidades, la auditoría y la gobernanza de memoria son viables. Pero quedó acotado a un solo dominio: IT Operations.

v1.0.0 (IT Ops)v2.0.0 (Multi-dominio)
Dominio fijo: incidentes, runbooks, casosDominios dinámicos: legal, CRM, finanzas, agentes, IT ops
Tipos rígidos (incidente, runbook, procedimiento)8 tipos genéricos (fact, preference, event, decision, task, procedure, note, entity)
Sin scoping multi-tenant nativoscope con tenantId, userId, sessionId, namespace
Internals en españolEnglish-Only internals — interoperable con ecosistemas IA
Solo API v1 (/api/v1/memorias)Solo API v2 (/api/v2/memories) — v1 se descarta por completo
Audiencia: operadores ITAudiencia: cualquier profesional con necesidad de memoria aumentada
Sin SDK ni integraciones con agentesDiseñado para LangChain, LlamaIndex y SDKs
Posicionamiento

Diferencial frente a Mem0, Zep y Letta

Ningún competidor ofrece el nivel de gobernanza, auditoría y control de ciclo de vida que Abax-Memory ya tiene implementados.

CapacidadAbax-Memory v2Competidores
Tipos de memoria8 kinds universalesLimitados o fijos
Ciclo de vida6 estados con reglas de transiciónBinario o ausente
Relaciones9 tipos estructurados con direccionalidadNo tipadas
Revisión humanaWorkflow draft → pending → activeNo existe
Auditoría100% de mutaciones con diff antes/despuésParcial o ausente
RBAC5 roles granularesBásico
Multi-tenantScoping nativo con 4 dimensionesVaría
English-OnlyInternals estandarizados para ecosistemas IAMixto
Usuario objetivo

Usuario Universal con IA — 5 roles, dominio-agnósticos

v2.0.0 se diseña para cualquier profesional que necesite memoria aumentada. Los roles se gestionan vía Keycloak RBAC.

RolNecesidad principal
Memory OperatorCrear, clasificar y relacionar memorias en cualquier dominio
Memory ReviewerAprobar o rechazar memorias que requieren revisión humana
Memory ConsumerConsultar memoria relevante, confiable y actualizada
Memory AdministratorDepurar, archivar, fusionar y gestionar tenants
Memory AuditorVerificar trazabilidad, cumplimiento y cobertura de conocimiento

3 perfiles de dominio (configuraciones que adaptan el core sin modificar la API): Ops Profile (SRE, DevOps), Agent Profile (agentes IA, chatbots), Business Profile (CRM, Legal, Finanzas).

Visión del producto

Motor de memoria aumentada para cualquier profesional

Principios del core genérico

Épicas Must del MVP

7 épicas · ~65 features

#ÉpicaFeatures
EP-001Motor de Memoria Genérico8 kinds, 6 estados, 9 relaciones, entidades, metadatos, confidence, versionado
EP-002Perfiles de DominioMecanismo de configuración + 3 perfiles (Ops, Agent, Business)
EP-003Scoping Multi-TenantAislamiento por tenantId, userId, sessionId, namespace + cross-tenant admin
EP-004API REST v2CRUD memorias, relaciones, revisión, entidades, stats, health, OpenAPI 3.x, auth OIDC
EP-005Búsqueda Semántica + GraphQdrant + OpenAI embeddings, 8 dimensiones de filtro, expandGraph, re-ranking
EP-006Gobernanza y TrazabilidadAuditoría 100%, visibilidad por estado, umbral de revisión, RBAC 5 roles
EP-009Frontend Multi-DominioUI adaptativa: creación, búsqueda, revisión, administración, dashboards
Épicas fuera del MVP

3 épicas Should/Could diferidas

#ÉpicaPrioridadJustificación
EP-007Batch IngestionShouldCreación individual cubre el MVP. Diferido a v2.1+
EP-010SDK Python BásicoShouldProducto funcional vía API REST v2. Diferido
EP-008Migración v1→v2CouldScript opcional. Solo si existen datos en v1

Adicional: 3 historias Should dentro de épicas Must, diferidas a R3: Rate limiting, Multi-hop traversal, Re-indexación masiva.

Cifras clave

El backlog en números

MétricaValor
Épicas totales10
Features totales85+
Historias de usuario69
Historias Must para MVP66 (95.7%)
Historias Should (R3)3 (4.3%)
Features Must cubiertas63/63 (100%)
TallaCantidad%
S (1-3d)2130.4%
M (1-2sem)3144.9%
L (3-4sem)1724.6%
Quick Wins (S)16—
MVP definido

R1 + R2 = 66 historias Must

R1 — MVP Core

43

historias (62.3%)

Motor funcional, API completa, seguridad, gobernanza básica, UI mínima. Recall@10 ≥ 0.85. Datos multi-tenant aislados.

R2 — MVP Completo

23

historias (33.3%)

Perfiles avanzados, búsqueda avanzada, gobernanza completa, frontend completo. NDCG@10 ≥ 0.80. Precisión top-1 ≥ 0.92.

Esfuerzo estimado MVP: 406-673 días-persona

Quick Wins

16 historias de alto valor + bajo esfuerzo (S)

Estrategia: primeras 3-4 semanas de desarrollo para establecer la base del motor y generar confianza temprana.

  1. Clasificar memoria con kind universal
  2. Metadatos extensibles (JSON libre)
  3. Soft-delete (flag crítico día 1)
  4. Modelo de confidence
  5. Scope obligatorio en escritura
  6. Defaults de sensibilidad por perfil
  7. Vocabulario controlado por perfil
  8. Health check
  1. English-Only en API
  2. Estándares de error HTTP
  3. Top-K configurable
  4. Scoring transparente en resultados
  5. Modelo de source tipado
  6. Rechazar memoria en revisión
  7. Herencia del core genérico
  8. Documentación OpenAPI viva
Criterios de éxito

13 criterios medibles y verificables

IDCriterioMeta
CE-01NDCG@10 en BEIR SciFact≥ 0.80
CE-02Recall@10 en BEIR SciFact≥ 0.90
CE-03Recall en LoCoMo (memoria conversacional)≥ 0.80
CE-04Latencia p95 búsqueda< 500ms
CE-05Precisión top-1 suite interna≥ 0.92
CE-06Cobertura 8 kinds100% (8/8)
CE-07Aislamiento multi-tenant100%
CE-08Visibilidad por estado (sin falsos positivos)100%
CE-09Trazabilidad de mutaciones100%
CE-10English-Only compliance100%
CE-11Operaciones sobre 9 relaciones9/9 tipos
CE-12Batch 100 memorias atómico≥ 99% (Should)
CE-13Migración v1→v2100% muestra (Could)

R1 cubre 8/13 criterios. R2 agrega CE-01, CE-03, CE-05. CE-12 y CE-13 son Should/Could.

Alcance

Lo que entra y lo que NO entra en v2.0.0

DENTRO del alcance

  • Motor genérico: 8 kinds, 6 estados, 9 relaciones, 4 sensibilidades
  • 3 perfiles de dominio (Ops, Agent, Business)
  • Scoping multi-tenant 4D
  • API REST v2 completa + OpenAPI 3.x
  • Búsqueda semántica + expandGraph + re-ranking
  • Gobernanza: auditoría 100%, revisión humana, RBAC 5 roles
  • Frontend multi-dominio adaptativo
  • English-Only en todos los identificadores
  • Stack flexible con ADR

FUERA del alcance

  • API v1 — descartada por completo
  • Backward compatibility con v1
  • Federación multi-repositorio
  • SDKs multi-lenguaje (solo Python diferido)
  • Benchmarks públicos completos
  • Automatización total de revisión humana
  • Orquestación multi-agente
  • Catálogo cerrado de dominios
  • Localización / i18n de la API
Decisiones técnicas clave

API v1 descartada · Stack flexible con ADR

API v1

Decisión del sponsor (2026-05-03): v1.0.0 está cerrado. Nadie usa v1 en producción.

  • No coexiste con v2
  • No hay período de transición
  • Solo /api/v2/
  • Sin dependencia de código ni esquemas heredados
  • Migración v1→v2 es script externo opcional

Beneficio: libertad total de stack.

Stack

Restricción R-01: se permite cambiar componentes si se justifica mediante ADR.

  • Backend: Quarkus o alternativa (ADR)
  • Base vectorial: Qdrant o alternativa (ADR)
  • Embeddings: OpenAI o alternativa (ADR)
  • BD relacional: PostgreSQL
  • Auth: Keycloak (OIDC)
  • Infra: Docker + Caddy + HTTPS

Decisión final en Fase 3 (Diseño Técnico).

Próximos pasos

Fases del proyecto

FaseNombreEntregables claveEstado
0DescubrimientoVisión, épicas, features, historias, backlog priorizadoCOMPLETADO
1InicioRefinamiento de perfiles con expertos, setup de ambiente, ADR de stackPendiente
2Análisis FuncionalEspecificación detallada API v2, modelo de datos, reglas de negocioPendiente
3Diseño TécnicoArquitectura, ADRs, modelo de BD, contratos OpenAPI finalesPendiente
4ConstrucciónR1 (MVP Core) → R2 (MVP Completo) → R3 (Enhancements)Pendiente
5UATValidación contra 13 criterios de éxito, benchmarks, tests de seguridadPendiente
6EstabilizaciónCorrección de defectos, ajustes de rendimiento, documentación finalPendiente
Decisión solicitada

¿Refleja correctamente tu necesidad?

  1. ¿La visión del motor genérico multi-dominio con IA captura lo que tenías en mente?
  2. ¿Épicas, features o historias que falten o sobren? ¿Alguna capacidad crítica no cubierta en las 85+ features?
  3. ¿De acuerdo con la priorización? R1 (43 Core) + R2 (23 Completan MVP) = 66 historias.
  4. ¿De acuerdo con lo que queda fuera? Batch ingestion, SDK Python y migración v1→v2 diferidos a v2.1+.
  5. ¿Stack flexible con ADR? ¿Fijar stack ahora o decisión técnica documentada en Fase 3?

Próximo hito: Fase 1 — Inicio. Refinamiento de perfiles de dominio, setup de ambiente de desarrollo, y ADR de stack.