CompliAgent AI — API

AI Agent Systems para Cumplimiento Regulatorio (Fintech/Healthtech)

---

Concepto

CompliAgent AI es una plataforma B2B SaaS que automatiza la gestión del cumplimiento regulatorio para startups y scale-ups de Fintech. El sistema utiliza un agente de IA que monitorea continuamente fuentes regulatorias clave (FinCEN, EBA, FCA, ESMA), las compara semánticamente contra las políticas internas de la empresa y genera alertas con checklists de acciones recomendadas cuando detecta gaps o conflictos.

Problema atacado: El seguimiento manual de regulaciones cambiantes (AML, KYC, PSD3) es lento, costoso y propenso a errores humanos que generan multas millonarias.

---

Arquitectura

┌──────────────────────────────────────────────────────┐
│                    REST API Layer                     │
│  AuthController  │  PolicyDocumentController         │
│  ComplianceDashboardController  │  RegulatorySource  │
└────────────────────────┬─────────────────────────────┘
                         │
┌────────────────────────▼─────────────────────────────┐
│                   Service Layer                       │
│                                                       │
│  AuthService          PolicyDocumentService           │
│  RegulatorySourceService  DashboardService            │
│  ComplianceAnalysisService  (AI Core Engine)          │
│  RegulatoryIngestorService  (@Scheduled — 6h)         │
└──────────┬────────────────────────────────────────────┘
           │
┌──────────▼──────────────────────────────────────────┐
│               Data Layer (JPA/H2/PostgreSQL)         │
│  User │ Company │ PolicyDocument                     │
│  RegulatorySource │ ComplianceFinding                │
└─────────────────────────────────────────────────────┘

Tecnologías:

• Spring Boot 4.0.4 / Spring Security 7 / Spring Data JPA
• Java 25 (Records, Virtual Threads, Text Blocks, Pattern Matching)
• H2 (dev) / PostgreSQL + pgvector (prod)
• JJWT 0.12.6 para autenticación JWT
• Jackson 3.x (tools.jackson.*)
• Spring Cloud OpenFeign 4.2.1

---

Endpoints

Autenticación (público)

Método	Ruta	Descripción
%%INLINE1%%	%%INLINE2%%	Registrar empresa + usuario admin
%%INLINE3%%	%%INLINE4%%	Login → JWT token

Dashboard de Cumplimiento

Método	Ruta	Descripción
%%INLINE5%%	%%INLINE6%%	Score global, conteos por severidad, alertas recientes, checklist de acciones
%%INLINE7%%	%%INLINE8%%	Disparar análisis AI: regulación vs. política interna
%%INLINE9%%	%%INLINE10%%	Listar todos los hallazgos
%%INLINE11%%	%%INLINE12%%	Detalle de un hallazgo con análisis y recomendaciones
%%INLINE13%%	%%INLINE14%%	Marcar hallazgo como resuelto

Repositorio de Políticas

Método	Ruta	Descripción
%%INLINE15%%	%%INLINE16%%	Subir documento de política
%%INLINE17%%	%%INLINE18%%	Listar documentos
%%INLINE19%%	%%INLINE20%%	Ver documento
%%INLINE21%%	%%INLINE22%%	Archivar documento

Fuentes Regulatorias

Método	Ruta	Descripción
%%INLINE23%%	%%INLINE24%%	Listar todas las fuentes
%%INLINE25%%	%%INLINE26%%	Fuentes activas
%%INLINE27%%	%%INLINE28%%	Detalle con contenido ingestado
%%INLINE29%%	%%INLINE30%%	Agregar nueva fuente a monitorear
%%INLINE31%%	%%INLINE32%%	Activar fuente
%%INLINE33%%	%%INLINE34%%	Desactivar fuente

---

Cómo Ejecutar

Requisitos

• Java 25
• Maven 3.9+

Inicio rápido

cd solutions/2026-06-29-compliagent-ai-api
mvn clean spring-boot:run

La API arranca en http://localhost:8080 con datos de demo pre-cargados.

Credenciales de demo:

• Email: admin@acme-fintech.com
• Password: password123
• CompanyId: 1

Flujo de prueba rápido

# 1. Login
curl -X POST http://localhost:8080/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@acme-fintech.com","password":"password123"}'
# → {"token":"eyJ...","email":"admin@acme-fintech.com","role":"ADMIN","companyId":1}

# 2. Dashboard (usar el token del paso 1)
curl http://localhost:8080/api/companies/1/compliance/dashboard \
  -H "Authorization: Bearer <TOKEN>"

# 3. Trigger AI analysis (regulatorySourceId=1 = FinCEN, policyDocumentId=1 = AML Policy)
curl -X POST http://localhost:8080/api/companies/1/compliance/analyze \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"regulatorySourceId":1,"policyDocumentId":1}'

