Conceitos

Sistema de Eventos

Eventos são a unidade fundamental de comunicação no PROST-QS. Toda ação significativa gera um evento imutável.

Princípio Central

Apps não calculam. Apps emitem. O kernel observa.

Seu aplicativo emite eventos descrevendo o que aconteceu. O PROST-QS processa, aplica regras, calcula billing e mantém audit trail automaticamente.

Estrutura de um Evento

{
  "type": "user.subscription.created",
  "app_id": "app_xxxxx",
  "user_id": "usr_xxxxx",
  "data": {
    "plan": "pro",
    "amount": 9900,
    "currency": "BRL"
  },
  "metadata": {
    "source": "checkout",
    "ip": "192.168.1.1"
  },
  "timestamp": "2026-01-10T10:00:00Z"
}

Tipos de Eventos

user.*Eventos de usuário (login, registro, update)

payment.*Eventos financeiros (charge, refund, dispute)

agent.*Ações de agentes autônomos

system.*Eventos internos do kernel

Fluxo de Processamento

App emite evento

Kernel valida

Rules Engine avalia

Billing calcula

Audit registra

Exemplo de Uso

// Emitir evento via SDK
await prostqs.events.emit({
  type: "user.action.completed",
  data: {
    action: "purchase",
    item_id: "prod_123",
    amount: 4990
  }
});