Capacidades de negocio

La plataforma no debe leerse como una coleccion de endpoints. Debe leerse como una cadena de capacidades funcionales que transforman una solicitud comercial en una operacion aprobada, registrada y trazable.

Mapa de capacidades

Capacidad	Que resuelve	Componentes involucrados	Salida principal
Parametrizacion	Configura catalogos, reglas y maestros	Frontend, alpura-sppd-main	Datos base para operar
Captura de folios	Registra promociones, archivos y productos	Frontend, alpura-sppd-main	Folio operativo
Evaluacion	Aplica reglas y validaciones	alpura-sppd-main	Solicitud validada
Aprobacion	Ejecuta decisiones y reemplazos	Frontend, alpura-sppd-main	Decision auditable
Orquestacion	Cambia estados y publica eventos	alpura-sppd-statemachine-main	Estado actualizado
Consulta y reporte	Expone historico, reportes y seguimiento	Frontend, ambos backends	Visibilidad operativa

Vista por dominio

Operacion comercial

• Carga parametros, clientes y catalogos.
• Crea y ajusta folios.
• Asocia productos, familias, presentaciones y reglas promocionales.
• Genera consultas y reportes para seguimiento.

Control y gobierno

• Enruta aprobaciones por rol.
• Registra historico y reemplazos de autorizadores.
• Sincroniza menus, accesos y roles.
• Mantiene evidencia de decision y trazabilidad.

Orquestacion de estados

• Evalua el ciclo de vida del folio.
• Publica o consulta eventos asociados al procesamiento.
• Expone catalogos de estados y eventos.
• Sirve como punto de control para transacciones criticas.

Secuencia funcional resumida

Lineamientos de modularidad

• Agrupar documentacion por capacidad y no por listado de archivos.
• Unificar flujos duplicados de promociones en familias de comportamiento.
• Mantener la aprobacion como capacidad transversal, no como subseccion aislada.
• Separar claramente reglas de negocio de hallazgos tecnicos.

Lectura recomendada

Despues de esta seccion, continua con Landscape de solucion para ver como estas capacidades aterrizan en componentes y dependencias reales.