Documentación

Introducción

Este resumen explica lo que significa comenzar con Asset Core y cómo abordar el sistema de manera efectiva.

A quién va dirigido esto

Cualquiera que sea nuevo en Asset Core y desee comprender los componentes mínimos requeridos para ejecutar el sistema y enviar su primera transacción.

Lo que aprenderás

  • Los cuatro componentes esenciales: daemon de escritura, daemon de lectura, registro de confirmaciones y cliente
  • Cómo fluye la data a través del sistema
  • Cómo se ve el “éxito” en una primera interacción

Cuándo usar esto

Lea esto antes de intentar ejecutar Asset Core localmente o integrarlo en su aplicación. Esta visión general proporciona el modelo mental necesario para comprender las guías posteriores.

Estructura de alto nivel

Asset Core utiliza una arquitectura de separación de escritura/lectura con event sourcing como la fuente de verdad:

┌──────────────┐        ┌──────────────┐
│ Write Daemon │        │ Read Daemon  │
│ POST /commit │        │ GET /read/*  │
└──────┬───────┘        └──────▲───────┘
       │                       │
       │ Events                │ Tail + Apply
       ▼                       │
   ┌───────────────────────────┴──┐
   │      Commit Log (Events)     │
   │   (sealed batches, durable)  │
   └──────────────────────────────┘

Escribir Daemon

El daemon de escritura acepta solicitudes HTTP POST a /v1/commit. Él:

  • Valida las transacciones entrantes
  • Ejecuta operaciones contra el tiempo de ejecución
  • Agrupa eventos en lotes
  • Persiste lotes en el registro de confirmaciones

El daemon de escritura es el único componente que muta el estado. Impone una semántica de escritor único para el determinismo.

Leer Daemon

El daemon de lectura sirve consultas HTTP GET. Él:

  • Registra los commits para nuevos lotes
  • Aplica eventos a través de la reproducción determinista
  • Publica instantáneas de cero-copia
  • Metadatos de frescura de informes

Las consultas devuelven proyecciones en un momento dado con información sobre cuán reciente es la data.

Registro de Commits

El registro de commits es el almacén de eventos duradero:

  • Registro de solo anexado de lotes de eventos sellados
  • Fuente de verdad para todo el estado
  • Habilita la reproducción determinista para la recuperación
  • Soporta el checkpointing para un inicio rápido

Ambos daemons interactúan con el mismo registro de confirmaciones, asegurando consistencia.

Cliente

Cualquier cliente HTTP puede interactuar con Asset Core:

  • Enviar transacciones al daemon de escritura
  • Consultar el estado desde el daemon de lectura
  • Utilice claves de idempotencia para reintentos seguros

El SDK de Python proporciona ayudantes tipados, pero el HTTP en bruto funciona para cualquier lenguaje.

El Objetivo

Comenzar significa:

  1. Ejecutando ambos daemons localmente
  2. Enviando un commit que crea un contenedor y añade saldo
  3. Leyendo de nuevo el estado para confirmar que el compromiso se aplicó

Esto valida que su entorno esté funcionando y le proporciona una base para experimentos más complejos.

Próximos pasos