Especificación de Infraestructura v2.4

Arquitectura sin cajas negras.

Diseñamos sistemas donde cada entrada está validada mediante esquemas tipados, cada inferencia de modelos de frontera opera con salida estructurada determinista y cada acción en sistemas de terceros es idempotente y auditable.

Pipeline de Procesamiento

El ciclo de vida de una transacción en Cerko

Latencia media: 140ms - 850ms según carga de inferencia

01 // INGESTA

Webhooks & REST

Recepción bajo TLS 1.3 con validación de firmas HMAC (Stripe, HubSpot, ERPs). Rate limiting con Redis.

HTTP 202 Accepted
02 // CONTRATO

Validación Tipada

Esquemas Zod en TypeScript. Filtrado de inyecciones y saneamiento de payloads antes de la inferencia.

z.infer<Schema>
03 // MOTOR

Claude Opus / Sonnet

Razonamiento de frontera con Tool Calling determinista. JSON estricto, temperatura baja (0.1) y sin retención de prompts.

Anthropic SDK v0.32+
04 // ACCIÓN

Ejecución Segura

Transacciones ACID en PostgreSQL, micro-sandboxes efímeros e idempotencia estricta en llamadas externas.

X-Idempotency-Key
05 // AUDITORÍA

Trazabilidad

Logs estructurados con PII ofuscada, métricas OpenTelemetry y alertas de anomalía en tiempo real.

OpenTelemetry v1.2+
pipeline-orchestrator.ts
TypeScript Strict • Node.js 22 LTS
// Validación de contrato con Zod antes del LLM
import { Anthropic } from "@anthropic-ai/sdk";
import { z } from "zod";

const ClientTransactionSchema = z.object({
  accountId: z.string().uuid(),
  operation: z.enum(["reconcile", "audit_invoice", "contract_extract"]),
  payload: z.record(z.unknown()),
  idempotencyToken: z.string().min(16),
});

export async function processOperationalEvent(
  rawEvent: unknown
) {
  // 1. Contrato estricto: rechazo en 2ms si el formato no encaja
  const validated = ClientTransactionSchema.parse(rawEvent);
  
  // 2. Inferencia con Claude Opus (Frontier Model) & Zero Data Retention
  const anthropic = new Anthropic();
  const response = await anthropic.messages.create({
    model: "claude-3-opus-20240229",
    max_tokens: 2048,
    temperature: 0.1, // Máximo determinismo
    system: "Eres el motor de validación contable de Cerko. Devuelve únicamente JSON validado.",
    tools: [OPERATIONAL_AUDIT_TOOL_SPEC],
    tool_choice: { type: "tool", name: "execute_audit" },
    messages: [{ role: "user", content: JSON.stringify(validated.payload) }]
  });

  // 3. Transacción ACID en base de datos con clave de idempotencia
  return await db.transaction(async (tx) => {
    await tx.auditLogs.insert({
      idempotency: validated.idempotencyToken,
      result: response.content,
      executedAt: new Date().toISOString()
    });
  });
}

Especificaciones de Infraestructura

Entorno de Ejecución
Node.js 22 LTS / Edge V8
Modelos de Frontera
Claude Opus & Claude Sonnet
Gobernanza de Datos
Zero Data Retention (ZDR)
Cifrado de Tráfico
TLS 1.3 / HSTS estricto
Cifrado en Reposo
AES-256 (PostgreSQL & S3)
Latencia SLA p95
< 900 ms

¿Por qué Claude Opus para la capa de razonamiento?

Tareas empresariales complejas —como cuadre contable multidivisa, reconciliación tributaria o extracción de contratos legales de 40 páginas— requieren una ventana de contexto profunda y una capacidad de razonamiento deductivo que modelos menores no alcanzan sin fallos de alucinación.

Combinamos Claude Opus con validación de esquemas JSON estricta para garantizar que el resultado siempre encaje en las interfaces de tus sistemas existentes.

Principios de Diseño de Sistemas en Cerko

01 // IDEMPOTENCIA TOTAL

Cero duplicaciones

Cada petición y evento contiene una clave única de idempotencia. Si un webhook se reintenta por un corte temporal de red, el sistema reconoce el evento previo y evita cobros, correos o inserciones duplicadas.

02 // DEGRADACIÓN ELEGANTE

Resiliencia sin caídas

Si un servicio de terceros o la API de un modelo experimenta latencia o caída temporal, el pipeline implementa colas de reintento con backoff exponencial y caminos de ejecución alternativos previamente definidos.

03 // PROPIEDAD DEL CÓDIGO

Sin bloqueo de proveedor

Todo el software, scripts de despliegue Docker y esquemas que desarrollamos se entregan íntegramente en tu propio repositorio de GitHub. Tu empresa mantiene el control absoluto y no depende de suscripciones a plataformas cerradas.

CONSULTORÍA & AUDITORÍA

¿Quieres revisar la arquitectura de tu empresa?

Analizamos tus flujos actuales, identificamos cuellos de botella y te proponemos un diseño técnico sólido antes de escribir una sola línea de código.

Hablar con un Ingeniero →