Propuesta funcional · Decisión solicitada

Abax-Memory v2.0.0

Propuesta Funcional

Fase 2: Análisis Funcional

2026-05-03 · Business Analyst · Audiencia: Comité Directivo

Agenda

Qué vamos a cubrir

  1. Modelo de Datos Genérico
  2. Perfiles de Dominio
  3. API v2
  4. Búsqueda Semántica + Graph
  5. Gobernanza y Trazabilidad
  6. Frontend Multi-Dominio
  7. Reglas de Negocio
  8. Criterios de Aceptación
Modelo de datos

MemoryFragment

DimensiónValores
Kinds8 (decision, incident, entity, knowledge, feature, agent_memory, document, custom)
Lifecycle6 estados (draft, review, approved, deprecated, archived, deleted)
Sensitivity4 niveles (public, internal, confidential, restricted)
Relationship types9 tipos con direccionalidad
ScopesAislamiento multi-tenant
Segmentación por audiencia

Perfiles de Dominio

PerfilAudienciaKinds activosDefault sensitivity
OpsSRE, DevOps, ITdecision, incident, knowledge, documentinternal
AgentAgentes IA autónomosagent_memory, decision, entity, knowledgeinternal
BusinessLegal, CRM, Finanzasentity, document, decision, customconfidential

Extensibilidad: cualquier industria puede definir su perfil.

Contrato de interfaz

API REST v2

CategoríaEndpoints
CRUD5 (crear, leer, actualizar, eliminar, listar)
Búsqueda3 (semántica, híbrida, similitud)
Graph2 (expandir, travesar)
Revisión2 (solicitar, aprobar/rechazar)
Admin4 (perfiles, scopes, auditoría, batch)

16 endpoints English-Only OpenAPI 3.1 OIDC + RBAC

Motor de búsqueda

Búsqueda Semántica + Graph

Flujo: Query → Embedding → Qdrant → Re-ranking → Filtros → Respuesta

Control y cumplimiento

Gobernanza y Trazabilidad

Experiencia de usuario

Frontend Multi-Dominio

6 pantallas principales:

  1. Búsqueda — motor de búsqueda unificado con filtros contextuales
  2. Detalle — vista completa del fragmento con relaciones y linaje
  3. Creación / Edición — formulario contextual según kind y perfil
  4. Revisión — cola de revisión pendiente con flujo de aprobación
  5. Admin — perfiles, scopes, configuración del sistema
  6. Dashboard — métricas, actividad y estado del sistema
Especificación formal

Reglas de Negocio

MétricaValor
Reglas explícitas20 (BR-001 a BR-020)
Reglas implícitas9
Categorías7
Conflictos identificados8 (todos con resolución documentada)
Jerarquía4 niveles
Verificación y calidad

Criterios de Aceptación

TipoCantidad
Funcionales (por épica)72
De sistema13
No funcionales11
Total verificables94

Checklist QA lista para Fase 5 — UAT. Todos los criterios en formato Given/When/Then.

Medición de resultados

Criterios de Éxito del Sistema

#MétricaMeta
CE-01BEIR SciFact NDCG@10≥ 0.80
CE-03LoCoMo retrieval≥ 0.80
CE-05Latencia búsqueda p95< 500ms
CE-08Cobertura kinds8/8
CE-12Trazabilidad100%

13 criterios medibles con método de verificación definido. 5 de 13 mostrados arriba.

Roadmap

Próximos Pasos

FaseEstado
Fase 0 — Descubrimiento✅ Completada
Fase 1 — Inicio✅ Completada
Fase 2 — Análisis Funcional🔄 En curso (esta presentación)
Fase 3 — Diseño Técnico⬜ Pendiente de aprobación
Fase 4 — Construcción⬜ Pendiente
Fases 5-9 — QA → Cierre⬜ Pendiente
Decisión solicitada

¿Aprobamos la propuesta funcional?

¿El modelo de datos, la API, las reglas de negocio y los criterios de aceptación reflejan correctamente la solución requerida?

Gate: Avanzar a Fase 3 — Diseño Técnico

Aprobación requerida del Comité Directivo para continuar.