# 4. Ver fuentes regulatorias
curl http://localhost:8080/api/regulatory-sources \
  -H "Authorization: Bearer <TOKEN>"

---

Análisis de Negocio

Propuesta de valor

• Must-have, no nice-to-have: El cumplimiento regulatorio es obligatorio. Las multas AML pueden alcanzar el 10% de la facturación anual.
• Mercado: +10,000 startups Fintech en EU/UK/US con equipos de cumplimiento insuficientes.
• Ventaja competitiva: Análisis proactivo basado en IA vs. monitoreo pasivo de competidores.

Modelo de monetización (B2B SaaS)

Tier	Precio	Regulaciones	Documentos	Usuarios
Starter	$299/mes	5	20	3
Professional	$799/mes	20	100	10
Enterprise	Custom	Ilimitado	Ilimitado	Ilimitado

Hoja de ruta

1. MVP (actual): Análisis keyword-based, ingesta simulada, H2
2. v1.0: Integración OpenAI GPT-4 / Anthropic Claude para análisis semántico real
3. v1.1: pgvector embeddings para búsqueda semántica de políticas
4. v2.0: Conectores reales a FinCEN API, EBA RSS, FCA feed
5. v3.0: Multi-jurisdicción, audit trail completo, SOC 2 Type II

---

Referencias

• Best AI Agent SaaS Ideas — Fintech/Healthtech
• FinCEN Beneficial Ownership Rule
• EBA AML/CFT Guidelines
• Spring Boot 4.0 Reference
• JJWT 0.12.x Documentation

---

FinOps Analysis

El análisis FinOps para CompliAgent AI revela un modelo de negocio con un potencial de rentabilidad muy alto desde el inicio, gracias a la naturaleza del software SaaS B2B y la eficiencia de los costos operativos actuales.

Desglose de Costos Mensuales Estimados:

• Tokens LLM (OpenAI gpt-4o-mini): ~$15/mes

* Estimación de ~500,000 tokens/mes, que incluye la generación de embeddings para documentos de políticas y regulaciones, así como las llamadas al agente de IA para el análisis de impacto. El modelo gpt-4o-mini es extremadamente costo-efectivo, y este presupuesto incluye un buffer para eventuales usos de modelos más avanzados o picos de demanda.

• Cloud Hosting (AWS Baseline): ~$45/mes

* EC2: Una instancia %%INLINE39%% para la aplicación Spring Boot (%%INLINE40%%). * RDS PostgreSQL: Una instancia %%INLINE41%% con pgvector para la base de datos (%%INLINE42%%), incluyendo almacenamiento y backups. * Networking y Monitoring (CloudWatch/Stackdriver): Costos asociados a la transferencia de datos y la monitorización básica (~$10/mes).

• Total Costos Operativos Mensuales Estimados: $60

Ingresos Mensuales Estimados:

Basado en un modelo de suscripción B2B SaaS, asumiendo un precio promedio de $150 por cliente al mes, y una base inicial de 5 clientes para el MVP:

Ingresos Mensuales: 5 clientes $150/cliente = $750/mes

Margen de Beneficio:

Con un ingreso de $750 y costos de $60, el margen de beneficio es excepcionalmente alto:

Profit Margin: (($750 - $60) / $750) 100 = 92%

Este alto margen es característico de las startups SaaS con costos variables bajos por cliente adicional y una infraestructura base eficiente. A medida que la base de clientes crezca, los costos de LLM y cloud aumentarán, pero a un ritmo menor que los ingresos, manteniendo la rentabilidad.

Optimizaciones de Costos Clave:

Para mantener y mejorar esta rentabilidad a medida que CompliAgent AI escala, se recomiendan las siguientes estrategias FinOps:

1. Optimización de Prompts y Modelos LLM: La eficiencia en el diseño de prompts y la selección inteligente de modelos (usando el más económico que cumpla el objetivo) son cruciales para controlar los costos de IA.
2. Cache de Respuestas LLM: Reducir llamadas redundantes a la API del LLM mediante el almacenamiento en caché de resultados para consultas frecuentes o datos estáticos.
3. Batch Processing: Agrupar tareas como la generación de embeddings para aprovechar la eficiencia del procesamiento en lotes, optimizando el uso de recursos y potencialmente reduciendo costos de API.
4. Infraestructura Serverless para Tareas Asíncronas: Migrar componentes como la ingesta de documentos o el monitoreo programado a funciones serverless (ej. AWS Lambda) para pagar solo por el consumo real, eliminando costos fijos.
5. Instancias Reservadas/Planes de Ahorro: A medida que la carga de trabajo se estabilice, comprometerse con planes de ahorro de los proveedores cloud para obtener descuentos significativos en la infraestructura base.
6. Monitorización y Alertas FinOps: Establecer un seguimiento proactivo de los costos cloud y de API para identificar y mitigar cualquier gasto inesperado o ineficiencia operativa de manera temprana.