ClauseCraft AI — MVP

Concepto

ClauseCraft AI automatiza el trabajo legal repetitivo de startups, pymes y bufetes pequeños: redacción, revisión de riesgo y comparación de contratos (NDAs, MSAs, SOWs). Reduce horas de abogado en documentos estándar y centraliza todo en una bóveda segura por usuario.

Monetización: SaaS por niveles (FREE / PRO / BUSINESS), modelado en PlanTier.

Arquitectura

Spring Boot 4.0.4 / Java 25, capas clásicas:

controller  → AuthController, DocumentController (REST, valida entrada, delega a service)
service     → AuthService, DocumentService, LegalAIService, DocumentStorageService
repository  → UserRepository, LegalDocumentRepository, RiskFindingRepository (Spring Data JPA)
model       → User, LegalDocument, RiskFinding (entidades JPA) + enums (Role, PlanTier, DocumentType, RiskLevel)
dto         → records inmutables para request/response
client      → LLMApiClient (Feign) hacia una API de LLM tipo Anthropic Messages
security    → JwtService, JwtAuthFilter, CustomUserDetailsService (JWT stateless)
config      → SecurityConfig, FeignClientConfig, JacksonConfig (pre-existente)
exception   → GlobalExceptionHandler con ProblemDetail (RFC 7807)

Persistencia: JPA + H2 embebido en memoria (autoconfigurado, sin credenciales explícitas en %%INLINE1%%); listo para apuntar a PostgreSQL solo agregando %%INLINE2%%.

IA / LLM: %%INLINE3%% intenta llamar a %%INLINE4%% (Feign) si llm.api.key está configurada. Sin credenciales, usa una heurística local determinista (plantillas de generación, detección de keywords de riesgo, diff línea a línea) para que el MVP funcione end-to-end sin depender de una API externa real. Esto es intencional para demo/dev; en producción basta con setear %%INLINE6%%, %%INLINE7%% y llm.api.model.

Almacenamiento de objetos: %%INLINE9%% es una interfaz; %%INLINE10%% la implementa con un ConcurrentHashMap (simula un bucket S3 cifrado en reposo). Sustituible por un adaptador real de AWS S3 sin tocar DocumentService.

Seguridad: registro/login emiten JWT (HS256, jjwt 0.12.6). JwtAuthFilter valida el Bearer token en cada request y puebla el %%INLINE14%%. %%INLINE15%% verifica que cada documento pertenezca al usuario autenticado (UnauthorizedAccessException → 403).

Endpoints

Método	Path	Descripción
POST	/api/v1/auth/register	Alta de usuario, devuelve JWT
POST	/api/v1/auth/login	Login, devuelve JWT
GET	/api/v1/documents	Lista documentos del usuario autenticado
GET	/api/v1/documents/{id}	Detalle de un documento propio
POST	/api/v1/documents/generate	Genera contrato desde prompt en lenguaje natural
POST	/api/v1/documents/upload	Sube documento existente (multipart, texto plano) a la bóveda
POST	/api/v1/documents/{id}/analyze	Analiza riesgo del documento (cláusulas ambiguas/desfavorables)
POST	/api/v1/documents/compare	Compara dos versiones y resume cambios clave

Todos los endpoints de %%INLINE25%% requieren header %%INLINE26%%.

Cómo ejecutar

cd solutions/2026-07-01-clause-craft-api
mvn clean compile
mvn spring-boot:run

Flujo de prueba manual:

# 1. Registro
curl -X POST localhost:8080/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"fullName":"Ada Lovelace","email":"ada@startup.com","password":"password123"}'
# -> devuelve { token, ... }

# 2. Generar NDA
curl -X POST localhost:8080/api/v1/documents/generate \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"prompt":"Crea un NDA mutuo para una startup de software en Madrid","title":"NDA Madrid","documentType":"NDA"}'

# 3. Analizar riesgo
curl -X POST localhost:8080/api/v1/documents/1/analyze -H "Authorization: Bearer <token>"

# 4. Comparar versiones
curl -X POST localhost:8080/api/v1/documents/compare \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"baseDocumentId":1,"revisedDocumentId":2}'

Para activar el LLM real (opcional): agregar en application.yml o variables de entorno %%INLINE28%%, %%INLINE29%%, llm.api.model.

Referencias

• Business case: Legal Document Automation con IA (ver sourceUrls en el business case original).
• Spring Boot 4.0.4 / Spring Framework 7 docs.
• jjwt 0.12.6 (io.jsonwebtoken) para JWT.
• Anthropic Messages API (forma de referencia para LLMApiClient).

Análisis de negocio

• Problema atacado: horas de abogado desperdiciadas en contratos estándar (NDA/MSA/SOW).
• Cuña de entrada (wedge): generación + análisis de riesgo cubren las features 1 y 2 del MVP

con el mayor payoff percibido (velocidad + reducción de riesgo legal).

• Expansión: comparación de versiones (feature 3) retiene usuarios en flujos de negociación

recurrentes; la bóveda (feature 4) es el lock-in que sostiene la suscripción recurrente.

