Documentació

Introducció a l’Inici

Aquesta visió general explica què significa començar amb Asset Core i com abordar el sistema de manera efectiva.

A qui va adreçat això

Qualsevol persona nova a Asset Core que vulgui entendre els components mínims necessaris per executar el sistema i enviar la seva primera transacció.

Què aprendràs

  • Els quatre components essencials: escriptura de daemon, lectura de daemon, registre de compromís i client
  • Com flueix la dada a través del sistema
  • Com és “l’èxit” en una primera interacció

Quan utilitzar això

Llegeix això abans d’intentar executar Asset Core localment o integrar-lo a la teva aplicació. Aquesta visió general proporciona el model mental necessari per entendre les guies posteriors.

Estructura de nivell alt

Asset Core utilitza una arquitectura de separació d’escriptura/lectura amb esdeveniments com a font de veritat:

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

Escriure Daemon

El daemon d’escriptura accepta sol·licituds HTTP POST a /v1/commit. Ell:

  • Valida les transaccions entrants
  • Executa operacions contra el temps d’execució
  • Agrupa esdeveniments en lots
  • Persisteix lots al registre de confirmacions

El daemon d’escriptura és el únic component que muta l’estat. Impulsa la semàntica de sol-escriptor per al determinisme.

Llegir Daemon

El daemon de lectura serveix consultes HTTP GET. Ho:

  • Tails el registre de commits per a nous lots
  • Aplica esdeveniments mitjançant la reproducció determinista
  • Publica instantànies de zero còpia
  • Informa sobre la frescor de les metadades

Les consultes retornen projeccions puntuals amb informació sobre quina és la recentesa de les dades.

Registre de Compromisos

El registre de commits és l’emmagatzematge d’esdeveniments durable:

  • Registre només d’append de lots d’esdeveniments segellats
  • Font de veritat per a tot l’estat
  • Permet la reproducció determinista per a la recuperació
  • Admet suport per a la creació de punts de control per a un inici ràpid

Ambdós daemons interactuen amb el mateix registre de commits, assegurant la consistència.

Client

Qualsevol client HTTP pot interactuar amb Asset Core:

  • Enviar transaccions al daemon d’escriptura
  • Consultar l’estat del daemon de lectura
  • Utilitzeu claus d’idempotència per a reintents segurs

El SDK de Python proporciona helpers tipats, però l’HTTP en brut funciona per a qualsevol llenguatge.

L’Objectiu

Començar significa:

  1. Executant ambdós daemons localment
  2. Enviament d’un commit que crea un contenidor i afegeix saldo
  3. Llegint l’estat per confirmar que el compromís s’ha aplicat

Això valida que el vostre entorn està funcionant i us proporciona una base per a experiments més complexos.

Properes passes