• Monetización: FREE limita volumen/features (ya modelado en PlanTier), PRO para abogados

individuales, BUSINESS con colaboración de equipo — próximo paso natural: compartir documentos entre usuarios de una misma organización.

• Riesgo clave a validar: precisión del análisis de riesgo percibida por abogados reales;

el fallback heurístico del MVP es un placeholder de producto, no un sustituto de revisión legal.

---

Análisis FinOps para ClauseCraft AI

Este análisis FinOps proporciona una estimación de los costos operativos y el margen de beneficio para ClauseCraft AI, una micro-startup centrada en la automatización de documentos legales con IA.

Desglose de Costos Mensuales Estimados

Los costos operativos iniciales se han mantenido muy ajustados, reflejando una estrategia de micro-startup lean:

• LLM (Large Language Model): $10/mes

* Estimación basada en ~1 millón de tokens/mes utilizando GPT-4o de OpenAI. Esto considera una mezcla de generación de contratos (mayor consumo de tokens de salida) y análisis/comparación de documentos (mayor consumo de tokens de entrada).

• Infraestructura Cloud (AWS/GCP/Azure): $35/mes

* Servidor de Aplicación (Spring Boot): $15/mes (ej. AWS t3.small EC2). * Base de Datos (PostgreSQL): $15/mes (ej. AWS RDS db.t3.micro). * Almacenamiento de Documentos (S3): $1/mes (para unos pocos GB de documentos y transferencias básicas). * Networking y Monitoreo Básico: $4/mes.

• Costo Total Estimado: $50/mes

Ingresos Mensuales Estimados

Basado en un modelo de monetización SaaS por niveles, con un plan 'Pro' a $25/mes:

20 clientes Pro: 20 usuarios $25/mes = $500/mes

Margen de Beneficio

Con los costos y el ingreso estimados, el margen de beneficio inicial es muy saludable:

• Ingresos: $500
• Costos: $50
• Beneficio Bruto: $450

Margen de Beneficio: (($500 - $50) / $500) 100 = 90%

Este alto margen es típico para una micro-startup con una infraestructura muy optimizada y bajos costos iniciales, donde el valor generado por la IA es significativo en comparación con el costo del token.

Drivers de Costo Clave

Los principales impulsores de costos serán:

1. Uso de LLM: Directamente proporcional al volumen de documentos generados, analizados o comparados. Un aumento exponencial de usuarios o de la longitud/complejidad de los documentos impactará directamente en este costo.
2. Escalabilidad de Infraestructura: A medida que la base de usuarios crezca, será necesario escalar las instancias de cómputo (EC2/Lambda) y la base de datos (RDS), lo que incrementará los costos de infraestructura.

Estrategias de Optimización FinOps

Para mantener los costos bajo control y maximizar la rentabilidad a medida que ClauseCraft AI crece, se recomiendan las siguientes estrategias:

• Optimización del Uso de LLM:

* Modelos Híbridos: Utilizar modelos LLM más económicos (ej. GPT-3.5 Turbo) para tareas de borrador, resúmenes preliminares o análisis menos críticos, reservando modelos más potentes (GPT-4o) para la generación final de contratos o análisis de riesgo de alta criticidad. * Caché Inteligente: Implementar un sistema de caché para almacenar respuestas de LLM de cláusulas, fragmentos de documentos o análisis comunes, evitando llamadas repetidas a la API para contenido idéntico o muy similar. * Prompt Engineering Eficiente: Diseñar prompts concisos y efectivos para minimizar la cantidad de tokens de entrada necesarios y controlar la longitud de las respuestas generadas por el LLM. * Límites de Uso: Establecer límites de tokens o de uso por usuario/organización para los planes de suscripción, incentivando un uso eficiente y permitiendo un control de costos granular.

• Optimización de Infraestructura Cloud:

* Serverless para Escalabilidad: Migrar componentes de la API o tareas asíncronas a funciones serverless (AWS Lambda, Google Cloud Functions) para pagar solo por el tiempo de ejecución, ideal para cargas de trabajo intermitentes o burstables. * Storage Tiers: Configurar políticas de ciclo de vida en AWS S3 (o equivalente) para mover automáticamente documentos antiguos o poco accedidos a clases de almacenamiento más baratas (ej. S3 Glacier), reduciendo los costos de almacenamiento a largo plazo. * Instancias Reservadas/Planes de Ahorro: Una vez que el uso de la instancia de cómputo y la base de datos se estabilice y sea predecible, considerar la compra de instancias reservadas o planes de ahorro para reducir significativamente los costos de EC2 y RDS. * Monitoreo y Alertas: Implementar un monitoreo robusto con alertas sobre picos de uso de tokens de LLM o consumo de recursos cloud para detectar y mitigar rápidamente costos inesperados.

Adoptando estas prácticas FinOps desde el inicio, ClauseCraft AI puede asegurar un crecimiento sostenible y mantener una alta rentabilidad a medida que escala su base de usuarios y funcionalidades.